This website is being translated through machine translation by a third-party service. Basler does not warrant the accuracy, reliability or timeliness of any information translated by this system and will not accept liability for loss or damage incurred as a result. Content that has not yet been translated appears in English. Switch to English version
Retrieves a grab result according to the strategy, waits if it is not yet available.
Parameters:
timeoutMs A timeout value in ms for waiting for a grab result, or the INFINITE value.
grabResult Receives the grab result.
timeoutHandling If timeoutHandling equals TimeoutHandling_ThrowException, a timeout exception is thrown on timeout.
Return: True if the call successfully retrieved a grab result, false otherwise.
Precondition: The preconditions for calling StartGrabbing() are met for every camera in the array.
Postcondition:
If successful, one image is removed from the output queue of a camera and is returned in the grabResult parameter.
If not successful, an empty grab result is returned in the grabResult parameter.
Error Safety:
The Instant Camera Array object is still valid after error. The grabbing is stopped by calling StopGrabbing() if an exception is thrown.
The content of the passed grab result is released.
If the grabbing is not started, the method returns immediately false.
If GrabStrategy_UpcomingImage strategy: RetrieveResult is called for a camera. Cameras are processed using a round-robin strategy.
If GrabStrategy_OneByOne, GrabStrategy_LatestImageOnly or GrabStrategy_LatestImages strategy: Pending images or camera events are retrieved. Cameras are processed using a round-robin strategy.
If GrabStrategy_OneByOne, GrabStrategy_LatestImageOnly or GrabStrategy_LatestImages strategy: Wait for a grab result if it is not yet available. Camera events are handled.
The camera array index is assigned to the context value of the instant camera when Initialize() is called. This context value is attached to the result when the result is retrieved and can be obtained using the grab result method GrabResultData::GetCameraContext(). The context value can be used to associate the result with the camera from where it originated.
Retrieves a grab result according to the strategy, waits if it is not yet available.
Parameters:
timeoutMs A timeout value in ms for waiting for a grab result, or the INFINITE value.
grabResult Receives the grab result.
timeoutHandling If timeoutHandling equals TimeoutHandling_ThrowException, a timeout exception is thrown on timeout.
Return: True if the call successfully retrieved a grab result, false otherwise.
Precondition: The preconditions for calling StartGrabbing() are met for every camera in the array.
Postcondition:
If successful, one image is removed from the output queue of a camera and is returned in the grabResult parameter.
If not successful, an empty grab result is returned in the grabResult parameter.
Error Safety:
The Instant Camera Array object is still valid after error. The grabbing is stopped by calling StopGrabbing() if an exception is thrown.
The content of the passed grab result is released.
If the grabbing is not started, the method returns immediately false.
If GrabStrategy_UpcomingImage strategy: RetrieveResult is called for a camera. Cameras are processed using a round-robin strategy.
If GrabStrategy_OneByOne, GrabStrategy_LatestImageOnly or GrabStrategy_LatestImages strategy: Pending images or camera events are retrieved. Cameras are processed using a round-robin strategy.
If GrabStrategy_OneByOne, GrabStrategy_LatestImageOnly or GrabStrategy_LatestImages strategy: Wait for a grab result if it is not yet available. Camera events are handled.
The camera array index is assigned to the context value of the instant camera when Initialize() is called. This context value is attached to the result when the result is retrieved and can be obtained using the grab result method GrabResultData::GetCameraContext(). The context value can be used to associate the result with the camera from where it originated.
Returns the connection state of the camera devices used by the Instant Cameras in the array.
Return: True if the camera device removal from the PC for any camera in the array has been detected.
Error Safety:
Does not throw C++ exceptions.
The device removal is only detected if the Instant Cameras and therefore the attached Pylon Devices are open.
The Pylon Device is not operable after this event. After it is made sure that no access to the Pylon Device or any of its node maps is made anymore the Pylon Device should be destroyed using InstantCamera::DeviceDestroy(). The access to the Pylon Device can be protected using the lock provided by GetLock(), e.g. when accessing parameters.