Grabber::setProperty Method
デバイスのプロパティ値を指定の値に設定、もしくはプロパティのautomatic mode(自動設定モード)の有効/無効化を行います。
構文
bool setProperty( tCameraPropertyEnum CameraPropType, bool autom );
bool setProperty( tVideoPropertyEnum VideoPropType, bool autom );
bool setProperty( tCameraPropertyEnum CameraPropType, long val );
bool setProperty( tVideoPropertyEnum VideoPropType, long val );| パラメータ | 説明 |
|---|---|
| CameraPropType | 設定するカメラプロパティを指定します。Grabber::tCameraPropertyEnumクラスライブラリリファレンス＞クラス＞Grabber＞Grabber::tCameraPropertyEnumの中から選択します。 |
| VideoPropType | 設定するビデオプロパティを指定します。Grabber::tVideoPropertyEnumクラスライブラリリファレンス＞クラス＞Grabber＞Grabber::tVideoPropertyEnumの中から選択します。 |
| autom | "automatic mode(自動設定モード)"を有効にするかどうかを指定します。trueの場合は自動設定を有効にし、パラメータvalを無視します。falseの場合は自動設定は無効となりパラメータvalを利用します。 |
| val | プロパティ値をval の値に設定します。値はGrabber::getPropertyRangeクラスライブラリリファレンス＞クラス＞Grabber＞Grabber::getPropertyRange Methodが返す範囲内である必要があります。それを超えた場合はエラーが発生します。値を設定するにはデバイスがそのプロパティをサポートしており、かつ自動設定が無効であることが条件となります。 |
戻り値
プロパティ値が正常に変更された場合はtrue、そうでない場合はfalse。
備考
特定のデバイスは定義されているプロパティのサブネットのみをサポートしている場合があります。
デバイスがプロパティをサポートしているかどうかはGrabber::isPropertyAvailableWithCurDevクラスライブラリリファレンス＞クラス＞Grabber＞Grabber::isPropertyAvailableWithCurDev Methodをコールすることでチェックすることができます。
"automatic mode"はサポートされているプロパティのサブネットにのみ利用可能です。特定のプロパティにおいて"automatic mode"が利用可能かどうかを知るにはGrabber::isPropertyAutomationAvailableWithCurDevクラスライブラリリファレンス＞クラス＞Grabber＞Grabber::isPropertyAutomationAvailableWithCurDev Methodをコールします。
プロパティが"automatic mode"に設定されているかどうかをチェックするにはGrabber::isPropertyAutomationEnabledクラスライブラリリファレンス＞クラス＞Grabber＞Grabber::isPropertyAutomationEnabled Methodをコールします。
プロパティのデフォルト値はGrabber::getPropertyDefaultクラスライブラリリファレンス＞クラス＞Grabber＞Grabber::getPropertyDefault Methodをコールすることでクエリ可能です。
関連項目
Grabberクラスライブラリリファレンス＞クラス＞Grabber, Grabber::getPropertyクラスライブラリリファレンス＞クラス＞Grabber＞Grabber::getProperty Method, Grabber::getPropertyDefaultクラスライブラリリファレンス＞クラス＞Grabber＞Grabber::getPropertyDefault Method, Grabber::getPropertyRangeクラスライブラリリファレンス＞クラス＞Grabber＞Grabber::getPropertyRange Method, Grabber::isPropertyAutomationEnabledクラスライブラリリファレンス＞クラス＞Grabber＞Grabber::isPropertyAutomationEnabled Method, Grabber::isPropertyAvailableWithCurDevクラスライブラリリファレンス＞クラス＞Grabber＞Grabber::isPropertyAvailableWithCurDev Method, Grabber::isPropertyAutomationAvailableWithCurDevクラスライブラリリファレンス＞クラス＞Grabber＞Grabber::isPropertyAutomationAvailableWithCurDev Method, Grabber::tCameraPropertyEnumクラスライブラリリファレンス＞クラス＞Grabber＞Grabber::tCameraPropertyEnum, Grabber::tVideoPropertyEnumクラスライブラリリファレンス＞クラス＞Grabber＞Grabber::tVideoPropertyEnum