ExtendedCamera Class

Namespace: id3.Devices

Definition

Enhances Camera with functionalities for detailed stream management, supporting operations to query available streams, control stream states, and access live framesets.
class ExtendedCamera
class ExtendedCamera implements Finalizable
public partial class ExtendedCamera
public class ExtendedCamera implements AutoCloseable, Serializable
typedef struct id3DevicesExtendedCamera *ID3_DEVICES_EXTENDED_CAMERA;

Usage

extendedCameraInstance = ExtendedCamera()
# ...

Explicit destruction

# ...
del extendedCameraInstance
final extendedCameraInstance = sdk.ExtendedCamera();
// ...

Explicit destruction

// ...
extendedCameraInstance.dispose()
using (var extendedCameraInstance = new ExtendedCamera())
{
   // ...
}

Explicit destruction

var extendedCameraInstance = new ExtendedCamera()
// ...
extendedCameraInstance.Dispose()
try (ExtendedCamera extendedCameraInstance = new ExtendedCamera()) {
// ...
}

Explicit destruction

ExtendedCamera extendedCameraInstance = new ExtendedCamera();
// ...
extendedCameraInstance.close();
ID3_DEVICES_EXTENDED_CAMERA hExtendedCamera{};
int err = id3DevicesExtendedCamera_Initialize(&hExtendedCamera);
if (err == ID3_SUCCESS) {
    // ...
    id3DevicesExtendedCamera_Dispose(&hExtendedCamera);
}

Properties

Name

Type

Description

captureCallback

CaptureCallback

Callback invoked when new camera capture data becomes available.

deviceAddedCallback

PlugAndPlayCallback

Callback invoked when a device is added to the channel.

deviceClosedCallback

DeviceSelectedCallback

Callback function for when a device is closed on this channel.

deviceEventCallback

DeviceEventCallback

(C++): Callback for generic device events.

deviceFilterList

DeviceTypeList

A list filtering the types of devices this channel will interact with.

deviceId

int

Identifier for the device associated with this channel, intended for internal or plugin use.

deviceInfo

DeviceInfo

Fetches the device object.

deviceOpenedCallback

DeviceSelectedCallback

Callback that is called when a device is opened on this channel.

deviceRemovedCallback

PlugAndPlayCallback

Callback function triggered upon the removal of a device from the channel.

deviceState

DeviceState

Reflects the current state of the device, such as connected, disconnected, etc.

deviceStatusChangedCallback

DeviceCaptureStatusChangedCallback

Callback for when there’s any change in the device’s operational status.

isCapturing

bool

Indicates if the device is currently capturing data, providing a quick status check.

parameterCategoryList

StringList

Lists categories of parameters relevant to the device.

takeSnapshotCallback

CaptureCallback

Callback triggered when a snapshot capture is completed.

videoFormat

int

Sets or gets the current video format.

videoFormatList

VideoFormatList

Lists all video formats supported by the camera, aiding in format selection and compatibility checks.

Methods

Name

Description

addDeviceFilter

Adds a filter to specify the types of devices this channel should handle.

applyParameters

Applies a set of parameters to the device.

checkCommand

(C++/dotnet): Checks if a specific command is available on the device.

checkParameter

Confirms if a parameter exists on the device.

clearDeviceFilter

Clears all set device filters, removing any type restrictions.

closeDevice

Controls closing the associated device.

enableStream

(C++/dotnet): Toggles the activation state of a specified stream.

getCurrentFrame

Fetches the most recent frame from the live feed.

getCurrentFrameset

Fetches the most recent set of frames captured across enabled streams.

getLastSnapshot

Fetches the most recent snapshot taken by the takeSnapshot function.

getMeasurementData

Retrieves a list of measurement data collected during capture sessions.

getParameter

Retrieves a device parameter’s value.

getParameterDescriptor

Fetches the descriptor of a device parameter.

getParameterList

Obtains all supported parameters, optionally filtered by category.

getParameterNameList

Retrieves names of all supported parameters, optionally filtered by category.

getParameterValueInt

Gets the integer value of a device parameter.

getSpecificFrame

Gets a specific live frame.

getStreamStatus

Queries the current status (enabled/disabled) of a specific stream.

getSupportedStreams

Retrieves a list of all streams supported by the device.

isPreviouslyDisconnectedDevice

Checks if the specified device was previously disconnected.

openDevice

Controls opening the associated device.

sendCommand

(C++/dotnet): Issues a command to the device.

sendCommandBoolean

(C++/dotnet): Issues a command with a boolean as result to the device.

sendModelCommand

(C++/dotnet): Dispatches a command to the device model.

setParameter

Sets a device parameter’s value.

setParameterValueInt

Assigns an integer value to a device parameter.

startCapture

Initiates data capture, allowing for an optional parameter to specify capture modes or configurations.

stopCapture

Ends the data capture process, stopping the live feed or any ongoing capture activity.

takeSnapshot

Triggers a snapshot capture process, with the result accessible through getLastSnapshot.

waitForCapture

Waits for new capture data within a specified timeout period.