abc カメラライブラリ マニュアル このマニュアルは、カメラライブラリの仕様 について記載します。 Ver. 1.
ご注意 ● このソフトウェアおよびマニュアルの、一部または全部を無断で使用、複製することはできません。 ● このソフトウェアおよびマニュアルは、本製品の使用許諾契約書のもとでのみ使用することができます。 ● このソフトウェアおよびマニュアルを運用した結果の影響については、一切の責任を負いかねますのでご了 承ください。 ● このソフトウェアの仕様、およびマニュアルに記載されている事柄は、将来予告なしに変更することがありま す。 ● このマニュアルの著作権はカシオ計算機株式会社に帰属します。 ● 本書中に含まれている画面表示は、実際の画面とは若干異なる場合があります。予めご了承ください。 © 2010 カシオ計算機株式会社 Microsoft, MS, ActiveSync, Active Desktop, Outlook, Windows, Windows NT, および Windows ロゴは、米国 Microsoft Corporation の米国およびその他の国における登録商標または商標です。Microsoft 社の製品は、OEM 各社に、Microsoft Corporation の 100%出資子会
変更履歴 バージョン 1.00 1.01 変更日付 2008.11 2009.03 1.02 2009.07 1.03 2009.09 1.04 1.05 2009.12 2010.
目次 1. 概要···················································································································································································1 2. 動作環境 ·········································································································································································2 3.
4.41 4.42 4.43 CAMStopVideoCapture···································································································································· 67 CAMWaitForVideoEncode ······························································································································· 69 CAMCancelVideoEncode································································································································· 71 5.
1. 概要 カメラライブラリは、本体に内蔵しているカメラモジュールを利用して、撮影機能、および撮影画像のファイ ルへの変換機能を提供します。 カメラクラスライブラリは、カメラライブラリを .
2. 動作環境 カメラライブラリの動作環境を以下に示します。 対象機種 DT-5200 / DT-X7 / DT-9800 / DT-5300 対象OS • Microsoft WindowsCE 5.0 • Microsoft WindowsCE 6.0 • Microsoft WindowsMobile 6.5 開発環境とプログラミング言語 表 2-1 Visual C++ 開発環境 Microsoft Microsoft Microsoft Microsoft Visual Basic, Visual C# ○ ○ ○ ○ embedded Visual C++ Version 4.0 + SP4 × Visual Studio.NET 2003 + SP1 ○ Visual Studio 2005 + SP1 ○ Visual Studio 2008 (○:利用可、×:利用不可、-:機能なし) 提供ファイル 表 2-2 ファイル Visual C++ CameraLib.h CameraLib.lib CameraLib.dll CameraLibNet.
使用方法 Visual C++ の場合 • プログラムソース内に CameraLib.h をインクルードし、リンカの依存ファイルとして CameraLib.lib を指 定してください • CameraLib.dll は本体に内蔵されています。 Visual BasicまたはVisual C# の場合 • CameraLibNet.dll をプロジェクトの参照に追加してください。 • CameraLib.dll は本体に内蔵されています。 • CameraLibNet.dll を実行モジュールと同じフォルダにコピーしてください。 名前空間とクラス クラスライブラリ CameraLibNet.dll では、関数および定数の参照用として、下記のクラスが用意されていま す。 表 2-3 名前空間 CaLib クラス名 内容 関数参照用クラス 定数参照用クラス CameraLibNet.Api CameraLibNet.Def クラス定義の詳細については、Microsoft Visual Studio で CameraLibNet.
3. 構造体 カメラライブラリで提供する構造体を以下に示します。 表 3-1 構造体一覧 構造体名 CAM_IMAGE_SET 内容 使用する関数 JPEG 圧縮率など、取り込む静止画のオプション CAMSetImageSettings 情報を格納する構造体 CAMGetImageSettings 3.
4.
DT-X7 DT-9800 DT-5300CE DT-5300WM 機能 DT-5200 関数名 CAMSetFlash フラッシュモードの設定 - - - ○ ○ CAMGetFlash 現在のフラッシュモードの取得 - - - ○ ○ CAMSetFocus 焦点位置とフォーカスフレームの表示方法を設定 - - - ○ ○ CAMGetFocus CAMSetFocus 関数で設定された焦点位置を取得 - - - ○ ○ CAMGetFocusStatus 現在の焦点位置の取得 - - - ○ ○ CAMAutoFocus オートフォーカスによる焦点合わせ - - - ○ ○ CAMSetPreviewMode プレビューモードの設定 - - - ○ ○ CAMGetPreviewMode 現在のプレビューモードの取得 - - - ○ ○ CAMSetVideoCaptureSett 取り込む動画ファイルのオプションを設定します - - - - ○ 取り込む動画ファイ
4.1 CAMOpen カメラドライバをロードします。 [C++] int CAMOpen() [Visual Basic] Public Shared Function CAMOpen() As Int32 [C#] public static Int32 CAMOpen() 解説 カメラドライバをロードします。カメラドライバを使用する際には、必ずこの関数をコールしてください。 パラメータ なし 戻り値 CAM_SUCCESS CAM_OPENERROR FUNCTION_UNSUPPORT : 正常終了 : カメラドライバが既にロードされているか、もしくはカメラを使用で きません : 未サポートエラー 対応情報 機種 ヘッダ ライブラリ : DT-5200、DT-5300CE、DT-5300WM : CameraLib.h : CameraLib.
4.2 CAMClose カメラドライバをアンロードします。 [C++] int CAMClose() [Visual Basic] Public Shared Function CAMClose() As Int32 [C#] public static Int32 CAMClose() 解説 カメラドライバをアンロードします。カメラドライバの使用を終了、またはアプリケーションプログラムを終 了する際には、必ずこの関数をコールしてください。 パラメータ なし 戻り値 CAM_SUCCESS CAM_NOTOPENED FUNCTION_UNSUPPORT : 正常終了 : カメラドライバがロードされていません : 未サポートエラー 対応情報 機種 ヘッダ ライブラリ : DT-5200、DT-5300CE、DT-5300WM : CameraLib.h : CameraLib.
4.3 CAMStartPreview プレビューを開始します。 [C++] int CAMStartPreview( HWND hWnd, int nX, int nY, int nResSize ) [Visual Basic] Public Shared Function CAMStartPreview( _ ByVal hWnd As IntPtr, _ ByVal nX As Int32, _ ByVal nY As Int32, _ ByVal nResSize As Int32 _ ) As Int32 [C#] public static Int32 CAMStartPreview( IntPtr hWnd, Int32 nX, Int32 nY, Int32 nResSize ); 解説 プレビューを開始します。プレビューは CAMStopPreview()関数がコールされるまで行われます。 Device Emulatorでは、infファイルで指定した静止画を表示します。詳細は、CameraLib.
nResSize プレビューの画像解像度を指定します。 ■ DT-5200 CAM_4PER9VGA CAM_QVGA CAM_1PER9VGA : 4/9VGA サイズ (432x320) : QVGA サイズ (320x240) : 1/9VGA サイズ (213x160) ■ DT-5300 CAM_4PER9VGA CAM_QVGA CAM_1PER9VGA : 4/9VGA サイズ (320x432) : QVGA サイズ (240x320) : 1/9VGA サイズ (160x213) また、DT-5300CE では OR 指定で画像の向き(回転方向)を指定することができます。 : 回転なし CAM_ROTATE_NONE : 時計回りに 90 度回転 CAM_ROTATE_90 : 時計回りに 180 度回転 CAM_ROTATE_180 : 時計回りに 270 度回転 CAM_ROTATE_270 DT-5300CE では OR 指定で横長プレビューを指定することができます。 横長プレビューを指定することにより、DT-5200 と同じように本体を縦向きにした状態で横長のプレビ ューを表
対応情報 機種 ヘッダ ライブラリ : DT-5200、DT-5300CE、DT-5300WM : CameraLib.h : CameraLib.
4.4 CAMStopPreview プレビューを停止します。 [C++] int CAMStopPreview() [Visual Basic] Public Shared Function CAMStopPreview() As Int32 [C#] public static Int32 CAMStopPreview() 解説 プレビューを停止します。 パラメータ なし 戻り値 CAM_SUCCESS CAM_NOTOPENED CAM_NOT_STARTED FUNCTION_UNSUPPORT : : : : 正常終了 カメラドライバがロードされていません プレビューが開始されていません 未サポートエラー 対応情報 機種 ヘッダ ライブラリ : DT-5200、DT-5300CE、DT-5300WM : CameraLib.h : CameraLib.
4.
nResSize 撮影画像の画像解像度を、以下の値で指定します。 ■ DT-5200 CAM_1M CAM_XGA CAM_SVGA CAM_VGA CAM_4PER9VGA CAM_QVGA CAM_1PER9VGA : : : : : : : 1M サイズ XGA サイズ SVGA サイズ VGA サイズ 4/9VGA サイズ 1/4VGA サイズ 1/9VGA サイズ (1160x870) (1024x768) (800x600) (640x480) (426x320) (320x240) (213x160) ■ DT-5300 CAM_UXGA CAM_QUADVGA CAM_XGA CAM_SVGA CAM_VGA CAM_QVGA : : : : : : UXGA サイズ QUAD-VGA サイズ XGA サイズ SVGA サイズ VGA サイズ 1/4VGA サイズ (1200x1600) (960x1280) (768x1024) (600x800) (480x640) (240x320) また、DT-5300CE では OR 指定で画像の向き(回転方向)を指定することができま
戻り値 CAM_SUCCESS CAM_NOTOPENED CAM_INVALID_PARAM CAM_NOT_STARTED CAM_FILE_ERROR CAM_INTERNAL_ERROR CAM_NOT_ENOUGH_MEMORY FUNCTION_UNSUPPORT : : : : : 正常終了 カメラドライバがロードされていません 引数が正しくありません プレビューが開始されていません 画像ファイルを保存できません パス名やディスク残り容量、ストレージデバイスの有無などを 確認してください : 内部エラーです Device Emulator では発生しません : プログラム実行用メモリが足りません プログラム実行用メモリの空きが 6MB 以上あることを確認し てください Device Emulator では発生しません : 未サポートエラー 対応情報 機種 ヘッダ ライブラリ : DT-5200、DT-5300CE、DT-5300WM : CameraLib.h : CameraLib.
4.6 CAMSetImageSettings 静止画オプションを設定します。 [C++] int CAMSetImageSettings( CAM_IMAGE_SET *lpImageSettings ) [Visual Basic] Public Shared Function CAMSetImageSettings( _ ByRef lpImageSettings As CameraLibNet.CAM_IMAGE_SET& _ ) As Int32 [C#] public static Int32 CAMSetImageSettings( ref CameraLibNet.
4.7 CAMGetImageSettings 静止画オプションを取得します。 [C++] int CAMGetImageSettings( CAM_IMAGE_SET *lpImageSettings ) [Visual Basic] Public Shared Function CAMGetImageSettings( _ ByRef lpImageSettings As CameraLibNet.CAM_IMAGE_SET& _ ) As Int32 [C#] public static Int32 CAMGetImageSettings( ref CameraLibNet.
4.
CAM_5FPS CAM_15FPS : 5 フレーム/秒 : 15 フレーム/秒 戻り値 CAM_SUCCESS CAM_NOTOPENED CAM_INVALID_PARAM CAM_NOT_STARTED CAM_FILE_ERROR CAM_INTERNAL_ERROR FUNCTION_UNSUPPORT : : : : : 正常終了 カメラドライバがロードされていません 引数が正しくありません プレビューが開始されていません 画像ファイルを保存できません パス名やディスク残り容量、ストレージデバイスの有無などを確認し てください : 内部エラーです : 未サポートエラー 対応情報 機種 ヘッダ ライブラリ : なし : CameraLib.h : CameraLib.
4.
4.10 CAMGetLightMode 撮影モードを取得します。 [C++] int CAMGetLightMode() [Visual Basic] Public Shared Function CAMGetLightMode() As Int32 [C#] public static Int32 CAMGetLightMode() 解説 現在の撮影モード(ホワイトバランス)を取得します。 パラメータ なし 戻り値 現在の撮影モードを取得します。取得する値は CAMSetLightMode関数を参照してください。 または、 : カメラドライバをロードしていません CAM_NOTOPENED : 未サポートエラー FUNCTION_UNSUPPORT 対応情報 機種 ヘッダ ライブラリ : DT-5200、DT-5300CE、DT-5300WM : CameraLib.h : CameraLib.
4.11 CAMSetDigitalZoom デジタルズームを設定します。 [C++] int CAMSetDigitalZoom( int nZoom ) [Visual Basic] Public Shared Function CAMSetDigitalZoom( _ ByVal nZoom As Int32 _ ) As Int32 [C#] public static Int32 CAMSetDigitalZoom( Int32 nZoom ); 解説 デジタルズームを設定します。 Device Emulatorでは、設定値を内部変数として格納するため、何も動作しませんが、 CAMGetDigitalZoom関数を実行することにより、設定値を確認することができます。 パラメータ nZoom デジタルズームの倍率を、以下の値で指定します : 等倍(デジタルズームを使用しない)。(デフォルト) CAM_ZOOM_NONE : 1.5 倍 CAM_ZOOM_15 : 2.0 倍 CAM_ZOOM_20 : 3.
補足 下記の×の設定で撮影を行うと、CAM_INVALID_PARAM が返り、デジタルズームなし(1.0 倍)で撮影 を行います。 ■ DT-5200 倍率 1.5 倍 2.0 倍 3.0 倍 1/9VGA ○ ○ ○ 1/4VGA ○ ○ ○ 4/9VGA ○ ○ ○ VGA ○ × × SVGA × × × XGA × × × XGA ○ × × Quad VGA × × × UXGA × × × ■ DT-5300CE 横長プレビューを使用しない場合(すべてのプレビュー解像度) 倍率 1.5 倍 2.0 倍 3.0 倍 1/4VGA ○ ○ ○ VGA ○ ○ × SVGA ○ ○ × 横長プレビューを使用する場合(プレビューの解像度が 1/9VGA、1/4VGA の場合) 倍率 1.5 倍 2.0 倍 3.0 倍 1/4VGA ○ × × VGA ○ × × SVGA ○ × × XGA × × × Quad VGA × × × UXGA × × × 1/9VGA もしくは QVGA の横長プレビュー表示中に 2.0 倍、3.
4.12 CAMGetDigitalZoom デジタルズームを取得します。 [C++] int CAMGetDigitalZoom() [Visual Basic] Public Shared Function CAMGetDigitalZoom() As Int32 [C#] public static Int32 CAMGetDigitalZoom() 解説 現在のデジタルズーム設定を取得します。 パラメータ なし 戻り値 現在のデジタルズーム設定を取得します。取得する値は CAMSetDigitalZoom関数を参照してくださ い。 : カメラドライバをロードしていません CAM_NOTOPENED : 未サポートエラー FUNCTION_UNSUPPORT 対応情報 機種 ヘッダ ライブラリ : DT-5200、DT-5300CE、DT-5300WM : CameraLib.h : CameraLib.
4.
4.14 CAMGetSensitivity 明るさを取得します。 [C++] int CAMGetSensitivity() [Visual Basic] Public Shared Function CAMGetSensitivity() As Int32 [C#] public static Int32 CAMGetSensitivity() 解説 現在の明るさ(露出補正値)を取得します。 パラメータ なし 戻り値 現在の明るさ(露出補正値)を取得します。取得する値は CAMSetSensitivity 関数を参照してください。 または、 : カメラドライバがロードされていません CAM_NOTOPENED : 未サポートエラー FUNCTION_UNSUPPORT 対応情報 機種 ヘッダ ライブラリ : DT-5200、DT-5300CE、DT-5300WM : CameraLib.h : CameraLib.
4.15 CAMRedrawPreview プレビュー画面の再描画を行います。 [C++] int CAMRedrawPreview() [Visual Basic] Public Shared Function CAMRedrawPreview() As Int32 [C#] public static Int32 CAMRedrawPreview() 解説 プレビュー画面の再描画を行います。 この関数は、プレビュー画面上にメッセージボックス等が表示され、再描画が必要なときにコールしま す。通常はアプリケーションプログラムに WM_PAINT メッセージが送られてきたときにコールしてくださ い。 パラメータ なし 戻り値 CAM_SUCCESS CAM_NOTOPENED FUNCTION_UNSUPPORT : 正常終了 : カメラドライバがロードされていません : 未サポートエラー 対応情報 機種 ヘッダ ライブラリ : : CameraLib.h : CameraLib.
4.
(RGB888 の場合) 1M XGA SVGA VGA 1/4VGA : : : : : 3,027,600 バイト 2,359,296 バイト 1,440,000 バイト 921,600 バイト 230,400 バイト ■ DT-5300 (YUV422 の場合) UXGA QUAD-VGA XGA SVGA VGA 1/4VGA : : : : : : 3,840,000 バイト 2,457,600 バイト 1,572,864 バイト 960,000 バイト 614,400 バイト 153,600 バイト (RGB888 の場合) UXGA QUAD-VGA XGA SVGA VGA 1/4VGA : : : : : : 5,760,000 バイト 3,686,400 バイト 2,359,296 バイト 1,440,000 バイト 921,600 バイト 230,400 バイト nResSize 撮影画像の解像度を、以下の値で指定します。 ■ DT-5200 CAM_1M CAM_XGA CAM_SVGA CAM_VGA CAM_4PER9VGA CAM_QVGA CAM_1PER9V
DT-5300CE では OR 指定で横長画像撮影を指定することができます。 横長画像撮影を指定することにより、DT-5200 と同じように本体を縦向きにした状態で横長の画像を 撮影することができます。 ただし、カメラの画角は DT-5200 に比べて狭くなりますので、撮影距離を調整してご使用ください。 CAM_LANDSCAPE : 横長画像撮影 ・ 横長画像撮影を指定する場合は、画像の向きに CAM_ROTATE_90、CAM_ROTATE_180、 CAM_ROTATE_270 を指定することはできません。 ・ 横長画像撮影を指定した場合に撮影できる画像サイズは、QVGA、VGA、SVGA、XGA です。Quad VGA、UXGA を撮影することはできませんのでご注意ください。 ・ 横長画像撮影を指定した場合、デジタルズーム機能の一部の倍率を指定することができません。 詳細は「4.
■RGB888 データ 1 ピクセルを B、G、R 各 1byte (8bit)で表したデータフォーマットです。データには縦・横ともにダミーピク セルを含むことができます。このため、ビットマップファイルのようにダミーデータを含んだデータもエンコ ードすることができます(※)。 実データの横ピクセル数 (dwWidth) 左上のピクセル 有効データの横ピクセル数 (dwValidWidth) 画像データ B G R B G R B G R ダミー ピクセル B G R ダミー ピクセル …… 実データの縦ピクセル数 (dwHeight) B G R B G R …… 有効データの縦ピクセル数 (dwValidHeight) 1ピクセル = 1byte x 3 = 3byte (24bit) (※) 24bit ビットマップファイルは RGB888 データで構成されますが、横幅の実サイズが 4 の倍数でなけ ればなりません。このため、画像の横幅が 4 の倍数でない場合は、上記のようにダミーデータを挿入し、横 幅のサイズを調整する必要があります。 31
■YUV422 データ 2 ピクセルを、輝度(Y)1byte×2、青の色差(U)1byte、赤の色差(V)1byte で表したデータフォーマットで す。先頭のデータが画像の左上になります。 左上のピクセル 実データの横ピクセル数 (dwWidth) 有効データの横ピクセル数 (dwValidWidth) 画像データ U Y1 V Y2 U Y1 V Y2 U Y1 V D U Y1 V D …… U Y1 V Y2 U Y1 V Y2 …… 実データの縦ピクセル数 (dwHeight) 有効データの縦ピクセル数 (dwValidHeight) 2ピクセル = 1byte x 4 = 4byte (32bit) U : 青の色差。2ピクセル共通。 Y1 : 1ピクセル目の輝度。 V : 赤の色差。2ピクセル共通。 Y2 : 2ピクセル目の輝度。 ダミーの 輝度データ データには縦・横ともにダミーピクセルを含むことができます。YUV422 フォーマットは横幅が偶数でなけ ればなりませんが、これにより横幅が奇数の画像データもエンコードすることができます。 32
4.
LED の点灯に失敗します。 34
4.
4.
4.20 CAMSetIris シャッターの絞りを設定します。 [C++] int CAMSetIris( DOWRD dwIris ) [Visual Basic] Public Shared Function CAMSetIris ( _ ByVal dwIris As Int32 _ ) As Int32 [C#] public static Int32 CAMSetIris ( Int32 dwIris ); 解説 F=3.5 と F=7.0 の 2 段階を設定することができます。 Device Emulatorでは、設定値を内部変数として格納するため、何も動作しませんが、CAMGetIris関 数を実行することにより、設定値を確認することができます。 パラメータ dwIris 絞りを設定します。 CAM_IRIS_35 CAM_IRIS_70 : F=3.5 (デフォルト) : F=7.
4.21 CAMGetIris 現在のシャッター絞り設定を取得します。 [C++] int CAMGetIris( LPDWORD pIris ) [Visual Basic] Public Shared Function CAMGetIris( _ ByRef pIris As Int32 _ ) As Int32 [C#] public static Int32 CAMGetIris ( ref Int32 pIris ); 解説 現在のシャッター絞り設定を取得します。 パラメータ pIris 取得する値は CAMSetIris関数を参照してください。 戻り値 CAM_SUCCESS CAM_NOTOPENED CAM_INVALID_PARAM CAM_INTERNAL_ERROR FUNCTION_UNSUPPORT : : : : 正常終了 カメラドライバがロードされていません 引数が正しくありません 内部エラーです Device Emulator では発生しません : 未サポートエラー 対応情報 機種 ヘッダ ライブラリ : DT-5200 : CameraLib.
4.
ライブラリ : CameraLib.
4.
4.
CAMSingleCaptureEx関数で高速連写が行われますが、出力される画像サイズはQVGAのみとなりま す。CAM_CAP_MSHUTTERを指定すると、連写スピードは低速ですが、QVGAのほかにVGAの画像出 力が可能です。bDFModeにFALSEを設定すると本引数は無視されます。 : 電子シャッター(高速、QVGA のみ)でのキャプチャ CAM_CAP_ESHUTTER : メカシャッター(低速、QVGA/VGA)でのキャプチャ(デフォルト) CAM_CAP_MSHUTTER nReserved 現在のバージョンではこの引数は使用されません。 戻り値 CAM_SUCCESS CAM_NOTOPENED CAM_INVALID_PARAM CAM_INTERNAL_ERROR FUNCTION_UNSUPPORT : : : : 正常終了 カメラドライバがロードされていません 引数が正しくありません 内部エラーです Device Emulator では発生しません : 未サポートエラー 対応情報 機種 : DT-5200 (※) ヘッダ : CameraLib.
4.
CAM_INTERNAL_ERROR FUNCTION_UNSUPPORT : 内部エラーです : 未サポートエラー 対応情報 機種 : DT-5200 (※) ヘッダ : CameraLib.h ライブラリ : CameraLib.lib ※ DT5200M50 シリーズの場合には、サービスパック(バージョン 1.02)または 「MoDevDT5200.101.CAB+CAMDT5200.100.
4.
4.
4.
4.
4.
4.
4.
4.
4.
dwAudio 動画ファイルの音声の付加を指定します。 : 音声を付加します CAM_VIDEO_AUDIO : 音声を付加しません(デフォルト) CAM_VIDEO_NOAUDIO dwReserved1 現在のバージョンではこの引数を使用しません。NULL を指定してください。 dwReserved2 現在のバージョンではこの引数を使用しません。NULL を指定してください。 戻り値 CAM_SUCCESS CAM_NOTOPENED CAM_INVALID_PARAM FUNCTION_UNSUPPORT : : : : 正常終了 カメラドライバをロードしていません 引数が正しくありません 未サポートエラー 対応情報 機種 ヘッダ ライブラリ : DT-5300WM : CameraLib.h : CameraLib.
4.
lpReserved2 現在のバージョンではこの引数を使用しません。 戻り値 CAM_SUCCESS CAM_NOTOPENED CAM_INVALID_PARAM FUNCTION_UNSUPPORT : : : : 正常終了 カメラドライバをロードしていません 引数が正しくありません 未サポートエラー 対応情報 機種 ヘッダ ライブラリ : DT-5300WM : CameraLib.h : CameraLib.
4.
dwReserved1 現在のバージョンではこの引数を使用しません。NULL を指定してください。 dwReserved2 現在のバージョンではこの引数を使用しません。NULL を指定してください。 戻り値 以下の値を返します。 CAM_SUCCESS CAM_NOTOPENED CAM_INVALID_PARAM FUNCTION_UNSUPPORT : : : : 正常終了 カメラドライバをロードしていません 引数が正しくありません 未サポートエラー 対応情報 機種 ヘッダ ライブラリ : DT-5300WM : CameraLib.h : CameraLib.
4.
戻り値 CAM_SUCCESS CAM_NOTOPENED CAM_INVALID_PARAM FUNCTION_UNSUPPORT : : : : 正常終了 カメラドライバをロードしていません 引数が正しくありません 未サポートエラー 対応情報 機種 ヘッダ ライブラリ : DT-5300WM : CameraLib.h : CameraLib.
4.
戻り値 CAM_SUCCESS CAM_NOTOPENED CAM_INVALID_PARAM CAM_NOT_PREVIEW_STOPPED CAM_INTERNAL_ERROR FUNCTION_UNSUPPORT : : : : 正常終了 カメラドライバをロードしていません 引数が正しくありません プレビューを停止してください Device Emulator では発生しません : 内部エラーです Device Emulator では発生しません : 未サポートエラー 対応情報 機種 ヘッダ ライブラリ : DT-5300WM : CameraLib.h : CameraLib.
4.
4.
nResSize 動画の解像度を指定します。 : 1/4VGA サイズ (240x320) CAM_QVGA dwReserved 現在のバージョンではこの引数を使用しません。 戻り値 CAM_SUCCESS CAM_NOTOPENED CAM_INVALID_PARAM CAM_NOT_STARTED CAM_NOT_VCAP_MODE : : : : : CAM_NOT_VCAP_STOPPED CAM_NOT_ENOUGH_MEMORY : : CAM_FILE_ERROR : CAM_INTERNAL_ERROR : FUNCTION_UNSUPPORT : 正常終了 カメラドライバをロードしていません 引数が正しくありません プレビューが開始されていません 動画撮影モードではありません CAMSetCaptureMode関数を実行し、動画撮影モードに 設定してください 動画撮影を停止してください プログラム実行用メモリが足りません Device Emulator では発生しません 動画ファイルを保存できません Device Emulator では発生しません 内部エラーです D
4.
CAM_INTERNAL_ERROR FUNCTION_UNSUPPORT : 内部エラーです Device Emulator では発生しません : 未サポートエラー 補足 本関数は、CAMStartVideoCapture関数実行後に、使用してください。 本関数を実行すると、プレビューについても停止します。プレビューを再開する場合は、 CAMWaitForVideoEncode関数にて動画データのエンコード完了を待った後に、CAMStartPreview関 数を実行してください。 対応情報 機種 ヘッダ ライブラリ : DT-5300WM : CameraLib.h : CameraLib.
4.
CAM_VIDEOENCODING CAM_NOTOPENED CAM_INVALID_PARAM CAM_NOT_VCAP_START CAM_NOT_ENOUGH_MEMORY CAM_FILE_ERROR FUNCTION_UNSUPPORT : 動画のエンコード中です Device Emulator では発生しません : カメラドライバをロードしていません : 引数が正しくありません : 動画撮影を開始していません : プログラム実行用メモリが足りません Device Emulator では発生しません : 動画ファイルを保存できません Device Emulator では発生しません : 未サポートエラー 補足 本関数は、CAMStopVideoCapture関数実行後に、使用してください。 注意 エンコードの進捗率をポーリングするなどの目的で本関数をループ内で繰り返し呼ぶ場合は、 dwMilliseconds を必ず 300 以上に指定してください。 対応情報 機種 ヘッダ ライブラリ : DT-5300WM : CameraLib.h : CameraLib.
4.
5. プログラミング上の注意点 通常は本体内蔵のカメラアプリケーションを使用して撮影を行いますが、本ライブラリを使用することにより、 ユーザアプリケーションから直接カメラモジュールの制御を行うことができます。なお、カメラライブラリとカ メラアプリケーションを同時に使用することはできません。 5.1 動作フローについて カメラライブラリを使用する場合は、まずカメラドライバをロードする必要があります。次にプレビューを開始 します。静止画や連写画像の撮影は、必ずプレビュー表示中に行う必要があります。なお、プレビュー表 示中に本体の電源をオフすると、オン後(レジューム後)は再びプレビューが続行されます。 ■ 静止画撮影時の動作フロー 図 5.
■ 動画撮影時の動作フロー 1. CAMSetVideoCaptureSettings関数を実行して、取り込む動画ファイルのオプションを設定します。こ こで、音声ありを設定すると、動画撮影と同時に音声録音を実行します。 2. CAMSetPreviewFrameRate関数を実行して、動画キャプチャモード時のプレビューの最大フレーム レートを設定します。ここで設定した最大フレームレートは作成する動画ファイルの最大フレームレー トと同等になります。 3. CAMSetCaptureMode関数を実行して、プレビューにおけるキャプチャモードを動画キャプチャモード に設定します。 4. CAMStartPreview関数を実行してプレビューを開始します。 5.
6. Device Emulator Device Emulator 上で本ライブラリを正しく動作させるためには、以下のファイルが必要です。 CameraLib.inf ***.bmp(***は任意) ***.jpg(***は任意) ファイルはあらかじめ以下のフォルダにインストールされています。 ¥Storage Card¥Camera 6.1 CameraLib.inf プレビューまたはキャプチャー時に表示する BMP または JPG ファイルのパスを保存するファイルです。 CameraLib.inf のサンプルを以下に示します。 [Preview] 1PER9VGA="\Storage Card\Camera\CAM_1PER9VGA_V.bmp" QVGA="\Storage Card\Camera\CAM_QVGA_V.bmp" [Capture] QVGA_BMP="\Storage Card\Camera\CAM_QVGA.bmp" QVGA_JPG="\Storage Card\Camera\CAM_QVGA.
[Preview] プレビュー画像セクション 1/9VGA サイズ(160x213)のプレビュー表示用 BMP ファイルのパス 1PER9VGA QVGA サイズ(240x320)のプレビュー表示用 BMP ファイルのパス QVGA [Capture] キャプチャー画像セクション QVGA サイズ(240x320)のキャプチャー表示用 BMP ファイルのパス QVGA_BMP QVGA サイズ(240x320)のキャプチャー表示用 JPG ファイルのパス QVGA_JPG VGA サイズ(480x640)のキャプチャー表示用 BMP ファイルのパス VGA_BMP VGA サイズ(480x640)のキャプチャー表示用 JPG ファイルのパス VGA_JPG SVGA サイズ(600x800)のキャプチャー表示用 BMP ファイルのパス SVGA_BMP SVGA サイズ(600x800)のキャプチャー表示用 JPG ファイルのパス SVGA_JPG XGA サイズ(768x1024)のキャプチャー表示用 BMP ファイルのパス XGA_BMP XGA サイズ(768x1024)のキャプチャー表示用 JPG
カシオ計算機お問い合わせ窓口 製品に関する最新情報 ●製品サポートサイト(カシオペア・ハンディターミナル) http://casio.