Magnification

Description

Returns or sets the zoom factor for the live video display. The zero value will fit the image to the size of the control window.

Syntax

[VB]
objActiveDcam.Magnification [= Value]

[C/C++]
HRESULT get_Magnification( float *pMagnification );
HRESULT put_Magnification( float Magnification );


Data Type [VB]

Float

Parameters [C/C++]

pMagnification [out,retval]

Pointer to the current zoom factor

Magnification [in]

The zoom factor to be set.

Return Values

S_OK

Success

E_FAIL

Failure.

E_INVALIDARG

Invalid property value.

Example

This VB example sets the zoom factor to 0.25:

ActiveDcam1.Magnification = 0.25
MsgBox ActiveDcam1.Magnification

Remarks

This property adjusts the magnification of the life video display. It does not change the content of the image data, but only its appearance in the ActiveDcam control window. The valid property values are from 0 to 100. If the Magnification property is set to zero, the video image will be fit to the size of the control window. In this case the display might not retain the original proportions of the video frame. Note that the Acquire and Display properties must be set to TRUE in order for the live video to be displayed in the control window.