background image

 

 

34 

A

PPENDIX 

C:

  

D

EMO 

A

PPLICATION

 

 

The demo application CamTest is simple and easy to use.  Just follow the on-screen instructions.   
The 

Push me

 button starts/stops or continues image acquisition and real-time displaying.  The currently 

displayed image can be stored in BMP file (\My Documents\My Pictures\vuq.bmp) by pressing the 

Save

 

button. 
 
The application main window is implemented as a modal dialog window.  Therefore, there is no window 
message loop in the WinMain() function. 
 
Note that the pre-built Demo application executable program supplied with the SDK was linked statically 
with the barcode decoding library SwiftDecoder from Omniplanar.  In the source code of the Demo 
Application, however, this decoding capability is disabled by default. In order to include SwiftDecoder in 
the Demo application, follow this procedure: 
 

1.  Obtain the barcode decoding library SwiftDecoder from Omniplanar. 

2.  Add the path to the SwiftDecoder master include file SD.H to the list of directories searched for 

include files in the project settings. 

3.  Add the library of the SwiftDecoder API functions SD2.LIB to the list of modules passed to the 

linker. Add the path to this library to the list of directories searched for libraries in the project 
settings. 

4.  Define the macro SWIFT_DECODER in the project settings or in the very beginning of the source 

file decode.c. 

5.  If the obtained SwiftDecoder library is not protected from unauthorized copying by means of 

security keys, you are all set to enable the decoding capability. Go to the final step 10. Otherwise, 
if the SwiftDecoder library is protected by security keys, go to the next step. 

6.  Obtain the SwiftDecoder signature key and the SwiftDecoder verification key from Omniplanar. 

7.  Add the library of the SwiftDecoder security functions SD2IMG.LIB to the list of modules passed 

to the linker. Add the path to this library to the list of directories searched for libraries in the 
project settings. 

8.  Define the macro SD_SIGNATURE_KEY with the value of the SwiftDecoder signature key in the 

project settings or in the very beginning of the source file decode.c. 

9.  Define the macro SD_VERIFICATION_KEY with the value of the SwiftDecoder verification key in 

the project settings or in the very beginning of the source file decode.c. 

10.  Rebuild the demo application 

 
 

Содержание IS4910 Series

Страница 1: ...METROLOGIC INSTRUMENTS INC IS4910 Series Area Imaging Engine Programmer s Manual...

Страница 2: ...rior written consent except by reviewer who may quote brief passages in a review or provided for in the Copyright Act of 1976 Trademarks Metrologic is a registered trademark of Metrologic Instruments...

Страница 3: ...a Support Library CamLib 5 Omniplanar Barcode Decoding Library SwiftDecoder 5 Metrologic Demo Application 5 INSTALLING IS4910 SOFTWARE Downloading Software to the Target Device 6 Easy Downloading Usin...

Страница 4: ...Time Exposure 14 camSetIntegrationDuration 15 camGetIntegrationDuration 15 camSetAutoExpoRange 15 camGetAutoExpoRange 16 Readout Order 16 camSetReadoutOrder 16 camGetReadoutOrder 16 Illumination 17 ca...

Страница 5: ...ntrol 23 camGetAutoBrightnessControl 24 IS4910 DEVICE DRIVER 25 Installation Procedure 25 Installing Driver in the Running OS 25 Including Driver in the Target OS Image 25 Registry Settings 26 Power M...

Страница 6: ......

Страница 7: ...image acquisition in video mode The Trigger signal is used to initiate image acquisition in snapshot mode The Trigger signal is also connected to the Illumination system thus automatically initiating...

Страница 8: ...CE operating system Metrologic is fully supporting an Intel PXA270 processing platform The software system can be easily ported to any other processing platform that has camera interface controller a...

Страница 9: ...fault will make the pre compiled Metrologic Demo Application inoperable Also in this section the user can specify in what directory on the target device the driver should be installed By default the d...

Страница 10: ...h does not last too long resulting in the image saturation Specifying the minimum and maximum illumination time provides the timing boundaries for the FirstFlash circuitry Image Sensor Gain The gain i...

Страница 11: ...sion whether to use the static or dynamic library is made by a user programmer depending on his her preferences and tools used to compile and build user applications Note that the Metrologic Demo Appl...

Страница 12: ...the target device specific software components must be transferred and installed on the target device Please refer to the following subsection Downloading Software to the Target Device for details Dow...

Страница 13: ...y going to Programs VuQuest2D SDK Note that the Image Acquisition Device Driver vuqdrv dll will be placed in the directory specified by the Path key in the Device section of the Driver Initialization...

Страница 14: ...nc software Now your Windows PC will be able to connect the target device over ActiveSync 4 At this point a dialog window should appear on the screen of your PC asking you to set up a connection partn...

Страница 15: ...o CamLib Once the CamLib framework is initialized an application must call camOpen function to establish communication with the camera device This function returns the device handle which must be used...

Страница 16: ...nt calls to CamLib APIs to identify the camera device on which an operation is requested to be performed camClose This function closes communication with the specified camera device Prototype int camC...

Страница 17: ...e camGetClocks This function returns the master and pixel clocks in Hertz Prototype int camGetClocks int cam_handle long pclk long mclk Parameters cam_handle in handle to the camera device returned by...

Страница 18: ...he camera device returned by the camOpen function img_leftx in x coordinate of the window upper left corner the maximum value is 1279 img_topy in y coordinate of the window upper left corner the maxim...

Страница 19: ...i the gain is set to 0 dB no gain For the purposes of automatic brightness adjustments an application can specify the minimum and maximum boundaries for the gain value By default the minimum gain is s...

Страница 20: ...inRange_db This function returns the minimum and maximum boundaries for the gain value during an execution of the automatic brightness adjustment see the function camAdjustBrightness for more details...

Страница 21: ...on time_ s in image integration exposure time in microseconds Return Value 0 Success 1 Failure camGetIntegrationDuration This function returns the current value of camera s image integration time in m...

Страница 22: ...IS4910 device driver initialization file VuQuest2D ini the image is transferred horizontally from left to right and vertically from top to bottom The readout order can be reversed for any or both of t...

Страница 23: ...e VuQuest2D ini illumination is enabled and the minimum illumination flash time for snapshot operations is set to 0 To enable or disable illumination while the camera is running in the video mode the...

Страница 24: ...hot mode of operation In the snapshot mode the functions camAcquireImage or camAcquireImageEx can be called to execute a single image acquisition and deliver the image data to the application To turn...

Страница 25: ...eturn Value 0 Success 1 Failure camAcquireImageEx This function performs an image acquisition and delivers the image data to the application If called when the camera is running in the video mode the...

Страница 26: ...eight bit pixels maximum should be allocated by the application prior to calling the function and the pointer to it along with the information about the buffer s size should be passed to the function...

Страница 27: ...is function pauses the video mode The video mode can be resumed by calling camResumeVideo Prototype int camPauseVideo int cam_handle Parameters cam_handle in handle to the camera device returned by th...

Страница 28: ...o the camera device returned by the camOpen function Return Value 0 Success 1 Failure camTurnAimingOff This function turns the IS4910 camera s aiming system off Prototype int camTurnAimingOff int cam_...

Страница 29: ...r allowed ranges see functions camSetAutoGainRange_db and camSetAutoExpoRange for details Prototype int camAdjustBrightness int cam_handle int cur_quality float correction_db unsigned long flags Param...

Страница 30: ...values should be applied to the camera immediately after taking the current image or postponed until and applied upon the next image acquisition The individual bit values are CAM_AUTOGAIN gain can be...

Страница 31: ...driver is described in Installing IS4910 Software section of this document The following subsections provide more details on the driver installation if such installation needs to be customized Instal...

Страница 32: ...configure the driver and initialize its operating parameters Value Type Description Prefix STRING Defines the three letter name of the driver Must be VUQ The device name is constructed from the Prefi...

Страница 33: ...d the driver fails to load GPIO_CIF_DD3 DWORD Specifies the GPIO pin connected to the D3 signal If it s not specified the driver fails to load GPIO_CIF_DD4 DWORD Specifies the GPIO pin connected to th...

Страница 34: ...egrationTime DWORD Optional Defines the image integration exposure time in microseconds Default is 8000 s In the snapshot mode if illumination is enabled the image integration time equals the maximum...

Страница 35: ...completely unplugs the power from it The failure to turn the IS4910 camera to power down state D4 prior to unplugging the power from it may result in rendering the camera inoperative and may require...

Страница 36: ...omsg if specified suppresses the message box with final status of installation ini file is name of the initialization ini file that contains the driver configuration settings If the ini file parameter...

Страница 37: ...MER Resources SysIntr DMAChannel MaxMemFrames Settings IntegrationTime MinFlashTime IllumControl Gain1000 PixelClock I2CBusClock I2C_PowerOff ReverseRows ReverseCols ImgWidth ImgHeight Values in the D...

Страница 38: ...normal polarity active high POLARITY_ILLUM optional specifies the polarity active high or low of the Illum_ON signal Allowed values are 1 normal polarity active high and 0 inverted polarity active lo...

Страница 39: ...camera is entering the power down state D4 If set to 1 the I2 C controller is disabled If set to 0 the I2 C controller remains to be enabled Default value is 0 ReverseRows optional defines order in wh...

Страница 40: ...he SwiftDecoder API functions SD2 LIB to the list of modules passed to the linker Add the path to this library to the list of directories searched for libraries in the project settings 4 Define the ma...

Страница 41: ...35...

Страница 42: ...January 2008 Revision 2 0 0 0 0 2 2 9 1 A...

Отзывы: