Objects

_GenerateBinaryND, _InspectObjects, _MeasureObjectsND, _ObjectData, _ObjectMeasSetup, _Restrictions, _ScanObjects, ClearCurrentMeasurement, GenerateBinary, GenerateBinaryEx, GenerateBinaryExND, GenerateBinaryND, MeasureObjects, MeasureObjectsND, ResetObjectFeatures, ResetRestrictions, Restrictions, ScanObjects, ScanObjectsND, SelectObjectFeature, UpdateCurrentMeasurement

ClearCurrentMeasurement

Description 

 ClearCurrentMeasurement();

This function deletes current measurement results from the Automated Measurement Results control window.

GenerateBinary

This function runs the Measure > Generate Binary Using Restrictions command.

Description 

 GenerateBinary();

This function creates binary image consisting of objects involved in the statistics.

See Also 
ScanObjects, Restrictions, MeasFrame, MaskOn

GenerateBinaryEx

Description 

DOUBLE GenerateBinaryEx(
   char *Feat1,
   double  FeatLow1,
   double  FeatHigh1,
   char *Feat2,
   double  FeatLow2,
   double  FeatHigh2,
   char *Feat3,
   double  FeatLow3,
   double  FeatHigh3
);

This function modifies a current binary image by removing objects that do not match the defined restrictions.

Parameters

char *Feat1

Name of the feature #1. If feat1 == NULL (0) or does not exist, the restriction is ignored.

double FeatLow1

Lower value of the restriction interval of the feature #1.

double FeatHigh1

Higher value of the restriction interval of the feature #1.

char *Feat2

Name of the feature #2. If feat2 == NULL (0) or does not exist, the restriction is ignored.

double FeatLow2

Lower value of the restriction interval of the feature #2.

double FeatHigh2

Higher value of the restriction interval of the feature #2.

char *Feat3

Name of the feature #3. If feat3 == NULL (0) or does not exist, the restriction is ignored.

double FeatLow3

Lower value of the restriction interval of the feature #3.

double FeatHigh3

Higher value of the restriction interval of the feature #3.

Return Values

DOUBLE

If the function is successful, the return value is TRUE (1), else FALSE (0).

Note

Compared to the GenerateBinary function, this function can use features that are not defined for an object measurement and ignores a measurement frame.

See Also 
Restrictions

GenerateBinaryExND

Description 

DOUBLE GenerateBinaryExND(
   char *Feat1,
   double  FeatLow1,
   double  FeatHigh1,
   char *Feat2,
   double  FeatLow2,
   double  FeatHigh2,
   char *Feat3,
   double  FeatLow3,
   double  FeatHigh3,
   int  NDTLoop,
   int  NDMPLoop,
   int  NDZLoop
);

This function modifies a current binary image by removing objects that do not match the defined restrictions.

Parameters

char *Feat1

Name of the feature #1. If feat1 == NULL (0) or does not exist, the restriction is ignored.

double FeatLow1

Lower value of the restriction interval of the feature #1.

double FeatHigh1

Higher value of the restriction interval of the feature #1.

char *Feat2

Name of the feature #2. If feat2 == NULL (0) or does not exist, the restriction is ignored.

double FeatLow2

Lower value of the restriction interval of the feature #2.

double FeatHigh2

Higher value of the restriction interval of the feature #2.

char *Feat3

Name of the feature #3. If feat3 == NULL (0) or does not exist, the restriction is ignored.

double FeatLow3

Lower value of the restriction interval of the feature #3.

double FeatHigh3

Higher value of the restriction interval of the feature #3.

int NDTLoop

0

apply to the current loop only

1

apply to the whole Time dimension

int NDMPLoop

Apply to Multi Point dimension.

0

apply to the current loop only

1

apply to the whole Multi Point dimension

int NDZLoop

Apply to Z dimension

0

apply to the current loop only

1

apply to the whole Z Series dimension

Return Values

DOUBLE

If the function is successful, the return value is TRUE (1), else FALSE (0).

Note

Compared to GenerateBinaryND function, this function can use features that are not defined for an object measurement and ignores a measurement frame.

GenerateBinaryND

Description 

 GenerateBinaryND(
   int  NDTLoop,
   int  NDMPLoop,
   int  NDZLoop
);

The GenerateBinaryND function creates binary image consisting of objects involved in the Scan Objects statistics.

Parameters

int NDTLoop

0

apply to the current loop only

1

apply to the whole Time dimension

int NDMPLoop

Apply to Multi Point dimension.

0

apply to the current loop only

1

apply to the whole Multi Point dimension

int NDZLoop

Apply to Z dimension

0

apply to the current loop only

1

apply to the whole Z Series dimension

MeasureObjects

This function runs the Measure > Measure Objects command.

Description 

 MeasureObjects();

This function performs the object measurement.

MeasureObjectsND

Description 

 MeasureObjectsND(
   int  NDTLoop,
   int  NDMPLoop,
   int  NDZLoop
);

This function performs the object measurement on an ND document.

Parameters

int NDTLoop

0

apply to the current loop only

1

apply to the whole Time dimension

int NDMPLoop

Apply to Multi Point dimension.

0

apply to the current loop only

1

apply to the whole Multi Point dimension

int NDZLoop

Apply to Z dimension

0

apply to the current loop only

1

apply to the whole Z Series dimension

ResetObjectFeatures

Description 

 ResetObjectFeatures();

This function clears features for the object measurement. This function is typically called, when you invoke the Object Features command (Measure menu).

See Also 
_ObjectMeasSetup, SelectObjectFeature, _ObjectMeasSetup

ResetRestrictions

Description 

 ResetRestrictions();

This function removes restrictions from all measurement features.

Note

Some objects are not involved in measurement because of lying out of the measurement frame, the mask image or the restriction interval. E.g. you can create a binary image that contains only circular objects if you set restrictions on circularity feature.

See Also 
_Restrictions, _ObjectMeasSetup, _FieldMeasSetup

Restrictions

Description 

 Restrictions(
    FeatName,
   int  Valid,
   int  Inside,
   double  FeatLow,
   double  FeatHigh
);

This function defines restriction interval of the feature.

Parameters

FeatName

Name of the feature.

int Valid

Turn on/off the restriction.

0

Restriction is disabled.

1

Restriction is enabled.

int Inside

Defines type of the interval.

0

Objects involved in the statistics have the value of “FeatName” feature out of the restriction interval.

1

Objects involved in the statistics have the value of the “FeatName” feature in the restriction interval.

double FeatLow

The lower value of the restriction interval.

double FeatHigh

The higher value of the restriction interval.

See Also 
ResetRestrictions

ScanObjects

This function runs the Measure > Perform Measurement command.

Description 

 ScanObjects();

This function performs measurement of the defined features over each object.

Note

The segmented image (=current binary) is scanned and a set of size, shape, color and density features is measured (for measurement of color and density features underlying current color (gray) image is used). The set of features is defined by Object Features command (Measure menu). Only objects within the measurement frame and the mask image are measured. Scan Objects command is an executable command of object measurement. Before calling it, you have to define the measurement using Object Features command. The Scan Objects command accepts only objects that match the restriction criteria defined by Restrictions command.

See Also 
_ObjectData, Restrictions, GenerateBinary, MeasFrame, MaskOn

ScanObjectsND

Description 

 ScanObjectsND(
   int  NDTLoop,
   int  NDMPLoop,
   int  NDZLoop
);

This function performs measurement of the defined features over each object on the selected dimension.

Parameters

int NDTLoop

0

apply to the current loop only

1

apply to the whole Time dimension

int NDMPLoop

Apply to Multi Point dimension.

0

apply to the current loop only

1

apply to the whole Multi Point dimension

int NDZLoop

Apply to Z dimension

0

apply to the current loop only

1

apply to the whole Z Series dimension

Note

The segmented image (=current binary) is scanned and a set of size, shape, color and density features is measured (for measurement of color and density features underlying current color (gray) image is used). The set of features is defined by Object Features command (Measure menu). Only objects within the measurement frame and the mask image are measured. Scan Objects command is an executable command of object measurement. Before calling it, you have to define the measurement using the Object Features command. The Scan Objects command accepts only objects that match the restriction criteria defined by Restrictions command (Measure menu).

See Also 
_ObjectData, Restrictions, GenerateBinary, MeasFrame, MaskOn

SelectObjectFeature

Description 

 SelectObjectFeature(
   char *FeatName
);

This function defines a feature to be included to object measurement. This function is typically called, when you invoke the Object Features (Measure menu). An interactive equivalent is the _ObjectMeasSetup function which generates one or more of the SelectObjectFeature function(s).

Parameters

char *FeatName

Name of the measurement feature.

See Also 
_ObjectMeasSetup, ResetObjectFeatures

UpdateCurrentMeasurement

Description 

 UpdateCurrentMeasurement();

Updates Automated Measurement Results data.

_GenerateBinaryND

Description 

 _GenerateBinaryND();

This function equals the GenerateBinary function except when performed on ND2 document you will be prompted to select whether to process the current image, selected dimension, or the whole ND document.

See Also 
GenerateBinary

_InspectObjects

This function runs the Measure > Inspect objects command.

Description 

 _InspectObjects();

This function opens the Inspect Object dialog window which inspects the objects according to two selected features.

_MeasureObjectsND

Description 

 _MeasureObjectsND();

This function performs the object measurement on an ND document. The Measure Objects window is displayed.

_ObjectData

Description 

 _ObjectData();

This function displays the Automated Measurement Results dialog box.

See Also 
ScanObjects, ResetObjectFeatures, SelectObjectFeature, Restrictions, DataDelimiter, ChangeObjective

_ObjectMeasSetup

This function runs the Measure > Object Features command.

Description 

 _ObjectMeasSetup();

The function displays the Object Measurement Setup dialog box.

See Also 
ResetObjectFeatures, SelectObjectFeature

_Restrictions

Description 

 _Restrictions();

This function displays the Measurement Restrictions dialog box.

See Also 
Restrictions

_ScanObjects

Description 

 _ScanObjects();

This function equals the ScanObjects function except when performed on ND2 document you will be prompt to select whether to process the current image, selected dimension, or the whole ND document.

See Also 
ScanObjects

Copyright 1991-2024 Laboratory Imaging s.r.o.