IBM Visualization Data Explorer User's Reference

[ Bottom of Page | Previous Page | Next Page | Table of Contents | Partial Table of Contents | Index ]

Text

Category

Annotation

Function

Displays text.

Syntax


text = Text(string, position, height, font, direction, up);

Inputs
Name Type Default Description
string string or field none text to be displayed
position vector [0 0 0] placement of displayed text
height scalar 1 height of the text (in world coordinates)
font string "variable" text font
direction vector [1 0 0] orientation of the baseline
up vector perpendicular to baseline orientation of vertical strokes of text font

Outputs
Name Type Description
text color field renderable string object

Functional Details

This module produces text that is displayed in space.

string

specifies the text to be displayed. If the parameter value is a string, that string is displayed. If the parameter value is a field, its "data" component must be TYPE_STRING. The data may be position or connection dependent:

  • position dependent: each string in the "data" component is displayed at its corresponding position.
  • connection dependent: each string is displayed at the center of its corresponding connection element.

position

specifies in world units the placement of the displayed text. It is used only when string is not a field.

height

specifies the height of the text, in world units.

font

specifies the font used for displayed text. You can specify any of the defined fonts supplied with Data Explorer. These include a variable-width font ("variable," the default) and a fixed-width font ("fixed"):

area          gothicit_t       pitman                roman_ext
cyril_d       greek_d          roman_d               script_d
fixed         greek_s          roman_dser            script_s
gothiceng_t   italic_d         roman_s               variable
gothicger_t   italic_t         roman_tser
For more information, see Appendix E. "Data Explorer Fonts" in IBM Visualization Data Explorer User's Guide.

direction

specifies the orientation of the baseline (see Note in next description). For example, a value of 10 for this parameter specifies that the text is aligned with the x-axis.

up

specifies the orientation of the vertical strokes of the font used for the displayed text.

Note: For string data in a field, the orientation of baseline and text can specified by using "tangents" and "binormals" components. In that way, each string can be oriented individually. These components should have the same dependency as "data" The "tangents" component corresponds to direction and "binormals" to up.

The parameter specifications will override those of the field components.

Components

Creates new "positions," "connections," and "colors" components.

Example Visual Program

UsingTextAndTextGlyphs.net

See Also

 Caption,  Color,  Format


[ Top of Page | Previous Page | Next Page | Table of Contents | Partial Table of Contents | Index ]
[Data Explorer Documentation | QuickStart Guide | User's Guide | User's Reference | Programmer's Reference | Installation and Configuration Guide ]

[Data Explorer Home Page | Contact Data Explorer | Same document on Data Explorer Home Page ]


[IBM Home Page | Order | Search | Contact IBM | Legal ]