Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Wiki Markup
{alias:tx2}
h2. Name

*tx2* — 2D text and legend display

h2. Command contents

[#Display 2D text on the screen] - *tx2* 
[#Display 2D legend and text] - *tx2 legend*

{anchor:tx2}
{anchor:Display 2D text on the screen}
h2. Name

*tx2* — 2D text

h2. Syntax
{panel:|borderStyle=solid|borderWidth=1|bgColor=#FFFFAA}

*tx2* \[_textsize_] \[*lle | lri | ule | uri | cur | ref | min*] | \[*coor* \[*screen*\] \] \[*nob*] \[*poi*] \[*col*] \[*fol*] \[*use*] \[*let*] \[*txt*] _text_

{panel}

h2. Description

Display a 2D text on the screen. This text is unaffected by rotation, pan and zoom, but will be affetced by window resizing. 

h2. Arguments

_textsize_ 
{indent}Will display the text using text size relative to 1.{indent} 
*lle | lri | ule | uri txt* _text_ 
{indent}Will display text in lower left | lower right | upper left | upper right corner of the screen.{indent} 
*cur | ref | min txt* _text_ 
{indent}Will display text at cursor position | reference point | lower left of grid window. The reference point is set by the [ref] command.{indent} 
*let* _text_ 
{indent}Display the text as individual letters at the points of the active datasets.{indent} 
*nob* 
{indent}No bold numbers.{indent} 
*nsh* 
{indent}No shadow on numbers.{indent} 
*ita* 
{indent}Italic numbers.{indent} 
*fam 1 | 2 | ... | 9*
{indent}Use font family 1 / 2 / 3 /.../9{indent}
*coor* _xcoor ycoor | xcoor ycoor zcoor_ 
{indent}Position in world coordinates _xcoor ycoor_ for fixed x y placement (not using the *fol* argument) or _xcoor ycoor zcoor_ for using the *fol* argument.{indent} 
*screen* _xpix ypix_ 
{indent}Position from lower left corner in pixel positions _xpix ypix_.{indent} 
*col whi | red | gre | ...* 
{indent}Select color for display.{indent} 
*col* _r g b_ 
{indent}Select color for display using _r g b_ values.{indent} 
*use* 
{indent}Use the current color.{indent} 
*fol* 
{indent}Use the follower for the text to follow the camera. In that case the command must know the x y and z coordinates to place the text. This is achieved with arguments *cur* or *coor* or *poi*.{indent} 
*poi* _pointnumber_ 
{indent}Display the text in the poisition of point _pointnumber_ of active data. Points are counted from 1.{indent} 
*txt* _text_ 
{indent}To display a text, put it in braces or double quotes if the text contains spaces.{indent} 

h2. Related command object
h3. Text presenter 

The main command object for generating 2D text which also utilizes the tx2 command. 

h2. Examples

h3. Ex.1: Two dimensional text

{noformat:|borderWidth=1|bgColor=#eeeeee}
z                                                    ;# Erase screen
win demo                                             ;# Get demo window (450000 460000 6450000 6460000 1000 4000)
spe bgc whi                                          ;# Specify background color to white
tx2 1.5 lle col bla txt "Text examples"              ;# Lower left
tx2 screen 20 40 txt "Screen coordinates"            ;# Using screen coordinates
tx2 1.2 coor 447000 6455000 txt "World coordinates"  ;# Using world coordinates
tx2 1.5 cur txt "Cursor position"                    ;# At cursor position
{noformat}
The above example produces this image.

!att:_img_ref^cmd_tx2.png!
_Text examples_

h2. See also

[txt - 3D text], [axe - Axes display]

{anchor:tx2 legend}
{anchor:Display 2D legend and text}
h2. Name

*tx2 legend* — 2D legend and text

h2. Syntax
{panel:|borderStyle=solid|borderWidth=1|bgColor=#FFFFAA}

*tx2* \[_textsize_] \[ *box*_boxsize_] \[*nfr | onlytxt | lef | cur | coor* \[*screen*\] \] [*space | xwid | ywid | xad | yad*] \[*coor* \[*screen*\] \] \[*col*] \[*tcol*] \[*txt*] _text_

{panel}


{pagebreak}