Add line

Draws an overlay line between two specified points.

Description

Draws an overlay line between two specified points.

Note: This currently only works in 2D.

Parameters

Parameter	Description
Colour mode	Method for assigning colour of each object: "Child count" Colour is determined by the number of children each object has. Colour range runs across the first half of the visible spectrum (i.e. red to cyan) and is maximised, so the object with the fewest children is shown in red and the object with the most, in cyan. Objects without any children are always shown in red. Child objects used for counting are selected with the "Child objects for colour" parameter. "ID" Colour is quasi-randomly selected based on the ID number of the object. The colour used for a specific ID number will always be the same and is calculated using the equation hue = (ID 1048576 % 255) / 255. "Measurement value" Colour is determined by a measurement value. Colour range runs across the first half of the visible spectrum (i.e. red to cyan) and is maximised, so the object with the smallest measurement is shown in red and the object with the largest, in cyan. Objects missing the relevant measurement are always shown in red. The measurement value is selected with the "Measurement for colour" parameter. "Parent ID" Colour is quasi-randomly selected based on the ID number of a parent of this object. The colour used for a specific ID number will always be the same and is calculated using the equation hue = (ID * 1048576 % 255) / 255*. The parent object is selected with the "Parent object for colour" parameter. "Parent measurement value" Colour is determined by a measurement value of a parent of this object. Colour range runs across the first half of the visible spectrum (i.e. red to cyan) and is maximised, so the object with the smallest measurement is shown in red and the object with the largest, in cyan. Objects either missing the relevant measurement or without the relevant parent are always shown in red. The parent object is selected with the "Parent object for colour" parameter and the measurement value is selected with the "Measurement for colour" parameter. "Partner count" Colour is determined by the number of partners each object has. Colour range runs across the first half of the visible spectrum (i.e. red to cyan) and is maximised, so the object with the fewest partners is shown in red and the object with the most, in cyan. Objects without any partners are always shown in red. Partner objects used for counting are selected with the "Partner objects for colour" parameter. "Random colour" Colour is randomly selected for each object. Unlike the "ID" option, the colours generated here will be different for each evaluation of the module. "Single colour" (default option) Colour is fixed to one of a predetermined list of colours. All objects will be assigned the same overlay colour. The colour is chosen using the "Single colour" parameter.
Colour map	Colourmap used for colour gradients. This parameter is used if "Colour mode" is set to any mode which yields a range of colours (e.g. measurements or IDs). Choices are: Black fire, Ice, Jet, Physics, Random, Random (vibrant), Spectrum, Thermal.
Single colour	Colour for all object overlays to be rendered using. This parameter is used if "Colour mode" is set to "Single colour". Choices are: White, Black, Red, Orange, Yellow, Green, Cyan, Blue, Violet, Magenta.
Child objects for colour	Object collection used to determine the colour based on number of children per object when "Colour mode" is set to "Child count". These objects will be children of the input objects.
Measurement for colour	Measurement used to determine the colour when "Colour mode" is set to either "Measurement value" or "Parent measurement value".
Parent object for colour	Object collection used to determine the colour based on either the ID or measurement value of a parent object when "Colour mode" is set to either "Parent ID" or "Parent measurement value". These objects will be parents of the input objects.
Partner objects for colour	Object collection used to determine the colour based on number of partners per object when "Colour mode" is set to "Partner count". These objects will be partners of the input objects.
Opacity (%)	Opacity of the overlay to be rendered. This is a value between 0 (totally transparent) and 100 (totally opaque).
Range minimum mode	Controls whether the minimum range for displayed colours is set automatically to the minimum available value (e.g. the smallest measurement being rendered), or whether it is defined manually by the "Minimum value" parameter.
Minimum value	When "Range minimum mode" is set to "Manual", this is the minimum value that will be displayed as a unique colour. All values smaller than this will be displayed with the same colour.
Range maximum mode	Controls whether the maximum range for displayed colours is set automatically to the maximum available value (e.g. the largest measurement being rendered), or whether it is defined manually by the "Maximum value" parameter.
Maximum value	When "Range maximum mode" is set to "Manual", this is the maximum value that will be displayed as a unique colour. All values larger than this will be displayed with the same colour.
Input image	Image onto which overlay will be rendered. Input image will only be updated if "Apply to input image" is enabled, otherwise the image containing the overlay will be stored as a new image with name specified by "Output image".
Input objects	Objects to represent as overlays.
Apply to input image	Determines if the modifications made to the input image (added overlay elements) will be applied to that image or directed to a new image. When selected, the input image will be updated.
Add output image to workspace	If the modifications (overlay) aren't being applied directly to the input image, this control will determine if a separate image containing the overlay should be saved to the workspace.
Output image	The name of the new image to be saved to the workspace (if not applying the changes directly to the input image).
Reference mode 1	Controls for the location of the first end of the line to be drawn: - "Object centroid" This end of the line is coincident with the centre of the input object. - "Image measurement" This end of the line is coincident with a pair of XY measurements taken from an image. The image to be used is selected with the "Reference image 1" parameter and the measurements by the "X-pos. image meas. 1 (px)" and "Y-pos. image meas. 1 (px)" parameters. - "Object measurement" This end of the line is coincident with a pair of XY measurements taken from the current object. The measurements are selected with the "X-pos. object meas. 1 (px)" and "Y-pos. object meas. 1 (px)" parameters.
Reference image 1	Image providing the XY coordinate measurements to be used as the location of the first end of the line.
X-pos. image meas. 1 (px)	Measurement used as X-coordinate for the first end of the line. This measurement will be taken from the image specified by "Reference image 1" when "Reference mode 1" is set to "Image measurement". The coordinate value is specified in pixel units.
Y-pos. image meas. 1 (px)	Measurement used as Y-coordinate for the first end of the line. This measurement will be taken from the image specified by "Reference image 1" when "Reference mode 1" is set to "Image measurement". The coordinate value is specified in pixel units.
X-pos. object meas. 1 (px)	Measurement used as X-coordinate for the first end of the line. This measurement will be taken from the current object. The coordinate value is specified in pixel units.
Y-pos. object meas. 1 (px)	Measurement used as Y-coordinate for the first end of the line. This measurement will be taken from the current object. The coordinate value is specified in pixel units.
Reference mode 2	Controls for the location of the second end of the line to be drawn: - "Object centroid" This end of the line is coincident with the centre of the input object. - "Image measurement" This end of the line is coincident with a pair of XY measurements taken from an image. The image to be used is selected with the "Reference image 2" parameter and the measurements by the "X-pos. image meas. 2 (px)" and "Y-pos. image meas. 2 (px)" parameters. - "Object measurement" This end of the line is coincident with a pair of XY measurements taken from the current object. The measurements are selected with the "X-pos. object meas. 2 (px)" and "Y-pos. object meas. 2 (px)" parameters.
Reference image 2	Image providing the XY coordinate measurements to be used as the location of the second end of the line.
X-pos. image meas. 2 (px)	Measurement used as X-coordinate for the second end of the line. This measurement will be taken from the image specified by "Reference image 2" when "Reference mode 2" is set to "Image measurement". The coordinate value is specified in pixel units.
Y-pos. image meas. 2 (px)	Measurement used as Y-coordinate for the second end of the line. This measurement will be taken from the image specified by "Reference image 2" when "Reference mode 2" is set to "Image measurement". The coordinate value is specified in pixel units.
X-pos. object meas. 2 (px)	Measurement used as X-coordinate for the second end of the line. This measurement will be taken from the current object. The coordinate value is specified in pixel units.
Y-pos. object meas. 2 (px)	Measurement used as Y-coordinate for the second end of the line. This measurement will be taken from the current object. The coordinate value is specified in pixel units.
Line width	Width of the rendered lines. Specified in pixel units.
Enable multithreading	Process multiple overlay elements simultaneously. This can provide a speed improvement when working on a computer with a multi-core CPU.