Flir.Atlas.Live.Remote.RemoteCameraFocus Class Reference

Control the camera focus. More...

Public Member Functions
bool	IsSupported ()
	Checks if the camera supports focus. More...
void	Mode (FocusMode mode)
	Control the camera focus. More...
double	GetDistance ()
	Get focus distance in meters. More...
void	SetDistance (double distance)
	Set focus distance (meters). More...
int	GetSpeed ()
	Get focus speed. Range -100 - 100. Speed 0 = engine stopped. Negative speed = reverse (focus near). Positive speed = forward (focus far). More...
void	SetSpeed (int speed)
	Set focus speed. Range -100 - 100. Speed 0 = engine stopped. Negative speed = reverse (focus near). Positive speed = forward (focus far). This method is redundancy to Mode combined with Speed. More...
bool	IsContinuousFocusEnabled ()
	Check if continuous focus is enabled. More...
void	EnableContinuousFocus ()
	Enable continuous focus. More...
void	DisableContinuousFocus ()
	Disable continuous focus More...
Rectangle	GetRoi ()
	Get auto focus region of interest. More...
void	SetRoi (Rectangle roi)
	Set auto focus region of interest. More...

Detailed Description

Control the camera focus.

Examples

The following code example demonstrates how to control the camera focus. This example is designed to be used with a Windows Forms that contains a GroupBox named groupBoxFocus, a TextBox named textBoxDistance and Button named buttonFocusNear, buttonFocusFar and buttonFocusAuto. See the sample GigabitCamera for the full source code.

 <![CDATA[
public partial class FocusControl : UserControl
{
    private const NumberStyles StyleDouble = NumberStyles.AllowDecimalPoint | NumberStyles.AllowThousands | NumberStyles.AllowLeadingSign;

    private ThermalCamera _camera;
    public FocusControl()
    {
        InitializeComponent();
    }

    public void SetCamera(ThermalCamera camera)
    {
        if (_camera != null)
        {
            _camera.ConnectionStatusChanged -= _camera_ConnectionStatusChanged;
            _camera = null;
        }
        if (camera != null)
        {
            _camera = camera;
            _camera.ConnectionStatusChanged += _camera_ConnectionStatusChanged;
            BeginInvoke(((Action)(() => UpdateButtons(_camera.ConnectionStatus))));
        }
    }

    private void UpdateButtons(ConnectionStatus connectionStatus)
    {
        if (connectionStatus == ConnectionStatus.Connected && _camera.RemoteControl.Focus.IsSupported())
        {
            groupBoxFocus.Enabled = true;
            try
            {
                textBoxDistance.Text = string.Format("{0:F}", _camera.RemoteControl.Focus.GetDistance());
            }
            catch (CommandFailedException exception)
            {
                textBoxDistance.Enabled = false;
            }
        }
        else
        {
            groupBoxFocus.Enabled = false;
        }
    }

    void _camera_ConnectionStatusChanged(object sender, Flir.Atlas.Live.ConnectionStatusChangedEventArgs e)
    {
        BeginInvoke(((Action)(() => UpdateButtons(e.Status))));
    }

    private void buttonFocusNear_MouseDown(object sender, MouseEventArgs e)
    {
        _camera.RemoteControl.Focus.Mode(FocusMode.Near);
    }

    private void buttonFocusNear_MouseUp(object sender, MouseEventArgs e)
    {
        _camera.RemoteControl.Focus.Mode(FocusMode.Stop);
    }

    private void buttonFocusAuto_Click(object sender, EventArgs e)
    {
        _camera.RemoteControl.Focus.Mode(FocusMode.Auto);
    }

    private void buttonFocusFar_MouseDown(object sender, MouseEventArgs e)
    {
        _camera.RemoteControl.Focus.Mode(FocusMode.Far);
    }

    private void buttonFocusFar_MouseUp(object sender, MouseEventArgs e)
    {
        _camera.RemoteControl.Focus.Mode(FocusMode.Stop);
    }

    private void buttonFocusDistance_Click(object sender, EventArgs e)
    {
        double value;
        if (double.TryParse(textBoxDistance.Text, StyleDouble, CultureInfo.InvariantCulture, out value))
        {
            _camera.RemoteControl.Focus.SetDistance(value);
        }
        else
        {
            MessageBox.Show("Invalid input");
        }
    }
}
 ]]>

Member Function Documentation

DisableContinuousFocus()

void Flir.Atlas.Live.Remote.RemoteCameraFocus.DisableContinuousFocus ( )

inline

Disable continuous focus

Exceptions

InvalidOperationException

Supported by the T1K camera.

EnableContinuousFocus()

void Flir.Atlas.Live.Remote.RemoteCameraFocus.EnableContinuousFocus ( )

inline

Enable continuous focus.

Exceptions

InvalidOperationException

Supported by the T1K camera

GetDistance()

double Flir.Atlas.Live.Remote.RemoteCameraFocus.GetDistance ( )

inline

Get focus distance in meters.

Returns

Distance in meters

Set distance is supported by the T1K and A6XX cameras, you can also check with your camera specification if set distance is supported.

Exceptions

InvalidOperationException
CommandFailedException

GetRoi()

Rectangle Flir.Atlas.Live.Remote.RemoteCameraFocus.GetRoi ( )

inline

Get auto focus region of interest.

Returns

Exceptions

InvalidOperationException
CommandFailedException

GetSpeed()

int Flir.Atlas.Live.Remote.RemoteCameraFocus.GetSpeed ( )

inline

Get focus speed. Range -100 - 100. Speed 0 = engine stopped. Negative speed = reverse (focus near). Positive speed = forward (focus far).

Returns

Focus engine speed.

Exceptions

InvalidOperationException
CommandFailedException

IsContinuousFocusEnabled()

bool Flir.Atlas.Live.Remote.RemoteCameraFocus.IsContinuousFocusEnabled ( )

inline

Check if continuous focus is enabled.

Returns

True if continuous focus is enabled.

Exceptions

InvalidOperationException
CommandFailedException

Supported cameras are the T1K

IsSupported()

bool Flir.Atlas.Live.Remote.RemoteCameraFocus.IsSupported ( )

inline

Checks if the camera supports focus.

Returns

True if Focus is supported.

Synchronous.

Exceptions

InvalidOperationException
CommandFailedException

Mode()

void Flir.Atlas.Live.Remote.RemoteCameraFocus.Mode ( FocusMode  mode )

inline

Control the camera focus.

Parameters

mode

Asynchronously sets focus mode, RemoteControl.CommandExecuted for more information about the result.

Exceptions

InvalidOperationException

SetDistance()

void Flir.Atlas.Live.Remote.RemoteCameraFocus.SetDistance ( double  distance )

inline

Set focus distance (meters).

Parameters

distance

meters

Exceptions

InvalidOperationException

Set distance is supported by the T1K and A6XX cameras, you can also check with your camera specification if set distance is supported.

SetRoi()

void Flir.Atlas.Live.Remote.RemoteCameraFocus.SetRoi ( Rectangle  roi )

inline

Set auto focus region of interest.

Parameters

roi	Region of interest.

Exceptions

InvalidOperationException

SetSpeed()

void Flir.Atlas.Live.Remote.RemoteCameraFocus.SetSpeed ( int  speed )

inline

Set focus speed. Range -100 - 100. Speed 0 = engine stopped. Negative speed = reverse (focus near). Positive speed = forward (focus far). This method is redundancy to Mode combined with Speed.

Parameters

speed

Focus engine speed.

Exceptions

InvalidOperationException