1 - PDFlib

ABC
PDFlib, PDFlib+PDI, PPS
A library for generating PDF on the fly
Version 8.0.1
COM .NET REALbasic

Copyright © 1997–2010 PDFlib GmbH and Thomas Merz. All rights reserved.
PDFlib
PDFlib GmbH
Franziska-Bilek-Weg 9, 80339 München, Germany
www.pdflib.com
+49 • 89 • 452 33 84-0
FAX +49 • 89 • 452 33 84-99
tech.groups.yahoo.com/group/pdflib PDFlib
jp.sales@pdflib.com
PDFlib jp.support@pdflib.com
PDFlib GmbH PDFlib GmbH
PDFlib PDFlib PDFlib GmbH PDFlib PDFlib
Adobe Acrobat PostScript XMP Adobe Systems Inc. AIX IBM OS/390 WebSphere
iSeries zSeries International Business Machines Corporation ActiveX Microsoft OpenType
Windows Microsoft Corporation Apple Macintosh TrueType Apple Computer, Inc.
Unicode Unicode Unicode, Inc. Unix The Open Group Java
Solaris Sun Microsystems, Inc. HKS HKS Hostmann-Steinberg K+E Printing
Inks Schmincke
PANTONE® PANTONE
PANTONE Color Publication
PANTONE® Pantone, Inc. Pantone, Inc. © Pantone, Inc., 2003.
Pantone, Inc. PDFlib GmbH PDFlib
PANTONE
PDFlib
PDFlib
ICClib Copyright © 1997-2002 Graeme W. Gill
GIF Copyright © 1990-1994 David Koblas
PNG libpng Copyright © 1998-2004 Glenn Randers-Pehrson
Zlib Copyright © 1995-2002 Jean-loup Gailly and Mark Adler
TIFFlib Copyright © 1988-1997 Sam Leffler Copyright © 1991-1997 Silicon Graphics, Inc.
Eric Young Cryptographic Copyright © 1995-1998 Eric Young eay@cryptsoft.com
Independent JPEG Group JPEG Copyright © 1991-1998, Thomas G. Lane
Cryptographic Copyright © 1998-2002 The OpenSSL Project www.openssl.org
Expat XML Copyright © 1998, 1999, 2000 Thai Open Source Software Center Ltd
ICU International Components for Unicode Copyright © 1995-2009 International Business Machines
Corporation and others
sRGB ICC Copyright © 1998 Hewlett-Packard Company
PDFlib RSA Security, Inc. MD5

0 PDFlib 9
1 13
1.1 13
1.2 PDFlib 15
1.3 PDFlib/PDFlib+PDI/PPS 8 17
17
18
20
21
1.4 PDFlib 22
1.5 PDFlib+PDI 26
1.6 PPS 27
1.7 28
2 PDFlib 29
2.1 29
2.2 Cobol 30
2.3 COM 31
2.4 C 37
2.5 C++ 38
2.6 Java 39
2.7 .NET 40
2.8 Perl 43
2.9 PHP 44
2.10 Python 45
2.11 REALbasic 46
2.12 RPG 47
2.13 Ruby 48
2.14 Tcl 49
3 PDFlib 51
3.1 PDFlib 51
51
3

53
55
59
59
60
3.2 61
61
63
64
66
67
3.3 PDF 68
68
69
3.4 Web PDF 71
3.5 72
72
73
76
3.6 79
79
81
3.7 PDF 85
85
85
86
87
4 Unicode 89
4.1 Unicode 89
4.2 8 91
4.3 95
4.4 PDFlib 97
97
97
98
4.5 99
99
100
5 103
5.1 103
103
4

103
104
105
105
5.2 Unicode 107
107
107
108
109
5.3 110
110
111
112
5.4 113
113
115
116
120
123
5.5 126
126
127
5.6 130
130
131
132
6 135
6.1 135
6.2 137
137
138
139
6.3 OpenType 142
142
144
6.4 148
148
150
152
152
154
6.5 156
156
5

157
158
159
7 PDF 163
7.1 163
163
165
168
168
170
7.2 PDI PDF 172
172
172
174
7.3 PDF 176
176
176
178
180
181
182
8 183
8.1 183
183
184
185
187
187
188
189
8.2 191
193
194
195
197
199
200
202
203
206
207
8.3 211
212
6

215
216
218
221
223
8.4 226
226
227
228
9 pCOS 231
9.1 pCOS 231
9.2 PDF 233
9.3 ID 235
9.4 236
9.5 238
9.6 PDF 245
10 PDF 247
10.1 Acrobat PDF 247
10.2 ISO 32000 250
10.3 PDF/X 251
251
252
255
256
10.4 PDF/A 258
258
258
262
263
264
266
266
10.5 PDF 267
267
269
270
273
11 PPS PDFlib Block Plugin 275
11.1 PDFlib Block Plugin 275
7

11.2 PDFlib 277
277
277
278
11.3 PDFlib Block Plugin 280
280
283
285
286
289
11.4 Acrobat 290
11.5 PPS 294
11.6 298
298
298
299
301
302
304
306
306
11.7 pCOS 308
11.8 PDFlib 310
310
311
313
A 315
317
8

0PDFlib
www.pdflib.com
sales@pdflib.com
general/license_key
Windows
license
>
oPDF.set_parameter "license", "... ..."
>
p.set_parameter("license", "... ...");
licensekeys.txt
PDFlib license file 1.0
# Licensing information for PDFlib GmbH products
PDFlib 8.0.1 ... ...
9

licensefile
>
oPDF.set_parameter "licensefile", "///licensekeys.txt"
>
p.set_parameter("licensefile", "///licensekeys.txt");
PDFLIBLICENSEFILE
HKLM\Software\PDFlib\PDFLIBLICENSEFILE
HKLM\Software\PDFlib\PDFlib8\license
HKLM\Software\PDFlib\PDFlib8\8.0.1\license
64 Windows 64
PDFlib Windows 64 64
32 PDFlib 32
32
32 regedit
...
%systemroot%\syswow64\regedit
8.0.x
10 0 : PDFlib COM .NET REALbasic

PDFlib GmbH, Licensing Department
Franziska-Bilek-Weg 9, 80339 München, Germany
www.pdflib.com
jp.sales@pdflib.com
jp.support@pdflib.com
11

12 0 : PDFlib COM .NET REALbasic

1
1.1
Windows Vista Windows 7
Program Files Windows
PDF
PDFlib PDFlib
PDFlib Java 29
2 PDFlib
C PDFlib
PDFlib API PDFlib API
php.net
PDFlib API
PDFlib PDFlib
1.1 13

www.pdflib.com/pdflib-cookbook/
pCOS pCOS
www.pdflib.com/pcos-cookbook/
TET
TET
www.pdflib.com/tet-cookbook/
14 1 : COM .NET REALbasic

1.2 PDFlib
PDFlib
>
>
>
PDFlib
>
>
>
>
>
>
>
>
>
>
>
>
>
1.2 PDFlib 15

PDFlib
>
>
>
>
PDFlib
16 1 : COM .NET REALbasic

1.3 PDFlib/PDFlib+PDI/PPS 8
1.3.1 Acrobat 9 PDF
PDF
PDF
AES-256 Unicode
Acrobat 9
1.3 PDFlib/PDFlib+PDI/PPS 8 17

1.3.2
OpenType
SING
18 1 : COM .NET REALbasic

1.3 PDFlib/PDFlib+PDI/PPS 8 19

1.3.3 PDFlib Block Plugin PDFlib Personalization Server PPS
PPS Acrobat
PDF/A PDF/X
PDFlib 8
20 1 : COM .NET REALbasic

1.3.4
PDF/X-4 PDF/X-5
TIFF PNG
JBIG2
PANTONE® Goe
®
> info_image( )
>
>
>
>
>
>
> info_font( )
>
> wstring
1.3 PDFlib/PDFlib+PDI/PPS 8 21

1.4 PDFlib
22 1 : COM .NET REALbasic

® ® ®
1.4 PDFlib 23

24 1 : COM .NET REALbasic

1.4 PDFlib 25

1.5 PDFlib+PDI
26 1 : COM .NET REALbasic

1.6 PPS
® ®
1.6 PPS 27

1.7
end_document( ) linearize
end_document( ) optimize
begin_template_ext( ) open_pdi_page( )
reference
add_portfolio_file( ) password
28 1 : COM .NET REALbasic

2PDFlib
PDFlib
PDFlib
2.1
2.1 29

2.2 Cobol
30 2 : PDFlib COM .NET REALbasic

2.3 COM
>
>
> pdflib_com.dll
>
>
>
PDFlib MTS Microsoft Transaction Server
MTS
PDFlib COM
>
>
>
>
>
\PDFlib 8.0.1\bin\pdflib _
com.dll
>
PDFlib MSI
1. COM www.microsoft.com/com
2.3 COM 31

.msi
> pdflib_com.dll
>
>
msiexec.exe /I PDFlib-8.0.1-com-dotnet.msi /qn
ISP PDFlib COM
> regsvr32
>
HKEY_LOCAL_MACHINE\SOFTWARE\PDFlib
>
set_parameter( )
SearchPath resourcefile license
PDFlib COM
32 2 : PDFlib COM .NET REALbasic

> pdflib.reg
> pdflib_com.dll regsvr32
> set_parameter( )
license
oPDF.set_parameter("license", " ")
COM
Active Server Pages PDFlib
MapPath
UNC IIS
PDFlib_com
CreateObject

PDFlib_com
> Object PDFlib_
com.PDF
34 2 : PDFlib COM .NET REALbasic

Dim oPDF As PDFlib_com.PDF
Set oPDF = CreateObject("PDFlib_com.PDF")
' : Set oPDF = New PDFlib_com.PDF
>
>
>
>
oPDF.circle 10, 10, 30
pcircle (circle)
pscale (scale)
oPDF.[circle] 10, 10, 30
circle
scale
long
long
int
On Error GoTo
Sub main()
Dim oPDF As PDFlib_com.PDF
On Error GoTo ErrExit
...PDFlib...
End
ErrExit:
MsgBox Hex(Err.Number) & ": " & Err.Description
End Sub
2.3 COM 35

.NET PDFlib COM
tlbimp.exe
tlbimp pdflib_com.dll /namespace:pdflib_com /out:Interop.pdflib_com.dll
pdflib_com.dll
Imports PDFlib_com
...
Dim p As PDFlib_com.IPDF
...
p = New PDF()
...
buf = p.get_buffer()
using PDFlib_com;
...
static PDFlib_com.IPDF p;
...
p = New PDF();
...
buf = (byte[])p.get_buffer();
get_buffer( )
create_pfv( )
36 2 : PDFlib COM .NET REALbasic

2.4 C
PDFlib C C++
PDFlib C++
C C++
2.4 C 37

2.5 C++
38 2 : PDFlib COM .NET REALbasic

2.6 Java
2.6 Java 39

2.7 .NET
pdflib_dotnet.dll
PDFlib.NET 32-bit 64-bit .NET Framework 2.0
PDFlib .NET
msiexec.exe /I PDFlib-8.0.1-com-dotnet.msi /qn
pdflib_dotnet.dll
IntelliSense
pdflib_dotnet.xml
pdflib_dotnet.dll
pdflib_dotnet.dll
pdflib_dotnet.xml
.NET
get_errnumget_errmsgget_apiname
PDFlib_dotnet.PDFlibException
C# PDFlib
... ... PDFlib_dotnet.dll
csc.exe /r:..\..\bin\PDFlib_dotnet.dll hello.cs
40 2 : PDFlib COM .NET REALbasic

try
catch
try {
...PDFlib...
catch (PDFlibException e)
{
// PDFlib
Console.WriteLine("PDFlib exception occurred in hello sample:\n");
Console.WriteLine("[{0}] {1}: {2}\n",
e.get_errnum(), e.get_apiname(), e.get_errmsg());
} finally {
if (p != null) {
p.Dispose();
}
}
VB.NET PDFlib
... ... PDFlib_
dotnet.dll
vbc.exe /r:..\..\bin\pdflib_dotnet.dll hello.vb
>
>
try catch
Try
...PDFlib...
Catch e As PDFlibException
Console.WriteLine("PDFlib exception occurred in hello sample:")
Console.WriteLine("[{0}] {1}: {2}",
e.get_errnum(), e.get_apiname(), e.get_errmsg())
Finally
If Not p Is Nothing Then
p.Dispose()
End If
End Try
On Error GoTo
Imports Microsoft.VisualBasic
Public Shared Sub Main()
On Error GoTo ErrExit
...PDFlib...
Exit Sub
ErrExit:
2.7 .NET 41

Console.WriteLine("PDFlib exception caught: {0}", Err.Description)
End Sub
ASP.NET PDFlib
PDFlib_dotnet.dll
bin
bin
C:\Inetpub\wwwroot\bin\pdflib_dotnet.dll
C:\Inetpub\wwwroot\WebApplicationX\bin\pdflib_dotnet.dll
MapPath
ASP.NET 2.0
Full
Unicode
Encoding
public String(sbyte*, int, int, Encoding)
42 2 : PDFlib COM .NET REALbasic

2.8 Perl
2.8 Perl 43

2.9 PHP
44 2 : PDFlib COM .NET REALbasic

2.10 Python
2.10 Python 45

2.11 REALbasic 1
PDFlib REALbasic
PDFlib.rbx
Plugins
PDFlib.framework /Library/Frameworks
>
>
>
REALbasic
> PDFlib
> PDFlibException RuntimeException
REALbasic PDFlibException
try catch
Exception err As PDFlibException
MsgBox("PDFlib exception occurred in hello sample: [" + _
Str(err.get_errnum()) + "] " + err.get_apiname() + ": " + err.get_errmsg())
PDFlibException
1. www.realbasic.com
46 2 : PDFlib COM .NET REALbasic

2.12 RPG
2.12 RPG 47

2.13 Ruby
48 2 : PDFlib COM .NET REALbasic

2.14 Tcl
2.14 Tcl 49

50 2 : PDFlib COM .NET REALbasic

3PDFlib
3.1 PDFlib
PDFlib
general
3.1.1
>
>
>
>
>
>
delete( ) get_apiname( ) get_errnum( ) get_errmsg( )
>
>
>
3.1 PDFlib 51

PDF
get_errnum( ) get_errmsg( ) get_apiname( )
errorpolicy
errorpolicy
> errorpolicy=legacy
fontwarning imagewarning
legacy
> errorpolicy=return
> errorpolicy=exception
errorpolicy=return
font = p.load_font("MyFontName", "unicode", "errorpolicy=return");
if (font == -1)
{
/* PDF*/
errmsg = p.get_errmsg();
/* */
...
}
/* */
52 3 : PDFlib COM .NET REALbasic

errorpolicy=exception
font = p.load_font("MyFontName", "unicode", "errorpolicy=exception");
/*
* PDF
*/
general/error_handling
p.set_parameter("logging", "filename=private.log");
>
>
3.1.2 PDFlib PVF
general/starter_pvf
PDFlib Virtual File System
filename
> /pvf/image/filename
>
/pvf/font/filename
> /pvf/iccprofile/filename
> /pvf/codepage/filename
> /pvf/pdf/filename
3.1 PDFlib 53

create_pvf( )
copy
delete( )
close( )
delete_pvf( )
copy
>
delete_pvf( ) close( ) delete_pvf( )
delete_pvf( )
>
delete_pvf( )
> delete_pvf( )
delete( )
delete_pvf( )
delete( )
PDF
begin_document( )
createpvf
54 3 : PDFlib COM .NET REALbasic

3.1.3
set_parameter( )
Unix
PostScript Resource
makepsres
HostFont
SearchPath
CMap
FontAFM
FontPFM
FontOutline
Encoding
HostFont
ICCProfile
StandardOutputIntent
UPR
3.1 PDFlib 55

> \
>
>
>
>
>
PS-Resources-1.0
>
>
SearchPath
SearchPath
SearchPath
SearchPath
SearchPath
p.set_parameter("SearchPath", "///1");
p.set_parameter("SearchPath", "///2");
SearchPath
> SearchPath
56 3 : PDFlib COM .NET REALbasic

HKLM\Software\PDFlib\PDFlib8\8.0.1\SearchPath
HKLM\Software\PDFlib\PDFlib8\SearchPath
HKLM\Software\PDFlib\SearchPath
> SearchPath
C:\Program Files\PDFlib\PDFlib 8.0.1\resource
UPR
PS-Resources-1.0
.
SearchPath
/usr/local/lib/fonts
C:/psfonts/pfm
C:/psfonts
/users/kurt/my_images
.
FontAFM
Code-128=Code_128.afm
.
FontPFM
Corporate-Bold=corpb___.pfm
Mistral=c:/psfonts/pfm/mist____.pfm
.
FontOutline
Code-128=Code_128.pfa
ArialMT=Arial.ttf
.
HostFont
Wingdings=Wingdings
.
Encoding
myencoding=myencoding.enc
.
ICCProfile
highspeedprinter=cmykhighspeed.icc
.
UPR
set_
parameter( )
> PDFLIBRESOURCE
> PDFLIBRESOURCE
pdflib.upr
3.1 PDFlib 57

HKLM\Software\PDFlib\PDFlib8\8.0.1\resourcefile
HKLM\Software\PDFlib\PDFlib8\resourcefile
HKLM\Software\PDFlib\resourcefile
regedit
...
%systemroot%\syswow64\regedit
64 Windows 64
PDFlib Windows 64 64
32 PDFlib 32
32
32 regedit
...
> resourcefile
p.set_parameter("resourcefile", "///pdflib.upr");
set_parameter( )
p.set_parameter("FontAFM", "Foobar-Bold=foobb___.afm");
p.set_parameter("FontOutline", "Foobar-Bold=foobb___.pfa");
116 5.4.3
get_parameter( )
s = p.get_parameter("SearchPath", n);
58 3 : PDFlib COM .NET REALbasic

n
n
3.1.4 PDF
end_document( )
createpvf
PDF begin_
document( ) get_buffer( )
p.begin_document("", "");
......
p.end_document("");
buf = p.get_buffer();
... PDF ...
p.delete();
PDF
3.1.5 PDF
>
>
begin_document( )
3.1 PDFlib 59

objectstreams={other}
objectstreams
>
3.1.6 PDFlib EBCDIC
60 3 : PDFlib COM .NET REALbasic

3.2
3.2.1
1 pt = 1/72 inch = 25.4/72 mm = 0.3528 mm
rotate( ) scale( ) translate( ) skew( )
p.scale(28.3465, 28.3465);
72 2.54 = 28.3465
begin/end_page_ext( ) userunit
general/metric_topdown_coordinates
usercoordinates true
p.set_parameter("usercoordinates", "true");
usercoordinates true
3.2 61

grid.pdf
...
> / :
>
fit_textline( ) fit_
textflow( ) fit_image( ) fit_pdi_page( ) rotate
orientate
p.fit_textline("", 50.0, 700.0, "rotate=45");
text_output/rotated_text
translate( ) rotate( )
(200, 100)
(0, 0)
p.save();
p.translate(200, 100);
/* */
p.rotate(45.0); /* */
p.rect(0.0, 0.0, 75.0, 25.0); /* */
p.stroke();
p.restore();
62 3 : PDFlib COM .NET REALbasic

topdown
(0, 0)
y
y
begin_page_ext( ) topdown
p.begin_page_ext(595.0, 842.0, "topdown");
topdown
>
moveto( ) x y circle( ) x y rect( ) x y width height
add_note( ) llx lly urx ury
>
>
>
(0, 0)
general/metric_topdown_coordinates
3.2.2
pagination/page_sizes
begin/end_page_ext( ) width height
< >.width <
>.height < >
a4.width
begin/end_page_ext( ) userunit
3.2 63

userunit
userunit
>
>
>
>
>
/* CropBox */
p.begin_page_ext(595, 842, "cropbox={10 10 500 800}");
3.2.3
>
>
>
>
64 3 : PDFlib COM .NET REALbasic

moveto( ) lineto( ) rect( )
stroke ( ) fill( ) clip( )
save( ) restore( )
p.setcolor("stroke", "rgb", 1, 0, 0, 0);
p.moveto(100, 100);
p.lineto(200, 100);
p.stroke();
graphics/starter_graphics
add_path_point( )
add_path_point( )
> draw_path( )
>
>
>
delete_path( )
info_path( )
path = p.add_path_point( -1, 0, 100, "move", "");
path = p.add_path_point(path, 200, 100, "control", "");
path = p.add_path_point(path, 0, 100, "circular", "");
p.draw_path(path, 0, 0, "stroke");
p.draw_path(path, 400, 500, "stroke");
p.delete_path(path);
3.2 65

image = p.load_image("auto", "image.tif", "clippingpathname={path 1}");
/* */
path = (int) p.info_image(image, "clippingpath", "");
if (path == -1)
throw new Exception(" : !");
p.draw_path(path, 0, 0, "stroke");
3.2.4
PDF XObject
PDFlib
fit_
image( )
/* */
template = p.begin_template_ext(template_width, template_height, "");
......
p.end_template_ext(0, 0);
...
p.begin_page(page_width, page_height);
/* */
p.fit_image(template, 0.0, 0.0, "");
......
p.end_page();
...
p.close_image(template);
> load_image( )
66 3 : PDFlib COM .NET REALbasic

general/repeated_contents
3.2.5 PDF
pdfx/starter_pdfx5g
XObject
> ... XObject
> ...
> ...
>
>
>
>
>
proxy = p.begin_template_ext(0, 0,
"reference={filename=target.pdf pagenumber=1 strongref=true}");
if (proxy == -1 )
{
/* */
}
3.2 67

3.3 PDF
3.3.1 PDF
>
>
>
>
There is nothing inherent in PDF encryption that enforces the document permissions
specified in the encryption dictionary. It is up to the implementors of PDF viewers to respect the
intent of the document creator by restricting user access to an encrypted PDF file according to
the permissions contained in the file.
Unicode
68 3 : PDFlib COM .NET REALbasic

3.3.2 PDFlib
>
>
>
>
>
begin_document( ) userpasswordmasterpassword
>
>
>
>
>
>
begin_document( ) permissions
permissions
masterpassword
3.3 PDF 69

p.begin_document(filename, "masterpassword=abcd1234 permissions={noprint nocopy}");
general/permission_settings
3.4 begin_document( ) permissions
noprint
nomodify
nocopy
noannots
noforms
noaccessible
noassemble
nohiresprint
plainmetadata
Acrobat
Acrobat
Acrobat
Acrobat
PDF 1.4 nomodify noannots Acrobat
PDF 1.4 Acrobat
PDF 1.4 nomodify Acrobat
PDF 1.4 Acrobat noprint
PDF 1.5 XMP
PDF
PDF
begin_document( )
attachmentpassword
70 3 : PDFlib COM .NET REALbasic

3.4 Web PDF
Web
> begin_document( )linearize
p.begin_document(outfilename, "linearize");
Web
>
>
... Web
PDF
begin_document( ) inmemory
3.4 Web PDF 71

3.5
PDFlib API
PDFlib color
color/starter_color
3.5.1
> begin_pattern( ) end_pattern( )
> begin_pattern( ) setcolor( )
begin_pattern( ) painttype
painttype
painttype
graphics/fill_patternimages/tiling_pattern
>
>
shading( ) c1 c2 c3 c4
setcolor( )
shading( )
> shfill( )
clip( )
>
shading_pattern( )
72 3 : PDFlib COM .NET REALbasic

color/color_gradient
3.5.2 Pantone HKS
makespotcolor( )
spotcolorlookup
PDFlib
PDFlib GmbH
color/spot_color
PANTONE®
®
®®
preserveoldpantonenames true
3.5 73

PANTONE
C
spot = p.makespotcolor("PANTONE 281 U");
p.setcolor("fill", "spot", spot, 0.7, 0, 0);
®
®
Pantone, Inc. Pantone, Inc. © Pantone, Inc., 2003.
® PDF/X-1a
74 3 : PDFlib COM .NET REALbasic

HKS®
Farbfächer
> (Kunstdruckpapier) (HKS 43
K)
> (Naturpapier) (HKS 43 N)
> (Endlospapier) (HKS 43 E)
> (Zeitungspapier) (HKS 43 Z)
HKS
N HKS
spot = p.makespotcolor("HKS 38 E");
p.setcolor("fill", "spot", spot, 0.7, 0, 0);
3.5 75

p.setcolor("fill", "cmyk", 0.2, 1.0, 0.2, 0); /* CMYK */
spot = p.makespotcolor("CompanyLogo"); /* */
p.setcolor("fill", "spot", spot, 1, 0, 0); /* */
3.5.3 ICC
color/iccprofile_to_image
CIE L*a*b* setcolor( ) lab
lab
load_image( )
renderingintent
create_
gstate( ) renderingintent
ICC
>
>
>
>
>
ICC www.pdflib.com
ICC
ICC load_iccprofile( ) profilename
1. www.color.org
76 3 : PDFlib COM .NET REALbasic

profilename=sRGB
> ICCProfile profilename
profilename
>
.icc
.icm
/
/.icc
/.icm
colordir
C:\WINNT\system32\ spool\drivers\color
colordir
/System/Library/ColorSync/Profiles
/Library/ColorSync/Profiles
/Network/Library/ColorSync/Profiles
~/Library/ColorSync/Profiles
colordir
sRGB sRGB ICC
load_iccprofile( ) profilename=sRGB
ICC
honoriccprofile
image:iccprofile
icccomponents
3.5 77

ICC
load_image( ) iccprofile
ICC
setcolor:iccprofilegray setcolor:iccprofilergb setcolor:iccprofilecmyk
iccbasedgray iccbasedrgb
iccbasedcmyk setcolor( )
p.set_parameter("errorpolicy", "return");
icchandle = p.load_iccprofile(...);
if (icchandle == -1)
{
return;
}
p.set_value("setcolor:iccprofilecmyk", icchandle);
p.setcolor("fill", "iccbasedcmyk", 0, 1, 0, 0);
ICC
begin_page_ext( ) defaultgray defaultrgb defaultcmyk
/* sRGB */
icchandle = p.load_iccprofile("sRGB", 0, "usage=iccbased");
p.begin_page_ext(595, 842, "defaultrgb=" + icchandle);
PDF/X PDF/A
load_
iccprofile( ) usage=outputintent
78 3 : PDFlib COM .NET REALbasic

3.6
PDFlib interactive
3.6.1
> www.kraxi.com www.kraxi.com
>
>
>
>
Web www.kraxi.com
matchbox
name=kraxi
URI Web
Link
action activate
act
linewidth=0
3.1
3.6 79

normalfont = p.load_font("Helvetica", "unicode", "");
p.begin_page_ext(pagewidth, pageheight, "topdown");
/* Kraxi Systems, Inc. */
String optlist =
"font=" + normalfont + " fontsize=8 position={left top} " +
"matchbox={name=kraxi} fillcolor={rgb 0 0 1} underline";
p.fit_textline("Kraxi Systems, Inc.", 2, 20, optlist);
/* URI */
optlist = "url={http://www.kraxi.com}";
int act = p.create_action("URI", optlist);
/* kraxiLink */
optlist = "action={activate " + act + "} linewidth=0 usematchbox={kraxi}";
/* 0 */
p.create_annotation(0, 0, 0, 0, "Link", optlist);
p.end_page_ext("");
interactive/link_annotations
paper_planes_catalog.pdf
GoToR
filename destination
page 2 type fixed
left 50 top 200 zoom 2
String optlist =
"filename=paper_planes_catalog.pdf " +
"destination={page 2 type fixed left 50 top 200 zoom 2}";
goto_action = p.create_action("GoToR", optlist);
action
activate
goto_action fontstyle bold
textcolor {rgb 0 0 1}
String
optlist=
"action={activate " + goto_action + " } fontstyle=bold textcolor={rgb 0 0 1}";
catalog_bookmark = p.create_bookmark("Our Paper Planes Catalog", optlist);
interactive/nested_bookmarks
80 3 : PDFlib COM .NET REALbasic

FileAttachment
filename mimetype image/gif
iconname pushpin
annotcolor {rgb 1 0 0} contents {Get the Kraxi Paper Plane!}
display noprint
String optlist =
"filename=kraxi_logo.gif mimetype=image/gif iconname=pushpin " +
"annotcolor={rgb 1 0 0} contents={Get the Kraxi Paper Plane!} display=noprint";
p.create_annotation(left_x, left_y, right_x, right_y, "FileAttachment", optlist);
iconname
3.6.2 JavaScript
Named
print_action = p.create_action("Named", "menuname=Print");
button_font = p.load_font("Helvetica-Bold", "unicode", "");
action
up
print_action backgroundcolor {rgb 1 1 0}
bordercolor {rgb 0 0 0}
caption Print Print tooltip {Print the document}
font button_font
print_buttonpushbutton
String optlist =
"action {up " + print_action + "} backgroundcolor=yellow " +
"bordercolor=black caption=Print tooltip={Print the document} font=" +
button_font;
p.create_field(left_x, left_y, right_x, right_y, "print_button", "pushbutton", optlist);
Print
print_
icon.jpg icon
print_icon
print_icon = p.load_image("auto", "print_icon.jpg", "template");
if (print_icon == -1)
{
3.6 81

* */
return;
}
p.begin_page_ext(pagewidth, pageheight, "");
...
String optlist = "action={up " + print_action + "} icon=" + print_icon +
" tooltip={Print the document} font=" + button_font;
p.create_field(left_x, left_y, right_x, right_y, "print_button", "pushbutton", optlist);
interactive/form_pushbutton
textfield date
textfield_font = p.load_font("Helvetica-Bold", "unicode", "");
String optlist = "backgroundcolor={gray 0.8} font=" + textfield_font;
p.create_field(left_x, left_y, right_x, right_y, "date", "textfield", optlist);
auto
interactive/form_textfield_layout
interactive/form_textfield_height
JavaScript
JavaScript JavaScript
script
date
String optlist =
"script={var d = util.printd('mmm dd yyyy', new Date()); "
"var date = this.getField('date'); date.value = d;}"
show_date = p.create_action("JavaScript", optlist);
action
show_date open
String optlist = "action={open " + show_date + "}";
p.begin_page_ext(pagewidth, pageheight, optlist);
textfield_font = p.load_font("Helvetica-Bold", "winansi", "");
String optlist = "backgroundcolor={gray 0.8} font=" + textfield_font;
p.create_field(left_x, left_y, right_x, right_y, "date", "textfield", optlist);
82 3 : PDFlib COM .NET REALbasic

interactive/form_textfield_fill_with_js
create_field( ) action
keystroke format
keystroke format
keystroke_action = p.create_action("JavaScript",
"script={AFNumber_Keystroke(2, 0, 3, 0, \"EUR \", true); }");
format_action = p.create_action("JavaScript",
"script={AFNumber_Format(2, 0, 0, 0, \"EUR \", true); }");
String optlist = "font=" + font + "action={keystroke " + keystroke_action +
" format=" + format_action + "}";
p.create_field(50, 500, 250, 600, "price", "textfield", optlist);
interactive/form_textfield_input_format
keystroke format
3.6 83

nDec
sepStyle
negStyle
strCurrency
0 1,234.56
1
2 1.234,56
3 1234,56
0
1
2
3
\u20AC
bCurrency-
Prepend
false
true
cFormat
tFormat
psf
d
dd
ddd
m
mm
mmm
mmmm
yyyy
yy
h
hh
H
HH
M
MM
s
ss
t
tt
0
1
2
3
84 3 : PDFlib COM .NET REALbasic

3.7 PDF
interactive/starter_geospatial
3.7.1 GeoPDF Acrobat
>
>
>
>
>
...
> begin/end_page_ext( )
viewports
georeference
> load_image( ) georeference
3.7.2
EPSG
www.epsg.org
3.7 PDF 85

WKT Well-known text
OpenGIS®
Implementation Specification: Coordinate Transformation Services
www.opengeospatial.org/standards/ct
www.spatialreference.org/ref/epsg
3.7.3
georeference
worldsystem
worldsystem={type=geographic wkt={
GEOGCS["WGS 84",
DATUM["WGS_1984", SPHEROID["WGS 84", 6378137, 298.257223563]],
PRIMEM["Greenwich", 0],
UNIT["degree", 0.01745329251994328]]
}}
worldsystem={type=geographic wkt={
GEOGCS["ETRS_1989",
DATUM["ETRS_1989", SPHEROID["GRS_1980", 6378137.0, 298.257222101]],
PRIMEM["Greenwich", 0.0],
UNIT["Degree", 0.0174532925199433]]
}}
WGS84 ETRS EPSG Acrobat
EPSG
georeference
worldsystem
worldsystem={type=projected wkt={
PROJCS["ETRS_1989_UTM_Zone_32N",
GEOGCS["GCS_ETRS_1989",
DATUM["D_ETRS_1989", SPHEROID["GRS_1980", 6378137.0, 298.257222101],
TOWGS84[0, 0, 0, 0, 0, 0, 0]],
PRIMEM["Greenwich", 0.0],
86 3 : PDFlib COM .NET REALbasic

}}
UNIT["Degree", 0.0174532925199433]],
PROJECTION["Transverse_Mercator"],
PARAMETER["False_Easting", 500000.0],
PARAMETER["False_Northing", 0.0],
PARAMETER["Central_Meridian", 9.0],
PARAMETER["Scale_Factor", 0.9996],
PARAMETER["Latitude_Of_Origin", 0.0],
UNIT["Meter", 1.0]]
worldsystem={type=projected epsg=25832}
3.7.4 Acrobat 9 GeoPDF
>
>
open_pdi_page( ) begin_template_ext( ) georeference
begin_page_ext( ) viewports
>
load_image( )
>
3.7 PDF 87

88 3 : PDFlib COM .NET REALbasic

4Unicode
4.1 Unicode
>
>
BMP PUA
> BMP
> PUA
4.1
4.1 Unicode 89

Unicode UTF
> UTF-8
 Ã
> UTF-16
> UTF-32
text_output/process_utf8
Unicode BOM

þÿ
ÿþ
þÿ
ÿþ
90 4 : Unicode COM .NET REALbasic

4.2 8
.notdef
PDFlib chartab
macroman
macroman_apple
macroman
> macroman_apple
> macroman_apple
macroman_apple
host
> ebcdic
> ebcdic_37
> winansi
> iso8859-1
host
auto
>
> iso8859-1 auto
macroman
> IBMCCSID000000000000
4.2 8 91

winansi cp1252 ISO8859-1
macroman
macroman_
apple
macroman
ebcdic
ebcdic_37
pdfdoc
iso8859-1
iso8859-2
iso8859-3
iso8859-4
iso8859-5
iso8859-6
iso8859-7
iso8859-8
iso8859-9
iso8859-10
iso8859-13
iso8859-14
iso8859-15
iso8859-16
cp1250
cp1251
cp1252
cp1253
cp1254
cp1255
cp1256
cp1257
cp1258
92 4 : Unicode COM .NET REALbasic

ebcdic
auto builtin
8
encoding_
set_char( ))
>
>
set_parameter( )
>
% PDFlib
% Unicode
space 32 0x0020
exclam 33 0x0021
...
% PDFlibUnicode
% Unicode
0x0020 32
0x0021 33
...
>
>
0x
>
0x0000 .notdef
4.2 8 93

*.enc
*.cpg
94 4 : Unicode COM .NET REALbasic

4.3
CMap
CMap
Unicode Unicode CMap UCS2 UTF16
CMap 97 4.4.2 Unicode
CMap
CMap
4.3 95

resource/cmap
>
SearchPath
p.set_parameter("SearchPath", "///resource/cmap");
SearchPath
PDFLIBRESOURCEFILE
96 4 : Unicode COM .NET REALbasic

4.4 PDFlib
4.4.1
text
show( ) fit_textline( ) add_textflow( ) text
add_table_cell( ) fieldname
define_layer( ) name
create_action( ) destname
create_bookmark( ) text
begin_document( ) create_pvf( ) filename
load_font( ) fontname
load_iccprofile( ) profilename
filenamehandling
4.4.2 Unicode
>
>
>
4.4 PDFlib 97

>
>
>
>
>
utf16 unicode
>
> unicode
>
Unicode
4.4.3 Unicode
98 4 : Unicode COM .NET REALbasic

4.5
winansi
macroman ebcdic
4.5.1
\t
\
\f
\n
\r
\t
\v
\\
\xNN \FF
\NNN \377
escapesequence true
p.set_parameter("escapesequence", "true");
fonts/escape_sequences
4.5 99

\x
glyphcheck errorpolicy
4.5.2
fonts/character_references
HTML
www.w3.org/TR/REC-html40/charset.html#h-5.3
&shy;
&euro;
&lt;
&gt;
&amp;
&Alpha;
U+00AD
U+00AD ()
U+00AD
U+00AD
U+00AD
U+0391
&#173;
&#xAD;
&#229;
&#xE5;
&#Xe5;
&#x20AC;
&#8364;
U+00AD
U+00AD
U+00AD a (10)
U+00E5 a (16x)
U+00E5 a (16X)
U+20AC (16)
U+20AC (10)
128 159 10 0x80 0x9F 16 winansi
Unicode
PDFlib
>
>
>
100 4 : Unicode COM .NET REALbasic

&linefeed;
&hortab;
&ZWNJ;
U+000A
U+0009
U+200C
>
>
&.three;
&.mapleleaf;
&.T.swash;
U+0033 3
PUA UnicodeCarta
PUA Unicode2
>
> uniXXXX u1XXXX
charref true
p.set_parameter("charref", "true");
font = p.load_font("Helvetica", "winansi", "");
if (font == -1) { ... }
p.setfont(font, 24);
p.show_xy("Price: 500&euro;", 50, 500);
>
> builtin unicode
> Unichar
&;
charref
> &# &
glyphcheck errorpolicy glyphcheck=none
4.5 101

102 4 : Unicode COM .NET REALbasic

5
5.1
5.1.1 TrueType
TrueType
> *.ttf
> *.ttc
> *.tte
eudcedit.exe
> .dfont
TrueType
TimesNewRomanPSMT Times
New Roman
5.1.2 OpenType
>
*.otf
>
*.ttf
.ttf
5.1 103

5.1.3 PostScript Type 1
PostScript
>
>
>
>
PostScript
> *.pfa *.pfb /FontName
\
>
> FontName
PostScript Windows
AvantGarde-Demi PostScript AvantGarde, Bold Windows
104 5 : COM .NET REALbasic

5.1.4 SING
Smart Independent Glyphlets
Adobe Glyphlet Development Kit (GDK) for SING Gaiji Architecture
www.adobe.com/devnet/opentype/gdk/topic.html
maingid = (int) p.info_font(font, "maingid", "");
uv = (int) p.info_font(font, "unicode", "gid=" + maingid);
load_font( ) fallbackfonts forcechars gaiji
fonts/starter_fallback
www.fontlab.com/font-utility/sigmaker/
5.1.5 Type 3
>
>
>
p.begin_font("Fuzzyfont", 0.001, 0.0, 0.0, 0.001, 0.0, 0.0, "");
p.begin_glyph("circle", 1000, 0, 0, 1000, 1000);
5.1 105

p.arc(500, 500, 500, 0, 360);
p.fill();
p.end_glyph();
p.begin_glyph("ring", 400, 0, 0, 400, 400);
p.arc(200, 200, 200, 0, 360);
p.stroke();
p.end_glyph();
p.end_font();
fonts/starter_type3font fonts/type3_
bitmaptext fonts/type3_rasterlogo fonts/type3_vectorlogo
load_font( )
>
>
x
x glyphname glyphname begin_glyph( )
>
.notdef
.notdef
.notdef
>
mask
> interpolate
>
load_font( )
106 5 : COM .NET REALbasic

5.2 Unicode
5.2.1 ID
.notdef
.notdef
info_font( ) numglyphs
>
>
>
5.2.2 Unicode
Unicode
PUA
info_font( ) unmappedglyphs
>
5.2 Unicode 107

>
TrueType OpenType SING Unicode
cmap cmap load_
font( )
cmap
post
cmap post
Type 1 Unicode
Type 3 Unicode
begin_glyph( ) glyphname
5.2.3 Unicode
1. AGL partners.adobe.com/public/developer/en/opentype/glyphlist.txt
108 5 : COM .NET REALbasic

>
>
&NBSP; &SHY; encoding=glyphid
5.2.4
> unicode
&euro; &#x20AC;
> winansi
> iso8859-1
iso8859-15 iso8859-1
> macroman
macroman macroman_apple
>
>
5.2 Unicode 109

5.3
>
>
>
5.3.1 Unicode
encoding=glyphid
>
> cp932
>
>
>
glyphcheck errorpolicy
glyphid builtin
110 5 : COM .NET REALbasic

5.3.2 Unicode ID
encoding=glyphid
>
> encoding=glyphid replacementchar glyphcheck=replace
glyphcheck=none glyphcheck=error
fallbackfonts forcechars
ID
glyphcheck
> glyphcheck=none .notdef
.notdef
> glyphcheck=replace
> glyphcheck=error errorpolicy=return
add/create_textflow( ) errorpolicy=exception
glyphcheck=replace
>
>
U+00A0 () U+0020 ()
U+00AD () U+002D (-)
U+2010 () U+002D (-)
U+03BC () U+00C5 ()
U+212B () U+00B5 (A)
U+220F () U+03A0 ()
U+2126 () U+03A9 ()
5.3 111

ff
f f
>
A.swash A g.alt g
replacementchar
replacementchar
fonts/glyph_replacement
5.3.3 ID
keepnative=true
vert
OpenType
features
shaping
112 5 : COM .NET REALbasic

5.4
5.4.1
load_font( ) add/
create_textflow( ) fill_textblock( ) fontnameencoding
>
>
>
Unicode encoding=unicode
encoding=unicode
encoding=unicode
font doesn't support encoding
1. www.unicode.org
5.4 113

>
encoding_set_char( )
>
encoding=builtin
> cmap
(3, 0)
>
>
>
info_font( ) symbolfont
false
symbolfont true
encoding=builtin
encoding=unicode
keepnative true
114 5 : COM .NET REALbasic

ID encoding=glyphid
info_font( ) maxcode
encoding=glyphid
5.4.2
> encoding=unicode
>
>
encoding=builtin
encoding=unicode
>
>
>
charmap
5.4 115

info_font( )
encoding=builtin
encoding=unicode
encoding=builtin
5.4.3
load_font( )
fontname
encoding
info_font( ) apiname
load_font( )
>
>
>
> begin_font( )
fonts/font_resources
>
> begin_font( )
>
FontOutline
>
FontAFM FontPFM
>
HostFont
116 5 : COM .NET REALbasic

>
>
Font file (AFM, PFM, TTF, OTF etc.) or host font not found
TrueType OpenType
FontOutline
p.set_parameter("FontOutline", "Arial=/usr/fonts/Arial.ttf");
font = p.load_font("Arial", "unicode", "embedding");
p.set_parameter("FontOutline", "f1=/usr/fonts/Arial.ttf");
font = p.load_font("f1", "unicode", "embedding");
set_parameter( ) FontOutline
SearchPath
SearchPath
p.set_parameter("SearchPath", "/usr/fonts");
p.set_parameter("FontOutline", "f1=Arial.ttf");
font = p.load_font("f1", "unicode", "");
TrueType
p.set_parameter("FontOutline", "MS-Gothic=msgothic.ttc");
font = p.load_font("MS-Gothic", "unicode", "embedding");
n n
p.set_parameter("FontOutline", "f1=msgothic.ttc");
font = p.load_font("f1:0", "unicode", "");
5.4 117

PostScript Type 1
FontAFM
FontPFM
p.set_parameter("FontPFM", "lucidux=LuciduxSans.pfm");
font = p.load_font("lucidux", "unicode", "embedding");
FontOutline
p.set_parameter("FontPFM", "lucidux=LuciduxSans.pfm");
p.set_parameter("FontOutline", "lucidux=LuciduxSans.pfa");
font = p.load_font("lucidux", "unicode", "embedding");
FontOutline
SearchPath
Courier Courier-Bold Courier-Oblique Courier-BoldOblique
Helvetica Helvetica-Bold Helvetica-Oblique Helvetica-BoldOblique
Times-Roman Times-Bold Times-Italic Times-BoldItalic
Symbol ZapfDingbats
embedding FontOutline
font = p.load_font("Times-Roman", "unicode", "");
font = p.load_font("Verdana", "unicode", "");
118 5 : COM .NET REALbasic

font = p.load_font("Verdana,Bold", "unicode", "");
HostFont
p.set_parameter("HostFont", "Symbol=Symbol");
font = p.load_font("Symbol", "unicode", "embedding");
SearchPath
>
.tte .ttf .otf .gai .afm .pfm .ttc
.TTE .TTF .OTF .GAI .AFM .PFM .TTC
>
.pfa .pfb
.PFA .PFB
Font cannot be embedded (PFA or PFB font file not found)
> SearchPath
p.set_parameter("FontOutline", "Arial=/usr/fonts/Arial.ttf");
font = p.load_font("Arial", "unicode", "");
5.4 119

p.set_parameter("SearchPath", "/usr/fonts");
font = p.load_font("Arial", "unicode", "");
>
>
> embedding
font = p.load_font("KozGoPro-Medium", "90msp-RKSJ-H", "");
Type 3
begin_font( ) load_font( )
p.begin_font("PDFlibLogoFont", 0.001, 0.0, 0.0, 0.001, 0.0, 0.0, "");
...
p.end_font();
...
font = p.load_font("PDFlibLogoFont", "logoencoding", "");
5.4.4 Windows Mac OS X
Windows
Bold
Fett
Arial Fett
Arial Bold
120 5 : COM .NET REALbasic

,Bold
Font properties
extension
Windows
font = p.load_font("Verdana,Bold", "unicode", "");
none, thin, extralight, ultralight, light, normal, regular, medium,
semibold, demibold, bold, extrabold, ultrabold, heavy, black
italic
font = p.load_font("Verdana,Bold,Italic", "unicode", "");
0 (none), 100 (thin), 200 (extralight), 300 (light), 400 (normal), 500 (medium), 600
(semibold), 700 (bold), 800 (extrabold), 900 (black)
font = p.load_font("Verdana,700", "unicode", "");
Windows
Windows fontstyle
Windows
1. www.microsoft.com/typography/TrueTypeProperty21.mspx
5.4 121

...
Fonts
Fonts
Fonts
Mac Font Book
ftxinstalledfonts
>
ftxinstalledfonts -q
>
ftxinstalledfonts -u
>
ftxinstalledfonts -p
PDFlib Leopard Mac OS X 10.5 3
Leopard QuickDraw
Mac
1. developer.apple.com/textfonts/download
122 5 : COM .NET REALbasic

5.4.5
text_output/starter_fallback
>
>
>
>
fallbackfonts
fallbackfonts load_font( )
fallbackfonts
info_font( )
>
> fallbackfonts
>
> shaping script locale
features script language
5.4 123

fit_textline( ) add/create_textflow( )
underlineposition underlinewidth
fallbackfonts
fallbackfonts={{fontname=Symbol encoding=unicode}}
fallbackfonts
fallbackfonts={
{fontname=Times-Greek encoding=unicode embedding forcechars={U+0391-U+03F5}}
{fontname=Times-Cyrillic encoding=unicode embedding forcechars={U+0401-U+0490}}
}
8
fallbackfonts
fallbackfonts={{fontname=Helvetica encoding=unicode forcechars=euro}}
&euro;
fallbackfonts
124 5 : COM .NET REALbasic

fallbackfonts={{fontname=Helvetica encoding=unicode forcechars=euro textrise=-5%}}}
textrise
fallbackfonts
fallbackfonts={
{fontname=Times-Italic encoding=unicode forcechars={U+0020-U+00FF} fontsize=120%}
}
fallbackfonts
fallbackfonts={
{fontname=ZapfDingbats encoding=unicode forcechars=.a12 fontsize=150% textrise=-15%}
}
fontsize textrise
fallbackfonts
fallbackfonts={
{fontname=Courier-Bold encoding=unicode forcechars={U+0020-U+007E}}
}
Unicode BMP Fallback SIL
fallbackfonts
fallbackfonts={{fontname={Unicode BMP Fallback SIL} encoding=unicode}}
5.4 125

5.5
5.5.1
Acrobat PDF
AdobeSansMM AdobeSerifMM
PDFlib
embedding
font = p.load_font("WarnockPro", "winansi", "embedding");
optimizeinvisible
embedding=true
embedding=true
126 5 : COM .NET REALbasic

5.5.2
>
>
>
autosubsetting
> autosubsetting
true
true
> autosubsetting=true subsetlimit
1. OS/2 fsType 2
5.5 127

p.set_value("subsetlimit", 75); /* 75% */
subsetlimit
load_font( )
> autosubsetting=true subsetminsize
subsetminsize
TrueType winansi
macroman
autocidfont
false
load_font( ) initialsubset
initialsubset={U+0020-U+00FF}
begin_document( ) optimize
Type 3
128 5 : COM .NET REALbasic

egin_font( ) widthsonly
begin_
font( ) begin_glyph( ) wx
begin_glyph( ) end_glyph( )
>
load_font( )
fonts/type3_subsetting
5.5 129

5.6
info_font( )
info_font( )
int uv;
int c;
int gid;
int cid;
String gn;
int gn_idx;
String enc;
int font;
unicode=euro
gn_idx
gn = p.get_parameter("string", gn_idx);
load_font( )
info_font( )
5.6.1 Unicode
info_font( ) font gn
c = (int) p.info_font(-1, "code", "unicode=" + uv + " encoding=" + enc);
c = (int) p.info_font(-1, "code", "glyphname=" + gn + " encoding=" + enc);
uv = (int) p.info_font(-1, "unicode", "code=" + c + " encoding=" + enc);
uv = (int) p.info_font(-1, "unicode", "glyphname=" + gn + " encoding=" + enc);
130 5 : COM .NET REALbasic

gn_idx = (int) p.info_font(-1, "glyphname", "code=" + c + " encoding=" + enc);
gn_idx = (int) p.info_font(-1, "glyphname", "unicode=" + uv + " encoding=" + enc);
/* */
gn = p.get_parameter("string", gn_idx);
Unicode info_font( )
uv = (int) p.info_font(-1, "unicode", "glyphname=" + gn + " encoding=unicode");
gn_idx = (int) p.info_font(-1, "glyphname", "unicode=" + uv + " encoding=unicode");
/* */
gn = p.get_parameter("string", gn_idx);
5.6.2 Unicode
gn
c = (int) p.info_font(font, "code", "unicode=" + uv);
c = (int) p.info_font(font, "code", "glyphid=" + gid);
c = (int) p.info_font(font, "code", "glyphname=" + gn);
c = (int) p.info_font(font, "code", "cid=" + cid);
uv = (int) p.info_font(font, "unicode", "code=" + c);
uv = (int) p.info_font(font, "unicode", "glyphid=" + gid);
uv = (int) p.info_font(font, "unicode", "glyphname=" + gn);
uv = (int) p.info_font(font, "unicode", "cid=" + cid);
gid = (int) p.info_font(font, "glyphid", "code=" + c);
gid = (int) p.info_font(font, "glyphid", "unicode=" + uv);
gid = (int) p.info_font(font, "glyphid", "glyphname=" + gn);
gid = (int) p.info_font(font, "glyphid", "cid=" + cid);
gid = (int) p.info_font(font, "glyphid", "code=" + c + " encoding" + enc);
gid = (int) p.info_font(font, "glyphid", "unicode=" + uv + " encoding=" + enc);
gid = (int) p.info_font(font, "glyphid", "glyphname=" + gn + " encoding=" + enc);
5.6 131

gn_idx = (int) p.info_font(font, "glyphname", "code=" + c);
gn_idx = (int) p.info_font(font, "glyphname", "unicode=" + uv);
gn_idx = (int) p.info_font(font, "glyphname", "glyphid=" + gid);
gn_idx = (int) p.info_font(font, "glyphname", "cid=" + cid);
/* */
gn = p.get_parameter("string", gn_idx);
info_font( )
/* "unicode=U+20AC" */
if (p.info_font(font, "code", "unicode=euro") == -1)
{
/* */
}
fonts/glyph_availability
info_textline( )
String optlist = "font=" + font + " charref";
if (p.info_textline("&euro;", "unmappedchars", optlist) == 1)
{
/* */
}
5.6.3
info_font( )
String cp="cp1254";
result = (int) p.info_font(font, "codepage", "name=" + cp);
132 5 : COM .NET REALbasic

if (result == -1)
System.err.println("");
else if (result == 0)
System.err.println("");
else
System.err.println("");
cp_idx = (int) p.info_font(font, "codepagelist", "");
if (cp_idx == -1)
System.err.println("");
else
{
System.err.println(":");
System.err.println(p.get_parameter("string", cp_idx));
}
cp1252 cp1250 cp1251 cp1253 cp1254 cp1255 cp1256 cp1257 cp1258 cp874 cp932 cp936 cp949
cp950 cp1361
info_font( )
result = p.info_font(basefont, "fallbackfont", "unicode=U+03A3");
/* result== */
if (result == -1)
{
/* */
}
else
{
idx = p.info_font(result, "fontname", "api");
fontname = p.get_parameter("string", idx);
}
5.6 133

134 5 : COM .NET REALbasic

6
6.1
> show( )
> fit_textline( )
> fit_textflow( )
>
show( )
font = p.load_font("Helvetica", "unicode", "");
p.setfont(font, 12);
p.set_text_pos(50, 700);
p.show("Hello world!");
p.continue_text("(says Java)");
fit_textline( )
load_font( )
p.fit_textline(text, x, y, "fontname=Helvetica encoding=unicode fontsize=12");
fit_textflow( )
tf = p.add_textflow(tf, text, optlist);
result = p.fit_textflow(tf, llx, lly, urx, ury, optlist);
p.delete_textflow(tf);
6.1 135

136 6 : COM .NET REALbasic

6.2
6.2.1
textx/texty currentx/currenty
leading
capheight T H
xheight x
ascender f d
descender j p
xheight capheight
ascender descender
gaplen
gaplen
info_font( ) faked xheight
font = p.load_font("Times-Roman", "unicode", "");
capheight = p.info_font(font, "capheight", "");
ascender = p.info_font(font, "ascender", "");
6.1
font size
capheight
ascender
baseline
descender
6.2 137

descender = p.info_font(font, "descender", "");
xheight = p.info_font(font, "xheight", "");
PDFlib
fonts/font_metrics_info
CPI
12 600 1000 7.2
6.2.2
6.2
138 6 : COM .NET REALbasic

load_font( ) readkerning false
> kerning
features={tnum}
6.2.3
Adobe Acrobat PDF
>
> winansi macroman
> embedding false
>
load_font( ) fontstyle
normal bold italic bolditalic
6.2 139

font = p.load_font("HeiseiKakuGo-W5", "UniJIS-UCS2-H", "fontstyle bold");
fontstyle
fonts/artificial_fontstyles
fontstyle
fakebold
fonts/simulated_fontstyles
fontstyle italicangle
italicangle
italicangle
italicangle
PDFlib
fit_textline( )
shadow
set_parameter( )
underlineoverlinestrikeout
underlineposition underlinewidth
140 6 : COM .NET REALbasic

text_output/starter_textline
PDFlib
API textrendering
output/invisible_text
text_output/text_as_clipping_path text_
setcolor( )
text_output/starter_textline
6.2 141

6.3 OpenType
text_output/starter_opentype
6.3.1 OpenType
liga f f i
smcp
onum
www.microsoft.com/typography/developers/opentype/default.htm
> features
>
features
>
shaping script
vert vertical
>
readkerning kerning
www.microsoft.com/typography/otspec/featuretags.htm
OpenType
>
www.fontlab.com
> www.fonttools.org
>
> info_font( )
1. www.microsoft.com/typography/TrueTypeProperty21.mspx
142 6 : COM .NET REALbasic

_none
afrc
c2pc
c2sc
case
dlig
dnom
frac
hist
hlig
liga
lnum
locl
script language
mgrk
numr
onum
ordn
ornm
pcap
pnum
salt
6.3 OpenType 143

sinf
smcp
ss01
...
ss20
salt
subs
sups
swsh
titl
tnum
unic
zero
6.3.2 OpenType
show( )
OpenType
> *.ttf *.otf *.ttc
>
> encoding=unicode glyphid
> load_font( ) readfeatures false
> load_font( ) fallbackfonts
PDFlib GSUB 1 4 OpenType
PDFlib GPOS OpenType
144 6 : COM .NET REALbasic

6.3
Microsoft font property extension
OpenType
> features script language
>
OpenType
features no
ffi

f+i Schilfinsel
features
&zwnj features
f+i
Schilf&zwnj;insel
OpenType
features script language
f i
i i
fi
fi
locl liga
:
&#x0431;
:
&#x0662;&#x0663;&#x0664;&#x0665;
OpenType
146 6 : COM .NET REALbasic

features
shaping script language
OpenType info_font( )
result = (int) p.info_font(font, "featurelist", "");
if (result != -1)
{
/* */
featurelist = p.get_parameter("string", result);
}
else
{
/* */
}
liga
result = (int) p.info_font(font, "feature", "name=liga");
if (result == 1)
{
/* PDFlib */
}
6.3 OpenType 147

6.4
scripts/starter_shaping
6.4.1
>
>
>
>
>
>
shaping
script language
shaping script=arab
> shapingscript
> shaping script language
>
148 6 : COM .NET REALbasic

script
_none
_latn _none
_auto
latn
grek
cyrl
arab
hebr
syrc
thaa
deva
beng
guru
gujr
orya
taml
telu
knda
mlym
thai
lao
khmr
hani
hira
kana
hang
www.microsoft.com/typography/developers/OpenType/scripttags.aspx
1.
6.4 149

>
> encoding=unicode glyphid
> load_font( ) monospacevertical readshaping
> load_font( ) fallbackfonts
6.4.2
> script
script=latn
script=cyrl
script=arab
script=hebr
script=deva
script={lao }
script=_auto
info_textline( ) scriptlist
> language
language=ARA
language=URD
language=ZHS
language=HIN
shaping script
language
script language
150 6 : COM .NET REALbasic

OpenType
script language
liga script language
206 8.2.9
language
locale locale
language
_none FIN NEP
AFK FRA ORI
SQI GAE PAS
ARA DEU PLK
HYE ELL PTG
ASM GUJ ROM
EUQ HAU RUS
BEL IWR SAN
BEN HIN SRB
BGR HUN SND
CAT IND SNH
CHE ITA SKY
ZHP JAN SLV
ZHS KAN ESP
ZHT KSH SVE
COP KHM SYR
HRV KOK TAM
CSY KOR TEL
DAN MLR THA
NLD MAL TIB
DZN MTS TRK
ENG MNI URD
ETI MAR WEL
FAR MNG JII
6.4 151

6.4.3
6.4.4
complex_scripts/bidi_formatting
script
1. www.unicode.org/unicode/reports/tr9/
152 6 : COM .NET REALbasic

>
>
>
>
position={right center}
>
leader={alignment=left text=.}
> begin/end_document( )
viewerpreferences={direction=r2l}
> info_textline( ) startx/startyendx/endy
> info_textline( ) writingdirx
> info_textline( )position auto
6.4 153

oxsize={width 0} position={auto bottom}
6.4.5
complex_scripts/arabic_formatting
> rlig
script=arab shaping
> liga dlig
features={liga}
script shaping feature
shaping script=arab features={liga}
script
&#x0623;&#x064A;&ZWNJ;&#x0628;&#x064A;&ZWNJ;&#x0625;&#x0645;
fallbackfonts
154 6 : COM .NET REALbasic

fallbackfonts
fallbackfonts={
{fontname=Helvetica encoding=unicode forcechars={U+0021-U+00FF}}
}
6.4 155

6.5
6.5.1
Unicode
encoding=unicode
CMap UCS2 UTF16
Acrobat
139 6.2.3
keepnative=true
keepnative=true
keepnative
keepnative=false
>
-H
-V
156 6 : COM .NET REALbasic

vertical
>
PDFlib
continue_text( )
load_font( )
encoding
KozMinPro-Regular-Acro
font = p.load_font("KozMinPro-Regular-Acro", "UniJIS-UCS2-H", "");
if (font == -1) { ... }
p.setfont(font, 24);
p.set_text_pos(50, 500);
p.show("\u65E5\u672C\u8A9E");
Ext-RKSJ
H fontname
encoding
load_font( ) monospace
font = p.load_font("KozMinPro-Regular-Acro", "UniJIS-UCS2-H", "monospace=1000");
monospace
6.5.2
PDFlib GmbH MS MS www.pdflib.com
PDFlib
> embedding true
6.5 157

load_font( )
> keepnative false
keepnative=false
keepnative=true embedding=true
Unicode
font = p.load_font("Arial Unicode MS", "unicode", "");
p.setfont(font, 24);
p.set_text_pos(50, 500);
p.show("\u4e00\u500b\u4eba");
TrueType Collection TTC
msgothic.ttc
load_font( )
msgothic:0 MS Gothic msgothic:
msgothic:1 MS PGothic
msgothic:2 MS UI Gothic
msgothic
msgothic.ttc
p.set_parameter("FontOutline", "msgothic=msgothic.ttc");
6.5.3 EUDC SING
*.tte *.gai
158 6 : COM .NET REALbasic

fallbackfonts
fallbackfonts
fallbackfonts={
{fontname=EUDC encoding=unicode forcechars=U+E000 fontsize=140% textrise=-20%}
}
fallbackfonts={
{fontname=PDFlibWing encoding=unicode forcechars=gaiji}
}
EUDC
> eudcedit.exe
> \Windows\fonts EUDC.TTE
dir copy
p.set_parameter("FontOutline", "EUDC=EUDC.TTE");
p.set_parameter("SearchPath", "......");
EUDC.TTE
p.set_parameter("FontOutline", "EUDC=C:\Windows\fonts\EUDC.TTE");
> fallbackfonts
font = p.load_font("EUDC", "unicode", "");
6.5.4 OpenType
6.5 159

vert load_font( ) vertical
expt
fwid
hkna
hngl
hojo
hwid
ital
jp04 nlck
jp78
jp83
jp90
locl
script language
nalt
nlck
pkna
pwid
qwid
ruby
smpl
160 6 : COM .NET REALbasic

tnam trad
trad
twid
vert
vkna
vrt2
vrt2 vert
6.5 161

162 6 : COM .NET REALbasic

7 PDF
PDFlib images
7.1
7.1.1
load_image( )
fit_image( )
image = p.load_image("auto", "image.jpg", "");
if (image == -1)
throw new Exception("" + p.get_errmsg());
p.fit_image(image, 0.0, 0.0, "");
p.close_image(image);
fit_image( )
images/starter_image
fit_image( )
dpi
images/image_dimensions
7.1 163

load_image( )
load_
image( ) page
image = p.load_image("tiff", filename, "page=2");
page
load_image( )
TIFF PDF
images/multi_page_tiff
load_image( ) inline
inline load_
image( )
p.fit_image(image, 0, 0, "");
p.close_image(image);
imagetype=ccitt jpeg raw
inline
OPI
load_image( )
String optlist13 =
"OPI-1.3 { ALDImageFilename bigfile.tif " +
"ALDImageDimensions {400 561} " +
"ALDImageCropRect {10 10 390 550} " +
"ALDImagePosition {10 10 10 540 390 540 390 10} }";
image = p.load_image("tiff", filename, optlist13);
164 7 : PDF COM .NET REALbasic

Helios EtherShare OPI PDF XObject
OPI PDFlib XObject
load_image( ) template
XObject
XMP
load_image( )
metadata={keepxmp=false}
7.1.2
Read less image data than expected
load_image( ) passthrough
load_image( )
get_errmsg( )
PNG
JPEG
load_image( )
passthrough
>
>
>
>
>
7.1 165

honoriccprofile
false iccprofile
JPEG 2000
> *.jp2 *.jpf
>
*.j2k
> mask
> iccprofile
honoriccprofile true
JBIG2
load_image( )
> load_
image( )
page=1 copyglobals=all
>
load_image( )
page=2 imagehandle=
copyglobals/imagehandle
copyglobals
166 7 : PDF COM .NET REALbasic

GIF
TIFF
>
>
>
>
>
ignoreorientation true
ignoreclippingpath
BMP
>
>
>
>
>
CCITT
load_
image( )
RAW
7.1 167

7.1.3
load_
image( ) clippingpathname
load_
image( ) honorclippingpath false
fit_image( ) ignoreclippingpath
images/integrated_clipping_path
7.1.4
>
>
7.1
168 7 : PDF COM .NET REALbasic

image = p.load_image("tiff", filename, "alphachannelname={apple}");
>
>
Photoshop
PDFlib PDFlib
Photoshop TIFF TIFF
ignoremask
image = p.load_image("tiff", filename, "ignoremask");
>
> load_image( ) nopassthrough
>
masked
mask = p.load_image("png", maskfilename, "");
if (mask == -1)
throw new Exception("" + p.get_errmsg());
String optlist = "masked=" + mask;
image = p.load_image(type, filename, optlist)
if (image == -1)
throw new Exception("" + p.get_errmsg());
p.fit_image(image, x, y, "");
PDFlib TIFF PDF
7.1 169

images/image_mask
>
>
>
>
x
>
mask
mask = p.load_image("tiff", maskfilename, "mask");
p.setcolor("fill", "rgb", 1.0, 0.0, 0.0, 0.0);
if (mask != -1)
{
p.fit_image(mask, x, y, "");
}
colorize
7.1.5
colorize
makespotcolor( )
p.setcolor("fillstroke", "cmyk", 1, .79, 0, 0);
spot = p.makespotcolor("PANTONE Reflex Blue CV");
170 7 : PDF COM .NET REALbasic

String optlist = "colorize=" + spot;
image = p.load_image("tiff", "image.tif", optlist);
if (image != -1)
{
p.fit_image(image, x, y, "");
}
7.1 171

7.2 PDI PDF
PDFlib+PDI PDF
PDI PDFlib PDI PDFlib
PDI PPS PPS PDI
7.2.1 PDI
>
>
>
>
>
>
>
>
>
7.2.2 PDFlib PDI
PDF PDFlib pdf_import
172 7 : PDF COM .NET REALbasic

PDF
int doc, page, pageno = 1;
String filename = "input.pdf";
if (p.begin_document(outfilename, "") == -1) {...}
...
doc = p.open_pdi_document(infilename, "");
if (doc == -1)
throw new Exception("" + p.get_errmsg());
page = p.open_pdi_page(doc, pageno, "");
if (page == -1)
throw new Exception("" + p.get_errmsg());
/* adjustpage */
p.begin_page_ext(20, 20, "");
p.fit_pdi_page(page, 0, 0, "adjustpage");
p.close_pdi_page(page);
...PDFlib...
p.end_page_ext("");
p.close_pdi_document(doc);
fit_pdi_page( )
PDF
fit_pdi_page( )
7.2 PDI PDF 173

>
cloneboxes
pdiusebox
PDF
GeoPDF PDI
> load_image( ) georeference
>
> begin/end_page_ext( ) viewports
>
OPI PDF
begin_document( ) optimize
7.2.3 PDF
open_pdi_document( ) open_pdi_
page( ) get_
errmsg( ) errorpolicy
true
174 7 : PDF COM .NET REALbasic

infomode
true
>
begin_document( )
compatibility
> infomode
> begin_document( ) tagged true
>
7.2 PDI PDF 175

7.3 PDF
fit_image( )
fit_pdi_page( )
PDFlib API
load_
image( ) fit_
image( )
open_pdi_page( ) fit_pdi_page( )
fit
load_image( ) open_pdi_document( ) open_pdi_
page( )
PDF PDFlib imagespdf_
import
7.3.1
(0, 0)
p.fit_image(image, 0, 0, "position={center bottom}");
position left right center top bottom
p.fit_image(image, 0, 0, "scale=0.5");
(0, 0)
x y
images/starter_image
7.3.2
176 7 : PDF COM .NET REALbasic

(0, 0)
7.2
fit_image
a) boxsize={70 45} position={right top}
b) boxsize={70 45} position={center bottom}
(0, 0)
position=center boxsize={70 45}
fitmethod=meet
fitmethod=meet
fitmethod=entire
fitmethod=clip
position={right top}
7.3 PDF 177

7.3
fit_image
a) boxsize={70 45} position=center
b) boxsize={35 45} position=center
c) boxsize={70 45} position=center fitmethod=meet
d) boxsize={35 45} position=center fitmethod=meet
e) boxsize={70 45} position=center fitmethod=entire
f) boxsize={30 30} position=center fitmethod=clip
g) boxsize={30 30} position={right top} fitmethod=clip
p.fit_image(image, 0, 0, "boxsize={595 842} position={left bottom} fitmethod=slice");
fitmethod=slice
fitmethod=clip
position fitmethod
7.3.3
orientate=west
(0, 0)
178 7 : PDF COM .NET REALbasic

7.4
rotate
7.5
orientate
fitmethod=meet
orientate=west
orientate north east
west south
orientate
7.6
fit_image
a) boxsize={70 45} orientate=west
b) boxsize={70 45} orientate=west fitmethod=meet
c) boxsize={70 45} orientate=east fitmethod=meet
d) boxsize={70 45} orientate=south fitmethod=meet
e)
boxsize={70 45} position={center bottom} orientate=east
fitmethod=clip
7.3 PDF 179

orientate=east
position={center bottom}
fitmethod=clip
7.3.4
(50, 0)
rotate
fitmethod=meet
7.7
fit_image
a) boxsize={70 45} rotate=90
(x, y)
b) boxsize={70 45} rotate=30
(x, y)
c) boxsize={70 45} rotate=90 fitmethod=meet
(x, y)
d) boxsize={70 45} rotate=30 fitmethod=meet
(x, y)
180 7 : PDF COM .NET REALbasic

7.8
7.3.5
(x, y)
p.fit_image(image, 0, 0, "adjustpage");
x y
p.fit_image(image, 40, 40, "adjustpage");
x y
p.fit_image(image, -40, -40, "adjustpage");
x y
boxsize fitmethod position
PDF
cloneboxes open_pdi_page( )
fit_pdi_page( )
/* */
inpage = p.open_pdi_page(indoc, 1, "cloneboxes");
...
/* */
p.begin_page_ext(10, 10, "");
...
/*
*
* begin_page_ext()
*
*/
p.fit_pdi_page(inpage, 0, 0, "cloneboxes");
7.3 PDF 181

7.3.6 PDF
info_image( )
String optlist = "boxsize={300 400} fitmethod=meet orientate=west";
p.fit_image(image, 0.0, 0.0, optlist);
imagewidth = (int) p.info_image(image, "imagewidth", optlist);
imageheight = (int) p.info_image(image, "imageheight", optlist);
System.err.println(": " + imagewidth + " x " + imageheight);
width = p.info_image(image, "width", optlist);
height = p.info_image(image, "height", optlist);
System.err.println(": " + width + " x " + height);
PDF info_pdi_page( )
String optlist = "boxsize={400 500} fitmethod=meet";
p.fit_pdi_page(page, 0, 0, optlist);
pagewidth = p.info_pdi_page(page, "pagewidth", optlist);
pageheight = p.info_pdi_page(page, "pageheight", optlist);
System.err.println(": " + pagewidth + " x " + pageheight);
width = p.info_pdi_page(page, "width", optlist);
height = p.info_pdi_page(page, "height", optlist);
System.err.println(": " + width + " x " + height);
182 7 : PDF COM .NET REALbasic

8
8.1
fit_textline( )
PDFlib API
fit_textline( ) fit_image( )
fit_textline( )
fit_textline( )
matchbox
fit_textline( ) x y
fit_textline( )
x y boxsize position rotate
margin
PDFlib text_output
8.1.1
(30, 20)
p.fit_textline(text, 30, 20, "position={center bottom}");
left right
center top bottom position
˚
(0, 0)
8.1
y
Kraxi
y
Kraxi
8.2
x
x
8.1 183

20
Kraxi 5022
20 Kraxi 500
30
20
8.3
p.fit_textline(text, 0, 0, "orientate=west");
8.1.2
(30, 20)
margin
8.4
fit_textline( )
Kraxi
a) boxsize={50 22} position={right top}
b) boxsize={50 22} position={center bottom}
Kraxi
Kraxi
c) boxsize={50 22} position={center bottom} margin={0 3}
d) boxsize={50 0} position={center bottom}
Kraxi
Kraxi
e) boxsize={0 35} position={left center} orientate=west
184 8 : COM .NET REALbasic

8.1.3
fitmethod=auto
auto shrinklimit
meet meet
fitmethod=meet
fitmethod=entire
fitmethod=clip
8.1 185

8.5
fit_textline( )
Kraxi Systems
a) boxsize={100 35} position=center fontsize=12
Kraxi Systems
b) boxsize={50 35} position=center fontsize=12
c)
Kraxi Systems
boxsize={100 35} position=center fontsize=12
fitmethod=auto
d)
Kraxi Systems
boxsize={58 35} position=center fontsize=12
fitmethod=auto
e)
Kraxi Systems
boxsize={30 35} position=center fontsize=12
fitmethod=auto
f)
Kraxi Systems
boxsize={100 35} position=center fontsize=12
fitmethod=meet
g)
Kraxi Systems
boxsize={100 35} position=center fontsize=12
fitmethod=entire
h)
Kraxi Sys
boxsize={50 35} position={left center}
fontsize=12 fitmethod=clip
fit_textline( )
H
fit_textline( ) matchbox
boxheight
boxheight
matchbox={boxheight={capheight none}}
xheight
186 8 : COM .NET REALbasic

oxheight
8.6
fit_textline( )
Kraxi Systems
a) boxsize={80 20} position=center fitmethod=auto
b)
c)
d)
e)
f)
Kraxi Systems
Kraxi Systems
Kraxi Systems
Kraxi Systems
Kraxi Systems
boxsize={80 20} position=center fitmethod=auto
matchbox={boxheight={capheight none}
fillcolor={rgb 1 0.8 0.8}}
boxsize={80 20} position=center fitmethod=auto
matchbox={boxheight={xheight none}
fillcolor={rgb 1 0.8 0.8}}
boxsize={80 20} position=center fitmethod=auto
matchbox={boxheight={ascender none}
fillcolor={rgb 1 0.8 0.8}}
boxsize={80 20} position=center fitmethod=auto
matchbox={boxheight={ascender descender}
fillcolor={rgb 1 0.8 0.8}}
boxsize={80 20} position=center fitmethod=auto
matchbox={boxheight={fontsize none}
fillcolor={rgb 1 0.8 0.8}}
8.1.4
fit_textline( ) alignchar=.
position
position={left bottom}
8.7
fit_textline( )
127.123
a)
12.01
123.0
boxsize={70 8} position={center bottom} alignchar=.
4025.20
127.123
b)
12.01
123.0
boxsize={70 8} position={left bottom} alignchar=.
4025.20
8.1.5
text_output/simple_stamp
8.1 187

fit_textline( ) stamp
stamp=ll2ur
stamp=ul2lr
showborder=true
8.8
Giant Wing
8.1.6
fit_textline( )
fontsize=8 boxsize={160 50} stamp=ll2ur showborder=true
fit_textline( ) leader alignment={none right}
text_output/leaders_in_textline
text_output/dot_leaders_with_tabs
alignment={left right}
8.9
fit_textline( )
a)
Features of Giant Wing ....................................................
Description of Long Distance Glider.................................
Benefits of Cone Head Rocket .........................................
boxsize={200 10}
leader={alignment={none right}}
188 8 : COM .NET REALbasic

Long Distance Glider with sensational range!
fit_textline( )
b)
+ + + + + + + + + Giant Wing in purple! + + + + + + + + +
+ + Long Distance Glider with sensational range! + +
+ + + + + Cone Head Rocket incredibly fast! + + + + +
boxsize={200 10}
position={center bottom}
leader={alignment={left right}
text={+ }}
8.1.7
fit_textline( ) textpath
add_path_point( )
/* */
path = p.add_path_point( -1, 0, 0, "move", "");
path = p.add_path_point(path, 100, 100, "control", "");
path = p.add_path_point(path, 200, 0, "circular", "");
/* */
p.fit_textline("Long Distance Glider with sensational range!", x, y,
"textpath={path=" + path + "} position={center bottom}");
/* */
p.draw_path(path, x, y, "stroke");
text_output/text_on_a_path
honorclippingpath
clippingpathname load_image( )
8.10
8.1 189

Long Distance Glider with sensational range!
image = p.load_image("auto", "image.tif", "clippingpathname={path 1}");
/* */
path = (int) p.info_image(image, "clippingpath", "");
if (path == -1)
throw new Exception(" : !");
/* */
p.fit_textline("Long Distance Glider with sensational range!", x, y,
"textpath={path=" + path + "} position={center bottom}");
matchbox
boxheight
p.fit_textline("Long Distance Glider with sensational range!", x, y,
"textpath={path=" + path + "} position={center bottom} " +
"matchbox={boxheight={capheight descender}}");
8.11
190 8 : COM .NET REALbasic

8.2
Kraxi Systems, Inc.
Paper Planes
17, Aviation Road
Paperfield
Phone 7079-4301
Fax 7079-4302
info@kraxi.com
www.kraxi.com
Kraxi Systems, Inc. 17, Aviation Road Paperfield
John Q. Doe
255 Customer Lane
Suite B
12345 User Town
Everland
INVOICE 14.03.2004
hortabmethod ruler
tabalignment right left right right right
ruler 30 45 275
375
475
8.12
ITEM DESCRIPTION QUANTITY PRICE AMOUNT
1 Super Kite 2 20,00 40,00
2 Turbo Flyer 5 40,00 200,00
3 Giga Trash 1 180,00 180,00
4 Bare Bone Kit 3 50,00 150,00
5 Nitty Gritty 10 20,00 200,00
6 Pretty Dark Flyer 1 75,00 75,00
7 Free Gift 1 0,00 0,00
845,00
leftindent
=55
parindent
=7%
leading
= 140%
leftindent = 75
leftindent = 105
Terms of payment: 30 days net. 30 days warranty starting at theday ofsale. This
warranty covers defects in workmanship only. Kraxi Systems, Inc., at its option, repairs or
replaces the product under warranty. This warranty is not transferable. Returns or
exchanges are not possible for wet products.
Have a look at our new paper plane models!
Our paper planes are the ideal way of passing the time. We offer revolutionary
new developments of the traditional common paper planes. If your lesson,
conference, or lecture turn out to be deadly boring, you can have a wonderful time
with our planes. All our models are folded from one paper sheet.
They are exclusively folded without using any adhesive. Several models are
equipped with a folded landinggear enabling a safe landing on the intended location
provided that you have aimed well. Other models are able to fly loops or cover long
distances. Let them start from a vista point in the mountains and see where they
touch the ground.
1. Long Distance Glider
With this paper rocket you can send all your messages even when
sitting in a hall or in the cinema pretty near theback.
2. Giant Wing
An unbelievable sailplane! It is amazingly robust and can evendo
alignment
= left
alignment
= justify
rightindent
=60
minlinecount
=2
8.2 191

add_textflow( )
create_textflow( )
> fit_textflow( )
> delete_textflow( )
add/create_textflow( )
create_textflow( )
info_textflow( )
PDFlib API
add/create_textflow( ) fit_textline( )
PDFlib text_output
aerobatics. But itisbest suited to gliding.
fillcolor, charspacing,
fontsize, fontname
3. C one Head R ocket
This paper arrow can be thrown with big swing. We launched it from
theroofofa hotel. It stayed in the air a long time and covered a
considerable distance.
4. Super Dart
The super dart can fly giant loops with a radius of 4 or 5 meters and
cover very long distances. Its heavy cone point is slightly bowed
upwards to get the lift required for loops.
5. German Bi-Plane
Brand-new and ready for take-off. If you have lessons in the history of
aviation you can show your interest by letting it land on yourteacher's
desk.
8.13
192 8 : COM .NET REALbasic

8.2.1
fit_textflow( )
llx lly urx ury
add_
textflow( )
add_textflow( )
add_textflow( )
text1 text2
fit_textflow( )
/* */
tf = p.add_textflow(-1, text1, "fontname=Helvetica-Bold fontsize=9 encoding=unicode");
if (tf == -1)
throw new Exception("" + p.get_errmsg());
/* */
tf = p.add_textflow(tf, text2, "fontname=Helvetica fontsize=9 encoding=unicode");
if (tf == -1)
throw new Exception("" + p.get_errmsg());
/* Place all text */
result = p.fit_textflow(tf, left_x, left_y, right_x, right_y, "");
if (!result.equals("_stop"))
{ /* ... */}
p.delete_textflow(tf);
fit_textflow( )
_boxfull
text_output/starter_textflow
/*
* 2
*/
do
{
String optlist = "verticalalign=justify linespreadlimit=120%";
p.begin_page_ext(0, 0, "width=a4.width height=a4.height");
/* 1 */
result = p.fit_textflow(tf, llx1, lly1, urx1, ury1, optlist);
/* 2 */
8.2 193

if (!result.equals("_stop"))
result = p.fit_textflow(tf, llx2, lly2, urx2, ury2, optlist);
p.end_page_ext("");
/* _boxfull
* _nextpage
*/
} while (result.equals("_boxfull") || result.equals("_nextpage"));
/* */
if (!result.equals("_stop"))
{
/* _boxempty
*/
if (result.equals( "_boxempty"))
throw new Exception("" + p.get_errmsg());
else
{
/* return
*
*/
}
}
p.delete_textflow(tf);
8.2.2
add_textflow( )
add_textflow( )
1 2 3 4
1 2
1 Lorem ipsum dolor sit amet, consectetur
adipisicing elit, sed do eiusmod tempor
incididunt ut labore et dolore magna aliqua.
Ut enim ad minim veniam, quis nostrud
exercitation ullamco laboris nisi ut aliquip ex
ea commodo consequat. Duis aute irure
dolor in reprehenderit in voluptate velit esse
cillum dolore eu fugiat nulla pariatur. Excepteur
sint occaecat cupidatat non proident,
sunt in culpa qui officia deserunt mollit anim
id est laborum. 2 Lorem ipsum dolor sit
amet, consectetur adipisicing elit, sed do
eiusmod tempor incididunt ut labore et
dolore magna aliqua. Ut enim ad minim
veniam, quis nostrud exercitation ullamco
laboris nisi ut aliquip ex ea commodo consequat.
Duis aute irure dolor in reprehenderit
in voluptate velit esse cillum dolore eu fugiat
nulla pariatur. Excepteur sint occaecat
cupidatat non proident, sunt in culpa qui
officia deserunt mollit anim id est laborum.
3 Lorem ipsum dolor sit amet, consectetur
adipisicing elit, sed do eiusmod tempor
incididunt ut labore et dolore magna aliqua.
Ut enim ad minim veniam, quis nostrud
exercitation ullamco laboris nisi ut aliquip ex
ea commodo consequat. Duis aute irure
dolor in reprehenderit in voluptate velit esse
cillum dolore eu fugiat nulla pariatur. Excepteur
sint occaecat cupidatat non proident,
sunt in culpa qui officia deserunt mollit anim
id est laborum. 4 Lorem ipsum dolor sit
amet, consectetur adipisicing elit, sed do
eiusmod tempor incididunt ut labore et
dolore magna aliqua. Ut enim ad minim
veniam, quis nostrud exercitation ullamco
laboris nisi ut aliquip ex ea commodo consequat.
Duis aute irure dolor in reprehenderit
in voluptate velit esse cillum dolore eu fugiat
nulla pariatur. Excepteur sint occaecat
cupidatat non proident, sunt in culpa qui
officia deserunt mollit anim id est laborum.
5 Lorem ipsum dolor sit amet, consectetur
adipisicing elit, sed do eiusmod tempor
incididunt ut labore et dolore magna aliqua.
Ut enim ad minim veniam, quis nostrud
exercitation ullamco laboris nisi ut aliquip ex
ea commodo consequat. Duis aute irure
dolor in reprehenderit in voluptate velit esse
cillum dolore eu fugiat nulla pariatur. Excepteur
sint occaecat cupidatat non proident,
sunt in culpa qui officia deserunt mollit anim
id est laborum. 6 Lorem ipsum dolor sit
amet, consectetur adipisicing elit, sed do
eiusmod tempor incididunt ut labore et
dolore magna aliqua. Ut enim ad minim
veniam, quis nostrud exercitation ullamco
laboris nisi ut aliquip ex ea commodo consequat.
Duis aute irure dolor in reprehenderit
in voluptate velit esse cillum dolore eu fugiat
nulla pariatur. Excepteur sint occaecat
cupidatat non proident, sunt in culpa qui
officia deserunt mollit anim id est laborum.
7 Lorem ipsum dolor sit amet, consectetur
adipisicing elit, sed do eiusmod tempor
incididunt ut labore et dolore magna aliqua.
Ut enim ad minim veniam, quis nostrud
exercitation ullamco laboris nisi ut aliquip ex
ea commodo consequat. Duis aute irure
dolor in reprehenderit in voluptate velit esse
cillum dolore eu fugiat nulla pariatur. Excepteur
sint occaecat cupidatat non proident,
sunt in culpa qui officia deserunt mollit anim
id est laborum. 8 Lorem ipsum dolor sit
amet, consectetur adipisicing elit, sed do
eiusmod tempor incididunt ut labore et
dolore magna aliqua. Ut enim ad minim
veniam, quis nostrud exercitation ullamco
laboris nisi ut aliquip ex ea commodo consequat.
Duis aute irure dolor in reprehenderit
in voluptate velit esse cillum dolore eu fugiat
nulla pariatur. Excepteur sint occaecat
cupidatat non proident, sunt in culpa qui
officia deserunt mollit anim id est laborum.
9 Lorem ipsum dolor sit amet, consectetur
adipisicing elit, sed do eiusmod tempor
incididunt ut labore et dolore magna aliqua.
Ut enim ad minim veniam, quis nostrud
exercitation ullamco laboris nisi ut aliquip ex
ea commodo consequat. Duis aute irure
dolor in reprehenderit in voluptate velit esse
cillum dolore eu fugiat nulla pariatur. Excepteur
sint occaecat cupidatat non proident,
sunt in culpa qui officia deserunt mollit anim
id est laborum. 10 Lorem ipsum dolor sit
amet, consectetur adipisicing elit, sed do
eiusmod tempor incididunt ut labore et
dolore magna aliqua. Ut enim ad minim
veniam, quis nostrud exercitation ullamco
laboris nisi ut aliquip ex ea commodo consequat.
Duis aute irure dolor in reprehenderit
in voluptate velit esse cillum dolore eu fugiat
nulla pariatur. Excepteur sint occaecat
cupidatat non proident, sunt in culpa qui
officia deserunt mollit anim id est laborum.
11 Lorem ipsum dolor sit amet, consectetur
adipisicing elit, sed do eiusmod tempor
incididunt ut labore et dolore magna aliqua.
Ut enim ad minim veniam, quis nostrud
exercitation ullamco laboris nisi ut aliquip ex
ea commodo consequat. Duis aute irure
dolor in reprehenderit in voluptate velit esse
cillum dolore eu fugiat nulla pariatur. Excepteur
sint occaecat cupidatat non proident,
sunt in culpa qui officia deserunt mollit anim
id est laborum. 12 Lorem ipsum dolor sit
amet, consectetur adipisicing elit, sed do
eiusmod tempor incididunt ut labore et
dolore magna aliqua. Ut enim ad minim
veniam, quis nostrud exercitation ullamco
laboris nisi ut aliquip ex ea commodo consequat.
Duis aute irure dolor in reprehenderit
in voluptate velit esse cillum dolore eu fugiat
nulla pariatur. Excepteur sint occaecat
cupidatat non proident, sunt in culpa qui
officia deserunt mollit anim id est laborum.
13 Lorem ipsum dolor sit amet, consectetur
adipisicing elit, sed do eiusmod tempor
incididunt ut labore et dolore magna aliqua.
Ut enim ad minim veniam, quis nostrud
exercitation ullamco laboris nisi ut aliquip ex
ea commodo consequat. Duis aute irure
dolor in reprehenderit in voluptate velit esse
cillum dolore eu fugiat nulla pariatur. Excepteur
sint occaecat cupidatat non proident,
sunt in culpa qui officia deserunt mollit anim
id est laborum. 14 Lorem ipsum dolor sit
amet, consectetur adipisicing elit, sed do
eiusmod tempor incididunt ut labore et
dolore magna aliqua. Ut enim ad minim
veniam, quis nostrud exercitation ullamco
laboris nisi ut aliquip ex ea commodo consequat.
Duis aute irure dolor in reprehenderit
in voluptate velit esse cillum dolore eu fugiat
nulla pariatur. Excepteur sint occaecat
cupidatat non proident, sunt in culpa qui
officia deserunt mollit anim id est laborum.
15 Lorem ipsum dolor sit amet, consectetur
adipisicing elit, sed do eiusmod tempor
incididunt ut labore et dolore magna aliqua.
Ut enim ad minim veniam, quis nostrud
exercitation ullamco laboris nisi ut aliquip ex
ea commodo consequat. Duis aute irure
dolor in reprehenderit in voluptate velit esse
cillum dolore eu fugiat nulla pariatur. Excepteur
sint occaecat cupidatat non proident,
sunt in culpa qui officia deserunt mollit anim
id est laborum. 16 Lorem ipsum dolor sit
amet, consectetur adipisicing elit, sed do
eiusmod tempor incididunt ut labore et
dolore magna aliqua. Ut enim ad minim
veniam, quis nostrud exercitation ullamco
laboris nisi ut aliquip ex ea commodo consequat.
Duis aute irure dolor in reprehenderit
in voluptate velit esse cillum dolore eu fugiat
nulla pariatur. Excepteur sint occaecat
cupidatat non proident, sunt in culpa qui
officia deserunt mollit anim id est laborum.
17 Lorem ipsum dolor sit amet, consectetur
adipisicing elit, sed do eiusmod tempor
incididunt ut labore et dolore magna aliqua.
Ut enim ad minim veniam, quis nostrud
exercitation ullamco laboris nisi ut aliquip ex
ea commodo consequat. Duis aute irure
dolor in reprehenderit in voluptate velit esse
cillum dolore eu fugiat nulla pariatur. Excepteur
sint occaecat cupidatat non proident,
sunt in culpa qui officia deserunt mollit anim
id est laborum. 18 Lorem ipsum dolor sit
amet, consectetur adipisicing elit, sed do
eiusmod tempor incididunt ut labore et
dolore magna aliqua. Ut enim ad minim
veniam, quis nostrud exercitation ullamco
laboris nisi ut aliquip ex ea commodo consequat.
Duis aute irure dolor in reprehenderit
in voluptate velit esse cillum dolore eu fugiat
nulla pariatur. Excepteur sint occaecat
cupidatat non proident, sunt in culpa qui
officia deserunt mollit anim id est laborum.
19 Lorem ipsum dolor sit amet, consectetur
adipisicing elit, sed do eiusmod tempor
incididunt ut labore et dolore magna aliqua.
Ut enim ad minim veniam, quis nostrud
exercitation ullamco laboris nisi ut aliquip ex
ea commodo consequat. Duis aute irure
dolor in reprehenderit in voluptate velit esse
cillum dolore eu fugiat nulla pariatur. Excepteur
sint occaecat cupidatat non proident,
sunt in culpa qui officia deserunt mollit anim
id est laborum. 20 Lorem ipsum dolor sit
amet, consectetur adipisicing elit, sed do
eiusmod tempor incididunt ut labore et
dolore magna aliqua. Ut enim ad minim
veniam, quis nostrud exercitation ullamco
laboris nisi ut aliquip ex ea commodo consequat.
Duis aute irure dolor in reprehenderit
in voluptate velit esse cillum dolore eu fugiat
nulla pariatur. Excepteur sint occaecat
cupidatat non proident, sunt in culpa qui
officia deserunt mollit anim id est laborum.
21 Lorem ipsum dolor sit amet, consectetur
adipisicing elit, sed do eiusmod tempor
incididunt ut labore et dolore magna aliqua.
Ut enim ad minim veniam, quis nostrud
exercitation ullamco laboris nisi ut aliquip ex
ea commodo consequat. Duis aute irure
dolor in reprehenderit in voluptate velit esse
cillum dolore eu fugiat nulla pariatur. Excepteur
sint occaecat cupidatat non proident,
sunt in culpa qui officia deserunt mollit anim
id est laborum. 22 Lorem ipsum dolor sit
amet, consectetur adipisicing elit, sed do
eiusmod tempor incididunt ut labore et
dolore magna aliqua. Ut enim ad minim
veniam, quis nostrud exercitation ullamco
laboris nisi ut aliquip ex ea commodo consequat.
Duis aute irure dolor in reprehenderit
in voluptate velit esse cillum dolore eu fugiat
nulla pariatur. Excepteur sint occaecat
cupidatat non proident, sunt in culpa qui
officia deserunt mollit anim id est laborum.
23 Lorem ipsum dolor sit amet, consectetur
adipisicing elit, sed do eiusmod tempor
incididunt ut labore et dolore magna aliqua.
Ut enim ad minim veniam, quis nostrud
exercitation ullamco laboris nisi ut aliquip ex
ea commodo consequat. Duis aute irure
dolor in reprehenderit in voluptate velit esse
cillum dolore eu fugiat nulla pariatur. Excepteur
sint occaecat cupidatat non proident,
sunt in culpa qui officia deserunt mollit anim
id est laborum. 24 Lorem ipsum dolor sit
amet, consectetur adipisicing elit, sed do
eiusmod tempor incididunt ut labore et
dolore magna aliqua. Ut enim ad minim
veniam, quis nostrud exercitation ullamco
laboris nisi ut aliquip ex ea commodo consequat.
Duis aute irure dolor in reprehenderit
in voluptate velit esse cillum dolore eu fugiat
nulla pariatur. Excepteur sint occaecat
cupidatat non proident, sunt in culpa qui
officia deserunt mollit anim id est laborum.
25 Lorem ipsum dolor sit amet, consectetur
adipisicing elit, sed do eiusmod tempor
incididunt ut labore et dolore magna aliqua.
Ut enim ad minim veniam, quis nostrud
exercitation ullamco laboris nisi ut aliquip ex
ea commodo consequat. Duis aute irure
dolor in reprehenderit in voluptate velit esse
cillum dolore eu fugiat nulla pariatur. Excepteur
sint occaecat cupidatat non proident,
sunt in culpa qui officia deserunt mollit anim
id est laborum. 26 Lorem ipsum dolor sit
amet, consectetur adipisicing elit, sed do
eiusmod tempor incididunt ut labore et
dolore magna aliqua. Ut enim ad minim
veniam, quis nostrud exercitation ullamco
laboris nisi ut aliquip ex ea commodo consequat.
Duis aute irure dolor in reprehenderit
in voluptate velit esse cillum dolore eu fugiat
nulla pariatur. Excepteur sint occaecat
cupidatat non proident, sunt in culpa qui
officia deserunt mollit anim id est laborum.
27 Lorem ipsum dolor sit amet, consectetur
adipisicing elit, sed do eiusmod tempor
incididunt ut labore et dolore magna aliqua.
8.14
194 8 : COM .NET REALbasic

leftindent = 15
parindent = 20
leading = 140%
8.15
Have a look at our newpaper plane models! Our paper planes
are the ideal way ofpassing the time. We offer revolutionary new
developments of the traditional common paper planes.
If yourlesson, conference, or lecture turn outtobedeadly boring,
you can have a wonderful time with our planes. All our models are
folded from one paper sheet.
They are exclusively folded without using any adhesive. Several
modelsare equipped with a folded landing gearenabling asafe landing
on the intended location provided that you have aimed well. Other
models are able to fly loops or cover long distances. Let them start
from a vista point in the mountains and see where they touch the
ground.
rightindent = 10
alignment =
justify
String optlist =
"leftindent=15 rightindent=10 parindent=20 alignment=justify " +
"leading=140% fontname=Helvetica fontsize=8 encoding=unicode";
8.2.3
create_textflow( )
add_texflow( ) create_textflow( ) create_
textflow( )
Have a look at our new paper plane models!
Our paper planes are the ideal way of passing the time. We offer
revolutionary new developments of the traditional common paper planes.
If your lesson, conference, or lecture
turn out to be deadly boring, you can have a wonderful time
with our planes. All our models are folded from one paper sheet.
They are exclusively folded without using any adhesive. Several
models are equipped with a folded landing gear enabling a safe
landing on the intended location provided that you have aimed well.
Other models are able to fly loops or cover long distances. Let them
start from a vista point in the mountains and see
where they touch the ground.
8.2 195

egoptlistchar endoptlistchar
begoptlistchar none
encoding=builtin
begoptlistchar
textlen
&lt;
H1 Body Body_indented
&
Have a look at our new paper plane models!
H1
Body
Body_indented
8.16
Have a look at our newpaper plane models!
Our paper planes are the ideal way ofpassing the time. We offer
revolutionary new developments of the traditional common paper
planes.
If yourlesson, conference, or lecture turn outtobedeadly boring,
you can have a wonderful time with our planes. All our models are
folded from one paper sheet.
They are exclusively folded without using any adhesive. Several
modelsare equipped with a folded landing gearenabling asafe landing
on the intended location provided that you have aimed well. Other
models are able to fly loops or cover long distances. Let them start
from a vista point in the mountains and see where they touch the
ground.
196 8 : COM .NET REALbasic

Our paper planes are the ideal way of passing the time. We offer
revolutionary new developments of the traditional common paper planes.
If your lesson, conference, or lecture
turn out to be deadly boring, you can have a wonderful time
with our planes. All our models are folded from one paper sheet.
They are exclusively folded without using any adhesive. Several
models are equipped with a folded landing gear enabling a safe
landing on the intended location provided that you have aimed well.
Other models are able to fly loops or cover long distances. Let them
start from a vista point in the mountains and see
where they touch the ground.
fontsize
>
>
8.2.4
8.2 197

hortabmethod ruler
tabalignment left right right right
ruler 30 150
250
350
8.17
ITEM DESCRIPTION QUANTITY PRICE AMOUNT
1 Super Kite 2 20.00 40.00
2 Turbo Flyer 5 40.00 200.00
3 Giga Trash 1 180.00 180.00
TOTAL 420.00
ITEM DESCRIPTION QUANTITY PRICE AMOUNT
1 Super Kite 2 20.00 40.00
2 Turbo Flyer 5 40.00 200.00
3 Giga Trash 1 180.00 180.00
TOTAL 420.00
_add/create_textflow( )
ruler tabalignment
hortabmethod
String optlist =
"ruler={30 150 250 350} " +
"tabalignment={left right right right} " +
"hortabmethod=ruler leading=120% fontname=Helvetica fontsize=9 encoding=winansi";
text_output/tabstops_in_textflow
PDFlib 211 8.3
1 2 3 4
1 2
1 Lorem ipsum dolor sit amet, consectetur
adipisicing elit, sed do eiusmod tempor
incididunt ut labore et dolore magna aliqua.
Ut enim ad minim veniam, quis nostrud
exercitation ullamco laboris nisi ut aliquip ex
ea commodo consequat. Duis aute irure
dolor in reprehenderit in voluptate velit esse
cillum dolore eu fugiat nulla pariatur. Excepteur
sint occaecat cupidatat non proident,
sunt in culpa qui officia deserunt mollit anim
id est laborum. 2 Lorem ipsum dolor sit
amet, consectetur adipisicing elit, sed do
eiusmod tempor incididunt ut labore et
dolore magna aliqua. Ut enim ad minim
veniam, quis nostrud exercitation ullamco
laboris nisi ut aliquip ex ea commodo consequat.
Duis aute irure dolor in reprehenderit
in voluptate velit esse cillum dolore eu fugiat
nulla pariatur. Excepteur sint occaecat
cupidatat non proident, sunt in culpa qui
officia deserunt mollit anim id est laborum.
3 Lorem ipsum dolor sit amet, consectetur
adipisicing elit, sed do eiusmod tempor
incididunt ut labore et dolore magna aliqua.
Ut enim ad minim veniam, quis nostrud
exercitation ullamco laboris nisi ut aliquip ex
ea commodo consequat. Duis aute irure
dolor in reprehenderit in voluptate velit esse
cillum dolore eu fugiat nulla pariatur. Excepteur
sint occaecat cupidatat non proident,
sunt in culpa qui officia deserunt mollit anim
id est laborum. 4 Lorem ipsum dolor sit
amet, consectetur adipisicing elit, sed do
eiusmod tempor incididunt ut labore et
dolore magna aliqua. Ut enim ad minim
veniam, quis nostrud exercitation ullamco
laboris nisi ut aliquip ex ea commodo consequat.
Duis aute irure dolor in reprehenderit
in voluptate velit esse cillum dolore eu fugiat
nulla pariatur. Excepteur sint occaecat
cupidatat non proident, sunt in culpa qui
officia deserunt mollit anim id est laborum.
5 Lorem ipsum dolor sit amet, consectetur
adipisicing elit, sed do eiusmod tempor
incididunt ut labore et dolore magna aliqua.
Ut enim ad minim veniam, quis nostrud
exercitation ullamco laboris nisi ut aliquip ex
ea commodo consequat. Duis aute irure
dolor in reprehenderit in voluptate velit esse
cillum dolore eu fugiat nulla pariatur. Excepteur
sint occaecat cupidatat non proident,
sunt in culpa qui officia deserunt mollit anim
id est laborum. 6 Lorem ipsum dolor sit
amet, consectetur adipisicing elit, sed do
eiusmod tempor incididunt ut labore et
dolore magna aliqua. Ut enim ad minim
veniam, quis nostrud exercitation ullamco
laboris nisi ut aliquip ex ea commodo consequat.
Duis aute irure dolor in reprehenderit
in voluptate velit esse cillum dolore eu fugiat
nulla pariatur. Excepteur sint occaecat
cupidatat non proident, sunt in culpa qui
officia deserunt mollit anim id est laborum.
7 Lorem ipsum dolor sit amet, consectetur
adipisicing elit, sed do eiusmod tempor
incididunt ut labore et dolore magna aliqua.
Ut enim ad minim veniam, quis nostrud
exercitation ullamco laboris nisi ut aliquip ex
ea commodo consequat. Duis aute irure
dolor in reprehenderit in voluptate velit esse
cillum dolore eu fugiat nulla pariatur. Excepteur
sint occaecat cupidatat non proident,
sunt in culpa qui officia deserunt mollit anim
id est laborum. 8 Lorem ipsum dolor sit
amet, consectetur adipisicing elit, sed do
eiusmod tempor incididunt ut labore et
dolore magna aliqua. Ut enim ad minim
veniam, quis nostrud exercitation ullamco
laboris nisi ut aliquip ex ea commodo consequat.
Duis aute irure dolor in reprehenderit
in voluptate velit esse cillum dolore eu fugiat
nulla pariatur. Excepteur sint occaecat
cupidatat non proident, sunt in culpa qui
officia deserunt mollit anim id est laborum.
9 Lorem ipsum dolor sit amet, consectetur
adipisicing elit, sed do eiusmod tempor
incididunt ut labore et dolore magna aliqua.
Ut enim ad minim veniam, quis nostrud
exercitation ullamco laboris nisi ut aliquip ex
ea commodo consequat. Duis aute irure
dolor in reprehenderit in voluptate velit esse
cillum dolore eu fugiat nulla pariatur. Excepteur
sint occaecat cupidatat non proident,
sunt in culpa qui officia deserunt mollit anim
id est laborum. 10 Lorem ipsum dolor sit
amet, consectetur adipisicing elit, sed do
eiusmod tempor incididunt ut labore et
dolore magna aliqua. Ut enim ad minim
veniam, quis nostrud exercitation ullamco
laboris nisi ut aliquip ex ea commodo consequat.
Duis aute irure dolor in reprehenderit
in voluptate velit esse cillum dolore eu fugiat
nulla pariatur. Excepteur sint occaecat
cupidatat non proident, sunt in culpa qui
officia deserunt mollit anim id est laborum.
11 Lorem ipsum dolor sit amet, consectetur
adipisicing elit, sed do eiusmod tempor
incididunt ut labore et dolore magna aliqua.
Ut enim ad minim veniam, quis nostrud
exercitation ullamco laboris nisi ut aliquip ex
ea commodo consequat. Duis aute irure
dolor in reprehenderit in voluptate velit esse
cillum dolore eu fugiat nulla pariatur. Excepteur
sint occaecat cupidatat non proident,
sunt in culpa qui officia deserunt mollit anim
id est laborum. 12 Lorem ipsum dolor sit
amet, consectetur adipisicing elit, sed do
eiusmod tempor incididunt ut labore et
dolore magna aliqua. Ut enim ad minim
veniam, quis nostrud exercitation ullamco
laboris nisi ut aliquip ex ea commodo consequat.
Duis aute irure dolor in reprehenderit
in voluptate velit esse cillum dolore eu fugiat
nulla pariatur. Excepteur sint occaecat
cupidatat non proident, sunt in culpa qui
officia deserunt mollit anim id est laborum.
13 Lorem ipsum dolor sit amet, consectetur
adipisicing elit, sed do eiusmod tempor
incididunt ut labore et dolore magna aliqua.
Ut enim ad minim veniam, quis nostrud
exercitation ullamco laboris nisi ut aliquip ex
ea commodo consequat. Duis aute irure
dolor in reprehenderit in voluptate velit esse
cillum dolore eu fugiat nulla pariatur. Excepteur
sint occaecat cupidatat non proident,
sunt in culpa qui officia deserunt mollit anim
id est laborum. 14 Lorem ipsum dolor sit
amet, consectetur adipisicing elit, sed do
eiusmod tempor incididunt ut labore et
dolore magna aliqua. Ut enim ad minim
veniam, quis nostrud exercitation ullamco
laboris nisi ut aliquip ex ea commodo consequat.
Duis aute irure dolor in reprehenderit
in voluptate velit esse cillum dolore eu fugiat
nulla pariatur. Excepteur sint occaecat
cupidatat non proident, sunt in culpa qui
officia deserunt mollit anim id est laborum.
15 Lorem ipsum dolor sit amet, consectetur
adipisicing elit, sed do eiusmod tempor
incididunt ut labore et dolore magna aliqua.
Ut enim ad minim veniam, quis nostrud
exercitation ullamco laboris nisi ut aliquip ex
ea commodo consequat. Duis aute irure
dolor in reprehenderit in voluptate velit esse
cillum dolore eu fugiat nulla pariatur. Excepteur
sint occaecat cupidatat non proident,
sunt in culpa qui officia deserunt mollit anim
id est laborum. 16 Lorem ipsum dolor sit
amet, consectetur adipisicing elit, sed do
eiusmod tempor incididunt ut labore et
dolore magna aliqua. Ut enim ad minim
veniam, quis nostrud exercitation ullamco
laboris nisi ut aliquip ex ea commodo consequat.
Duis aute irure dolor in reprehenderit
in voluptate velit esse cillum dolore eu fugiat
nulla pariatur. Excepteur sint occaecat
cupidatat non proident, sunt in culpa qui
officia deserunt mollit anim id est laborum.
17 Lorem ipsum dolor sit amet, consectetur
adipisicing elit, sed do eiusmod tempor
incididunt ut labore et dolore magna aliqua.
Ut enim ad minim veniam, quis nostrud
exercitation ullamco laboris nisi ut aliquip ex
ea commodo consequat. Duis aute irure
dolor in reprehenderit in voluptate velit esse
cillum dolore eu fugiat nulla pariatur. Excepteur
sint occaecat cupidatat non proident,
sunt in culpa qui officia deserunt mollit anim
id est laborum. 18 Lorem ipsum dolor sit
amet, consectetur adipisicing elit, sed do
eiusmod tempor incididunt ut labore et
dolore magna aliqua. Ut enim ad minim
veniam, quis nostrud exercitation ullamco
laboris nisi ut aliquip ex ea commodo consequat.
Duis aute irure dolor in reprehenderit
in voluptate velit esse cillum dolore eu fugiat
nulla pariatur. Excepteur sint occaecat
cupidatat non proident, sunt in culpa qui
officia deserunt mollit anim id est laborum.
19 Lorem ipsum dolor sit amet, consectetur
adipisicing elit, sed do eiusmod tempor
incididunt ut labore et dolore magna aliqua.
Ut enim ad minim veniam, quis nostrud
exercitation ullamco laboris nisi ut aliquip ex
ea commodo consequat. Duis aute irure
dolor in reprehenderit in voluptate velit esse
cillum dolore eu fugiat nulla pariatur. Excepteur
sint occaecat cupidatat non proident,
sunt in culpa qui officia deserunt mollit anim
id est laborum. 20 Lorem ipsum dolor sit
amet, consectetur adipisicing elit, sed do
eiusmod tempor incididunt ut labore et
dolore magna aliqua. Ut enim ad minim
veniam, quis nostrud exercitation ullamco
laboris nisi ut aliquip ex ea commodo consequat.
Duis aute irure dolor in reprehenderit
in voluptate velit esse cillum dolore eu fugiat
nulla pariatur. Excepteur sint occaecat
cupidatat non proident, sunt in culpa qui
officia deserunt mollit anim id est laborum.
21 Lorem ipsum dolor sit amet, consectetur
adipisicing elit, sed do eiusmod tempor
incididunt ut labore et dolore magna aliqua.
Ut enim ad minim veniam, quis nostrud
exercitation ullamco laboris nisi ut aliquip ex
ea commodo consequat. Duis aute irure
dolor in reprehenderit in voluptate velit esse
cillum dolore eu fugiat nulla pariatur. Excepteur
sint occaecat cupidatat non proident,
sunt in culpa qui officia deserunt mollit anim
id est laborum. 22 Lorem ipsum dolor sit
amet, consectetur adipisicing elit, sed do
eiusmod tempor incididunt ut labore et
dolore magna aliqua. Ut enim ad minim
veniam, quis nostrud exercitation ullamco
laboris nisi ut aliquip ex ea commodo consequat.
Duis aute irure dolor in reprehenderit
in voluptate velit esse cillum dolore eu fugiat
nulla pariatur. Excepteur sint occaecat
cupidatat non proident, sunt in culpa qui
officia deserunt mollit anim id est laborum.
23 Lorem ipsum dolor sit amet, consectetur
adipisicing elit, sed do eiusmod tempor
incididunt ut labore et dolore magna aliqua.
Ut enim ad minim veniam, quis nostrud
exercitation ullamco laboris nisi ut aliquip ex
ea commodo consequat. Duis aute irure
dolor in reprehenderit in voluptate velit esse
cillum dolore eu fugiat nulla pariatur. Excepteur
sint occaecat cupidatat non proident,
sunt in culpa qui officia deserunt mollit anim
id est laborum. 24 Lorem ipsum dolor sit
amet, consectetur adipisicing elit, sed do
eiusmod tempor incididunt ut labore et
dolore magna aliqua. Ut enim ad minim
veniam, quis nostrud exercitation ullamco
laboris nisi ut aliquip ex ea commodo consequat.
Duis aute irure dolor in reprehenderit
in voluptate velit esse cillum dolore eu fugiat
nulla pariatur. Excepteur sint occaecat
cupidatat non proident, sunt in culpa qui
officia deserunt mollit anim id est laborum.
25 Lorem ipsum dolor sit amet, consectetur
adipisicing elit, sed do eiusmod tempor
incididunt ut labore et dolore magna aliqua.
Ut enim ad minim veniam, quis nostrud
exercitation ullamco laboris nisi ut aliquip ex
ea commodo consequat. Duis aute irure
dolor in reprehenderit in voluptate velit esse
cillum dolore eu fugiat nulla pariatur. Excepteur
sint occaecat cupidatat non proident,
sunt in culpa qui officia deserunt mollit anim
id est laborum. 26 Lorem ipsum dolor sit
amet, consectetur adipisicing elit, sed do
eiusmod tempor incididunt ut labore et
dolore magna aliqua. Ut enim ad minim
veniam, quis nostrud exercitation ullamco
laboris nisi ut aliquip ex ea commodo consequat.
Duis aute irure dolor in reprehenderit
in voluptate velit esse cillum dolore eu fugiat
nulla pariatur. Excepteur sint occaecat
cupidatat non proident, sunt in culpa qui
officia deserunt mollit anim id est laborum.
27 Lorem ipsum dolor sit amet, consectetur
adipisicing elit, sed do eiusmod tempor
incididunt ut labore et dolore magna aliqua.
8.18
198 8 : COM .NET REALbasic

8.2.5
leftindent
1.Long Distance Glider: With this paper rocket you can send all
your messages even when sitting in a hall or in the cinema pretty near the back.
2.Giant Wing: An unbelievable sailplane! It is amazingly
robust and can even do aerobatics. But it is best suited to gliding.
3.Cone Head Rocket: This paper arrow can be thrown with big
swing. We launched it from the roof of a hotel. It stayed in the air a long time and
covered a considerable distance.
bulleted_list text_output/numbered_list
text_output/
list indent
1. Long Distance Glider: With this paper rocket you can send all your messages
even when sitting in a hall or in the cinema pretty near the back.
2. Giant Wing: An unbelievable sailplane! It is amazingly robust and can even do
aerobatics. But it is best suited to gliding.
3. Cone Head Rocket: This paper arrow can be thrown with big swing. We launched
it from the roof of a hotel. It stayed in the air a long time and covered a
considerable distance.
leftindent parindent
leftindent
hortabsize hortabmethod ruler leftindent
leftindent
parindentleftindent
nextline
1. Long Distance Glider: With this paper rocket you can send all your
messages even when sitting in a hall or in the cinema pretty near the
back.
2. Giant Wing: An unbelievable sailplane! It is amazingly robust and can
even do aerobatics. But it is best suited to gliding.
3. Cone Head Rocket: This paper arrow can be thrown with big swing. We
launched it from the roof of a hotel. It stayed in the air a long time and
covered a considerable distance.
8.19
8.2 199

leftindent = &indent
parindent = – &indent 1. Long Distance Glider: With this paper rocket you can send all your
messages even when sitting in a hall or in the cinema pretty near
the back.
2. Giant Wing: An unbelievable sailplane! It is amazingly robust and
can evendoaerobatics.But itisbest suited to gliding.
8.20
3. Cone Head Rocket: This paper arrow can be thrown with big swing.
We launched it from the roof of a hotel. It stayedintheair a long
time and covered a considerable distance.
1. Long Distance Glider: With this paper rocket you can send all your messages
even when sitting in a hall or in the cinema pretty near the back.
2. Giant Wing: An unbelievable
sailplane! It is amazingly robust and can even do aerobatics. But it is best suited to
gliding.
text_output/distance_between_paragraphs
8.2.6
charmapping
/ charmapping
charmapping
charmapping={hortab space}
hortab space
PDFlib API
charmapping={hortab space CRLF space LF space CR space}
charmapping={shy {shy 0}}
200 8 : COM .NET REALbasic

8.1
Unicode
VB
U+0020 SP, space space
U+00A0 NBSP, nbsp no-break space
U+0009 VbTab HT, hortab ruler tabalignchar tabalignment
U+002D HY, hyphen
U+00AD SHY, shy soft hyphen
U+000B
U+2028
VT, verttab
LS, linesep
nextline
next line
U+000A VbLf
U+000D VbCr
U+000D
U+000A VbCrLf
U+0085
U+2029
LF, linefeed
CR, return
CRLF
NEL, newline
PS, parasep
nextparagraph
next paragraph nextline parindent
U+000C
VbFormFeed
FF, formfeed return fit_textflow( ) _nextpage
charmapping={hortab {space 4}}
charmapping={linefeed {linefeed -1}}
charmapping={CRLF {space -1}}
To fold the famous rocket looper proceed as follows:
Take a sheet of paper. Fold it
lengthwise in the middle.
Then, fold down the upper corners. Fold the
long sides inwards
that the points A and B meet on the central fold.
8.2 201

To fold the famous rocket looper proceed as follows:
Take a sheet of paper. Fold it
lengthwise in the middle.
Then, fold down the upper corners. Fold the
long sides inwards
that the points A and B meet on the central fold.
To fold the famous rocket looper proceed as follows: Take a sheet of
paper. Fold it lengthwise in the middle. Then, fold down the upper
corners. Fold the long sides inwards that the points A and B meet on
the central fold.
8.21
charmapping
/* */
String optlist = "fontname=Helvetica fontsize=9 encoding=winansi alignment=justify "
"charmapping {CRLF {space -1}}"
/* */
textflow = p.add_textflow(-1, text, optlist);
if (textflow == -1)
throw new Exception("" + p.get_errmsg());
result = p.fit_textflow(textflow, left_x, left_y, right_x, right_y, "");
if (!result.equals("_stop"))
{ /* ... */ }
p.delete_textflow(textflow);
charmapping
8.2.7
U+00AD
> cp1250 cp1258winansi iso8859-1 iso8859-16
>
macroman &shy;
U+002D
Our paper planes are the ideal way of pas sing the time. We offer revolu tionary
brand new dev elop ments of the tradi tional common paper planes. If your lesson,
confe rence, or lecture turn out to be deadly boring, you can have a wonder ful time
with our planes. All our models are folded from one paper sheet. They are exclu sively
202 8 : COM .NET REALbasic

Our paper planes are the ideal way of
passing the time. We offer revolutionary
brand new developments of the
traditional common paper planes. If
your lesson, conference, or lecture turn
out to be deadly boring, you can have
a wonderful time with our planes. All
our models are folded from one paper
sheet. They are exclusively folded
without using any adhesive. Several
models are equipped with a folded
landing gear enabling a safe landing
on the intended location provided that
you have aimed well. Other models are
able to fly loops or cover long distances.
Let them start from a vista point
in the mountains and see where they
touch the ground.
8.22
Our paper planes are the ideal way of
passing the time. We offer revolutionary
brand new developments of the
traditional common paper planes. If
your lesson, conference, or lecture turn
out to be deadly boring, you can have
a wonderful time with our planes. All
our models are folded from one paper
sheet. They are exclusively folded
without using any adhesive. Several
models are equipped with a folded
landing gear enabling a safe landing
on the intended location provided that
you have aimed well. Other models are
able to fly loops or cover long
distances. Let them start from a vista
point in the mountains and see where
they touch the ground.
8.23
folded without using any adhe sive. Several models are equip ped with a folded
landing gear enab ling a safe landing on the intended loca tion provided that you
have aimed well. Other models are able to fly loops or cover long dist ances. Let them
start from a vista point in the mount ains and see where they touch the ground.
fontname=Helvetica fontsize=9 encoding=winansi alignment=justify
8.2.8
-12+235/8*45
PDF-345+LIBRARY
alignment=justify
8.2 203

adjustmethod
advancedlinebreak
avoidbreak
charclass
hyphenchar
locale
maxspacing
minspacing
minspacing maxspacing
auto
auto shrink spread nofit split
clip
nofit
shrink
split
spread
nofit rightindent
nofitlimit
shrinklimit
nofit
spreadlimit nofit
locale script false
true avoidbreak false false
letter
punct
open
close
default
charclass={ close » open « letter {/ : =} punct & }
advancedlinebreak= true
>
en de ja language
>
Hira Hebr Thai
>
DE CH GB
_none
_none
Thai de_DE en_US en_GB
wordspacing minspacing=50% maxspacing=500%
204 8 : COM .NET REALbasic

nofitlimit
shrinklimit
spreadlimit
nofit
shrink
spread
charspacing
charclass
charclass={letter /}
avoidbreak
noavoidbreak
text_output/avoid_linebreaking
hyphenchar=none
alignment=justify
shrinklimit=100%
spreadlimit=100%
maxspacing
split
shrinklimit
shrinklimit shrink
8.2 205

Our paper planes
are the ideal way of
passing the time.We
offer revolutionary
brand new developments
of the traditional
common paper planes.
If your lesson, conference,
or lecture
turn out to be deadly
boring, you can have
a wonderful time
with our planes. All
8.24
minspacing
shrink shrinklimit
split
spread maxspacing
shrinklimit=50%
spreadlimit
spread spreadlimit
spreadlimit=5
8.25
fit_textline( )
passing the time.We
offer revolutionary
brand new developments
a) of the traditional
alignment=justify shrinklimit=50%
common paper planes.
If your lesson, conference,
or lecture turn out to
Our paper planes
are the ideal way of
b)
passing the time.We
offer revolutionary
alignment=justify spreadlimit=5
b r a n d n e w
developments of the
ments of the traditional
common paper planes.
c)
If your lesson,
conference, or lecture
alignment=justify nofitlimit=50
turn out to be deadly
boring, you can have
nofitlimit nofitlimit nofit
8.2.9
206 8 : COM .NET REALbasic

advancedlinebreak
script
locale
>
> «»
locale language
locale
8.2.10
matchbox={name=img margin=-5}
img
result = p.fit_image(image, 50, 35,
"boxsize={80 46} fitmethod=meet position=center matchbox={name=img margin=-5}");
img
wrap
8.26
Have a look at our new paper plane models! Our
paper planes are the ideal way of passing the time.
We offer revolutionary new
developme-
nts of the traditional
com-
mon paper planes.
If your les-
son, conference,
or lecture
turn out to be
deadly bor- ing, you can
have a wonderful time with our planes. All our
models are folded from one paper sheet. They are
exclusively folded without using any adhesive.
8.27
Our paper planes are 50% the ideal 80% way of passing the time.
We offer a lot of revolutionary brand-new developments
of the traditional common paper planes. If your
lesson, conference, or lecture turn out to be
deadly boring, you
can have a wonderful
time with our planes.
All our models are
folded from one
paper sheet. They
are exclusively
folded without
20% using 30% any
adhesive. 80% 30%
Several models are equipped with a folded landing gear.
enabling a safe landing on the intended location provided
that you have aimed well. Other models are able to fly
loops or cover long distances.
8.2 207

esult = p.fit_textflow(textflow, left_x, left_y, right_x, right_y,
"wrap={usematchboxes={{img}}}");
text_output/wrap_text_around_images
fit_textflow( )
wrap
path = p.add_path_point( -1, 0, 100, "move", "");
path = p.add_path_point(path, 200, 100, "control", "");
path = p.add_path_point(path, 0, 100, "circular", "");
/* */
p.draw_path(path, x, y, "stroke");
result = p.fit_textflow(tf, llx1, lly1, urx1, ury1,
"wrap={paths={" +
"{path=" + path + " refpoint={100% 50%} }" +
"}}");
p.delete_path(path);
result = p.fit_textflow(tf, llx1, lly1, urx1, ury1,
"wrap={inversefill paths={" +
"{path=" + path + " refpoint={100% 50%} }" +
"}}");
load_image( )
clippingpathname
fit_textflow( ) wrap
scale
image = p.load_image("auto", "image.tif", "clippingpathname={path 1}");
/* */
path = (int) p.info_image(image, "clippingpath", "");
if (path == -1)
throw new Exception(" : !");
result = p.fit_textflow(tf, llx1, lly1, urx1, ury1,
208 8 : COM .NET REALbasic

"wrap={paths={{path=" + path + " refpoint={50% 50%} scale=2}}}");
p.delete_path(path);
clippingpathname fit_image( )
fit_image( ) info_image( )
fit_image( ) x/y wrap paths
refpoint
image = p.load_image("auto", "image.tif", "clippingpathname={path 1}");
/* */
String imageoptlist = "scale=2";
p.fit_image(image, x, y, imageoptlist);
/* */
path = (int) p.info_image(image, "clippingpath", imageoptlist);
if (path == -1)
throw new Exception(" : !");
result = p.fit_textflow(tf, llx1, lly1, urx1, ury1,
"wrap={paths={{path=" + path + " refpoint={" + x + " " + y + "} }}}");
p.delete_path(path);
fit_textflow( ) wrap
wrap={ polygons={ {50% 80% 20% 30% 80% 30% 50% 80%} } }
showborder=true wrap
wrap={ polygons={ {50% 80% 20% 30% 80% 30% 50% 80%}
{20% 90% 10% 70% 30% 70% 20% 90%} } }
fixedleading=true
text_output/wrap_text_around_polygons
8.2 209

8.27
50% 100%
Our
paper
planes are
the ideal way
of passing the
time. We offer a lot
of revolutionary brandnew
developments of the
10% 50% traditional common paper
planes. If your lesson, conference,
or lecture turn
out to be deadly boring,
you can have
a wonderful
time with
our planes.
90% 50%
8.28
Our paper planes are
the ideal way of passing
the time. We offer
revolutionary new developments
of the traditional
co- mmon paper
planes. If your lesson,
conf- erence, or
lecture turn out to be
deadly
boring,
you can have a wonderful
time with our planes. All
our models are folded
from one paper sheet.
50% 0%
wrap addfitbox
inversefill
wrap={ addfitbox polygons={ {50% 100% 10% 50% 50% 0% 90% 50% 50% 100%} } }
showborder=true
addfitbox
addfitbox
wrap={ addfitbox polygons=
{ {20% 10% 80% 10% 100% 50% 80% 90% 20% 90% 0% 50% 20% 10%}
{35% 35% 65% 35% 65% 65% 35% 65% 35% 35%} } }
addfitbox
text_output/fill_polygons_with_text
210 8 : COM .NET REALbasic

8.3
PDFlib tables
>
>
>
fit_table( )
>
1 Giant Wing
Material
Benefit
2 Long Distance Glider
Material
Benefit
3 Cone Head Rocket
Our Paper Plane Models
Offset print paper 220g/sqm
It is amazingly robust and
can even do aerobatics. But
it is best suited to gliding.
Drawing paper 180g/sqm
With this paper rocket you
can send all your messages
even when sitting in the
cinema pretty near the back.
Amazingly robust!
Material
Benefit
Kent paper 200g/sqm
This paper arrow can be
thrown with big swing. It
stays in the air a long time.
With big swing!
8.29
PDFlib API
add_table_cell( )
fit_table( )
8.3 211

add_table_cell( ) fit_table( )
tables/starter_table
8.3.1
fittextline font fontsize
{left center}
add_
table_cell( )
fit_table( )
tables/vertical_text_alignment
/* */
String tf_text = "It is amazingly robust and can even do aerobatics. " +
"But it is best suited to gliding.";
/* 12 */
int c1 = 80, c2 = 120;
/* */
double llx=100, lly=500, urx=300, ury=600;
/* */
font = p.load_font("Helvetica", "unicode", "");
if (font == -1)
throw new Exception("" + p.get_errmsg());
/* 1 */
optlist = "fittextline={position={left center} font=" + font + " fontsize=8} margin==4" +
colwidth=" + c1;
/* 11 */
tbl = p.add_table_cell(tbl, 1, 1, "Our Paper Planes", optlist);
if (tbl == -1)
throw new Exception("" + p.get_errmsg());
/* 12 */
212 8 : COM .NET REALbasic

tbl = p.add_table_cell(tbl, 1, 2, "Material", optlist);
if (tbl == -1)
throw new Exception("" + p.get_errmsg());
/* 13 */
tbl = p.add_table_cell(tbl, 1, 3, "Benefit", optlist);
if (tbl == -1)
throw new Exception("" + p.get_errmsg());
/* 2 */
optlist = "fittextline={position={left center} font=" + font + " fontsize=8} " +
"colwidth=" + c2 + " margin=4";
/* 22 */
tbl = p.add_table_cell(tbl, 2, 2, "Offset print paper 220g/sqm", optlist);
if (tbl == -1)
throw new Exception("" + p.get_errmsg());
/* */
optlist = "font=" + font + " fontsize=8 leading=110%";
tf = p.add_textflow(-1, tf_text, optlist);
/* */
optlist = "textflow=" + tf + " margin=4 colwidth=" + c2;
/* 23 */
tbl = p.add_table_cell(tbl, 2, 3, "", optlist);
if (tbl == -1)
throw new Exception("" + p.get_errmsg());
p.begin_page_ext(0, 0, "width=200 height=100");
/* */
optlist = "stroke={{line=frame linewidth=0.8} {line=other linewidth=0.3}}";
/* */
result = p.fit_table(tbl, llx, lly, urx, ury, optlist);
/* _stopOK*/
if (!result.equals("_stop")) {
if (result.equals( "_error"))
throw new Exception("" + p.get_errmsg());
else {
/* */
}
}
p.end_page_ext("");
/* */
p.delete_table(tbl, "");
optlist = "fittextline={position={left center} font=" + font +
" fontsize=8} colwidth=80 margin=4";
8.3 213

Benefit
8.30
Our Paper Planes
a)
Material
Benefit
Offset print paper 220g/sqm
It is amazingly robust and can
even do aerobatics. But it is
best suited to gliding.
b)
Our Paper Planes
Material
Benefit
Offset print paper 220g/sqm
It is amazingly robust and can
even do aerobatics. But it is
best suited to gliding.
fontsize=8
capheight
fontsize={capheight=6}
margin=4 rowheight
add_table_cell( )
/* */
optlist = "fittextline={position={left top} font=" + font +
" fontsize={capheight=6}} rowheight=14 colwidth=80 margin=4";
fontsize={capheight=6}
margin=4
/* */
optlist = "font=" + font + " fontsize={capheight=6} leading=110%";
Benefit
Benefit Material
fittextflow={firstlinedist=capheight}
/* */
optlist = "textflow=" + tf + " fittextflow={firstlinedist=capheight} "
"colwidth=120 margin=4";
214 8 : COM .NET REALbasic

tables/vertical_text_alignment
8.3.2
add_table_cell( )
....................
..............................................
..............................................
8.31
add_table_cell( ) text
fittextline fit_textline( )
fitmethod=nofit
fitmethod=auto shrinklimit
boxheight
{capheight none}
add_table_cell( ) create_textflow( ) add_textflow( )
textflow
fittextflow fit_textflow( )
fitmethod=clip
fitmethod=auto minfontsize
checkwordsplitting true
add_table_cell( ) load_image( )
begin_template_ext( )
image fitimage
fit_image( )
fitmethod=meet
8.3 215

PDF add_table_cell( ) open_pdi_
page( ) pdipage
fitpdipage fit_pdi_page( )
fitmethod=meet
add_table_cell( ) add_path_
point( ) path
fitpath draw_path( )
create_annotation( ) type
add_table_cell( ) annotationtype
fitannotation create_annotation( )
create_field( ) name type
add_table_cell( )
fieldnamefieldtype fitfield create_
field( )
add_table_cell( ) margin
8.32
8.3.3
colspan
rowspan
216 8 : COM .NET REALbasic

1
2
3
1 1
1 2
1 3
............ ............ ............
...... ...... ......
2 3
3 2
....
.... ....
8.33
4
1 4
2 4
....
1 2 3
colwidth
1
1
1
1
1
2
3
colspan=3
colwidth=50
colspan=2
colwidth=50
colspan=1
colwidth=50
colspan=1
colwidth=50
4
2
2
3
4
colspan=1
colwidth=100
colspan=1
colwidth=100
3
2
rowspan=3
colwidth=90
8.34
50 100 90
240
add_table_cell( ) colscalegroup
Max. Load
Range
Weight
Speed
8.35
Giant Wing
12g
18m
14g
8m/s
Long Distance Glider
5g
30m
11.2g
5m/s
Cone Head Rocket
7g
7m
12.4g
6m/s
8.3 217

8.3.4
tables/mixed_table_contents
double llx = 100, lly = 500, urx = 360, ury = 600; //
int c1 = 50, c2 = 120, c3 = 90; // 3
boldfont = p.load_font("Helvetica-Bold", "unicode", "");
normalfont = p.load_font("Helvetica", "unicode", "");
p.begin_page_ext(0, 0, "width=a4.width height=a4.height");
optlist = "fittextline={font=" + boldfont + " fontsize=12 position=center} " +
"margin=4 colspan=3 colwidth=" + c1;
tbl = p.add_table_cell(tbl, 1, 1, "Our Paper Plane Models", optlist);
if (tbl == -1)
throw new Exception("" + p.get_errmsg());
1 Giant Wing
fontsize={capheight=6}
Giant Wing
Giant Wing
optlist = "fittextline={position={left top} font=" + boldfont +
" fontsize={capheight=6}} rowheight=14 colwidth=" + c1 +
" margin=4 colspan=2 matchbox={fillcolor={gray .92}}";
tbl = p.add_table_cell(tbl, 1, 2, "1 Giant Wing", optlist);
if (tbl == -1)
throw new Exception("" + p.get_errmsg());
218 8 : COM .NET REALbasic

8.36
Our Paper Plane Models
1 Giant Wing
Material Offset print paper 220g/sqm
Benefit It is amazingly robust and can
even do aerobatics. But it is
best suited to gliding.
Amazingly robust!
MaterialBenefitOffset
print paper Offset print paper
optlist = "fittextline={position={left top} font=" + normalfont +
" fontsize={capheight=6}} rowheight=14 colwidth=" + c1 + " margin=4";
tbl = p.add_table_cell(tbl, 1, 3, "Material", optlist);
if (tbl == -1)
throw new Exception("" + p.get_errmsg());
tbl = p.add_table_cell(tbl, 1, 4, "Benefit", optlist);
if (tbl == -1)
throw new Exception("" + p.get_errmsg());
optlist = "fittextline={position={left top} font=" + normalfont +
" fontsize={capheight=6}} rowheight=14 colwidth=" + c2 + " margin=4";
tbl = p.add_table_cell(tbl, 2, 3, "Offset print paper 220g/sqm", optlist);
if (tbl == -1)
throw new Exception("" + p.get_errmsg());
It is amazingly
fontsize={capheight=6}
margin=4
tftext = "It is amazingly robust and can even do aerobatics. " +
"But it is best suited to gliding.";
optlist = "font=" + normalfont + " fontsize={capheight=6} leading=110%";
tf = p.add_textflow(-1, tftext, optlist);
if (tf == -1)
throw new Exception("Error: " + p.get_errmsg());
Benefit
Benefit Material
fittextflow={firstlinedist=capheight}
8.3 219

optlist = "textflow=" + tf + " fittextflow={firstlinedist=capheight} " +
"colwidth=" + c2 + " margin=4";
tbl = p.add_table_cell(tbl, 2, 4, "", optlist);
if (tbl == -1)
throw new Exception("" + p.get_errmsg());
Amazingly robust!
image = p.load_image("auto", "kraxi_logo.tif", "");
if (image == -1)
throw new Exception("" + p.get_errmsg());
optlist = "fittextline={font=" + boldfont + " fontsize=8} image=" + image +
" colwidth=" + c3 + " rowspan=3 margin=4";
tbl = p.add_table_cell(tbl, 3, 2, "Amazingly robust!", optlist);
if (tbl == -1)
throw new Exception("" + p.get_errmsg());
fit_table( )
int doc = p.open_pdi("kraxi_logo.pdf", "", 0);
if (tbl == -1)
throw new Exception("" + p.get_errmsg());
page = p.open_pdi_page(doc, pageno, "");
if (tbl == -1)
throw new Exception("" + p.get_errmsg());
optlist = "fittextline={font=" + boldfont + " fontsize=9} pdipage=" + page +
" colwidth=" + c3 + " rrowspan=3 margin=4";
tbl = p.add_table_cell(tbl, 3, 2, "Amazingly robust!", optlist);
if (tbl == -1)
throw new Exception("" + p.get_errmsg());
fit_table( ) header=1
fill area=header fillcolor={rgb
0.8 0.8 0.87} stroke
line=frame linewidth=0.8
line=other linewidth=0.3
optlist = "header=1 fill={{area=header fillcolor={rgb 0.8 0.8 0.87}}} " +
"stroke={{line=frame linewidth=0.8} {line=other linewidth=0.3}}";
result = p.fit_table(tbl, llx, lly, urx, ury, optlist);
if (result.equals("_error"))
throw new Exception("" + p.get_errmsg());
220 8 : COM .NET REALbasic

p.end_page_ext("");
8.3.5
fit_table( )
fit_table( )
Our Paper Plane Models
3 Cone Head Rocket
Material Kent paper 200g/sqm
BenefitOur Paper This paper Plane arrow can Models be
thrown with big swing. It
2 Long Distance Glider
stays in the air a long time.
Material Drawing paper 180g/sqm
BenefitOur Paper With this Plane paper rocket Models you
1 Giant Wing
can send all your messages
even when sitting in the
Material Offset print cinema paper pretty 220g/sqm near the back.
Benefit It is amazingly robust and
Amazingly robust!
can even do aerobatics. But
it is best suited to gliding.
With big swing!
3
8.37
2
1
do {
/* */
p.begin_page_ext(0, 0, "width=a4.width height=a4.height");
/* */
optlist = "header=1 stroke={{line=other}}";
/* */
result = p.fit_table(tbl, llx, lly, urx, ury, optlist);
if (result.equals("_error"))
throw new Exception("" + p.get_errmsg());
p.end_page_ext("");
} while (result.equals("_boxfull"));
8.3 221

* _stopOK*/
if (!result.equals("_stop")) {
if (result.equals( "_error"))
throw new Exception("" + p.get_errmsg());
else {
/* return
* */
throw new Exception ("");
}
}
/* */
p.delete_table(tbl, "");
fit_table( ) header footer
fill area=header area=footer
n
m
fit_table( )
rowjoingroup
vertshrinklimit
fit_table( ) _error
vertshrinklimit=100%
fit_table( )
horshrinklimit fit_table( )
_error
horshrinklimit=100%
222 8 : COM .NET REALbasic

1
1 Giant Wing
Material
Offset print paper 220g/sqm
Our paper planes are the
ideal way of passing the
time. We offer revolutionary
8.38
2
Benefit
It is amazingly robust and
can even do aerobatics. But
it is best suited to gliding.
new developments of the
traditional common paper
planes.
fit_table( ) minrowheight
minrowheight
It's amazingly robust
Benefit
1
1 Giant Wing
Material
Benefit
Offset print paper 220g/sqm
It is amazingly robust and
can even do aerobatics. But
8.39
2
Benefit
it is best suited to gliding.
8.3.6
fit_table( ) colwidth rowheight fittextline
fittextflow
colwidth rowheight
fittextline
boxheight {capheight
none}
8.3 223

colwidth rowheight
colwidth
rowheight
rowheight
fitmethod=auto
fittextline
fitmethod=auto
colscalegroup
checkwordsplitting=false
info_table( ) horboxgap
fitmethod=auto continuetextflow
rowscalegroup
repeatcontent=false
224 8 : COM .NET REALbasic

owjoingroup
return
fit_table( ) minrowheight
minrowheight
info_table( ) rowsplit
horshrinklimit
info_table( ) horshrinking
horshrinklimit
Calculated table width $1 is too large (> $2, shrinking $3)")
horshrinklimit
fit_table( ) rewind=1
8.3 225

8.4
fit_textline( ) fit_image( ) matchbox
>
> create_annotation( )
> fit_textline( )
boxheight
>
> info_matchbox( )
fitmethod=slice fitmethod=clip
fit_image( )
rect( )
info_matchbox( )
fit_image( )
PDFlib API
8.4.1
fit_textline( )
String optlist =
"font=" + normalfont + " fontsize=8 position={left top} " +
"matchbox={fillcolor={rgb 0.8 0.8 0.87} boxheight={capheight none}}";
p.fit_textline("Giant Wing Paper Plane", 2, 20, optlist);
boxheight boxheight={capheight none}
boxheight
boxheight={fontsize descender}
226 8 : COM .NET REALbasic

text_output/text_on_color
8.40
Giant Wing Paper Plane
fit_textline( ) matchbox
a) boxheight={capheight none}
Giant Wing Paper Plane
b) boxheight={ascender descender}
Giant Wing Paper Plane
c) boxheight={fontsize descender}
d)
Giant Wing Paper Plane
boxheight={fontsize descender} borderwidth=0.3
offsetleft=-2 offsetright=2 offsetbottom=-2
8.4.2
very dangerous
matchbox matchbox=end
8.41 matchbox
It is very dangerous to fly
the Giant Wing in a
thunderstorm.
create_textflow( )
It is very dangerous
to fly the Giant Wing in a
thunderstorm.
Web
kraxi
Link
kraxi
create_annotation( )
text_output/weblink_in_textflow
/* kraxi */
String tftext =
"For more information about the Giant Wing Paper Plane see the Web site of " +
"" +
"Kraxi Systems, Inc.";
String optlist = "font=" + normalfont + " fontsize=8 leading=110%";
tflow = p.create_textflow(tftext, optlist);
if (tflow == -1)
8.4 227

throw new Exception("" + p.get_errmsg());
result = p.fit_textflow(tflow, 0, 0, 50, 70, "fitmethod=auto");
if (!result.equals("_stop"))
{ /* ... */ }
/* URI */
optlist = "url={http://www.kraxi.com}";
act = p.create_action("URI", optlist);
/* kraxiLink */
optlist = "action={activate " + act + "} linewidth=0 usematchbox={kraxi}";
p.create_annotation(0, 0, 0, 0, "Link", optlist);
create_annotation( )
For information about
Giant Wing Paper
Planes see the Web
site of Kraxi Systems,
Inc.
8.42
Web
8.4.3
String optlist = "boxsize={130 130} fitmethod=meet matchbox={name=kraxi}";
p.fit_image(image, 10, 10, optlist);
interactive/link_annotations
fitmethod=meet
borderwidth matchbox
strokecolor linecap
linejoin
images/frame_around_image
offset
fit_image( )
228 8 : COM .NET REALbasic

8.43
fit_image( )
boxsize={60 60} position={center} fitmethod=meet
matchbox={name=kraxi borderwidth=4 offsetleft=-2 offsetright=2
offsetbottom=-2 offsettop=2 linecap=round linejoin=round
strokecolor {rgb 0.0 0.3 0.3}}
meet
info_matchbox( )
(x2, y2)
images/align_text_at_image
/* */
String optlist = "boxsize={300 200} position={center} fitmethod=meet " +
"matchbox={name=giantwing borderwidth=3 strokecolor={rgb 0.85 0.83 0.85}}";
/* */
/* */
if ((int) p.info_matchbox("giantwing", 1, "exists") == 1)
{
x1 = p.info_matchbox("giantwing", 1, "x2");
y1 = p.info_matchbox("giantwing", 1, "y2");
}
/* 2 */
p.fit_textline("Foto: Kraxi", x2+2, y2+2, "font=" + font + " fontsize=8 orientate=west");
8.44
Foto: Kraxi
(x2, y2)
orientate=west
8.4 229

230 8 : COM .NET REALbasic

9pCOS
PDFlib Comprehensive Object Syntax
www.adobe.com/devnet/pdf/pdf_reference.html
9.1 pCOS
pCOS PDFlib
pCOS
PDF_pcos_get_number( ) PDF_
pcos_get_string( ) PDF_pcos_get_stream( )
length:pages
/Info/Title
Title Author Subject Keywords Creator Producer
CreationDate ModDate Trapped
/Root/Metadata
fonts[...]/name length:fonts
fonts[...]/vertical
fonts[...]/embedded
pages[...]/width
pagecount = p.pcos_get_number(doc, "length:pages");
objtype = p.pcos_get_string(doc, "type:/Info/Title");
if (objtype.equals("string"))
{
/* */
9.1 pCOS 231

}
title = p.pcos_get_string(doc, "/Info/Title");
MediaBox CropBox Rotate
pages width height
pages
pagenum = 2
width = p.pcos_get_number(doc, "pages[" + pagenum + "]/width");
height = p.pcos_get_number(doc, "pages[" + pagenum + "]/height");
fontcount = p.pcos_get_number(doc, "length:fonts");
for (i=0; i < fontcount; i++)
{
fontname = p.pcos_get_string(doc, "fonts[" + i + "]/name");
embedded = p.pcos_get_number(doc, "fonts[" + i + "]/embedded");
}
char_info fontid
if (p.pcos_get_number(doc, "fonts[" + ci->fontid + "]/vertical"))
{
/* */
}
pcosmode
if (p.pcos_get_number(doc, "pcosmode") == 2)
{
/* pCOS */
}
XMP
objtype = p.pcos_get_string(doc, "type:/Root/Metadata");
if (objtype.equals("stream"))
{
/* XMP */
metadata = p.pcos_get_stream(doc, "", "/Root/Metadata");
}
232 9 : pCOS COM .NET REALbasic

9.2 PDF
PDF_pcos_get_number( )PDF_pcos_get_string( )PDF_pcos_get_stream( )
PDF_pcos_get_number( )
PDF_pcos_get_string( )
>
>
PDF_pcos_get_string( )
PDF_pcos_get_stream( )
PDF_pcos_get_number( )
PDF_pcos_get_string( )
true false
PDF_pcos_get_stream( )
stream fstream
PDF_pcos_get_stream( ) keepfilter stream
filterinfo
stream stream
PDF_pcos_get_stream( )
pCOS JBIG2 JPX
fstream fstream
PDF_pcos_get_stream( )
PDF_pcos_get_stream( )
9.2 PDF 233

get_stream( )
convert=unicode
234 9 : pCOS COM .NET REALbasic

9.3 ID
N
length N-1
null
N
length N-1
.key
.val
length
MediaBox
pages[ ]
/Pages objects[ ]
pages[ ][ ]
pCOS ID
pcosid
objects[]
9.3 ID 235

9.4
PDF_pcos_get_number( ) PDF_pcos_get_string( ) PDF_pcos_
get_stream( )
[:][[]]/[]/[] ... [.key|.val]
>
>
>
>
> .key .val
pCOS
> / [ ] #
>
>
ebcdic
236 9 : pCOS COM .NET REALbasic

length
pcosid type
length
pcosid
type
array
dict
stream
Length
fstream
-
0, null
1, boolean
2, number
3, name
4, string
5, array
6, dict
7, stream
8, fstream
9.4 237

9.5
dict
requiredmode
encrypt
extensionlevel
filename
filesize
length
algorithm
description
-1
0
1
2
3
4
5
6
7
8
9
10
master
true false
user true false
noaccessible noannots noassemble nocopy noforms nohiresprint nomodify noprint
true false
plainmetadata
true false
238 9 : pCOS COM .NET REALbasic

fullpdfversion
BaseVersion ExtensionLevel
150
160
170
173
linearized
major
minor
revision
pcosinterface
pdfversion
pcosmode
pcosmodename
pdfversionstring
version
true false
1
2
3
4
5
0
1
2
PDF
articles
articles
beads
destpage
9.5 239

ookmarks
fields
names
objects
bookmarks
level
destpage
fields
level
fullname
AP
AlternatePresentations Dests EmbeddedFiles IDS JavaScript Pages Renditions Templates
URLS
names/Dests[0].key
names/Dests[0].val
Dests
destpage
/Root/
Names/Dests
pcosid
length
240 9 : pCOS COM .NET REALbasic

pages
pdfa
pdfe
pdfx
tagged
/Pages /MediaBox
/Rotate
colorspaces extgstates fonts images patterns properties shadings templates
annots annots
destpage Subtype=Link Dest
blocks pages[ ]/PieceInfo/PDFlib/Private/Blocks[ ]
blocks
rect
height
isempty true false
label
/Root/PageLabels
width
CropBox MediaBox Resources Rotate
none PDF/A-1a:2005 PDF/A-1b:2005 PDF/A-
2a PDF/A-2b PDF/A-2u
none PDF/E-1
none
PDF/X-1:2001 PDF/X-1a:2001 PDF/X-1a:2003
PDF/X-2:2003
PDF/X-3:2002 PDF/X-3:2003
PDF/X-4 PDF/X-4p
PDF/X-5g PDF/X-5n PDF/X-5p
true false
9.5 241

>
> images[ ]
> pages[ ]/images[ ]
P[ ] pages[ ]/P[ ]
colorspaces
alternateid
name=Separation DeviceN
colorspaces[]
baseid name=Indexed colorspaces[]
colorantname
name=Separation
colorantnames
name=DeviceN
components
name CalGray CalRGB DeviceCMYK DeviceGray DeviceN
DeviceRGB ICCBased Indexed Lab Separation
csarray name=DeviceGray/RGB/CMYK
242 9 : pCOS COM .NET REALbasic

P[ ] pages[ ]/P[ ]
extgstates
fonts
images
name
embedded
type (unknown) Composite Multiple Master OpenType
TrueType TrueType (CID) Type 1 Type 1 (CID) Type 1 CFF Type 1 CFF (CID) Type 3
vertical true false
bpc BitsPerComponent
colorspaceid
colorspaces[]
filterinfo keepfilter true
filterinfo
name
supported true
decodeparms
DecodeParms
mergetype
0
1 mergetype=2
2
mergetype=1
length:images
patterns
properties
9.5 243

P[ ] pages[ ]/P[ ]
shadings
templates
colorspaceid
colorspaces[]
Form XObject
244 9 : pCOS COM .NET REALbasic

9.6 PDF
pCOS
pCOS
stream fstream
> nocopy=false plainmetadata=true /Root/Metadata /Info/*
> nocopy=false
bookmarks[]/Title pages[...]/annots/Contents
pCOS
encrypt
9.6 PDF 245

246 9 : pCOS COM .NET REALbasic

10 PDF
10.1 Acrobat PDF
>
>
>
>
>
>
begin_document( ) compatibility
PDI PDF
compatibility
PDF
PDF
>
>
>
begin_document( ) viewports
load_image( ) georeference
begin_document( ) portfolio
add_portfolio_folder( )
begin_document( ) compatibility=1.7ext3
masterpassword userpassword attachmentpassword permissions
set_layer_dependency( ) Variant
10.1 Acrobat PDF 247

open_pdi_page( ) begin_template_ext( ) reference
add_portfolio_file( )
begin/end_document( ) userunit
begin/end_document( ) viewerpreferences
printscaling
begin/end_document( ) openmode=attachments
begin_document( ) compatibility=1.6 1.7
masterpassword userpassword attachmentpassword permissions
begin/end_document( ) attachmentpassword
begin/end_document( ) attachments
description
load_3ddata( ) create_3dview( ) create_annotation( ) type=3D
create_field( ) create_fieldgroup( )
begin/end_document( ) pagelayout=twopageleft/right
create_annotation( )
begin_document( ) permissions=plainmetadata
load_font( )
begin_item( )
begin/end_page_ext( ) taborder
define_layer( ) begin_layer( ) end_layer( ) layer_dependency( )
load_image( ) imagetype=jpeg2000
compatibility=1.5 begin_
document( ) objectstreams=none
shading_pattern( ) shfill( ) shading( )
load_image( )
load_image( ) imagetype=jbig2
userpassword masterpassword permissions begin_
document( )
permissions begin_document( )
248 10 : PDF COM .NET REALbasic

load_font( )
alphaisshape blendmode opacityfill opacitystroke
textknockout create_gstate( )
create_action( )
create_annotation( )
create_field( ) create_fieldgroup( )
begin_document( ) tagged
open_pdi_page( ) begin_template_ext( ) reference
10.1 Acrobat PDF 249

10.2 ISO 32000
compatibility=pdf1.7ext3
250 10 : PDF COM .NET REALbasic

10.3 PDF/X
10.3.1 PDF/X
PDF/X-1a:2001 ISO 15930-1
PDF/X-1a:2003 ISO 15930-4
PANTONE® PDF/X-1a
PDF/X-3:2002 ISO 15930-3
PDF/X-3:2003 ISO 15930-6
PDF/X-4 ISO 15930-7
>
>
PDF/X-5 ISO 15930-8
>
>
>
1. www.globalgraphics.com/products/pdfx/index.html PDF/X FAQ
10.3 PDF/X 251

Acrobat Acrobat
9 9.3.1 PDF/X-5
10.3.2 PDF/X
PDF/X PDFlib pdfx
>
>
>
>
begin_document( ) pdfx
begin_document( ) load_iccprofile( ) usage=outputintent
process_pdi( ) action=copyoutputintent
load_font( ) embedding true
252 10 : PDF COM .NET REALbasic

RGB
CMYK
cropbox bleedbox trimbox artbox
>
>
>
setcolor( )
begin_page_ext( ) defaultgray
setcolor( )
begin_page_ext( ) defaultrgb
setcolor( )
begin_page_ext( ) defaultcmyk
Creator Title set_info( )
begin/end_document( ) metadata CreatorTool dc:title
RGB
CMYK
ICC
Lab
JavaScript
begin_page_ext( ) defaultgray
begin_page_ext( ) defaultrgb
begin_page_ext( ) defaultcmyk
setcolor( ) iccbasedgray/rgb/cmyk setcolor:iccprofilegray/
rgb/cmyk
setcolor( )
create_annotation( ) create_field( )
10.3 PDF/X 253

PDF
PDF PDI
load_image( ) OPI-1.3 OPI-2.0
load_image( )
masked
load_image( ) ignoremask create_gstate( )
opacityfill opacitystroke
begin/end_page_ext( ) begin_template_ext( ) open_pdi_page( ) transparencygroup
transparencygroup colorspace
>
begin_
page_ext( ) defaultgray
>
begin_page_ext( ) defaultrgb
>
begin_page_ext( )
defaultcmyk
begin/end_document( ) viewerpreferences viewarea viewclip
printarea printclip media bleed
set_info( ) Trapped pdf:Trapped
True False
begin_document( ) userpassword masterpassword permissions
254 10 : PDF COM .NET REALbasic

egin_template_ext( ) open_pdi_page( ) reference
begin_template_ext( ) open_pdi_page( ) reference
>
set_layer_dependency( )
type=variant
> define_layer( ) set_layer_dependency( )
10.3.3
>
>
StandardOutputIntent
if (p.load_iccprofile("CGATS TR 001", "usage=outputintent") == -1)
{
/* */
}
>
p
10.3 PDF/X 255

urls
if (p.load_iccprofile("CGATS TR 001",
"usage=outputintent urls={http://www.color.org}") == -1)
{
/* */
}
PDF/X
10.3.4 PDI PDF/X
256 10 : PDF COM .NET REALbasic

PDF/X-1a:2001
PDF/X-1a:2003
PDF/X-3:2002
PDF/X-3:2003
PDF/X-4
PDF/X-4p
PDF/X-5g
PDF/X-5pg
PDF/X-1a:2001
PDF/X-1a:2003
PDF/X-3:2002
PDF/X-3:2003
PDF/X-4
PDF/X-4p
PDF/X-5g
PDF/X-5pg
process_pdi( ) action=copyoutputintent
open_pdi_page( )
pdfxlevel = p.pcos_get_string(doc, "pdfx");
none
begin_document( ) pdfx
PDF/X
ret = p.process_pdi(doc, -1, "action=copyoutputintent");
load_iccprofile( )
load_iccprofile( ) usage=outputintent
10.3 PDF/X 257

10.4 PDF/A
10.4.1 PDF/A
PDF/A
www.pdfa.org
Member of…
ISO 19005-1 PDF/A-1a:2005 PDF/A-1b:2005
>
>
>
>
>
>
10.4.2 PDF/A
PDF/A PDFlib pdfa
258 10 : PDF COM .NET REALbasic

>
>
>
PDF/A-1b
RGB
CMYK
begin_document( ) pdfa PDF/A-
1a:2005 PDF/A-1b:2005
begin_document( ) load_iccprofile( ) usage=outputintent
process_pdi( ) action=copyoutputintent
load_iccprofile( ) embedprofile
load_font( ) embedding
optimizeinvisible
setcolor( )
begin_page_ext( ) defaultgray
setcolor( )
begin_page_ext( ) defaultrgb
setcolor( )
begin_page_ext( ) defaultcmyk
10.4 PDF/A 259

JavaScript
ICC
PDF /
PDF PDI
create_annotation( ) type=FileAttachment zoom rotate true
annotcolor interiorcolor
fillcolor
create_field( ) create_fieldgroup( )
create_action( ) type=Hide Launch ResetForm ImportData JavaScript
type=name NextPage PrevPage FirstPage LastPage
load_image( ) OPI-1.3 OPI-2.0 interpolate=true
load_iccprofile( )
begin_template_ext( ) OPI-1.3 OPI-2.0
load_image( ) masked
load_image( ) ignoremask
create_gstate( ) opacityfill opacitystroke blendmode
Normal
create_annotation( ) opacity
begin/end_page_ext( ) begin_template_ext( ) open_pdi_page( ) transparencygroup
begin_document( ) userpassword masterpassword permissions
begin_template_ext( ) open_pdi_page( ) reference
PDF/A-1a
260 10 : PDF COM .NET REALbasic

PDF
> begin/end_document( ) Lang
> begin_item( ) Lang
> begin_item( ) Alt
> begin_item( )
ActualText
> begin_item( ) E
create_annotation( ) contents
PDF PDI
load_font( ) monospace unicodemap=false autocidfont=false
icc = p.load_iccprofile("sRGB", "usage=outputintent");
process_pdi( ) action=copyoutputintent
PDF/A PDF/X
begin_document( ) pdfa
pdfx
ret = p.begin_document("combo.pdf", "pdfx=PDF/X-4 pdfa=PDF/A-1b:2005");
embedprofile
10.4 PDF/A 261

10.4.3 PDF/A PDI
PDFlib PDF PDF/A PDF
PDF/A
open_pdi_
document( )
pdfa/import_pdfa
pdfalevel = p.pcos_get_string(doc, "pdfa");
262 10 : PDF COM .NET REALbasic

none
begin_document( ) pdfa
PDF/A
pdfa/import_pdfa
load_iccprofile( )
load_iccprofile( ) usage outputintent
begin_document( )
10.4.4 PDF/A
> load_image( )
> setcolor( )
>
>
ICC
RGBICC
sRGB
CMYKICC
10.4 PDF/A 263

(0, 0, 0)
p.setcolor("fillstroke", "lab", 0, 0, 0, 0);
PDF/A www.pdfa.org PDF/A
Technical Note 0002
10.4.5 PDF/A XMP
CreationDate
begin/end_document( ) metadata
/Root/Metadata
interchange/import_xmp_from_pdf
XMP
1. www.aiim.org/documents/standards/xmpspecification.pdf
264 10 : PDF COM .NET REALbasic

XMP
begin_document( ) end_document( )
metadata
XMP pdfa/pdfa_extension_schemapdfa/
pdfa_extension_schema_with_type
10.4 PDF/A 265

10.4.6 PDF/A
PDF/A
www.pdflib.com/developer/pdfa/validation-report
Acrobat 9.1
Acrobat 9.0
Acrobat PDF/A
10.4.7 PDF/A Acrobat
... PDF/A
>
>
266 10 : PDF COM .NET REALbasic

10.5 PDF
PDFlib PDF
PDF PDFlib document_
interchange
10.5.1 PDFlib PDF
document_interchange/starter_tagged
PDF
begin_document( ) tagged true
begin_document( ) lang
begin_item( ) end_item( )
Unicode
begin_item( ) ActualText Alt
begin_mc( ) ActualText
10.5 PDF 267

PDF
ActualText
Artifact
>
>
>
PDFlib API
ASpan begin_item( )
inline
inline=false
268 10 : PDF COM .NET REALbasic

Type 3
autospace
begin_item( ) tag=Artifact
begin_font( )
familyname stretch weight
begin/end_document( ) taborder
10.5.2 PDF
PDF
P
autospace
if (p.begin_document("hello-tagged.pdf", "tagged=true") == -1)
throw new Exception("" + p.get_errmsg());
/* */
p.set_parameter("autospace", "true");
/* (=0) */
id = p.begin_item("P", "Title={Simple Paragraph}");
p.begin_page_ext(0, 0, "width=a4.width height=a4.height");
font = p.load_font("Helvetica-Bold", "unicode", "");
p.setfont(font, 24);
p.show_xy("Hello, Tagged PDF!", 50, 700);
p.continue_text("This PDF has a very simple");
p.continue_text("document structure.");
p.end_page_ext("");
p.end_item(id);
p.end_document("");
10.5 PDF 269

PDF
>
>
fit_textflow( )
>
>
10.5.3
>
>
>
/* */
id_art = p.begin_item("Art", "Title=Article");
id_sect1 = p.begin_item("Sect", "Title={First Section}");
/* 1 */
p.set_text_pos(x1_left, y1_left_top);
...
/* 2 */
p.set_text_pos(x1_left, y1_left_bottom);
...
/* 3 */
270 10 : PDF COM .NET REALbasic

10.1
1
4
6
7
1
6
5
2 3
4
8
1
2
5
3
4 6
7
8
p.set_text_pos(x1_right, y1_right_top);
...
p.end_item(id_sect1);
id_sect2 = p.begin_item("Sect", "Title={Second Section}");
/* 4 */
p.set_text_pos(x2_right, y2_right);
...
/* 2 */
p.end_item(id_sect2);
String optlist = "Title=Table parent=" + id_art;
id_table = p.begin_item("Table", optlist);
/* 5 */
p.set_text_pos(x_start_table, y_start_table);
...
p.end_item(id_table);
optlist = "Title=Insert parent=" + id_art;
id_insert = p.begin_item("P", optlist);
/* 6 */
p.set_text_pos(x_start_table, y_start_table);
...
p.end_item(id_insert);
id_artifact = p.begin_item("Artifact", "");
/* 7+8 */
p.set_text_pos(x_header, y_header);
...
p.set_text_pos(x_footer, y_footer);
...
p.end_item(id_artifact);
/* */
10.5 PDF 271

...
p.end_item(id_art);
activate_item( )
/* */
id_header = p.begin_item("Artifact", "");
/* 1 */
p.set_text_pos(x_header, y_header);
...
p.end_item(id_header);
id_art = p.begin_item("Art", "Title=Article");
id_sect1 = p.begin_item("Sect", "Title = {First Section}");
/* 2 */
p.set_text_pos(x1_left, y1_left_top);
...
String optlist = "Title=Table parent=" + id_art;
id_table = p.begin_item("Table", optlist);
/* 3 */
p.set_text_pos(x_start_table, y_start_table);
...
p.end_item(id_table);
/* 1 */
p.activate_item(id_sect1);
/* 4 */
p.set_text_pos(x1_left, y1_left_bottom);
...
optlist = "Title=Insert parent=" + id_art;
id_insert = p.begin_item("P", optlist);
/* 5 */
p.set_text_pos(x_start_table, y_start_table);
...
p.end_item(id_insert);
/* 1 */
p.activate_item(id_sect1);
/* 6 */
p.set_text_pos(x1_right, y1_right_top);
...
p.end_item(id_sect1);
id_sect2 = p.begin_item("Sect", "Title={Second Section}");
/* 7 */
p.set_text_pos(x2_right, y2_right);
...
/* 2 */
p.end_item(id_sect2);
272 10 : PDF COM .NET REALbasic

id_footer = p.begin_item("Artifact", "");
/* 8 */
p.set_text_pos(x_footer, y_footer);
...
p.end_item(id_footer);
/* */
...
p.end_item(id_art);
activate_item( )
10.5.4 Acrobat PDF
Acrobat
>
>
Figure
>
> BBox BBox
BBox
P H
BBox BBox
> TR TD TH THead TBody
Caption
> Private
Private
> topdown
10.5 PDF 273

>
Span
>
>
>
Acrobat
> create_field( ) create_fieldgroup( )
tooltip
>
Acrobat
> Form ActualText
Alt
> NonStruct
> Code Quote Reference
Alt
ActualText
Acrobat
> AltActualText
274 10 : PDF COM .NET REALbasic

11 PPS PDFlib Block Plugin
>
>
>
>
PDFlib Personalization Server PPS PPS
PDFlib PPS
PDFlib PDFlib+PDI
PDF Adobe Acrobat PDFlib
Block Plugin
PDFlib blocks
11.1 PDFlib Block Plugin
>
>
Acrobat
Acrobat
Windows Acrobat 7/8/9 PDFlib Block Plugin
Block.api AcroFormConversion.api
C:\Program Files\Adobe\Acrobat 9.0\Acrobat\plug_ins\PDFlib Block Plugin
11.1 PDFlib Block Plugin 275

Mac Acrobat 8/9 PDFlib Block Plugin
>
>
/Applications/Adobe Acrobat 9.0 Professional
>
>
> ... PDFlib Block Plugin
Intel
PPC
> ...
>
276 11 : PPS PDFlib Block Plugin COM .NET REALbasic

11.2 PDFlib
11.2.1
>
>
11.2.2
firstname
lastname zipcode
>
>
>
> PDF
11.2 PDFlib 277

fill_textblock( )
11.2.3 PDF ?
278 11 : PPS PDFlib Block Plugin COM .NET REALbasic

11.2 PDFlib 279

11.3 PDFlib Block Plugin
11.3.1
>
> PDFlib PDFlib
rotate
PDF
PDF Acrobat
...
Acrobat Enfocus PitStop PDFlib
This document contains PieceInfo from PDFlib. Press OK to continue editing or Cancel to
abort.
OK
>
>
>
PDFlib
280 11 : PPS PDFlib Block Plugin COM .NET REALbasic

11.1
Delete
PDFlib
> ...
>
Rect
fontsize
11.3 PDFlib Block Plugin 281

11.2
Acrobat
>
>
> ...
PDFlib
282 11 : PPS PDFlib Block Plugin COM .NET REALbasic

fontnamefontsizefillcolorcharspacinghorizscalingwordspacing
textrenderingtextrise
PDFlib
11.3.2
hortabmethodruler
linewidth fitmethod
orientate ...
backgroundcolor defaultimage fontname
11.3 PDFlib Block Plugin 283

Enter
> Name Type Rect Description
>
defaulttext defaultimage defaultpdf
290
> PDFlib PDFlib
>
>
>
Enter
284 11 : PPS PDFlib Block Plugin COM .NET REALbasic

NameDescriptionSubtypeTypeRectStatus
11.3.3
>
>
>
>
...
>
>
>
>
>
> PDFlib
...
>
>
11.3 PDFlib Block Plugin 285

PDFlib
...
PDFlib
...
11.3.4 PDF PDFlib
PDFlib
PDFlib
...
286 11 : PPS PDFlib Block Plugin COM .NET REALbasic

PDFlib:field:name
PDFlib:field:pagenumber
PDFlib:field:type
PDFlib:field:value
pushbutton checkbox radiobutton listbox
combobox textfield signature
type=checkbox
PDFlib
...
PDFlib ...
>
>
>
11.3 PDFlib Block Plugin 287

Rect
Name
Description
fontname
fontsize auto
fitmethod auto
strokecolor fillcolor
bordercolor
backgroundcolor
linewidth
Status
active
ignore
ignore
active
orientate north west south east
defaulttext
position
{left center}
{center center}
{right center}
defaulttext
defaulttext
defaulttext
288 11 : PPS PDFlib Block Plugin COM .NET REALbasic

11.3.5 Block Plugin
default.PPSoptions
> /Block_Plugin/MainDialog/CloseOnApply
> /Block_Plugin/FontDialog/ShowBaseFonts
fontname
> /Block_Plugin/Command/ControlByClick PDFlib
> /Block_Plugin/Command/DetectFonts PDFlib
11.3 PDFlib Block Plugin 289

11.4 Acrobat
PDFlib block_template.pdf
defaulttext
defaultimage defaultpdf
Status=ignoredefault
defaulttext defaultimage defaultpdf
charref true
charref=true
&.smileface;
charref=false
J
> PDFlib
290 11 : PPS PDFlib Block Plugin COM .NET REALbasic

11.3
>
>
...
PDFlib ...
>
>
>
>
>
> PPS
PDF_set_option( ) searchpath
11.4 Acrobat 291

>
>
PDF PDF/A-1b PDF/X
>
PDF PDF/A-1b PDF/X
PDF/A PDF/X PDF PDF/A-1b PDF/X
PDF/A-1b:2005
PDF/X-1a:2001PDF/X-1a:2003
PDF/X-3:2002PDF/X-3:2003
PDF/X-4PDF/X-4p
PDF/X-5gPDF/X-5pg
>
>
>
>
292 11 : PPS PDFlib Block Plugin COM .NET REALbasic

11.4
PDF
11.4 Acrobat 293

11.5 PPS
fit_pdi_page( )
fill_*block( )
firstname
doc = p.open_pdi_document(filename, "");
if (doc == -1)
throw new Exception(" : " + p.get_errmsg());
page = p.open_pdi_page(doc, pageno, "");
if (page == -1)
throw new Exception(" : " + p.get_errmsg());
p.begin_page_ext(width, height, "");
/* */
p.fit_pdi_page(page, 0.0, 0.0, "");
/* */
p.fill_textblock(page, "firstname", "Serge", "encoding=winansi");
p.close_pdi_page(page);
p.end_page_ext("");
p.close_pdi_document(doc);
blocks/starter_block
>
>
>
>
fill_*block( )
p.fill_textblock(page, "firstname", "Serge", "fontsize=12");
fontsize
294 11 : PPS PDFlib Block Plugin COM .NET REALbasic

fit_pdi_page( ) blind
/* blind */
p.fit_pdi_page(page, 0.0, 0.0, "blind");
/* */
p.fill_textblock(page, "firstname", "Serge", "encoding=winansi");
/* ... ... */
/* */
p.fit_pdi_page(page, 0.0, 0.0, "");
blocks/block_below_contents
fit_pdi_page( ) blind
blocks/duplicate_block
fill_textblock( )
> fill_textblock( )
textflowhandle
fill_textblock( )
> fill_textblock( )
textflowhandle text
11.5 PPS 295

> info_textflow( )
fitmethod clip textflowhandle
p.fit_pdi_page(page, 0.0, 0.0, "");
tf = -1;
for (i = 0; i < blockcount; i++)
{
String optlist = "encoding=winansi textflowhandle=" + tf;
tf = p.fill_textblock(page, blocknames[i], text, optlist);
text = null;
if (tf == -1)
break;
/* fit_textflow() */
reason = (int) p.info_textflow(tf, "returnreason");
result = p.get_parameter("string", (float) reason);
}
/* */
if (result.equals("_stop"))
{
p.delete_textflow(tf);
break;
}
blocks/linked_textblocks
fill_*block( )
> backgroundcolor None
> bordercolor None
> bordercolor linewidth
>
blind
> fit_pdi_page( )
> fit_table( )
296 11 : PPS PDFlib Block Plugin COM .NET REALbasic

fill_pdfblock( )
>
>
blocks/nested_blocks
fit_pdi_page( )
makespotcolor( )
11.5 PPS 297

11.6
PDF
fit_image( )
fitmethod charspacing
11.6.1
Description
Locked
Name
Subtype
textflow
Type
true
false
Text Image PDF
Text
textflow
false
false fit_textline( )
true
fit_textflow( )
Block
11.6.2
backgroundcolor
None
None
298 11 : PPS PDFlib Block Plugin COM .NET REALbasic

ordercolor
linewidth
Rect
Status
None
None
bordercolor
active
active
ignore
ignoredefault
defaulttext/image/pdf
active
static
11.6.3
>
>
blendmode
opacityfill
opacitystroke
Normal
NoneColorColorDodgeColorBurnDarkenDifference
ExclusionHardLightHueLightenLuminosityMultiplyNoneNormalOverlay
SaturationScreenSoftLight None
11.6 299

charspacing
fillcolor
fontname 1
fontsize 1
fontstyle
horizscaling
italicangle
kerning
monospace
overline
strikeout
strokecolor
strokewidth
textrendering
fontsize
true underline strikeout overline
false
gray 0
load_font( )
fontname
fill_textblock( )
font
normal bold italic bolditalic
false
false
false
gray 0
textrendering
percentage
auto auto
P
0 4
1 5
P
2 6
3 7
textrise
underline
decorationabove
underlineposition
fontsize
false
fontsize auto
300 11 : PPS PDFlib Block Plugin COM .NET REALbasic

wordspacing
fontsize
auto
fontsize
11.6.4
charref
underlinewidth
escapesequence
features
language
script
shaping
true
charref
true
escapesequence
script language
_none vert novert
< >
liga ital tnum smcp swsh zero
no< > no noliga
_none vert
load_font( ) readfeatures
script
features shaping
ARA JAN
HIN _none
shaping=true
features shaping advancedlinebreak
_none latn grek cyrl
armn hebr arab deva beng guru gujr orya taml thai laoo tibt hang kana han
_auto
_latn _none
_none
true script language
script _none
false
11.6 301

11.6.5
stamp
create_textflow( ) optlist
fill_textblock( )
defaulttext
alignment
fixedleading
adjustmethod
advancedlinebreak
avoidemptybegin
hortabmethod
hortabsize
minspacing maxspacing
auto
auto shrink spread nofit split
clip
nofit
shrink
split
spread
rightindent
nofit
nofitlimit
shrinklimit
nofit
spreadlimit nofit
locale script
false
left
left leftindent
center leftindent rightindent
right rightindent
justify
true false
true
false
relative
relative hortabsize
typewriter hortabsize
ruler
ruler
relative
hortabmethod
302 11 : PPS PDFlib Block Plugin COM .NET REALbasic

lastalignment
leading
locale
maxspacing
minspacing
minlinecount
nofitlimit
parindent
rightindent
leftindent
ruler 2
shrinklimit
spreadlimit
stamp
alignment
auto
auto alignment justify left
advancedlinebreak=true
>
en de ja language
>
Hira Hebr Arab Thai
>
DE CH GB
_none
_none
de_DE en_US en_GB
wordspacing minspacing
maxspacing
nofit
leftindent
leftindent
hortabmethod=ruler
hortabsize
shrink
horizscaling
spread
charspacing
position fitmethod orientate
north south none
ll2ur
ul2lr
none
11.6 303

tabalignchar
tabalignment
ruler
left
center
decimal tabalignchar tabalignchar
left
right
11.6.6
>
>
fitmethod=clip
fitmethod=nofit
alignchar
dpi
fitmethod
orientate=north south position
orientate=west east position
none fitmethod
alignchar
none
fitmethod auto meet
slice entire
auto nofit clip meet slice entire
auto
auto fontsize leading
nofit
clip
304 11 : PPS PDFlib Block Plugin COM .NET REALbasic

margin
minfontsize
orientate
position
rotate
scale
shrinklimit
fitmethod=auto shrinklimit
minfontsize
north east south west
north
auto
right left
fitmethod
auto meet slice entire
fitmethod=auto
firstlinedist
fitmethod
fixedleading=true
leading
leading
ascender
capheight
xheight
fixedleading=false leading ascender xheight capheight
auto nofit
clip auto
auto fontsize leading
nofit
clip
11.6 305

lastlinedist
linespreadlimit
maxlines
minfontsize
orientate
rotate
verticalalign
fitmethod=nofit
fixedleading=true
descender
fixedleading=false
verticalalign=justify
auto
fit_
textflow( ) _boxfull
fitmethod=auto
_boxfull
north east south west
north
top
top
center
bottom
justify
linespreadlimit
firstlinedist=leading
11.6.7
11.6.8
306 11 : PPS PDFlib Block Plugin COM .NET REALbasic

defaultimage
defaultpdf
defaultpdfpage
defaulttext
winansi
11.6 307

11.7 pCOS
PDF
blocks/query_block_properties
pagenum
blockcount = (int) p.pcos_get_number(doc, "length:pages[" + pagenum + "]/blocks");
pagenum blocknum
blockname = p.pcos_get_string(doc,
"pages[" + pagenum + "]/blocks[" + blocknum + "]/Name");
length
Blocks
< > Name < >
pages[...]/blocks[]
pages[...]/blocks/
foo
(llx, lly) (urx, ury)
llx = p.pcos_get_number(doc, "pages[" + pagenum + "]/blocks/foo/Rect[0]");
lly = p.pcos_get_number(doc, "pages[" + pagenum + "]/blocks/foo/Rect[1]");
urx = p.pcos_get_number(doc, "pages[" + pagenum + "]/blocks/foo/Rect[2]");
ury = p.pcos_get_number(doc, "pages[" + pagenum + "]/blocks/foo/Rect[3]");
Rect
refpoint boxsize
topdown
308 11 : PPS PDFlib Block Plugin COM .NET REALbasic

pagenum b1 zipcode
zip = p.pcos_get_string(doc, "pages[" + pagenum + "]/blocks/b1/Custom/zipcode");
b1
propname = p.pcos_get_string(doc, "pages[" + pagenum + "]/blocks/b1/Custom[0].key");
length
type null
acme.com:digits
acme.com:refnumber
11.7 pCOS 309

11.8 PDFlib
11.8.1 PDFlib PDF
PieceInfo
PDFlib
LastModified
Private
Version
Blocks
PluginVersion
pdfmark
Name
pdfmark
PluginVersion 1
true
PluginVersion pdfmark
310 11 : PPS PDFlib Block Plugin COM .NET REALbasic

float
unichar
/DeviceGray
/DeviceRGB
/DeviceCMYK
[/Separation/ ]
/Separation
/DeviceGray /DeviceRGB /DeviceCMYK /Lab
[/Lab] /Lab
utf16be
11.8.2
11.8 PDFlib 311

job_title logo
format
>
/Contents 12 0 R
/Type /Page
/Parent 1 0 R
/MediaBox [ 0 0 595 842 ]
/PieceInfo >
13 0 obj
>
/LastModified (D:20090813200730)
>>
endobj
14 0 obj
>>
endobj
15 0 obj
>
312 11 : PPS PDFlib Block Plugin COM .NET REALbasic

11.8.3 pdfmark PDFlib
pdfmark
pdfmark
pdfmark
% ---------- Setup for the Blocks on a page ----------
[/_objdef {B1} /type /dict /OBJ pdfmark % Blocks dict
[{ThisPage}
>>
>> /PUT pdfmark
% ---------- text Block ----------
[{B1} >
>> /PUT pdfmark
% ---------- image Block ----------
[{B1}
>> /PUT pdfmark
11.8 PDFlib 313

314 11 : PPS PDFlib Block Plugin COM .NET REALbasic

A
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
A 315

.NET 40
A
Acrobat 275
Active Server Pages 33
Adobe Font Metrics AFM 104
AES Advanced Encryption Standard 69
AFM Adobe Font Metrics 104
ArtBox 64
ascender 137
ASP.NET 42
autocidfont 128
autosubsetting 127
B
BleedBox 64
BMP 89, 167
C
C++ 38
capheight 137
CCITT 167
character references 100
characters per inch 138
CIE L*a*b* 76
circle():VB 35
CMap 95
CMaps 95
Cobol 30
COM Component Object Model
31
copyoutputintent 257
CPI characters per inch 138
CropBox 64
currentx currenty 137
C 37
D
defaultgray/rgb/cmyk 78
descender 137
DLL 32
dpi 163
E
EBCDIC 60
ebcdic 92
errorpolicy 174
EUDC
103
examples
page size 232
EXIF JPEG 166
G
get_buffer() 59
GIF 167
global.asa 34
grid.pdf 62
H
HKS 75
HTML character references 100
I
ignoremask 169
image:iccprofile 77
ISO 10646 113
ISO 15930 251
ISO 19005 258
ISO 32000 250
ISO 8859-2 -15 92
J
Java 39
JBIG2 166
JFIF 165
JPEG 165
JPEG2000 166
JPEG
EXIF 166
L
leading 137
linearized PDF 71
LWFN LaserWriter Font 104
M
macroman_apple 109
macroman 91, 92
makepsres 55
masked 169
masterpassword 69
MediaBox 64
317

MSI 31
O
OpenType 103
optimized PDF 71
overline 140
P
page 164
PANTONE 73
pCOS 231
245
238
233
236
pCOS 231
PDF/A 258
PDF/X 251
PDF_set_parameter() 58
PDFlib
22
PDFlib Personalization Server 275
pdflib.upr 57
PDFLIBRESOURCE 57
PDFlib 22, 26
PDF PDI 172
PDF 231
pdiusebox 174
PDI PDF 172
Perl 43
permissions 69
PFA Printer Font ASCII 104
PFB Printer Font Binary 104
PFM Printer Font Metrics 104
PHP 44
PNG 165, 169
PostScript Type 1 104
PPS PDFlib Personalization Server 275
Printer Font ASCII PFA 104
Printer Font Binary PFB 104
Printer Font Metrics PFM 104
PUA 89
Python 45
R
RAW 167
REALbasic 46
regsvr32 32
renderingintent 76
resourcefile 58
RPG 47
Ruby 48
S
scale():VB 35
SearchPath 56
setcolor:iccprofilegray/rgb/cmyk 78
sRGB 77
strikeout 140
subsetminsize 128
T
Tcl 49
textrendering 141
textx texty 137
TIFF 167
topdown 63
TrimBox 64
TrueType 103
TTC TrueType Collection 103
TTC TrueType Collection 157, 158
Type 1 104
Type 3 105
U
UNC 33
underline 140
UPR Unix PostScript Resource 55
usercoordinates 61
userpassword 69
UTF 90
V
VB.NET 41
VBA 31
Visual Basic 34
Visual Basic for Applications 31
W
web-optimized PDF 71
winansi 92
Windows 31
X
XMP 232
XObject 66
x 137
137
68
PDF 245
PDF 245
232
71
59
, 32
318

32
61
164
138
99
51
93
95
31
138
169
62
163
93
163
163
165
168, 170
55
65
PDFLIBRESOURCE 57
95, 156
139
232
PDFlib 22, 26
PDFlib 22
89
137
89
137
137
64
72
89
132
111
68
118
206
:Microsoft Windows 1250
1258 92
32
61
62
61
127
64
235
138
62
255
PDF/A 259
PDF/X 252
89
Windows 121
121
73
72
31
68
163
156
61
95, 156
137
137
156
137
137
61
319

66
168
138
97
97
157
95
95, 156
64
71
BOM 90
97
235
29
64
65
68
72
99
PDF/A 261
PDF/X 255
64
XObject 66
: 286
Type 3 105
127
232
AFM 104
OpenType 103
PDF 118
PFA 104
PFB 104
PFM 104
PostScript Type 1 104
TrueType 103
Type 3 105
127
138
Type 3 105
55
139
Windows 121
137
300
164
181
300
275
72
275
277
231
71
232
63
Acrobat 63
231
61
165
91
120
168
61
61
137
PDF 59
100
61
Type 3 105
109
320

206
156
55
page size
232
232
232
231
232
231
51
PDI 174
76
321

ABC
PDFlib GmbH
Franziska-Bilek-Weg 9
80339 München, Germany
www.pdflib.com
+49 • 89 • 452 33 84-0
FAX +49 • 89 • 452 33 84-99
PDFlib
tech.groups.yahoo.com/group/pdflib
sales@pdflib.com
support@pdflib.com