# PlotString

Plots a text string on the image.

Note: After inserting the PlotString function Functions are tools that are available in Spreadsheet for processing and analyzing acquisitions or other results. You can add functions to your Spreadsheet job to create tool chains and produce results for specific applications. into the spreadsheet, right-click on the spreadsheet cell of the function and select Format and then Cells to open the Format Cells dialog. Use the Graphics tab of the Format Cells dialog to format the Font and Font Size of the plotted text string. This is independent from the Font setting of the spreadsheet cell itself, which only affects the appearance of the cell in the Spreadsheet Editor.
Inputs

The PlotString function has the following syntax:

PlotString(Image, String, X, Y, Color, FontSize, Font, Show)

See the table for a description of the available parameters:

Parameter | Description
Image | Reference to a cell containing an Image structure. Default = $A$0.
String | Specifies the text string to be plotted.
Point | Specifies the image coordinates of the string to be plotted.
X | The X coordinate of the string.
Y | The Y coordinate of the string.
Color | Specifies the color of the plotted graphic. Default: 0x32CD32, LimeGreen; max: 0xFFFFFF. Configure different colors by providing the hexadecimal color code in the formula bar or selecting a color from the color picker on the tool property sheet.
Font Size | Specifies the font size of the cell graphic.
Font | Specifies the font of the cell graphic. The list of available fonts depends upon the fonts loaded on the host PC. If a job A job is a user-configured program in In-Sight Spreadsheet consisting of functions and designed for specific applications. You can create and edit jobs using the In-Sight Spreadsheet interface, and load them on a vision system for deployment in a live environment. is loaded onto a PC that does not have that font, the default font of that PC is used instead.
Show | Specifies the display mode for the graphic overlay on the image.
0 = OFF | The graphic is hidden, except when the cell containing the function is highlighted in the spreadsheet.
1 = ON (default) | The graphic is displayed at all times.

Outputs

Returns | A Plot data structure containing the graphic.