Draws a string into a picture.

This VI automatically calculates the bounding rectangle of the text and positions the text with respect to the point you specify.


icon

Inputs/Outputs

  • ccclst.png [user-specified font] —

    [user-specified font] specifies the specific font characteristics for the text to draw.

    The VI ignores this input unless desired font is User-specified Font.

  • cstr.png Font Name: —

    Font Name specifies the font to use for the text.

    If you misspell the font name or specify a font that is not installed on the computer, the operating system selects a font.

  • ci16.png Size —

    Size specifies the size of the font in points.

  • cbool.png Strikeout? —

    Strikeout? specifies if the text appears in strikeout. If Strikeout? is TRUE, the text appears in strikeout.

  • cbool.png Italic? —

    Italic? specifies if the text appears in italics. If Italic? is TRUE, the text appears in italics.

  • cbool.png Underline? —

    Underline? specifies if the text is underlined. If Underline? is TRUE, the text appears underlined.

  • cbool.png Outline? —

    Outline? specifies if the text is outlined. If Outline? is TRUE, the text appears outlined.

  • cbool.png Shadow? —

    Shadow? specifies if the text has a shadow. If Shadow? is TRUE, the text appears in shadow.

  • cbool.png Bold? —

    Bold? specifies if the text is bold. If Bold? is TRUE, the text appears bold.

  • cenum.png desired font(Application) —

    desired font specifies the text font.

    0
    User-specified Font
    1
    Application Font
    (default)
    2
    System Font
    3
    Dialog Font
  • cpict.png picture —

    picture is the picture to which you want to add the text string. The default is an empty picture.

  • cnclst.png origin —

    origin is the coordinate of the starting point of the text.

  • ci16.png x —

    x is the horizontal coordinate that increases to the right.

  • ci16.png y —

    y is the vertical coordinate that increases to the bottom.

  • cnclst.png alignment(left, top) —

    alignment specifies the location of the text relative to the origin you specify.

  • cenum.png horizontal —

    horizontal sets the horizontal position of the text with respect to the origin.

    0left—The horizontal component of origin specifies the left edge of the text.
    1center—The horizontal component of the origin specifies the center of the text.
    2right—The horizontal component of origin specifies the right of the text.
  • cenum.png vertical —

    vertical sets the vertical position of the text with respect to the origin.

    0top—The vertical component of origin specifies the top edge of the text.
    1center—The vertical component of the origin specifies the center of the text.
    2bottom—The vertical component of origin specifies the bottom of the text.
  • cstr.png text —

    text is the string to draw in the picture.

  • cu32.png text color(black) —

    text color is the color of the text. The default is black.

    You can wire a color box constant to this input.

  • cu32.png BG color(transparent) —

    BG color is the color of the background of the text.

    The default is transparent.

    You can wire a color box constant to this input.

  • cenum.png text orientation —

    text orientation sets the orientation of the text to draw.

    0None (default)—Text appears normal.
    1Stacked—Text appears stacked.
    2Clockwise—Text appears rotated 90° clockwise, which results in vertical text that reads downward.
    3Counterclockwise—Text appears rotated 90° counterclockwise, which results in vertical text that reads upward.
  • ipict.png new picture —

    new picture is the picture that contains the new image. You can wire this output to any other picture input to add more drawing instructions to the picture.

    You also can wire this output to the Picture to Pixmap VI to obtain an image data cluster. You then can use the Graphics Formats VIs to save the image data to a file. You can wire this output to the Concatenate Strings function to concatenate the output from multiple Picture Functions VIs so that they draw on a single picture control.

  • inclst.png text rect —

    text rect is a cluster that contains coordinates that describe the left, top, right, and bottom coordinates of the outer edges of the rectangle.

  • ii16.png left —

    left is the horizontal coordinate of the left edge of the rectangle.

  • ii16.png top —

    top is the vertical coordinate of the top edge of the rectangle.

  • ii16.png right —

    right is the horizontal coordinate of the right edge of the rectangle.

  • ii16.png bottom —

    bottom is the vertical coordinate of the bottom edge of the rectangle.