SVS-Vistek CameraLink svs16000, Руководство пользователя

Страница: 64 / 97

Users Manual Area Scan Cameras SVSGigE Page 64
Users Manual –svs11002 and svs16000
© SVS-VISTEK GmbH
16.11 Best programming practices
In the following a step-by-step procedure will be given how to communicate to a
SVCam GigE camera by a software application. A working application that implements
all hints can be found in the sources of the SVGigE_Example.VC8 program which
comes as a part of the SVGigE SDK.
The project file of the SVGige_Example.VC8 program was generated by the Visual
Studio 2005 development environment which can be used to compile the project in
order to get to a running application:
NOTE : An application which was compiled with Visual Studio 2005 needs a runtime
environment in order to run on a WinXP computer. Dependent on the software
components that have already been installed on the target computer it might be
necessary to install the Microsoft VC runtime package (
vcredist_x86.exe
) in addition to
the runtime DLLs that are shipped with Visual Studio 2005. A discussion of the
involved problems can be found here:
http://forums.microsoft.com/MSDN/ShowPost.aspx?PostID=164132&SiteId=1
16.11.1 Connecting to the camera container
Whenever an application is going to operate SVCam GigE cameras it has to become a
client of the camera container first which is located inside the SVGigE.dll module.
CameraContainerClient_handle CameraClient;
CameraClient = CameraContainer_create(SVGigETL_TypeWinsock);
When establishing a connection to the camera container the application will demand
for the type of transport layer to be used for the network connection to the camera,
either a FilterDriver (recommended) or a Winsock (for first testing purposes) based
transport layer. The FilterDriver based transport layer guaranties the highest possible
performance
Once the application is done with cameras the connection to the container will be
closed what will allow the SVGigE DLL to release all resources which were occupied for
that client.
CameraContainer_delete(CameraClient);
Between becoming a camera client and shutting down the connection to the camera
container an application will be allowed to operate all SVCam GigE cameras that are
available in the attached network segment. The
CameraClient
handle is used for
identifying the application against the camera container module inside the SVGigE.dll.
16.11.2 Connecting to a camera
Based on a valid connection to the camera container an application can query for
available cameras and can open connections to one or multiple cameras.
Camera_handle Camera;
if( SVGigE_SUCCESS != CameraContainer_discovery(CameraClient) )
return;
int NumCameras = CameraContainer_getNumberOfCameras(CameraClient);
if( 0 == NumCameras )
return;
Camera = CameraContainer_getCamera(CameraClient, Index); // Index < NumCameras
The
Camera
handle relates a specific camera to an application. The application will have
to open a connection to the camera before being able to issue commands to the
camera and to initiate an image stream.
Camera_openConnection(Camera);