Provides access to camera information. The camera information can be updated if camera properties have changed. Camera properties may change e.g. if a GigE camera has been assigned a new IP address after reconnection.
Tries to open a connection to the camera until a timeout occurs. If the camera device is not available, the method tries to access the camera until a timeout occurs.
During the execution of this event, the connection to the camera is already open.
If an event handler called by this event throws an exception, the connection to the camera will be closed and the exception will be propagated to the caller of Open(). No other handlers will be called.
This event is fired inside the lock of the camera instance.
Called event handlers should expect exceptions if they call methods of the camera. It is safe to call Close().
If an event handler throws an exception, it will be ignored and the remaining handlers will be called.
This event is fired inside the lock of the camera instance. Event handlers should make no assumptions on the thread from which the event handler is called.
// Copy a file into a byte array:
using (Stream fs = m_camera.CreateFileStream( fileName, System.IO.FileAccess.Read ))
using (MemoryStream ms = new MemoryStream())
{
fs.CopyTo( ms );
byte [] Buffer = ms.ToArray();
}
It is not possible to access multiple files in parallel. Dispose the stream before opening the next.
Thread Safety: This method is synchronized with the lock of the camera object.
Type: Version Returns the version number of the SFNC specification that the camera complies to. If no SFNC version information is available, a version of 0.0.0.0 is returned.
If the connection to the camera is already open, the function returns successfully.
The CameraOpening event is fired. The notification of event handlers stops in case any eventhandler throws an exception.
The connection to the camera device is established.
The CameraOpened event is fired if the camera object has been opened successfully. The notification of event handlers stops in case any eventhandler throws an exception.
Opening the camera connection may fail if the camera connection has been already opened by another instance or if a physical connection could not be established. You can check the current state of a camera by calling CameraFinder::GetDeviceAccessibilityInfo
Thread Safety: This method is synchronized with the lock of the camera object.
Error Safety: Can throw exceptions if the camera cannot be opened successfully or if any of the event handlers throws an exception.
Tries to open a connection to the camera until a timeout occurs. If the camera device is not available, the method tries to access the camera until a timeout occurs.
If the camera is already open, the function returns successfully.
If the camera device is not available, the method tries to rediscover the camera by enumerating all camera devices of the same type or by checking the availability until a timeout occurs or the camera class is disposed.
If the camera is not found, the method returns or throws an exception. The action depends on the timeoutHandling parameter.
Type: System.Int32 The timeout period in milliseconds. If the SoftwareTrigger.IsDone() method does not return true within the given period, a timeout will occur. The exact timeout behaviour can be set using the timeoutHandling parameter.
Type: Boolean Returns true if the camera was ready to receive a software trigger within the given time period. Otherwise, the action specified in timoutHandling is performed.
After issuing a software trigger, there is a short time period within which the camera is unable to accept another trigger. During this period, all triggers are ignored. You can use this function to poll until the camera is ready to accept a trigger.
Thread Safety: This method is synchronized with the lock of the camera object.
Tries to open a connection to the camera until a timeout occurs. If the camera device is not available, the method tries to access the camera until a timeout occurs.
Provides access to camera information. The camera information can be updated if camera properties have changed. Camera properties may change e.g. if a GigE camera has been assigned a new IP address after reconnection.
Type: Boolean Returns true if the camera device is properly connected to the camera object while the camera object is open. Returns false if the camera object is closed.
The camera object will not automatically close itself if the connection to the camera device is lost, e.g., if the camera device is physically disconnected from the PC.
Thread Safety: This method is synchronized with the lock of the camera object.
You can use the parameter collection to configure the camera device and the camera instance through parameters. You can access parameters by their name or predefined parameter lists.
There are several predefined parameter lists available:
PLCamera
PLCameraInstance
PLStreamGrabber
PLEventGrabber
PLTransportLayer
For more information about the parameters, see the documentation for the parameter list.
You can access parameters by passing a key from a parameter list to the index operator, e.g. C#
camera.Parameters[PLCamera.Width].GetValue();
Thread Safety: This method is synchronized with the lock of the camera object.