.\"##
.\" $XConsortium: p378,v 5.2 94/04/17 20:58:52 rws Exp $
.\"##
.\"## 
$XMCOPY
.\"## Copyright (c) 1990, 1991 by Sun Microsystems, Inc. 
.\"## 
.\"##                         All Rights Reserved
.\"## 
.\"## Permission to use, copy, modify, and distribute this software and its 
.\"## documentation for any purpose and without fee is hereby granted, 
.\"## provided that the above copyright notice appear in all copies and that
.\"## both that copyright notice and this permission notice appear in 
.\"## supporting documentation, and that the name of Sun Microsystems,
.\"## not be used in advertising or publicity 
.\"## pertaining to distribution of the software without specific, written 
.\"## prior permission.  
.\"## 
.\"## SUN MICROSYSTEMS DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, 
.\"## INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO
.\"## EVENT SHALL SUN MICROSYSTEMS BE LIABLE FOR ANY SPECIAL, INDIRECT OR
.\"## CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF
.\"## USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
.\"## OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
.\"## PERFORMANCE OF THIS SOFTWARE.
.TH "SET TEXT FONT" 3P "29 February 1991"
.SH NAME
SET TEXT FONT \- create a structure element to set the current text font attribute
.IX "Aspect Source Flags" "SET TEXT FONT"
.IX "Text Attributes" "SET TEXT FONT"
.IX "Attributes, Text Attributes" "SET TEXT FONT"
.IX "Fonts" "SET TEXT FONT"
.SH SYNOPSIS
.SS C Syntax
.ft B
.ta 1.25i 3i
.nf
void
pset_text_font ( font )
Pint	font;	\fItext font\fP
.fi
.ft R
.SS Required PHIGS Operating States
(PHOP, *, STOP, *)
.SH DESCRIPTION
.SS Purpose
\s-2SET TEXT FONT\s+2 creates a structure element
containing a value for the current text font attribute,
which selects a font from those available on the workstation.  
.LP
When the \fItext font\fP \s-1ASF\s0 is set to \s-2INDIVIDUAL\s+2, 
this attribute applies to the output primitives:
.RS
.LP
\(bu
.SM TEXT
.LP
\(bu
.SM "TEXT 3"
.LP
\(bu
.SM "ANNOTATION TEXT RELATIVE"
.LP
\(bu
.SM "ANNOTATION TEXT RELATIVE 3"
.RE
.LP
If the current edit mode is \s-2INSERT\s+2,  
a \s-2SET TEXT FONT\s+2 element is inserted in the currently open
structure after the element pointed to by the current element pointer.  If
the edit mode is \s-2REPLACE\s+2, the new \s-2SET TEXT FONT\s+2 element
replaces the element pointed to by the element pointer.  In either case, the
element pointer is updated to point to the new element.  
.SS C Input Parameters
.IP \fIfont\fP
The \fItext font\fP, specified as an index to the workstation's non-writable
table of available fonts.  
.IP
All the font indices have named constants defined in phigs.h,
as shown below.
.IP
The fonts available for \s-2PCS_ASCII\s+2 are:
.ta .5i +\w'PFONT_G_GREEK_COMPLEX         'uC
.nf
	Constant	Value
.sp .3
	PFONT_MONO	1
.\" begin stuff retained for KANJI version
.\" The fonts available for \s-2PCS_KANJI\s+2 are:
.\" .sp .2
.\" .ta .5i +\w'PFONT_G_GREEK_COMPLEX         'uC
.\" .nf
.\" 	PFONT_KANJI_MONO	1
.\" .fi
.\" end stuff retained for KANJI version
.SS Execution
When the \s-2SET TEXT FONT\s+2 element is traversed, the current
text font entry in the traversal state list is set to
\fItext font\fP.  When the current text font \s-2ASF\s+2 (Aspect Source Flag)
is set to \s-2INDIVIDUAL\s+2, the \fItext font\fP is applied to text strings in
output primitives that follow in the structure network.
.LP
The text font attribute selects a font from those available on the workstation.
The default \fItext font\fP is 1;  
the default \fItext precision\fP is String Precision.
The default is used when the font selected is
not available in the precision selected on the workstation.  
.LP
When the text font \s-2ASF\s+2 is set to \s-2BUNDLED\s+2,
the text font is taken from the
workstation's representation indicated by the \fIcurrent text index\fP.  
In this case, the font set with \s-2SET TEXT FONT\s+2 has no effect.  
.SH ERRORS
.IP 005
Ignoring function, function requires state (\s-2PHOP\s+2, \s-2*\s+2, 
\s-2STOP\s+2, \s-2*\s+2)
.SH SEE ALSO
.nf
.IP
.ta 0.5i
.SM "SET TEXT PRECISION (3P)"
.SM "SET INDIVIDUAL ASF (3P)"
.SM "SET TEXT REPRESENTATION (3P)"
.SM "INQUIRE TEXT FACILITIES (3P)"
.SM "SET TEXT REPRESENTATION PLUS (3P+)"
.fi
