ROI to Mask (G Dataflow)

Template for the destination image where the mask is placed.

This can be any image type that NI Vision supports. Image takes the characteristics of Image Model (size and location of ROI) when Image Model is connected. However, the connection of Image Model is optional. When no Image Model is connected, the size of the image mask generated is limited to the bounding rectangle of the ROI Descriptor.gtype, which reduces the amount of memory used. The offset of the image mask generated is set to reflect the real position of the ROI.

Reference to the destination image in which the mask is created.

Descriptor that defines the region of interest.

global rectangle

Minimum rectangle required to contain all of the contours in the ROI.

Contours

Each of the individual shapes that define the ROI.

ID

Contour that is the external or internal edge of an ROI.

If the contour is external, all of the area inside it is considered part of the ROI. This node draws the contours in the order that they are listed in the ROI Descriptor.gtype.

Internal contours do not become part of the mask. You can use internal contours to create non-mask regions inside external contours.

Type

Shape type of the contour.

Coordinates

Coordinates that define the contour.

Pixel value of the mask.

All pixels inside the region of interest take this value.

Default: 255

Error conditions that occur before this node runs.

The node responds to this input according to standard error behavior.

Standard Error Behavior

Many nodes provide an error in input and an error out output so that the node can respond to and communicate errors that occur while code is running. The value of error in specifies whether an error occurred before the node runs. Most nodes respond to values of error in in a standard, predictable way.

error in does not contain an error	error in contains an error
If no error occurred before the node runs, the node begins execution normally. If no error occurs while the node runs, it returns no error. If an error does occur while the node runs, it returns that error information as error out.	If an error occurred before the node runs, the node does not execute. Instead, it returns the error in value as error out.

Default: No error

Pixel value of the background.

Default: 0

Reference to image in.

ROI data found outside the space associated with the Image Model.

Error information.

The node produces this output according to standard error behavior.

Standard Error Behavior

Many nodes provide an error in input and an error out output so that the node can respond to and communicate errors that occur while code is running. The value of error in specifies whether an error occurred before the node runs. Most nodes respond to values of error in in a standard, predictable way.

error in does not contain an error	error in contains an error
If no error occurred before the node runs, the node begins execution normally. If no error occurs while the node runs, it returns no error. If an error does occur while the node runs, it returns that error information as error out.	If an error occurred before the node runs, the node does not execute. Instead, it returns the error in value as error out.