Get Rectangle Properties

Use this tool to get properties of one or more rectangles.

Parameters

Basic Parameters

Image:

This parameter represents the input image containing the rectangular ROI.

Rectangle:

This parameter defines the rectangular region(s) of interest (ROIs) for the processing. By default no ROI is defined. To define the rectangles to be checked, you either have to connect the parameter to an appropriate ROI result of a previous tool or you have to draw new ROIs into the image using the available ROI buttons.

Results

Basic Results

X Center:

This result contains the position of the center of the rectangle in x-direction. The result is returned in pixels.. If more than one rectangle was processed via the parameter "Rectangle", a tuple of values is returned.

Y Center:

This result contains the position of the center of the rectangle in y-direction. The result is returned in pixels.. If more than one rectangle was processed via the parameter "Rectangle", a tuple of values is returned.

Major Length:

This result contains the width of the rectangle in pixels. If more than one rectangle was processed via the parameter "Rectangle", a tuple of values is returned.

Minor Length:

This result contains the height of the rectangle in pixels. If more than one rectangle was processed via the parameter "Rectangle", a tuple of values is returned.

Orientation:

This result returns the information how far and in which direction the "Rectangle" is rotated in form of an angle in degrees. Positive values indicate a clockwise rotation, negative values indicate a counterclockwise rotation. If more than one rectangle was processed via the parameter "Rectangle", a tuple of values is returned.

Area:

This result contains the area of the rectangle in pixels. If more than one rectangle was processed via the parameter "Rectangle", a tuple of values is returned.

Tool State:

"Tool State" returns information about the state of the tool and thus can be used for error handling. For more information, see Tool State Result

Additional Results

Front Segment:

This result contains the ROI of the front segment of the rectangle. If more than one rectangle was processed via the parameter "Rectangle", the ROIs of all front segments are returned.

Back Segment:

This result contains the ROI of the back segment of the rectangle. If more than one rectangle was processed via the parameter "Rectangle", the ROIs of all back segments are returned.

Processing Time:

This result returns the duration of the most recent execution of the tool in milliseconds. The result is provided as additional result. Therefore, it is hidden by default but it can be displayed via the button beside the tool results. For more information see the section Processing Time in the tool reference overview.