デバイス接続 & 撮影設定 API

INFINICAM デバイスの接続管理および本体パラメーターを制御する API 仕様です。

1. 初期化 & 接続管理

PUC_Initialize

PUCRESULT WINAPI PUC_Initialize();

SDK ライブラリを初期化します。アプリケーション起動時に 1 度だけ実行してください。

引数 / 戻り値	型	説明
引数	なし	-
戻り値	`PUCRESULT`	成功時は `PUC_SUCCEEDED` / 失敗時はエラーコード一覧

PUC_DetectDevice

PUCRESULT WINAPI PUC_DetectDevice(PPUC_DETECT_INFO pDetectInfo);

PC に接続されている INFINICAM デバイスを検索します。

引数 / 戻り値	型	説明
`pDetectInfo`	`PPUC_DETECT_INFO`	`[out]` 検出されたデバイス情報の格納先
戻り値	`PUCRESULT`	成功時は `PUC_SUCCEEDED` / 失敗時はエラーコード一覧

PUC_OpenDevice / PUC_CloseDevice

PUCRESULT WINAPI PUC_OpenDevice(UINT32 nDeviceNo, PPUC_HANDLE pDeviceHandle);
PUCRESULT WINAPI PUC_CloseDevice(PUC_HANDLE hDevice);

指定したデバイスのオープンおよびクローズを行います。

引数 / 戻り値	型	説明
`nDeviceNo`	`UINT32`	`[in]` 検索したデバイス ID
`pDeviceHandle`	`PPUC_HANDLE`	`[out]` オープンしたデバイスハンドルの格納先
`hDevice`	`PUC_HANDLE`	`[in]` クローズするデバイスハンドル
戻り値	`PUCRESULT`	成功時は `PUC_SUCCEEDED` / 失敗時はエラーコード一覧

PUC_ResetDevice

PUCRESULT WINAPI PUC_ResetDevice(UINT32 nDeviceNo);

デバイスをハードウェアリセットします。PUC_OpenDevice に失敗した場合のリカバリーとして使用します。

引数 / 戻り値	型	説明
`nDeviceNo`	`UINT32`	`[in]` リセットするデバイス ID
戻り値	`PUCRESULT`	成功時は `PUC_SUCCEEDED` / 失敗時はエラーコード一覧

2. デバイス情報取得

PUC_GetColorType

PUCRESULT WINAPI PUC_GetColorType(PUC_HANDLE hDevice, PUC_COLOR_TYPE* pType);

カメラのカラー / モノクロ仕様を取得します。

引数 / 戻り値	型	説明
`hDevice`	`PUC_HANDLE`	`[in]` デバイスハンドル
`pType`	`PUC_COLOR_TYPE*`	`[out]` カラー種別 (`PUC_COLOR_MONO` / `PUC_COLOR_COLOR`)
戻り値	`PUCRESULT`	成功時は `PUC_SUCCEEDED` / 失敗時はエラーコード一覧

PUC_GetSerialNo

PUCRESULT WINAPI PUC_GetSerialNo(PUC_HANDLE hDevice, UINT64* pSerialNo);

デバイスのシリアル番号を取得します。

引数 / 戻り値	型	説明
`hDevice`	`PUC_HANDLE`	`[in]` デバイスハンドル
`pSerialNo`	`UINT64*`	`[out]` シリアル番号の格納先
戻り値	`PUCRESULT`	成功時は `PUC_SUCCEEDED` / 失敗時はエラーコード一覧

3. 解像度 & 撮影条件設定

PUC_SetResolution / PUC_GetResolution

PUCRESULT WINAPI PUC_SetResolution(PUC_HANDLE hDevice, UINT32 nWidth, UINT32 nHeight);
PUCRESULT WINAPI PUC_GetResolution(PUC_HANDLE hDevice, UINT32* pWidth, UINT32* pHeight);

撮影解像度（幅・高さ）を設定・取得します。

引数 / 戻り値	型	説明
`hDevice`	`PUC_HANDLE`	`[in]` デバイスハンドル
`nWidth` / `pWidth`	`UINT32` / `UINT32*`	横解像度（ピクセル単位）
`nHeight` / `pHeight`	`UINT32` / `UINT32*`	縦解像度（ピクセル単位）
戻り値	`PUCRESULT`	成功時は `PUC_SUCCEEDED` / 不正な値は `PUC_ERROR_ILLEGAL_RESOLUTION`

PUC_SetFramerateShutter / PUC_GetFramerateShutter

PUCRESULT WINAPI PUC_SetFramerateShutter(PUC_HANDLE hDevice, UINT32 nFramerate, UINT32 nShutterSpeedFps);
PUCRESULT WINAPI PUC_GetFramerateShutter(PUC_HANDLE hDevice, UINT32* pFramerate, UINT32* pShutterSpeedFps);

撮影速度 (fps) とシャッター速度 (1/fps) を設定・取得します。

引数 / 戻り値	型	説明
`hDevice`	`PUC_HANDLE`	`[in]` デバイスハンドル
`nFramerate` / `pFramerate`	`UINT32` / `UINT32*`	撮影速度 (fps)
`nShutterSpeedFps` / `pShutterSpeedFps`	`UINT32` / `UINT32*`	シャッター速度 (1/fps 単位)
戻り値	`PUCRESULT`	成功時は `PUC_SUCCEEDED` / 不正な値は `PUC_ERROR_ILLEGAL_FRAME_RATE`