Create Region of Interest Controls

NI Vision Builder

Process Images Tab

Create Region of Interest Controls

Main Tab

The following controls are available on the Main tab.

Control Name Description
Step Name Name to give the step.
Reposition Region of Interest When enabled, the step dynamically repositions the region of interest based on a coordinate system you built in a previous step.
Reference Coordinate System Coordinate system to which you want to link the region of interest.

Coordinates Tab

The following controls are available on the Coordinates tab.

Control Name Description
ROI Type Type of region of interest (ROI) to create. The following options are available:
  • Line—Creates a Line ROI.
  • Rectangle (Top/Left)—Creates a rectangular ROI defined by the coordinates of the top-left and bottom-right corners of the rectangle.
  • Rectangle (Center)—Creates a rectangular ROI defined by the coordinates of the center point, width, and height of the rectangle.
  • Rotated Rectangle—Creates a Rectangle (Center) ROI rotated by a specified angle.
  • Annulus—Creates an annulus ROI.
  • Oval—Creates an oval ROI.
ROI Parameters Use these controls to specify values, or measurements from previous steps, that define the ROI specified in ROI Type. The available parameters will vary depending on the ROI Type selected. The following are the parameters available for each ROI Type:
Tip  To use the measurement from a previous step or the value of a variable as the value for an ROI parameter, select the measurement or variable from the drop-down list of the parameter you want to specify. These values are not changed by repositioning the ROI.

Point

  • X—The x-coordinate of the point.
  • Y—The y-coordinate of the point.

Line

  • Start X—The x-coordinate of the starting point.
  • Start Y—The y-coordinate of the starting point.
  • End X—The x-coordinate of the ending point.
  • End Y—The y-coordinate of the ending point.

Rectangle (Top/Left)

  • Left—The x-coordinate for the left side of the rectangle.
  • Top—The y-coordinate for the top of the rectangle.
  • Right—The x-coordinate for the right side of the rectangle.
  • Bottom—The y-coordinate for the bottom of the rectangle.

Rectangle (Center)

  • Center X—The x-coordinate of the center of the rectangle.
  • Center Y—The y-coordinate of the center of the rectangle.
  • Width—The width of the rectangle.
  • Height—The height of the rectangle.

Rotated Rectangle

  • Center X—The x-coordinate of the center of the rectangle.
  • Center Y—The y-coordinate of the center of the rectangle.
  • Width—The width of the rectangle.
  • Height—The height of the rectangle.
  • Angle—The rotation angle in degrees of the rectangle. The center of the rectangle is the point of rotation.

Annulus

  • Center X—The x-coordinate of the center of the circle or annulus.
  • Center Y—The y-coordinate of the center of the circle or annulus.
  • Inner Radius—The radius in pixels of the inner circle defining one edge of the circular strip.
  • Outer Radius—The radius in pixels of the outer circle defining the second edge of the circular strip.
  • Start Angle—The first angle of the circular strip. The angle is measured counter-clockwise from the x-axis of a coordinate system centered on the circle or annulus.
  • End Angle—The second angle of the circular strip. The angle is measured counter-clockwise from the x-axis of a coordinate system centered on the circle or annulus.

Oval

  • Center X—The x-coordinate of the center of the circle or annulus.
  • Center Y—The y-coordinate of the center of the circle or annulus.
  • Width—The width of the oval.
  • Height—The height of the oval.