.ig >>
<STYLE TYPE="text/css">
<!--
        A:link{text-decoration:none}
        A:visited{text-decoration:none}
        A:active{text-decoration:none}
-->
</STYLE>
<title>ploticus: textdetails attribute type</title>
<body bgcolor=D0D0EE vlink=0000FF>
<br>
<br>
<center>
<table cellpadding=2 bgcolor=FFFFFF width=550 ><tr>
<td>
  <table cellpadding=2 width=550><tr>
  <td><br><h2>textdetails attribute type</h2></td>
  <td align=right>
  <small>
  <a href="../doc/Welcome.html"><img src="../doc/ploticus.gif" border=0></a><br>
  <a href="../doc/Welcome.html">Welcome</a> &nbsp; &nbsp;
  <a href="../gallery/index.html">Gallery</a> &nbsp; &nbsp;
  <a href="../doc/Contents.html">Handbook</a> 
  <td></tr></table>
</td></tr>
<td>
<br>
<br>
.>>

.TH textdetails_attribute_type PL "12-JUL-2001   PL www.sgpr.net"

.ig >>
<center>
<a href="../gallery/text.htm">
.>>
text 
.ig >>
<br><img src="../gallery/text.gif">
</a>
</center>
.>>

.SH DESCRIPTION
.IP
A \fBtextdetails\fR attribute
controls details 
regarding the presentation of some text, including the size, style, alignment,
and color.  
These details have defaults that will often be satisfactory; text details
specifications may be used when it is desired to override the defaults.
Virtually every text attribute in the ploticus system 
has an accompanying textdetails attribute.
.IP
Text capabilities vary depending on the output format.  See
.ig >>
<a href="../doc/fonts.html">
.>>
fonts
.ig >>
</a>
.>>
for more information.

.IP
A \fBtextdetails\fR specification occupies one line in a script file
and contains one or more sub-attribute settings.
A sub-attribute setting has the form \fIsubattribute\fB=\fIvalue\fR
with no embedded spaces.
Multiple sub-attribute settings on the line are separated by white-space.

.SH SUB-ATTRIBUTES
.LP
\fBsize\fR=\fIp\fR  
integer point size of the text.  10 point is standard.
A point is 1/72th of an inch.

.LP
\fBstyle\fR=\fIs\fR 
.IP
style font variant.  \fIs\fR may be either
\fCB\fR for bold, \fCI\fR for italic, \fCBI\fR for bold-italic, 
or \fCR\fR for regular.  
This has an effect only when rendering in PostScript, and cannot be combined with
the \fBfont=\fR subattribute.

.LP
\fBfont\fR=\fIpostscriptfontname\fR
.IP
use the font \fIpostscriptfontname\fR.
This has an effect only with PostScript or 
PNG/JPEG/WBMP with FreeType2 enabled.   It cannot 
be combined with the \fBstyle=\fR subattribute.  New in version 1.40.  See
.ig >>
<a href="../doc/fonts.html">
.>>
fonts
.ig >>
</a>
.>>
for more info.

.LP
\fBalign\fR=\fIa\fR  
.IP
alignment or justification.  \fIa\fR may be either
\fCL\fR for left, \fCC\fR for centered, \fCR\fR for right justified.

.LP
\fBadjust\fR=\fIx,y\fR  
.IP
vector adjustment in 
.ig >>
<a href="attributetypes.html#positionunits">
.>>
absolute units
.ig >>
</a>
.>>
to default position.

.LP
\fBcolor\fR=
.ig >>
<a href="color.html">
.>>
\fI color \fR
.ig >>
</a>
.>>

.SH EXAMPLE
Here's an example of a textdetails attribute:
.ft C
.nf
Titledetails: size=12 color=blue style=BI adjust=0,0.2
.fi

.ig >>
<br>
<br>
</td></tr>
<td align=right>
<a href="Welcome.html">
<img src="../doc/ploticus.gif" border=0></a><br><small>data display engine &nbsp; <br>
<a href="../doc/Copyright.html">Copyright Steve Grubb</a>
<br>
<br>
<center>
<img src="../gallery/all.gif">
</center>
</td></tr>
</table>
.>>
