PDFlib 8 Windows COM/.NET Tutorial

11.6.6 Object Fitting Properties
Fitting properties are available for all Block types, although some properties are specific
to a certain Block type. They manage how the contents will be placed in the Block:
> Table 11.10 lists fitting properties for Textline, Image, and PDF Blocks
> Table 11.11 lists fitting properties for Textflow Blocks (mostly related to aspects of vertical
fitting).
The object fitting algorithm uses the Block rectangle as fitbox. Except for fitmethod=clip
there will be no clipping; if you want to make sure that the Block contents do not exceed
the Block rectangle avoid fitmethod=nofit.
Table 11.10 Fitting properties for Textline, Image, and PDF Blocks
keyword
alignchar
dpi
fitmethod
margin
orientate
position
rotate
scale
shrinklimit
possible values and explanation
(Unichar or keyword; only for Textline Blocks) If the specified character is found in the text, its lower left
corner will be aligned at the lower left corner of the Block rectangle. For horizontal text with
orientate=north or south the first value supplied in the position option defines the position. For horizontal
text with orientate=west or east the second value supplied in the position option defines the
position. This option will be ignored if the specified alignment character is not present in the text. The
value 0 and the keyword none suppress alignment characters. The specified fitmethod will be applied, although
the text cannot be placed within the Block rectangle because of the forced positioning of
alignchar. Default: none
(Float list; only for image Blocks) One or two values specifying the desired image resolution in pixels per
inch in horizontal and vertical direction. With the value o the image’s internal resolution will be used if
available, or 72 dpi otherwise. This property will be ignored if the fitmethod property has been supplied
with one of the keywords auto, meet, slice, or entire. Default: 0
(Keyword) Strategy to use if the supplied content doesn’t fit into the Block rectangle. Possible values are
auto, nofit, clip, meet, slice, and entire. For Textline Blocks, image, and PDF Blocks this property will
be interpreted according to the standard interpretation. Default: auto. For Textflow Blocks where the
Block is too small for the text the interpretation is as follows:
auto fontsize and leading will be decreased until the text fits.
nofit Text will run beyond the bottom margin of the Block.
clip Text will be clipped at the Block margin.
(Float list; only for Textline Blocks) One or two float values describing additional horizontal and vertical
reduction of the Block rectangle. Default: 0
(Keyword) Specifies the desired orientation of the content when it is placed. Possible values are north,
east, south, west. Default: north
(Float list) One or two values specifying the position of the reference point within the content. The position
is specified as a percentage within the Block. Only for Textline Blocks: the keyword auto can be used
for the first value in the list. It indicates right if the writing direction of the text is from right to left (e.g.
for Arabic and Hebrew text), and left otherwise (e.g. for Latin text).
Default: {0 0}, i.e. the lower left corner
(Float) Rotation angle in degrees by which the Block will be rotated counter-clockwise before processing
begins. The reference point is center of the rotation. Default: 0
(Float list) One or two values specifying the desired scaling factor(s) in horizontal and vertical direction.
This option will be ignored if the fitmethod property has been supplied with one of the keywords auto,
meet, slice, or entire. Default: 1
(Float or percentage; only for Textline Blocks) The lower limit of the shrinkage factor which will be applied
to fit text with fitmethod=auto. Default: 0.75
308 Chapter 11: PPS and the PDFlib Block Plugin (Edition for COM, .NET, and REALbasic)