Objectif Lune PlanetPress Design - 7.1 Instruction Manual

PlanetPress Design

User Guide

www.objectiflune.com

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 2013-03-22

Table of Content

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

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

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 81 Show or Hide Areas of the Program Window 81 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 90 Emulation 90

Text-Based Emulation Properties 91 Line Printer Emulation 91 ASCII Emulation 92 Comma Separated Value (CSV) Emulation 92 Channel Skip Emulation 93 Database Emulation 93 Export or Import a Database Emulation Configuration 95 XML Emulation 96 PDF Emulation 96 User-Defined Emulation 96 Associate a Sample Data File with a Document 97

Metadata 97

Setting Up a Document 105

Set Up a Document 105

Cacheable Execution Options 109

FreeForm Caching 110 FreeForm 2 Caching 111 VPSCaching 111 VDXCaching 112 PPDSetup 113 Add or Remove PPDs 113 Refresh the PPD Lists 114 Specify Job Infos 114 Associate Attachments with a Document 114

Table of Content

Setting Up Pages 117

Page Properties 117

Page Types 119

Normal Page 119 Overlay Page 119 Virtual Page 120 Execution Order of Pages 120

Advanced Paper Handling 120

Associate Attachments with a Page 121 Add or Remove Overlays 121

PlanetPress Design Objects 123

View or Edit the Properties of an Object 123

Basic Attributes 123 Repeat 124 Snapping Points 126 Manipulation 126 PlanetPress Talk Before and PlanetPress Talk After 127 Preview options 127

Line Repeat and Data Overflow 127

Snapping Points 128 Object Preview Window 129

Text and Box Object 130

Borders 130 Color 131 Text 131 Apply a Style to Text in a Text Object 132 Set Tabs 133 Adjust Alignment and Lines Per Unit settings 134 Spell Check Text in a Text Object 135 Use the Thesaurus 137 Change the Width of the Text Object in the Text Area 138 Use Variables in a Text Object 138

Data Selection Object 140

Data 140 Lines 140 Archive/Email/Fax 141 Text-Based Data Selections 142 Database Data Selections 143 XMLData Selections 144 PDFData Selections 145 Edit Text-Based Data Selection Size 145

Postal Address Object 146

Metadata 146

PlanetPress Talk Object 147 Shape Object 149

Table of Content

N-Up Object 149

Picture Object 150

Barcode Object 152

Supported Barcodes 152

Australia Post 152 Aztec 153 Codabar 153 CodablockF 153 Code 11 154 Code 16k 154 Code 39 154 Code 49 155 Code 93 155 Code 128 157 Datamatrix 158 Discrete 2 of 5 159 FIM 159 GS1 Databar (RSS) 159 IMB/OneCode 159 Interleaved 2 of 5 159 Japan Post 160 Maxicode 160 Micro PDF417 160 Micro QR 160 MSI Plessey 161 PDF417 161 Plessey 161 USPSPostnet 161 QR Code 162 Royal Mail 162 UPC 162 ISBN 163

Business Graphic Object 164

Excel Graphic 165

Document Resources 167

Image Resources 169

Location of image resources 169 Static and Dynamic Images 169 Supported Image Formats 169 Image Glossary 170

Scanline Orientation 171

Image Quality Settings 172

Caches 172

Host-Based Cache 173 Printer-Based Cache 173 Adding Image Resources 173

Table of Content

Guidelines for Optimizing Images 174

Modifying and Updating Images 174 Color Management and Matching 175

PostScript Attachments 177

Delete a Resource 178

Conditions 181

Conditions 181 Global Conditions 181 Local Conditions 181 Line Conditions 181 Create or Remove a Line Condition 182 PlanetPress Supports Global Variables in the Global Function Library Manager 183 Create a Global Condition 184 View or Edit the Properties of a Global Condition 186 Apply or Remove a Global Condition 186 Use a Global Condition as a Variable 186 Combine Global Conditions 186 Override a Global Condition 189 Delete a Global Condition 189 Create, Edit, or Delete Local Conditions 189 Verify a Condition 190 Add a Global Function 190 View or Edit a Global Function 190 Delete a Global Function 191

PlanetPress Talk 193

Variable PlanetPressTalk Properties 193

The PlanetPress Talk Editor 195 PlanetPress Talk Editor Features 196 Debugging Features 197 Code Execution in the Editor 197 Enter a New Program in the Editor 199 Import or Export a Program 199 Save a Program 199 Print a Program 199 Exit the PlanetPress Talk Editor 200 Show or Hide the Commands Area or Spy List 200 Adjust the Sizes of the Commands Area, Code Area and Spy List 200 Expand or Collapse Command Groups 201 Enter Commands in the Editor 201 Use Command and Variable Name Completion 202

Dynamic Images 203 PlanetPress Talk Expressions for Dynamic Images that Reference Image Resources 203 PlanetPress Talk Expressions for Dynamic Images that Reference External Images 203

Physical Location of Dynamic Images 204 Host-Based or Printer-Based Document Execution 204 Image Format 205

Table of Content

Summary of Execution Environments 205 Examples of PlanetPress Talk Expressions that Resolve to Pathnames 206

Image Name and Pathname Resolution in Dynamic Images 207

Custom Data Selections 207 PlanetPress Talk Before and After 207

Creating and using Runpages 208

Convert an Object to PlanetPress Talk 209

PlanetPress Talk Basics 211

Assumed Knowledge 211 PlanetPress Talk 211 PlanetPress Talk Terminology 213 The Elements of PlanetPress Talk 213 PlanetPress Talk Syntax 214 Data Types 216 Variables 218 Create a Global Variable 219 View or Edit a Global Variable 220 Delete a Global Variable 220 System Variables with Local Scope 222 System Variables with Global Scope 222 System Objects with Global Scope 223

Current System Object 223

Runpage 226 Using Foreign Language Text with PPtalk 226 Learning PlanetPress Talk 230 Integrate PlanetPress Talk into Documents 231 Define and Assign Values to Variables 231 Select Data 232 Use Functions as Arguments 232 Debug Scripts 232 Tips and Tricks 232

Code Samples 233

Print a variable number of copies of a page based on a value in the datastream 233 Store two lines of input data on one line of the data page 234 Print a line of text on odd-numbered pages 235 Determine the proper page to print based on the width of the data in the data page 235

Language Reference 237 Language Reference (Alphabetical) 237

% (procedure) 237 Current (system object) 237 ¤titeration (variable) 239 &Document (system object) 240 &EOJob (system variable) 240 &FirstSide (system variable) 240 &Height (system variable) 241 &iterationcount (variable) 241

Table of Content

lastoverflowcount (variable) 241 &Metamode (variable) 241 Physical (system object) 242 &PrinterMode (system variable) 242 Script (system object) 243 &Str (system variable) 244 &system (system object) 244 &watch (system object) 245 &Width (system variable) 245 @ (function) 245 @name (function/procedure) 246 @page (procedure) 246 $element (procedure) 247 + (operator & function) 247 – (operator) 248 Asterisk (*) operator 248 / (operator) 248 Greater than (>) operator 248 Greater or equal to (>=) operator 248 Less than (<) operator 248 Less or equal to (<=) operator 248 = (operator) 248 <> (operator) 249 Add (function) 249 And (Boolean operator function) 249 Arc and ArcN (procedures) 250 BeginDocument/EndDocument (procedure) 251 BeginGroup/EndGroup (procedure) 252 BeginParagraph … EndParagraph (procedure) 252 BeginUTF8Paragraph … EndUTF8Paragraph (procedure) 254 BitmapWidth/BitmapHeight (function) 254 Breakpoint (procedure) 255 C128 (function) 255 CallPPD (procedure) 256 Ceil (function) 256 Char (function) 257 CharPath (procedure) 257 ClearPage (procedure) 258 ClipPath (procedure) 258 ClosePath (procedure) 259 Cos (function) 259 CRLF (procedure) 260 CurToStr (function) 260 CurToFloat (function) 261 CurveTo/RCurveTo (procedure) 261 Date (function) 262 Define (procedure) 263

Table of Content

DefineData (procedure) 263 DefineImageIndex (procedure) 264 Definemeta (function) 264 Div (function) 265 DoForm (procedure) 266 endpageset (procedure) 266 EPSWidth/EPSHeight (function) 267 Eq (function) 268 ExecPage (procedure) 268 ExecScriptFile (function) 269 Exit (procedure) 270 ExpandString (function) 271 Field (function) 271 FieldCount (function) 272 FieldName (function) 272 Fill (procedure) 272 Find (function) 273 FloatToCur (function) 273 FloatToInt (function) 274 FloatToStr (function) 274 For… EndFor (procedure) 275 Function @name (procedure) 276 GE (function) 278 Get (function) 279 GetBlack (function) 280 GetCyan (function) 280 GetMagenta (function) 280 Getmeta (function) 281 Getmetacount (function) 282 GetNextDataPage(procedure) 283 GetYellow (function) 284 GRestore (procedure) 284 GSave (procedure) 284 GT (function) 285 If (function) 286 If … ElseIf… EndIf (procedure) 286 InStream... EndInStream (procedure) 288 IntToCur (function) 289 IntToFloat (function) 289 IntToStr (function) 290 IsNumber (function) 291 IsPageEmpty (function) 291 LE (function) 291 Left (function) 292 Length (function) 293 LineTo/RLineTo (procedure) 293 LowerCase (function) 294

Table of Content

LT (function) 294 MapUTF8 (function) 295 Margin (procedure) 297 Mid (function) 297 Mod (function & procedure) 298 MoveTo/RMoveTo (procedure) 299 Mul (function) 299 NE (function) 300 Neg (function) 301 Not (Boolean operator function) 301 Object $name()... EndObject (procedure) 302 Or (Boolean operator function) 304 Ord (function) 304 OutputDebugString (procedure) 305 PassThrough (procedure) 305 PDFPageCount (function) 306 PDFWidth/PDFHeight (function) 306 Pie (procedure) 307 PixelHeight (function) 308 PixelWidth (function) 308 Pos (function) 308 Put (procedure) 309 Random (function) 309 Rectangle (procedure) 310 RectFill (procedure) 311 RectFillStroke (procedure) 312 RectStroke (procedure) 312 Region (function) 313 Regionline (function) 314 Repeat... Until (procedure) 314 ResourceType (function) 315 Right (function) 316 RunPS (procedure) 317 Scale (procedure) 317 Search … EndSearch (procedure) 317 SelectMedia (procedure) 318 SelectPrinter (procedure) 319 Set (procedure) 319 SetAngle (procedure) 320 SetBodyText (procedure) 321 SetDash(procedure) 321 SetDataPage(procedure) 322 SetEmailAddress (procedure) 322 SetEmailSubject (procedure) 322 SetEmulation(procedure) 322 SetUserCRLF (procedure) 323 SetFaxInformation (procedure) 323

Table of Content

SetFaxNumber (procedure) 324 SetFillColor (procedure) 324 SetImageIndex (procedure) 325 SetLineWidth (procedure) 325 SetLPP(procedure) 326 SetPDFBookmark (procedure) 326 SetStrokeColor (procedure) 327 SetStyle (procedure) 327 SetStyleExt (procedure) 328 Show / ShowCenter / ShowRight (procedure) 329 ShowBarCode (procedure) 329 ShowBarcode2of5(procedure) 331 ShowBarcodeAustPost (procedure) 331 ShowBarcodeAztec (procedure) 331 ShowBarcodeCodabar (procedure) 332 ShowBarcodeCodablockF (procedure) 333 ShowBarcodeCode11 (procedure) 334 ShowBarcodeCode128 (procedure) 334 ShowBarcodeCode16k (procedure) 335 ShowBarcodeCode39 (procedure) 335 ShowBarcodeCode49 (procedure) 336 ShowBarcodeCode93 (procedure) 336 ShowBarcodeDatamatrix (procedure) 337 ShowBarcodeEAN8 (procedure) 338 ShowBarcodeEAN13 (procedure) 338 ShowBarcodeFIM (procedure) 339 ShowBarcodeI2of5 (procedure) 339 ShowBarcodeISBN (procedure) 340 ShowBarcodeJapanpost (procedure) 341 ShowBarcodeMaxicode (procedure) 341 ShowBarcodeMicroPDF (procedure) 342 ShowBarcodeMicroQR (procedure) 342 ShowBarcodeMSI (procedure) 343 ShowBarcodeOnecode (procedure) 343 ShowBarcodePDF417 (procedure) 344 ShowBarcodePlessey (procedure) 345 ShowBarcodePostnet (procedure) 345 ShowBarcodeQRCode (procedure) 346 ShowBarcodeRoyalMail (procedure) 346 ShowBarcodeRSS (procedure) 347 ShowBarcodeUPCA (procedure) 347 ShowBarcodeUPCE (procedure) 348 ShowBitmap (procedure) 349 ShowCaptureUserArea (procedure) 350 ShowEPS (procedure) 351 ShowLeftRight (procedure) 352 ShowPage (procedure) 352

Table of Content

ShowPDF (procedure) 353 ShowUTF8 (procedure) 354 ShowUTF8Left / ShowUTF8Right / ShowUTF8Center (procedure) 355 Sin (function) 356 StopJob (procedure) 357 Store (procedure) 357 StringReplace (function) 357 StringWidth (function) 358 StringWidthUTF8 (function) 359 Strip (function) 359 Stroke (procedure) 360 StrokeAndFill (procedure) 360 StrToCur (function) 361 StrToFloat (function) 361 StrToInt (function) 362 Sub (function) 362 SubRecCount (function) 363 Time (function) 364 Translate (procedure) 365 Trim (function) 366 TrimLeft (function) 366 TrimRight (function) 366 UpperCase (function) 367 xmlCount() 367 xmlGet() 368 XOr (Boolean operator function) 369

Language Reference (by element type) 369

System Variables 370 &EOJob (system variable) 370 &FirstSide (system variable) 370 &Height (system variable) 370 &PrinterMode (system variable) 371 &Str (system variable) 371 &Width (system variable) 372 System Objects 372 Current (system object) 372 Physical (system object) 374 &system (system object) 374 Assignment Operator 375 = (operator) 375 Mathematical Operators and Operator Functions 375 + (operator & function) 375 Add (function) 376 – (operator) 376 Sub (function) 376 Asterisk (*) operator 377 Mul (function) 377

Table of Content

/ (operator) 377 Div (function) 377 Neg (function) 378 Cos (function) 378 Sin (function) 379 Random (function) 380 Ceil (function) 380 String Operator 381 + (operator & function) 381 Boolean Operator Functions 381 And (Boolean operator function) 381 Not (Boolean operator function) 382 Or (Boolean operator function) 382 XOr (Boolean operator function) 383 Comparison Operators and Operator Functions 384 GT (function) 384 Greater than (>) operator 385 GE (function) 385 Greater or equal to (>=) operator 385 LT (function) 385 Less than (<) operator 386 LE (function) 386 Less or equal to (<=) operator 387 Eq (function) 387 = (operator) 387 NE (function) 388 <> (operator) 388 Conversion Operator Functions 388 FloatToCur (function) 389 FloatToInt (function) 389 FloatToStr (function) 389 IntToCur (function) 390 IntToFloat (function) 390 IntToStr (function) 391 StrToCur (function) 392 StrToFloat (function) 392 StrToInt (function) 392 Loop Structures 393 For… EndFor (procedure) 393 Repeat... Until (procedure) 394 Search … EndSearch (procedure) 395 Exit (procedure) 396 Condition Structures 396 If … ElseIf… EndIf (procedure) 396 If (function) 398 Procedures 399 % (procedure) 399

Table of Content

@name (function/procedure) 399 @page (procedure) 400 $element (procedure) 400 Arc and ArcN (procedures) 401 BeginDocument/EndDocument (procedure) 402 BeginGroup/EndGroup (procedure) 403 BeginParagraph … EndParagraph (procedure) 403 BeginUTF8Paragraph … EndUTF8Paragraph (procedure) 405 Breakpoint (procedure) 406 CallPPD (procedure) 406 CharPath (procedure) 407 ClearPage (procedure) 407 ClipPath (procedure) 408 ClosePath (procedure) 408 CRLF (procedure) 409 CurveTo/RCurveTo (procedure) 409 Define (procedure) 410 DefineData (procedure) 411 DefineImageIndex (procedure) 412 DoForm (procedure) 412 endpageset (procedure) 413 ExecPage (procedure) 413 Exit (procedure) 414 Fill (procedure) 415 For… EndFor (procedure) 415 Function @name (procedure) 416 GetNextDataPage(procedure) 419 GRestore (procedure) 419 GSave (procedure) 419 If … ElseIf… EndIf (procedure) 420 InStream... EndInStream (procedure) 422 LineTo/RLineTo (procedure) 423 Margin (procedure) 424 MoveTo/RMoveTo (procedure) 424 Object $name()... EndObject (procedure) 425 OutputDebugString (procedure) 426 PassThrough (procedure) 427 Pie (procedure) 427 Put (procedure) 428 Rectangle (procedure) 429 RectFill (procedure) 429 RectFillStroke (procedure) 430 RectStroke (procedure) 431 Repeat... Until (procedure) 431 RunPS (procedure) 432 Scale (procedure) 433 Search … EndSearch (procedure) 433

Table of Content

SelectMedia (procedure) 434 SelectPrinter (procedure) 435 Set (procedure) 435 SetAngle (procedure) 436 SetBodyText (procedure) 436 SetDash(procedure) 437 SetDataPage(procedure) 437 SetEmailAddress (procedure) 438 SetEmailSubject (procedure) 438 SetEmulation(procedure) 438 SetUserCRLF (procedure) 438 SetFaxInformation (procedure) 439 SetFaxNumber (procedure) 439 SetFillColor (procedure) 440 SetImageIndex (procedure) 440 SetLineWidth (procedure) 441 SetLPP(procedure) 442 SetPDFBookmark (procedure) 442 SetStrokeColor (procedure) 443 SetStyle (procedure) 443 SetStyleExt (procedure) 444 Show / ShowCenter / ShowRight (procedure) 445 ShowBarCode (procedure) 445 ShowBarcode2of5(procedure) 446 ShowBarcodeAustPost (procedure) 447 ShowBarcodeAztec (procedure) 447 ShowBarcodeCodabar (procedure) 448 ShowBarcodeCodablockF (procedure) 449 ShowBarcodeCode11 (procedure) 449 ShowBarcodeCode128 (procedure) 450 ShowBarcodeCode16k (procedure) 451 ShowBarcodeCode39 (procedure) 451 ShowBarcodeCode49 (procedure) 452 ShowBarcodeCode93 (procedure) 452 ShowBarcodeDatamatrix (procedure) 453 ShowBarcodeEAN8 (procedure) 453 ShowBarcodeEAN13 (procedure) 454 ShowBarcodeFIM (procedure) 455 ShowBarcodeI2of5 (procedure) 455 ShowBarcodeISBN (procedure) 456 ShowBarcodeJapanpost (procedure) 456 ShowBarcodeMaxicode (procedure) 457 ShowBarcodeMicroPDF (procedure) 457 ShowBarcodeMicroQR (procedure) 458 ShowBarcodeMSI (procedure) 459 ShowBarcodeOnecode (procedure) 459 ShowBarcodePDF417 (procedure) 460

Table of Content

ShowBarcodePlessey (procedure) 460 ShowBarcodePostnet (procedure) 461 ShowBarcodeQRCode (procedure) 461 ShowBarcodeRoyalMail (procedure) 462 ShowBarcodeRSS (procedure) 462 ShowBarcodeUPCA (procedure) 463 ShowBarcodeUPCE (procedure) 464 ShowBitmap (procedure) 464 ShowCaptureUserArea (procedure) 466 ShowEPS (procedure) 467 ShowLeftRight (procedure) 467 ShowPage (procedure) 468 ShowPDF (procedure) 469 ShowUTF8 (procedure) 469 ShowUTF8Left / ShowUTF8Right / ShowUTF8Center (procedure) 470 StopJob (procedure) 472 Store (procedure) 472 Stroke (procedure) 473 StrokeAndFill (procedure) 473 Translate (procedure) 474 Functions 475 @ (function) 475 @name (function/procedure) 475 BitmapWidth/BitmapHeight (function) 476 C128 (function) 476 Ceil (function) 477 Char (function) 477 Date (function) 478 Definemeta (function) 478 EPSWidth/EPSHeight (function) 479 ExecScriptFile (function) 480 ExpandString (function) 481 Field (function) 481 FieldCount (function) 482 FieldName (function) 482 Find (function) 483 Get (function) 483 GetBlack (function) 484 GetCyan (function) 484 GetMagenta (function) 485 Getmeta (function) 485 Getmetacount (function) 487 GetYellow (function) 488 IsNumber (function) 488 IsPageEmpty (function) 488 Left (function) 489 Length (function) 489

Table of Content

LowerCase (function) 490 MapUTF8 (function) 490 Mid (function) 492 Mul (function) 493 Ord (function) 493 PDFPageCount (function) 494 PDFWidth/PDFHeight (function) 494 PixelHeight (function) 495 PixelWidth (function) 495 Pos (function) 495 Random (function) 496 Region (function) 496 Regionline (function) 497 ResourceType (function) 498 Right (function) 499 StringReplace (function) 499 StringWidth (function) 500 StringWidthUTF8 (function) 501 Strip (function) 501 Sub (function) 501 SubRecCount (function) 502 Time (function) 503 Trim (function) 504 TrimLeft (function) 504 TrimRight (function) 505 UpperCase (function) 505 xmlCount() 505 xmlGet() 506

System Variables (by data type) 507

Integer 507 Measure 507 String 508 Boolean 508

Functions (by return value data type) 508

Currency 508 Add (function) 508 FloatToCur (function) 509 IntToCur (function) 509 StrToCur (function) 509 Integer 510 Add (function) 510 Ceil (function) 510 Div (function) 511 FieldCount (function) 511 FloatToInt (function) 511 Get (function) 512

Table of Content

GetBlack (function) 512 GetCyan (function) 513 GetMagenta (function) 513 GetYellow (function) 514 Getmetacount (function) 514 If (function) 515 Length (function) 516 Mod (function & procedure) 516 Mul (function) 517 Neg (function) 518 Ord (function) 518 PDFPageCount (function) 519 PixelHeight (function) 519 PixelWidth (function) 519 Pos (function) 520 ResourceType (function) 520 StrToInt (function) 521 Sub (function) 522 SubRecCount (function) 522 xmlCount() 523 Measure 524 Add (function) 524 BitmapWidth/BitmapHeight (function) 525 Cos (function) 525 CurToFloat (function) 526 Div (function) 526 EPSWidth/EPSHeight (function) 526 Get (function) 527 If (function) 527 IntToFloat (function) 528 Mul (function) 529 Neg (function) 529 PDFWidth/PDFHeight (function) 530 Random (function) 530 Sin (function) 531 StringWidth (function) 531 StringWidthUTF8 (function) 532 StrToFloat (function) 532 Sub (function) 533 String 534 @ (function) 534 C128 (function) 534 Char (function) 535 CurToStr (function) 535 ExpandString (function) 535 Field (function) 536 FieldName (function) 536

Table of Content

FloatToStr (function) 537 Get (function) 537 If (function) 538 IntToStr (function) 538 Left (function) 539 LowerCase (function) 540 Mid (function) 540 Right (function) 541 StringReplace (function) 542 Strip (function) 542 Trim (function) 543 TrimLeft (function) 543 TrimRight (function) 544 UpperCase (function) 544 xmlGet() 544 Boolean 545 Add (function) 545 Eq (function) 546 Find (function) 547 GE (function) 547 GT (function) 548 If (function) 548 IsNumber (function) 549 IsPageEmpty (function) 549 LE (function) 550 LT (function) 550 NE (function) 551 Not (Boolean operator function) 552 Or (Boolean operator function) 552 XOr (Boolean operator function) 553

Procedures (by category) 554

Debugging 554 Breakpoint (procedure) 555 OutputDebugString (procedure) 555 Variables 555 Define (procedure) 555 Put (procedure) 556 Set (procedure) 557 Global Functions 557 @name (function/procedure) 557 Function @name (procedure) 558 Comments 560 % (procedure) 560 Graphics State 561 GRestore (procedure) 561 GSave (procedure) 561 Scale (procedure) 562

Table of Content

SetAngle (procedure) 563 SetDash(procedure) 563 SetFillColor (procedure) 564 SetLineWidth (procedure) 565 SetStrokeColor (procedure) 565 Translate (procedure) 565 Path 566 Arc and ArcN (procedures) 567 ClosePath (procedure) 568 CurveTo/RCurveTo (procedure) 568 Fill (procedure) 569 LineTo/RLineTo (procedure) 570 MoveTo/RMoveTo (procedure) 571 Pie (procedure) 571 Rectangle (procedure) 572 RectFill (procedure) 573 RectFillStroke (procedure) 574 RectStroke (procedure) 574 Stroke (procedure) 575 StrokeAndFill (procedure) 576 Paragraphs and Text 576 BeginParagraph … EndParagraph (procedure) 576 BeginUTF8Paragraph … EndUTF8Paragraph (procedure) 578 CRLF (procedure) 579 Margin (procedure) 579 ShowLeftRight (procedure) 580 Show / ShowCenter / ShowRight (procedure) 580 Styles 581 SetStyle (procedure) 581 SetStyleExt (procedure) 582 Objects 583 Object $name()... EndObject (procedure) 583 Bar Codes 584 ShowBarCode (procedure) 584 ShowBarcode2of5(procedure) 585 ShowBarcodeAustPost (procedure) 586 ShowBarcodeAztec (procedure) 586 ShowBarcodeCodabar (procedure) 587 ShowBarcodeCodablockF (procedure) 588 ShowBarcodeCode11 (procedure) 588 ShowBarcodeCode128 (procedure) 589 ShowBarcodeCode16k (procedure) 590 ShowBarcodeCode39 (procedure) 590 ShowBarcodeCode49 (procedure) 591 ShowBarcodeCode93 (procedure) 591 ShowBarcodeDatamatrix (procedure) 592 ShowBarcodeEAN8 (procedure) 592

Table of Content

ShowBarcodeEAN13 (procedure) 593 ShowBarcodeFIM (procedure) 594 ShowBarcodeI2of5 (procedure) 594 ShowBarcodeISBN (procedure) 595 ShowBarcodeJapanpost (procedure) 595 ShowBarcodeMaxicode (procedure) 596 ShowBarcodeMicroPDF (procedure) 596 ShowBarcodeMicroQR (procedure) 597 ShowBarcodeMSI (procedure) 598 ShowBarcodeOnecode (procedure) 598 ShowBarcodePDF417 (procedure) 599 ShowBarcodePlessey (procedure) 599 ShowBarcodePostnet (procedure) 600 ShowBarcodeQRCode (procedure) 601 ShowBarcodeRoyalMail (procedure) 601 ShowBarcodeRSS (procedure) 602 ShowBarcodeUPCA (procedure) 602 ShowBarcodeUPCE (procedure) 603 Resources 604 InStream... EndInStream (procedure) 604 ShowBitmap (procedure) 605 ShowEPS (procedure) 606 ShowPDF (procedure) 607 Elements 607 $element (procedure) 607 Emulation, Data File, and Data Pages 608 ClearPage (procedure) 608 DefineData (procedure) 609 DoForm (procedure) 609 GetNextDataPage(procedure) 610 SetDataPage(procedure) 610 SetEmulation(procedure) 610 SetLPP(procedure) 611 Store (procedure) 611 Data Destined for PlanetPress Image, PlanetPress Fax and PlanetPress Search 611 DefineImageIndex (procedure) 612 SetBodyText (procedure) 612 SetEmailAddress (procedure) 612 SetEmailSubject (procedure) 613 SetFaxInformation (procedure) 613 SetFaxNumber (procedure) 613 SetImageIndex (procedure) 614 SetPDFBookmark (procedure) 614 Document Pages 615 @page (procedure) 615 ExecPage (procedure) 616 ShowPage (procedure) 616

Table of Content

PPDs and PostScript 617 CallPPD (procedure) 617 PassThrough (procedure) 618 RunPS (procedure) 618 SelectMedia (procedure) 618 Program Control 619 Exit (procedure) 619 For… EndFor (procedure) 620 If … ElseIf… EndIf (procedure) 621 Repeat... Until (procedure) 623 Search … EndSearch (procedure) 623 StopJob (procedure) 624

Conversion Tables 625 ASCII Conversion Table 626 Points to Inches or Centimeters 628

Points to Inches 629 Points to Centimeters 631

Line Height as a Function of Lines Per Unit (LPU) 632

Line Height as a Function of Lines Per Inch 632 Line Height as a Function of Lines Per Centimeter 632

Tools and Utilities 635

The Image Downloader 635 Adjust the Image Quality Options 637 Virtual Drive Manager 639

Access Manager 639

To open the Access Manager 640 To add a new entry in the list 640 To modify permissions 641

SOAPAccess 641

To add a new SOAPuser 642 To define or change the permissions for a SOAP User 642

Managing Documents and Printers 645

Obtain Information from a Printer 645 Delete Documents or Files on the Printer 645 Printer Firmware Version 646 Control Versions of a Document 646 Adjust Printer Settings 647 Form Cache 648 Remove Background Color 648 Named Colors 649 Create a Graybar Report 650 The Hex Viewer 652 Date and Time Format 654

Document Output and Preview 657

About Previewing and Printing 657

Preview a Document On Screen 657

Table of Content

Previews of Documents that Use ASCII Emulation 660 Preview a Capture-Ready document 661 Print a Document Preview 661 Print Using a Windows Driver 662 Printing Using a Windows Driver 664 Generate a Soft Proof 664 Convert a Document and Save It to a File 666

Install a Document 667

Install a document on one or more printers 667 Send the document to one or more local PlanetPress Workflow servers 668 Save a PTK or PTZfile to send to a remote PlanetPress Workflow installation 669 Send a document to PlanetPress iWatch or a UNIX or Linux CodeHost BrightQ print spooler system: 669

Perform a Batch Conversion and/or Installation 670

To use the Batch Send To wizard 670 Move a Document between PlanetPress Design Installations 670 Trigger 670

How a Variable Content Document Runs on a Printer 671

Phase 1: Data Reading 671 Phase 2: Global Condition Resolution 671 Phase 3: Document Page Printing 671

Techniques for Inserting Triggers 671 Trigger Syntax 672

Trigger Syntax for Documents Installed on a Hard Disk 673 Trigger Syntax for Documents Installed in RAM 673 Trigger Syntax for Documents Installed in Flash Memory 673 Run a Document Installed on a Printer 674 Run a Document Installed in a PlanetPress Suite Workflow Tool 674 Run a Document that Uses a Database Emulation 674 Run Several Documents as a Single Job 675 Troubleshoot Execution Problems 675

Keyboard Shortcuts 679

PlanetPress Design General 679

Exit PlanetPress Design 679 Use the Help System 679 Show or Hide Areas of the Program Window 680 Work with Hierarchies 680 Work in the Document Structure Area 680 Work with Documents 680 Preview and Install Documents 681 Work with Pages 681 Adjust the Zoom 682 Use Basic Editing Commands 682 Work in the Data Pane 682 Work with the Data File 683 Work with Data Selections 683 Use the Hex Viewer 684

Table of Content

Work with Objects 685 Work in the Text Properties of a Text Object 686

PlanetPress Talk Editor 686

General 687 Show or Hide Areas of the Editor 687 Expand or Collapse Groups in the Commands Area 687 Work in the Code Area 688 Use Command Name Completion/Argument Insertion 688 Undo Commands 688 Work with Selections 688 Add/Remove Comments 689 Indent Code 689 Search 689 Jump to a Specific Line 689 Use Bookmarks 689 Execute a Program 689 Debug Code 690 Print the Script 690 Converted Document 690

About Documents 690

About Document Elements 691

About Data Selections 692 About Objects 692 PPD File 692

PP7 File 692 PTZ File 693 PTK File 693 About Resources 693

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-readable 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:

l In the Structure area, right-click on the Styles folder and choose Style. l 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 fontwhen it performs a hard copy preview or installation of

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 fontappears 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.

+ 664 hidden pages