#set TITLE = "textdetails attribute type"
#include top

.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

#include bottom
