FX3Cam SDK for FCB-MA130 Programmer’s Guide FX3Cam SDK for FCB-MA130 Programmer’s Guide Rev 1.3.0 Infinitegra Inc. www.infinitegra.co.jp Infinitegra Inc. 1 FX3Cam SDK for FCB-MA130 Programmer’s Guide Notice for this document Infinitegra, Inc. (indicate as “Infinitegra” hereinafter) have a right for all of information in this document. Infinitegra do not allow reproducing/redistribution any information in this document without approval from Infinitegra. Infinitegra may change the information in this document without further notice. Please contact Infinitegra if you find wrong information and /or have any unclear points in this document. This document is an English translation version from Japanese (original) version for reference purpose. If there are any discrepancy between English version and Japanese version, Japanese version should prevail. Notice for the product / Disclaimer Please do not operate the product against the contents of this document. It may be cause of troubles. Infinitegra may not accept any responsibility for any troubles those are caused by illegal operation. This application is for experiment/evaluation purpose. Please do not use for the usage those require safety and/or reliability and have a possibility to affect one’s life. Infinitegra will not accept any responsibility for any loss, damage or mal state incurred by this application. Infinitegra do not allow to modify, dis-assemble, change, alter, reverse assemble, reverse compile, reverse engineer or to undertake any similar action to SW, FW and/or HW of the product. Copyright © Infinitegra, INC. All Rights Reserved. All product names of other companies mentioned in this document are trademarks or registered trademarks owned by the respective corporations. Infinitegra Inc. 2 FX3Cam SDK for FCB-MA130 Programmer’s Guide Index 1. Introduction ............................................................................................................................................. 10 1.1. Content of SDK ................................................................................................................................ 10 1.2. Requirements ................................................................................................................................... 11 1.2.1. Host Library ............................................................................................................................. 11 1.2.2. Build Environment ................................................................................................................... 11 1.3. Reference Materials ......................................................................................................................... 11 2. Limitations .............................................................................................................................................. 12 3. Host Library Overview ............................................................................................................................ 13 3.1. System Structure ............................................................................................................................. 13 3.2. Relationship between Application and Host Library ..................................................................... 14 3.3. Classification of APIs ....................................................................................................................... 14 3.4. Sample Source Codes ....................................................................................................................... 15 3.4.1. CamControlTest ........................................................................................................................ 15 3.4.2. CamControlTest_CS ................................................................................................................. 15 3.4.3. DirectShow Sample .................................................................................................................. 15 3.4.4. DirectShowBaseClasses ........................................................................................................... 15 3.4.5. IFTCamCon .............................................................................................................................. 17 4. Host Library Installation ........................................................................................................................ 18 4.1. Deployment ...................................................................................................................................... 18 4.2. Compilation ...................................................................................................................................... 18 4.3. Runtime Requirements .................................................................................................................... 18 5. C API ........................................................................................................................................................ 19 5.1. Common Types ................................................................................................................................. 19 5.1.1. CamcFunc ................................................................................................................................. 19 5.1.2. CamcStatus_t ........................................................................................................................... 19 5.1.3. CamcSensorErrorCode_t .......................................................................................................... 20 5.1.4. CamcHostErrorCode_t ............................................................................................................. 21 5.1.5. CamcFX3ErrorCode_t .............................................................................................................. 21 5.2. Error Code Sets ................................................................................................................................ 22 5.2.1. Error Code Set 1 ....................................................................................................................... 22 5.2.2. Error Code Set 2 ....................................................................................................................... 22 5.2.3. Error Code Set 3 ....................................................................................................................... 22 5.2.4. Error Code Set 4 ....................................................................................................................... 22 5.3. Functions .......................................................................................................................................... 23 5.3.1. CamcFunc_GetFuncs ............................................................................................................... 23 5.3.2. CamcFunc_GetFuncByCaptureFilter ...................................................................................... 23 Infinitegra Inc. 3 FX3Cam SDK for FCB-MA130 Programmer’s Guide 5.3.3. CamcFunc_GetCaptureFilter .................................................................................................. 24 5.3.4. CamcFunc_Invalidate .............................................................................................................. 24 5.3.5. CamcFunc_Release ................................................................................................................... 25 5.3.6. CamcFunc_ReleaseArray ......................................................................................................... 25 5.3.7. CamcFunc_GetLibVersion ....................................................................................................... 26 5.3.8. CamcFunc_GetVendorID ......................................................................................................... 26 5.3.9. CamcFunc_GetProductID ........................................................................................................ 26 5.3.10. CamcFunc_GetFirmwareVersion ............................................................................................. 27 5.3.11. CamcFunc_GetReleaseNumber ............................................................................................... 27 5.3.12. CamcFunc_GetDeviceName..................................................................................................... 27 5.3.13. CamcFunc_GetActive ............................................................................................................... 28 5.3.14. CamcFunc_GetHostError ........................................................................................................ 29 5.3.15. CamcFunc_GetSensorError ..................................................................................................... 29 5.3.16. CamcFunc_GetFX3Error ......................................................................................................... 29 5.3.17. CamcFunc_GetErrorMessage .................................................................................................. 30 5.3.18. CamcFunc_GetTimeoutMilliSec .............................................................................................. 30 5.3.19. CamcFunc_SetTimeoutMilliSec ............................................................................................... 31 5.3.20. CamcFunc_CommandWrite ....................................................................................................