Objectif Lune PlanetPress Talk - 7.0, PlanetPress Design - 7.6 Instruction Manual

0 (0)

User Guide

www.objectiflune.com

- 2 -

Copyright Information

No part of this publication may be reproduced, transmitted, transcribed, stored in a retrieval system, or translated into any other language or computer language in whole or in part, in any form or by any means, whether it be electronic, mechanical, magnetic, optical, manual or otherwise, without prior written consent of Objectif Lune Inc.

Objectif Lune Inc.disclaims all warranties as to this software, whether expressed or implied, including without limitation any implied warranties of merchantability, fitness for a particular purpose, functionality, data integrity or protection.

PlanetPress and PrintShop Mail are registered trademarks of Objectif Lune Inc.

PostScript and Acrobat are registered trademarks of Adobe Systems Inc.

Pentium is a registered trademark of Intel Corporation.

Windows is a registered trademark of Microsoft Corporation.

Adobe, Adobe PDF Library, Adobe Acrobat, Adobe Distiller, Adobe Reader, Adobe Illustrator, Adobe Photoshop, Optimized Postcript Stream, the Adobe logo, the Adobe PDF logo are either registered trademarks or trademarks of Adobe Systems Incorporated in the United States and/or other countries.

Trademarks of other companies mentioned in this documentation appear for identification purposes only and are the property of their respective companies.

Title

PlanetPress Design User Guide

Revision 2012-01-25

- 3 -

- 4 -

Table of Content

Copyright Information		3
Table of Content		5
Fonts and Styles		29
Create a Style		29
Apply a Style		31
View or Edit the Properties of a Style		31
Delete a Style		32
Set the Default Style for New Objects and Groups		32
Create a MICR Style for Account Information on Cheques		33
Arabic Content in PlanetPress Design Documents		33
CID-Keyed Fonts		34
Double-byte Character Sets		34
Encoding Tables		34
Why have different encoding tables?		35
Encoding Tables in PlanetPress Design		35
Edit the Encoding Table for a Style		35
Set a Default Encoding Table		38
Export an Encoding Table		38
Refresh the Font Lists		38
Install a PostScript Font in PlanetPress Design		39
Overview		41
Icons used in this guide		41
Other Documentation		41
Getting Started		43
Environment Considerations		43
Terminal Server/Service		43
VMWare/ESX		43
32-Bit or 64-Bit?		43
Network Considerations		43
Mapped Drives		43
Activate Your Printers		44
The Nature of PlanetPress Design		44
The PlanetPress Design Program		45
Start PlanetPress Design		45
The PlanetPress Suite Button		45
Open a Document		46
Save a Document		47
Save and Open a Document Template		47
Change the Interface Language		47
Exit PlanetPress Design		48
The Quick Access Toolbar		48
The PlanetPress Design Ribbon		49
©2010 Objectif Lune Inc	- 5 -

Table of Content

Undo and Redo Commands		50
Navigate Data Pages		51
Document Structure Area		51
Selecting and moving elements		52
Add a Metadata Field		52
Add a Document Page		53
Edit the Order of Pages		53
Duplicate a Page		53
Delete a Page		54
Object Layering Order		54
Group and Ungroup Objects and/or Groups		55
Data Pane		55
Object Inspector		55
Workspace Area		56
Using the Select Tool in the Workspace		56
Zoom in and out of the Workspace		57
Pan the Workspace		57
Use Guides		58
Right-Click Menu in the Workspace		59
Detailed Directions		59
Debug an Object or Group		60
Select Objects and/or Groups		60
Lock and Unlock Objects and Groups		60
Reposition Objects and/or Groups		61
Resize Objects and/or Groups		61
Delete Objects and/or Groups		62
Align Objects and/or Groups		63
Rotate Objects and/or Groups		63
Duplicate Objects and/or Groups		63
Snap or Unsnap Objects and/or Groups		63
Copy Values of Properties between Objects and/or Groups		66
Adding image resources to your document		66
Messages Area		67
Adding External Resources		67
PlanetPress Design Preferences		68
Notification Messages Preferences		69
Image Resources Preferences		70
Color Preferences		71
Object Duplication Preferences		71
Miscellaneous Preferences		72
Editor Preferences		73
Display Preferences		74
Color Preferences		75
Ribbon Preferences		75
Object Inspector Preferences		75
Document Structure Area Preferences		76
©2010 Objectif Lune Inc	- 6 -

Table of Content

Rulers Preferences		76
Form Pages Preferences		77
Compiler Messages Preferences		77
Document and Pages Preferences		77
Image Resources Preferences		78
Data Selector Display Preferences		79
Dock and Undock Areas of the Program Window		80
Minimize and Customize the Ribbon		80
Show or Hide Areas of the Program Window		80
Resize the Program Window Area		81
Data in PlanetPress Design		83
Sample Data File		83
Capturing Data		85
Capture Sample Data Using the Data Capture Tool		85
LPD Input		85
Serial Input		86
Telnet Input		86
Windows Queue Input		87
The Data Selector		88
Metadata tab		89
Data Page		89
Emulation		90
Text-Based Emulation Properties		90
Line Printer Emulation		91
ASCII Emulation		91
Comma Separated Value (CSV) Emulation		92
Channel Skip Emulation		92
Database Emulation		93
Export or Import a Database Emulation Configuration		94
XML Emulation		95
PDF Emulation		95
User-Defined Emulation		96
Associate a Sample Data File with a Document		96
Metadata		97
Setting Up a Document		103
Set Up a Document		103
Cacheable Execution Options		107
FreeForm Caching		108
FreeForm 2 Caching		109
VPS Caching		110
VDX/PPML Caching		110
PPD Setup		111
Add or Remove PPDs		112
Refresh the PPD Lists		112
Specify Job Infos		112
Associate Attachments with a Document		113
©2010 Objectif Lune Inc	- 7 -

Table of Content

Setting Up Pages		115
Page Properties		115
Page Types		117
Normal Page		117
Overlay Page		117
Virtual Page		118
Execution Order of Pages		118
Advanced Paper Handling		118
Associate Attachments with a Page		119
Add or Remove Overlays		119
PlanetPress Design Objects		121
View or Edit the Properties of an Object		121
Basic Attributes		121
Repeat		122
Snapping Points		124
Manipulation		124
PlanetPress Talk Before and PlanetPress Talk After		125
Preview options		125
Line Repeat and Data Overflow		125
Snapping Points		126
Object Preview Window		127
Text and Box Object		128
Borders		128
Color		129
Text		129
Apply a Style to Text in a Text Object		130
Set Tabs		131
Adjust Alignment and Lines Per Unit settings		132
Spell Check Text in a Text Object		133
Use the Thesaurus		135
Change the Width of the Text Object in the Text Area		136
Use Variables in a Text Object		136
Data Selection Object		138
Data		138
Lines		138
Archive/Email/Fax		139
Text-Based Data Selections		140
Database Data Selections		141
XML Data Selections		142
PDF Data Selections		143
Edit Text-Based Data Selection Size		143
Postal Address Object		144
Metadata		144
PlanetPress Talk Object		145
Shape Object		147
©2010 Objectif Lune Inc	- 8 -

Objectif Lune PlanetPress Talk - 7.0, PlanetPress Design - 7.6 Instruction Manual

Table of Content

N-Up Object	147
Picture Object	148
Barcode Object	150
Supported Barcodes	150
Australia Post	150
Aztec	151
CEPNet (Brazilian Postal Code)	151
Codabar	151
CodablockF	151
Code 11	152
Code 16k	152
Code 39	152
Code 49	153
Code 93	154
Code 128	155
Datamatrix	156
Discrete 2 of 5	157
FIM	157
GS1 Databar (RSS)	157
IMB/OneCode	157
Interleaved 2 of 5	157
Japan Post	158
Maxicode	158
Micro PDF417	158
Micro QR	158
MSI Plessey	159
PDF417	159
Plessey	159
USPS Postnet	159
QR Code	160
Royal Mail	160
UPC	160
ISBN	161
Business Graphic Object	162
Excel Graphic	163
Capture Field Object	164
Considerations	166
Pidgets	167
Capture Field Masks	167
Custom Masks	168
Regular Expressions	169
Document Resources	171
Image Resources	173
Location of image resources	173
Static and Dynamic Images	173
Supported Image Formats	173
©2010 Objectif Lune Inc	- 9 -

Table of Content

Image Glossary		174
Scanline Orientation		175
Image Quality Settings		176
Caches		176
Host-Based Cache		177
Printer-Based Cache		177
Adding Image Resources		177
Guidelines for Optimizing Images		178
Modifying and Updating Images		178
Color Management and Matching		179
PostScript Attachments		181
Delete a Resource		182
Conditions		185
Conditions		185
Global Conditions		185
Local Conditions		185
Line Conditions		185
Create or Remove a Line Condition		186
Variables		187
PlanetPress Supports Global Variables in the Global Function Library Manager		188
Create a Global Condition		188
View or Edit the Properties of a Global Condition		190
Apply or Remove a Global Condition		191
Use a Global Condition as a Variable		191
Create a Global Variable		191
View or Edit a Global Variable		192
Delete a Global Variable		192
Combine Global Conditions		193
Override a Global Condition		196
Delete a Global Condition		196
Create, Edit, or Delete Local Conditions		197
Verify a Condition		197
Add a Global Function		197
View or Edit a Global Function		198
Delete a Global Function		198
PlanetPress Talk		199
Variable PlanetPressTalk Properties		199
The PlanetPress Talk Editor		201
PlanetPress Talk Editor Features		202
Debugging Features		203
Code Execution in the Editor		204
Enter a New Program in the Editor		205
Import or Export a Program		205
Save a Program		205
Print a Program		206
Exit the PlanetPress Talk Editor		206
©2010 Objectif Lune Inc	- 10 -

Table of Content

Show or Hide the Commands Area or Spy List		206
Adjust the Sizes of the Commands Area, Code Area and Spy List		207
Expand or Collapse Command Groups		207
Enter Commands in the Editor		207
Use Command and Variable Name Completion		208
Dynamic Images		209
PlanetPress Talk Expressions for Dynamic Images that Reference Image Resources		209
PlanetPress Talk Expressions for Dynamic Images that Reference External Images		210
Physical Location of Dynamic Images		210
Host-Based or Printer-Based Document Execution		210
Image Format		211
Summary of Execution Environments		211
Examples of PlanetPress Talk Expressions that Resolve to Pathnames		212
Image Name and Pathname Resolution in Dynamic Images		213
Custom Data Selections		213
PlanetPress Talk Before and After		214
Creating and using Runpages		215
Convert an Object to PlanetPress Talk		215
PlanetPress Talk Basics		217
Assumed Knowledge		217
PlanetPress Talk		217
PlanetPress Talk Terminology		219
The Elements of PlanetPress Talk		219
PlanetPress Talk Syntax		220
Data Types		222
Variables		224
System Variables with Local Scope		225
System Variables with Global Scope		225
System Objects with Global Scope		226
Current System Object		226
Runpage		229
Using Foreign Language Text with PPtalk		229
Learning PlanetPress Talk		233
Integrate PlanetPress Talk into Documents		234
Define and Assign Values to Variables		234
Select Data		235
Use Functions as Arguments		235
Debug Scripts		235
Tips and Tricks		235
Code Samples		236
Print a variable number of copies of a page based on a value in the datastream		236
Store two lines of input data on one line of the data page		237
Print a page n-up		238
Print a line of text on odd-numbered pages		239
Determine the proper page to print based on the width of the data in the data page		239
Language Reference		241
©2010 Objectif Lune Inc	- 11 -

Table of Content

Language Reference (Alphabetical)		241
% (procedure)		241
Current (system object)		241
&currentiteration (variable)		243
&Document (system object)		244
&EOJob (system variable)		244
&FirstSide (system variable)		244
&Height (system variable)		245
&iterationcount (variable)		245
lastoverflowcount (variable)		245
&Metamode (variable)		245
Physical (system object)		246
&PrinterMode (system variable)		246
Script (system object)		247
&Str (system variable)		248
&system (system object)		248
&Width (system variable)		249
@ (function)		249
@name (function/procedure)		249
@page (procedure)		250
$element (procedure)		250
+ (operator & function)		251
– (operator)		252
Asterisk (*) operator		252
/ (operator)		252
Greater than (>) operator		252
Greater or equal to (>=) operator		252
Less than (<) operator		252
Less or equal to (<=) operator		252
= (operator)		252
<> (operator)		252
Add (function)		253
And (Boolean operator function)		253
Arc and ArcN (procedures)		254
BeginDocument/EndDocument (procedure)		255
BeginGroup/EndGroup (procedure)		255
BeginParagraph … EndParagraph (procedure)		256
BeginUTF8Paragraph … EndUTF8Paragraph (procedure)		257
BitmapWidth/BitmapHeight (function)		258
Breakpoint (procedure)		259
C128 (function)		259
CallPPD (procedure)		260
Ceil (function)		260
Char (function)		261
CharPath (procedure)		261
ClearPage (procedure)		262
ClipPath (procedure)		262
©2010 Objectif Lune Inc	- 12 -

Table of Content

ClosePath (procedure)	263
Cos (function)	263
CRLF (procedure)	264
CurToStr (function)	264
CurToFloat (function)	265
CurveTo/RCurveTo (procedure)	265
Date (function)	266
Define (procedure)	267
DefineData (procedure)	267
DefineImageIndex (procedure)	268
Definemeta (function)	268
Div (function)	269
DoForm (procedure)	270
endpageset (procedure)	270
EPSWidth/EPSHeight (function)	271
Eq (function)	272
ExecPage (procedure)	272
ExecScriptFile (function)	273
Exit (procedure)	274
ExpandString (function)	275
Field (function)	275
FieldCount (function)	276
FieldName (function)	276
Fill (procedure)	276
Find (function)	277
FloatToCur (function)	277
FloatToInt (function)	278
FloatToStr (function)	278
For… EndFor (procedure)	279
Function @name (procedure)	280
GE (function)	282
Get (function)	283
GetBlack (function)	284
GetCyan (function)	284
GetMagenta (function)	284
Getmeta (function)	285
Getmetacount (function)	286
GetNextDataPage(procedure)	287
GetYellow (function)	288
GRestore (procedure)	288
GSave (procedure)	288
GT (function)	289
If (function)	290
If … ElseIf… EndIf (procedure)	290
InStream... EndInStream (procedure)	292
IntToCur (function)	293
IntToFloat (function)	293
©2010 Objectif Lune Inc	- 13 -

Table of Content

IntToStr (function)	294
IsNumber (function)	295
IsPageEmpty (function)	295
LE (function)	295
Left (function)	296
Length (function)	297
LineTo/RLineTo (procedure)	297
LowerCase (function)	298
LT (function)	298
MapUTF8 (function)	299
Margin (procedure)	301
Mid (function)	301
Mod (function & procedure)	302
MoveTo/RMoveTo (procedure)	303
Mul (function)	303
NE (function)	304
Neg (function)	305
Not (Boolean operator function)	305
Object $name()... EndObject (procedure)	306
Or (Boolean operator function)	308
Ord (function)	309
OutputDebugString (procedure)	309
PassThrough (procedure)	310
PDFPageCount (function)	310
PDFWidth/PDFHeight (function)	310
Pie (procedure)	311
PixelHeight (function)	312
PixelWidth (function)	312
Pos (function)	312
Put (procedure)	313
Random (function)	313
Rectangle (procedure)	314
RectFill (procedure)	315
RectFillStroke (procedure)	316
RectStroke (procedure)	316
Region (function)	317
Regionline (function)	318
Repeat... Until (procedure)	318
ResourceType (function)	319
Right (function)	320
RunPS (procedure)	321
Scale (procedure)	321
Search … EndSearch (procedure)	321
SelectMedia (procedure)	322
SelectPrinter (procedure)	323
Set (procedure)	323
SetAngle (procedure)	324
©2010 Objectif Lune Inc	- 14 -

Table of Content

SetBodyText (procedure)	325
SetDash(procedure)	325
SetDataPage(procedure)	326
SetEmailAddress (procedure)	326
SetEmailSubject (procedure)	326
SetEmulation(procedure)	326
SetUserCRLF (procedure)	327
SetFaxInformation (procedure)	327
SetFaxNumber (procedure)	328
SetFillColor (procedure)	328
SetImageIndex (procedure)	329
SetLineWidth (procedure)	329
SetLPP(procedure)	330
SetPDFBookmark (procedure)	330
SetStrokeColor (procedure)	331
SetStyle (procedure)	331
SetStyleExt (procedure)	332
Show / ShowCenter / ShowRight (procedure)	333
ShowBarCode (procedure)	333
ShowBarcode2of5(procedure)	335
ShowBarcodeAustPost (procedure)	335
ShowBarcodeAztec (procedure)	335
ShowBarcodeCodabar (procedure)	336
ShowBarcodeCodablockF (procedure)	337
ShowBarcodeCode11 (procedure)	338
ShowBarcodeCode128 (procedure)	338
ShowBarcodeCode16k (procedure)	339
ShowBarcodeCode39 (procedure)	339
ShowBarcodeCode49 (procedure)	340
ShowBarcodeCode93 (procedure)	340
ShowBarcodeDatamatrix (procedure)	341
ShowBarcodeEAN8 (procedure)	342
ShowBarcodeEAN13 (procedure)	342
ShowBarcodeFIM (procedure)	343
ShowBarcodeI2of5 (procedure)	343
ShowBarcodeISBN (procedure)	344
ShowBarcodeJapanpost (procedure)	345
ShowBarcodeMaxicode (procedure)	345
ShowBarcodeMicroPDF (procedure)	346
ShowBarcodeMicroQR (procedure)	346
ShowBarcodeMSI (procedure)	347
ShowBarcodeOnecode (procedure)	347
ShowBarcodePDF417 (procedure)	348
ShowBarcodePlessey (procedure)	349
ShowBarcodePostnet (procedure)	349
ShowBarcodeQRCode (procedure)	350
ShowBarcodeRoyalMail (procedure)	350
©2010 Objectif Lune Inc	- 15 -

Table of Content

ShowBarcodeRSS (procedure)		351
ShowBarcodeUPCA (procedure)		351
ShowBarcodeUPCE (procedure)		352
ShowBitmap (procedure)		353
ShowCaptureUserArea (procedure)		354
ShowEPS (procedure)		355
ShowLeftRight (procedure)		356
ShowPage (procedure)		356
ShowPDF (procedure)		357
ShowUTF8 (procedure)		358
ShowUTF8Left / ShowUTF8Right / ShowUTF8Center (procedure)		359
Sin (function)		360
StopJob (procedure)		361
Store (procedure)		361
StringReplace (function)		361
StringWidth (function)		362
StringWidthUTF8 (function)		363
Strip (function)		363
Stroke (procedure)		364
StrokeAndFill (procedure)		364
StrToCur (function)		365
StrToFloat (function)		365
StrToInt (function)		366
Sub (function)		366
SubRecCount (function)		367
Time (function)		368
Translate (procedure)		369
Trim (function)		370
TrimLeft (function)		370
TrimRight (function)		370
UpperCase (function)		371
xmlCount()		371
xmlGet()		372
XOr (Boolean operator function)		373
Language Reference (by element type)		373
System Variables		374
&EOJob (system variable)		374
&FirstSide (system variable)		374
&Height (system variable)		374
&PrinterMode (system variable)		375
&Str (system variable)		375
&Width (system variable)		376
System Objects		376
Current (system object)		376
Physical (system object)		378
&system (system object)		378
Assignment Operator		379
©2010 Objectif Lune Inc	- 16 -

Table of Content

= (operator)	379
Mathematical Operators and Operator Functions	379
+ (operator & function)	379
Add (function)	380
– (operator)	380
Sub (function)	380
Asterisk (*) operator	381
Mul (function)	381
/ (operator)	381
Div (function)	381
Neg (function)	382
Cos (function)	382
Sin (function)	383
Random (function)	384
Ceil (function)	384
String Operator	385
+ (operator & function)	385
Boolean Operator Functions	385
And (Boolean operator function)	385
Not (Boolean operator function)	386
Or (Boolean operator function)	386
XOr (Boolean operator function)	387
Comparison Operators and Operator Functions	388
GT (function)	388
Greater than (>) operator	389
GE (function)	389
Greater or equal to (>=) operator	389
LT (function)	389
Less than (<) operator	390
LE (function)	390
Less or equal to (<=) operator	391
Eq (function)	391
= (operator)	391
NE (function)	392
<> (operator)	392
Conversion Operator Functions	392
FloatToCur (function)	393
FloatToInt (function)	393
FloatToStr (function)	393
IntToCur (function)	394
IntToFloat (function)	394
IntToStr (function)	395
StrToCur (function)	396
StrToFloat (function)	396
StrToInt (function)	396
Loop Structures	397
For… EndFor (procedure)	397
©2010 Objectif Lune Inc	- 17 -

Table of Content

Repeat... Until (procedure)		398
Search … EndSearch (procedure)		399
Exit (procedure)		400
Condition Structures		400
If … ElseIf… EndIf (procedure)		400
If (function)		402
Procedures		403
% (procedure)		403
@name (function/procedure)		403
@page (procedure)		404
$element (procedure)		404
Arc and ArcN (procedures)		405
BeginDocument/EndDocument (procedure)		406
BeginGroup/EndGroup (procedure)		407
BeginParagraph … EndParagraph (procedure)		407
BeginUTF8Paragraph … EndUTF8Paragraph (procedure)		409
Breakpoint (procedure)		410
CallPPD (procedure)		410
CharPath (procedure)		411
ClearPage (procedure)		411
ClipPath (procedure)		412
ClosePath (procedure)		412
CRLF (procedure)		413
CurveTo/RCurveTo (procedure)		413
Define (procedure)		414
DefineData (procedure)		415
DefineImageIndex (procedure)		416
DoForm (procedure)		416
endpageset (procedure)		417
ExecPage (procedure)		417
Exit (procedure)		418
Fill (procedure)		419
For… EndFor (procedure)		419
Function @name (procedure)		420
GetNextDataPage(procedure)		423
GRestore (procedure)		423
GSave (procedure)		423
If … ElseIf… EndIf (procedure)		424
InStream... EndInStream (procedure)		426
LineTo/RLineTo (procedure)		427
Margin (procedure)		428
MoveTo/RMoveTo (procedure)		428
Object $name()... EndObject (procedure)		429
OutputDebugString (procedure)		431
PassThrough (procedure)		431
Pie (procedure)		431
Put (procedure)		432
©2010 Objectif Lune Inc	- 18 -

Table of Content

Rectangle (procedure)	433
RectFill (procedure)	433
RectFillStroke (procedure)	434
RectStroke (procedure)	435
Repeat... Until (procedure)	435
RunPS (procedure)	436
Scale (procedure)	437
Search … EndSearch (procedure)	437
SelectMedia (procedure)	438
SelectPrinter (procedure)	439
Set (procedure)	439
SetAngle (procedure)	440
SetBodyText (procedure)	440
SetDash(procedure)	441
SetDataPage(procedure)	441
SetEmailAddress (procedure)	442
SetEmailSubject (procedure)	442
SetEmulation(procedure)	442
SetUserCRLF (procedure)	442
SetFaxInformation (procedure)	443
SetFaxNumber (procedure)	443
SetFillColor (procedure)	444
SetImageIndex (procedure)	444
SetLineWidth (procedure)	445
SetLPP(procedure)	446
SetPDFBookmark (procedure)	446
SetStrokeColor (procedure)	447
SetStyle (procedure)	447
SetStyleExt (procedure)	448
Show / ShowCenter / ShowRight (procedure)	449
ShowBarCode (procedure)	449
ShowBarcode2of5(procedure)	450
ShowBarcodeAustPost (procedure)	451
ShowBarcodeAztec (procedure)	451
ShowBarcodeCodabar (procedure)	452
ShowBarcodeCodablockF (procedure)	453
ShowBarcodeCode11 (procedure)	453
ShowBarcodeCode128 (procedure)	454
ShowBarcodeCode16k (procedure)	455
ShowBarcodeCode39 (procedure)	455
ShowBarcodeCode49 (procedure)	456
ShowBarcodeCode93 (procedure)	456
ShowBarcodeDatamatrix (procedure)	457
ShowBarcodeEAN8 (procedure)	457
ShowBarcodeEAN13 (procedure)	458
ShowBarcodeFIM (procedure)	459
ShowBarcodeI2of5 (procedure)	459
©2010 Objectif Lune Inc	- 19 -

Table of Content

ShowBarcodeISBN (procedure)		460
ShowBarcodeJapanpost (procedure)		460
ShowBarcodeMaxicode (procedure)		461
ShowBarcodeMicroPDF (procedure)		461
ShowBarcodeMicroQR (procedure)		462
ShowBarcodeMSI (procedure)		463
ShowBarcodeOnecode (procedure)		463
ShowBarcodePDF417 (procedure)		464
ShowBarcodePlessey (procedure)		464
ShowBarcodePostnet (procedure)		465
ShowBarcodeQRCode (procedure)		465
ShowBarcodeRoyalMail (procedure)		466
ShowBarcodeRSS (procedure)		466
ShowBarcodeUPCA (procedure)		467
ShowBarcodeUPCE (procedure)		468
ShowBitmap (procedure)		468
ShowCaptureUserArea (procedure)		470
ShowEPS (procedure)		471
ShowLeftRight (procedure)		471
ShowPage (procedure)		472
ShowPDF (procedure)		473
ShowUTF8 (procedure)		473
ShowUTF8Left / ShowUTF8Right / ShowUTF8Center (procedure)		474
StopJob (procedure)		476
Store (procedure)		476
Stroke (procedure)		477
StrokeAndFill (procedure)		477
Translate (procedure)		478
Functions		479
@ (function)		479
@name (function/procedure)		479
BitmapWidth/BitmapHeight (function)		480
C128 (function)		480
Ceil (function)		481
Char (function)		481
Date (function)		482
Definemeta (function)		482
EPSWidth/EPSHeight (function)		483
ExecScriptFile (function)		484
ExpandString (function)		485
Field (function)		486
FieldCount (function)		486
FieldName (function)		486
Find (function)		487
Get (function)		487
GetBlack (function)		488
GetCyan (function)		488
©2010 Objectif Lune Inc	- 20 -

Table of Content

GetMagenta (function)	489
Getmeta (function)	489
Getmetacount (function)	491
GetYellow (function)	492
IsNumber (function)	492
IsPageEmpty (function)	493
Left (function)	493
Length (function)	493
LowerCase (function)	494
MapUTF8 (function)	495
Mid (function)	496
Mul (function)	497
Ord (function)	497
PDFPageCount (function)	498
PDFWidth/PDFHeight (function)	498
PixelHeight (function)	499
PixelWidth (function)	499
Pos (function)	499
Random (function)	500
Region (function)	501
Regionline (function)	502
ResourceType (function)	502
Right (function)	503
StringReplace (function)	504
StringWidth (function)	504
StringWidthUTF8 (function)	505
Strip (function)	505
Sub (function)	506
SubRecCount (function)	507
Time (function)	508
Trim (function)	508
TrimLeft (function)	509
TrimRight (function)	509
UpperCase (function)	509
xmlCount()	510
xmlGet()	510
System Variables (by data type)	511
Integer	511
Measure	512
String	512
Boolean	512
Functions (by return value data type)	513
Currency	513
Add (function)	513
FloatToCur (function)	513
IntToCur (function)	514
©2010 Objectif Lune Inc	- 21 -

Table of Content

StrToCur (function)	514
Integer	514
Add (function)	514
Ceil (function)	515
Div (function)	515
FieldCount (function)	516
FloatToInt (function)	516
Get (function)	516
GetBlack (function)	517
GetCyan (function)	517
GetMagenta (function)	518
GetYellow (function)	518
Getmetacount (function)	519
If (function)	520
Length (function)	520
Mod (function & procedure)	521
Mul (function)	522
Neg (function)	522
Ord (function)	523
PDFPageCount (function)	524
PixelHeight (function)	524
PixelWidth (function)	524
Pos (function)	524
ResourceType (function)	525
StrToInt (function)	526
Sub (function)	526
SubRecCount (function)	527
xmlCount()	528
Measure	528
Add (function)	529
BitmapWidth/BitmapHeight (function)	529
Cos (function)	530
CurToFloat (function)	530
Div (function)	530
EPSWidth/EPSHeight (function)	531
Get (function)	531
If (function)	532
IntToFloat (function)	532
Mul (function)	533
Neg (function)	534
PDFWidth/PDFHeight (function)	534
Random (function)	535
Sin (function)	535
StringWidth (function)	536
StringWidthUTF8 (function)	537
StrToFloat (function)	537
Sub (function)	538
©2010 Objectif Lune Inc	- 22 -

Table of Content

String	538
@ (function)	538
C128 (function)	539
Char (function)	539
CurToStr (function)	540
ExpandString (function)	540
Field (function)	540
FieldName (function)	541
FloatToStr (function)	541
Get (function)	542
If (function)	543
IntToStr (function)	543
Left (function)	544
LowerCase (function)	545
Mid (function)	545
Right (function)	546
StringReplace (function)	546
Strip (function)	547
Trim (function)	548
TrimLeft (function)	548
TrimRight (function)	548
UpperCase (function)	549
xmlGet()	549
Boolean	550
Add (function)	550
Eq (function)	551
Find (function)	551
GE (function)	552
GT (function)	552
If (function)	553
IsNumber (function)	554
IsPageEmpty (function)	554
LE (function)	554
LT (function)	555
NE (function)	555
Not (Boolean operator function)	556
Or (Boolean operator function)	557
XOr (Boolean operator function)	558
Procedures (by category)	558
Debugging	559
Breakpoint (procedure)	559
OutputDebugString (procedure)	560
Variables	560
Define (procedure)	560
Put (procedure)	561
Set (procedure)	561
Global Functions	562
©2010 Objectif Lune Inc	- 23 -

Table of Content

@name (function/procedure)		562
Function @name (procedure)		562
Comments		565
% (procedure)		565
Graphics State		565
GRestore (procedure)		565
GSave (procedure)		566
Scale (procedure)		567
SetAngle (procedure)		567
SetDash(procedure)		568
SetFillColor (procedure)		568
SetLineWidth (procedure)		569
SetStrokeColor (procedure)		569
Translate (procedure)		570
Path		571
Arc and ArcN (procedures)		571
ClosePath (procedure)		572
CurveTo/RCurveTo (procedure)		573
Fill (procedure)		574
LineTo/RLineTo (procedure)		574
MoveTo/RMoveTo (procedure)		575
Pie (procedure)		576
Rectangle (procedure)		577
RectFill (procedure)		577
RectFillStroke (procedure)		578
RectStroke (procedure)		579
Stroke (procedure)		579
StrokeAndFill (procedure)		580
Paragraphs and Text		581
BeginParagraph … EndParagraph (procedure)		581
BeginUTF8Paragraph … EndUTF8Paragraph (procedure)		582
CRLF (procedure)		583
Margin (procedure)		584
ShowLeftRight (procedure)		584
Show / ShowCenter / ShowRight (procedure)		585
Styles		585
SetStyle (procedure)		586
SetStyleExt (procedure)		586
Objects		587
Object $name()... EndObject (procedure)		587
Bar Codes		589
ShowBarCode (procedure)		589
ShowBarcode2of5(procedure)		590
ShowBarcodeAustPost (procedure)		591
ShowBarcodeAztec (procedure)		591
ShowBarcodeCodabar (procedure)		592
ShowBarcodeCodablockF (procedure)		593
©2010 Objectif Lune Inc	- 24 -

Table of Content

ShowBarcodeCode11 (procedure)		593
ShowBarcodeCode128 (procedure)		594
ShowBarcodeCode16k (procedure)		594
ShowBarcodeCode39 (procedure)		595
ShowBarcodeCode49 (procedure)		595
ShowBarcodeCode93 (procedure)		596
ShowBarcodeDatamatrix (procedure)		596
ShowBarcodeEAN8 (procedure)		597
ShowBarcodeEAN13 (procedure)		598
ShowBarcodeFIM (procedure)		598
ShowBarcodeI2of5 (procedure)		599
ShowBarcodeISBN (procedure)		599
ShowBarcodeJapanpost (procedure)		600
ShowBarcodeMaxicode (procedure)		601
ShowBarcodeMicroPDF (procedure)		601
ShowBarcodeMicroQR (procedure)		602
ShowBarcodeMSI (procedure)		602
ShowBarcodeOnecode (procedure)		603
ShowBarcodePDF417 (procedure)		603
ShowBarcodePlessey (procedure)		604
ShowBarcodePostnet (procedure)		605
ShowBarcodeQRCode (procedure)		605
ShowBarcodeRoyalMail (procedure)		606
ShowBarcodeRSS (procedure)		606
ShowBarcodeUPCA (procedure)		607
ShowBarcodeUPCE (procedure)		608
Resources		608
InStream... EndInStream (procedure)		608
ShowBitmap (procedure)		609
ShowEPS (procedure)		611
ShowPDF (procedure)		611
Elements		612
$element (procedure)		612
Emulation, Data File, and Data Pages		613
ClearPage (procedure)		613
DefineData (procedure)		613
DoForm (procedure)		614
GetNextDataPage(procedure)		614
SetDataPage(procedure)		614
SetEmulation(procedure)		615
SetLPP(procedure)		615
Store (procedure)		615
Data Destined for PlanetPress Image, PlanetPress Fax and PlanetPress Search		616
DefineImageIndex (procedure)		616
SetBodyText (procedure)		617
SetEmailAddress (procedure)		617
SetEmailSubject (procedure)		617
©2010 Objectif Lune Inc	- 25 -

Table of Content

SetFaxInformation (procedure)		617
SetFaxNumber (procedure)		618
SetImageIndex (procedure)		618
SetPDFBookmark (procedure)		619
Document Pages		620
@page (procedure)		620
ExecPage (procedure)		620
ShowPage (procedure)		621
PPDs and PostScript		622
CallPPD (procedure)		622
PassThrough (procedure)		622
RunPS (procedure)		623
SelectMedia (procedure)		623
Program Control		624
Exit (procedure)		624
For… EndFor (procedure)		624
If … ElseIf… EndIf (procedure)		625
Repeat... Until (procedure)		627
Search … EndSearch (procedure)		628
StopJob (procedure)		629
Conversion Tables		631
ASCII Conversion Table		632
Points to Inches or Centimeters		634
Points to Inches		635
Points to Centimeters		637
Line Height as a Function of Lines Per Unit (LPU)		638
Line Height as a Function of Lines Per Inch		638
Line Height as a Function of Lines Per Centimeter		638
Tools and Utilities		641
The Image Downloader		641
Adjust the Image Quality Options		643
Virtual Drive Manager		645
Access Manager		645
To open the Access Manager		646
To add a new entry in the list		646
To modify permissions		647
SOAP Access		647
To add a new SOAP user		648
To define or change the permissions for a SOAP User		648
Managing Documents and Printers		651
Obtain Information from a Printer		651
Delete Documents or Files on the Printer		651
Printer Firmware Version		652
Control Versions of a Document		652
Adjust Printer Settings		653
Form Cache		654
©2010 Objectif Lune Inc	- 26 -

Table of Content

Remove Background Color		654
Named Colors		655
Create a Graybar Report		656
The Hex Viewer		658
Date and Time Format		660
Document Output and Preview		663
About Previewing and Printing		663
Preview a Document On Screen		663
Previews of Documents that Use ASCII Emulation		666
Preview a Capture-Ready document		667
Print a Document Preview		667
Print Using a Windows Driver		668
Printing Using a Windows Driver		670
Generate a Soft Proof		670
Convert a Document and Save It to a File		672
Install a Document		673
Install a document on one or more printers		673
Send the document to one or more local PlanetPress Workflow servers		674
Save a PTK or PTZ file to send to a remote PlanetPress Workflow installation		675
Send a document to PlanetPress iWatch or a UNIX or Linux CodeHost BrightQ print spooler system:		675
Perform a Batch Conversion and/or Installation		676
To use the Batch Send To wizard		676
Print a Document without Data		676
Exclude the Sample Data File from the PP7 File		677
Move a Document between PlanetPress Design Installations		677
Trigger		678
How a Variable Content Document Runs on a Printer		678
Phase 1: Data Reading		678
Phase 2: Global Condition Resolution		678
Phase 3: Document Page Printing		678
Techniques for Inserting Triggers		679
Trigger Syntax		680
Trigger Syntax for Documents Installed on a Hard Disk		680
Trigger Syntax for Documents Installed in RAM		680
Trigger Syntax for Documents Installed in Flash Memory		680
Run a Document Installed on a Printer		681
Run a Document Installed in a PlanetPress Suite Workflow Tool		681
Run a Document that Uses a Database Emulation		681
Run Several Documents as a Single Job		682
Troubleshoot Execution Problems		682
Keyboard Shortcuts		685
PlanetPress Design General		685
Exit PlanetPress Design		685
Use the Help System		685
Show or Hide Areas of the Program Window		686
Work with Hierarchies		686
©2010 Objectif Lune Inc	- 27 -

Table of Content

Work in the Document Structure Area	686
Work with Documents	686
Preview and Install Documents	687
Work with Pages	687
Adjust the Zoom	688
Use Basic Editing Commands	688
Work in the Data Pane	688
Work with the Data File	689
Work with Data Selections	689
Use the Hex Viewer	689
Work with Objects	690
Work in the Text Properties of a Text Object	691
PlanetPress Talk Editor	691
General	692
Show or Hide Areas of the Editor	692
Expand or Collapse Groups in the Commands Area	692
Work in the Code Area	693
Use Command Name Completion/Argument Insertion	693
Undo Commands	693
Work with Selections	693
Add/Remove Comments	694
Indent Code	694
Search	694
Jump to a Specific Line	694
Use Bookmarks	694
Execute a Program	694
Debug Code	695
Print the Script	695
Converted Document	695
About Documents	695
About Document Elements	696
About Data Selections	697
About Objects	697
PPD File	697
PP7 File	697
PTZ File	698
PTK File	698
About Resources	698
Index	699

- 28 -

Fonts and Styles

A style is a specific set of properties that describe how a font is used within a PlanetPress Design object. Styles are created at the document level and can be used in any object where text is displayed, including data selections, text boxes, human-read- able barcode text and business graphics.

While creating your PlanetPress Design document, you can use multiple styles as well as unique fonts for each style. This chapter explains how to create and manage styles, how to install and manage fonts, as well as how to troubleshoot font issues.

Create a Style

To create a style:

1. Do one of the following to display the Style properties dialog box:

•In the Structure area, right-click on the Styles folder and choose Style.

•Choose Home | Style.

The Style properties dialog box appears.

2.If you want to preview the style as you work, click the Preview button to display the Style Preview. Click the Preview button a second time to hide the Style Preview. You can show or hide the Style Preview at any time as you work in the Style dialog. As you work the Style Preview updates to reflect any changes you make to the properties in the Style dialog. See To work in the Style Preview: for help using the Style Preview.

3.In the Style properties dialog box, click Style properties, enter a name for the style, indicate whether or not you want to set it as the default style, and set the font properties for the style.

Name: Enter a name for the style. Although PlanetPress Design supplies a default name, it is recommended you choose a name that reflects the purpose of the style. A meaningful name makes it easier to distinguish one style from another in a document, and thus makes the document easier to design and maintain. Names cannot begin with a number, and can contain only the following ASCII characters: underscore, upper and lower case letters of the alphabet, all digits 0 through 9. If you use an underscore in the name, it should not appear as either the first or last character of the name as this may cause internal conflicts in the software. Names are case-insensitive and must be unique (no two elements in a document can have the same name). Names can be a maximum of 50 characters in length. Finally, PlanetPress Talk variable and command names are reserved words; you cannot use any of these reserved words as a name.

Default style: Select to make this style the default style. The default style is the style PlanetPress Design associates by default with each new object it creates. It is the style that appears by default in the Style box in the Basic attributes properties of an object when you create that object. The current default style appears in bold in the Structure area.

Font Definition

Font type: Select the type of font for the style. PostScript fonts are strongly recommended to improve printer performance and reduce the file size of a document. The type you select determines the contents and availability of the remaining options. The Default font type option in the User Options dialog box determines the font type that appears here by default.

Refresh Fonts List button: Click to refresh the list of available fonts. You use this button if you added fonts to, or removed fonts from, your PlanetPress Design installation after you began your current PlanetPress Design session. PlanetPress Design automatically refreshes the list of available fonts each time it starts.

Font name: Select the font you want to use for the style. The Font type you selected determines the contents of this box. If the font you want to use is a Bold, Italic, or Bold Italic font, you should choose the regular version of the font in this box, and use the Bold and/or Italic buttons to adjust its Bold and Italic properties. For example, if you want to use the Helvetica Bold font, select Helvetica in this box, and click the Bold button. This increases the flexibility of the style; rather than create a new style for each version of the font, you create a single style and adjust the properties as necessary when you reference the style. Note that if the font you select exists in the PPD file of the document (i.e. is printer-resident), PlanetPress Design does not include the font when it performs a hard copy preview or installation of

- 29 -

Fonts and Styles

the document. If you did not modify the Font type option, the font name that appears by default is the one set in the Default font name option in the User Options dialog box.

Default attributes

Font size: Select or type the point size for the font. Note that this is the default font size for the style. You can override the default as necessary in various places in PlanetPress Design, including the text in text/box objects, and in PlanetPress Talk using the setstyleext() command.

Bold button: Click to turn the Bold property of the font on or off. When you turn the Bold property on, the style uses the font selected in the Bold font name box, or, if the Italic property is also on, the font selected in the Bold italic font name box, of the Advanced Fonts dialog box. The property is on when the button appears recessed.

Italic button: Click to turn the Italic property of the font on or off. When you turn the Italic property on, the style uses the font you selected in the Italic font name box, or, if the Bold property is also on, the font selected in the Bold italic font name box, of the Advanced Fonts dialog box. The property is on when the button appears recessed.

Underline button: Click to turn the Underline property of the font on or off. When you turn the Underline property on, the style underlines the characters of its font. The property is on when the button appears recessed. Note that spaces may not appear underlined in PlanetPress Design, but that they will be when the document is used to generate output.

Color box: View the current color for the style. When you select a color in the Color Picker, this box updates to reflect the selected color.

Color button: Click to select a color for the style using the Color Picker. The Color box displays the selected color for the style.

Font ratio: Enter a percentage by which you want to shrink or stretch the font spacing. This value adjusts both the width of each glyph and the spacing between glyphs. This is in contrast to kerning, which modifies the spacing between characters without modifying the width of characters.

4.If necessary, click Set advanced fonts (the button to the right of the Font name box), and use the Advanced Fonts dialog box to specify the fonts to use when you set the Bold, Italic, and BoldItalic properties on this style.

Bold font name: Select the font to use when you set the Bold property on this style. You use the Bold button to set the Bold property. The Font type you selected determines the contents of this box, and the Font name you selected determines which font appears by default in this box. It is important to select a font from the same family as the font you selected for the style in the Font name box. For example, if you selected Helvetica in the Font name box, you should select a Helvetica font (for example, Helvetica Bold) in this box. This ensures all fonts the style references use the same encoding table, and thus prevents unpredictable results. Note that if the font you select exists in the PPD file of the document (i.e. is printer-resident), PlanetPress Design does not include the font when it performs a hard copy preview or an installation of the document.

Italic font name: Select the font to use when you set the Italic property on this style. You use the Italic button to set the Italic property. The Font type you selected determines the contents of this box, and the Font name you selected determines which font appears by default in this box. It is important to select a font from the same family as the font you selected for the style in the Font name box. For example, if you selected Helvetica in the Font name box, you should select a Helvetica font (for example, Helvetica Oblique) in this box. This ensures all fonts the style references use the same encoding table, and thus prevents unpredictable results. Note that if the font you select exists in the PPD file of the document (i.e. is printer-resident), PlanetPress Design does not include the font when it performs a hard copy preview or an installation of the document.

Bold italic font name: Select the font to use when you set both the Bold and Italic properties on this style. You use the Italic and Bold buttons to set these properties. The Font type you selected determines the contents of this box, and the Font name you selected determines which font appears by default in this box. It is important to select a font from the same family as the font you selected for the style in the Font name box. For example, if you selected Helvetica in the Font name box, you should select a Helvetica font (for example, Helvetica Bold Oblique) in this box. This ensures all fonts the style references use the same encoding table, and thus prevents unpredictable results. Note that if the font you select exists in the PPD file of the document (i.e. is printer-resident), PlanetPress Design does not include the font when it performs a hard copy preview or an installation of the document.

5.In the Encoding box, select the encoding table you want to use for the font.

- 30 -

+ 669 hidden pages