Objectif Lune PlanetPress Design - 7.3 User Guide

4.7 (3)

PlanetPress Design

User Guide

www.objectiflune.com

©2010 Objectif Lune Inc

- 2 -

Copyright Information

Copyright Information

Copyright © 1994-2011 Objectif Lune Inc. All Rights Reserved.

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

©2010 Objectif Lune Inc

- 3 -

©2010 Objectif Lune Inc

- 4 -

Table of Content

Table of Content

Copyright Information

 

3

Table of Content

 

5

Fonts and Styles

 

29

Create a Style

 

29

Apply a Style

 

31

View or Edit the Properties of a Style

 

31

Delete a Style

 

32

Set the Default Style for New Objects and Groups

 

32

Create a MICR Style for Account Information on Cheques

33

Arabic Content in PlanetPress Design Documents

 

33

CID-Keyed Fonts

 

34

Double-byte Character Sets

 

34

Encoding Tables

 

34

Why have different encoding tables?

 

35

Encoding Tables in PlanetPress Design

 

35

Edit the Encoding Table for a Style

 

35

Set a Default Encoding Table

 

38

Export an Encoding Table

 

38

Refresh the Font Lists

 

38

Install a PostScript Font in PlanetPress Design

 

39

Overview

 

41

Icons used in this guide

 

41

Other Documentation

 

41

Getting Started

 

43

Environment Considerations

 

43

Terminal Server/Service

 

43

VMWare/ESX

 

43

32-Bit or 64-Bit?

 

43

Network Considerations

 

43

Mapped Drives

 

43

Activate Your Printers

 

44

The Nature of PlanetPress Design

 

44

The PlanetPress Design Program

 

45

Start PlanetPress Design

 

45

The PlanetPress Suite Button

 

45

Open a Document

 

46

Save a Document

 

47

Save and Open a Document Template

 

47

Change the Interface Language

 

47

Exit PlanetPress Design

 

48

The Quick Access Toolbar

 

48

The PlanetPress Design Ribbon

 

49

©2010 Objectif Lune Inc

- 5 -

 

Table of Content

Undo and Redo Commands

 

50

Navigate Data Pages

 

51

Document Structure Area

 

51

Selecting and moving elements

 

52

Add a Metadata Field

 

52

Add a Document Page

 

53

Edit the Order of Pages

 

53

Duplicate a Page

 

53

Delete a Page

 

54

Object Layering Order

 

54

Group and Ungroup Objects and/or Groups

 

55

Data Pane

 

55

Object Inspector

 

55

Workspace Area

 

56

Using the Select Tool in the Workspace

 

56

Zoom in and out of the Workspace

 

57

Pan the Workspace

 

57

Use Guides

 

58

Right-Click Menu in the Workspace

 

59

Detailed Directions

 

59

Debug an Object or Group

 

60

Select Objects and/or Groups

 

60

Lock and Unlock Objects and Groups

 

60

Reposition Objects and/or Groups

 

61

Resize Objects and/or Groups

 

61

Delete Objects and/or Groups

 

62

Align Objects and/or Groups

 

63

Rotate Objects and/or Groups

 

63

Duplicate Objects and/or Groups

 

63

Snap or Unsnap Objects and/or Groups

 

63

Copy Values of Properties between Objects and/or Groups

66

Adding image resources to your document

 

66

Messages Area

 

67

Adding External Resources

 

67

PlanetPress Design Preferences

 

68

Notification Messages Preferences

 

69

Image Resources Preferences

 

70

Color Preferences

 

71

Object Duplication Preferences

 

71

Miscellaneous Preferences

 

72

Editor Preferences

 

73

Display Preferences

 

74

Color Preferences

 

75

Ribbon Preferences

 

75

Object Inspector Preferences

 

75

Document Structure Area Preferences

 

76

©2010 Objectif Lune Inc

- 6 -

 

Table of Content

Rulers Preferences

 

76

Form Pages Preferences

 

77

Compiler Messages Preferences

 

77

Document and Pages Preferences

 

77

Image Resources Preferences

 

78

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

 

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

©2010 Objectif Lune Inc

- 7 -

 

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

©2010 Objectif Lune Inc

- 8 -

 

Objectif Lune PlanetPress Design - 7.3 User Guide

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

168

Capture Field Masks

169

Custom Masks

169

Regular Expressions

170

Document Resources

173

Image Resources

175

Location of image resources

175

Static and Dynamic Images

175

©2010 Objectif Lune Inc

- 9 -

Table of Content

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

Expand or Collapse Command Groups

 

207

©2010 Objectif Lune Inc

- 10 -

 

Table of Content

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

Language Reference (Alphabetical)

 

243

©2010 Objectif Lune Inc

- 11 -

 

Table of Content

% (procedure)

 

243

Current (system object)

 

243

&currentiteration (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

ClipPath (procedure)

 

264

©2010 Objectif Lune Inc

- 12 -

 

Table of Content

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

IntToFloat (function)

295

©2010 Objectif Lune Inc

- 13 -

Table of Content

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

SetAngle (procedure)

326

©2010 Objectif Lune Inc

- 14 -

Table of Content

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

ShowBarcodeRoyalMail (procedure)

352

©2010 Objectif Lune Inc

- 15 -

Table of Content

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

Assignment Operator

 

381

©2010 Objectif Lune Inc

- 16 -

 

Table of Content

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

For… EndFor (procedure)

399

©2010 Objectif Lune Inc

- 17 -

Table of Content

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

Put (procedure)

 

434

©2010 Objectif Lune Inc

- 18 -

 

Table of Content

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

ShowBarcodeI2of5 (procedure)

461

©2010 Objectif Lune Inc

- 19 -

Table of Content

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

GetCyan (function)

 

490

©2010 Objectif Lune Inc

- 20 -

 

Table of Content

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

IntToCur (function)

515

©2010 Objectif Lune Inc

- 21 -

Table of Content

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

Sub (function)

539

©2010 Objectif Lune Inc

- 22 -

Table of Content

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

Global Functions

563

©2010 Objectif Lune Inc

- 23 -

Table of Content

@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

ShowBarcodeCodablockF (procedure)

 

594

©2010 Objectif Lune Inc

- 24 -

 

Table of Content

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

SetEmailSubject (procedure)

 

619

©2010 Objectif Lune Inc

- 25 -

 

Table of Content

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

Form Cache

 

654

©2010 Objectif Lune Inc

- 26 -

 

Table of Content

Remove Background Color

 

654

Named Colors

 

655

Create a Graybar Report

 

656

The Hex Viewer

 

658

Date and Time Format

 

660

Document Output and Preview

 

663

About Previewing and Printing

 

663

Preview a Document On Screen

 

663

Previews of Documents that Use ASCII Emulation

 

666

Preview a Capture-Ready document

 

667

Print a Document Preview

 

667

Print Using a Windows Driver

 

668

Printing Using a Windows Driver

 

670

Generate a Soft Proof

 

670

Convert a Document and Save It to a File

 

672

Install a Document

 

673

Install a document on one or more printers

 

673

Send the document to one or more local PlanetPress Workflow servers

674

Save a PTK or PTZ file to send to a remote PlanetPress Workflow installation

675

Send a document to PlanetPress iWatch or a UNIX or Linux CodeHost BrightQ print spooler system:

675

Perform a Batch Conversion and/or Installation

 

676

To use the Batch Send To wizard

 

676

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

Work with Documents

 

686

©2010 Objectif Lune Inc

- 27 -

 

Table of Content

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

©2010 Objectif Lune Inc

- 28 -

Fonts and Styles

Fonts and Styles

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

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

Create a Style

To create a style:

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

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

Choose Home | Style.

The Style properties dialog box appears.

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

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

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

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

Font Definition

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

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

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

©2010 Objectif Lune Inc

- 29 -

Fonts and Styles

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

Default attributes

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

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

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

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

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

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

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

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

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

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

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

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

©2010 Objectif Lune Inc

- 30 -

Loading...
+ 670 hidden pages