imaqGetWindowZoom2

NI Vision for LabWindows/CVI Function

imaqGetWindowZoom2

Usage

int imaqGetWindowZoom2(int windowNumber, float* xZoom, float* yZoom);

Purpose

Retrieves the current zoom factors for a given image window. The zoom factor indicates an increase or decrease in the magnification of an image and this value is expressed as a ratio of the image size. A number greater than 1 indicates a magnification by the amount specified. For example, a zoom factor of 3 indicates that the image is displayed at three times its actual size (3:1). A number less than 1 indicates that the image is decreased in magnification by the specified amount. For example, a zoom factor of 0.2 indicates that the image is displayed at one-fifth its actual size (1:5).

Parameters

Name

Type

Description

windowNumber int The window number of the image window.
xZoom float* On return, the current zoom factor in the x direction for the window.
yZoom float* On return, the current zoom factor in the y direction for the window

Return Value

Type

Description

int On success, this function returns a non-zero value. On failure, this function returns 0. To get extended error information, call imaqGetLastError().