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. This function is available only in the Medical Imaging Suite toolkits.

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.