Magnification

Description

Returns or sets the zoom factor for the live video display.

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]

Floating point value specifying the zoom factor to be set. If 0, the image will be fit to the size of the control window. If -1, the image will be displayed in the full-screen mode.

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. If the property is set to -1, the image will be displayed in the full-screen mode retaining the original proportions.

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.

Note that setting both Display and Magnification properties to zero will disable an image conversion pipeline that is normally applied to each raw frame. This will significantly increase the performance of your application as long as it does not utilize ActiveDcam's built-in image decoding/display and uses GetRawData to access the raw image data.