You are here: Start » Function Reference » Smart » Smart_GrabImage_SynView

Smart_GrabImage_SynView

Header:	ThirdPartySdk.h
Namespace:	fil

Captures an image from a smart camera using SynView interface. Allows for remote access to the runtime system.

Syntax

bool fil::Smart_GrabImage_SynView
(
	Smart_State& ioState,
	const fil::SmartIPAddress& inIpAddress,
	ftl::Optional<const ftl::String&> inDeviceID,
	fil::SynViewColorFormat::Type inPixelFormat,
	const fil::SynViewAcquisitionParams& inAcquisitionParams,
	const fil::SynViewImageFormatParams& inImageFormatParams,
	const fil::SynViewAnalogParams& inAnalogParams,
	fil::Image& outImage,
	bool& outIsRemote
)

Parameters

Name	Type	Default	Description
ioState	Smart_State&		Object used to maintain state of the function.
inIpAddress	const SmartIPAddress&		IP address of the runtime system (e.g. a smart camera)
inDeviceID	Optional<const String&>	NIL	Tries to find the camera in all available IDs (UserID, VendorName, ModelName...)
inPixelFormat	SynViewColorFormat::Type		Image color format
inAcquisitionParams	const SynViewAcquisitionParams&
inImageFormatParams	const SynViewImageFormatParams&
inAnalogParams	const SynViewAnalogParams&
outImage	Image&		Captured frame
outIsRemote	bool&

Hints

Check the IP address of your runtime system (e.g. using the "ipconfig" command) and set it to the inIpAddress input.
Set an appropriate inPixelFormat.
Run the program on you runtime system and the camera filter will acquire images directly on it.
Run the program on your development machine (e.g. your laptop) connected to the same Ethernet and the camera filter will receive images through a connection with the runtime system.

Multithreaded environment

This function is not guaranteed to be thread-safe. When used in multithreaded environment, it has to be manually synchronized.

Errors

List of possible exceptions:

Error type	Description
RuntimeError	Smart_GrabImage_SynView is not supported in the Lite edition.