measCurves

measCurves ( integer Input, integer Step [, string File, string User ] )

Use this function to activate interactive curve measurements that allow you to define curve features and collect information about their geometrical properties. Equivalent to selecting the Curve Measurements command in the Measure menu. Prior to performing curve measurements, the image must be calibrated with a proper spatial calibration scale.

Parameters

Input

An integer between 1 and 99 specifying the frame number of the image for which the measurements are taken.

Step

A positive integer specifying the distance between consecutive points in freehand segments of curve features.

File

An optional string specifying the name of the ImageWarp data file for saving measurement results. If the file already exists, the data previously stored will be loaded into the Measurement table and the measurement parameters recorded in the file will be used to activate the set of measurements for the session. If no such a file exists, it will be created when the user presses the Save button on the dialog. In this case the set of parameters must be selected manually by pressing the Parameters button or specified in advance by using the combination of the setParamScope and selectParam functions.

User

A string specifying the formulas for calculating user-defined parameter. See User-defined parameters for more details.

Error flags

ERR_OK

The flag set if successful.

ERR_FAILED

The flag set if failed.

Example

This set of statements reads a sample image, initializes measurement parameters using the global scope and activates interactive curve measurements:

setCurDir ("samples")

loadIm (1,"sample8.iwd")

setParamScope(PAR_GLOBAL)

resetParam()

selectParam ("Length","BoxLength","BoxWidth")

measCurves (1,3,"curves.dbs")

Remark

For more information on the Curve Measurements dialog box and the list of supported parameters refer to ImageWarp User's Guide.