Zoom

Description

Returns or sets the row value of the zoom


Syntax

[VB]
objActiveDcam.Zoom [= Value]

[C/C++]
HRESULT get_Zoom( long *pZoom );
HRESULT put_Zoom( long Zoom );


Data Type [VB]

Long

Parameters [C/C++]

pZoom [out,retval]

Pointer to the current zoom value

Zoom [in]

The zoom value to be set

Return Values

S_OK

Success

E_FAIL

The zoom control is not available for the selected camera

E_INVALIDARG

The value is out of range

Example

The following VB example demonstrates the use of a scroll control for real-time adjustment of the camera's zoom.

Private Sub Form_Load()
ActiveDcam1.Acquire=True
HScroll1.Value = ActiveDcam1.Zoom
HScroll1.Min = ActiveDcam1.GetZoomMin
HScroll1.Max = ActiveDcam1.GetZoomMax
End Sub

Private Sub HScroll1_Scroll()
ActiveDcam1.Zoom = HScroll1.Value
End Sub

Remarks

This property provides adjustment of the optical zoom of the camera lens. The valid property range is reported by the GetZoomMin and GetZoomMax methods. Note that the property is available only if the currently selected camera is equipped with a motorized lens supports software zoom control.