putpdf paragraph — Add text or images to a PDF file 3
fspec is
fontname
, size
, color
fontname may be any supported font installed on the user’s computer. Base 14 fonts, Type 1
fonts (.pfa or .pfb), TrueType fonts (.ttf or .ttc), and OpenType fonts (.otf) are supported.
TrueType and OpenType fonts that cannot be embedded may not used. If fontname includes
spaces, then it must be enclosed in double quotes. The default font is Helvetica.
size is a numeric value that represents font size measured in points. The default is 11.
color sets the text color.
unit may be in (inch), pt (point), cm (centimeter), or twip (twentieth of a point). An inch is equivalent
to 72 points, 2.54 centimeters, or 1440 twips. The default is in.
color may be one of the colors listed in Colors of [RPT] Appendix for putpdf; a valid RGB value
in the form ### ### ###, for example, 171 248 103; or a valid RRGGBB hex value in the form
######, for example, ABF867.
Options
Options are presented under the following headings:
Options for putpdf paragraph
Options for putpdf text
Options for putpdf image
Options for putpdf paragraph
font(fontname
, size
, color
) sets the font, font size, and font color for the text within the
paragraph. The font size and font color may be specified individually without specifying fontname.
Use font("", size) to specify font size only. Use font("", "", color) to specify font color
only. For both cases, the default font will be used.
Specifying font() with putpdf paragraph overrides font settings specified with putpdf begin.
halign(hvalue) sets the horizontal alignment of the text within the paragraph. hvalue may be left,
right, center, justified, or distribute. distribute and justified justify text between
the left and right margins equally, but distribute also changes the spacing between words and
characters. The default is halign(left).
valign(vvalue) sets the vertical alignment of the characters on each line when the paragraph contains
characters of varying size. vvalue may be baseline, bottom, center, or top. The default is
valign(baseline).
indent(indenttype, #
unit
) specifies that the paragraph be indented by # units. indenttype may
be left, right, or para. left and right indent # units from the left or the right, respectively.
para uses standard paragraph indentation and indents the first line by # inches unless another unit
is specified. This option may be specified multiple times in a single command to accommodate
different indentation settings.
spacing(position, #
unit
) sets the spacing between lines of text. position may be before, after,
or line. before specifies the space before the first line of the current paragraph, after specifies
the space after the last line of the current paragraph, and line specifies the space between lines
within the current paragraph. This option may be specified multiple times in a single command to
accommodate different spacing settings.