Grabber::getCurrentActualFrameRate Method
現在のフレームレートを返します。
構文
long getCurrentActualFrameRate() const;戻り値
2枚のフレーム間の時間をミリ秒で表したもの。0の場合はエラーが発生したことを示します。
備考
このメソッドは2枚のフレーム間の時間をミリ秒で表したものを返します。その時間はGrabber::getFrameRateクラスライブラリリファレンス＞クラス＞Grabber＞Grabber::getFrameRate Methodによって返されるものよりも大きくなることがあります。
デバイスがオープンで有効かつライブモード時のみ使用できるメソッドです。
帯域が狭いと要求するフレームレートは達成することができません。この場合getCurrentActualFrameRateはデバイスのデフォルト値よりも大きな値、もしくはGrabber::setFrameRateクラスライブラリリファレンス＞クラス＞Grabber＞Grabber::setFrameRate Methodに渡された値を返します。
またGrabber::getFrameRateクラスライブラリリファレンス＞クラス＞Grabber＞Grabber::getFrameRate Methodが返す値とgetCurrentActualFrameRateも違ってきます。
getCurrentActualFrameRateの戻り値はGrabber::getFrameRateクラスライブラリリファレンス＞クラス＞Grabber＞Grabber::getFrameRate Methodの値よりも大きくなります。
USBや1394機器はフレームレートがいろいろ変わるためgetCurrentActualFrameRateを継続的にコールしてフレームレートをチェックしておくことが推奨されます。
エラーが発生した場合やメソッドがデバイスにサポートされていない場合、getCurrentActualFrameRateが0を返します。GetLastError()は以下のうちの1つが設定されます。
● eNO_DEVICE_OPENED
● eDEVICE_INVALID
● eOPTION_NOT_AVAILABLE
● eFUNC_ONLY_AVAIL_IN_LIVEMODE。