7.3  Text Functions s 161
Table 7.9 9 Parameters and values for the text functions (see Section 7.2.3, »Parameter Handling«, page 150)
function
key
explanation
set_parameter
get_parameter
textformat
Specifies the format in which the text output functions will expect the client-
supplied strings. Possible values are bytes, utf8, utf16, utf16le, utf16be, and auto 
(see Section 4.5.2, »Unicode Text Formats«, page 91). Default: auto. Scope: any.
set_value
get_value
leading
Set or get the leading, which is the distance between baselines of adjacent lines of 
text. The leading is used for PDF_continue_text() and PDF_show_boxed(). It is set 
to the value of the font size when a new font is selected using PDF_setfont(). 
Setting the leading equal to the font size results in dense line spacing (leading=0 
will result in overprinting lines). However, ascenders and descenders of adjacent 
lines will generally not overlap. Scope: page, pattern, template, glyph.
set_value
get_value
textrise
Set or get the text rise parameter. The text rise specifies the distance between the 
desired text position and the default baseline. Positive values of text rise move the 
text up. The text rise always relates to the vertical coordinate. This may be useful 
for superscripts and subscripts. The text rise is set to the default value of 0 at the 
beginning of each page. Scope: page, pattern, template, glyph.
set_value
get_value
textrendering
Set or get the current text rendering mode. It can have one of the values given in 
Table 4.4. The text rendering parameter is set to the default of 0 (= solid fill) at the 
beginning of each page. Scope: page, pattern, template, glyph.
set_parameter glyphwarning
If true, an exception will be thrown when a glyph cannot be shown because the 
font does not contain the corresponding glyph description. If false, glyphs missing 
from a font will be replaced with a space character or glyph ID 0. Default: false. 
Scope: any.
set_value
get_value
horizscaling
Set or get the horizontal text scaling to the given percentage, which must be 
greater than 0. Text scaling shrinks or expands the text by a given percentage. The 
text scaling is set to the default of 100 at the beginning and end of each page. Text 
scaling always relates to the horizontal coordinate. Scope: page, pattern, 
template, glyph, document.
set_value
get_value
charspacing
Set or get the character spacing, i.e., the shift of the current point after placing the 
individual characters in a string. The spacing is given in units of the current user 
coordinate system. It is reset to the default of 0 at the beginning and end of each 
page. In order to spread the characters apart use positive values for horizontal 
writing mode, and negative values for vertical writing mode. Scope: page, pattern, 
template, glyph, document.
set_value
get_value
wordspacing
Set or get the word spacing, i.e., the shift of the current point after placing indi-
vidual words in a text line. In other words, the current point is moved horizontally 
after each ASCII space character (0x20). Since only 8-bit encodings can include an 
ASCII space character, word spacing does not work with wide-character 
addressing, such as unicode, glyphid, or encodings which contain non-AGL glyph 
names. Also, it does not work when font subsetting is active. The spacing value is 
given in text space units. It is reset to the default of 0 at the beginning and end of 
each page. Scope: page, pattern, template, glyph, document.
get_value
textx
texty
Get the x or y coordinate, respectively, of the current text position. Scope: page, 
pattern, template, glyph.
set_parameter
get_parameter
underline
overline
strikeout
Set or get the current underline, overline, and strikeout modes, which are retained 
until they are explicitly changed, or a new page is started. Theses modes can be 
set independently from each other, and are reset to false at the beginning of each 
page (see Section 4.6, »Text Metrics, Text Variations, and Box Formatting«, page 
95). Scope: page, pattern, template, glyph.
true
underline/overline/strikeout text
false
do not underline/overline/strikeout text
set_parameter kerning
If true, enable kerning for fonts which have been opened with the kerning option; 
disable if false. Default value is true (see Section 4.6, »Text Metrics, Text Variations, 
and Box Formatting«, page 95). Scope: any.
How to convert pdf into tiff - Convert PDF to tiff images in C#.net, ASP.NET MVC, Ajax, WinForms, WPF
Online C# Tutorial for How to Convert PDF File to Tiff Image File
convert pdf images to tiff; pdf to tiff converters
How to convert pdf into tiff - VB.NET PDF Convert to Tiff SDK: Convert PDF to tiff images in vb.net, ASP.NET MVC, Ajax, WinForms, WPF
Free VB.NET Guide to Render and Convert PDF Document to TIFF
convert pdf to tiff high quality; export pdf to tiff
162
Chapter 7:  API Reference for PDFlib, PDI, and PPS
Details The text position is set to the default value of (0, 0) at the beginning of each page. The 
current point for graphics output and the current text position are maintained sepa-
rately.
Scope page, pattern, template, glyph
Params See Table 7.9.
void PDF_show(PDF *p, const char *text)
void PDF_show2(PDF *p, const char *text, int len)
Print text in the current font and size at the current text position.
text The text to be printed. In C text must not contain null characters when using PDF_
show(), since it is assumed to be null-terminated; use PDF_show2() for strings which 
may contain null characters.
len (Only for PDF_show2().) Length of text (in bytes) for strings which may contain 
null characters. If len = 0 a null-terminated string must be provided.
Details The font must have been set before with PDF_setfont(). The current text position is 
moved to the end of the printed text.
Scope page, pattern, template, glyph
Params See Table 7.9.
Bindings PDF_show2() is only available in C since in all other bindings arbitrary string contents 
can be supplied with PDF_show().
void PDF_show_xy(PDF *p, const char *text, float x, float y)
void PDF_show_xy2(PDF *p, const char *text, int len, float x, float y)
Print text in the current font at position (x, y).
text The text to be printed. In C text must not contain null characters when using PDF_
show_xy(), since it is assumed to be null-terminated; use PDF_show_xy2() for strings 
which may contain null characters.
x,y The position in the user coordinate system where the text will be printed.
len (Only for PDF_show_xy2().) Length of text (in bytes) for strings which may contain 
null characters. If len = 0 a null-terminated string must be provided.
Details The font must have been set before with PDF_setfont(). The current text position is 
moved to the end of the printed text.
Scope page, pattern, template, glyph
Params See Table 7.9.
Bindings PDF_show_xy2() is only available in C since in all other bindings arbitrary string con-
tents can be supplied with PDF_show_xy().
C# Create PDF from Tiff Library to convert tif images to PDF in C#
desStream). Description: Convert to PDF/TIFF with specified resolution and save it into stream. Parameters: Name, Description, Valid Value.
how to convert pdf to tiff in; convert pdf to tiff c#
C# PDF insert text Library: insert text into PDF content in C#.net
Parameters: Name, Description, Valid Value. value, The char wil be added into PDF page, 0
pdf to tiff online; converting pdf to tiff file
7.3  Text Functions s 163
void PDF_continue_text(PDF *p, const char *text)
void PDF_continue_text2(PDF *p, const char *text, int len)
Print text at the next line.
text The text to be printed. If this is an empty string, the text position will be moved 
to the next line anyway. In C text must not contain null characters when using PDF_
continue_text(), since it is assumed to be null-terminated; use PDF_continue_text2() for 
strings which may contain null characters.
len (Only for PDF_continue_text2().) Length of text (in bytes) for strings which may 
contain null characters. If len = 0 a null-terminated string must be provided as in PDF_
continue_text().
Details The positioning of text (x and y position) and the spacing between lines is determined 
by the leading parameter and the most recent call to PDF_show_xy() or PDF_set_text_
pos(). This function can also be used after PDF_show_boxed() if that function has been 
called with mode = left or justify. The current point will be moved to the end of the print-
ed text; the x position for subsequent calls of this function will not be changed.
Scope page, pattern, template, glyph; this function should not be used in vertical writing mode.
Params See Table 7.9.
Bindings PDF_continue_text2() is only available in C since in all other bindings arbitrary string 
contents can be supplied with PDF_continue_text().
void PDF_fit_textline(PDF *p, const char *text, int len, float x, float y, const char *optlist)
Place a single text line at (x, y) with various options.
text The text to be printed.
len (C binding only) Length of text (in bytes) for strings which may contain null char-
acters. If len = 0 a null-terminated string must be provided.
x, y The coordinates of the reference point in the user coordinate system where the 
text will be placed, subject to various options.
optlist An option list (see Section 3.1.4, »Option Lists«, page 44) specifying placement 
details according to Table 7.10.
Details The current graphics state will not be modified by this function. In particular, the cur-
rent text position and the current font will be unaffected.
Scope page, pattern, template, glyph; this function should not be used in vertical writing mode.
Params See Table 7.9.
C# PDF Convert to Word SDK: Convert PDF to Word library in C#.net
zoomValue, The magnification of the original PDF page size. 0.1f
pdf to tiff conversion; batch pdf to tiff converter
Online Convert Excel to PDF file. Best free online export xlsx
Download Free Trial. Convert a Excel File to PDF. Drag and drop your excel file into the box or click the green button to browse for a file to upload.
convert pdf to tiff using c#; program to convert pdf to tiff
164
Chapter 7:  API Reference for PDFlib, PDI, and PPS
Table 7.10 0 Options for PDF_fit_textline()
key
type
explanation
boxsize
float list
Two values specifying the width and height of a box, relative to which the text 
will be placed and possibly scaled. The lower left corner of the box coincides with 
the reference point (x, y). Placing the text and fitting it into the box is controlled 
by the position and fitmethod options. If width=0, only the height is considered; 
If height=0, only the width is considered. In these cases the text will be placed 
relative to the vertical line from (x, y) to (x, y+height), or the horizontal line from 
(x, y) to (x+width, y), respectively. Default: {0 0}.
charspacing
float
The character spacing (see Table 7.9). Default: the current value of the global 
charspacing parameter.
fitmethod
keyword
Specifies the method used to fit the text into the specified box. This option will be 
ignored if no box has been specified. Default: nofit.
nofit
Position the text only, without any scaling or clipping.
clip
Position the text, and clip it at the edges of the box.
meet
Position the text according to the position option, and scale it such
that it entirely fits into the box while preserving its aspect ratio.
Generally at least two edges of the text will meet the corresponding
edges of the box. The dpi and scale options are ignored.
auto
This method tries to fit the text into the box automatically. In detail:
Same as nofit if the text fits into the box. Otherwise a scaling factor is
calculated such that the text fits into the box. If this factor is larger than
0.75 the text is distorted to fit intothe box, otherwise the meet method
is applied.
slice
Position the text according to the position option, and scale it such
that it entirely covers the box, while preserving the aspect ratio and
making sure that at least one dimension of the text is fully contained
in the box. Generally parts of the text’s other dimension will extend
beyond the box, and will therefore be clipped.
entire
Position the text according to the position option, and scale it such
that it entirely covers the box. Generally this method will distort the
text. The scale option will be ignored.
font
font handle
A font handle returned by PDF_load_font(). Default: the current font.
fontsize
float
(Required if the font option is provided) Size of the font, measured in units of the 
current user coordinate system. Default: the current font size.
horizscaling
float
The horizontal text scaling (see Table 7.9). Default: the current value of the global 
horizscaling parameter.
kerning
boolean
Kerning behavior (see Table 7.9). Default: the current value of the global kerning 
parameter.
margin
float list
One or two float values describing additional horizontal and vertical extensions 
of the text box. Default: 0.
orientate
keyword
Specifies the desired orientation of the text when it is placed. Default: north.
north
upright
east
pointing to the right
south
upside down
west
pointing to the left
overline
boolean
Overline mode (see Table 7.9). Default: the current value of the global overline 
parameter.
C# PDF insert image Library: insert images into PDF in C#.net, ASP
Support various image formats, like Jpeg or Jpg, Png, Gif, Bmp, Tiff and other Import graphic picture, digital photo, signature and logo into PDF document.
how to convert pdf to tiff image; c# pdf to tiff
C# TIFF: TIFF Editor SDK to Read & Manipulate TIFF File Using C#.
Convert Tiff file to bmp, gif, png, jpeg, and scanned PDF files to Tiff, like Word, Excel, PowerPoint, PDF, and images. to add XImage.OCR for .NET into C# Tiff
pdf converter to tiff; pdf to tiff conversion using
7.3  Text Functions s 165
int PDF_show_boxed(PDF *p, const char *text, float x, float y, float width, float height,
const char *mode, const char *feature)
Format text into a text box according to the requested formatting mode.
text The text to be formatted into the box. The text must not contain any null charac-
ters.
x, y The coordinates of the lower left corner of the text box or the coordinates of the 
alignment point if width = 0 and height = 0.
width, height The size of the text box, or 0 for single-line formatting.
mode mode selects the horizontal alignment mode. If width = 0 and height = 0mode 
can attain one of the values leftright, or center, and the text will be formatted according 
to the chosen alignment with respect to the point (x, y), with y denoting the position of 
the baseline. In this mode, this function does not check whether the submitted parame-
ters result in some text being clipped at the page edges, nor does it apply any line-wrap-
ping. It returns the value 0 in this case.
If width or height is different from 0, mode can attain one of the values left, right, 
centerjustify, or fulljustify. The supplied text will be formatted into a text box defined by 
the lower left corner (x, y) and the supplied width and height. If the text doesn’t fit into a 
line, a simple line-breaking algorithm is used to break the text into the next available 
line, using existing space characters for possible line-breaks. While the leftright, and 
center modes align the text on the respective line, justify aligns the text on both left and 
right margins. According to common practice the very last line in the box will only be 
position
float list
(Alignment control) One or two values specifying the position of the reference 
point (x, y) within the text’s bounding box with {0 0} being the lower left corner of 
the text box, and {100100} the upper right corner. If the boxsize option has been 
specified, the position option also specifies the positioning of the target box. The 
values are expressed as percentages of the text’s width and height. If both 
percentages are equal it is sufficient to specify a single float value. Some exam-
ples: {0 50} results in left-justified text; {5050} results in centered text; {100 50} 
results in right-justified text. Default: 0 (lower left corner)
rotate
float
Rotate the coordinate system, using the reference point as center and the speci-
fied value as rotation angle in degrees. This results in the box and the text being 
rotated. The rotation will be reset when the text has been placed. Default: 0.
strikeout
boolean
Strikeout mode (see Table 7.9). Default: the current value of the global strikeout 
parameter.
textformat
keyword
The format used to interpret the supplied text (see Section 4.5.2, »Unicode Text 
Formats«, page 91). Default: the current value of the global textformat parameter.
textrendering
int
The text rendering mode (see Table 4.4). Default: the current value of the global 
textrendering parameter.
textrise
float
The text rise mode (see Table 7.9). Default: the current value of the global text rise 
parameter.
underline
boolean
Underline mode (see Table 7.9). Default: the current value of the global underline 
parameter.
wordspacing
float
The word spacing (see Table 7.9). Default: the current value of the global 
wordspacing parameter.
Table 7.10 0 Options for PDF_fit_textline()
key
type
explanation
RasterEdge XDoc.Tiff for .NET - SDK for Tiff Document Imaging
Convert Word, Excel, PowerPoint to Tiff. Convert PDF to Tiff. Convert Jpeg Images to Tiff. Tiff File Process. Tiff Page Edit. Insert Pages into Tiff File.
how to convert pdf to tiff; convert pdf file to tiff format
C# PDF File Split Library: Split, seperate PDF into multiple files
Divide PDF File into Two Using C#. This is an C# example of splitting a PDF to two new PDF files. Split PDF Document into Multiple PDF Files in C#.
how to change pdf to tiff file; how to convert pdf to tiff format online
166
Chapter 7:  API Reference for PDFlib, PDI, and PPS
left-aligned in justify mode, while in fulljustify mode all lines (including the last one if it 
contains at least one space character) will be left- and right-aligned. fulljustify is useful if 
the text is to be continued in another column.
feature If the feature parameter is blind, all calculations are performed (with the excep-
tion of the internal textx and texty coordinates, which are not updated), but no text out-
put is actually generated. This can be used for size calculations and possibly trying dif-
ferent font sizes for fitting some amount of text into a given box by varying the font 
size. Otherwise feature must be empty.
Returns The number of characters which could not be processed since the text didn’t completely 
fit into the column. If the text did actually fit, it returns 0. Since no formatting is per-
formed if width = 0 and height = 0, the function always returns 0 in this case.
Details The current font must have been set before calling this function. The current values of 
font, font size, kerning, horizontal scaling, and leading are used for the text, but the 
word spacing is ignored. The current text position is moved to the end of the generated 
text.
Scope page, pattern, template, glyph; this function cannot be used with CJK fonts or ebcdic or 
unicode encoding. Calling this function is only allowed if the current text format is auto 
or bytes, font subsetting is disabled, and the current encoding has a space character at 
position 0x20.
Params See Table 7.9.
See also Restrictions of this functions are listed in Section 4.6, »Text Metrics, Text Variations, 
and Box Formatting«, page 95.
float PDF_stringwidth(PDF *p, const char *text, int font, float fontsize)
float PDF_stringwidth2(PDF *p, const char *text, int len, int font, float fontsize)
Return the width of text in an arbitrary font.
text The text for which the width will be queried. In C text must not contain null char-
acters when using PDF_stringwidth(), since it is assumed to be null-terminated; use PDF_
stringwidth2() for strings which may contain null characters.
len (Only for PDF_stringwidth2().) Length of text (in bytes) for strings which may con-
tain null characters. If len = 0 a null-terminated must be provided.
font A font handle returned by PDF_load_font(). The corresponding font must not be a 
CJK font with a non-Unicode CMap. If font refers to such a font, this function returns 0 
regardless of the text and fontsize parameters (unless the monospace option has been 
supplied when loading the font).
fontsize Size of the font, measured in units of the user coordinate system (see PDF_
setfont()).
Returns The width of text in an arbitrary font which has been selected with PDF_load_font(), and 
the supplied fontsize. The returned width value may be negative (e.g., when negative 
horizontal scaling has been set).
7.3  Text Functions s 167
Details The width calculation takes the current values of the following text parameters into ac-
count: horizontal scaling, kerning, character spacing, and word spacing.
Scope page, pattern, template, path, glyph, document
Params See Table 7.9.
Bindings PDF_stringwidth2() is only available in C since in all other bindings arbitrary string con-
tents can be supplied with PDF_stringwidth().
168
Chapter 7:  API Reference for PDFlib, PDI, and PPS
7.4Graphics Functions
7.4.1Graphics State Functions
All graphics state parameters are restored to their default values at the beginning of a 
page. The default values are documented in the respective function descriptions. Func-
tions related to the text state are listed in Section 7.3, »Text Functions«, page 155.
Note None of the graphics state functions must be used in path scope (see Section 3.2, »Page Descrip-
tions«, page 53).
void PDF_setdash(PDF *p, float b, float w)
Set the current dash pattern.
b, w
The number of alternating black and white units. b and w must be non-negative 
numbers.
Details In order to produce a solid line, set b = w = 0. The dash parameter is set to solid at the be-
ginning of each page.
Scope page, pattern, template, glyph
void PDF_setdashpattern(PDF *p, const char *optlist)
Set a dash pattern defined by an option list. 
optlist An option list (see Section 3.1.4, »Option Lists«, page 44) according to Table 7.11. 
An empty optlist will generate a solid line.
Details The dash parameter is set to a solid line at the beginning of each page.
Scope page, pattern, template, glyph
void PDF_setpolydash(PDF *p, float *darray, int length)
Deprecated, use PDF_setdashpattern() instead. 
void PDF_setflat(PDF *p, float flatness)
Set the flatness parameter.
flatness A positive number which describes the maximum distance (in device pixels) 
between the path and an approximation constructed from straight line segments.
Table 7.11 1 Options for PDF_setdashpattern()
option
type
description
dasharray
float list
An list of 2-8 alternating values for the lengths of dashes and gaps for stroked 
paths (measured in the user coordinate system) . The array values must be non-
negative, and not all zero. The array values will be cyclically reused until the 
complete path is stroked.
dashphase
float
Distance into the dash pattern at which to start the dash. Default: 0
7.4  Graphics Functions s 169
Details The flatness parameter is set to the default value of 1 at the beginning of each page.
Scope page, pattern, template, glyph
void PDF_setlinejoin(PDF *p, int linejoin)
Set the linejoin parameter.
linejoin Specifies the shape at the corners of paths that are stroked, see Table 7.12.
Details The linejoin parameter is set to the default value of 0 at the beginning of each page.
Scope page, pattern, template, glyph
void PDF_setlinecap(PDF *p, int linecap)
Set the linecap parameter.
linecap Controls the shape at the end of a path with respect to stroking, see Table 7.13.
Details The linecap parameter is set to the default value of 0 at the beginning of each page.
Scope page, pattern, template, glyph
Table 7.12 2 Values of the linejoin parameter
value
description (from the PDF reference)
examples
0
Miter joins: the outer edges of the strokes for the two segments are 
continued until they meet. If the extension projects too far, as determined 
by the miter limit, a bevel join is used instead.
1
Round joins: a circular arc with a diameter equal to the line width is drawn 
around the point where the segments meet and filled in, producing a 
rounded corner.
2
Bevel joins: the two path segments are drawn with butt end caps (see the 
discussion of linecap parameter), and the resulting notch beyond the ends 
of the segments is filled in with a triangle.
Table 7.13 3 Values of the linecap parameter
value
description (from the PDF reference)
examples
0
Butt end caps: the stroke is squared off at the endpoint of the path.
1
Round end caps: a semicircular arc with a diameter equal to the line width 
is drawn around the endpoint and filled in.
2
Projecting square end caps: the stroke extends beyond the end of the line 
by a distance which is half the line width and is squared off.
170
Chapter 7:  API Reference for PDFlib, PDI, and PPS
void PDF_setmiterlimit(PDF *p, float miter)
Set the miter limit.
miter A value greater than or equal to 1 which controls 
the spike produced by miter joins.
Details If the linejoin parameter is set to 0 (miter join), two line 
segments joining at a small angle will result in a sharp 
spike. This spike will be replaced by a straight end (i.e., the 
miter join will be changed to a bevel join) when the ratio of 
the miter length and the line width exceeds the miter limit. The miter limit is set to the 
default value of 10 at the beginning of each page. This corresponds to an angle of rough-
ly 11.5 degrees.
Scope page, pattern, template, glyph
void PDF_setlinewidth(PDF *p, float width)
Set the current line width.
width The line width in units of the current user coordinate system.
Details The width parameter is set to the default value of 1 at the beginning of each page.
Scope page, pattern, template, glyph
void PDF_initgraphics(PDF *p)
Reset all color and graphics state parameters to their defaults.
Details The color, linewidth, linecap, linejoin, miterlimit, dash parameter, and the current 
transformation matrix (but not the text state parameters) are reset to their respective 
defaults. The current clipping path is not affected.
This function may be useful in situations where the program flow doesn’t allow for 
easy use of PDF_save()/PDF_restore().
Scope page, pattern, template, glyph
7.4.2Saving and Restoring Graphics States
void PDF_save(PDF *p)
Save the current graphics state.
Details The graphics state contains parameters that control all types of graphics objects. Saving 
the graphics state is not required by PDF; it is only necessary if the application wishes to 
return to some specific graphics state later (e.g., a custom coordinate system) without 
setting all relevant parameters explicitly again. The following items are subject to save/
restore: 
>graphics parameters: clipping path, coordinate system, current point, flatness, line 
cap style, dash pattern, line join style, line width, miter limit;
Miter 
length
Line width
Documents you may be interested
Documents you may be interested