Objectif Lune PlanetPress Design - 7.2 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 112 VDXCaching 112 PPDSetup 113 Add or Remove PPDs 114 Refresh the PPD Lists 114 Specify Job Infos 114 Associate Attachments with a Document 115

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

Capture Field Object 166

Considerations 167 Pidgets 168

Capture Field Masks 168

Custom Masks 169 Regular Expressions 170

Document Resources 171

Image Resources 173

Location of image resources 173 Static and Dynamic Images 173 Supported Image Formats 173 Image Glossary 174

Table of Content

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 PlanetPress Supports Global Variables in the Global Function Library Manager 187 Create a Global Condition 188 View or Edit the Properties of a Global Condition 190 Apply or Remove a Global Condition 190 Use a Global Condition as a Variable 190 Combine Global Conditions 190 Override a Global Condition 193 Delete a Global Condition 193 Create, Edit, or Delete Local Conditions 193 Verify a Condition 194 Add a Global Function 194 View or Edit a Global Function 194 Delete a Global Function 195

PlanetPress Talk 197

Variable PlanetPressTalk Properties 197

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

Table of Content

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

Physical Location of Dynamic Images 208 Host-Based or Printer-Based Document Execution 208 Image Format 209 Summary of Execution Environments 209 Examples of PlanetPress Talk Expressions that Resolve to Pathnames 210

Image Name and Pathname Resolution in Dynamic Images 211

Custom Data Selections 211 PlanetPress Talk Before and After 211

Creating and using Runpages 212

Convert an Object to PlanetPress Talk 213

PlanetPress Talk Basics 215

Assumed Knowledge 215 PlanetPress Talk 215 PlanetPress Talk Terminology 217 The Elements of PlanetPress Talk 217 PlanetPress Talk Syntax 218 Data Types 220 Variables 222 Create a Global Variable 223 View or Edit a Global Variable 224 Delete a Global Variable 224 System Variables with Local Scope 226 System Variables with Global Scope 226 System Objects with Global Scope 227

Current System Object 227

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

Code Samples 237

Print a variable number of copies of a page based on a value in the datastream 237 Store two lines of input data on one line of the data page 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 Language Reference (Alphabetical) 241

% (procedure) 241 Current (system object) 241

Table of Content

¤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 &watch (system object) 249 &Width (system variable) 249 @ (function) 249 @name (function/procedure) 250 @page (procedure) 250 $element (procedure) 251 + (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) 253 Add (function) 253 And (Boolean operator function) 253 Arc and ArcN (procedures) 254 BeginDocument/EndDocument (procedure) 255 BeginGroup/EndGroup (procedure) 256 BeginParagraph … EndParagraph (procedure) 256 BeginUTF8Paragraph … EndUTF8Paragraph (procedure) 258 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 ClosePath (procedure) 263 Cos (function) 263

Table of Content

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 IntToStr (function) 294 IsNumber (function) 295

Table of Content

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) 308 OutputDebugString (procedure) 309 PassThrough (procedure) 309 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 SetBodyText (procedure) 325 SetDash(procedure) 325

Table of Content

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 ShowBarcodeRSS (procedure) 351 ShowBarcodeUPCA (procedure) 351

Table of Content

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 = (operator) 379 Mathematical Operators and Operator Functions 379

Table of Content

+ (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 Repeat... Until (procedure) 398 Search … EndSearch (procedure) 399

Table of Content

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) 430 PassThrough (procedure) 431 Pie (procedure) 431 Put (procedure) 432 Rectangle (procedure) 433 RectFill (procedure) 433

Table of Content

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 ShowBarcodeISBN (procedure) 460 ShowBarcodeJapanpost (procedure) 460

Table of Content

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) 485 FieldCount (function) 486 FieldName (function) 486 Find (function) 487 Get (function) 487 GetBlack (function) 488 GetCyan (function) 488 GetMagenta (function) 489 Getmeta (function) 489

Table of Content

Getmetacount (function) 491 GetYellow (function) 492 IsNumber (function) 492 IsPageEmpty (function) 492 Left (function) 493 Length (function) 493 LowerCase (function) 494 MapUTF8 (function) 494 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) 500 Regionline (function) 501 ResourceType (function) 502 Right (function) 503 StringReplace (function) 503 StringWidth (function) 504 StringWidthUTF8 (function) 505 Strip (function) 505 Sub (function) 505 SubRecCount (function) 506 Time (function) 507 Trim (function) 508 TrimLeft (function) 508 TrimRight (function) 509 UpperCase (function) 509 xmlCount() 509 xmlGet() 510

System Variables (by data type) 511

Integer 511 Measure 511 String 512 Boolean 512

Functions (by return value data type) 512

Currency 512 Add (function) 512 FloatToCur (function) 513 IntToCur (function) 513 StrToCur (function) 513 Integer 514

Table of Content

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

Table of Content

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

Procedures (by category) 558

Debugging 558 Breakpoint (procedure) 559 OutputDebugString (procedure) 559 Variables 559 Define (procedure) 559 Put (procedure) 560 Set (procedure) 561 Global Functions 561 @name (function/procedure) 561 Function @name (procedure) 562

Table of Content

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

Table of Content

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

Table of Content

SetImageIndex (procedure) 618 SetPDFBookmark (procedure) 618 Document Pages 619 @page (procedure) 619 ExecPage (procedure) 620 ShowPage (procedure) 620 PPDs and PostScript 621 CallPPD (procedure) 621 PassThrough (procedure) 622 RunPS (procedure) 622 SelectMedia (procedure) 622 Program Control 623 Exit (procedure) 623 For… EndFor (procedure) 624 If … ElseIf… EndIf (procedure) 625 Repeat... Until (procedure) 627 Search … EndSearch (procedure) 627 StopJob (procedure) 628

Conversion Tables 629 ASCII Conversion Table 630 Points to Inches or Centimeters 632

Points to Inches 633 Points to Centimeters 635

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

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

Tools and Utilities 639

The Image Downloader 639 Adjust the Image Quality Options 641 Virtual Drive Manager 643

Access Manager 643

To open the Access Manager 644 To add a new entry in the list 644 To modify permissions 645

SOAPAccess 645

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

Managing Documents and Printers 649

Obtain Information from a Printer 649 Delete Documents or Files on the Printer 649 Printer Firmware Version 650 Control Versions of a Document 650 Adjust Printer Settings 651 Form Cache 652 Remove Background Color 652 Named Colors 653

Table of Content

Create a Graybar Report 654 The Hex Viewer 656 Date and Time Format 658

Document Output and Preview 661

About Previewing and Printing 661

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

Install a Document 671

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

Perform a Batch Conversion and/or Installation 674

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

How a Variable Content Document Runs on a Printer 675

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

Techniques for Inserting Triggers 675 Trigger Syntax 676

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

Keyboard Shortcuts 683

PlanetPress Design General 683

Exit PlanetPress Design 683 Use the Help System 683 Show or Hide Areas of the Program Window 684 Work with Hierarchies 684 Work in the Document Structure Area 684 Work with Documents 684 Preview and Install Documents 685 Work with Pages 685

Table of Content

Adjust the Zoom 686 Use Basic Editing Commands 686 Work in the Data Pane 686 Work with the Data File 687 Work with Data Selections 687 Use the Hex Viewer 688 Work with Objects 689 Work in the Text Properties of a Text Object 690

PlanetPress Talk Editor 690

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

About Documents 694

About Document Elements 695

About Data Selections 696 About Objects 696 PPD File 696

PP7 File 696 PTZ File 697 PTK File 697 About Resources 697

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.

+ 668 hidden pages

Objectif Lune PlanetPress Design - 7.2 Instruction Manual

Specifications and Main Features

Frequently Asked Questions

User Manual

Copyright Information

Table of Content

Fonts and Styles

Create a Style