Objectif Lune PlanetPress Talk - 7.0, PlanetPress Design - 7.6 User Guide

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 2012-01-25

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

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

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

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

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

Table of Content

Language Reference (Alphabetical) 241

% (procedure) 241 Current (system object) 241 ¤titeration (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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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 font when 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 fontsize 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.

+ 669 hidden pages

Objectif Lune PlanetPress Talk - 7.0, PlanetPress Design - 7.6 User Guide

Specifications and Main Features

Frequently Asked Questions

User Manual

Copyright Information

Table of Content

Fonts and Styles

Create a Style