[ Previous | Next | Contents | Glossary | Home | Search ]
The graPHIGS Programming Interface: ISO PHIGS Subroutine Reference

TEXT (PHOP,*,STOP,*)

Purpose

Use Text to insert a two-dimensional, geometric text element into the open structure following the element pointer or replace the element pointed at by the element pointer with a Text structure element, depending on the current edit mode.

This structure element specifies a string of geometric text that the graPHIGS API draws at the specified location in the x, y plane.

The graPHIGS API treats control characters in a character string as undefined characters and displays the default for the character set. This default for the character set is the default character in the graPHIGS API character set file. For U.S. English, this is the hyphen character (EBCDIC X'60', ASCII X'2D').

Language Bindings

C

ptext (text_pos, char_string)

Input Parameters

const Ppoint *text_pos
Text position in MC.

const char *char_string
Character string.

FORTRAN

PTX (px, py, chars)

Input Parameters

real px
x coordinate of text position in MC.

real py
y coordinate of text position in MC.

character*(*) chars
Text to be displayed.

FORTRAN Subset

PTXS (px, py, lstr, chars)

Input Parameters

real px
x coordinate of text position in MC.

real py
y coordinate of text position in MC.

integer lstr
Length of text string in bytes (>=0).

character*80 chars
Text to be displayed.

Errors

5
Function Requires State (PHOP,*,STOP,*)

Related Subroutines

  • Inquire Text Facilities

  • Set Character Expansion Factor

  • Set Character Height

  • Set Character Spacing

  • Set Character Up Vector

  • Set Text Alignment

  • Set Text Color Index

  • Set Text Font

  • Set Text Index

  • Set Text Path

  • Set Text Precision

    • [ Previous | Next | Contents | Glossary | Home | Search ]