Objectif Lune PlanetPress Design - 7.4 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 PDF Text Extraction Tolerance Factors 79 Data Selector Display Preferences 80 Dock and Undock Areas of the Program Window 81 Minimize and Customize the Ribbon 82 Show or Hide Areas of the Program Window 82 Resize the Program Window Area 82

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 110

FreeForm Caching 110 FreeForm 2 Caching 111 VPSCaching 112 VDXCaching 112 PPDSetup 114 Add or Remove PPDs 114 Refresh the PPD Lists 115 Specify Job Infos 115

Table of Content

Associate Attachments with a Document 115

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

Table of Content

Shape Object 149

N-Up Object 149

Picture Object 150

Barcode Object 152

Supported Barcodes 152

Australia Post 152 Aztec 153 CEPNet (Brazilian Postal Code) 153 Codabar 153 CodablockF 153 Code 11 154 Code 16k 154 Code 39 154 Code 49 155 Code 93 156 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 168 Pidgets 169

Capture Field Masks 169

Custom Masks 169 Regular Expressions 170 Capture Field Template List 171

Document Resources 173

Image Resources 175

Location of image resources 175

Table of Content

Static and Dynamic Images 175 Supported Image Formats 175 Image Glossary 176

Scanline Orientation 177

Image Quality Settings 178

Caches 178

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

Guidelines for Optimizing Images 180

Modifying and Updating Images 180 Color Management and Matching 181

PostScript Attachments 183

Delete a Resource 184

Conditions 187

Conditions 187 Global Conditions 187 Local Conditions 187 Line Conditions 187 Create or Remove a Line Condition 188 PlanetPress Supports Global Variables in the Global Function Library Manager 189 Create a Global Condition 190 View or Edit the Properties of a Global Condition 192 Apply or Remove a Global Condition 192 Use a Global Condition as a Variable 192 Combine Global Conditions 192 Override a Global Condition 195 Delete a Global Condition 195 Create, Edit, or Delete Local Conditions 195 Verify a Condition 196 Add a Global Function 196 View or Edit a Global Function 196 Delete a Global Function 197

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 203 Enter a New Program in the Editor 205 Import or Export a Program 205 Save a Program 205 Print a Program 205 Exit the PlanetPress Talk Editor 206 Show or Hide the Commands Area or Spy List 206 Adjust the Sizes of the Commands Area, Code Area and Spy List 206

Table of Content

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 209

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 213

Creating and using Runpages 214

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 Create a Global Variable 225 View or Edit a Global Variable 226 Delete a Global Variable 226 System Variables with Local Scope 228 System Variables with Global Scope 228 System Objects with Global Scope 229

Current System Object 229

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

Code Samples 239

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

Language Reference 243

Table of Content

Language Reference (Alphabetical) 243

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

Table of Content

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

Table of Content

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

Table of Content

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

Table of Content

ShowBarcodeRoyalMail (procedure) 352 ShowBarcodeRSS (procedure) 353 ShowBarcodeUPCA (procedure) 353 ShowBarcodeUPCE (procedure) 354 ShowBitmap (procedure) 355 ShowCaptureUserArea (procedure) 356 ShowEPS (procedure) 357 ShowLeftRight (procedure) 358 ShowPage (procedure) 358 ShowPDF (procedure) 359 ShowUTF8 (procedure) 360 ShowUTF8Left / ShowUTF8Right / ShowUTF8Center (procedure) 361 Sin (function) 362 StopJob (procedure) 363 Store (procedure) 363 StringReplace (function) 363 StringWidth (function) 364 StringWidthUTF8 (function) 365 Strip (function) 365 Stroke (procedure) 366 StrokeAndFill (procedure) 366 StrToCur (function) 367 StrToFloat (function) 367 StrToInt (function) 368 Sub (function) 368 SubRecCount (function) 369 Time (function) 370 Translate (procedure) 371 Trim (function) 372 TrimLeft (function) 372 TrimRight (function) 372 UpperCase (function) 373 xmlCount() 373 xmlGet() 374 XOr (Boolean operator function) 375

Language Reference (by element type) 375

System Variables 376 &EOJob (system variable) 376 &FirstSide (system variable) 376 &Height (system variable) 376 &PrinterMode (system variable) 377 &Str (system variable) 377 &Width (system variable) 378 System Objects 378 Current (system object) 378 Physical (system object) 380 &system (system object) 380

Table of Content

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

Table of Content

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

Table of Content

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

Table of Content

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

Table of Content

GetCyan (function) 490 GetMagenta (function) 491 Getmeta (function) 491 Getmetacount (function) 493 GetYellow (function) 494 IsNumber (function) 494 IsPageEmpty (function) 494 Left (function) 495 Length (function) 495 LowerCase (function) 496 MapUTF8 (function) 496 Mid (function) 498 Mul (function) 499 Ord (function) 499 PDFPageCount (function) 500 PDFWidth/PDFHeight (function) 500 PixelHeight (function) 501 PixelWidth (function) 501 Pos (function) 501 Random (function) 502 Region (function) 502 Regionline (function) 503 ResourceType (function) 504 Right (function) 505 StringReplace (function) 505 StringWidth (function) 506 StringWidthUTF8 (function) 507 Strip (function) 507 Sub (function) 507 SubRecCount (function) 508 Time (function) 509 Trim (function) 510 TrimLeft (function) 510 TrimRight (function) 511 UpperCase (function) 511 xmlCount() 511 xmlGet() 512

System Variables (by data type) 513

Integer 513 Measure 513 String 514 Boolean 514

Functions (by return value data type) 514

Currency 514 Add (function) 514 FloatToCur (function) 515

Table of Content

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

Table of Content

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

Procedures (by category) 560

Debugging 560 Breakpoint (procedure) 561 OutputDebugString (procedure) 561 Variables 561 Define (procedure) 561 Put (procedure) 562 Set (procedure) 563

Table of Content

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

Table of Content

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

Table of Content

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

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

Table of Content

Form Cache 654 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 Move a Document between PlanetPress Design Installations 676 Trigger 676

How a Variable Content Document Runs on a Printer 677

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

Techniques for Inserting Triggers 677 Trigger Syntax 678

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

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 Work in the Document Structure Area 686

Table of Content

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 690 Work with Objects 691 Work in the Text Properties of a Text Object 692

PlanetPress Talk Editor 692

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

About Documents 696

About Document Elements 697

About Data Selections 698 About Objects 698 PPD File 698

PP7 File 698 PTZ File 699 PTK File 699 About Resources 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 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.

+ 670 hidden pages

Objectif Lune PlanetPress Design - 7.4 Instruction Manual

Specifications and Main Features

Frequently Asked Questions

User Manual

Copyright Information

Table of Content

Fonts and Styles

Create a Style