background image

 

 

 

 

43 / 58 

Trigger functions: 

 

int 

iCube

 SDK_

SetTrigger(int nCamIndex,int nMode) 

Purpose:               sets the Trigger mode. The behavior of this function is dependent from the  

parameter REG_SW_TRIG_MODE.  

 

DELAYED_TRIGGER_RETURN:   
SetTrigger(TRIG_SW_DO) returns when the last sensor line is in the camera-usb-chip. 
If the last sensor line is not arriving in time the return value will be an error. 

 

IMMEDIATE_TRIGGER_RETURN:  
SetTrigger(TRIG_SW_DO) returns immediately. 

 

3iCube: IMMEDIATE_TRIGGER_RETURN is default and the only possible mode. 
iCube: DELAYED_TRIGGER_RETURN is default, but it is more common to use 

                        IMMEDIATE_TRIGGER_RETURN. 
 

 

Description 

Parameters 

int

 nCamIndex, 

int

 nMode 

Return value 

int

 stat 

 

Return value: 

int

 

stat

:             

IC_SUCCESS:     success 

                                  else:               error 

 
Parameters: 

int

 

nCamIndex:                         index of camera.  

Int 

 

nMode:                             TRIG_SW_START:         starts the software trigger mode  .   

                                             TRIG_SW_DO :            get one software triggered frame.                
                                            TRIG_HW_START:         starts the hardware trigger mode. 
                                             TRIG_STOP:                stops soft/hardware trigger mode.           

TRIG_SW_START_2:      GRR mode  

(1500CU/BU >= FW x.4.11.x) 

(1300CU >= FW x.1.12.x)  

TRIG_HW_START_2 :     GRR mode  

(1500CU/BU >= FW x.4.11.x) 

(1300CU >= FW x.1.12.x)  

Содержание 3iCUBE

Страница 1: ...1 SDK API Manual USB3 0 CMOS cameras USB2 0 CMOS cameras SDK API Manual Rev 2 0 1 2 Please note that all data and illustrations are subject to error change and omissions without notice 3iCube iCube ...

Страница 2: ...era body Warranty shall be voided for improper usage or fault caused by user or damage caused by other equipments due to negligence Warranty NET GMBH warrants the original components free of defects for one year from purchase date This warranty covers failures and damage due to defect which may occur during normal use It does not cover damages or failure resulting from mishandling abuse misuse or ...

Страница 3: ...SYSTEM REQUIREMENTS 11 HARDWARE REQUIREMENTS 11 SOFTWARE REQUIREMENTS 11 USAGE NOTES 12 SOFTWARE 15 SOFTWARE CD 15 SOFTWARE INSTALLATION 17 SOFTWARE AND DRIVER UPDATE 18 PROBLEMS 18 APPLICATIONS 19 ICUBE ICONTROL 19 CALIBRATION OPTIONAL 19 ICUBE DX REGISTRATION 20 ICUBE SDK SAMPLES WINDOWS 21 SDK INTERFACE 22 MICROSOFT VISUAL STUDIO C 22 C BUILDER 22 VISUAL BASIC NET 22 VISUAL BASIC 6 0 22 C 23 ...

Страница 4: ...NS 39 SAVE FUNCTIONS 41 TRIGGER FUNCTIONS 43 PARAMETER FUNCTIONS 45 EXPOSURE FUNCTIONS 47 ADDITIONAL PARAMETER FUNCTIONS 49 ERROR CODES 51 DIRECTSHOW INTERFACES 52 SUPPORTED STANDARD DIRECTSHOW INTERFACES 52 ICUBE DIRECTSHOW INTERFACES 52 ICUBE DIRECTSHOW SETTING 53 VIDEO CONTROL PARAMETERS 54 VIDEO STREAM CONTROL PARAMETERS 56 TECHNICAL SUPPORT 57 IMPRINT 58 ...

Страница 5: ...e or build Application for cameras or hardware from other venders with this API The EVALUATION VERSION SOFTWARE is provided to you AS IS without warranty The entire risk of the quality and performance of the software is with its users We would appreciate feedback bug report of any kind however we can not guarantee satisfactory response Legal Notice By installing copying or otherwise using the SOFT...

Страница 6: ...19 FIGURE 5 ICUBE DX REGISTRATION 20 FIGURE 6 VIDEO CONTROL PARAMETERS 53 FIGURE 7 CAMERA CONTROL PARAMETERS 55 FIGURE 8 VIDEO STREAM CONTROL PARAMETERS 56 List of Tables TABLE 1 STANDARD CAMERA FUNCTION CONTROL 24 TABLE 2 ERROR CODES 51 TABLE 3 VIDEO CONTROL PARAMETERS 54 TABLE 4 CAMERA CONTROL PARAMETERS 55 TABLE 5 VIDEO STREAM CONTROL PARAMETERS 56 ...

Страница 7: ... instruction manual may cause harmful interference to radio communication Operation of this equipment in a residential area is likely to cause harmful interference in which case the user will be required to correct the interference at his own expense CE This apparatus has been certified to meet or exceed the standards for CE compliance per Council Directives Pertinent testing documentation is avai...

Страница 8: ...foreign matter or if the equipment is dropped or malfunctions fire or electric shock may result Be always sure to disconnect the power cable from the wall socket at once and contact your dealer Unplug Do not use the equipment in locations subject to water splashes Otherwise fire or electric shock may result Do not wet Safety Signs Description WARNING Indicates a potentially hazardous situation tha...

Страница 9: ...esult in fire or electric shock Do not handle roughly damaged fabricated bent forcefully pulled twisted bundled placed under heavy objects or heated the power cable and the connection cable Otherwise fire or electric shock may result Avoid CAUTION Observe the following when installing the equipment Do not cover the equipment with a cloth etc Do not place the equipment in a narrow location where he...

Страница 10: ... Otherwise its inner image pickup device might get damaged Avoid Avoid short circuiting signal output Otherwise a malfunction may occur Avoid Avoid giving a strong shock against the camera body It might cause a breakdown or damage If your camera is used in a system where its camera connector is subjected to strong repetitive shocks its camera connector is possible to break down If you intend to us...

Страница 11: ...um IV processor with a clock frequency of at least 1 5 GHz or higher Software requirements iCube iControl Viewer Software The iControl software allows you to test the functionalities of the 3iCube camera on your own application Apart from controlling the 3iCube camera you can grab images and save them as jpg bmp and tiff files SynView Software Development Kit SDK only USB3 Vision supported complia...

Страница 12: ... specifications In a thermal challenging environment the customer needs to ensure sufficient heat dissipation with a thermal connection to the bottom of the camera housing and sufficient airflow Non adequate thermal connection may increase heat induced noise or degrade image quality in other ways and internal components may be adversely affected up to camera outages due to overheating Temperature ...

Страница 13: ...up surface If the equipment is not to be used for a long duration turn off power to the camera for safety Check compatibility of lens Depending on lens and lighting an image can be reflected as a ghost into the imaging area This is not a fault of the camera Depending on the lens the performance of the camera might not be brought out fully due to deterioration in resolution and brightness in the pe...

Страница 14: ...e noise may be generated on the screen If this occurs move the camera or the cable Following information is only for EU member states The use of the symbol indicates that this product may not be treated as household waste By ensuring this product is disposed correctly you help to prevent potential negative consequences for the environment and human health which could otherwise be caused by inappro...

Страница 15: ...33_MultiROI Microsoft Visual Studio multi roi example C C SDK Example C Microsoft Visual Studio examples C Builder Borland C Builder SDK Example iCubeSDKSample_x32_VC6 Visual Studio 6 0 32bit SDK Example iCubeSDKSample_x32_x64_vs2010 Visual Studio 2010 32bit 64bit SDK Example vb 6 Visual Basic 6 0 SDK Example VB NET VB NET SDK Example 06_Tools dxRegistration Register more than one device as direct...

Страница 16: ...eb debian packet which uses usbfs interface used for older debian distrutions readme txt describes requirements of usbfs and libudev packets 99 netusbcam rules rules for netusbcam libudev packet 05_Interfaces SDK SDK tar gz SDK packet API NETUSBCAM_API h HelloICube minimal iCube example MultiROI_SIMR_Test multi roi sdk example MultiROITest multi roi sdk example sdk_sample1 QT based SDK example ...

Страница 17: ...o your USB 3 0 port and 3iCube 3 Windows plug and play manager recognizes the new hardware 4 Follow the instruction of the Windows plug and play manager 5 After the 3iCube driver is installed you can see on the device Manager imaging devices the recognized 3iCube camera 3iCube NET ICube_Cam Device USB30 Windows german version Windows english version Figure 2 Device manager ...

Страница 18: ... file on the device manager imaging devices and select the driver manually Problems Due to heavy real time data transfer and processing system performance especially CPU is crucial for smooth operation Possible performance degradation such as actual frame rate drop may occur for systems with lower performance than of Pentium IV 1 5 GHz computer Faulty cables can drop the frame rate The maximum of ...

Страница 19: ... controlling the 3iCube camera you can grab images and save them as jpg bmp and tiff files Figure 3 iControl viewer software Calibration optional The Color Calibration application uses a Macbeth standard color checker to evaluate the predefined color spots and calculate the correction values for the RGB color matrix in the camera Figure 4 Macbeth standard color checker ...

Страница 20: ...Choose device to register You will see the connected camera with serial numbers in the ComboBox The selection of the dx capture filter in 2 will change automatically when changing the device 2 Register the selected device The name in the square brackets is the dx friendly name which will appear in amcap for example Additional functionalities are explained in Tools dxRegistration readme txt Figure ...

Страница 21: ...MR Multiple Integration Multiple ROI mode allows the user to define an acquisition cycle comprising 1 to 4 ROI cycle s SIMR Single Integration Multiple ROI mode allows 1 2 or 4 areas of interest to be acquired within the same integrated image C Microsoft Visual Studio examples C Builder Borland C Builder SDK Example ICubeSDKSample_x32_VC6 Visual Studio 6 0 32bit SDK Example ICubeSDKSample_x32_x64_...

Страница 22: ...le C Builder Static linking If the user want to use iCubeSDK lib file while compiling add the path lib IcubeSDK lib to library modules Uncomment the define define LIBFILE in the NET_iCube_API h file Uncomment the define define BORLAND_C in the NET_iCube_API h file dynamic linking Comment the define define LIBFILE in the NET_iCube_API h file Visual Basic NET available Visual Basic NET example Inter...

Страница 23: ...23 58 23 C available C example Interface definitions ICube cs ...

Страница 24: ...SDK_Stop stops the video stream iCube SDK_GetSize get the current frame sizes iCube SDK_GetName get the name of the selected camera iCube SDK_GetBrokenFrames get the number of broken frames since the last start iCube SDK_GetGoodFrames get the number of good frames since the last start iCube SDK SetDisplayMode sets the display mode Version function iCube SDK_GetVersion get the SDK version iCube SDK...

Страница 25: ...r mode iCube SDK_GetTrigger gets the current trigger mode Parameter functions iCube SDK_SetCamParameter set parameter value iCube SDK_GetCamParameter get parameter value iCube SDK_GetCamParameterRange get parameter min max values default value auto onepush and enabled information Exposure functions iCube SDK_SetExposure set Exposure time Input iCube SDK_GetExposure get Exposure time Output iCube S...

Страница 26: ...SDK_Open int nCamIndex Purpose opens the camera interface Description Parameters int CamIndex Return value Int stat Return value int stat IC_SUCCESS success else error Parameters int nCamIndex index of camera to open void iCube SDK_Close int nCamIndex Purpose closes the camera interface Description Parameters int CamIndex Return value Int stat Return value int stat IC_SUCCESS success else error Pa...

Страница 27: ... SDK_IsOpen int nCamIndex Purpose checks for open camera interfaces Description Parameters int CamIndex Return value Return value int stat ON camera is open OFF camera is not open Parameters int nCamIndex index of camera ...

Страница 28: ...e below Description Parameters int CamIndex int nMode long CALLBACK CallbackFunc void pCBContext Return value Int stat Return value int stat IC_SUCCESS success else error Parameters int nCamIndex index of camera int nMode defines the grab mode CALLBACK_RAW Data format passed to the callback function color camera 8bit Pixel Bayer raw Data monochrome camera 8bit Pixel Raw Data CALLBACK_RGB Data form...

Страница 29: ...int stat IC_SUCCESS success else error Parameters int nCamIndex index of camera HWND ImgHandle handle to preview window bool Preview set unset the use of a preview window If preview mode is set and ImgHandle is NULL a default preview window will be used bool Callback set unset the use of the callback function void iCube SDK_IsStarted int nCamIndex Purpose checks for open image stream Description P...

Страница 30: ...t Return value int stat IC_SUCCESS success else error Parameters int nCamIndex index of camera int iCube SDK_GetSize int nCamIndex int pnXRes int pnYRes Purpose get the current frame sizes Description Parameters int CamIndex int pnXRes int pnYRes Return value int stat Return value int stat IC_SUCCESS success else error Parameters int nCamIndex index of camera int pnXRes current width int pnYRes cu...

Страница 31: ...rokenFrames int nCamIndex int pnFrames Purpose get the number of broken frames since the last start The broken frames information can also be retrieved via the callback function if the parameter REG_CALLBACK_BR_FRAMES is set to ON In this case a buffersize of 0 indicates a badframe Description Parameters int CamIndex int pnFrames Return value int stat Return value int stat IC_SUCCESS success else ...

Страница 32: ...perty Purpose sets the display mode This function has to be called before ICubeSDK_Start Description Parameters int CamIndex int nMode DISP_PROPERTY property Return value int stat Return value int stat IC_SUCCESS success else error Parameters int nCamIndex index of camera int nMode DISPLAY_NORMAL displays the full frame DISPLAY_FIT_TO_WINDOW resizes the displayed frame to the size of the preview w...

Страница 33: ... char pVersion Purpose get the firmware version Description Parameters int CamIndex char pVersion Return value int stat Return value int stat IC_SUCCESS success else error Parameters int nCamIndex index of camera char version the version of the camera firmware int iCube SDK_GetSerialNum int nCamIndex char pVersion Pupose get the serial number of the camera Description Parameters int CamIndex char ...

Страница 34: ...firmware version This functions returns IC_SUCCESS if the hardware uses a FPGA Description Parameters int CamIndex char pVersion Return value int stat Return value int stat IC_SUCCESS success else error Parameters int nCamIndex index of camera char version the version of the camera fpga firmware ...

Страница 35: ...PROPERTY property Return value int stat Return value int stat IC_SUCCESS success else error Parameters int nCamIndex index of camera ROI_PROPERTY property pointer to the ROI_PROPERTY structure int iCube SDK_GetResolution int nCamIndex ROI_PROPERTY property Purpose get the resolution and position of the Region of Interest ROI Get the enable disable status of the ROI mode Description Parameters int ...

Страница 36: ...ilable only for 4133 and 4203 cameras The correct roi ID 2 4 has to set before this function with ICubeSDK_SetCamParameter nCamIndex REG_ROI_ID roi ID It is not allowed to leave a gap in the roi settings you can not set roi 2 without setting roi 1 See 4133_MultiROI SDK Example Linux this function is not available with the linux api see MultiROITest example Description Parameters int CamIndex ROI_P...

Страница 37: ...de highest resolution Description Parameters int CamIndex int nMode Return value int stat Return value int stat IC_SUCCESS success else error Parameters int nCamIndex index of camera int nMode this value sets the basis format see table below Table 2 resolution Mode Resolution 0 320x240 QVGA 1 640x480 VGA 2 752x480 WVGA 3 800x600 SVGA 4 1024x768 XGA 5 1280x1024 SXGA 6 1600x1200 UXGA 7 2048x1536 QXG...

Страница 38: ...arameters int nCamIndex index of camera int pMode current format int iCube SDK_GetModeList int nCamIndex int pLength int pList Purpose get the possible formats of the camera Description Parameters int CamIndex int pLenght int pList Return value int stat Return value int stat IC_SUCCESS success else error Parameters int nCamIndex index of camera int pLength number of formats in list int pList forma...

Страница 39: ... used The availability of BinSkip modes is camera dependent and can be identified with iCubeSDK_GetBinSkipList Description Parameters int CamIndex int nParameter int nMode Return value int stat Return value int stat IC_SUCCESS success else error Parameters int nCamIndex index of camera int nParameter this value sets how many pixels should skipped or binned BIN_SKIP_OFF BIN_SKIP_2ND_PIXEL or BIN_SK...

Страница 40: ...get current skipping mode MODE_BIN get current binning mode int iCube SDK_GetBinSkipList int nCamIndex int nMode int pLength int pList Purpose get the possible skipping or binning formats of the camera Description Parameters int CamIndex int nMode int pLenght int pList Return value int stat Return value int stat IC_SUCCESS success else error Parameters int nCamIndex index of camera int nMode MODE_...

Страница 41: ...era is in freerun mode this function returns when the next available frame has been saved If the camera is in trigger mode this function marks the next available frame to be saved If the frame arrives SetTrigger TRIG_SW_DO it will be saved Description Parameters int CamIndex char Name Return value int stat Return value int stat IC_SUCCESS success else error Parameters int nCamIndex index of camera...

Страница 42: ..._AVI_STATE get the avi stream save status ON OFF whereat ON means saving is still in progress and OFF saving is finished Description Parameters int nCamIndex char Name int nMode int nTimeInSecs Return value int stat Return value int stat IC_SUCCESS success else error Parameters int nCamIndex index of camera Char name path and name of the file the extension must be avi int nMode currently only AVI_...

Страница 43: ...e IMMEDIATE_TRIGGER_RETURN is default and the only possible mode iCube DELAYED_TRIGGER_RETURN is default but it is more common to use IMMEDIATE_TRIGGER_RETURN Description Parameters int nCamIndex int nMode Return value int stat Return value int stat IC_SUCCESS success else error Parameters int nCamIndex index of camera Int nMode TRIG_SW_START starts the software trigger mode TRIG_SW_DO get one sof...

Страница 44: ...ex int nMode Purpose gets the current trigger mode Description Parameters int nCamIndex int nMode Return value int stat Return value int stat IC_SUCCESS success else error Parameters int nCamIndex index of camera Int nMode current trigger mode ...

Страница 45: ...camera int Type type of parameter to set See Parameter Definitions in API Header unsigned long Value value to set int iCube SDK_GetCamParameter ini nCamIndex int Type unsigned long Value Purpose get parameter value If ICubeSDK_GetCamParameter is used with multi roi applications the correct roi ID 2 4 has to set before this function with ICubeSDK_SetCamParameter nCamIndex REG_ROI_ID roi ID See 4133...

Страница 46: ...epush and enabled information Description Parameters int nCamIndex int Type PARAM_PROPERTY property Return value int stat Return value int stat IC_SUCCESS success else error Parameters int nCamIndex index of camera int Type type of parameter to get See Parameter Definitions in API Header PARAM_PROPERTY property pointer to PARAM_PROPERTY structure ...

Страница 47: ...pose set Exposure time Input Description Parameters int CamIndex float Value Return value int stat Return value int stat IC_SUCCESS success else error Parameters int nCamIndex index of camera FLOAT Value exposure time ms int iCube SDK_GetExposure IN int nCamIndex OUT float Value Pupose get Exposure time Output Description Parameters int CamIndex float Value Return value int stat Return value int s...

Страница 48: ...erty Pupose get Exposure time Range Output Description Parameters int CamIndex PARAM_PROPERTY_f property Return value int stat Return value int stat IC_SUCCESS success else error Parameters int nCamIndex index of camera PARAM_PROPERTY_f property pointer to the PARAM_PROPERTY_f ...

Страница 49: ...amIndex index of camera int Type type of parameter See Parameter Definitions in API Header int bAuto 1 supported 0 unsupported int iCube SDK_SetParamAuto int nCamIndex int Type int bAuto Purpose if auto mode is supported set unset auto mode of parameter Description Parameters int CamIndex int Type int bAuto Return value int stat Return value int stat IC_SUCCESS success else error Parameters int nC...

Страница 50: ...pe of parameter to set See Parameter Definitions in API Header int iCube SDK_SetParamOnePush int nCamIndex int Type Purpose if one push mode is supported set unset one push mode of parameter currently one push is used for white balance Description parameters int CamIndex int Type Return value int stat Return value int stat IC_SUCCESS success else error Parameters int nCamIndex index of camera int ...

Страница 51: ...IC_ALREADY_DONE 4 e g Interface already open IC_WRONG_CLOCK_VAL 5 wrong PLL value more information on operation manual camera specification IC_COM_LIB_INIT 6 wrong library called IC_NOT_IF_STARTED 7 parameter not usable when video stream is started IC_WRONG_ROI_ID 8 wrong roi id number IC_IF_NOT_ENABLED 9 parameter not enabled IC_COLOR_CAM_ONLY 10 parameter is only for color cameras IC_DRIVER_VERS...

Страница 52: ...ol CameraControl_Exposure These are the interfaces for controlling camera parameters Other implemented interfaces e g IAMStreamConfig are not shown here iCube DirectShow Interface With the iCube DirectShow interface it is possible to control all camera parameters including Trigger mode ROI mode and Bin Skip modes In DirectShow ROI mode is unlike to the SDK a basic format like 640x480 For further d...

Страница 53: ...53 58 iCube DirectShow setting Video Control Parameters Figure 7 Video control parameters ...

Страница 54: ...e Auto Eeprom Rough Eeprom Fine Eeprom Exp Target Eeprom Gain Eeprom Default Registry default parameters Color Enhancement Color Enhancement enable Eeprom Saturation Eeprom White Balance White Balance Eeprom Red Eeprom Green Eeprom Blue Eeprom Red Offset Eeprom Green Offset Eeprom Blue Offset Eeprom One Push not saved Color correction enable Eeprom TNR enable Eeprom ...

Страница 55: ...rol Parameters Trigger Trigger enable not saved Software Trigger not saved Hardware Trigger not saved Trigger Delay Eeprom Push SW trigger not saved Strobe Strobe Delay Eeprom Strobe Length Eeprom Other flip V Registry flip H Registry color enable Registry RAW Data on off Clock Registry ...

Страница 56: ...eam control parameters Videoformat Videostandard display only Video Format Registry Framerate calculation PLL H Shutter Resolution Registry Region of Interest Start Position Horizontal Registry Vertical Registry Size Horizontal Registry Vertical Registry Bin Skip Binning Registry Skipping Registry ...

Страница 57: ...nce www net france sas fr Italy www net italia it USA www net usa inc com Asia www net japan com Email Europe info net gmbh com France info net france sas fr Italy info net italia it USA info net usa inc com Asia info net japan com Phone Europe 49 8806 92 34 0 France 33 450 452 292 Italy 39 030 5237 163 USA 1 219 934 9042 Asia 81 454 781 020 Fax Europe 49 8806 92 34 77 Italy 39 030 5237 163 USA 1 ...

Страница 58: ...ss Lerchenberg 7 D 86923 Finning Germany Contact Phone 49 88 06 92 34 0 Fax 49 88 06 92 34 77 www net gmbh com E mail info net gmbh com VAT ID DE 811948278 Register Court Augsburg HRB 18494 Copyright 2014 NEW ELECTRONIC TECHNOLOGY GMBH All rights reserved ...

Отзывы: