DcamViewer
Top  Previous  Next

DcamViewer is a universal plug-and-play application for DCAM (IIDC-1394) compliant cameras which is intended for camera and CPU performance evaluation. It can display live video from multiple cameras, provide full control over camera parameters, analyze incoming video frames and save them to image files. DcamViewer is available only as part of ActiveDcam SDK and not as separate distribution.

To start DcamViewer run "DcamViewer.exe" from ActiveDcam working folder. You can also run it through the Windows Start Menu: Start -> All Programs -> ActiveDcam -> DcamViewer or by double-clicking on the DcamViewer icon at the desktop. The following user interface will be displayed:

clip0133

When DcamViewer is launched for the first time, it will attempt to connect to the first camera in the DCAM-compliant camera list and start acquiring the live video.

Toolbar

The most often used commands to operate the viewer are provided through the toolbar at the upper part of the application window:
 
 
clip0144  
Live Video  
Switches the camera into the continuous acquisition mode and initiates live preview.  
 
clip0145  
One Shot  
Initiates an acquisition of one frame.  
 
clip0141  
Save Image  
Lets you save the current frame buffer in an image file. When you click this button, the Save As dialog box will appear where you can select the file name and one of the image file formats: BMP, TIF and JPEG.  
 
clip0140  
Open Image  
Lets you open the static image from a file and display the image. When you click this button, the Open dialog box will appear where you can select the file name and one of the image file formats: BMP, TIF and JPEG.  
 
clip0139  
Zoom in  
Click this button to increase the magnification of the image.  
 
clip0138  
Zoom out  
Click this button to decrease the magnification of the image.  
 
clip0137  
Fit to screen  
Click this button to change the magnification factor of the image so that it fits to the image window.  
 
clip0135  
Full screen  
Click this button to enter the full screen mode. To exit the full screen mode, press the Esc key or double-click on the image.  
 
clip0142  
Settings  
Click this button to display ActiveDcam Property Pages.  
 
 
In addition to buttons, the toolbar also contains the following controls:
 
Frame rate  
Show the current frame rate of the camera in frames per second.  
 
Select Camera  
Use this option to switch between several connected cameras.  
 
Select Format  
Use this option to select the desired pixel format from the list of available formats.  
 
Select Frame Rate  
Use this option to set the desired frame rate for the camera.  
 
 
Status Bar

The Status Bar appears along the lower edge of DcamViewer window and contains the following information fields in the order from left to right:
 
Frames acquired  
Displays the amount of acquired frame since the last restart of the acquistion.  
 
Frames skipped  
Displays the amount of skipped frames since the last restart of the acquistion.  
 
Image Size  
Displays the horizontal and vertical size of the video frames.  
 
Cursor Position  
Displays the X and Y coordinates of the mouse pointer. The coordinates are expressed in pixels relative to the top left corner of the image frame.  
 
Pixel Value  
Displays the value of the pixel identified by the mouse pointer. For a monochrome image, each pixel value will be represented by a single number, while for an RGB image by a triad of numbers.  


Menu

Right-clicking the video window of DcamViewer will display the context menu with the following commands:
 
Acquire Video  
Switches the camera into the continuous acquisition mode and initiates live preview. Equivalent to pressing the Live button.  
 
Store camera parameters  
Selecting this option will make DcamViewer store the main camera parameters upon its exit and restore them upon the next start. The parameters of each camera are stored independently in the system registry.  
 
Settings  
Displays ActiveDcam Property Pages.  
 
Save Image  
Lets you save the current frame buffer in an image file.  
 
Open Image  
Lets you open the static image from a file.  
 
Zoom in  
Increases the magnification of the image.  
 
Zoom out  
Decreases the magnification of the image.  
 
Fit to screen  
Changes the magnification factor of the image so that it fits to the image window.  
 

Operation

 
You can run several instances of DcamViewer at the same time provided each instance of the viewer is connected to a different camera.

If you want the current parameters of the camera to be memorized, activate the Store camera parameters option from the context menu. DcamViewer will save the parameters of the camera in the system registry upon exiting and restore it next time this camera is selected.

You are now ready to move to the next chapter and create your own DCAM application!