Home
MB-Ruler Help Prev Page Prev Page
Quickstart
Registration
Measure Instruments
Define Scale
Triangular Ruler
Coordinate System
Additional Features
RGB Picker
Screen Cutter
Screen Loupe
Overlay Objects
Remote Interface
Communication
Functions
Hotkeys
Comments of other users
History
About ...
MB-Ruler Pro
Double Cross Hair
Circle (radius)
Circle (3 points)
Ellipse
Polyline
Polygon
Line
Angle (3 points)
Angle (4 points)
Distance Point-to-Line
Comparison with MB-Ruler
Download of the Demo Version
Homepage
Homepage of MB-Ruler Pro
Homepage of MB-ScreenOverlay SDK

Remote Interface - generell functions

Set the active measure instrument

Message WParam LParam Result
WM_MB_RULER_MEASURE_INSTRUMENT WM_MB_RULER_SET_INSTRUMENT MEASURE_INSTRUMENT_NONE
MEASURE_INSTRUMENT_TRIANGULAR_RULER
MEASURE_INSTRUMENT_COORDINATE_SYSTEM
MEASURE_INSTRUMENT_DOUBLE_CROSS_HAIR
MEASURE_INSTRUMENT_CIRCLE_RADIUS
MEASURE_INSTRUMENT_CIRCLE_THREEPOINTS
MEASURE_INSTRUMENT_ELLIPSE_TWOCENTER_POINT
MEASURE_INSTRUMENT_POLYGON
MEASURE_INSTRUMENT_POLYLINE
MEASURE_INSTRUMENT_LINE_TWOPOINTS
MEASURE_INSTRUMENT_LINE_THREEPOINTS
MEASURE_INSTRUMENT_LINE_FOURPOINTS
MEASURE_INSTRUMENT_DISTANCE_POINT_TO_LINE
1, if the measure instrument was set
0, if the measure instrument could not be set

Get the active measure instrument

Message WParam LParam Result
WM_MB_RULER_MEASURE_INSTRUMENT WM_MB_RULER_CHECK_INSTRUMENT 0 MEASURE_INSTRUMENT_NONE
MEASURE_INSTRUMENT_TRIANGULAR_RULER
MEASURE_INSTRUMENT_COORDINATE_SYSTEM
MEASURE_INSTRUMENT_DOUBLE_CROSS_HAIR
MEASURE_INSTRUMENT_CIRCLE_RADIUS
MEASURE_INSTRUMENT_CIRCLE_THREEPOINTS
MEASURE_INSTRUMENT_ELLIPSE_TWOCENTER_POINT
MEASURE_INSTRUMENT_POLYGON
MEASURE_INSTRUMENT_POLYLINE
MEASURE_INSTRUMENT_LINE_TWOPOINTS
MEASURE_INSTRUMENT_LINE_THREEPOINTS
MEASURE_INSTRUMENT_LINE_FOURPOINTS
MEASURE_INSTRUMENT_DISTANCE_POINT_TO_LINE
- depending of the active measure instrument

Get the measured data of the active measure instrument

The current measure values can be read by a simple iteration. Look at the description of the measure instrument for the description of the order of the returned values.
All measure values are SIGNED values.
Message WParam LParam Result
WM_MB_RULER_GETVALUE ValueID (valid values are listet in the description of the measure instrument) 0 Measured value of the measure instrument, that belongs to the ValueID (the format of the returned values is listed in the description of the measure instrument)
-1, if the ValueID has no valid value

Get the position data of the active measure instrument

The current position information can be set by a simple iteration. Look at the description of the measure instrument for the description of the order of the returned values.
All position information are SIGNED values.
Message WParam LParam Result
WM_MB_RULER_GETVALUE ValueID (valid values are listet in the description of the measure instrument) 0 Position information of the measure instrument, that belongs to the ValueID (the format of the returned values is listed in the description of the measure instrument)
-1, if the ValueID has no valid value

Set the position data of the active measure instrument

Each position information can also be set.
All position information are SIGNED values.
Message WParamLo WParamHi LParam Result
WM_MB_RULER_GETVALUE ValueID (valid values are listet in the description of the measure instrument) =0, value to set is an absolute value
=1, value to set is a relativ value
value to set (the format of the value to set is listed in the description of the measure instrument) 0,if the new position was set
-1, if the ValueID or the position information has no valid value

Store measure data

Message WParam LParam Result
WM_MB_RULER_RULER RULER_STORE_VALUES 0 0

Inform the client application, when values have changes

If the calling application was added to the message loop of MB-Ruler, MB-Ruler informs the client about every changed messure value or position data by a windows message.

Change of measure value

Message WParam LParam
WM_MB_RULER_MEASURE_INSTRUMENT WM_MB_RULER_VALUECHANGED one of the values MEASURE_INSTRUMENT_XXX, if the measure instrument changed
$FFFF, if the measure instrument did not change

Change of position information

Message WParam LParam
WM_MB_RULER_MEASURE_INSTRUMENT WM_MB_RULER_DATACHANGED one of the values MEASURE_INSTRUMENT_XXX, if the measure instrument changed
$FFFF, if the measure instrument did not change
Converted from CHM to HTML with chm2web Pro 2.76 (unicode)