API version 8

Runtime.SetCameraOptionメソッド

iOSAndroidWindows

説明

カメラの各種設定をします。

このメソッドは実行前にStartCameraCaptureメソッドを呼ぶ必要があります。
カメラが初期化されていない場合やカメラが停止中の場合に実行した場合、RTM-46例外が発生します。

利用上の注意
OSやハードウェアの種類により、一部の設定が無効となる場合があります。
必要な引数の個数は、第1引数に指定した値によって変化します。
現状使用する引数はparam1までとなっていますが、
将来、新しい設定可能項目が増えた際にparam2以降の引数を使用する可能性があります。

呼出形式

rt.SetCameraOption( type [, param1 [, param2 [, ...] ] ] )

戻り値

なし

引数

int type

設定の種類を指定します。
指定できる値は下記の通りです。

定数	値	説明
Runtime.CAMERA_OPTION_MODE	0	使用するカメラ（表/裏）
Runtime.CAMERA_OPTION_FLASH	1	フラッシュ
Runtime.CAMERA_OPTION_ORIENTATION	2	カメラの向き
Runtime.CAMERA_OPTION_SIZE	3	撮影サイズ
Runtime.CAMERA_OPTION_ZOOM	4	ズーム

int param1

引数typeによって指定する値や引数の個数が変わります。
指定できる値はそれぞれ下記の通りです。

使用するカメラ

定数	値	説明
Runtime.CAMERA_MODE_FRONT	0	フロントカメラを使用します。
Runtime.CAMERA_MODE_BACK	1	リアカメラを使用します。（初期値）

フラッシュ

常に点灯（トーチモード）するにはtrueを、点灯しない場合はfalseを指定します。
デフォルトはfalseです。

撮影サイズ

定数

値

説明

Runtime.CAMERA_SIZE_LOW

低解像度で撮影します。
撮影サイズは横192[px] 縦144[px]を基準として設定されます。
環境によって基準サイズで撮影できない場合は撮影可能な
解像度のうち最も近いものを自動選択します。

Runtime.CAMERA_SIZE_MEDIUM

中解像度で撮影します。
撮影サイズは横480[px] 縦360[px]を基準として設定されます。（初期値）
環境によって基準サイズで撮影できない場合は撮影可能な
解像度のうち最も近いものを自動選択します。

Runtime.CAMERA_SIZE_HIGH

高解像度で撮影します。撮影可能な解像度のうち最も大きいものを自動選択します。

利用上の注意
環境によっては非常に高負荷となり動作不能になる場合があります。

カメラの向き

定数	値	説明
Runtime.CAMERA_ORIENTATION_LEFT	0	端末の左側を上にします。
Runtime.CAMERA_ORIENTATION_TOP	1	端末と同じ向きにします。（初期値）
Runtime.CAMERA_ORIENTATION_RIGHT	2	端末の右側を上にします。
Runtime.CAMERA_ORIENTATION_BOTTOM	3	端末の下側を上にします。

ズーム

ズーム倍率を1.0以上の値で指定します。単位は拡大倍率です。最大ズーム倍率は環境により異なります。
設定値が1.0～最大ズーム倍率の範囲外の値を指定した場合は、最小値または最大値に矯正されます。
初期値は1.0倍です。

Android版
端末の撮影可能なズーム倍率の中から指定した値に最も近いズーム倍率に自動変換されます。

例外

RTM-46

カメラの操作に失敗しました。

使用例

/* カメラの表裏切り替え */
^.r.SetCameraOption( Runtime.CAMERA_OPTION_MODE, mode );
if(mode == Runtime.CAMERA_MODE_FRONT){
	mode = Runtime.CAMERA_MODE_BACK;
}else{
	mode = Runtime.CAMERA_MODE_FRONT;
}
StartCameraCaptureの使用例もご参照ください。