Copyright 2017 Sony IP&S Inc. XC-SDK 2018 Overview

Transcription

1 Copyright 2017 Sony IP&S Inc. XC-SDK 2018 Overview

2 The contents 1 THE OVERVIEW THE FUNCTIONAL-DESCRIPTION THE COMPOSITION THE SYSTEM REQUIREMENTS THE PRODUCT FORM THE PRODUCT STRUCTURE THE DRIVER THE LIBRARY THE OTHER XCCAM API THE OVERVIEW OF API API FOR THE C++ (FOR THE DETAILS, REFER TO EACH HELP FILE) API FOR.NET FRAMEWORK THE CAMERA CLASS API THE API COMPARISON THE HELP THE OVERVIEW THE CONTENTS OF THE MANUAL... 31

3 1 The overview This specification is the functional-description explanation of "XC-SDK 2018" (hereinafter, it is called this application ). 1.1 The functional-description On Microsoft Windows OS, including the control by the GenICam library, it controls GigE Vision XCG series and USB3 Vision XCU series. And this application is composed by the driver, the library to work, and the various tools, the sample programs. 1.2 The composition This application is composed below. The driver The library The other : The various tools, Viewer, the various documents 1.3 The system requirements The compatible OS Support OS:Microsoft Windows 7 Service Pack 1/8.1/10 (64 bits of 32bit) WindowsXP Then, it doesn't work. The driver of this application is.net Framework It is created for 4.5. Because WindowsXP doesn't support.net Framework The compatible camera All GigE Vision cameras which are made by Sony XCG series And All USB3 vision cameras which are made by Sony XCU series The compatible development environment The development environment that the library supports is as the following. Microsoft Visual Studio Doing 2008 based (.Net Framework 3.5 supports) Microsoft Visual Studio Doing 2010 based (.NET Framework 3 supports) 1.4 The product form This application is provided with the installer and the accompanying explanation document. Setup.exe : The installer (For 32bitOS) Sony IP&S inc. PPG PD2 DD4 section 2. It prohibits reprinting contents without notice. Page 2

4 Setup64. exe : The installer (For 64bitOS) Manual_J.pdf : The introduction manual (in Japanese) Manual_E.pdf : The introduction manual (in English) Page3 Sony IP&S Four PPG PD2-design section 2 It prohibits reprinting contents without notice.

5 2 The product structure 2.1 The driver This application includes the following driver. The GigE camera driver : The driver who controls GigE camera The USB camera driver : The driver who controls USB camera 2.2 The library This application includes the following library. The API of the GenTL:GenICam transport layer XC Cam API : Three kinds of API the following of the camera control of the application layer The API for the C++, the API which is compatible with.net Framework, the camera class API When installing this application, it installs the following library. GenICam library (The latest version :GenICam Standard Version 3.0.2) Sony IP&S inc. PPG PD2 DD4 section 2. It prohibits reprinting contents without notice. Page 4

6 2.3 The other This application includes the following tool, a sample. The utility software (The environment setting tool, the log acquisition tool) Sample Viewer The help (The API specification, the usage of the camera feature, the operation explanation of the various tool) GenICam version The sample program User Application XC API GenAPI XC Cam API GenICam The library GenTL The GigE camera driver/the USB camera driver The cable The GigE camera The cable The USB camera Page5 Sony IP&S Four PPG PD2-design section 2 It prohibits reprinting contents without notice.

7 3 XCCam API 3.1 The overview of API It includes the following API in this application. API for the C++ API for.net Framework (C# and VB.net) The camera class API 3.2 API for the C++ (For the details, refer to each Help file) The classification In this application, it provides six kinds of the following API. The API : The API to acquire the control of the camera, an image GigE Only : The GigE camera exclusive use API USB Only : The USB camera exclusive use API Color Conversion : The color change API : The API of the camera function control RegThe API : The API of the register control by the camera The API list The list and the classification of the API are as the following. The API name The API The contents classification XCCAM_SetCallBack The API The setting of a system call back function XCCAM_SetStructVersion The API The setting of a structure definition version XCCAM_GetLastError The API The error code acquisition XCCAM_GetList The API The connection camera list acquisition XCCAM_Open The API The camera connecting XCCAM_Close The API The camera deactivating XCCAM_CloseAll The API The camera use master-stop XCCAM_Camera The API The camera connectacknowledge Sony IP&S inc. PPG PD2 DD4 section 2. It prohibits reprinting contents without notice. Page 6

8 XCCAM_CameraInfo The API The camera information acquisition XCCAM_GetNodeMap The API The node mapping information acquisition XCCAM_ResourceAlloc The API The communication resource securing XCCAM_ResourceRelease The API The communication resource release XCCAM_ConvMode The API XCCAM_GetBMPINFO The API XCCAM_BufferConvExec The API XCCAM_ImageConvExec The API XCCAM_BufferChunkInfo The API XCCAM_ImageChunkInfo The API XCCAM_ImageStart The API The start-of-message XCCAM_ImageStop The API The communication stop XCCAM_ImageAlloc The API The image data area securing XCCAM_ImageFree The API The image data area release XCCAM_ImageFreeAll The API All the image data area opening XCCAM_ImageReq The API The image data acquisition request XCCAM_ImageComplete The API The image data acquisition completion wait XCCAM_ImageReqAbortAll The API The image data acquisition cancellation XCCAM_VSyncReq The API VSyncThe acquisition request XCCAM_VSyncComplete The API VSyncThe acquisition completion wait XCCAM_SetImageCallBack The API The setting of an image data acquisition call back function XCCAM_SetEventCallBack The API The Event call back function setting XCCAM_GetLibraryRevision The API The XC library revision acquisition XCCAM_GetGigEPktLog GigE Only GigE The camera packet information acquisition Page7 Sony IP&S Four PPG PD2-design section 2 It prohibits reprinting contents without notice.

9 XCCAM_TestStream GigE Only GigE The film test packet reception GigE Only GigE The camera XCCAM_ResourceAllocGigE communication resource securing XCCAM_HeartbeatMode GigE Only The Heartbeat adjusts-thehours XCCAM_ActionCommand GigE Only ActionCommand Published XCCAM_ActionCommandAll GigE Only All the ports ActionCommand Published XCCAM_ActionCommandTime GigE Only XCCAM_ActionCommandAllTime GigE Only XCCAM_SetActionAckCallBack GigE Only Ack reception of ActionCommand 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 XCCAM_FeatureName XCCAM_FeatureInfo XCCAM_FeatureDisplayName XCCAM_FeatureDescription XCCAM_FeatureToolTip XCCAM_FeatureUnit XCCAM_EnumerationEntryName XCCAM_EnumerationEntryDisplayNam e XCCAM_EnumerationEntryDescription XCCAM_EnumerationEntryToolTip XCCAM_EnumerationEntryValue XCCAM_EnumerationEntryIsAvailable XCCAM_GetFeatureInteger XCCAM_SetFeatureInteger Sony IP&S inc. PPG PD2 DD4 section 2. It prohibits reprinting contents without notice. Page 8

10 XCCAM_GetFeatureFloat XCCAM_SetFeatureFloat XCCAM_GetFeatureString XCCAM_SetFeatureString XCCAM_GetFeatureBoolean XCCAM_SetFeatureBoolean XCCAM_GetFeatureEnumeration XCCAM_SetFeatureEnumeration XCCAM_GetFeatureRegister XCCAM_SetFeatureRegister XCCAM_FeatureCommand XCCAM_FeatureIs Available XCCAM_FeatureIs Writeable XCCAM_FeatureIs Readable XCCAM_ReadReg RegThe API It reads a register. XCCAM_WriteReg RegThe API The register writing in XCCAM_ReadMem RegThe API It reads a memory. XCCAM_WriteMem RegThe API The memory writing in Page9 Sony IP&S Four PPG PD2-design section 2 It prohibits reprinting contents without notice.

11 3.3 API for.net Framework The classification. It provides the API which supported Net Framework in the following class The XCCAM class The class to control a camera The XCCAM_WATCH class The class to share the image of one camera with more than one PC The XCCOMV class The class to do a color change The API list The list and the class of the API are as the following. The API name The class The contents SetCallBack XCCAM The system call back setting SetStructVersion XCCAM The setting of a structure definition version GetLastError XCCAM The library error code acquisition GetList XCCAM The connection camera list acquisition XCCAM XCCAM The camera connecting Dispose XCCAM The camera deactivating CameraInfo XCCAM The camera information acquisition CameraInfoGigE XCCAM The GigE camera information acquisition CameraInfoUSB XCCAM The USB camera information acquisition Camera XCCAM The camera connect-acknowledge ResourceAlloc XCCAM The resource securing ResourceAllocGigE XCCAM The GigE resource securing ResourceRelease XCCAM The resource release GetGigEPktLog XCCAM The GigE Packet Log acquisition TestStreamGigE XCCAM The GigE test packet reception Camera XCCAM The camera connect-acknowledge ResourceAlloc XCCAM The resource securing ResourceAllocGigE XCCAM The GigE resource securing Sony IP&S inc. PPG PD2 DD4 section 2. It prohibits reprinting contents without notice. Page 10

12 ResourceRelease XCCAM The resource release GetGigEPktLog XCCAM The GigE Packet Log acquisition TestStreamGigE XCCAM The GigE test packet reception ConvMode XCCAM The color conversion mode setting SetBMPINFO XCCAM The BITMAPINFO information setting GetImageInfo XCCAM The Image information acquisition BufferConvExec XCCAM The color change execution ImageConvExec XCCAM The color change execution ImageStart XCCAM The image transfer beginning ImageStop XCCAM The image transfer stop ImageAlloc XCCAM It allocates in the image buffer. ImageFree XCCAM The image buffer release ImageReq XCCAM The image data acquisition request ImageComplete XCCAM The image data acquisition completion wait ImageReqAbortAll XCCAM The image data acquisition cancellation VSyncReq XCCAM VSyncThe acquisition request VSyncComplete XCCAM VSyncThe acquisition completion wait SetImageCallBack XCCAM The image acquisition call back setting GetImageStruct XCCAM The image buffer structure acquisition MonoBMPINFO XCCAM The BITMAPINFO information setting for MONO GetLibraryRevision XCCAM Revision's being acquired by the library Reset XCCAM Resource's being re-initialized ReDetection XCCAM The confirmation of the composition CategoryList XCCAM The category list acquisition CameraStandby XCCAM_WATCH The confirmation of a state of the image (the stream) data communication XCCAM_WATCHGIGE XCCAM_WATCH The camera connecting XCCOMV XCCONV The translate-table creating Dispose XCCONV The translate-table release Page11 Sony IP&S Four PPG PD2-design section 2 It prohibits reprinting contents without notice.

13 ConvExec XCCONV The change execution SetBMPINFO XCCONV The BITMAPINFO information setting Sony IP&S inc. PPG PD2 DD4 section 2. It prohibits reprinting contents without notice. Page 12

14 3.4 The camera class API It provides an API by the class definition. The camera opening voidcsonycam() Specified UID voidcsonycam(uint64 UID) Specified UserName voidcsonycam(std::stringusername) The camera list voidgetcameralist(cameralist* List ) acquisition The vender name std::stringgetvendorname() acquisition The model name std::stringgetmodelname() acquisition The Serial number std::stringgetserialnumber() acquisition The version number ULONGGetGigEVersion() acquisition The node mapping void *GetNodeMap() address acquisition The Feature value voidgetfeature(std::stringfname, INT64& Value ) acquisition voidgetfeature(std::stringfname, double& Value ) voidgetfeature(std::stringfname, std::string& Value ) voidgetfeature(std::stringfname, BYTE& Value, UINT32& Length ) voidgetfeature(std::stringfname, bool& Value ) The Feature value voidsetfeature(std::stringfname, INT64 Value ) setting voidsetfeature(std::stringfname, double Value ) voidsetfeature(std::stringfname, std::string Value ) voidsetfeature(std::stringfname, BYTE& Value, UINT32& Length ) voidsetfeature(std::stringfname, boolvalue ) voidsetfeature(std::stringfname) The image reception voidstreamstart() beginning The image reception voidstreamstop() ending The present image void Capture (void *)pbuffer) acquisition Page13 Sony IP&S Four PPG PD2-design section 2 It prohibits reprinting contents without notice.

15 The image acquisition curing The image acquisition completion confirmation The present image save The image save curing The image save completion confirmation The AVI file save beginning The ending of the AVI file save voidqueuecapture(void *)pbuffer) voidqueuecapturecomplete(void *)pbuffer, ULONGTimeOut) voidcapturefile(std::stringfilename) voidqueuecapturefile(std::stringfilename) voidqueuecapturefilecomplete(std::stringfilename, ULONGTimeOut) voidcaptureavifile(std::stringfilename) voidcaptureavifile( ) Sony IP&S inc. PPG PD2 DD4 section 2. It prohibits reprinting contents without notice. Page 14

16 3.5 The API comparison A difference with the API of article "XC-SDK2017 version2" is shown in this application and the past The API for the C++ Version 2 Version 3 The API classification The contents XCCAM_SetCallBack XCCAM_SetCallBack The API There is no change. XCCAM_SetStructVersion XCCAM_SetStructVersion The API There is no change. XCCAM_GetLastError XCCAM_GetErrorMsg The API It changes into the message from the error number. XCCAM_GetList XCCAM_GetList The API There is a change in the detailed contents. It returns the contents of Bootstrap Registers. XCCAM_Open XCCAM_Open The API The parameter change It specifies a request by the structure. XCCAM_Close XCCAM_Close The API There is no change. XCCAM_CloseAll XCCAM_CloseAll The API There is no change. XCCAM_Camera XCCAM_Camera The API There is no change. XCCAM_CameraInfo XCCAM_CameraInfo The API There is a change in the detailed contents. XCCAM_GetNodeMap XCCAM_GetNodeMap The API There is no change. XCCAM_GetFeatureHandle The API Newly GenAPIFor the C language interface of the business XCCAM_ResourceAlloc XCCAM_ResourceAlloc The API XCCAM_WatchAllocIt shares a feature by the を abolition. Page15 Sony IP&S inc. PPG PD2 DD4 section 2. It prohibits reprinting contents without notice.

17 XCCAM_ResourceRelease XCCAM_ResourceRelease The API There is no change. XCCAM_ConvMode XCCAM_SetConvMode The API The name change XCCAM_GetBMPINFO XCCAM_GetBMPINFO The API There is no change. XCCAM_BufferConvExec XCCAM_ImageConvExec XCCAM_BufferChunkInfo XCCAM_ImageChunkInfo XCCAM_ConvExec The API It makes common, changing a parameter. XCCAM_GetChunkInfo The API It makes common, changing a parameter. XCCAM_ImageStart XCCAM_ImageStart The API There is no change. XCCAM_ImageStop XCCAM_ImageStop The API There is no change. XCCAM_ImageAlloc XCCAM_ImageAlloc The API There is no change. XCCAM_ImageFree XCCAM_ImageFree The API There is no change. XCCAM_ImageFreeAll XCCAM_ImageFreeAll The API There is no change. XCCAM_ImageReq XCCAM_ImageReq The API There is no change. XCCAM_ImageComplete XCCAM_ImageComplete The API There is no change. XCCAM_ImageReqAbortAll XCCAM_ImageReqAbortAll The API There is no change. XCCAM_VSyncReq XCCAM_VSyncReq The API There is no change. XCCAM_VSyncComplete XCCAM_VSyncComplete The API There is no change. XCCAM_SetImageCallBack XCCAM_SetImageCallBack The API There is no change. XCCAM_SetEventCallBack XCCAM_SetEventCallBack The API There is no change. XCCAM_SetCmdTimeOut The API Newly The change of the temporary command timeout time XCCAM_GetLibraryRevision XCCAM_GetLibraryRevision The API There is no change. XCCAM_Reset The API The abolition XCCAM_ReDetection The API The abolition XCCAM_OpenGigE The API The abolition Sony IP&S inc. PPG PD2 DD4 section 2. It prohibits reprinting contents without notice. Page 16

18 XCCAM_CameraInfoGigE The API The abolition XCCAM_GetGigEPktLog XCCAM_GetGigEPktLog GigE Only There is no change. XCCAM_TestStream XCCAM_TestStream GigE Only There is no change. XCCAM_GetGigEPktLog XCCAM_GetGigEPktLog GigE Only There is no change. XCCAM_TestStream XCCAM_TestStream GigE Only There is no change. XCCAM_ResourceAllocGigE XCCAM_ResourceAllocGigE GigE Only The IP address which it is possible to specify, uses by the other PC, too. XCCAM_HeartbeatMode XCCAM_HeartbeatMode GigE Only There is no change. XCCAM_LostPktMode GigE Only Newly The data clearance feature in case of the packet coming-off XCCAM_BandAdjust GigE Only Newly It specifies GevSCPD caused by due to band limitation. XCCAM_ActionCommand XCCAM_ActionCommand GigE Only There is no change. XCCAM_ActionCommandAll XCCAM_ActionCommandAll GigE Only There is no change. XCCAM_ActionCommandTime XCCAM_ActionCommandTime GigE Only There is no change. XCCAM_ActionCommandAllTim XCCAM_ActionCommandAllTime GigE Only There is no change. e XCCAM_SetActionAckCallBack XCCAM_SetActionAckCallBack GigE Only There is no change. XCCAM_ControlCamera GigE Only Newly XCCAM_SetPacketSizeUSB USB Only Newly XCCAM_StreamResetUSB USB Only Newly XCCAM_CreateConvHandle XCCAM_CreateConvHandle Color Conversion There is no change. XCCAM_CloseConvHandle XCCAM_CloseConvHandle Color Conversion There is no change. Page17 Sony IP&S inc. PPG PD2 DD4 section 2. It prohibits reprinting contents without notice.

19 XCCAM_CloseAllConvHandle XCCAM_CloseAllConvHandle Color Conversion There is no change. XCCAM_ColorConvExec XCCAM_ColorConvExec Color Conversion There is no change. XCCAM_ColorConvGetBMPINFO XCCAM_ColorConvGetBMPINFO Color Conversion There is no change. XCCAM_MonoBMPINFO XCCAM_MonoBMPINFO Color Conversion There is no change. XCCAM_CategoryName Newly XCCAM_FeatureName Newly XCCAM_FeatureInfo Newly XCCAM_FeatureDisplayName Newly XCCAM_FeatureDescription Newly XCCAM_FeatureToolTip Newly XCCAM_FeatureUnit Newly XCCAM_EnumerationEntryName Newly XCCAM_EnumerationEntryDisplayNa Newly me XCCAM_EnumerationEntryDescriptio Newly n XCCAM_EnumerationEntryToolTip Newly XCCAM_EnumerationEntryValue Newly XCCAM_EnumerationEntryIsAvailabl Newly e XCCAM_GetFeatureInteger Newly XCCAM_SetFeatureInteger Newly XCCAM_GetFeatureFloat Newly XCCAM_SetFeatureFloat Newly XCCAM_GetFeatureString Newly XCCAM_SetFeatureString Newly XCCAM_GetFeatureBoolean Newly Sony IP&S inc. PPG PD2 DD4 section 2. It prohibits reprinting contents without notice. Page 18

20 XCCAM_SetFeatureBoolean Newly XCCAM_GetFeatureEnumeration Newly XCCAM_SetFeatureEnumeration Newly XCCAM_GetFeatureRegister Newly XCCAM_SetFeatureRegiste Newly XCCAM_FeatureCommand Newly XCCAM_FeatureIsAvailabl Newly XCCAM_FeatureIsWritable Newly XCCAM_FeatureIsReadable Newly XCCAM_ReadReg XCCAM_ReadReg Reg_API There is no change. XCCAM_ReadMem XCCAM_ReadMem Reg_API There is no change. XCCAM_WriteReg XCCAM_WriteReg Reg_API There is no change. XCCAM_WriteMem XCCAM_WriteMem Reg_API There is no change. XCCAM_WriteRegAll Reg_API Newly The broadcast feature of the register writing in XCCAM_WatchOpen The WATCH class The deletion XCCAM_WatchOpenGigE The WATCH class The deletion XCCAM_WatchClose The WATCH class The deletion XCCAM_WatchCamera The WATCH class The deletion XCCAM_WatchAlloc The WATCH class The deletion XCCAM_WatchRelease The WATCH class The deletion XCCAM_WatchStart The WATCH class The deletion XCCAM_WatchStop The WATCH class The deletion Page19 Sony IP&S inc. PPG PD2 DD4 section 2. It prohibits reprinting contents without notice.

21 3.5.2 The structurer for API of C++ Please refer the XCCampAPI.h for the detail. Structure name Version 2 Version 3 The contents XCCAM_GIGESTREAMTYPE XCCAM_GIGEIMAGEDATA= 1, There is no change. typedef enum XCCAM_GIGERAWDATA, XCCAM_GIGEFILEDATA, XCCAM_GIGECHUNKDATA, XCCAM_GIGEEXTCHUNKDATA, XCCAM_GIGEVENDORDATA= 0x8000, XCCAM_TRANSMITSPEED XCCAM_S100M= 0, XCCAM_S200M, XCCAM_S100M= 0, XCCAM_S1000M, Some members are abolished. typedef enum XCCAM_S400M, XCCAM_S800M, XCCAM_S1600M, XCCAM_S3200M, XCCAM_S1000M, XCCAM_SUSB2, XCCAM_SUSB3, XCCAM_SUSB2=100, XCCAM_SUSB3, XCCAM_DIBMODE XCCAM_DIB32= 0, XCCAM_DIB24, There is no change. typedef enum XCCAM_STOREMODE XCCAM_MEMmode= 0, There is no change. XCCAM_MEMmodeLR, typedef enum XCCAM_BMPmode, Sony IP&S inc. PPG PD2 DD4 section 2. It prohibits reprinting contents without notice. Page 20

22 XCCAM_BMPmodeLR, XCCAM_ENDIAN XCCAM_BIGENDIAN= 0, There is no change. XCCAM_LITTLEENDIAN typedef enum XCCAM_CAMERATYPE XCCAM_CAMERA1394= 0, It is replaced XCCAM_CAMERAGIGE, XCCAM_DEVICETYPE typedef enum XCCAM_CAMERAUSB XCCAM_DEVICETYPE XCCAM_UNKNOWNDEV= -1, Newly XCCAM_ANYDEV = 0, typedef enum XCCAM_GIGECAMERA, XCCAM_USBCAMERA, XCCAM_OPENMODE XCCAM_AUTO_ACCESS= 0, Newly XCCAM_READONLY_ACCESS, typedef enum XCCAM_CONTROL_ACCESS, XCCAM_EXCLUSIVE_ACCESS, XCCAM_FEATURETYPE XCCAM_INTEGERTYPE= 0, Newly XCCAM_BOOLEANTYPE, typedef enum XCCAM_FLOATTYPE, XCCAM_STRINGTYPE, XCCAM_COMMANDTYPE, XCCAM_ENUMERATIONTYPE, XCCAM_CATRGORYTYPE, XCCAM_REGISTERTYPE Page21 Sony IP&S inc. PPG PD2 DD4 section 2. It prohibits reprinting contents without notice.

23 STATUS_SYSTEMCODE STATUSXCCAM_BUSRESET= 1, STATUSXCCAM_POWERUP= 1, There is some STATUSXCCAM_POWERUP STATUSXCCAM_DEVICECHANGE changed. typedef enum, STATUS_IMAGE STATUSIMAGE_COMPLETE= 0, Newly STATUSIMAGE_REQUEST_PEND typedef enum ING, STATUSIMAGE_REQUEST_ERRO R, STATUSIMAGE_REQUEST_REST ART, STATUS_RTNCODE STATUSXCCAM_COMPLETE=0, It is divided into STATUSXCCAM_PARAMETER_ER XCCAM_OPENMODE typedef enum ROR, and STATUS_IMAGE. STATUSXCCAM_BUFFER_SHORT, etc. XCCAM_CAMERAINFO UINT64 UID; Structure for DWORD BusNumber; XCCAM_CmeraInfo typedef struct XCCAM_CAMERATYPE CameraType; It is abolished. *pxccam_camerainfo; XCCAM_TRANSMITSPEED Speed; BYTE VendorName[ 256 ]; BYTE ModelName[ 256 ]; XCCAM_GIGECAMERAINFO DWORD BusNumber; Structure for BYTE MACAddr[ 6 ]; XCCAM_GigECmeraInfo typedef struct WORD Spec_Major; Sony IP&S inc. PPG PD2 DD4 section 2. It prohibits reprinting contents without notice. Page 22

24 *pxccam_gigecamerainf O; XCCAM_GIGEDEVINFO typedef struct *pxccam_gigedevinfo; 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 ]; 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 ]; char Rsvd3; char SerialNumber[ 16 ]; char Rsvd4; char UserName[ 16 ]; It is replaced to XCCAM_GIGEDEVINFO Newly Page23 Sony IP&S inc. PPG PD2 DD4 section 2. It prohibits reprinting contents without notice.

25 DWORD Rsvd5; XCCAM_USBCAMERAINFO typedef struct *pxccam_usbcamerainfo ; XCCAM_USBDEVINFO typedef struct *pxccam_usbdevinfo; 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; 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 ]; char Rsvd5; char UserName[ 64 ]; Strucurer for XCCAM_USBCameraInf o It is replaced to XCCAM_USBDEVINFO Newly Sony IP&S inc. PPG PD2 DD4 section 2. It prohibits reprinting contents without notice. Page 24

26 DWORD Rsvd6; XCCAM_LIST DWORD CameraCount; DWORD Count; Structurer for XCCAM_CAMERAINFO Info[ 1 ]; XCCAM_DEVINFO Info[ 1 ]; XCCAM_GetList typedef struct Member is changed. *pxccam_list; XCCAM_OPENPARAM XCCAM_DEVICETYPE Structurer for DeviceType; XCCAM_Open typedef struct UINT64 UID; BYTE IPAddr[ 4 ]; *pxccam_openparam; char UserName[ 64 ]; ULONG Rsvd; XCCAM_OPENMODE AccMode; BOOL XML_DiskFlag; XCCAM_OPENREQUEST UINT64 UID; Structure for DWORD URLIdx; XCCAM_OpenGigE typedef struct BYTE UserName[ 64 ]; It is abolished. *pxccam_openrequest; XCCAM_IMAGE DWORD Width; DWORD Width; Member is changed DWORD Height; DWORD Height; typedef struct BYTE *pbuffer; BYTE *pbuffer; DWORD Length; DWORD Length; *pxccam_image; DWORD PixelFormatID; DWORD PixelFormatID; Page25 Sony IP&S inc. PPG PD2 DD4 section 2. It prohibits reprinting contents without notice.

27 XCCAM_ENDIAN EndianMode; XCCAM_ENDIAN EndianMode; STATUS_RTNCODE Status; STATUS_IMAGE Status; XCCAM_USBSTREAMINFO DOWRD Stream_Type; There is no change. Typedef struct etc. *pxccam_gigestreaminf O; XCCAM_IMAGEDATAINFO XCCAM_CAMERATYPE XCCAM_DEVICETYPE 1394 member is CameraType; DeviceType; abolished. typedef struct union U union U *pxccam_imagedatainfo struct C1394 struct CGIGE ; XCCAM_TRANSMITSPEED BOOL Payload_Flag; Speed; XCCAM_GIGESTREAMINFO DWORD CycleTime_S; StreamInfo; DWORD CycleCount_S; } CGigE; DWORD CycleTime_E; struct CUSB DWORD CycleCount_E; } C1394; BOOL Payload_Flag; struct CGIGE XCCAM_USBSTREAMINFO StreamInfo; BOOL Payload_Flag; } CUsb; XCCAM_GIGESTREAMINFO } u; StreamInfo; } CGigE; Sony IP&S inc. PPG PD2 DD4 section 2. It prohibits reprinting contents without notice. Page 26

28 struct CUSB BOOL Payload_Flag; XCCAM_USBSTREAMINFO StreamInfo; } CUsb; } u; XCCAM_PKTLOG UINT64 ToTalPktCount; UINT64 ToTalPktCount; Structurer for UINT64 ErrorPktCount; UINT64 ErrorPktCount; GigEGetPktLog typedef struct UINT64 RetryCount; UINT64 RSendCount; Member is changed. *pxccam_pktlog; XCCAM_COLORVALUE double R_Value; There is not changed. double G1_Value; typedef struct double G2_Value; double B_Value; *pxccam_colorvalue; XCCAM_COLORCONVMODE XCCAM_STOREMODE XCCAM_STOREMODE Member is changed. StoreMode; StoreMode; typedef struct XCCAM_SHIFTID XCCAM_SHIFTID ShiftID; ShiftID; *pxccam_colorconvmod XCCAM_DIBMODE XCCAM_DIBMODE E; DIBMode; DIBMode; DWORD Parallel_Thread; DWORD Parallel_Thread; BOOL BayerRevision_G; BOOL BayerRevision_G; BOOL Parallel_Flag; Page27 Sony IP&S inc. PPG PD2 DD4 section 2. It prohibits reprinting contents without notice.

29 XCCAM_EVENTINFO USHORT EventID; USHORT EventID; Member types are union U union U changed. typedef struct struct CGIGE struct CGIGE *pxccam_eventinfo; USHORT StreamIndex; WORD StreamIndex; UINT64 BlockID; UINT64 BlockID; UINT64 TimeStamp; UINT64 TimeStamp; UINT32 Length; DWORD Length; UCHAR Data[ 4 ]; BYTE Data[ 4 ]; } CGigE; } CGigE; struct CUSB struct CUSB UINT64 TimeStamp; UINT64 TimeStamp; UINT32 Length; DWORD Length; UCHAR Data[ 4 ]; BYTE Data[ 4 ]; } CUsb; } CUsb; } u; } u; XCCAM_CHUNKINFO DWORD Count; There is no change. struct INFO typedef struct DWORD ChunkID; *pxccam_chunkinfo; DWORD Length; PVOID pchunkdata; } Info[ 1 ]; XCCAM_FEATUREINFO XCCAM_FEATURETYPE FType; Newly UINT64 PollingTime; typedef struct union U Structure for Sony IP&S inc. PPG PD2 DD4 section 2. It prohibits reprinting contents without notice. Page 28

30 *pxccam_featureinfo; 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 Page29 Sony IP&S inc. PPG PD2 DD4 section 2. It prohibits reprinting contents without notice.

31 4 The help 4.1 The overview The offer form It is HTML Help form The offer contents We provide the following manual. The manual of the utility software The manual of Viewer The manual of the API manual/camera feature and so on The fusing with a sample It adds a code example to the explanation of each API, the explanation of the each function. Sony IP&S inc. PPG PD2 DD4 section 2. It prohibits reprinting contents without notice. Page 30

32 4.2 The contents of the manual The manual of the utility software An operating method is described The manual of Viewer The operating method of Viewer is described The manual of the API, the camera feature and so on A. The description contents An explanation about the following is described. The specification of the API The specification of each API is described. The each function of the camera As for the following camera feature, it provides a sample code. The explanation of the camera setting by Trigger and so on The explanation of the camera manner of use of the multicast and so on Page31 Sony IP&S inc. PPG PD2 DD4 section 2. It prohibits reprinting contents without notice.