Back to FabImage Library website

You are here: Start » Function Reference » Camera Support » Smart » Smart_GrabImage_WebCamera

Smart_GrabImage_WebCamera


Header: ThirdPartySdk.h
Namespace: fil
Module: ThirdParty

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

Syntax

bool fil::Smart_GrabImage_WebCamera
(
	Smart_State& ioState,
	const fil::SmartIPAddress& inIpAddress,
	ftl::Optional<int> inDeviceID,
	fil::Image& outImage,
	bool& outIsRemote
)

Parameters

Name Type Default Description
Input will be modified ioState Smart_State& Object used to maintain state of the function.
Input value inIpAddress const SmartIPAddress& IP address of the runtime system
Input value inDeviceID Optional<int> NIL Tries to find the camera in all available IDs (UserID, VendorName, ModelName...)
Output value outImage Image& Captured frame
Output value outIsRemote bool& Specifies whether the program is currently executed on the runtime (True) or development (False) system

Hints

  • Check the IP address of your runtime system (e.g. using the "ipconfig" command) and set it to the inIpAddress input.
  • 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_WebCamera is not supported in the Lite edition.