XC-SDK 2018 概要...目次 1 概要 2 1.1 機能概要 ... XC-SDK 2018 概要 ソニーIP&S PPG PD2...

27
XC-SDK 2018 概要 Copyright 2017 Sony IP&S Inc.

Transcript of XC-SDK 2018 概要...目次 1 概要 2 1.1 機能概要 ... XC-SDK 2018 概要 ソニーIP&S PPG PD2...

Page 1: XC-SDK 2018 概要...目次 1 概要 2 1.1 機能概要 ... XC-SDK 2018 概要 ソニーIP&S PPG PD2 設計4 部 2 課 内容の無断転載を禁止します Page 2

XC-SDK 2018 概要

Copyright 2017 Sony IP&S Inc.

Page 2: XC-SDK 2018 概要...目次 1 概要 2 1.1 機能概要 ... XC-SDK 2018 概要 ソニーIP&S PPG PD2 設計4 部 2 課 内容の無断転載を禁止します Page 2

XC-SDK 2018 概要

目次

1 概要 ......................................................................................................................... 2

1.1 機能概要 ................................................................................................................ 2

1.2 構成 ....................................................................................................................... 2

1.3 動作環境 ................................................................................................................ 2

1.4 製品形態 ................................................................................................................ 2

2 製品構成 ................................................................................................................... 3

2.1 ドライバー ................................................................................................................. 3

2.2 ライブラリー ............................................................................................................... 3

2.3 その他 ..................................................................................................................... 3

3 XCCAM API ............................................................................................................ 4

3.1 API の概要 ............................................................................................................. 4

3.2 C++用 API (詳細は各 HELPファイルを参照のこと) ..................................................... 4

3.3 .NET FRAMEWORK対応 API .................................................................................... 7

3.4 カメラクラス API ........................................................................................................ 9

3.5 API比較 .............................................................................................................. 10

4 ヘルプ ...................................................................................................................... 25

4.1 概要 ..................................................................................................................... 25

4.2 説明書の内容 ........................................................................................................ 25

Page 3: XC-SDK 2018 概要...目次 1 概要 2 1.1 機能概要 ... XC-SDK 2018 概要 ソニーIP&S PPG PD2 設計4 部 2 課 内容の無断転載を禁止します Page 2

XC-SDK 2018 概要

ソニーIP&S㈱ PPG PD2 設計 4部 2課 内容の無断転載を禁止します Page 2

1 概要 本仕様書は『XC-SDK version 3』(以下本アプリケーションと記載)の機能概要説明です。

1.1 機能概要

本アプリケーションはWindows上で、GenICamライブラリーによる制御を含め、GigE Vision XCGシリーズ およびUSB3 Vision XCUシリーズ カメラを制御, 動作させるためのドライバー, ライブラリー、及び各種ツール, サンプルにより構成されます。

1.2 構成

本アプリケーションは以下により構成されます。 ドライバー ライブラリー その他:各種ツール, Viewer, 各種ドキュメント

1.3 動作環境

1.3.1 対応 OS サポートOS :Windows 7 Service Pack 1/8.1/10 (32bit/64bit)

※ WindowsXPでは動作しません。 本アプリケーションのドライバーは .NET Framework 4.5向けに作成されており、 WindowsXPは.NET Framework 4.5をサポートしない為です。

1.3.2 対応カメラ ソニー製のすべてのGigE Visionカメラ XCGシリーズ および ソニー製のすべてのUSB3 Visionカメラ XCUシリーズ

1.3.3 対応開発環境 ライブラリーが対応する開発環境は以下のとおり。

Microsoft Visual Studio 2008準拠 (.Net Framework 3.5対応) Microsoft Visual Studio 2010準拠 (.NET Framework 3.5/4 対応)

1.4 製品形態

本アプリケーションはインストーラー、及び付随する説明ドキュメントにて提供されます。 Setup.exe : インストーラー(32bitOS向け) Setup64.exe :インストーラー(64bitOS向け) Manual_J.pdf :導入説明書(日本語) Manual_E.pdf :導入説明書(英語)

Page 4: XC-SDK 2018 概要...目次 1 概要 2 1.1 機能概要 ... XC-SDK 2018 概要 ソニーIP&S PPG PD2 設計4 部 2 課 内容の無断転載を禁止します Page 2

XC-SDK 2018 概要

Page 3 ソニーIP&S㈱ PPG PD2 設計 4部 2課 内容の無断転載を禁止します

2 製品構成

2.1 ドライバー

本アプリケーションは以下のドライバーを含みます。 GigEカメラドライバー :GigEカメラを制御するドライバー USBカメラドライバー :USBカメラを制御するドライバー

2.2 ライブラリー

本アプリケーションは以下のライブラリーを含みます。 GenTL :GenICamトランスポートレイヤーのAPI XC Cam API :アプリケーションレイヤーのカメラ制御の下記3種API

C++用API, .NET Framework対応API, カメラクラスAPI 本アプリケーションをインストール時は、以下のライブラリーをインストールします。

GenICamライブラリー(最新バージョン:GenICam Standard Version 3.0.2)

2.3 その他

本アプリケーションは以下のツール、サンプルを含みます。 ユーティリティソフト (環境設定ツール, ログ取得ツール) サンプルViewer ヘルプ(API仕様, カメラ機能の使用法, 各種ツールの操作説明) GenICam version 3.0.2 サンプルプログラム

ユーザー アプリ XC API GenAPI

XC Cam API GenICam ライブラリー

GenTL

GigEカメラドライバー/USBカメラドライバー

ケーブル

ケーブル

GigEカメラ USBカメラ

Page 5: XC-SDK 2018 概要...目次 1 概要 2 1.1 機能概要 ... XC-SDK 2018 概要 ソニーIP&S PPG PD2 設計4 部 2 課 内容の無断転載を禁止します Page 2

XC-SDK 2018 概要

ソニーIP&S㈱ PPG PD2 設計 4部 2課 内容の無断転載を禁止します Page 4

3 XCCam API

3.1 API の概要

本アプリケーションでは以下のAPIを含みます。 C++用API .NET Framework対応API (C#および、VB.net) カメラクラスAPI

3.2 C++用 API (詳細は各 Help ファイルを参照のこと)

3.2.1 種別 本アプリケーションでは以下の 6種類の API を提供します。

API :カメラの制御、画像を取得するためのAPI GigE Only :GigEカメラ専用API USB Only :USBカメラ専用API Color Conversion :色変換API Feature API :カメラ機能制御のAPI Reg API :カメラのレジスター制御のAPI

3.2.2 API一覧 APIの一覧と種別は以下の通り

API名称 API種別 内容

XCCAM_SetCallBack API システムコールバック関数の設

定 XCCAM_SetStructVersion API 構造体定義バージョンの設定 XCCAM_GetLastError API エラーコード取得 XCCAM_GetList API 接続カメラリスト取得 XCCAM_Open API カメラ使用開始 XCCAM_Close API カメラ使用停止 XCCAM_CloseAll API カメラ使用全停止 XCCAM_Camera API カメラ接続確認 XCCAM_CameraInfo API カメラ情報取得 XCCAM_GetNodeMap API ノードマップ情報取得 XCCAM_ResourceAlloc API 通信資源確保 XCCAM_ResourceRelease API 通信資源解放 XCCAM_ConvMode API XCCAM_GetBMPINFO API XCCAM_BufferConvExec API XCCAM_ImageConvExec API XCCAM_BufferChunkInfo API

Page 6: XC-SDK 2018 概要...目次 1 概要 2 1.1 機能概要 ... XC-SDK 2018 概要 ソニーIP&S PPG PD2 設計4 部 2 課 内容の無断転載を禁止します Page 2

XC-SDK 2018 概要

Page 5 ソニーIP&S㈱ PPG PD2 設計 4部 2課 内容の無断転載を禁止します

XCCAM_ImageChunkInfo API XCCAM_ImageStart API 通信開始 XCCAM_ImageStop API 通信停止 XCCAM_ImageAlloc API 画像データ領域確保 XCCAM_ImageFree API 画像データ領域解放 XCCAM_ImageFreeAll API 画像データ領域全開放 XCCAM_ImageReq API 画像データ取得要求 XCCAM_ImageComplete API 画像データ取得完了待ち XCCAM_ImageReqAbortAll API 画像データ取得キャンセル XCCAM_VSyncReq API VSync 取得要求 XCCAM_VSyncComplete API VSync 取得完了待ち

XCCAM_SetImageCallBack API 画像データ取得コールバック関

数の設定 XCCAM_SetEventCallBack API Event コールバック関数設定 XCCAM_GetLibraryRevision API XC ライブラリリビジョン取得 XCCAM_GetGigEPktLog GigE Only GigE カメラ パケット情報取得

XCCAM_TestStream GigE Only GigE カメラ テストパケット受

信 XCCAM_ResourceAllocGigE GigE Only GigE カメラ 通信資源確保 XCCAM_HeartbeatMode GigE Only Heartbeat時間設定 XCCAM_ActionCommand GigE Only ActionCommand発行

XCCAM_ActionCommandAll GigE Only 全ポート ActionCommand

発行 XCCAM_ActionCommandTime GigE Only XCCAM_ActionCommandAllTime GigE Only

XCCAM_SetActionAckCallBack GigE Only ActionCommand の Ack

受信 XCCAM_SetPacketSizeUSB USB only XCCAM_StreamResetUSB USB only XCCAM_CreateConvHandle Color Conv. XCCAM_CloseConvHandle Color Conv. XCCAM_CloseAllCOnvHandle Color Conv. XCCAM_ColorConvExec Color Conv. XCCAM_ColorConvGetBMPINFO Color Conv. XCCAM_monoBMPINFO Color Conv. XCCAM_CategoryName Feature API XCCAM_FeatureName Feature API XCCAM_FeatureInfo Feature API XCCAM_FeatureDisplayName Feature API XCCAM_FeatureDescription Feature API XCCAM_FeatureToolTip Feature API

Page 7: XC-SDK 2018 概要...目次 1 概要 2 1.1 機能概要 ... XC-SDK 2018 概要 ソニーIP&S PPG PD2 設計4 部 2 課 内容の無断転載を禁止します Page 2

XC-SDK 2018 概要

ソニーIP&S㈱ PPG PD2 設計 4部 2課 内容の無断転載を禁止します Page 6

XCCAM_FeatureUnit Feature API XCCAM_EnumerationEntryName Feature API XCCAM_EnumerationEntryDisplayName Feature API XCCAM_EnumerationEntryDescription Feature API XCCAM_EnumerationEntryToolTip Feature API XCCAM_EnumerationEntryValue Feature API XCCAM_EnumerationEntryIsAvailable Feature API XCCAM_GetFeatureInteger Feature API XCCAM_SetFeatureInteger Feature API XCCAM_GetFeatureFloat Feature API XCCAM_SetFeatureFloat Feature API XCCAM_GetFeatureString Feature API XCCAM_SetFeatureString Feature API XCCAM_GetFeatureBoolean Feature API XCCAM_SetFeatureBoolean Feature API XCCAM_GetFeature Enumeration Feature API XCCAM_SetFeature Enumeration Feature API XCCAM_GetFeature Register Feature API XCCAM_SetFeature Register Feature API XCCAM_Feature Command Feature API XCCAM_Feature Is Available Feature API XCCAM_Feature Is Writeable Feature API XCCAM_Feature Is Readable Feature API XCCAM_ReadReg Reg API レジスタ読出し XCCAM_WriteReg Reg API レジスタ書き込み XCCAM_ReadMem Reg API メモリ読み出し XCCAM_WriteMem Reg API メモリ書き込み

Page 8: XC-SDK 2018 概要...目次 1 概要 2 1.1 機能概要 ... XC-SDK 2018 概要 ソニーIP&S PPG PD2 設計4 部 2 課 内容の無断転載を禁止します Page 2

XC-SDK 2018 概要

Page 7 ソニーIP&S㈱ PPG PD2 設計 4部 2課 内容の無断転載を禁止します

3.3 .Net Framework対応 API

3.3.1 種別 .Net Frameworkに対応したAPIを以下のクラスで提供します

XCCAMクラス カメラを制御するためのクラス XCCAM_WATCHクラス 複数PCで1台のカメラの映像を共有するためのクラス XCCOMVクラス 色変換を行うためのクラス

3.3.2 API一覧

APIの一覧とクラスは以下の通り API名称 クラス 内容 SetCallBack XCCAM システムコールバック設定 SetStructVersion XCCAM 構造体定義バージョンの設定 GetLastError XCCAM ライブラリエラーコード取得 GetList XCCAM 接続カメラリスト取得 XCCAM XCCAM カメラ使用開始 Dispose XCCAM カメラ使用停止 CameraInfo XCCAM カメラ情報取得 CameraInfoGigE XCCAM GigEカメラ情報取得 CameraInfoUSB XCCAM USBカメラ情報取得 Camera XCCAM カメラ接続確認 ResourceAlloc XCCAM 資源確保 ResourceAllocGigE XCCAM GigE資源確保 ResourceRelease XCCAM 資源解放 GetGigEPktLog XCCAM GigEパケットログ取得 TestStreamGigE XCCAM GigE テストパケット受信 Camera XCCAM カメラ接続確認 ResourceAlloc XCCAM 資源確保 ResourceAllocGigE XCCAM GigE資源確保 ResourceRelease XCCAM 資源解放 GetGigEPktLog XCCAM GigEパケットログ取得 TestStreamGigE XCCAM GigE テストパケット受信 ConvMode XCCAM 色変換モード設定 SetBMPINFO XCCAM BITMAPINFO情報設定 GetImageInfo XCCAM Image情報取得 BufferConvExec XCCAM 色変換実行

Page 9: XC-SDK 2018 概要...目次 1 概要 2 1.1 機能概要 ... XC-SDK 2018 概要 ソニーIP&S PPG PD2 設計4 部 2 課 内容の無断転載を禁止します Page 2

XC-SDK 2018 概要

ソニーIP&S㈱ PPG PD2 設計 4部 2課 内容の無断転載を禁止します Page 8

ImageConvExec XCCAM 色変換実行 ImageStart XCCAM 画像転送開始 ImageStop XCCAM 画像転送停止 ImageAlloc XCCAM イメージバッファ割当 ImageFree XCCAM イメージバッファ解放 ImageReq XCCAM 画像データ取得要求 ImageComplete XCCAM 画像データ取得完了待ち ImageReqAbortAll XCCAM 画像データ取得キャンセル VSyncReq XCCAM VSync取得要求 VSyncComplete XCCAM VSync取得完了待ち SetImageCallBack XCCAM イメージ取得コールバック設定 GetImageStruct XCCAM イメージバッファ構造体取得 MonoBMPINFO XCCAM MONO用 BITMAPINFO情報設定 GetLibraryRevision XCCAM ライブラリのリビジョン取得 Reset XCCAM リソース再初期化 ReDetection XCCAM 構成の確認 CategoryList XCCAM カテゴリリスト取得 CameraStandby XCCAM_WATCH 画像(ストリーム)データ通信状態の確認 XCCAM_WATCHGIGE XCCAM_WATCH カメラ使用開始 XCCOMV XCCONV 変換テーブル作成 Dispose XCCONV 変換テーブル解放 ConvExec XCCONV 変換実行 SetBMPINFO XCCONV BITMAPINFO情報設定

Page 10: XC-SDK 2018 概要...目次 1 概要 2 1.1 機能概要 ... XC-SDK 2018 概要 ソニーIP&S PPG PD2 設計4 部 2 課 内容の無断転載を禁止します Page 2

XC-SDK 2018 概要

Page 9 ソニーIP&S㈱ PPG PD2 設計 4部 2課 内容の無断転載を禁止します

3.4 カメラクラス API

クラス定義による API を提供します。 カメラオープン UID指定 UserName指定

void CSonyCam() void CSonyCam( UINT64 UID ) void CSonyCam( std::string UserName )

カメラ一覧取得 void GetCameraList( CameraList* List ) ベンダー名取得 std::string GetVendorName() モデル名取得 std::string GetModelName() シリアル番号取得 std::string GetSerialNumber() バージョン番号取得 ULONG GetGigEVersion() ノードマップアドレス取得 void* GetNodeMap() Feature値取得 void GetFeature( std::string Fname, INT64& Value )

void GetFeature( std::string Fname, double& Value ) void GetFeature( std::string Fname, std::string& Value ) void GetFeature( std::string Fname, BYTE& Value, UINT32& Length ) void GetFeature( std::string Fname, bool& Value )

Feature値設定 void SetFeature( std::string Fname, INT64 Value ) void SetFeature( std::string Fname, double Value ) void SetFeature( std::string Fname, std::string Value ) void SetFeature( std::string Fname, BYTE& Value, UINT32& Length ) void SetFeature( std::string Fname, bool Value ) void SetFeature( std::string Fname )

画像受信開始 void StreamStart() 画像受信終了 void StreamStop() 現在の画像取得 void Capture( void* pBuffer ) 画像取得キューイング void QueueCapture( void* pBuffer ) 画像取得完了確認 void QueueCaptureComplete( void* pBuffer , ULONG

TimeOut ) 現在の画像保存 void CaptureFile( std::string FIleName ) 画像保存キューイング void QueueCaptureFile(std::string FIleName) 画像保存完了確認 void QueueCaptureFileComplete(std::string FIleName,

ULONG TimeOut ) AVIファイル保存開始 void CaptureAVIFile(std::string FIleName ) AVIファイル保存終了 void CaptureAVIFile( )

Page 11: XC-SDK 2018 概要...目次 1 概要 2 1.1 機能概要 ... XC-SDK 2018 概要 ソニーIP&S PPG PD2 設計4 部 2 課 内容の無断転載を禁止します Page 2

XC-SDK 2018 概要

ソニーIP&S㈱ PPG PD2 設計 4部 2課 内容の無断転載を禁止します Page 10

3.5 API比較

本アプリケーションと従来品 「XC-SDK2017 version2」 のAPIとの違いを示します。 3.5.1 C++用 API

Version 2 Version 3 API種別 内容 XCCAM_SetCallBack XCCAM_SetCallBack API 変更無し XCCAM_SetStructVersion XCCAM_SetStructVersion API 変更無し XCCAM_GetLastError XCCAM_GetErrorMsg API エラー番号からメッセージに変更 XCCAM_GetList XCCAM_GetList API 詳細内容を変更あり

Bootstrap Registers の内容を返す XCCAM_Open XCCAM_Open API パラメーター変更

要求を構造体で指定する XCCAM_Close XCCAM_Close API 変更無し XCCAM_CloseAll XCCAM_CloseAll API 変更無し XCCAM_Camera XCCAM_Camera API 変更無し XCCAM_CameraInfo XCCAM_CameraInfo API 詳細内容に変更あり XCCAM_GetNodeMap XCCAM_GetNodeMap API 変更無し XCCAM_GetFeatureHandle API 新規

GenAPI 用の C 言語インタフェース用 XCCAM_ResourceAlloc XCCAM_ResourceAlloc API XCCAM_WatchAlloc を廃止で機

能を共有 XCCAM_ResourceRelease XCCAM_ResourceRelease API 変更無し XCCAM_ConvMode XCCAM_SetConvMode API 名称変更 XCCAM_GetBMPINFO XCCAM_GetBMPINFO API 変更無し XCCAM_BufferConvExec XCCAM_ImageConvExec

XCCAM_ConvExec API パラメータを変更して共通にする

Page 12: XC-SDK 2018 概要...目次 1 概要 2 1.1 機能概要 ... XC-SDK 2018 概要 ソニーIP&S PPG PD2 設計4 部 2 課 内容の無断転載を禁止します Page 2

XC-SDK 2018 概要

Page 11 ソニーIP&S㈱ PPG PD2 設計 4部 2課 内容の無断転載を禁止します

XCCAM_BufferChunkInfo XCCAM_ImageChunkInfo

XCCAM_GetChunkInfo API パラメータを変更して共通にする

XCCAM_ImageStart XCCAM_ImageStart API 変更無し XCCAM_ImageStop XCCAM_ImageStop API 変更無し XCCAM_ImageAlloc XCCAM_ImageAlloc API 変更無し XCCAM_ImageFree XCCAM_ImageFree API 変更無し XCCAM_ImageFreeAll XCCAM_ImageFreeAll API 変更無し XCCAM_ImageReq XCCAM_ImageReq API 変更無し XCCAM_ImageComplete XCCAM_ImageComplete API 変更無し XCCAM_ImageReqAbortAll XCCAM_ImageReqAbortAll API 変更無し XCCAM_VSyncReq XCCAM_VSyncReq API 変更無し XCCAM_VSyncComplete XCCAM_VSyncComplete API 変更無し XCCAM_SetImageCallBack XCCAM_SetImageCallBack API 変更無し XCCAM_SetEventCallBack XCCAM_SetEventCallBack API 変更無し XCCAM_SetCmdTimeOut API 新規

一時的コマンドタイムアウト時間の変更 XCCAM_GetLibraryRevision XCCAM_GetLibraryRevision API 変更無し XCCAM_Reset API 廃止 XCCAM_ReDetection API 廃止 XCCAM_OpenGigE API 廃止 XCCAM_CameraInfoGigE API 廃止

Page 13: XC-SDK 2018 概要...目次 1 概要 2 1.1 機能概要 ... XC-SDK 2018 概要 ソニーIP&S PPG PD2 設計4 部 2 課 内容の無断転載を禁止します Page 2

XC-SDK 2018 概要

ソニーIP&S㈱ PPG PD2 設計 4部 2課 内容の無断転載を禁止します Page 12

XCCAM_GetGigEPktLog XCCAM_GetGigEPktLog GigE Only 変更無し XCCAM_TestStream XCCAM_TestStream GigE Only 変更無し XCCAM_GetGigEPktLog XCCAM_GetGigEPktLog GigE Only 変更無し XCCAM_TestStream XCCAM_TestStream GigE Only 変更無し XCCAM_ResourceAllocGigE XCCAM_ResourceAllocGigE GigE Only 指定可能の IP Addr を他の PC も可

能とする XCCAM_HeartbeatMode XCCAM_HeartbeatMode GigE Only 変更無し XCCAM_LostPktMode GigE Only 新規

パケット抜け時のデータクリア機能 XCCAM_BandAdjust GigE Only 新規

帯域制限による GevSCPD の設定 XCCAM_ActionCommand XCCAM_ActionCommand GigE Only 変更無し XCCAM_ActionCommandAll XCCAM_ActionCommandAll GigE Only 変更無し XCCAM_ActionCommandTime XCCAM_ActionCommandTime GigE Only 変更無し XCCAM_ActionCommandAllTime XCCAM_ActionCommandAllTime GigE Only 変更無し XCCAM_SetActionAckCallBack XCCAM_SetActionAckCallBack GigE Only 変更無し XCCAM_ControlCamera GigE Only 新規 XCCAM_SetPacketSizeUSB USB Only 新規 XCCAM_StreamResetUSB USB Only 新規 XCCAM_CreateConvHandle XCCAM_CreateConvHandle Color Conversion 変更無し XCCAM_CloseConvHandle XCCAM_CloseConvHandle Color Conversion 変更無し XCCAM_CloseAllConvHandle XCCAM_CloseAllConvHandle Color Conversion 変更無し XCCAM_ColorConvExec XCCAM_ColorConvExec Color Conversion 変更無し XCCAM_ColorConvGetBMPINFO XCCAM_ColorConvGetBMPINFO Color Conversion 変更無し

XCCAM_MonoBMPINFO XCCAM_MonoBMPINFO Color Conversion 変更無し

Page 14: XC-SDK 2018 概要...目次 1 概要 2 1.1 機能概要 ... XC-SDK 2018 概要 ソニーIP&S PPG PD2 設計4 部 2 課 内容の無断転載を禁止します Page 2

XC-SDK 2018 概要

Page 13 ソニーIP&S㈱ PPG PD2 設計 4部 2課 内容の無断転載を禁止します

XCCAM_CategoryName Feature API 新規 XCCAM_FeatureName Feature API 新規 XCCAM_FeatureInfo Feature API 新規 XCCAM_FeatureDisplayName Feature API 新規 XCCAM_FeatureDescription Feature API 新規 XCCAM_FeatureToolTip Feature API 新規 XCCAM_FeatureUnit Feature API 新規 XCCAM_EnumerationEntryName Feature API 新規 XCCAM_EnumerationEntryDisplayName Feature API 新規 XCCAM_EnumerationEntryDescription Feature API 新規 XCCAM_EnumerationEntryToolTip Feature API 新規 XCCAM_EnumerationEntryValue Feature API 新規 XCCAM_EnumerationEntryIsAvailable Feature API 新規 XCCAM_GetFeatureInteger Feature API 新規 XCCAM_SetFeatureInteger Feature API 新規 XCCAM_GetFeatureFloat Feature API 新規 XCCAM_SetFeatureFloat Feature API 新規 XCCAM_GetFeatureString Feature API 新規 XCCAM_SetFeatureString Feature API 新規 XCCAM_GetFeatureBoolean Feature API 新規 XCCAM_SetFeatureBoolean Feature API 新規 XCCAM_GetFeatureEnumeration Feature API 新規 XCCAM_SetFeatureEnumeration Feature API 新規 XCCAM_GetFeatureRegister Feature API 新規 XCCAM_SetFeatureRegiste Feature API 新規 XCCAM_FeatureCommand Feature API 新規 XCCAM_FeatureIsAvailabl Feature API 新規

Page 15: XC-SDK 2018 概要...目次 1 概要 2 1.1 機能概要 ... XC-SDK 2018 概要 ソニーIP&S PPG PD2 設計4 部 2 課 内容の無断転載を禁止します Page 2

XC-SDK 2018 概要

ソニーIP&S㈱ PPG PD2 設計 4部 2課 内容の無断転載を禁止します Page 14

XCCAM_FeatureIsWritable Feature API 新規 XCCAM_FeatureIsReadable Feature API 新規 XCCAM_ReadReg XCCAM_ReadReg Reg_API 変更無し XCCAM_ReadMem XCCAM_ReadMem Reg_API 変更無し XCCAM_WriteReg XCCAM_WriteReg Reg_API 変更無し XCCAM_WriteMem XCCAM_WriteMem Reg_API 変更無し XCCAM_WriteRegAll Reg_API 新規

レジスター書き込みのブロードキャスト機能

XCCAM_WatchOpen WATCHクラス 削除 XCCAM_WatchOpenGigE WATCHクラス 削除 XCCAM_WatchClose WATCHクラス 削除 XCCAM_WatchCamera WATCHクラス 削除 XCCAM_WatchAlloc WATCHクラス 削除 XCCAM_WatchRelease WATCHクラス 削除 XCCAM_WatchStart WATCHクラス 削除 XCCAM_WatchStop WATCHクラス 削除

Page 16: XC-SDK 2018 概要...目次 1 概要 2 1.1 機能概要 ... XC-SDK 2018 概要 ソニーIP&S PPG PD2 設計4 部 2 課 内容の無断転載を禁止します Page 2

XC-SDK 2018 概要

Page 15 ソニーIP&S㈱ PPG PD2 設計 4部 2課 内容の無断転載を禁止します

3.5.2 C++用構造体

詳しくは、「XCCampAPI.h」を参照ください

Structure name Version 2 Version 3 The contents XCCAM_GIGESTREAMTYPE typedef enum

XCCAM_GIGEIMAGEDATA= 1, XCCAM_GIGERAWDATA, XCCAM_GIGEFILEDATA, XCCAM_GIGECHUNKDATA, XCCAM_GIGEEXTCHUNKDATA, XCCAM_GIGEVENDORDATA= 0x8000,

← 変更無し

XCCAM_TRANSMITSPEED typedef enum

XCCAM_S100M= 0, XCCAM_S200M, XCCAM_S400M, XCCAM_S800M, XCCAM_S1600M, XCCAM_S3200M, XCCAM_S1000M, XCCAM_SUSB2, XCCAM_SUSB3,

XCCAM_S100M= 0, XCCAM_S1000M, XCCAM_SUSB2=100, XCCAM_SUSB3,

いくつかのメンバーを削除

XCCAM_DIBMODE typedef enum

XCCAM_DIB32= 0, XCCAM_DIB24,

← 変更無し

Page 17: XC-SDK 2018 概要...目次 1 概要 2 1.1 機能概要 ... XC-SDK 2018 概要 ソニーIP&S PPG PD2 設計4 部 2 課 内容の無断転載を禁止します Page 2

XC-SDK 2018 概要

ソニーIP&S㈱ PPG PD2 設計 4部 2課 内容の無断転載を禁止します Page 16

XCCAM_STOREMODE typedef enum

XCCAM_MEMmode= 0, XCCAM_MEMmodeLR, XCCAM_BMPmode, XCCAM_BMPmodeLR,

← 変更無し

XCCAM_ENDIAN typedef enum

XCCAM_BIGENDIAN= 0, XCCAM_LITTLEENDIAN

← 変更無し

XCCAM_CAMERATYPE typedef enum

XCCAM_CAMERA1394= 0, XCCAM_CAMERAGIGE, XCCAM_CAMERAUSB

XCCAM_DEVICETYPE と置き換え

XCCAM_DEVICETYPE typedef enum

XCCAM_UNKNOWNDEV= -1, XCCAM_ANYDEV = 0, XCCAM_GIGECAMERA, XCCAM_USBCAMERA,

新規

XCCAM_OPENMODE typedef enum

XCCAM_AUTO_ACCESS= 0, XCCAM_READONLY_ACCESS, XCCAM_CONTROL_ACCESS, XCCAM_EXCLUSIVE_ACCESS,

新規

XCCAM_FEATURETYPE typedef enum

XCCAM_INTEGERTYPE= 0, XCCAM_BOOLEANTYPE, XCCAM_FLOATTYPE, XCCAM_STRINGTYPE, XCCAM_COMMANDTYPE, XCCAM_ENUMERATIONTYPE, XCCAM_CATRGORYTYPE,

新規

Page 18: XC-SDK 2018 概要...目次 1 概要 2 1.1 機能概要 ... XC-SDK 2018 概要 ソニーIP&S PPG PD2 設計4 部 2 課 内容の無断転載を禁止します Page 2

XC-SDK 2018 概要

Page 17 ソニーIP&S㈱ PPG PD2 設計 4部 2課 内容の無断転載を禁止します

XCCAM_REGISTERTYPE

STATUS_SYSTEMCODE typedef enum

STATUSXCCAM_BUSRESET= 1, STATUSXCCAM_POWERUP

STATUSXCCAM_POWERUP= 1, STATUSXCCAM_DEVICECHANGE,

メンバー変更

STATUS_IMAGE typedef enum

STATUSIMAGE_COMPLETE= 0, STATUSIMAGE_REQUEST_PENDING, STATUSIMAGE_REQUEST_ERROR, STATUSIMAGE_REQUEST_RESTART,

新規

STATUS_RTNCODE typedef enum

STATUSXCCAM_COMPLETE=0, STATUSXCCAM_PARAMETER_ERROR, STATUSXCCAM_BUFFER_SHORT, etc.

XCCAM_OPENMODE と STATUS_IMAGE に分割

XCCAM_CAMERAINFO typedef struct *pXCCAM_CAMERAINFO;

UINT64 UID; DWORD BusNumber; XCCAM_CAMERATYPE CameraType; XCCAM_TRANSMITSPEED Speed; BYTE VendorName[ 256 ]; BYTE ModelName[ 256 ];

XCCAM_CmeraInfo用構造体 廃止

Page 19: XC-SDK 2018 概要...目次 1 概要 2 1.1 機能概要 ... XC-SDK 2018 概要 ソニーIP&S PPG PD2 設計4 部 2 課 内容の無断転載を禁止します Page 2

XC-SDK 2018 概要

ソニーIP&S㈱ PPG PD2 設計 4部 2課 内容の無断転載を禁止します Page 18

XCCAM_GIGECAMERAINFO typedef struct *pXCCAM_GIGECAMERAINFO;

DWORD BusNumber; BYTE MACAddr[ 6 ]; WORD Spec_Major; WORD Spec_Minor; DWORD Dev_Mode; BYTE VendorName[ 32 ]; BYTE ModelName[ 32 ]; BYTE Dev_Ver[ 32 ]; BYTE Vendor_Info[ 48 ]; BYTE SerialNumber[ 16 ]; BYTE UserName[ 16 ];

XCCAM_GigECmeraInfo用構造体 XCCAM_GIGEDEVINFO と置き換え

XCCAM_GIGEDEVINFO typedef struct *pXCCAM_GIGEDEVINFO;

WORD Spec_Major; WORD Spec_Minor; DWORD Dev_Mode; DWORD IPConfig; DWORD IPConfigOption; BYTE MACAddr[ 6 ]; BYTE IPAddr[ 4 ]; BYTE SubMask[ 4 ]; BYTE GateWay[ 4 ]; char VendorName[ 32 ]; char Rsvd; char ModelName[ 32 ]; char Rsvd1; char Dev_Ver[ 32 ]; char Rsvd2; char Vendor_Info[ 48 ];

新規

Page 20: XC-SDK 2018 概要...目次 1 概要 2 1.1 機能概要 ... XC-SDK 2018 概要 ソニーIP&S PPG PD2 設計4 部 2 課 内容の無断転載を禁止します Page 2

XC-SDK 2018 概要

Page 19 ソニーIP&S㈱ PPG PD2 設計 4部 2課 内容の無断転載を禁止します

char Rsvd3; char SerialNumber[ 16 ]; char Rsvd4; char UserName[ 16 ]; DWORD Rsvd5;

XCCAM_USBCAMERAINFO typedef struct *pXCCAM_USBCAMERAINFO;

DWORD BusNumber; DWORD GenCP_Version; BYTE VendorName[ 64 ]; BYTE ModelName[ 64 ]; BYTE FamilyName[ 64 ]; BYTE Dev_Version[ 64 ]; BYTE Vendor_Info[ 64 ]; BYTE SerialNumber[ 64 ]; BYTE UserName[ 64 ]; UINT64 Dev_Capability;

XCCAM_USBCameraInfo用構造体 XCCAM_USBDEVINFO と置き換え

XCCAM_USBDEVINFO typedef struct *pXCCAM_USBDEVINFO;

UINT64 Dev_Capability; DWORD GenCP_Version; char VendorName[ 64 ]; char Rsvd; char ModelName[ 64 ]; char Rsvd1; char FamilyName[ 64 ]; char Rsvd2; char Dev_Version[ 64 ]; char Rsvd3; char Vendor_Info[ 64 ]; char Rsvd4; char SerialNumber[ 64 ];

新規

Page 21: XC-SDK 2018 概要...目次 1 概要 2 1.1 機能概要 ... XC-SDK 2018 概要 ソニーIP&S PPG PD2 設計4 部 2 課 内容の無断転載を禁止します Page 2

XC-SDK 2018 概要

ソニーIP&S㈱ PPG PD2 設計 4部 2課 内容の無断転載を禁止します Page 20

char Rsvd5; char UserName[ 64 ]; DWORD Rsvd6;

XCCAM_LIST typedef struct *pXCCAM_LIST;

DWORD CameraCount; XCCAM_CAMERAINFO Info[ 1 ];

DWORD Count; XCCAM_DEVINFO Info[ 1 ];

XCCAM_GetList用構造体 メンバー変更

XCCAM_OPENPARAM typedef struct *pXCCAM_OPENPARAM;

XCCAM_DEVICETYPE DeviceType; UINT64 UID; BYTE IPAddr[ 4 ]; char UserName[ 64 ]; ULONG Rsvd; XCCAM_OPENMODE AccMode; BOOL XML_DiskFlag;

XCCAM_Open用構造体

XCCAM_OPENREQUEST typedef struct *pXCCAM_OPENREQUEST;

UINT64 UID; DWORD URLIdx; BYTE UserName[ 64 ];

XCCAM_OpenGigE用構造体 廃止

XCCAM_IMAGE typedef struct

DWORD Width; DWORD Height; BYTE *pBuffer; DWORD Length;

DWORD Width; DWORD Height; BYTE *pBuffer; DWORD Length;

Member is changed

Page 22: XC-SDK 2018 概要...目次 1 概要 2 1.1 機能概要 ... XC-SDK 2018 概要 ソニーIP&S PPG PD2 設計4 部 2 課 内容の無断転載を禁止します Page 2

XC-SDK 2018 概要

Page 21 ソニーIP&S㈱ PPG PD2 設計 4部 2課 内容の無断転載を禁止します

*pXCCAM_IMAGE; DWORD PixelFormatID; XCCAM_ENDIAN EndianMode; STATUS_RTNCODE Status;

DWORD PixelFormatID; XCCAM_ENDIAN EndianMode; STATUS_IMAGE Status;

XCCAM_USBSTREAMINFO Typedef struct *pXCCAM_GIGESTREAMINFO;

DOWRD Stream_Type; etc.

← 変更無し

XCCAM_IMAGEDATAINFO typedef struct *pXCCAM_IMAGEDATAINFO;

XCCAM_CAMERATYPE CameraType; union U {

struct C1394 {

XCCAM_TRANSMITSPEED Speed;

DWORD CycleTime_S; DWORD CycleCount_S; DWORD CycleTime_E; DWORD CycleCount_E;

} C1394; struct CGIGE {

BOOL Payload_Flag; XCCAM_GIGESTREAMINFO

StreamInfo; } CGigE;

XCCAM_DEVICETYPE DeviceType; union U {

struct CGIGE {

BOOL Payload_Flag; XCCAM_GIGESTREAMINFO

StreamInfo; } CGigE; struct CUSB {

BOOL Payload_Flag; XCCAM_USBSTREAMINFO

StreamInfo; } CUsb;

} u;

1394 メンバーを削除

Page 23: XC-SDK 2018 概要...目次 1 概要 2 1.1 機能概要 ... XC-SDK 2018 概要 ソニーIP&S PPG PD2 設計4 部 2 課 内容の無断転載を禁止します Page 2

XC-SDK 2018 概要

ソニーIP&S㈱ PPG PD2 設計 4部 2課 内容の無断転載を禁止します Page 22

struct CUSB {

BOOL Payload_Flag; XCCAM_USBSTREAMINFO

StreamInfo; } CUsb;

} u; XCCAM_PKTLOG typedef struct *pXCCAM_PKTLOG;

UINT64 ToTalPktCount; UINT64 ErrorPktCount; UINT64 RetryCount;

UINT64 ToTalPktCount; UINT64 ErrorPktCount; UINT64 RSendCount;

GigEGetPktLog用構造体 メンバー変更

XCCAM_COLORVALUE typedef struct *pXCCAM_COLORVALUE;

double R_Value; double G1_Value; double G2_Value; double B_Value;

← 変更無し

XCCAM_COLORCONVMODE typedef struct *pXCCAM_COLORCONVMODE;

XCCAM_STOREMODE StoreMode; XCCAM_SHIFTID ShiftID; XCCAM_DIBMODE DIBMode; DWORD Parallel_Thread; BOOL BayerRevision_G;

XCCAM_STOREMODE StoreMode; XCCAM_SHIFTID ShiftID; XCCAM_DIBMODE DIBMode; DWORD Parallel_Thread; BOOL BayerRevision_G;

メンバー変更

Page 24: XC-SDK 2018 概要...目次 1 概要 2 1.1 機能概要 ... XC-SDK 2018 概要 ソニーIP&S PPG PD2 設計4 部 2 課 内容の無断転載を禁止します Page 2

XC-SDK 2018 概要

Page 23 ソニーIP&S㈱ PPG PD2 設計 4部 2課 内容の無断転載を禁止します

BOOL Parallel_Flag;

XCCAM_EVENTINFO typedef struct *pXCCAM_EVENTINFO;

USHORT EventID; union U {

struct CGIGE {

USHORT StreamIndex; UINT64 BlockID; UINT64 TimeStamp; UINT32 Length; UCHAR Data[ 4 ];

} CGigE; struct CUSB {

UINT64 TimeStamp; UINT32 Length; UCHAR Data[ 4 ];

} CUsb; } u;

USHORT EventID; union U {

struct CGIGE {

WORD StreamIndex; UINT64 BlockID; UINT64 TimeStamp; DWORD Length; BYTE Data[ 4 ];

} CGigE; struct CUSB {

UINT64 TimeStamp; DWORD Length; BYTE Data[ 4 ];

} CUsb; } u;

メンバーの型を変更

XCCAM_CHUNKINFO typedef struct *pXCCAM_CHUNKINFO;

DWORD Count; struct INFO {

DWORD ChunkID; DWORD Length; PVOID pChunkData;

} Info[ 1 ];

← 変更無し

Page 25: XC-SDK 2018 概要...目次 1 概要 2 1.1 機能概要 ... XC-SDK 2018 概要 ソニーIP&S PPG PD2 設計4 部 2 課 内容の無断転載を禁止します Page 2

XC-SDK 2018 概要

ソニーIP&S㈱ PPG PD2 設計 4部 2課 内容の無断転載を禁止します Page 24

XCCAM_FEATUREINFO typedef struct *pXCCAM_FEATUREINFO;

XCCAM_FEATURETYPE FType; UINT64 PollingTime; union U {

struct INTREG {

INT64 MinValue; INT64 MaxValue; INT64 IncValue;

} IntReg; struct FLOATREG {

double MinValue; double MaxValue; double IncValue; BOOL HasInc;

} FloatReg; struct STRINGREG {

UINT64 MaxLength; } StringReg; struct REG {

INT64 Addr; UINT64 Length;

} Reg; } u;

新規 XCCAM_FeatureInfo用構造体

Page 26: XC-SDK 2018 概要...目次 1 概要 2 1.1 機能概要 ... XC-SDK 2018 概要 ソニーIP&S PPG PD2 設計4 部 2 課 内容の無断転載を禁止します Page 2

XC-SDK 2018 概要

Page 25 ソニーIP&S㈱ PPG PD2 設計 4部 2課 内容の無断転載を禁止します

4 ヘルプ

4.1 概要

4.1.1 提供形式 HTML Help形式です。

4.1.2 提供内容 以下の説明書を提供いたします。

ユーティリティソフトの説明書 Viewer の説明書 APIの説明書/カメラ機能等の説明書

4.1.3 サンプルとの融合 各APIの説明,各機能の説明にコード例を付記します。

4.2 説明書の内容

4.2.1 ユーティリティソフトの説明書 操作方法を説明します。

4.2.2 Viewerの説明書 Viewerの操作方法を説明します。

4.2.3 API, カメラ機能等の説明書 A. 記述内容

下記についての説明を記述します。

Page 27: XC-SDK 2018 概要...目次 1 概要 2 1.1 機能概要 ... XC-SDK 2018 概要 ソニーIP&S PPG PD2 設計4 部 2 課 内容の無断転載を禁止します Page 2

XC-SDK 2018 概要

ソニーIP&S㈱ PPG PD2 設計 4部 2課 内容の無断転載を禁止します Page 26

♦ API の仕様 各APIの仕様を記述します。

♦ カメラの各機能 以下のカメラ機能について、サンプルコードを提供します。 Trigger等のカメラ設定の説明 マルチキャスト等のカメラ使用方法の説明