# SmartJPEG PHPライブラリ仕様書

Updated 2023/09/08

SmartJPEG PHPライブラリ(SmartJpeg.php)は、SmartJPEG for Linuxの機能をPHP上から実行するためのライブラリです。用意されたメソッドを使用することでSmartJPEGの各種オプションを指定し、画像を変換することができます。変換結果はファイルへの出力に加え、画像データとして取得し、PHP上で処理することも可能です。
本ドキュメントでは、SmartJPEG PHPライブラリの各メソッドについて解説しています。

- 本ライブラリを使用するに当たっては、お使いのシステムに予めSmartJPEGが正しくインストールされている必要があります。
- 本ドキュメントはSmartJPEG Version 1.50.01の仕様に基づいて記述しています。
  最新の SmartJPEG でご利用したい場合はお問い合わせください。
- SmartJPEG の概要は、「導入ガイド - SmartJPEGをはじめよう」をご参照ください。
- SmartJPEG の詳細な使い方については「SmartJPEG 仕様書」をご参照ください。

- 使用許諾契約書は、「SmartJPEG for Linux」（以下、「本ソフトウェア」という）のご使用条件等を定めたものです。本契約の全部または一部に同意できない場合は、直ちに本ソフトウェアの使用を中止し、お客様の端末から本ソフトウェアをアンインストールしてください。
- 本ドキュメントに記載の内容はご契約のお客様のみに開示される秘密情報です。情報のお取り扱いにご注意ください。

# 使用法

本ライブラリは以下のように使用します。

1. 本ライブラリ SmartJpeg.php を所定のディレクトリに配置します。
2. お使いのPHPスクリプトに、include, require 文等により SmartJpeg.php をインクルードします。

require_once 'SmartJpeg.php'

3. Webtechnology\SmartJpeg インスタンスを生成します。

$smartjpeg = new Webtechnology\SmartJpeg();

4. 生成したインスタンスに対して、メソッドを用いて入出力ファイル、及び変換オプションを設定します。

$smartjpeg->setIn("./input.jpg"); $smartjpeg->setOut("./output.jpg"); $smartjpeg->setReduceMode(5);

5. SmartJPEGを呼び出し、変換結果を取得します。

$result = $smartjpeg->getOutImageFile(); if ($result !== null) { echo "succeeded." }

SmartJPEG呼び出し後、出力画像にアクセスしてブラウザで表示させるなど、目的に応じた処理を行ってください。
また、生成したインスタンスは本ライブラリのアンロード時に自動的に破棄されます。

# メソッドの一覧

各メソッドは基本的にSmartJPEGのコマンドラインオプションに対応する形になっています。setXXX()という名のメソッドはパラメータやデータを設定し、getXXX()という名のメソッドは設定したパラメータやデータを取得します。
setXXX()で指定するパラメータは基本的にコマンドラインオプションと同等ですが、本ライブラリでは "on"/"off" の代わりに true/false を用います。またモードを表すパラメータは文字列で(setPurpose("smartphone")やsetOutFormat("jpg")など)、サイズは数値(setLongSide(640), setRotateL(90)など)で渡します。
なお、ここで設定する値は本PHPライブラリが読み込まれている間のみ有効で、アンロード時に失われますのでご注意ください。

入出力
メソッド | 説明
--- | ---
setIn() | 入力ファイル名を設定します。
getIn() | 設定された入力ファイル名を取得します。
setInFromBinary() | 入力画像イメージを設定します。 ファイルではなく画像データを直接渡します。
getInFromBinary() | 設定された入力画像イメージを取得します。 ファイルではなく画像データを直接取得します。
setOut() | 出力ファイル名を設定します(*1)。
getOut() | 設定された出力ファイル名を取得します。

基本設定
メソッド | 説明
--- | ---
setReduceMode() | ファイルサイズ縮小化モードを設定します。
getReduceMode() | ファイルサイズ縮小化モードの設定を取得します。
setOutFormat() | 出力画像形式を設定します(*1)。
getOutFormat() | 出力画像形式の設定を取得します。
setMakeup() | 画像メイクアップを使うかどうか設定します(*2)。
getMakeup() | 画像メイクアップを使うかどうかの設定を取得します。
setMakeupMode() | 画像メイクアップのモードを設定します(*2)。
getMakeupMode() | 画像メイクアップのモード設定を取得します。
setRotateL() | 画像を左回転させる角度を設定します。
getRotateL() | 画像の左回転角度を取得します。
setRotateR() | 画像を右回転させる角度を設定します。
getRotateR() | 画像の右回転角度を取得します。
setResizeAlg() | 拡大縮小アルゴリズムを設定します。
getResizeAlg() | 拡大縮小アルゴリズムの設定を取得します。
setLongSide() | 拡大縮小の長辺サイズを設定します。
getLongSide() | 拡大縮小の長辺サイズの設定を取得します。
setWidth() | 拡大縮小の幅を設定します。
getWidth() | 拡大縮小の幅の設定を取得します。
setHeight() | 拡大縮小の高さを設定します。
getHeight() | 拡大縮小の高さの設定を取得します。
setZoom() | 拡大縮小の倍率を設定します。
getZoom() | 拡大縮小の倍率設定を取得します。

*1 PNG/GIF形式の出力には、「PNG・GIF出力ライセンス」契約が必要です。
*2 メイクアップ機能の利用には、「メイクアップライセンス」契約が必要です。

応用設定
メソッド | 説明
--- | ---
setOutExt() | 出力ファイル拡張子の調整を行うかどうかを設定します。
getOutExt() | 出力ファイル拡張子の調整設定を取得します。
setPurpose() | 用途を設定します。
getPurpose() | 用途設定を取得します。
setAutoResize() | 自動リサイズを行うかどうかを設定します。
getAutoResize() | 自動リサイズの設定を取得します。
setRecovery() | ファイルサイズが肥大化したときに元画像に復元するかどうかを設定します。
getRecovery() | 元画像に復元するかどうかの設定を取得します。
setJpegSpeed() | JPEG出力時の処理速度の優先度を設定します。
getJpegSpeed() | JPEG出力時の処理速度の優先度を取得します。
setJpegLimit() | JPEGクオリティの上限値を設定します。
getJpegLimit() | JPEGクオリティの上限設定を取得します。
setJpegSampling() | JPEGサンプリング形式を設定します。
getJpegSampling() | JPEGサンプリング形式の設定を取得します。
setJpegIccp() | JPEG ICCプロファイルの扱い方を設定します。
getJpegIccp() | JPEG ICCプロファイルの扱い方の設定を取得します。
setPngMode() | PNG出力の最適化方法を設定します。
getPngMode() | PNG出力最適化方法の設定を取得します。
setPngLossy() | PNG出力時に非可逆圧縮を行うかどうかを設定します。
getPngLossy() | PNG出力時に非可逆圧縮を行うかどうかの設定を取得します。

実行
メソッド | 説明
--- | ---
getOutImageFile() | 設定に基づきSmartJPEGを実行し、変換結果の出力画像ファイル名を取得します。
getOutImage() | 設定に基づきSmartJPEGを実行し、変換結果の出力画像データを取得します。
getOutImageType() | 設定に基づきSmartJPEGを実行し、変換結果の出力画像形式を取得します。
getResultMessage() | SmartJPEGの実行結果ステータス文字列を取得します。
setCustom() | パラメータをSmartJPEGのコマンドラインオプション文字列で直接指定します。
getCustom() | 直接指定されたコマンドラインオプション文字列を取得します。
getParam() | SmartJPEGに渡すコマンドラインオプション文字列を取得します。
getVersion() | SmartJPEGのバージョン番号を取得します。

# メソッドの詳細

# 入力ファイル名の設定

メソッド： setIn($filename)

filename に入力する画像ファイル名を指定します。

- 入力可能な画像形式はJPEG/PNG/GIFです。

- ファイル名の拡張子がない場合や、実際のファイル形式と一致していない(拡張子が間違っている)場合でも、正しい画像ファイルであれば読み込み可能です。
- 「PNG・GIF出力ライセンス」がない状態でも、PNG/GIFファイルの読み込みは可能です。

- 読み込み可能な最大サイズは12,000×12,000ピクセルです。
- ファイルパスの最大長は511文字です。ファイル名にマルチバイト文字は使用できません。
- setInFromBinary()と同時に使用することはできません。

# 入力ファイル名の取得

メソッド： getIn()

setIn()で設定した入力ファイル名を返します。設定されていない場合はnullを返します。

# 入力画像イメージの設定

メソッド： setInFromBinary($image)

image に入力する画像データオブジェクトを指定します。画像データはあらかじめ他の方法で読み込み、image に代入しておいてください。

- 入力可能な画像形式はJPEG/PNG/GIFです。

- 「PNG・GIF出力ライセンス」がない状態でも、PNG/GIFファイルの読み込みは可能です。

- 読み込み可能な最大サイズは12,000×12,000ピクセルです。
- setIn()と同時に使用することはできません。

# 入力画像イメージの取得

メソッド： getInFromBinary()

setInFromBinary()で設定した入力画像データオブジェクトを返します。データが指定されていない場合、及びSmartJPEGによる処理の実行後はnullを返します。

# 出力ファイル名の設定

メソッド：setOut($filename)

filename に出力する画像ファイル名を指定します。

- 出力可能な画像形式はJPEG/PNG/GIFです。
- デフォルトでは、ファイル名の拡張子(".jpg", ".png", ".gif")で指定された画像形式に変換します。
- setOutFormat()メソッドの指定によっては、setOut()メソッドで指定したファイル名の拡張子とは違う拡張子で出力される場合があります。
- PNG/GIF形式の出力には「PNG・GIF出力ライセンス」が必要です。ライセンスがない状態でPNG/GIF出力を指定するとエラーとなり、画像変換は行われません。
- 出力最大縦横サイズは5,000×5,000ピクセルです。ただし、入力画像ファイルのサイズがこれを超える場合は、そのサイズまで有効です。
- ファイルパスの最大長は511文字です。ファイル名にマルチバイト文字は使用できません。

本メソッドによる出力ファイル名の指定を省略することも可能です。この場合、内部的にテンポラリファイルが作成され、そこに画像が出力されます。出力ファイル名はgetOut()メソッドで取得できます。

- 出力ファイル名指定を省略した場合、内部的に出力ファイル拡張子調整機能はfalseとなり、setOutExt()の指定は無視されます。
- CentOS 7でご利用の場合、出力されたテンポラリファイルを他アプリで参照することはできません。
- 出力されたテンポラリファイルはSmartJPEGの再実行時、または本ライブラリのアンロード時に削除されます。

# 出力ファイル名の取得

メソッド：getOut()

出力する画像ファイル名を返します。
setIn()メソッドによる出力ファイル名の指定を省略した場合は、内部的に作成されたテンポラリファイル名を返します。

- 出力ファイル名指定を省略した場合、内部的に出力ファイル拡張子調整機能はfalseとなり、setOutExt()の指定は無視されます。
- 出力されたテンポラリファイルを他アプリで参照することはできません。
- 出力されたテンポラリファイルはSmartJPEGの再実行時、または本ライブラリのアンロード時に削除されます。

# ファイルサイズ縮小化モードの設定

メソッド：setReduceMode($mode)

mode にファイルを縮小する際のサイズや品質の優先度1～7の範囲で指定します。1は画質を最重視し、7はファイルサイズを最重視します。デフォルトは5です。
詳しくはSmartJPEG仕様書の -reducemode の項をご参照ください。

# ファイルサイズ縮小化モードの設定取得

メソッド：getReduceMode()

setReduceMode()で設定したファイルサイズ縮小化モードの値を返します。設定されていない場合はnullを返します。

# 出力画像形式の設定

メソッド：setOutFormat($format)

format に出力画像形式を表す所定の文字列を指定します。デフォルトは "ext" です。
詳しくはSmartJPEG仕様書の -outformat の項をご参照ください。
なお、PNG/GIF形式の出力には「PNG・GIF出力ライセンス」が必要です。ライセンスがない状態でPNG/GIF出力を指定してもエラーとなり画像変換は行われませんのでご注意ください。

# 出力画像形式の取得

メソッド：getOutFormat()

setOutFormat()で設定した出力画像形式名(文字列)を返します。設定されていない場合はnullを返します。

# 画像メイクアップの設定

メソッド：setMakeup(false|true)

画像メイクアップを使用するかどうかを指定します。使用する場合はtrueを、使用しない場合はfalseを指定してください。
詳しくはSmartJPEG仕様書の -makeup の項をご参照ください。
なお、メイクアップ機能を利用するには「メイクアップライセンス」が必要です。ライセンスがない状態で本メソッドを指定するとエラーとなり、画像変換は行われません。

# 画像メイクアップの設定取得

メソッド：getMakeup()

setMakeup()で設定した画像メイクアップ使用の有無を返します。設定されていない場合はnullを返します。

# 画像メイクアップモード設定

メソッド：setMakeupMode($mode)

mode に画像メイクアップのモードを表す所定の文字列を指定します。
詳しくはSmartJPEG仕様書の -makeupmode の項をご参照ください。
なお、メイクアップ機能を利用するには「メイクアップライセンス」が必要です。ライセンスがない状態で本メソッドを指定するとエラーとなり、画像変換は行われません。

# 画像メイクアップモードの設定取得

メソッド：getMakeupMode()

setMakeupMode()で設定した画像メイクアップモード(文字列)を返します。設定されていない場合はnullを返します。

# 左回転

メソッド：setRotateL($n)

画像を左回転させたい場合、n にその角度を90度単位の数値で指定します。
本メソッドは右回転(setRotateR())と同時に指定することはできません。

# 画像の左回転角度の取得

メソッド：getRotateL()

setRotateL()で設定した画像の左回転角度を返します。設定されていない場合はnullを返します。

# 右回転

メソッド：setRotateR($n)

画像を右回転させたい場合、n にその角度を90度単位の数値で指定します。
本メソッドは左回転(setRotateL())と同時に指定することはできません。

# 画像の右回転角度の取得

メソッド：getRotateR()

setRotateR()で設定した画像の右回転角度を返します。設定されていない場合はnullを返します。

# 拡大縮小アルゴリズム指定

メソッド：setResizeAlg($mode)

mode に画像を拡大縮小する際のアルゴリズムを表す所定の文字列を指定します。
画像サイズを変更しない場合、本メソッドの指定は動作に影響しません。
詳しくはSmartJPEG仕様書の -resizealg の項をご参照ください。

# 拡大縮小アルゴリズム設定の取得

メソッド：getResizeAlg()

setResizeAlg()で設定した拡大縮小アルゴリズム(文字列)を返します。設定されていない場合はnullを返します。

# 拡大縮小の長辺指定

メソッド：setLongSide($n)

n に拡大縮小するときの長辺サイズ(幅か高さの長い方の長さ)を数値で指定します。短辺は自動算出されます。
詳しくはSmartJPEG仕様書の -longside の項をご参照ください。
本メソッドは以下のメソッドと同時に指定することはできません。

- 拡大縮小の幅指定(setWidth())
- 拡大縮小の高さ指定(setHeight())
- 拡大縮小の倍率指定(setZoom())

# 拡大縮小の長辺サイズ設定の取得

メソッド：getLongSide()

setLongSide()で設定した長辺サイズ(数値)を返します。設定されていない場合はnullを返します。

# 拡大縮小の幅指定

メソッド：setWidth($n)

n に拡大縮小の幅を数値で指定します。高さは自動算出されます。
詳しくはSmartJPEG仕様書の -width の項をご参照ください。
本メソッドは以下のメソッドと同時に指定することはできません。

- 拡大縮小の長辺指定(setLongSide())
- 拡大縮小の高さ指定(setHeight())
- 拡大縮小の倍率指定(setZoom())

# 拡大縮小の幅の取得

メソッド：getWidth()

setWidth()で設定した拡大縮小の幅(数値)を返します。設定されていない場合はnullを返します。

# 拡大縮小の高さ指定

メソッド：setHeight($n)

n に拡大縮小の高さを数値で指定します。幅は自動算出されます。
詳しくはSmartJPEG仕様書の -height の項をご参照ください。
本メソッドは以下のメソッドと同時に指定することはできません。

- 拡大縮小の長辺指定(setLongSide())
- 拡大縮小の幅指定(setWidth())
- 拡大縮小の倍率指定(setZoom())

# 拡大縮小の高さの取得

メソッド：getHeight()

setHeight()で設定した拡大縮小の高さ(数値)を返します。設定されていない場合はnullを返します。

# 拡大縮小の倍率指定

メソッド：setZoom($n)

n に拡大縮小の倍率(%)を1～999の範囲で指定します。
詳しくはSmartJPEG仕様書の -zoom の項をご参照ください。
本メソッドは以下のメソッドと同時に指定することはできません。

- 拡大縮小の長辺指定(setLongSide())
- 拡大縮小の幅指定(setWidth())
- 拡大縮小の高さ率(setHeight())

# 拡大縮小の倍率設定の取得

メソッド：getZoom()

setZoom()で設定した拡大縮小の倍率を返します。設定されていない場合はnullを返します。

# 出力ファイル拡張子の調整

メソッド：setOutExt(false|true)

setOut()メソッドで指定された出力ファイル名の拡張子と画像形式が整合していない場合、画像形式に合わせて拡張子を変更・付加するかどうかを指定します。
setOut()メソッドを省略した場合は本オプションでtrueを指定してもfalseの扱いになります。
詳しくはSmartJPEG仕様書の -outext の項をご参照ください。

# 出力ファイル拡張子の調整設定の取得

メソッド：getOutExt()

setOutExt()で設定した出力ファイル拡張子の調整の有無を返します。設定されていない場合はnullを返します。

# 用途指定

メソッド：setPurpose($mode)

mode に最適化の用途・対象を表す文字列("smartphone"または"pc")を指定し、それぞれの用途に適した変換を行えるようにします。
詳しくはSmartJPEG仕様書の -purpose の項をご参照ください。
本メソッドは以下の処理に影響します。また、内部処理で JPEG 品質や再圧縮の判定処理が変更されます。

- 自動リサイズ

# 用途設定の取得

メソッド：getPurpose()

setPurpose()での用途設定(文字列)を返します。設定されていない場合はnullを返します。

# 自動リサイズの指定

メソッド：setAutoResize(false|true)

自動リサイズを行うかどうかを設定します。
詳しくはSmartJPEG仕様書の -autoresize の項をご参照ください。
なお、以下のメソッドで有効な値を指定すると、本メソッドは常にsetAutoResize(false)として処理されます。

- 画像メイクアップ(setMakeup())
- 拡大縮小の長辺指定(setLongSide())
- 拡大縮小の幅指定(setWidth())
- 拡大縮小の高さ指定(setHeight())
- 拡大縮小の倍率指定(setZoom())

# 自動リサイズ設定の取得

メソッド：getAutoResize()

setAutoResize()での自動リサイズ設定を返します。設定されていない場合はnullを返します。

# 元画像よりファイルサイズが大きくなったときに復元

メソッド：setRecovery(false|true)

元画像よりファイルサイズが大きくなったときに復元(元画像ファイルをコピー)するかどうかを指定します。
詳しくはSmartJPEG仕様書の -recovery の項をご参照ください。
なお、本メソッドは以下のメソッドに有効値を指定すると、常にsetRecovery(false)として処理されます。

- 画像メイクアップ(setMakeup())
- 左回転(setRotateL())
- 右回転(setRotateR())
- 拡大縮小の長辺指定(setLongSide())
- 拡大縮小の幅指定(setWidth())
- 拡大縮小の高さ指定(setHeight())
- 拡大縮小の倍率指定(setZoom())
- JPEG出力時の処理速度優先度をsetJpegSpeed("rapid")とした場合

# 元画像復元設定の取得

メソッド：getRecovery()

setRecovery()での元画像復元設定を返します。設定されていない場合はnullを返します。

# JPEG出力時の処理速度の優先度の指定

メソッド：setJpegSpeed($mode)

mode にJPEG出力時の処理速度の優先度を示す所定の文字列を指定します。
詳しくはSmartJPEG仕様書の -jpegspeed の項をご参照ください。

# JPEG出力時の処理速度の優先度の取得

メソッド：getJpegSpeed()

setJpegSpeed()で設定したJPEG出力時の処理速度の優先度(文字列)を返します。設定されていない場合はnullを返します。

# JPEGクオリティ値の上限指定

メソッド：setJpegLimit($n)

n にJPEGクオリティ値の上限を50～100の範囲で指定します。
詳しくはSmartJPEG仕様書の -jpeglimit の項をご参照ください。

# JPEGクオリティ上限設定の取得

メソッド：getJpegLimit()

setJpegLimit()で設定したJPEGクオリティ上限値を返します。設定されていない場合はnullを返します。

# JPEGサンプリング形式の指定

メソッド：setJpegSampling($mode)

mode に出力画像のJPEGサンプリング形式を表す所定の文字列を指定します。
詳しくはSmartJPEG仕様書の -jpegsampling の項をご参照ください。

# JPEGサンプリング形式設定の取得

メソッド：getJpegSampling()

setJpegSampling()で設定したJPEGサンプリング形式(文字列)を返します。設定されていない場合はnullを返します。

# JPEG ICCプロファイルの処理

メソッド：setJpegIccp($mode)

mode に入力JPEGファイルにICCプロファイルが含まれていた場合の処理方法を表す所定の文字列を指定します。
詳しくはSmartJPEG仕様書の -jpegiccp の項をご参照ください。

# JPEG ICCプロファイルの処理設定の取得

メソッド：getJpegIccp()

setJpegIccp()で設定したJPEG ICCプロファイルの処理方法(文字列)を返します。設定されていない場合はnullを返します。

# PNGファイル出力時の最適化方法の指定

メソッド：setPngMode($mode)

mode にPNG形式で出力する場合の最適化方法を表す所定の文字列を指定します。
詳しくはSmartJPEG仕様書の -pngmode の項をご参照ください。

# PNGファイル最適化方法の取得

メソッド：getPngMode()

setPngMode()で設定したPNGファイル出力時の最適化方法(文字列)を返します。設定されていない場合はnullを返します。

# PNGファイル出力時の非可逆圧縮の指定

メソッド：setPngLossy(false|true)

PNG形式で出力する際に非可逆圧縮処理を行うかどうかを指定します。非可逆圧縮処理によりファイルサイズをより縮小化することが可能です。
詳しくはSmartJPEG仕様書の -pnglossy の項をご参照ください。

# PNGファイル出力時の非可逆圧縮設定の取得

メソッド：getPngLossy()

setPngLossy()で設定したPNGファイル出力時の非可逆圧縮の設定を返します。設定されていない場合はnullを返します。

# SmartJPEGを実行し、出力画像ファイル名を取得

メソッド：getOutImageFile()

設定に従って必要に応じてSmartJPEGを実行し、出力画像ファイル名を取得します。失敗時はnullを返します。
入出力指定に応じて以下のように処理を行います。

入出力指定 | 処理
--- | ---
setIn(), setOut()を指定 | setIn()で指定されたファイルを処理し、setOut()で指定されたファイルに出力。
setIn()のみ指定 | setIn()で指定されたファイルを処理し、テンポラリファイルに出力。
setInFromBinary(), setOut()を指定 | setInFromBinary()で指定されたデータを処理し、setOut()で指定されたファイルに出力。
setInFromBinary()のみ指定 | setInFromBinary()で指定されたデータを処理し、テンポラリファイルに出力。

# SmartJPEGを実行し、出力画像データを取得

メソッド：getOutImage()

設定に従って必要に応じてSmartJPEGを実行し、出力画像データを取得します。失敗時はnullを返します。
入出力指定に応じて以下のように処理を行います。

入出力指定 | 処理
--- | ---
setIn(), setOut()を指定 | setIn()で指定されたファイルを処理し、出力画像データを返す。
setIn()のみ指定 | setIn()で指定されたファイルを処理し、出力画像データを返す。
setInFromBinary(), setOut()を指定 | setInFromBinary()で指定されたファイルを処理し、出力画像データを返す。
setInFromBinary()のみ指定 | setInFromBinary()で指定されたファイルを処理し、出力画像データを返す。

# SmartJPEGを実行し、出力画像形式を取得

メソッド：getOutImageType()

設定に従って必要に応じてSmartJPEGを実行し、出力画像形式を取得します。返値は以下の何れかになります。

パラメータ | 説明
--- | ---
IMAGETYPE_JPEG | JPEG形式
IMAGETYPE_PNG | PNG形式(*)
IMAGETYPE_GIF | GIF形式(*)

失敗時はfalseを返します。
* PNG/GIF形式の出力には、「PNG・GIF出力ライセンス」契約が必要です。

# SmartJPEGの実行結果ステータス文字列の取得

メソッド：getResultMessage()

SmartJPEGを実行した結果のステータス文字列を返します。実行結果の状態が文字列で確認できます。

# コマンドラインオプションの直接指定

メソッド：setCustom($array)

SmartJPEGのコマンドラインオプションを直接指定します。array にはコマンドとオプションを順に並べた文字列の配列を指定してください。例えば以下のような形です。

$param = array("-in", "./in.jpg", "-out", "./out.jpg") $smartjpeg->setCustom($param);

本メソッドでのコマンドラインオプション指定は他のパラメータ設定メソッドに優先します。

# コマンドラインオプション指定の取得

メソッド：getCustom()

setCustom()で設定したコマンドラインオプション文字列を取得します。設定されていない場合はnullを返します。

# オプション文字列の取得

メソッド：getParam()

SmartJPEGに渡すコマンドラインオプション文字列を取得します。
本ライブラリは各種メソッドでの設定をSmartJPEGのコマンドラインオプションに置換し、これをSmartJPEGに渡します。本メソッドを利用することで、SmartJPEG実行前にオプションの設定状況と文字列置換状態を確認することができます。
コマンドラインオプションが設定されていない場合はnullを返します。

# SmartJPEGのバージョンの取得

メソッド：getVersion()

SmartJPEGのバージョン番号(文字列)を取得します。失敗時にはnullを返します。

Copyright © 2017-2021 Web Technology Corp.
Copyright © CRI Middleware Co., Ltd.

一部、ISO/JIS-SCIDの画像を使用しています。