LImageViewer::SetRulerUnit

#include "ltwrappr.h"

L_INT LImageViewer::SetRulerUnit(uUnit, uFlags)

L_UINT uUnit;

/* measurement unit */

L_UINT uFlags;

/* reserved for future use */

Changes the measurement unit used for the viewer ruler.

Parameter

Description

uUnit

Value that represents the measurement unit used for the viewer ruler. Possible values are:

 

Value

Meaning

 

CONTAINER_RULERUNIT_INCHES

[0] Inches.

 

CONTAINER_RULERUNIT_FEET

[1] Feet.

 

CONTAINER_RULERUNIT_MICROMETERS

[2] Micrometers.

 

CONTAINER_RULERUNIT_MILLIMETERS

[3] Millimeters.

 

CONTAINER_RULERUNIT_CENTIMETERS

[4] Centimeters.

 

CONTAINER_RULERUNIT_METERS

[5] Meters.

uFlags

Reserved for future use. Pass 0.

Returns

SUCCESS

The function was successful.

< 1

An error occurred. Refer to Return Codes.

Comments

To retrieve the current measurement unit used for the viewer ruler, call the LImageViewer::GetRulerUnit function.

The annotation ruler and the cell ruler measurement unit values change depending on the value passed to the uUnit parameter.

Required DLLs and Libraries

LTIVW

For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application.

See Also

Functions:

LImageViewer::Create, LImageViewer::Destroy, LImageViewer::SetAction, LImageViewer::AddAction, LImageViewer::SetRulerUnit, LImageViewer::CalibrateRuler

Topics:

Image Viewer Functions: The Annotation Feature

 

The Annotation Feature

Example

For an example, refer to LImageViewer::CalibrateRuler.