Xerox Elixir Vitesse User Guide

Download

Vitesse®

User Guide

Elixir Technologies Corporation 721 East Main Street Ventura, CA 9300

VT200

All product names and trade names used herein are trademarks of their respective owners.

To report any errors you might find, please send a note to errata@elixir.com. Please note: e-mails are used to correct future versions of this guide and may not receive an individual reply. For technical support, please contact Customer Support.

801V200

Welcome

This document provides background an d procedural information for using Vitesse. Because business requirements and user preferences can vary for each company, the material contained herein should be viewed as a general guide only.

As you step through the material, please remember that your specific business needs will govern selection from the various options and preferences described. Similarly, certain selections will require that some tasks be repeated, while other selections will allow you to omit tasks entirely.

Who Should Use this Guide?

Users should already be familiar with Microsoft Wind ow s operations, printer and font management operations, and PC peripherals, and have access to reference manuals for related PC software and hardware.

About This Guide

Vitesse user guide is organized as follows: Chapter 1: Introduction, provides an overview of the Vitesse project modes,

functions and features that facilitate creating projects and resources for VIPP printing. It also provides information on the new features introduced in Vitesse

Section I: Vitesse Basics

Chapter 2: Understanding the Vitesse Workspace, provides an overview of the Vitesse workspace and describes activities and tasks for using the workspace.

2.00.

Chapter 3: Understanding the Vitesse Directory Structure, directory structure, the scope of resources used in Vitesse, and associated tasks for setting up working folders.

explains the Vitesse

Section II: Using VIPP Resources

Chapter 4: Working with Forms, provides information on the form resource and

explains tasks for using forms, setting form properties, and caching resources. Chapter 5: Working with Segments, provides information on using the segment

resource and provides tasks for creating a segment, setting segment properties, caching a segment, and dynamically resizing segments.

Chapter 6: Working with Fonts, provides information on the different font styles available in Vitesse. It gives a detailed overview on the font types, mappings, and their significance in VIPP printing.

Chapter 7: Working with Images, describes how to add images to a project and set image properties.

Section III: Vitesse Project Tools

Chapter 8: Using the Drawing Tools, provides information on drawing tools.

Included are instructions for adding drawing objects in the form and setting associated properties. It also describes the basic operations for editing/modifying objects inserted in a design.

Chapter 9: Using the Text Tools, provides activities and tasks for using text and graphic text objects and setting associated properties. It also gives a detailed overview on using rich text from external pr oject s, spell checker and dictionary files, finding and replacing text, and for setting the default text properties.

Chapter 10: Applying Transformations, describes how to apply different formatting options on field, text, and graphic text objects.

Chapter 11: Working with Colors, describes activities and tasks for working with colors, color palettes, and patterns.

Section IV: Creating a VIPP Project

Chapter 12: Creating a Native Mode Project, describes activities and tasks for

creating VIPP native mode projects. Chapter 13: Creating a Database Mode Project, describes activities and tasks for

creating VIPP database mode projects. Chapter 14: Creating a Line Mode Project, activities and tasks for creating VIPP

line mode projects. Chapter 15: Creating an XML Mode Project, activities and tasks for creating VIPP

XML mode projects.

Section V: Basic Project Setup

Chapter 16:, Setting Document Properties, describes activities and tasks for

setting properties associated with a Vitesse project. Chapter 17: Defining Paper and Print Setup, describes activities and tasks for

defining paper and print setup. Chapter 18: Defining the Logical Page Setup, describes activities and tasks for

adding a logical page to a design and setting logical page properties.

Section VI: Working in Database Mode

Chapter 19: Understanding Database Mode Data, provides an overview of the

database mode data stream and explains the database data structure in detail. It also gives a detailed overview on printing doc uments using the ZSORT feature.

Chapter 20: Working with Data in Database Mode, describes activities and tasks for working with data in database mode projects.

II Vitesse User Guide

Section VII: Working in Line Mode

Chapter 21: Understanding Line Mode Data, provides an overview of the line

mode data stream and explains the data stream attributes in detail. It also describes activities and tasks for working with data files and the Data View window in Vitesse.

Chapter 22: Working with Data in Line Mode, describes activities and tasks for working with data in line mode projects.

Section VIII: Working in XML Mode

Chapter 23: Understanding XML Mode Data, provides an overview of the XML

mode data stream and explains the XML data structure in detail. Chapter 24: Working with Data in XML Mode, describes activities and tasks for

working with data in XML mode projects.

Section IX: Using Data Driven Objects in a Project

Chapter 25: Using Frames, describes activities and tasks for working with frames in

Vitesse. Chapter 26: Using Variables, describes activities and tasks for working with

variables in Vitesse. Chapter 27: Adding Conditions, explains condition objects and conditional logic

that you can apply to design and data objects inserted in a project. Chapter 28: Adding Charts, describes activities and tasks for adding charts and

setting chart properties. It also provides information on mapping data to charts using different techniques for various types of data files and project modes.

Chapter 29: Using Actions, describes activities and tasks for working with action objects in Vitesse.

Chapter 30: Adding Barcodes, describes activities and tasks for adding a barcode to a design and setting barcode properties. It also gives a detailed overview on specifying the barcode data using barcode, field, text, and graphic text objects.

Section X: Referencing Resources

Chapter 31: Using Forms in Projects, describes activities and tasks for inserting and referencing forms in Vitesse.

Chapter 32: Using Segments in Projects, describes activities and tasks for inserting and referencing different segment types in Vitesse.

Chapter 33: Referencing Images, describes how to reference image resources in a project design and set image properties of the image references.

Welcome III

Section XI: Preparing the VIPP Project for Production

Chapter 34: Previewing and Testing the Project, describes activities and tasks for

previewing and testing projects in Vitesse. The chapter also provides information about performing standard operations in Vitesse, including opening and saving resources.

Chapter 35: Importing and Exporting Projects, provides information regarding the import and export operations of the Vitesse design projects and describes activities and tasks related to them.

Chapter 36: Vitesse Administrative Options, describes activities and tasks for opening Vitesse in administration and user mode. It also provides information about operating Vitesse in the administration mode.

Appendix A: Error and Warning Message Handling, lists and explains error and warning messages that can be encountered while performing specified Vitesse operations, along with explanations for each occurrence. Also included are messages and handling routines for VIPP source code errors.

Glossary, lists the basic Vitesse terms used in this guide.

Conventions

Conventions are the same or similar to Windows conventions, including:

! Display conventions ! Typographic conventions

Display Conventions

Elixir products adhere to Microsoft Windows conventions for using menus, menu commands, dialog boxes, command buttons, icons and mouse. See your Windows manual for more information.

IV Vitesse User Guide

Typographic Conventions

This guide uses the following typographic conventions to identify sp ecial information.

Convention Information Type/Example

< > (angle brackets), Keystrokes

Ex: <Enter> Key combinations are denoted by a plus sign between keys. Ex: <Shift> + <F1>.

Bold type - Field names within an explanation.

Ex: Use rules set by selected Start on option.

- Dialog areas referenced in tasks. Ex: Select an item from the List of used Fonts.

Click the Options tab.

- Tool names referenced in dialogs/windows. Ex: Make sure the Text tool is selected.

- Button names with text written on them. Ex: Click OK to save settings.

- Any text that you must type.

Ex: Enter LPT1 for the following option.

Italic type - References to other guides.

Ex: Elixir Scout Guide.

- References to other chapters. Ex: Chapter 10: eDelivery.

- Toolbar names. Ex: Click any tool on the Drawing toolbar.

- Window names. Ex: Message window displays.

- Directory paths. Ex: drive:\Programs Files\Elixir Technologies.

Quotation marks - References to tasks, activities or concepts.

Ex: See “Adding Drawing Objects” section in Chapter 5: Working with Drawing Tools.

Welcome V

Symbols Used in This Guide

Look for the following symbols as you read through this guide:

Symbol Information Type

Note

This symbol calls your attention to additional information.

Shortcut

This symbol shows a shortcut for a procedure you just learned.

Tip This symbol highlights a helpful tip.

Warning

This symbol emphasizes an important note and/or warning.

Migrating Users

This symbol emphasizes a note for users migrating from previous versions of Vitesse.

VI Vitesse User Guide

Getting the Answers You Need

Elixir Technologies provides the following resources to help you learn and use Vitesse:

! Customer Support ! Elixir Training ! Help ! Related Guides

Customer Support

If you purchased this product directly from Elixir Technologies, you can contact the Customer Support Center for your region at the number listed below:

North and South America:

! +1 805 641 5900 ext. 3

Monday – Friday, 7:00 am to 4:00 pm Pacific Standard Time; if closed, press 2 to reach Elixir’s extended Support coverage.

! Elx_support@elixir.com Asia Pacific:

Asia_support@elixir.com

Europe:

! +44 (0) 207 993 4811

Monday – Friday, 6:00 am to 4:00 pm Central European Time

! +1 805 5900 ext. 3

Monday – Friday, 4:00 pm to 2:00 am Central European Time

Europe_support@elixir.com

If you have a problem with your Elixir product, contact the Elixir Customer Support Center for your region. An Elixir Product Specialist will answer your call and ask for the following information:

! Your name, organization, telephone number and address. ! Elixir product name and version number. ! A complete description of the problem, including any error messages printed or

displayed on your monitor.

Welcome VII

Elixir Website Support

You can also obtain product support by accessing the Elixir web page at

http://www.elixir.com and selecting Support.

The Elixir website allows you to:

! Select your preferred support method. ! Identify support centers. ! Access web support. ! Register Elixir products. ! Renew Elixir licenses. ! Learn through the User Group how others are using Eli xir products. ! Download the latest patches. ! Contact Elixir Partner Support. ! Ask a question of Elixir Support. To submit a question, select Questions>

Submit a Question here. Please complete the question form.

! Find answers in the list of Frequently Asked Questions. ! Access the Elixir Knowledge Base.

Elixir Training

Elixir Technologies offers training for its full-range of Windows-based products. For more information, contact:

Elixir Learning (805) 641-5900 ext.4

Using Help

Elixir software uses the Microsoft Windows Help program to provide help for all product functions.

What’s This? Help

Selecting a dialog control such as an input field, radio button or drop-down list, and then pressing Shift + F1 displays a pop-up window containing information about that control. You can also get this information by right-clicking the control and selectin g

What’s This? from the pop-up window or clicking available.

Help Pop-ups and Jumps

The help can be opened using Help>Contents from the application menu bar. Within the Help topic text, words or phrases in blue are drop-down hotspots and underlined words or phrases in blue are jumps or hyperlinks. Clicking a hotspot displays images and links directly below the hotspot within the same topic. Clicking a jump displays an associated Help topic within the same window.

VIII Vitesse User Guide

on the dialog title bar if

Related Guides

If you require further information about a specific topic or wish to obtain product background information, reference the Vitesse Getting Started Guide which is part of the Vitesse documentation package.

Welcome IX

User Notes:

X Vitesse User Guide

Contents

Welcome ----------------------------------------------------------------------I

About This Guide ------------------------------------------------------------I Conventions---------------------------------------------------------------- IV

Getting the Answers You Need ---------------------------------------- VII

Chapter 1: Introduction 37

Section I: Vitesse Basics

Who Should Use this Guide?-----------------------------------------I

Display Conventions------------------------------------------------ IV Typographic Conventions------------------------------------------- V Symbols Used in This Guide -------------------------------------- VI

Customer Support -------------------------------------------------- VII

Elixir Website Support ---------------------------------------- VIII Elixir Training ----------------------------------------------------- VIII Using Help --------------------------------------------------------- VIII Related Guides------------------------------------------------------- IX

Vitesse Overview-----------------------------------------------------37 Before You Start------------------------------------------------------39

Creating a Preliminary Project-----------------------------------39

Defining and Locating Test Data--------------------------------39 Understanding the VIPP Modes------------------------------------40

What is Native Mode?--------------------------------------------40

What is Line Mode?-----------------------------------------------40

What is Database Mode?-----------------------------------------41

What is XML Mode? ---------------------------------------------42 What’s New in Vitesse 2.00?---------------------------------------43

Form and Segment Behavior-------------------------------------43

Frame Behavior----------------------------------------------------43

Restricted Mode Operation --------------------------------------43

Predefined Media and Fields-------------------------------------44

Batch Conversion of Documents--------------------------------44

Chapter 2: Understanding the Vitesse Workspace

Getting Familiar with the Workspace -----------------------------------47

Using the Design Area-----------------------------------------------48

Design View -------------------------------------------------------48

Source View--------------------------------------------------------49 Using the Project Tree View Window----------------------------- 49

Media--------------------------------------------------------------- 50 MasterDoc --------------------------------------------------------- 51

Resources ---------------------------------------------------------- 51 Using the Property View Window -------------------------------- 51 Using the Data View Window------------------------------------- 52 Using the Message View Window -------------------------------- 53

Clearing Messages------------------------------------------------ 54

Saving Messages-------------------------------------------------- 54

Setting the Default View Options ------------------------------ 54 Arranging the Workspace Windows ------------------------------ 55 Using Workspace Tools -------------------------------------------- 56

Using the Menu Bar---------------------------------------------- 56

Using the Toolbar------------------------------------------------- 57

Viewing the Status Bar ------------------------------------------ 57 Placing Objects in the Design Area ------------------------------- 58

Using the Ruler --------------------------------------------------- 58

Displaying and Hiding the Ruler ------------------------------- 58

Setting the Default Ruler Option ------------------------------- 58

Changing the Unit of Measurement---------------------------- 58

Using the Grid----------------------------------------------------- 59

Displaying and Hiding the Grid -------------------------------- 60

Setting the Default Grid Option -------------------------------- 60

Automatically Aligning Objects to the Grid ------------------ 60

Setting the Default Snap to Grids Option --------------------- 61

Setting the Grid Color-------------------------------------------- 62

Setting the Grid Style -------------------------------------------- 63

Setting the Grid Spacing----------------------------------------- 63

Using Guides------------------------------------------------------ 64

Turning the Guides On and Off--------------------------------- 64

Setting the Default Guide Option------------------------------- 65

Moving Guides to the Design Area ---------------------------- 65

Removing Guides from the Design Area---------------------- 66

Automatically Aligning Objects to the Guides --------------- 66

Setting the Default Snap to Guides Option-------------------- 66

Setting the Guide Color------------------------------------------ 66

Setting the Guide Style------------------------------------------- 67

Using the Crosshair----------------------------------------------- 68

Displaying and Hiding the Crosshair -------------------------- 68

Setting the Default Crosshair Option -------------------------- 68 Moving Objects using the Keyboard------------------------------ 69

Setting the Nudge Options -------------------------------------- 69

XII Vitesse User Guide

Zooming within the Design Area ----------------------------------70

Specifying Custom Zoom Value --------------------------------71 Moving the Design Area View -------------------------------------71 Using the Full Screen View-----------------------------------------72 Refreshing the Project -----------------------------------------------72 Navigating the Workspace ------------------------------------------72 Choosing Commands ------------------------------------------------73

Chapter 3: Understanding the Vitesse Directory Structure 75

Understanding Resource Scope ------------------------------------75

Local Resources ---------------------------------------------------75

Shared Resources--------------------------------------------------75

Global Resources--------------------------------------------------75 Understanding the Vitesse Directory Structure ------------------76

Vitesse Folder------------------------------------------------------77

ClientsFolder-------------------------------------------------------77

Client Folder -------------------------------------------------------77

Project Folder------------------------------------------------------77

Data Files-----------------------------------------------------------78

Config---------------------------------------------------------------78

xgf -------------------------------------------------------------------78

FormLib ------------------------------------------------------------78

ImgLib --------------------------------------------------------------78

SegLib --------------------------------------------------------------78

MisLib --------------------------------------------------------------78

Setting up the Working Folder ----------------------------------79 Using Scope Specific View in the Project Tree------------------79

Opening Vitesse Projects in Scope Specific View------------81 Setting Default Folder Preferences --------------------------------81

Adding a Directory------------------------------------------------ 82

Deleting a Directory ----------------------------------------------83

Rearranging the Directory List ----------------------------------83

Section II: Using VIPP Resources Chapter 4: Working with Forms 87

Using a Form----------------------------------------------------------87

Creating a New Form---------------------------------------------87 Setting Form Properties ---------------------------------------------89

Setting the Form Size---------------------------------------------89

Setting the Form Orientation-------------------------------------90

Specifying Form Details------------------------------------------91

Contents XIII

Caching Resources -------------------------------------------------- 93

Caching a Form --------------------------------------------------- 93

Chapter 5: Working with Segments 95

Using a Segment----------------------------------------------------- 95

Creating a New Segment ---------------------------------------- 96

Setting Segment Properties----------------------------------------- 97

Setting the Segment Size ---------------------------------------- 97 Setting the Segment Origin-------------------------------------- 98 Clipping and Caching a Segment------------------------------- 99

Specifying Segment Details------------------------------------100 Dynamic Behavior of Segments----------------------------------101 Working with Postscript Segments-------------------------------101

Viewing Postscript Segment as a Faded Template----------102

Setting Transparency of White Areas in a PostScript

Segment-----------------------------------------------------------

104

Chapter 6: Working with Fonts 105

Font Types Supported in Vitesse---------------------------------105 Managing Font Styles in Vitesse ---------------------------------106

Creating a New Font Style -------------------------------------106

Editing a Font Style ---------------------------------------------109 Using Legacy Fonts ------------------------------------------------109

Mapping a Legacy Font to a VIPP Font----------------------110

Viewing Mapped Fonts in Vitesse ----------------------------111 Mapping VIPP Fonts to True Type or PostScript Fonts in Vitesse---------------------------------------------------------------Setting a Default Font----------------------------------------------114 Setting Font List Viewing Options-------------------------------115

112

Chapter 7: Working with Images 117

Adding an Image----------------------------------------------------117 Setting Image Properties-------------------------------------------118

Replacing an Image ---------------------------------------------118

Previewing the Image as a Faded Template------------------119

Setting Transparency of White Areas in an Image----------120

Caching an Image------------------------------------------------121

Previewing Images in Low Resolution -----------------------121

XIV Vitesse User Guide

Section III: Vitesse Project Tools Chapter 8: Using the Drawing Tools 125

Drawing Objects---------------------------------------------------------- 125

Using the Line Tool------------------------------------------------ 127

Drawing a Line -------------------------------------------------- 127 Positioning a Line ----------------------------------------------- 127 Repositioning a Line--------------------------------------------129

Using the Box Tool ------------------------------------------------ 131

Drawing a Box--------------------------------------------------- 131 Positioning a Box------------------------------------------------ 131 Creating a Rounded Box --------------------------------------- 132 Setting Corner Radius ------------------------------------------ 132 Splitting a Box---------------------------------------------------133 Repeating a Box ------------------------------------------------- 134

Using the Path Tool------------------------------------------------136

Drawing a Path -------------------------------------------------- 136 Positioning a Path ----------------------------------------------- 136 Setting Path Nodes ---------------------------------------------- 137 Adding a Path Node--------------------------------------------- 138 Deleting a Path Node ------------------------------------------- 139 Positioning a Path Node----------------------------------------139

Using the Polygon Tool ------------------------------------------- 141

Drawing a Polygon---------------------------------------------- 141 Positioning a Polygon------------------------------------------- 141 Selecting a Polygon Shape------------------------------------- 142

Using the Static Table Tool--------------------------------------- 144

Drawing a Static Table ----------------------------------------- 144 Positioning a Static Table -------------------------------------- 144 Setting the Number of Rows and Columns------------------ 145 Setting the Table Cell Spacing -------------------------------- 146

Setting Common Object Properties------------------------------148

Setting the Object Size------------------------------------------ 148 Setting the Box Size--------------------------------------------- 148 Setting the Path Size -------------------------------------------- 149 Setting the Polygon Size---------------------------------------- 149 Setting the Static Table Size ----------------------------------- 150 Setting Object Line Width ------------------------------------- 150 Setting the Line Width------------------------------------------ 151 Setting the Box Line Width------------------------------------152 Setting the Path Line Width------------------------------------ 153

Contents XV

Setting the Polygon Line Width -------------------------------154

Setting the Static Table Line Width---------------------------155

Setting the Object Line Style-----------------------------------156

Setting the Line Style -------------------------------------------157

Setting the Box Line Style--------------------------------------158

Setting the Path Line Style -------------------------------------159

Setting the Polygon Line Style---------------------------------160

Setting the Static Table Line Style ----------------------------161

Assigning Properties to Multiple Selected Objects ---------161 GEP Keys------------------------------------------------------------162

Basic Operations ----------------------------------------------------------162

Selecting an Object-------------------------------------------------162

Select Design Area Objects ------------------------------------163

Select Project Tree Nodes --------------------------------------163 Copying an Object--------------------------------------------------164 Cutting an Object---------------------------------------------------164 Pasting an Object ---------------------------------------------------164 Deleting an Object--------------------------------------------------165 Resizing an Object--------------------------------------------------165 Moving an Object---------------------------------------------------165 Renaming an Object------------------------------------------------166 Sequencing Project Tree Nodes ----------------------------------166 Aligning Objects----------------------------------------------------166

Align Left---------------------------------------------------------167

Align Right -------------------------------------------------------167

Align Bottom-----------------------------------------------------167

Align Top---------------------------------------------------------167

Center Horizontally----------------------------------------------167

Center Vertically-------------------------------------------------167

Evenly Space Horizontally -------------------------------------168

Evenly Space Vertically ----------------------------------------168

Make Same Width-----------------------------------------------168

Make Same Height ----------------------------------------------169 Arranging Objects --------------------------------------------------169

Bring to Front ----------------------------------------------------170

Send to Back -----------------------------------------------------170

Bring Forward----------------------------------------------------170

Send Backward---------------------------------------------------170 Undoing and Repeating Actions----------------------------------172

XVI Vitesse User Guide

Chapter 9: Using the Text Tools 173

Using Text Tools--------------------------------------------------- 173

Inserting a Text Object ----------------------------------------- 173 Inserting Text by Clicking and Typing----------------------- 174 Creating a Text Box--------------------------------------------- 174 Inserting a Graphic Text Object-------------------------------174 Editing Text------------------------------------------------------ 175 Positioning Text ------------------------------------------------- 175 Setting the Text Size-------------------------------------------- 177

Using the Merge Data Feature------------------------------------ 178

Creating an XML file with Pre-defined Variables----------178 Loading an XML file with Pre-defined Variables ----------180

Merging Data with Static Text -------------------------------- 181 Autosizing Text Objects------------------------------------------- 183 Formatting Text Objects------------------------------------------- 183

Setting Text Background Attributes -------------------------- 183

Setting Line Spacing--------------------------------------------184

Setting Paragraph Spacing ------------------------------------- 185

Aligning the Text------------------------------------------------ 185

Indenting Text --------------------------------------------------- 186

Setting Text Tabs------------------------------------------------ 187

Setting Tab Stops------------------------------------------------ 187

Adding Tab Stops to a List------------------------------------- 188

Deleting Tab Stops from a List-------------------------------- 188

Modifying a Tab Stop in a List--------------------------------188

Selecting the Tab type ------------------------------------------ 188

Setting the Default Tab Value and Alignment for the Text189 Formatting Graphic Text Objects -------------------------------- 189

Setting Graphic Text Rotation--------------------------------- 190 Using Rich Text from External Projects ------------------------ 191

Importing Rich Text Format Text----------------------------- 191

Exporting Text to a Rich Text Format Text File------------ 192 Joining Text Objects ----------------------------------------------- 193 Using the Spell Checker------------------------------------------- 193 Specifying Dictionary Files for Spell Checking --------------- 194

Adding a Dictionary File--------------------------------------- 194

Deleting a Dictionary File-------------------------------------- 195

Rearranging the Dictionary Files List ------------------------ 195 Setting Default Text Attributes----------------------------------- 195

Setting the Default Text Justification------------------------- 195

Contents XVII

Setting the Default Paragraph Spacing -----------------------196 Setting the Default Tab Value and Alignment ---------------196 Setting the Default Text Indentation--------------------------197 Setting the Spell Checker Depth-------------------------------197 Setting the Data Switch-----------------------------------------197 Finding Text------------------------------------------------------198 Replacing Text---------------------------------------------------199

Chapter 10: Applying Transformations 201

Transforming Strings-----------------------------------------------201

Formatting a Number String -----------------------------------201 Adding a New Format Mask -----------------------------------202 Extracting a Fixed Length Sub-String from Text -----------203 Extracting a Variable Length Sub-String from Text--------204 Stripping Characters and Blanks ------------------------------205 Formatting a Time String---------------------------------------206 Changing String Case -------------------------------------------207 Concatenating Strings-------------------------------------------208 Formatting Strings as Barcodes--------------------------------209

Chapter 11: Working with Colors 211

Using Colors --------------------------------------------------------211

Selecting a Foreground Color----------------------------------213 Selecting a Background Color ---------------------------------214

Working with Color Palettes--------------------------------------215

Loading a Palette ------------------------------------------------215 Adding a New Color to the Color Palette --------------------215 Adding a Color Using the Color Spectrum-------------------215 Adding a Color Using the Color Model ----------------------217 Editing a Color---------------------------------------------------219 Deleting a Color -------------------------------------------------220 Saving a Palette --------------------------------------------------221

Using Patterns-------------------------------------------------------221

Applying Line Patterns -----------------------------------------222 Applying Fill Patterns-------------------------------------------223

Setting Default Color and Pattern Attributes -------------------224

Setting Default Foreground Color-----------------------------224 Setting Default Background Color ----------------------------224 Setting Default Line Patterns ----------------------------------224 Setting Default Fill Patterns------------------------------------225

XVIII Vitesse User Guide

Section IV: Creating a VIPP Project Chapter 12: Creating a Native Mode Project 229

Using the Native Mode--------------------------------------------229

Creating a New Native Mode Project------------------------- 229

Selecting the Paper Size---------------------------------------- 230

Selecting the Paper Orientation-------------------------------- 231

Chapter 13: Creating a Database Mode Project 233

Using the Database Mode-----------------------------------------233

Creating a New Database Mode Project --------------------- 233

Selecting the Paper Size---------------------------------------- 234

Selecting the Paper Orientation-------------------------------- 235

What is a Sample Data File?----------------------------------- 236

Selecting a Sample Data File ---------------------------------- 237

Specifying a Data File Delimiter------------------------------238

Chapter 14: Creating a Line Mode Project 239

Using the Line Mode ----------------------------------------------239

Creating a New Line Mode Project--------------------------- 239

Setting up a Data Grid ------------------------------------------ 240

Selecting the Paper Size---------------------------------------- 242

Selecting the Paper Orientation-------------------------------- 243

Setting the Page Margins--------------------------------------- 244 What is a Sample Data File?-------------------------------------- 245

Selecting a Sample Data File ---------------------------------- 245 Defining the Data--------------------------------------------------- 246

Specifying the Record Prefixes-------------------------------- 247

Specifying the Field Type-------------------------------------- 248

Specifying Fixed Length Data--------------------------------- 248

Specifying Delimited Data-------------------------------------248

Specifying a Delimiter------------------------------------------ 249 Working with Page Delimiters ----------------------------------- 250

Specifying Page Delimiters ------------------------------------ 251

Matching the Page Delimiter ---------------------------------- 252

Printing the Page Delimiter Line------------------------------253

Looping the Page Delimiter Line ----------------------------- 254

Setting Document Flow Options ------------------------------ 256

Specifying Printer Control Characters in Data -------------- 257 Using the XML Mode --------------------------------------------- 259

Creating a New XML Mode Project-------------------------- 259

Selecting the Paper Size---------------------------------------- 260

Contents XIX

Selecting the Paper Orientation--------------------------------261

Section V: Basic Project Setup Chapter 16: Setting Document Properties 265

Specifying Project Details-----------------------------------------265

Setting the Project Information --------------------------------265 Maintaining Change History--------------------------------------266 Setting Regional Preferences--------------------------------------266

Applying Regional Preferences to Numeric Formats-------266

Specifying Default Regional Preferences --------------------269 Working with Regional Languages ------------------------------271

Setting Character Set Encoding Options ---------------------271 Printing Multiple Copies of a Document------------------------271

Setting the Document Printing Options-----------------------272

Chapter 17: Defining Paper and Print Setup 275

Defining the Media Properties------------------------------------275

Adding a Paper---------------------------------------------------275

Adding a Predefined Paper-------------------------------------276 Setting Paper Properties -------------------------------------------278

Changing the Paper Size----------------------------------------278

Changing the Paper Orientation -------------------------------279 Using Printing Options---------------------------------------------280

Setting Printing Options ----------------------------------------280

Selecting the Paper Type ---------------------------------------281

Setting the Paper Weight ---------------------------------------281

Setting the Paper Color -----------------------------------------282

Using Document Structuring Conventions-------------------282

Printing a Constant Form on the Back of the Paper---------282

Printing Several Pages on One Paper (N-UP) ---------------282 Setting Default Paper Properties----------------------------------286

Setting the Default Paper Size ---------------------------------286

Setting Default Paper Orientation -----------------------------286

Setting Default Media Settings --------------------------------287

Chapter 18: Defining the Logical Page Setup

289

About the Logical Page-------------------------------------------- 289

Adding a Page----------------------------------------------------290 Setting the Page Properties----------------------------------------290

Setting the Page Name------------------------------------------290

Selecting a Paper-------------------------------------------------291

XX Vitesse User Guide

Selecting the Paper Side for Printing ------------------------- 291 Selecting the Page Orientation--------------------------------- 292 Setting the Page Margins--------------------------------------- 293 Adding a Page Border ------------------------------------------ 294 Creating a Zebra Effect----------------------------------------- 295 Setting up a Data Grid ------------------------------------------ 296 Adding the Page Numbers ------------------------------------- 297 Formatting the Page Numbers--------------------------------- 297 Setting the Page Number Color ------------------------------- 298 Setting the Page Number Font--------------------------------- 298 Specifying the Starting Page Number ------------------------ 299 Positioning the Page Numbers --------------------------------- 299 Setting the Default Page Properties---------------------------300 Setting the Default Margins------------------------------------ 300 Setting the Default Data Grid---------------------------------- 300

Section VI: Working in Database Mode Chapter 19: Understanding Database Mode Data 303

Understanding Database Mode Data ---------------------------- 303

Inserting a Data File--------------------------------------------- 304 Specifying a Delimiter------------------------------------------ 305

Using the Data View Window for Database Mode Projects-- 305

Auto-sizing Data Columns-------------------------------------306 Understanding the Database Data File Structure------------ 307

Creating ZSort ------------------------------------------------------ 308

Printing Documents Using ZSort------------------------------ 309 Example 1: Using ZSORT for Simplex Printing------------ 310 Example 2: Using ZSORT with Insert blank pages option 311 Example 3: Using ZSORT with Shorten last stack option- 312 Example 4: Using ZSORT with Record Processing set to Twice-------------------------------------------------------------Example 5: Using ZSORT for Duplex Printing------------- 314

Trimming Fields---------------------------------------------------- 315

313

Chapter 20: Working with Data in Database Mode 317

Mapping Data------------------------------------------------------------- 317 Understanding Database Processing Order--------------------------- 318

Mapping Fields ----------------------------------------------------- 319

Inserting a Field ------------------------------------------------- 320 Using Normal Fields----------------------------------------------- 320 Specifying the Normal Field Data ------------------------------- 321

Contents XXI

Using the Data File----------------------------------------------321 Using Variables--------------------------------------------------322 Using Constant Data --------------------------------------------324 Aligning the Normal Field Contents--------------------------324 Defining the Cell Margins--------------------------------------325

Setting Field Justification---------------------------------------325 Using Image Fields-------------------------------------------------327 Specifying an Image Resource------------------------------------327

Using the Data File----------------------------------------------327

Using Variables--------------------------------------------------329

Using an Existing Project Resource as Field Data ----------329

Aligning the Image Field ---------------------------------------330 Using Segment Fields----------------------------------------------332 Specifying a Segment Resource ----------------------------------332

Using the Data File----------------------------------------------332

Using Variables--------------------------------------------------333

Using an Existing Project Resource as Field Data ----------334

Using the Dynamic Sizing Behavior in a Segment Field---334 Using Static Text Fields -------------------------------------------336

Formatting Static Text Field Data-----------------------------336

Specifying Static Text Field Data -----------------------------337 Setting Common Field Properties --------------------------------337

Positioning a Field-----------------------------------------------337

Setting Field Absolute Position--------------------------------338

Setting Field Relative Position---------------------------------339

Setting the Field Size--------------------------------------------341

Adjusting the Field Size to its Contents ----------------------343

Setting Field Rotation-------------------------------------------344

Scaling Image and Segment Fields----------------------------345

Section VII: Working in Line Mode Chapter 21: Understanding Line Mode Data 349

Understanding Line Mode Data ----------------------------------349

Listing Mode -----------------------------------------------------350

Record Processing Entry (RPE) Mode------------------------350

Defining RPE Fields Vertically--------------------------------350

Defining RPE Fields Horizontally ----------------------------350

Specifying Fixed Field Data -----------------------------------351

Specifying a Delimiter for Delimited Data-------------------352

Working with Page Delimiters---------------------------------353

Specifying a Page Delimiter------------------------------------353

XXII Vitesse User Guide

Matching the Page Delimiter ---------------------------------- 354 Printing the Page Delimiter Line------------------------------355 Looping the Page Delimiter Line ----------------------------- 356 Setting Document Flow Options ------------------------------ 357

Working with Printer Control Characters----------------------- 358

Creating a Custom PCC Table--------------------------------- 359 Selecting a Predefined PCC Table ---------------------------- 364 Using Advanced Vertical Control Options ------------------ 364 Defining RCD Conditions-------------------------------------- 369

Setting up a VFU Key Table ----------------------------------- 375 Inserting a Data File ----------------------------------------------- 377 Using the Data View Window------------------------------------ 377

Editing the Data File-------------------------------------------- 379

Setting Data View Options------------------------------------- 380

Selecting Foreground and Background Color for Viewing

Data ---------------------------------------------------------------

380 Selecting a Font for Viewing Data---------------------------- 381 Auto-sizing Data Columns-------------------------------------383 Using Column View for Delimited Files--------------------- 383 Changing RPE Prefix ------------------------------------------- 384 Creating a Data Dictionary ------------------------------------- 385 Defining a Data Area ------------------------------------------- 386 Viewing a Data Area-------------------------------------------- 387

Working in Listing Mode ----------------------------------------- 387

Specifying a Listing Color ------------------------------------- 389

Chapter 22: Working with Data in Line Mode 391

Mapping Data------------------------------------------------------------- 391 Understanding Data Processing Order -------------------------------- 394

Mapping Records--------------------------------------------------- 394

Inserting a Record in Line Mode------------------------------ 395

Setting Record Properties in Line Mode ------------------------ 395

Specifying a Starting Line and the Number of Repeating Lines for Non-Prefixed Data-----------------------------------

396 Specifying an RPE Key for Prefixed Data-------------------398

Using Fixed or Variable Spacing--------------------------------- 398

Fixed Line Spacing Mode-------------------------------------- 399 Variable Line Spacing Mode ---------------------------------- 399

Mapping Fields ----------------------------------------------------- 400

Inserting a Field ------------------------------------------------- 400

Using Normal Fields----------------------------------------------- 401

Contents XXIII

Specifying the Normal Field Data--------------------------------401

Using the Data File----------------------------------------------401 Using Fixed Field Data -----------------------------------------402 Using the Field Number ----------------------------------------403 Using Variables--------------------------------------------------403 Using Constant Data --------------------------------------------405 Aligning the Normal Field Contents--------------------------405 Creating Dynamic Tables using Field Borders --------------407 Specifying Cell Margins----------------------------------------408 Specifying Cell Margin Line Width---------------------------409 Specifying Cell Margin Line Style----------------------------410 Specifying OutLine Color and Pattern for Cell Margins---412 Specifying Fill Color and Pattern for Cell Margins---------413

Setting Field Justification---------------------------------------414 Using Image Fields-------------------------------------------------416 Specifying an Image Resource------------------------------------416

Using the Data File----------------------------------------------416

Using Variables--------------------------------------------------417

Using an Existing Project Resource as Field Data ----------418

Aligning the Image Field ---------------------------------------418 Using Segment Fields----------------------------------------------421 Specifying a Segment Resource ----------------------------------421

Using the Data File----------------------------------------------421

Using Variables--------------------------------------------------422

Using an Existing Project Resource as Field Data ----------423 Using Static Text Fields -------------------------------------------423

Formatting Static Text Field Data-----------------------------424 Setting Common Field Properties --------------------------------425

Positioning a Field-----------------------------------------------425

Setting Field Absolute Position--------------------------------425

Setting Field Relative Position---------------------------------426

Setting the Field Size--------------------------------------------429

Adjusting the Field Size to its Contents ----------------------430

Setting Spacing between Fields--------------------------------431

Setting Field Rotation-------------------------------------------433

Scaling Image and Segment Fields----------------------------433

What is a Data Group?---------------------------------------------------434

Inserting a Data Group in Line Mode Projects --------------436

XXIV Vitesse User Guide

Section VIII: Working in XML Mode Chapter 23: Understanding XML Mode Data 441

Understanding XML Mode Data--------------------------------------- 441

Inserting a Data File ----------------------------------------------- 441

Using the Data View Window------------------------------------------ 442

Using the Data Window for XML Mode Projects ------------- 443

XML Data Tree-------------------------------------------------- 444 Viewing Multiple Tag Occurrences -------------------------- 445

XML Data File Structure------------------------------------------ 446

Tags --------------------------------------------------------------- 446 Attributes --------------------------------------------------------- 447 Values------------------------------------------------------------- 447

Chapter 24: Working with Data in XML Mode 449

Mapping XML Data to the Project Design --------------------------- 449 Understanding XML Data Processing Order-------------------------451

Associating a Data Tag to a Page -------------------------------- 451 Mapping Records--------------------------------------------------- 453

Inserting a Record in XML Mode----------------------------- 455 Mapping a Record to a Data Tag------------------------------ 456 Using the Record Property Sheet------------------------------ 456 Using Drag and Drop ------------------------------------------- 457 Printing a Record on a New Page ----------------------------- 459 Record Processing ----------------------------------------------- 461

Mapping Fields ----------------------------------------------------- 461

Inserting a Field in XML Mode ------------------------------- 461 Mapping a Field to a Data Tag Value ------------------------ 462 Field Processing ------------------------------------------------- 464

Using Normal Fields----------------------------------------------- 465

Specifying the Normal Field Data ---------------------------- 466 Using the Data File---------------------------------------------- 466 Using Variables-------------------------------------------------- 466 Using Constant Data -------------------------------------------- 467 Aligning the Normal Field Contents-------------------------- 467 Creating Dynamic Tables using Field Borders-------------- 468 Setting Field Justification -------------------------------------- 469

Using Image Fields------------------------------------------------- 471

Specifying an Image Resource -------------------------------- 471 Using the Data File---------------------------------------------- 472 Using Variables-------------------------------------------------- 473

Contents XXV

Using an Existing Project Resource as Field Data ----------473

Aligning an Image Field----------------------------------------474 Using Segment Fields----------------------------------------------476

Specifying a Segment Resource -------------------------------476

Using the Data File----------------------------------------------476

Using Variables--------------------------------------------------478

Using an Existing Project Resource as Field Data ----------478

Using the Dynamic Size Behavior in a Segment Field-----479 Using Static Text Fields -------------------------------------------481

Formatting Static Text Field Data-----------------------------481

Specifying Field Data -------------------------------------------482

Merging XML Data with Static Text -------------------------482 Setting Common Field Properties --------------------------------483

Positioning a Field-----------------------------------------------483

Setting Field Absolute Position--------------------------------484

Setting Field Relative Position---------------------------------485

Setting the Field Size--------------------------------------------488

Adjusting the Field Size to its Contents ----------------------489

Setting Spacing between Fields--------------------------------489

Setting Field Rotation-------------------------------------------490

Scaling Image and Segment Fields----------------------------491

Section IX: Using Data Driven Objects in a Project Chapter 25: Using Frames 495

Understanding Frames---------------------------------------------------495

Understanding Relative and Static Objects ---------------------496 Working with Frames in Vitesse ---------------------------------497 Understanding Segment Overflow Behavior -------------------498

Creating a Frame-------------------------------------------------498

Creating a Frame Using the Property Sheet------------------499 Using Borders to Preview Frames--------------------------------500

Specifying Frame Border Width-------------------------------500

Specifying Frame Border Style--------------------------------501

Changing Frame Placement and Size-------------------------502 Relatively Positioning Objects in Frames-----------------------505 Using Text or Field Objects in Frames --------------------------506 Using Conditions in Frames---------------------------------------508 Enabling Segment Overflow--------------------------------------508

Enabling Frame Overflow in Segments ----------------------509

Enabling Frame Overflow in Objects referencing the

XXVI Vitesse User Guide

Segment----------------------------------------------------------- 509 Enabling Frame Overflow in SegRef-------------------------510

Enabling Frame Overflow in Segment Fields --------------- 510 Using SegRef in Frames------------------------------------------- 510 Using Frame Numbers--------------------------------------------- 511 Working with Frames in XML Mode --------------------------- 512

Chapter 26: Using Variables 513

What is a Variable? ------------------------------------------------ 513 Understanding Variable Types ----------------------------------- 513 Creating a New Variable ------------------------------------------ 514

Creating a String Variable-------------------------------------- 514

Example: Using a string variable as a field value----------- 515

Creating a Number Variable----------------------------------- 516

Example: Using a number variable as a barcode value ---- 516

Creating an Array Variable ------------------------------------ 517

Example: Using an array variable for creating DDG Charts519

Creating a Boolean Variable----------------------------------- 520 Working with System Variables --------------------------------- 520

Example: Using system variable BACK to switch forms

for a sheet front and back---------------------------------------

524 Using Persistent Variables ----------------------------------------525 Using Variables for Referencing Forms------------------------- 526 Using Variables for Referencing Segments--------------------- 528 Using Variables for Referencing Images------------------------ 529 Using Variables in Forms and Segments------------------------ 530

Chapter 27: Adding Conditions 533

What are Conditions?---------------------------------------------------- 533

Defining a Condition Statement---------------------------------- 534

Operands---------------------------------------------------------- 534 Operators --------------------------------------------------------- 534 Comparison Operators------------------------------------------ 534 Logical Operators ----------------------------------------------- 535 Working with Page Level Conditions ------------------------ 536 Working with Record Level Conditions --------------------- 537

Adding Conditions to the Project Tree -------------------------- 537

Inserting a Condition-------------------------------------------- 537 Specifying a Condition Test ----------------------------------- 538 Specifying Detailed Condition Tests using Logical Operators ---------------------------------------------------------

Contents XXVII

539

Using the AND and OR Logical Operators ------------------539 Using the NOT Logical Operator------------------------------540 Using the ElseIf Condition -------------------------------------540 Deleting a Condition --------------------------------------------541

Using Data in Conditions------------------------------------------------542

Mapping Data to a Condition in Line Mode Project-----------542

Mapping Data at the Page Level Condition – Non-Prefixed Data----------------------------------------------------------------

542

Mapping Data at the Record Level Condition – Non-Prefixed Data----------------------------------------------------------------

544

Mapping Data to a Condition in Line Mode Project – Prefixed Data----------------------------------------------------------------

546 Mapping Data to a Condition in Database Mode------------548 Mapping Data to a Condition in XML Mode----------------550

Using Variables in a Condition-----------------------------------552 Using System Variables in a Condition -------------------------554 Using Constants in a Condition-----------------------------------556 Dynamically Managing Form and Segment Content using Conditions -----------------------------------------------------------

557 Forms and Segments Used as Resources in Projects -------557 Segments and Forms Used as Stand-Alone Projects--------558

Chapter 28: Adding Charts 561

Understanding Charts ----------------------------------------------561

Working with Page Level Charts------------------------------562 Working with Record Level Charts ---------------------------562 Inserting a Chart -------------------------------------------------562

Setting Chart Properties--------------------------------------------563

Naming a Chart --------------------------------------------------563 Selecting Chart Type--------------------------------------------563 Positioning a Chart ----------------------------------------------564 Setting Chart Absolute Position -------------------------------564 Setting Chart Relative Position --------------------------------565 Setting the Chart Size -------------------------------------------568 Setting the Chart Spacing---------------------------------------568 Applying the 3 D Effect ----------------------------------------571 Setting the Chart Background Color--------------------------572 Setting a Color Table for the Chart----------------------------573

XXVIII Vitesse User Guide

Setting a Chart Legend ----------------------------------------- 575 Setting the Chart Border---------------------------------------- 576 Setting the Chart Border Width ------------------------------- 576 Setting the Chart Border Color -------------------------------- 576 Setting the Chart Border Pattern ------------------------------ 576 Setting the Chart Text and Scale Color----------------------- 576 Setting Chart Fit Sizing Option-------------------------------- 577 Setting the Space Between Bars------------------------------- 578 Printing Data Values--------------------------------------------578 Setting the Value Format--------------------------------------- 579 Merging Values in a Chart ------------------------------------- 579 Maintaining Chart Ratio---------------------------------------- 580 Setting Range for the Y-axis----------------------------------- 580

Setting the Pie Chart Properties ---------------------------------- 581

Selecting the Pie Chart Display Type ------------------------ 581 Customizing the Pie Chart Labels----------------------------- 582 Setting the Label Dash Color ---------------------------------- 582 Setting the Label Dash Width --------------------------------- 582 Setting the Label Offset ---------------------------------------- 582 Setting the Slice Burst Value ---------------------------------- 582 Setting the Pie Chart Radius ----------------------------------- 583

Mapping Data to Charts------------------------------------------------- 584

Using DDG Index to Map Fields as Chart Data---------------- 584

Specifying Fields as Labels and Values---------------------- 584

Storing Field Label and Value Pairs-------------------------- 585 Using Predefined Variables as Chart Data---------------------- 587 Using Data from the Data File (Manual Data) ----------------- 588

Manually Mapping Field Data--------------------------------- 588

Mapping Data to a Page Level Chart – Non-Prefixed Line

mode Data--------------------------------------------------------

Mapping Data to a Record Level Chart – Prefixed Line

mode Data--------------------------------------------------------

Mapping Data to a Chart - Database Mode Data------------ 593

Mapping Data to a Chart – XML Mode Data --------------- 595

Manually Mapping Variables---------------------------------- 597

Manually Mapping Constants --------------------------------- 598

589 591

Contents XXIX

Chapter 29: Using Actions 599

Understanding Actions---------------------------------------------------599

Inserting an Action ----------------------------------------------600

Setting Action Properties------------------------------------------601

Creating a Booklet-----------------------------------------------601 Setting Document Control Printing Options-----------------603 Selecting the Page Mode ---------------------------------------603 Selecting the Duplex Mode ------------------------------------604 Selecting the Orientation ---------------------------------------604 Setting Document Set Options---------------------------------605 Specifying Finishing Operations ------------------------------606 Selecting the Bind Option --------------------------------------606 Selecting the Jog and Offset Option --------------------------606 Selecting the Staple Option ------------------------------------607 Selecting the Collate Option -----------------------------------607 Setting Page Control Options ----------------------------------608 Inserting Inline VIPP Code-------------------------------------612

Modifying Variables Using Actions -----------------------------612

Setting a Variable Value----------------------------------------613 Creating a Variable at Runtime--------------------------------615 Incrementing a Variable ----------------------------------------618 Decrementing a Variable ---------------------------------------618 Adding a Variable -----------------------------------------------619 Adding a Value to the Variable--------------------------------619 Adding an Existing Variable to the Variable ----------------620 Subtracting a Variable ------------------------------------------621 Subtracting a Value from the Variable -----------------------621 Subtracting an Existing Variable from the Variable--------621

Assigning Field Value to a Variable -----------------------------622

Assigning Value in Line Mode --------------------------------622 Choosing a Data Line – Using Conditions-------------------623 Choosing a Data Line – Using Line Number ----------------626 Choosing a Data Field – Using Fixed Field Data -----------626 Choosing a Data Field – Using Delimited Data -------------627 Assigning Value in Database Mode---------------------------628 Assigning Value in XML Mode-------------------------------630

Setting Variables as PDF Bookmarks----------------------------631

Setting Bookmark Properties-----------------------------------631

XXX Vitesse User Guide

Chapter 30: Adding Barcodes 635

Understanding Barcodes ------------------------------------------ 635

Associating the Barcode Fonts with the Barcode Types---638

Adding a Barcode ----------------------------------------------- 639 Setting Barcode Properties----------------------------------------639

Naming a Barcode----------------------------------------------- 639

Positioning a Barcode------------------------------------------- 639

Setting the Barcode Absolute Position ----------------------- 640

Setting the Barcode Relative Position ------------------------ 641

Setting the Barcode Size---------------------------------------- 643

Selecting the Barcode Type------------------------------------ 644 Specifying the Barcode Data ------------------------------------- 644

Applying Barcodes Using the Barcode Object-------------- 645

Using Variables as Barcode Data ----------------------------- 645

Using Constants as Barcode Data-----------------------------646

Using Merge Data-----------------------------------------------647

Applying Barcodes Using Field, Text, and Graphic Text

Objects------------------------------------------------------------

Example: Using Field Data as Barcode Value -------------- 648

Example: Using Static Text as Barcode Value--------------649

647

Section X: Referencing Resources Chapter 31: Using Forms in Projects 653

Using Forms in Projects-------------------------------------------653

Embedded Forms------------------------------------------------ 653

Inline Forms ------------------------------------------------------ 653

Linked Forms ---------------------------------------------------- 653

Referenced Forms ----------------------------------------------- 654 Inserting Forms-----------------------------------------------------654

Inserting a Form as a Project Resource----------------------- 654

Inserting a Form in the Project Design ----------------------- 655 Setting Properties of a Form Reference ------------------------- 657

Changing the Referenced Form ------------------------------- 657

Using Variables to Reference a Form ------------------------ 657 Setting Properties of an Inline Form----------------------------- 658

Contents XXXI

Chapter 32: Using Segments in Projects 659

Understanding Segment Types -----------------------------------659

Embedded Segments --------------------------------------------659 Inline Segments--------------------------------------------------659 Linked Segments-------------------------------------------------659 Referenced Segments -------------------------------------------660 Begin Page Segments -------------------------------------------660 End Page Segments----------------------------------------------660 Repeat Segments-------------------------------------------------660

Inserting Segments -------------------------------------------------661

Inserting a Segment as a Project Resource-------------------661 Inserting a Segment in the Project Design -------------------662

Setting Properties of a Segment Reference ---------------------664

Positioning a Referenced Segment----------------------------664 Aligning a Segment Reference --------------------------------665 Scaling a Referenced Segment---------------------------------667 Rotating a Referenced Segment -------------------------------668 Changing the Referenced Segment----------------------------668 Using Variables to Reference a Segment---------------------669

Dynamically Sizing Segments ---------------------------------670 Using Repeat Segments--------------------------------------------672 Working with Segments in an XML Mode Project ------------673

Using Tag Start Segments--------------------------------------673

Using a Tag Orphan Segment----------------------------------674

Using a Tag End Segment--------------------------------------674

Specifying Vertical Spacing between Segments ------------675

Chapter 33: Referencing Images 677

Referencing Images ------------------------------------------------677

Inserting an Image in a Project Design -----------------------677

Setting Properties of an Image Reference--------------------678

Positioning an Image Reference-------------------------------679

Resizing an Image Reference ----------------------------------681

Rotating an Image Reference ----------------------------------682

Scaling an Image Reference------------------------------------683

Aligning an Image Reference----------------------------------684

Changing the Referenced Image-------------------------------685

Using Variables to Reference an Image ----------------------685

XXXII Vitesse User Guide

Section XI: Preparing the VIPP Project for Production Chapter 34: Previewing and Testing the Project 689

Opening Existing Resources-------------------------------------- 689 Opening Recently Used Resources ------------------------------ 691 Previewing a Project ----------------------------------------------- 691

Proof-Printing a Project ---------------------------------------- 692

Print Previewing Multi-Up Projects -------------------------- 693 Setting Memory Size for Optimization for View -------------- 696 Working with Source Code --------------------------------------- 697

Viewing the Source Code -------------------------------------- 698

Searching in the Source Code --------------------------------- 699

Finding Text in the Source Code------------------------------ 699

Replacing Text in the Source Code---------------------------699

Editing the Source Code---------------------------------------- 700

Compiling VIPP Code------------------------------------------700

Reverting to the Last Compiled State ------------------------ 701

Exporting Source Code-----------------------------------------701

Setting Default Source Code Options ------------------------ 702

Setting Colors for Source Code Objects ---------------------702

Setting Source View Background Color --------------------- 703

Setting a Default Font for the Source Code------------------ 704 Saving Resources--------------------------------------------------- 704

Saving a Project ------------------------------------------------- 705

Saving a Resource----------------------------------------------- 706

Saving Projects in Vitesse Zip Format ----------------------- 706

Chapter 35: Importing and Exporting Projects 707

Importing Projects-------------------------------------------------------- 707

Setting Import Preferences---------------------------------------- 707

Setting Text Merge Preferences------------------------------- 708

Using Comments in the Imported Project-------------------- 708

Using Preferences from a DEF File--------------------------- 709

Importing a Project---------------------------------------------- 709

Exporting Projects-------------------------------------------------------- 712

Setting the Export Preferences ----------------------------------- 712

Setting the Default Measurement Unit -----------------------712

Setting a Comment Level for the Exported Project--------- 713

Using Elixir Comments----------------------------------------- 713

Converting TIFF Files ------------------------------------------ 713

Setting the Buffer Size------------------------------------------ 714

Contents XXXIII

Setting Maximum Number of Forms -------------------------714 Exporting a Vitesse Project-------------------------------------715

Packaging Other Files with a Project ----------------------------716

Exporting a Project ----------------------------------------------717 Managing Unmapped Fonts during Export ------------------718 Converting True Type Fonts to the PostScript Format -----718 Packaging the PostScript Fonts into the VPC----------------718

Chapter 36: Vitesse Administrative Options 719

Vitesse User Types-------------------------------------------------719

Administrator-----------------------------------------------------719 User----------------------------------------------------------------719

Opening Vitesse in Administration Mode-----------------------720

Opening a File in Vitesse Administration Mode ------------720 Setting Administrator Preferences-----------------------------721 Setting up the Working Folder---------------------------------721 Limiting Vitesse Functions-------------------------------------722 Setting Default Vitesse Mode----------------------------------723 Setting Permissions for the Export Folder -------------------724 Setting up Predefined Media-----------------------------------725 Limiting Resource Insertion------------------------------------727 Setting Resource Loading Options----------------------------728 Limiting Resource Deletion------------------------------------729 Enabling Field Insertion in Forms and Segments -----------730 Setting VIPP Projects Import Options------------------------732

Opening Vitesse in User Mode -----------------------------------733

Opening a File in Vitesse Administration Mode ------------733

Appendix A: Error and Warning Message Handling 735

Source Code Error Handling--------------------------------------735

Error Messages---------------------------------------------------735 Warning Messages-----------------------------------------------735 Informational Messages ----------------------------------------735 Viewing Source Code for Entire Application or External Resources ---------------------------------------------------------

736 Handling Compilation Errors ----------------------------------736 Reverting to the Last Valid Compiled State -----------------737

Error Messages------------------------------------------------------737

Import Error Messages------------------------------------------737

Warning Messages -------------------------------------------------739

Import Warning Messages--------------------------------------739

XXXIV Vitesse User Guide

Export Warning Messages ------------------------------------- 740 Text Warning Messages----------------------------------------745

Glossary 749 Index 753

Contents XXXV

User Notes:

XXXVI Vitesse User Guide

Chapter 1: Introduction

This chapter provides an overview of the Vitesse functions and features that facilitate creating projects and resources for VIPP printing. It also includes information on the following:

! Vitesse: From Document Design to Printed Page ! Creating a Preliminary Design ! Defining and Locating Test Data ! Understanding the VIPP modes ! What’s New in Vitesse

Vitesse Overview

Vitesse is a Windows-based, visual design environment for creating, editing, and formatting variable data projects and resources for Black and White, Highlight, and Full color VIPP (Variable Data Intelligent PostScript Printware) printing. VIPP is an open language Xerox print stream, which is based on PostScript and works by extending PostScript programming language, enabling you to efficiently create Xerox printer applications. Vitesse simplifies the document designing process as it provides a Windows-based visual design environm ent.

2.00

With Vitesse, you can use XML, database resident, and legacy line data map the data in a project using either the drag and drop operation, or by typing in data specifications. You can also design forms and segments using objects such as lines, boxes, and images; create data-driven graphics, dynamic texts flows, and apply conditional logic to your design.

You can import and edit VIPP projects and project resources visually or by editing the source code. Vitesse provides a VIPP source view for viewing, editing, and compiling code changes in a single, integrated environment for newly designed or imported projects.

Existing hand-coded VIPP applications; Xerox native print resources such as forms (FRM and FSL), fonts (FNT), and image files (IMG and LGO) for migration from LCDS and Metacode environments; and VIPP resources (FRM, SEG, JDT, XJT, and DBM) can also be imported, edited, and saved using Vitesse.

Vitesse fully supports VIPP Native (NM), Database (DBM), Line data (JDT), and XML (XJT) project modes, and provides for creation and modification of VIPP resources such as forms and segments.

Depending on the project mode, a VIPP project designed in Vitesse can be exported as a VIPP Project Container (VPC), as well as DBM, JDT, NM, or XJT.

VPC enables you to archive all project resources into one file. Later, you can export a VPC to any location. Once exported, the VPC automatically allocates all resources to their respective VIPP directory. Contrarily, exporting projects in JDT, XJT, or DBM format does not pack the resources, indicating that you need to track each resource file individually.

VIPP uses Dynamic Document Composition (DDC) to format and print line printer and database data using PostScript features at production speeds. DDC is based on real time composition of the document at the printer or imaging device. In keeping with Dynamic Document Composition (DDC) , VIPP projects and resources from Vitesse are typically transported over the network to the PostScript print controller, and then merged with the data file by the Xerox VIPP compiler.

Additionally, the Vitesse VIPP project code can be sent to a Xerox VIPP Thin Printer for distillation and conversion to PDF. The VIPP Thin Printer can be resident on the PostScript print controller or any server or client machine running Windows NT, Windows 2000, or later versions. The image below depicts how projects designed inVitesse are exported to destination printers for generating the required output:

Vitesse also extends Xerox PDF workflow functionality by providing the following features:

! Drag and drop workflow for creating P DF b o okmarks. ! PDF bookmark creation in all three VIPP modes. ! Creation of single-level bookmarks or sub-bookmarks for hierarchical bookmark

levels within a PDF.

! Bookmark-driven PDF splitting.

38 Vitesse User Guide

Before You Start

Prior to creating your projects in Vitesse, you need to familiarize yourself with prerequisite activities that are required for creating a design. Some basic activities include: defining the input; setting the project defaults; specifying document attributes; identifying the content, layout, and structure of the design and associated data; and identifying scenarios for subsequent design testing, etc. The sections below briefly explain the process of creating and implementing projects in Vitesse.

Subsequent chapters provide detailed descriptions of the activities and tasks involved when using Vitesse for designing applications.

Creating a Preliminary Project

You should prepare a preliminary struct ure of the required output before building the actual design. You can create a pencil drawing depicting the physical layout of each page or identify a proximate archived project to subsequently import and serve as the basis for a new project. In either case, your first step should establish how each document page will look. This includes object placement, arrangement of images/logos and borders, layout of headers and footers, font selection, and simplex vs. duplex printing considerations , etc.

Once you have settled on a preliminary design, you should next specify the design preferences and document properties, as appropriate for subsequent development and testing. This activity includes specification of default text, paper, color options, document name, description, etc.

Defining and Locating Test Data

After specifying the initial design, you should next specify the parameters for testing the design. You can create a test data file and define parameters for placing in the design by using a text editor or by excerpting relevant data from a production data file.

In either case, records and fields in a test data file should structurally and accurately represent the production data, and follow the organization’s business rules including all possible scenarios and data combinations. Typically, an effective test data contains only enough records and associated fields necessary to reflect the cohesiveness of the various design combinations, test the required results, and enable you to print preview the results. You can test and preview the document design competency with test data, forgoing the usually larger files typical of the actual production data.

Chapter 1: Introduction 39

Understanding the VIPP Modes

Vitesse supports the following VIPP modes for designing and testing your projects:

! Native mode ! Line mode ! Database mode ! XML mode

These modes or project types are based on the various VIPP input data formats and are discussed in the following sections.

What is Native Mode?

Native mode is used for creating, positioning, formatting, and printing static objects such as lines, boxes, text, images, forms, and segments directly on a physical page.

Applications created in the Native mode support fully composed Native mode data streams. For example, you can create college application forms or promotional flyers using this mode, as well as other documents. Native mode applications do not support variable data.

What is Line Mode?

Line mode enables you to work with legacy type data streams. Legacy type data streams are characteristic of transactional documents, such as telephone bills, credit card statements, banking statements, and sales reports. These data streams are also referred to as “line” or “print ready” data. One example is LCDS (Line Conditioned Data Streams. Line mode projects comprise line data in ASCII format that is line numbered or RPE prefixed. Moreover, the data can either have delimited or nondelimited fields within records. Line mode enables you to read, process, and format the line printer data either line-by-line (records) or column-by-column ( fields).

Using Line mode, you can also control the page composition, color, and formatting of the line printer data by a JDT (Job Descriptor Ticket) file. This file contains the VIPP commands used to define the required presentation of the line printer data. The .LM extension is recommended for Line mode data files, but is not required, as VIPP and Vitesse can use other extensions.

40 Vitesse User Guide

The following image is an example of a fixed length, prefixed line mode data file:

What is Database Mode?

Database mode is used to process data files containing delimited records. The delimited data file is typically extracted from a relational database. You can use the Database mode to create applications, such as promotional flyers, insurance contracts, etc. Records in a data file may be of fixed or variable length, and must have the same sequence and number of fields. The first line in the data file contains field names. Remaining lines contain data in the order of field names. Delimiters are used to separate fields within records. Data files used in the Database mode can use the .DBF extension.

Chapter 1: Introduction 41

The following image is an example of a variable length data file in the Database mode:

What is XML Mode?

XML mode uses XML data files in ASCII format. Data in the XML files is organized in a tree structure. Nodes in the tree structure represent tag names, attribute names, and associated values. The entire data in the data file is enclosed within start and end tags.

Delimited and/or prefixed data files are not supported in XML mode.

XML mode requires an XJT (XML Job Ticket) file for processing XML dat a. An XJT file contains instructions on how to process and arrange the XML data into a document. It contains all global layout definitions for the document (orientation, forms, medias, frames, fonts, colors, etc.) and an XML Processing Definition (XPD) table that describes specific actions to be performed on specific XML tags. XML Mode files use the .XML extension.

42 Vitesse User Guide

Sample of XML mode data file.

What’s New in Vitesse 2.00?

Vitesse 2.00 introduces new and advanced features that can be accommodated in the designs. Also, some of the existing features and object behaviors have been enhanced in the new version. The sections below briefly explain the features and associated behaviors.

Form and Segment Behavior

Vitesse 2.00 enables you to manage the content of segments and forms through the use of conditional logic. Additionally, you can dynamically resize segments based on the objects used in the segment design.

Frame Behavior

Vitesse 2.00 supports the overflow of segments across multiple frames. In previous Vitesse versions, if the contents of a segment object did not fit in one frame, the rest of the contents were printed outside the frame. With this new overflow behavior, if the contents of a segment do not fit in one frame, the rest of the contents automatically flow to the next frame. If the current frame is the last frame on the page, then the overflow behavior automatically causes a page break and a new page is created.

Restricted Mode Operation

You can operate Vitesse 2.00 in administration and/or use r modes. Using the Administration mode, you can operate Vitesse as an administrator, utilizing all the functionalities provided in Vitesse. Moreover, you can use the Administrator category in the Preferences dialog (discussed in later chapters) to choose features that you want to be available in the Vitesse user mode.

Chapter 1: Introduction 43

User mode provides a customized Vitesse workspace, depending on the preferences set by the administrator. The administrator can restrict options such as creating, opening, saving, or exporting projects in Vitesse user mode. The administrator can also setup rights for each project resource by setting preferences in the Administration mode. For example, restrictions can be set for loading form resources in a project.

Predefined Media and Fields

Vitesse 2.00 enables you to predefine media settings by specifying paper properties in an XML file. By placing the media file at the path drive:/Program Files/Vitesse/Config, only papers defined in the XML file are inserted in a project. Similarly, you can also set up a predefined variable list to add variables in forms and segments.

Batch Conversion of Documents

You can export multiple .EVD files in a single application instance using the Vitesse batch conversion feature. This process is invoked using the command prompt. You can also choose to log all of the messages generated during the conversion process.

44 Vitesse User Guide

Section I: Vitesse Basics

User Notes:

46 Vitesse User Guide

Chapter 2: Understanding the Vitesse Workspace

This chapter provides an overview of the Vitesse workspace and describes activities and tasks for using the workspace. Information includes the following:

! Getting Familiar with the Workspace ! Using the Design Area ! Using the Project Tree View Window ! Using the Project Tree, Property, Data, and Message View Windows ! Arranging the Workspace Windows ! Using Workspace Tools ! Placing Objects in the Design Area ! Moving Objects using the Keyboard ! Zooming within the Design Area ! Moving the Design Area view ! Using the Full Screen View ! Refreshing the Project ! Navigating the Workspace ! Choosing Commands

Getting Familiar with the Workspace

When you open a project in Vitesse, the workspace and all associated components display. Application objects are created and maintained in the workspace.

The workspace contains the following windows:

! Design area ! Project Tree View window ! Property View window ! Data View window ! Message View window

You can customize the position and size of the windows per your requirements. The workspace windows can be displayed as either floating or docked and can also be hidden from view.

The image below identifies each part of the Vitesse workspace:

The Vitesse workspace.

The following sections explain each window in detail.

Using the Design Area

The design area provides a visual representation of the active application. Vitesse provides two tabs for viewing the design area in the following two modes: Design View and Source View. You can scroll the design area vertically and horizontally using the scroll bars in both views.

Design View

Design View is the default view when a project is opened in Vitesse. You can add drawing objects to this view, visually map objects and data, resize, and move objects as required. Mapped objects have corresponding entries automatically created in the project tree. Object properties that you set are also immediately reflected in the Design View.

You can, therefore, design a document and view its composed structure merged with the variable data simultaneously in the Design View.

48 Vitesse User Guide

Source View

Clicking the Source View tab generates the VIPP source code for the active application. Application or external resource source code can be viewed either by selecting the SubDoc node or the required Project tree resource node and then switching from Design View to Source View, or by selecting options from the dropdown list provided in the Source View.

Design area can be viewed using the Design View and Source View tabs.

Using the Project Tree View Window

By default, the Project Tree View window is located at the top left side of the design area. This window contains a project tree that provides a hierarchical representation of the Vitesse objects used within a project. The structure of the tree varies, depending on the type of resource or project mode you are working on.

Chapter 2: Understanding the Vitesse Workspace 49

Project Tree View window displaying the default nodes.

The root (top most) node in the project tree specifies the VIPP project type and name. Sub-nodes under the root node are the default high-level nodes and contain further sub-nodes explained in the sections below. Objects that are inserted in the design area are also added to the project tree as object nodes. You can set properties for each object node using the Property View window. You can also use the project tree to select, add, and/or remove resources and objects from the project. During printing, Vitesse processes objects in the order they are placed in the project tree.

Default project tree nodes cannot be deleted.

Media

The Media node enables you to insert physical paper(s) to your design. Each inserted paper (or Paper node) can have different property settings such as the paper type, orientation, size, etc. You can set the properties for a particular paper by selecting the Paper node, and then specifying the associated properties in the Property View window. Each Paper node further contains a Front and Back node that indicate the front and back side of the selected paper respectively. You can insert a form on either side of the paper.

50 Vitesse User Guide

MasterDoc

The MasterDoc node contains the SubDoc and Page node by default. These nodes represent the logical page(s) and their associated properties used in a design. You can set the logical page definitions at the MasterDoc, SubDoc, and Page level using the Property View window. The MasterDoc node and consequently the Page node also contain nodes for all objects that are mapped to the logical page(s).

Resources

The Resources node contains the sub-nodes Fonts, Segments, Font Styles, and Images that represent all of the resources (forms, segments, fonts, and images) used

or referenced in the project. You can display or hide the Project Tree View window by selecting Window>Project

Tree from the main menu.

You can also display or hide the

! Clicking on the status bar.

! Pressing <Ctrl>+<1> on the keyboard.

Project Tree View

window either by:

Using the Property View Window

Once an object is added to the design, you can specify the attributes/properties using the Property View window. The Property View window is located at the bottom left of the workspace by default. The properties displayed in the Property View window change as different objects are selected from either the design area or the project tree. Each object can have different attributes/properties that are categorized different tabs in the window.

using

Chapter 2: Understanding the Vitesse Workspace 51

The Property View window displaying the General properties associated with a Page object.

To specify any property, select the relevant tab and make your changes using the available options.

The Property View window can be opened or closed by selecting the Windo w> Properties menu option.

You can also display or hide the

Property View

window either by:

! Clicking icon on the status bar.

! Pressing <Ctrl> + <2> on the keyboard.

Using the Data View Window

Vitesse also supports the use of data files for composing data-driven applications. The data files can be viewed in the Data View window so you can drag and drop required data directly into the design area. This window is context-sensitive and displays data files and associated options relating to specific project modes (i.e., Line, Database, or XML mode).

The Data View window is located at the right side of the workspace by default and contains two tabs:

! The Data tab shows the data file in a row and column layout for Line Mode and

Database Mode projects. For an XML Mode project, the data is displayed in a tree structure.

! The Source tab displays the source code of the data file. You can edit the file

only if it is not in read-only mode.

52 Vitesse User Guide

Data View window can be viewed using the Data View and Source View tabs.

To view the Data View window if it is not already open, select Window>Data from the menu bar.

You can also view the

Data View

window either by:

! Clicking on the status bar.

! Pressing <Ctrl> + <3> on the keyboard.

Using the Message View Window

The Message View window is located at the bottom of the workspace by default. This window displays the processing and compilation errors, warnings, and informational messages generated by the application. Messages are displayed when either a VIPP application is being imported or source code is being edited and compiled.

Error messages display in black text, warnings display in gray text, and informational messages display in blue text. You can close the Message View window by selecting Window>Messages menu option to allow more space to work. However, the window will automatically redisplay whenever a message is generated by the application.

You can also view or hide the + <4> on the keyboard.

Chapter 2: Understanding the Vitesse Workspace 53

Message View

window by pressing <Ctrl>

The Message View window displaying informational, error, and warning messages in their respective colored text.

Clearing Messages

To clear the messages generated by the application, right-click in the Message View window, and then select Clear from the pop-up menu.

Saving Messages

To save the messages generated by the application:

1 Right-click in the Message View window area. 2 Select Save from the pop-up menu to open the Save dialog. 3 Search Save in for the required folder where y ou want to save the message

file.

4 Specify the file name in the File name entry bo x. 5 Click Save to save the file.

You can create a message log file in any required format.

Setting the Default View Options

You can customize Vitesse to display or hide the Message View window, tool bars, and status bar every time you open a project. To specify the viewing options:

1 Select Tools>Preferences from the menu bar to open the Preferences dialog. 2 In the Preferences dialog, select the View category.

54 Vitesse User Guide

3 Select the options you want to show or hide each time the application is

opened. Options include Status bar, Messages window, Toolbars, and associated toolbar options in the list.

Preferences dialog –View Category.

4 Click OK.

The items not selected will not be displayed the next time you open a project. However, you can view them any time during the application design using the View menu or the Window menu.

Arranging the Workspace Windows

Vitesse lets you arrange the workspace windows in an orderly manner using the main menu options. To arrange the design area windows, select the required arrangement option from the Windows menu.

! Default State – displays all of the workspace windows docked to the default

locations.

! Data/Design State – displays the Data View window and the design area docked

in the workspace.

! Data/Design/Tree State – displays the Data View window, the design area, and

the Project Tree View window as docked in the workspace.

Chapter 2: Understanding the Vitesse Workspace 55

An illustration of these views is as follows:

The Message View window displays at the bottom of the workspace in all three states.

Using Workspace Tools

Vitesse toolbars provide easy access to most commonly used application commands. You can perform standard MS-Windows operations to hide or display a toolbar or dock a toolbar at the edge of the workspace.

Using the Menu Bar

A menu bar with drop-down menus displays directly below the application title bar. These drop-down menus provide both standard MS-Windows and application-specific options. Selecting a menu item performs the associated action or displays a submenu or a dialog.

56 Vitesse User Guide

Using the Toolbar

Directly below the menu bar are toolbars with buttons that provide access to the most commonly used menu commands and tools. You can hide or display all available toolbars by selecting View>Toolbars> toolbar name from the main menu. You can also dock the toolbars in the workspace.

Viewing the Status Bar

The status bar displays along the lower edge of the Vitesse workspace. When you move the mouse pointer over the design area, the status bar displays the current position of the mouse pointer and the zoom level. The status bar also displays the tool tip when the mouse pointer is placed over a command.

In addition, when an object is selected or being drawn in the design area, the status bar also displays the tool tip of the object being drawn, the height, width, and the current coordinates of the mouse pointer. This information helps when drawing objects in the design area.

At the extreme right of the status bar are three buttons, hide the Project Tree View window, the Property View window, and the Data View window .

To view all of the buttons on the status bar, ensure the Vitesse workspace window is in the maximized state.

Chapter 2: Understanding the Vitesse Workspace 57

, , and to show or

Placing Objects in the Design Area

Vitesse provides various tools that help you draw and place objects accurately in the design area. These tools are discussed below:

Using the Ruler

Vitesse provides horizontal and vertical rulers to help visually place objects in the design area. Rulers display along the top and left side of the design area. When you move an object or cursor in the design area, lines indicating the object or cursor position appear on the rulers. By default, the unit of measurement for the rulers is Dot 3 (dots per inch). You can show or hide the rulers a nd chan ge t he unit of measurement used in the rulers.

Displaying and Hiding the Ruler

To display or hide the rulers, select View>Ruler from the menu bar.

You can also display or hide the ruler either by:

! Clicking on the

! Pressing <Ctrl> + <R> on the keyboard.

View

toolbar.

Setting the Default Ruler Option

To display or hide the rulers every time you open a project:

1 Select Tools>Preferences from the menu bar to open the Preferences dialog. 2 In the Preferences dialog, select the Designer category under the Workspace

node.

3 Select or deselect the Ruler option under the View area as required, and then

click OK.

Changing the Unit of Measurement

You can also change the unit of measurement for the rulers. To specify the required unit of measurement:

1 Select Tools>Preferences from the menu bar to open the Preferences dialog. 2 In the Preferences dialog, select the Designer category under the Workspace

node.

3 Specify the required unit of measurement from the Default unit drop-down

list.

4 Click OK.

The design area displays the rulers with the specified settings.

58 Vitesse User Guide

Image showing steps for changing the default unit of measurement.

To change the unit of measurement, you can also right-click the rulers displaying in the design area, and then select the required unit from the pop-up menu.

Using the Grid

You can also use the grid while creating an application. A grid can display either as a set of lines or dots in the design area. Grids help in marking ruler positions across and down the design area so you can align objects accurately in the design. The grid, however, is only a tool to assist you visually with the application design; it does not display when you print or preview your document.

You can show or hide the grid; snap objects to the grid; and you can modify the grid spacing and color.

Chapter 2: Understanding the Vitesse Workspace 59

Displaying and Hiding the Grid

To display or hide the grid tool, select View>Grid from the menu bar.

You can also turn the grid on or off either by:

! Clicking on the

View

toolbar.

! Pressing <Ctrl> + <G> on the keyboard.

Setting the Default Grid Option

To display or hide the rulers every time you open a project:

1 Select Tools>Preferences from the menu bar to open the Preferences dialog. 2 In the Preferences dialog, select the Designer category under the Workspace

node.

3 Select or deselect the Grid option under the View area, and then click OK.

Automatically Aligning Objects to the Grid

Vitesse enables you to automatically align objects to the grid by providing the snap to grid feature. Snapping offers a way of precisely placing an object on the design area by having the object affix itself to the intersections of grid lines or dots.

We recommend keeping the grid on before activating the snap to grid feature so that you can see the snap points.

To turn on the snap to grid feature, click on the View toolbar. You can use the same method to turn snapping off.

60 Vitesse User Guide

Image shows the box alignment to the grid using the snap to grid feature.

Setting the Default Snap to Grids Option

To turn the snap to grid feature on or off every time you open a proj ect:

1 Select Tools>Preferences from the menu bar to open the Preferences dialog. 2 In the Preferences dialog, select the Designer category under the Workspace

node.

3 Select or deselect the Snap to Grids option under the Grids area, and then

click OK.

Chapter 2: Understanding the Vitesse Workspace 61

Setting the Grid Color

You can also specify the grid color using the following steps:

1 Select Tools>Preferences from the main menu to open the Preferences dialog. 2 In the Preferences dialog, select the Designer category under the Workspace

node.

3 For setting the grid color, click the Color drop-down under the Grids area; a

color palette with command buttons for choosing the appropriate color is displayed. Select the required color.

4 Click OK.

The grid updates with the specified color.

Image showing steps for setting the grid color.

62 Vitesse User Guide

Setting the Grid Style

You can choose to display the grid as either intersecting lines or dots in the design area. To specify the grid style:

1 Select Tools>Preferences from the main menu to display the Preferences

dialog.

2 In the Preferences dialog, select the Designer category under the Workspace

node.

3 As appropriate, select any one of the following Style As options available

under the Grids area:

! Lines – displays the grid as intersecting lines. ! Dots – displays the grid as dots.

4 Click OK. The grid displays in the selected style.

Design area displaying grid style set to: (1) Lines (2) Dots.

Setting the Grid Spacing

Vitesse lets you customize the spacing between the grid points, as per the specified unit of measurement.

To specify the grid spacing:

1 Select Tools>Preferences from the main menu to display the Preferences

dialog.

2 In the Preferences dialog, select the Designer category under the Workspace

node.

3 Specify the required spacing in Inches in the Spacing entry box under the

Grids area.

You can also set the unit of measurement by right clicking the upward and downward arrows in the Spacing entry box and selecting Units>

name

Chapter 2: Understanding the Vitesse Workspace 63

from the pop-up menu.

unit

The Spacing value can be specified in Inches only.

4 Click OK.

The grid displays as per the specified spacing value.

Setting the grid spacing visually helps with placing objects in accordance with the grid lines. For example, if you want to place text objects vertically at a distance of

0.5 inches with each other, you can set the grid spacing to 0.5 inches.

Design area displaying text objects placed accurately on the grid lines with spacing value set to 0.5 Inches.

Using Guides

Guides are horizontal and vertical lines that you can drag from the rulers onto the design area. You can move, hide, and remove the guides. You can also snap objects to guides, change guide color, and choose to display guides as solid or dotted lines. Guides are used as visual aids when placing objects and do not display while previewing or printing.

Turning the Guides On and Off

To turn the guides on or off, select View>Guides from the menu bar.

You can also turn the guide on or off either by:

! Clicking on the

! Pressing <Ctrl> + <D> on the keyboard.

64 Vitesse User Guide

View

toolbar.

Setting the Default Guide Option

To display or hide the guides every time you open a project:

1 Select Tools>Preferences from the menu bar to open the Preferences dialog. 2 In the Preferences dialog, select the Designer category under the Workspace

node.

3 Select or deselect the Guidelines option under the View area, and then click

OK.

Moving Guides to the Design Area

When you turn on the guides feature, the guides do not display in the design area like the ruler or the grids do. To view the horizontal guide, click at any point on the horizontal ruler and drag the line to the required position in the design area. Similarly, to view the vertical guide, drag the line from any point on the vertical ruler to the required location in the design area. You can drag as many horizontal and vertical guides as appropriate.

Before using the guides option, you should make sure the rulers are displaying in the design area.

The image below illustrates the process of viewing guides in the design area:

Chapter 2: Understanding the Vitesse Workspace 65

Removing Guides from the Design Area

To remove a guide from the design area, click the guide and then drag it back to the ruler.

Automatically Aligning Objects to the Guides

Vitesse also provides the snap to guide feature for automatically aligning objects to the guides. This enables you to place objects precisely in the design area.

To turn on the snap to guide feature, click same method to turn snapping off again.

Snapping to guides takes precedence over snapping to the grid in places where guides fall between the grid lines.

on the View toolbar. You can use the

Setting the Default Snap to Guides Option

To turn the snap to guide feature on or off every time you open a project:

1 Select Tools>Preferences from the menu bar to open the Preferences dialog. 2 In the Preferences dialog, select the Designer category under the Workspace

node.

3 Select or deselect the Snap to Guidelines option under the Guides area, and

then click OK.

Setting the Guide Color

You can also specify the guide color using the following steps:

1 Select Tools>Preferences from the main menu to display the Preferences

dialog.

2 In the Preferences dialog, select the Designer category under the Workspace

node.

3 For setting the guide color, click the Color drop-down under the Guides area;

a color palette with command buttons for choosing the appropriate color is displayed. Select the required color.

4 Click OK to update the guides with the specified color.

66 Vitesse User Guide

Setting the Guide Style

You can choose to display the guides as either solid or dotted lines in the design area. To specify the guide style:

1 Select Tools>Preferences from the main menu to display the Preferences

dialog.

2 In the Preferences dialog, select the Designer category under the Workspace

node.

3 As appropriate, select one of the following options available under the

Guides area:

! Lines – displays the guides as solid lines. ! Dots – displays the guides as dotted lines.

4 Click OK.

The guide displays in the selected style.

Image showing steps for setting the style for guides.

Chapter 2: Understanding the Vitesse Workspace 67

Using the Crosshair

The Crosshair tool displays as a pair of lines intersecting at the cursor. These lines move with the cursor and help in placing objects relative to each other in the design area.

You can also use the crosshair to assist in aligning objects visually, as shown below:

Displaying and Hiding the Crosshair

To display or hide the crosshair, select View>Crosshair from the menu bar.

You can also turn the crosshair on or off either by:

! Clicking on the

! Pressing <Ctrl> + <L> on the keyboard.

View

toolbar.

Setting the Default Crosshair Option

To display or hide the crosshair every time you open a project:

1 Select Tools>Preferences from the menu bar to open the Preferences dialog. 2 In the Preferences dialog, select the Designer category under the Workspace

node.

3 Select or deselect the Crosshairs option under the View area, and then click

OK.

68 Vitesse User Guide

Moving Objects using the Keyboard

Once an object is placed in the design area, you can move it anywhere in the design area. To precisely place objects in the design area, you can also make use of the arrow keys on the keyboard.

To move an object using the keyboard:

1 Select the required object in the design area. 2 Press the appropriate arrow key to move the object in the required direction

with a specified displacement. This is also referred to as nudge in Vitesse.

3 Press <Shift> along with the appropriate arrow key to move the object in the

required direction with a finer displacement. This is referred to as super nudge in Vitesse.

Setting the Nudge Options

You can set the increment value (nudge setting) by which you want to displace an object.

To specify the nudge settings:

1 Select Tools>Preferences from the main menu to display the Preferences

dialog.

2 In the Preferences dialog, select the Designer category under the Workspace

node.

3 In the Nudge area, specify a value in Inches for the following:

! Nudge Settings – sets the value by which an arrow key displaces the

selected object in the appropriate direction.

! Super Nudge – sets the smallest value by which an arrow key displaces the

selected object in the appropriate direction.

The Nudge values are specified only in Inches.

4 Click OK.

Chapter 2: Understanding the Vitesse Workspace 69

Zooming within the Design Area

To view the entire design on the screen, or to view just a particular area of your design at higher magnification, you can use the zoom tool. Vitesse provides various options for setting the magnification level. To do so, select View>Zoom>required option from the menu bar. The options are:

! Zoom In – magnifies the entire design area view. You can also magnify the

view by clicking

! Zoom Out – reduces the entire design area view. You can also zoom out of

the view by clicking

! Zoom Back – reverts back to the last magnification level. ! Zoom Fit – scales the design view to fit completely in the given design area.

You can also zoom to full extent by clicking

! Zoom to Object – magnifies the selected object in the design area. You can

also zoom to the selected object by clicking

! Zoom to Width – scales the design view to fit the design area width. You

can also use the Zoom to Width option by clicki ng toolbar.

! Zoom to Height – scales the design view to fit the design area height. You

can also use the Zoom to Height option by clicking toolbar.

The View>Zoom menu also provides sub-menu options to zoom in or out using predefined values: 50%, 100%, 250%, or 500%.

on the Zoom toolbar.

on the Zoom

70 Vitesse User Guide

Image showing the magnified pie chart view using the Zoom to Object option.

Specifying Custom Zoom Value

To zoom in or out of the design area to a specified custom value:

1 Select View>Zoom>Custom from the menu bar to open the Custom Zoom

dialog.

2 Specify the required Zoom percentage value. You can either select the values

available in the drop down list or type a new value.

3 Click OK.

You can also specify a custom zoom value in the text box provided in the

Zoom

toolbar.

Moving the Design Area View

When the design area is magnified, you may not be able to see all of it. The pan tool lets you move the design area to change the view without having to change the magnification.

To move/pan the design area view:

1 Click on the Drawing toolbar. 2 Click anywhere in the design area and drag to the required view.

Chapter 2: Understanding the Vitesse Workspace 71

Using the Full Screen View

To display as much of your design as possible on the screen, you can switch to the full-screen view. In this view, Vitesse removes most of the screen elements, such as the menu bar, toolbars, and scroll bars. It only displays the design area, the Project Tree View window, and the Property View window.

To switch to the full screen view, select View>Full Screen from the menu bar or click

on the Zoom toolbar.

To turn off the full-screen mode and switch to the previous view, click Full Screen toolbar, or press <Esc> on the keyboard. The Full Screen toolbar displays only in the full-screen mode.

Refreshing the Project

You can refresh the document design to reflect the latest changes in the design area by selecting View>Refresh from the menu bar. You can also refresh your design by pressing <F5> on the keyboard.

To refresh the design changes along with the property settings sp ecified in the Property View window, select View>Refresh All from the menu bar. You can also perform the same operation by pressing <Shift> + <F5> on the keyboard.

Navigating the Workspace

Vitesse workspace components are organized according to function and use. You can navigate any component using the mouse.

! To use the menu bar:

Click the appropriate menu, and then select the required option from the dropdown list.

! To show the toolbar:

From the View menu, select Toolbars>toolbar name. A check mark next to the required toolbar indicates that it has been selected.

! To use a toolbar:

Click the required icon on a toolbar to perform an operation.

! To use the right-click menu:

Position the cursor on the menu or design area, right-click the mouse, and then select the required option.

on the

72 Vitesse User Guide

Choosing Commands

A command instructs Vitesse to perform a specific action. You can choose a command by either:

! Clicking a toolbar button. ! Selecting a menu command. ! Using a shortcut menu. ! Using a shortcut key.

In the chapters that follow, command selection is described using the most common method for the described task. However, any related command selection can be used to accomplish the same instruction.

Chapter 2: Understanding the Vitesse Workspace 73

User Notes:

74 Vitesse User Guide

Chapter 3: Understanding the Vitesse Directory Structure

This chapter explains the Vitesse directory structure, the scope of resources used in Vitesse, and associated tasks for setting up working folders. Information covers:

! Understanding Project Resource Scope ! Understanding the Vitesse Directory Structure ! Setting up the Working Folder ! Using Scope Specific View in the Project Tree ! Setting Default Folder Preferences

Understanding Resource Scope

A resource’s scope refers to the accessibility of a resource in various Vitesse projects. There are three types of resource scopes defined in Vitesse:

! Local ! Shared ! Global

Local Resources

Local resources are contained only in projects in which they are created or referenced. By default, all resources created or referenced within a project are local to that project.

Shared Resources

Shared resources are shared between groups of similar projects that reside in the same directory. For example, a department logo may be shared across all the projects of the department but not across the entire company. In this case, you can store the logo as a shared resource between the department projects to avoid storing it individually in every project.

Global Resources

Global resources are available to every project that you create in Vitesse. For example, a company logo assigned with a global scope is available across all the projects within a company. The purpose is to avoid storing the logo individually in every project.

Sharing resources saves storage space, ensures consistency, and simplifies maintenance. Any changes that you make in a resource assigned a shared or global scope is applied to all the projects that it is being referenced. We suggest that you keep the commonly used resources as either shared or global, whichever is applicable.

Resources with different scopes reside at different locations according to the Vitesse directory structure (explained in “Understanding the Vitesse Directory Structure” task below). Once you have defined the scope of a resource, you can manually place it at the required directory location.

Local resources take precedence over the shared and global resources. For example, if a resource referenced in a project is present in the local, shared, and global scope, the local resource will be used. Similarly, shared resources take precedence over global resources.

Understanding the Vitesse Directory Structure

Vitesse formats and composes documents using the Dynamic Document Composition model (DDC). DDC is based on real time composition of a document at the printer or the imaging device. In keeping with this model, the resources are often referenced in a design and do not form a part of the project file. The referenced resources (images, segments, and forms) are located and accessed from the different Vitesse directories, which are explained later in this section.

Vitesse follows the same folder structure used in VIPP for organizing the project files and the resources referenced in projects. The following image shows the basic structure of the Vitesse folders/directories:

76 Vitesse User Guide

The Vitesse directories are explained as follows:

Vitesse Folder

The main Vitesse directory is located at drive:\Program Files\Elixir Technologies\Vitesse, where drive is the Vitesse installation drive. The Vitesse folder

contains the application components (e.g. *.dll, *.ocx, *.exe files etc.); resource, client, and project folders as discussed below:

ClientsFolder

The Clients folder is located at drive:\Program Files\Elixir Technologies\Vitesse\Clients. Clients is the default working folder in which the

client folders associated with projects are created and maintained.

You can change the working folder by using the procedure explained in the “Setting up the Working Folder” section later in this chapter.

Client Folder

All Vitesse projects essentially relate to a client specified at the time of project creation. Vitesse maintains these clients as folders; each client folder further contains multiple project folders that consist of applications created in Native, Line, Database, and XML modes. A client folder helps maintain a set of projects that share common resources. Besides the project folders, a client folder also contains an fShared folder; all of the shared resources used within the projects are located in the fShared folder.

Whenever a new client folder is created, an fShared folder is automatically created within the client folder. New client folders can be created at the time of project creation. For more information, refer to

Section 4: Creating a VIPP Project

Vitesse creates a Default folder within the Clients folder that can be used as a default client when creating projects. The Default option is always available in the list of clients whenever you create a new project. You can also create and maintain your own client folders for different projects. In the image above, MyProjects is a custom client folder that contains the project folders.

Project Folder

When you create a project, Vitesse automatically makes a project folder in the specified client directory. The name of the project folder is identical to the name specified at the time of project creation. For example, in the image, NewLineMode is the project folder created in the MyProjects client directory. The resources created or referenced within this project are local and also located in the same project folder.

Chapter 3: Understanding the Vitesse Directory Structure 77

Data Files

In the Data Files folder, you can place the actual data files used in the print production process.

Config

The Config folder contains the Vitesse configuration files and the sample data files for projects.

xgf

The xgf folder contains the predefined sample VIPP applications that you can import in Vitesse.

FormLib

The stand-alone form resources are created in the FormLib directory by default . In this directory, you can also place the form resources that are shared globally among projects located within different client folders.

ImgLib

In the ImgLib directory, you can place the image resources that are shared globally among projects located within different client folders.

SegLib

The stand-alone segment resources are created in the SegLib directory by default. In this directory you can also place the segment resources that are shared globally among projects located within different client folders.

MisLib

In the MisLib directory, you can maintain miscellaneous resources that are accessed globally by projects.

The FormLib, ImgLib, SegLib, and MisLib directories are also referred to as the global resource libraries.

78 Vitesse User Guide

Setting up the Working Folder

Clients folder is the default working directory in which all of the Vitesse projects are created. You can also create and save your projects at different locations other than the default working folder.

To set up the working folder:

1 Select Tools>Preferences from the menu bar to open the Preferences dialog. 2 From the Preferences dialog, select the General category to view the

associated options.

3 Specify the required directory path in the Working Folder entry box. You

can also click Browse for Folder dialog to specify the location.

adjacent to the Working Folder entry box to open the

4 In the Browse for Folder dialog, browse and select the required directory. 5 Click OK to return to the Preferences dialog.

The full path of the specified directory displays in the Working Folder entry box.

6 Click OK.

Projects will now be created at the specified working directory.

You can also open an existing project from any other location on the system. Selecting File>Save from the menu bar saves the existing project in the specified working folder.

Using Scope Specific View in the Project Tree

Vitesse lets you view the project tree and the project resources on the basis of their resource scope. The view is created depending on the locations from where the resources are being accessed in a design. For example, if a project uses a form that is located in the FormLib directory, the form is displayed as a global resource. Similarly, if you use the fShared directory for referencing a form, it is displayed as a shared resource.

To view the project resources based on the resource scope, select View>Project Tree>Scope Specific View from the menu bar.

Chapter 3: Understanding the Vitesse Directory Structure 79

Image shows the steps involved in setting the scope specific view.

In the scope specific view, the following three nodes identifying the three sco pes are displayed under the Resources node:

! Local – contains the resources that are accessed from the project folder itself. ! Shared – contains the resources that are accessed from the fShared folder of the

respective client directory.

! Global – contains the resources that are accessed from the global resource

libraries.

You can toggle between the two views through this menu item. By default, all of the resources in the project are displayed without their scope specific view and classified according to their types such as forms, segments, fonts, and images.

You can also turn the scope specific view on or off by right-clicking in the project tree and selecting Tree>Scope Specific Resource from the pop up menu.

When a resource is created or inserted in a project, it is assigned a local scope by default. To change the scope of a resource after it has been created, you have to manually cut the resource from its current location and paste in the required folder.

80 Vitesse User Guide

Opening Vitesse Projects in Scope Specific View

To turn on the scope specific view of resources whenever a Vitesse project is opened:

1 Select Tools>Preferences from the menu bar to open the Preferences dialog. 2 From the Preferences dialog, select the Tree View category under the

Workspace node to view the associated options.

3 Select the Scope specific resource view option. 4 Click OK.

Setting Default Folder Preferences

When you import a VIPP project in the Vitesse environment, the resources referenced within the VIPP project are also imported. However, the VIPP source code includes only the resource name(s) of the referenced resource(s) and does not provide the full path where the resource is located. Therefore, prior to importing a VIPP project in Vitesse, you need to define a list of directories/folders for the required resources so that Vitesse locates the resources referenced in the imported project at the specified paths. These directories are also used as default paths for the resources.

The Folder category in the Preferences dialog provides options for specifying the directories. This category consists of the different resource types that may have been used in an imported VIPP project. The resource types are identified by their respective sub-categories under the Folder node in the Preferences dialog and explained below:

! Form – lists the paths of the form resources used in a VIPP project. VIPP

projects use VIPP forms with the *.frm extension.

! Segment – lists the paths of the segment resources used in a VIPP project. VIPP

projects use VIPP segments with the *.seg extension.

! Image – lists the paths of the image resources used in a VIPP project.

For more information on forms, segments, and images, refer to

2: Using VIPP Resources

! JDT – lists the paths of the JDT resources used in a VIPP project. A JDT (Job

Descriptor Ticket) resource is a file that controls the page composition of a print job in a VIPP project. These files have*.jdt as their extension.

! Project – lists the paths of the VIPP project files. A VIPP Project File contains

all of the information needed for a single project and is saved as a *.vpf file.

! Encoding – lists the paths of font encoding files used in a VIPP project. ! Misc – lists the paths of any miscellaneous resources used in a VIPP project

other than those mentioned above.

Chapter 3: Understanding the Vitesse Directory Structure 81

in this guide.

Section

For each resource type, you can add new folders, delete existing folders, and reorder the folders. The process for managing the folders is exactly the same for all of the resource types, as mentioned in the following tasks.

Adding a Directory

To add a new directory for a resource:

1 Select Tools>Preferences from the menu bar to open the Preferences dialog. 2 From the Preferences dialog, select the category for the required resource

under the Folders node. The associated directory list displays the list of available folders.

3 Click to add a row for specifying a new directory in the list. 4 Click in the newly added row to open the Browse for Folder dialog.

5 In the Browse for Folder dialog, browse and select the required folder. 6 Click OK to return to the Preferences dialog.

The full path of the specified folder displays in the newly added row.

7 Click OK to add the specified folder to the list.

Image showing the steps involved in adding a new directory to the Form category. Adding a directory to the remaining categories will follow the same procedure.

82 Vitesse User Guide

Deleting a Directory

To delete a selected directory from the list:

1 Select Tools>Preferences from the menu bar to open the Preferences dialog. 2 From the Preferences dialog, select the required resource category under the

Folders node.

3 Select the required directory, and then click .

Rearranging the Directory List

You can also reorder the directory list for a resource type. Vitesse looks for the required resources starting from the first location specified in the list. If the resource is not found, it moves down to the next location in the list, and so on. We recommend keeping the folders that are more likely to contain the required resources at the top of the list. This will help in locating the resources quickly.

To reorder the list of directories:

1 Select Tools>Preferences from the menu bar to open the Preferences dialog. 2 From the Preferences dialog, select the required resource category under the

Folders node.

3 Select the directory to be moved. 4 As appropriate, click to move the selected folder up one level in the list

or click

to move the selected folder down one level in the list.

5 Click OK.

Chapter 3: Understanding the Vitesse Directory Structure 83

User Notes:

84 Vitesse User Guide

Section II: Using VIPP Resources

User Notes:

86 Vitesse User Guide

Chapter 4: Working with Forms

This chapter provides information on the form resource and explains tasks for:

! Using a Form ! Setting Form Properties ! Caching Resources

Using a Form

A form is a single page resource that is designed using static objects such as images, segments, composed text data, charts, barcodes, tables, lines, paths, polygons, and boxes. A form is used as a background overlay in different applications. For variable data documents, the overlay is merged with the variable data for the final output. You can insert forms to the Front and Back sides of a Paper or to Page objects, depending upon the design requirements. Vitesse enables you to create forms in the Elixir Vitesse Format (*.evf). You can insert linked, embedded, inline, and referenced forms in Vitesse, and set or change the form properties. You can also import VIPP Forms (*.frm) to a Vitesse project.

Refer to forms in designs. For more information on importing VIPP forms, refer to

Chapter 31: Using Forms in Projects

Chapter 35: Importing and Exporting Projects

for details on inserting

Creating a New Form

To create a new form:

1 Select File>New from the menu bar to open the New Project dialog.

You can also open the

! Clicking on the Standard toolbar.

! Pressing <Ctrl>+<N> on the keyboard.

2 From the New tab, select the Form icon , and then click New.

The Form dialog is displayed with the General tab selected.

New Project

dialog either by:

3 In the General tab, set the following form specifications under the Project

area: ! Name – specifies a unique name identifying the form. The name can be 30

characters in length and can include alphanumeric characters.

! Path – displays the path of the default form folder. By default, the form is

saved in drive:\Program Files\Elixir Technologies\Vitesse\FormLib\. You can also click

to browse and select the required location using the Browse

for Folder dialog.

Client directories contain applications created in Native, Line, Database, and XML modes. As forms are stand-alone resources used as backgrounds in different designs, they are not associated with client directories. Therefore, the Client drop-down list remains disabled. For more information on client directories, refer to

Understanding the Vitesse Directory Structure

Chapter 03:

4 Click OK.

The new form resource is created and the corresponding form node is created under the Resources>Forms node in the project tree.

Image showing the steps for creating a new form.

The root node in the project tree represents the project title, which in this case, is the form name itself. The project title node identifies the form as a stand-alone resource or project. No properties are associated with this node.

88 Vitesse User Guide

The project tree displaying the newly created form node.

You can design the newly created form using the drawing tools and other objects. Segments, fonts/font styles, and images can also be added to a form.

Setting Form Properties

Once a form resource is created, you can set the associated form properties. When setting the form properties, you should keep in view the final project design which the form will be used. For example, if the form is to be inserted on a page with the A4 standard size, then the recommended form size is A4 as well.

Setting the Form Size

To set the form size:

1 Select the required form node from the project tree. 2 From the Property View window, select the General tab. 3 Select the required form size option from the Standard drop-down list.

The W and H entry boxes display the width and height of the fo rm resource.

4 To set a form size other than the predefined values, select the Custom option

from the Standard drop-down list. This option enables the W and H entry boxes.

You can also set the unit of measurement for the form size by right clicking the upward or downward arrows in the W and H entry boxes, and then selecting Units>

Chapter 4: Working with Forms 89

unit name

from the pop-up menu.

5 Enter the required custom form width and height, and then click OK.

The specified size is applied to the form.

The image shows the process of setting the custom form size.

Setting the Form Orientation

Form orientation defines the layout position of a form for printing. Vitesse supports four orientation options discussed below.

To set the form orientation:

1 Select the required form node from the project tree. 2 From the Property View window, select the General tab. 3 From the Orientation drop-down list, select one of the following orientation

options: ! Portrait – sets orientation to portrait; a vertical print orientation in which a

page is printed across the narrower dimension of a paper, i.e., the height of the page is greater than the width.

! Landscape – sets orientation to landscape; a horizontal print orientation in

which a page is printed sideways, i.e., the width of the page is greater than the height.

! Inverse Portrait – sets orientation to inverse portrait; this orientation is

obtained by rotating a portrait pape r by 18 0 d e grees.

! Inverse Landscape – sets orientation to inverse landscape; this orientation is

obtained by rotating a portrait paper 9 0 deg rees clockwise.

4 Click OK.

The selected form displays with the specified orientation.

90 Vitesse User Guide

The two settings, Inverse Landscape and Inverse Portrait, do not reflect in the design area until you insert the form in a page. For information on inserting forms in a design, refer to

Projects.

Chapter 31: Using Forms in

Specifying Form Details

You can view or specify the form identification information including the form title, short description about the form, form creator and generator name, copyright details, version number, creation and modification dates in the Property View window.

The information that you specify in the Properties tab is displayed as comments in the generated VIPP project source code.

To specify the form details:

1 Select the required form node from the project tree. 2 From the Property View window, select the Properties tab. This tab contains

the project information that is organized as a Key (item) and Value pair.

3 Double-click any cell under the Key and Value columns to enter the form

details.

You cannot modify the Copyright and Version information.

4 To add a new key-value pair abo ve or below a selected row, click in the

Properties tab.

5 Enter the additional information as required in the newly added key and value

pair.

You can also delete a selected key-value pair by selecting the required

row, and then clicking in the Properties tab.

Chapter 4: Working with Forms 91

The image shows the process of specifying form details.

92 Vitesse User Guide

Caching Resources

In a typical printing process, the resources used in a document are loaded to the printer memory, and then printed. In some cases, a document may include heavy resources that are used repetitively. Loading such heavy resources to the printer memory each time they occur in the project design makes the printing process cumbersome.

To overcome this issue and maintain the efficiency of the printing process, Vitesse offers the resource-caching feature. This feature enables you to store and retrieve certain resources from the printer cache. Once a resource is available in the cache, the printer does not load it from the system memory. This eliminates the surplus loading time and therefore, makes the printing process efficient. Vitesse allows you to specify the caching option explicitly for the form, segment, and image resources.

We recommend using the cache option only for the frequently used heavy resources. Caching too many resources unnecessarily may overload the printer cache.

Caching a Form

To enable resource caching for a form resource, select the Cache option from the General tab of the Property View window. Selecting this optio n d oes n o t have any

effect on the interface. It only enables you to load and retrieve forms from the printer cache while printing.

Chapter 4: Working with Forms 93

User Notes:

94 Vitesse User Guide

Chapter 5: Working with Segments

This chapter provides information on using the segment resource and provides tasks for:

! Creating a New Segment ! Setting Segment Properties ! Caching a Segment ! Dynamic Behavior of Segments ! Working with Postscript Segments

Using a Segment

A segment is a VIPP Native mode or PostScript resource that can be reused in different locations in a document and/or a form. Vitesse enables you to create segment files in the Elixir Vitesse Segment (*.evs) format. A Vitesse segment is designed using static objects such as images, composed text data, charts, and barcodes. Drawing objects, such as lines, paths, polygons, and boxes are also used.

You can import PostScript forms, Encapsulated PostScript files (EPS), or PS format files as segments in Vitesse, using the Insert Segment option from the menu bar or the Insert toolbar. These files can be inserted as segments, but cannot be edited in Vitesse (*.ps, *.eps, *.prn) . Vitesse also lets you import VIPP Segments (*.seg) in the Vitesse design. A segment can be referenced several times in a page.

One difference between forms and segments is that segments can be rotated and resized within a form or a document.

You can insert linked, embedded, inline, referenced, begin page, end page, and repeat segments in Vitesse designs, and set or change the segment properties.

Refer to segments in designs. For more information on importing VIPP segments, refer to

Chapter 32: Using Segments in Projects

Chapter 35: Importing and Exporting Projects

for details on inserting

Creating a New Segment

To create a new segment:

1 Select File>New from the menu bar to open the New Project dialog.

You can also open the

New Project

dialog either by:

! Clicking on the Standard toolbar.

! Pressing <Ctrl>+<N> on the keyboard.

2 From the New tab, select the Segment icon , and then click New.

The Segment dialog is displayed with the General tab selected.

3 In the General tab, set the following form specifications under the Project

area: ! Name – specifies a unique name identifying the segment. The name can be

30 characters in length and can include alphanumeric characters.

! Path – displays the path of the default form folder. By default, the segment

is saved in drive:\Program Files\Elixir Technologies\Vitesse\SegLib\. You can also click

for Folder dialog.

Client directories contain applications created in Native, Line, Database, and XML modes. As segments are stand-alone Vitesse resources used in page designs, they are not associated with client directories. Therefore, the Client drop-down list remains disabled. For more information on client directories, refer to

Understanding the Vitesse Directory Structure

to browse and select the required location using the Browse

Chapter 03:

4 Click OK.

The new segment resource is created and a corresponding segment node is created under the Resources>Segments node in the project tree.

The root node in the project tree represents the project title, which in this case is the segment name itself. The project title node identifies the segment as a stand-alone resource or project. No properties are associated with this node.

96 Vitesse User Guide

The project tree displaying the newly created segment node.

You can design the newly created segment using the drawing tools and other objects. Fonts/font styles and images can also be added to a segment.

Setting Segment Properties

Once a segment resource is created, you can set the associated segment properties. The specified properties reflect in the project design whenever the segment is referenced.

PostScript segments cannot be edited in the Vitesse environment and therefore, the properties associated with them are different, as explained in “Working with PostScript Segments” section later in this chapter.

Setting the Segment Size

To set the segment size:

1 Select the required segment node under the Resources>Segments node from

the project tree.

2 From the Property View window, select the General tab. 3 In the Size area, enter the required segment width and height in the W and H

entry boxes. The specified size is applied to the segment.

You can also set the unit of measurement for the segment size by right clicking in the W and H entry boxes, and then selecting Units> from the pop-up menu.

Chapter 5: Working with Segments 97

unit name

To increase or decrease the segment size in equal proportion, click in the Size area. The following image shows how to resize a segment in equal proportion.

Setting the Segment Origin

Objects are positioned in the design area with respect to an origin. The point of origin is defined by the two coordinates (x, y). In the Vitesse design environment, origin is the top left corner of the design area. The value is set to (0, 0) by default for all project designs.

1) Property View window - Settings tab for a segment resource specifying the origin set to (0, 0) by default, 2) Design area ruler displaying the origin set to (0,

0) and an image placed at (0.5, 0.5) w.r.t. the origin.

98 Vitesse User Guide

Xerox Elixir Vitesse User Guide

Specifications and Main Features

Frequently Asked Questions

User Manual

Who Should Use this Guide?

About This Guide

Conventions

Display Conventions

Typographic Conventions

Symbols Used in This Guide

Getting the Answers You Need

Customer Support

Elixir Website Support

Elixir Training

Using Help

Related Guides

Vitesse Overview

Before You Start

Creating a Preliminary Project

Defining and Locating Test Data

Understanding the VIPP Modes

What is Native Mode?

What is Line Mode?

What is Database Mode?

What is XML Mode?

Form and Segment Behavior

Frame Behavior

Restricted Mode Operation

Predefined Media and Fields

Batch Conversion of Documents

Getting Familiar with the Workspace

Using the Design Area

Design View

Source View

Using the Project Tree View Window

Media

MasterDoc

Resources

Using the Property View Window

Using the Data View Window

Using the Message View Window

Clearing Messages

Saving Messages

Setting the Default View Options

Arranging the Workspace Windows

Using Workspace Tools

Using the Menu Bar

Using the Toolbar

Viewing the Status Bar

Placing Objects in the Design Area

Using the Ruler

Displaying and Hiding the Ruler

Setting the Default Ruler Option

Changing the Unit of Measurement

Using the Grid

Displaying and Hiding the Grid

Setting the Default Grid Option

Automatically Aligning Objects to the Grid

Setting the Default Snap to Grids Option

Setting the Grid Color

Setting the Grid Style

Setting the Grid Spacing

Using Guides

Turning the Guides On and Off

Setting the Default Guide Option

Moving Guides to the Design Area

Removing Guides from the Design Area

Automatically Aligning Objects to the Guides

Setting the Default Snap to Guides Option

Setting the Guide Color

Setting the Guide Style

Using the Crosshair

Displaying and Hiding the Crosshair

Setting the Default Crosshair Option

Moving Objects using the Keyboard

Setting the Nudge Options

Zooming within the Design Area

Specifying Custom Zoom Value

Moving the Design Area View

Using the Full Screen View