advertisement
▼
Scroll to page 2
of 426
DesignPro Tools Manager for AFP User Guide Elixir Technologies Corporation 721 East Main Street Ventura, CA 93003 Copyright ©2006 by Elixir Technologies Corporation. All rights reserved. DP200608V200 To report any errors you might find, please send a note to [email protected]. Please note: emails are used to correct future versions of this guide and may not receive an individual reply. For technical support, please see "Customer Support" on page 22. 2 DesignPro Manager for AFP User Guide Contents Chapter 1: Introduction 13 DesignPro Manager Overview.............................................................13 Supported File Formats........................................................................14 Overlay Formats ........................................................................................ 14 Font Formats.............................................................................................. 15 Image Formats ........................................................................................... 15 Document Formats .................................................................................... 16 Associated DesignPro Modules ...........................................................17 About this User Guide .........................................................................17 Who Should Use this Guide?..................................................................... 19 Related Guides........................................................................................... 19 Conventions .........................................................................................19 Typographic Conventions.......................................................................... 20 Symbolic Conventions............................................................................... 21 Getting the Answers You Need ...........................................................22 Customer Support ...................................................................................... 22 Elixir Web Site Support............................................................................. 23 Elixir Training ........................................................................................... 23 Product Help .............................................................................................. 23 Chapter 2: DesignPro Manager Environment 25 Understanding the Workspace................................................................... 25 Navigation window ..........................................................................................26 Resources Window ...........................................................................................27 Explorer Window..............................................................................................27 Details Pane ......................................................................................................28 Messages Window ............................................................................................28 Working with Messages Window .....................................................................28 Status Bar..........................................................................................................29 Using the Workspace Tools....................................................................... 29 Menu bar and Toolbars .....................................................................................29 Navigating the Workspace................................................................................30 Keyboard Shortcuts .................................................................................. 31 Contents 3 Chapter 3: DesignPro Manager Basics 33 Browsing the Workspace.....................................................................33 Working with Folders..........................................................................35 Defining Virtual and Physical Folders ..................................................... 35 Locating Virtual and Physical Folders ..................................................... 36 Using Virtual Folders ............................................................................... 36 Documents Folder ............................................................................................ 37 Fonts Folder ..................................................................................................... 37 Forms Folder .................................................................................................... 38 Graphics Folder................................................................................................ 39 Jobs Folder ....................................................................................................... 39 Creating a New Physical Folder....................................................................... 40 Mapping a Physical Folder to a Virtual Folder ................................................ 40 Moving Files Across Virtual and Physical Folders.......................................... 41 Unmapping Virtual Folders.............................................................................. 41 Deleting a Physical Folder ............................................................................... 41 Creating Application Shortcuts ...........................................................42 Creating a Shortcut........................................................................................... 42 Creating a Shortcut to Elixir Website .............................................................. 46 Deleting a Shortcut........................................................................................... 47 Chapter 4: Customizing DesignPro Manager 49 Changing Application Default Options ...............................................49 Setting General Parameters ...................................................................... 50 Setting Conversion Parameters.................................................................. 50 Setting Symbols Properties........................................................................ 50 Setting Message Preferences ..................................................................... 52 Logging Messages............................................................................................ 53 Viewing Parser and Converter Properties ...........................................54 Changing Resource Extensions ....................................................................... 55 Chapter 5: Using Converters 57 Converting Files to Different Formats.................................................57 File Types Supported by Converters ......................................................... 58 Input Formats ................................................................................................... 58 Output Formats ................................................................................................ 60 File Conversion Process ............................................................................ 61 Identify, Prepare, and Stage the Resources ...................................................... 61 AFP Resources................................................................................................. 61 4 DesignPro Manager for AFP User Guide Understanding Setup Files......................................................................... 63 Choosing a Setup (.EPM) File..........................................................................63 Loading a Setup File.........................................................................................63 Setting up the Conversion.......................................................................... 64 Selecting Resource Files in Manager ...............................................................64 Changing Input Format Properties ..................................................................66 Changing Output Format Properties.................................................................67 Start the Conversion .........................................................................................69 Saving a Setup (.EPM) File ....................................................................... 70 Resetting Customized Conversion Settings to Default............................. 70 Working with Windows Fonts .................................................................. 71 Registering Windows Fonts for Conversion.....................................................71 Chapter 6: File Format Dictionary 73 DesignPro Tools Formats ....................................................................73 Setting Parser Parameters ....................................................................75 Setting AFPDS Parser Parameters............................................................. 75 General .............................................................................................................76 Paper .................................................................................................................77 Fonts .................................................................................................................78 FormDef ...........................................................................................................80 Synthesizer .......................................................................................................81 Resources..........................................................................................................88 Setting Resource Paths .....................................................................................88 Setting OGL Parser Parameters................................................................. 89 General .............................................................................................................90 Prefix ................................................................................................................90 Font...................................................................................................................91 Synthesizer .......................................................................................................92 Resources..........................................................................................................92 Setting PCL Parser Parameters.................................................................. 93 Shading .............................................................................................................94 Page ..................................................................................................................94 Synthesizer .......................................................................................................94 Setting ElixirGDF Parser Parameters ........................................................ 95 Main..................................................................................................................96 Resources..........................................................................................................96 Tags...................................................................................................................97 Synthesizer .......................................................................................................98 Contents 5 Setting ElxirPDW Parser Parameters ........................................................ 99 Page................................................................................................................ 100 General ........................................................................................................... 101 Synthesizer ..................................................................................................... 101 Setting WindowsEMF Parser Parameters ............................................... 102 Page................................................................................................................ 103 General ........................................................................................................... 103 Synthesizer ..................................................................................................... 103 Setting PPFA Parser Parameters ............................................................. 104 General ........................................................................................................... 105 Prefix.............................................................................................................. 106 Font ................................................................................................................ 107 Encoding ........................................................................................................ 108 Error Handling ............................................................................................... 110 Setting Converter Parameters ............................................................111 Setting AFPDS Converter Parameters..................................................... 112 Main ............................................................................................................... 113 Colors ............................................................................................................. 114 Fonts............................................................................................................... 116 Images ............................................................................................................ 118 Forms ............................................................................................................. 119 Code Pages..................................................................................................... 120 Formdef.......................................................................................................... 122 Pagedef........................................................................................................... 124 Page Objects................................................................................................... 126 Setting OGL Converter Parameters......................................................... 127 General ........................................................................................................... 128 Form ............................................................................................................... 130 Font ................................................................................................................ 131 Color............................................................................................................... 133 Environment................................................................................................... 134 Setting PostScript Converter Parameters................................................. 135 Printer Properties............................................................................................ 137 Error Handling ............................................................................................... 139 Setting PCL Converter Parameters.......................................................... 140 Main ............................................................................................................... 141 Images ............................................................................................................ 143 Fonts............................................................................................................... 145 Paper............................................................................................................... 146 Page................................................................................................................ 147 Error Handling ............................................................................................... 148 6 DesignPro Manager for AFP User Guide Simplifier ........................................................................................................148 Setting PDF Converter Parameters.......................................................... 166 Main ...............................................................................................................167 Encryption .....................................................................................................169 Active Objects ................................................................................................170 Setting Raster image output in TIFF/BMP format .................................. 172 Output Formats ...............................................................................................173 Drawing Options ............................................................................................174 Image ..............................................................................................................175 Setting ElxirGDF Converter Parameters ................................................. 177 Main................................................................................................................178 Images.............................................................................................................179 Fonts ...............................................................................................................180 Setting Elixir Form Converter Parameters .............................................. 182 Resources........................................................................................................183 Fonts ...............................................................................................................183 Setting PPFA Converter Parameters........................................................ 184 General ...........................................................................................................185 Font.................................................................................................................186 FormDef .........................................................................................................187 PageDef ..........................................................................................................189 Encoding.........................................................................................................190 Working with Elixir Properties................................................................ 192 Elixir Properties Definitions.................................................................... 193 Resources........................................................................................................194 Resource Library ............................................................................................195 Caching...........................................................................................................196 Chapter 7: File Transfers 197 PC-to-z/OS (MVS) Host File Transfer ..............................................197 Downloading Files................................................................................... 198 Downloading Object files ..............................................................................198 Downloading Source files ..............................................................................199 Working with Overlay and MO:DCA Document files...................................200 Working with Fonts .......................................................................................200 Input Directory Information ...........................................................................201 Uploading Files........................................................................................ 202 Uploading Object-Format AFP Files..............................................................202 Uploading Text Files ......................................................................................203 Contents 7 PC-to-IBM z/VSE Host File Transfer ...............................................204 Downloading Files................................................................................... 204 Downloading Object files ............................................................................. 204 Uploading Files ....................................................................................... 205 Uploading Object Files .................................................................................. 205 PC-to-IBM iSeries (AS/400) File Transfer ......................................206 Transferring PC-to-IBM AS/400 File .................................................... 206 Creating a Temporary Holding Library and File on the AS/400 ................... 207 Installing the Resources in the AFP Libraries ............................................... 208 Printing Fully Composed AFPDS Documents .............................................. 209 Extracting Object Files from the AS/400 to a PC .........................................................................................209 Chapter 8: Stand-Alone Utilities 211 Using the Utilities..............................................................................211 Running Windows-Based Utilities................................................................. 211 Running DOS-Based Utilities........................................................................ 211 Supplied Utilities ..............................................................................212 Tools and Utilities ................................................................................... 212 Product Registration – Password.exe............................................................. 213 Display Password File – Disppw.exe............................................................. 213 Display Key – Showbd32.exe........................................................................ 213 Display PC Serial Number – Showpc.exe ..................................................... 214 Update Key – UPDKEY.exe .......................................................................... 214 AfpdsTree – AFPDSTREEU.EXE................................................................. 215 Opening a File in AfpdsTree.......................................................................... 215 Navigating in AfpdsTree................................................................................ 216 Additional Utilities ............................................................................217 AFPVIEW.EXE Overview...................................................................... 217 AU.EXE Overview.................................................................................. 219 DOSVSE Overview................................................................................. 221 DTAFP Overview.................................................................................... 223 Converting Elixir Legacy Form Files to Normalized AFPDS ................ 223 Saving Forms to Elixir Format ...................................................................... 223 Creating a DAT File ....................................................................................... 224 Running the Conversion................................................................................. 224 Converting DAT Files to Normalized AFPDS using the Command Prompt ................................................................... 225 Accessing the DTAFP Utility using the DesignPro Manager........................ 226 Converting DAT Files to Normalized AFPDS............................................... 227 8 DesignPro Manager for AFP User Guide Working with DTAFP ............................................................................. 228 Specifying a Form List Directory...................................................................228 Specifying a Form Directory ..........................................................................229 Specifying a Fonts Directory..........................................................................229 Justifying the Text ..........................................................................................229 Specifying an External Tag Attribute File......................................................230 Default Tag Settings .......................................................................................230 Setting a Work File Directory.........................................................................231 Setting the Printer Resolution.........................................................................231 Specifying an Output Format .........................................................................232 Setting Font Type............................................................................................232 Setting AFP Form Format ..............................................................................232 Setting Page Rotation .....................................................................................232 Specifying an ASCII to EBCDIC Table Name ..............................................233 Specifying the Last Page Bottom ..................................................................233 Saving Setup Options .....................................................................................233 Editing File Options................................................................................. 234 Editing a Form List.........................................................................................234 Creating a New DAT File ...............................................................................234 Editing a DAT File..........................................................................................235 Editing a Tag Form List..................................................................................236 Selecting a Tag File ........................................................................................236 Printing Tags...................................................................................................237 MakePub Overview ................................................................................ 237 Listing Files ....................................................................................................240 Extracting Files...............................................................................................240 ElX2VSE Overview ................................................................................ 241 Using ELX2VSE ............................................................................................242 Elixir CodePage Builder Overview ......................................................... 243 Launching Elixir Code Page Builder Utility ..................................................243 Setting Elixir Code Page Utility Modes .................................................. 243 Working in Normal Mode ....................................................................... 244 Loading a Code Page......................................................................................244 Setting Properties of a Code Point..................................................................246 Mapping a Code Point ....................................................................................247 Saving the Code Page .....................................................................................248 Creating a New Code Page ............................................................................248 Properties of a Code Page...............................................................................249 Working in AFP Mode ............................................................................ 250 Selecting a Template Code Page ....................................................................250 Exporting the Code Page to Resource Map....................................................251 Contents 9 Customizing Elixir Code Page Builder ................................................... 252 Profile Selection............................................................................................. 253 ElixiTag Overview .................................................................................. 253 Starting ElixiTag ............................................................................................ 253 Working with ElixiTag................................................................................... 255 Saving a Tag File............................................................................................ 257 Editing an Existing Tag.................................................................................. 258 Adding a Tag .................................................................................................. 258 Deleting a Tag ................................................................................................ 259 Copying a Tag ................................................................................................ 259 Exiting ElixiTag ............................................................................................. 259 PDF plug-in ............................................................................................. 260 Using PDF Plug-In......................................................................................... 260 CharmapUpdt Overview.......................................................................... 262 Chapter 9: Elixir Profile Editor 263 Elixir Profile Editor Overview ..........................................................263 Elixir Profile Editor Workspace ............................................................. 265 Profile Window .............................................................................................. 265 Messages Window ......................................................................................... 277 Working with Elixir Profile Editor....................................................277 Creating Custom Profiles ........................................................................ 277 Adding a New Default Profile ....................................................................... 278 Adding a Derived Profile ............................................................................... 279 Cloning a Profile ............................................................................................ 279 Deleting a Profile ........................................................................................... 279 Changing Profile Properties .................................................................... 280 Adding a Profile Item..................................................................................... 280 Modifying a Profile Item................................................................................ 282 Deleting a Profile Item................................................................................... 283 Selecting a Pre-defined User Profile ...................................................... 283 Loading a New Profile in DesignPro Tools ............................................ 284 Customizing Elixir Profile Editor......................................................284 Profile Selection ...................................................................................... 285 Chapter 10: Elixir Viewer 287 About Elixir Viewer ..........................................................................287 Elixir Viewer Workspace ........................................................................ 288 Using Workspace Tools ......................................................................... 289 Menu bar and Toolbars ................................................................................. 289 10 DesignPro Manager for AFP User Guide Grid ................................................................................................................290 Ruler ..............................................................................................................290 Elixir Viewer Toolbars ............................................................................ 291 Standard Toolbar.............................................................................................291 Zoom Toolbar .................................................................................................292 Go Toolbar......................................................................................................292 Getting Ready to Use Viewer ................................................................. 293 Loading a Setup File.......................................................................................294 Modifying Setup File......................................................................................294 Unloading a Setup File ...................................................................................294 Viewing and Printing............................................................................... 295 Opening a File to View...................................................................................295 Handling Unrecognized Files .........................................................................295 Previewing a Document .................................................................................296 Printing a Document.......................................................................................296 Customizing Viewer ................................................................................ 297 Grid Category .................................................................................................297 Ruler Category................................................................................................298 Chapter 11: Command Line Converters 299 About DesignPro Tools Command Line Converter ..........................299 Using DPTCLCu.exe............................................................................... 300 Command Line Parameters ..................................................................... 300 Command Line Examples ....................................................................... 305 Specifying Parameters Directly on a Command Line ....................................305 Specifying Parameters in an Unstructured File ..............................................306 Specifying Parameters in a Structured File ....................................................307 Automating Command Line Converter with Scout ...........................309 Method 1.................................................................................................. 309 Set Up Scout (Method 1) ...............................................................................309 Method 2.................................................................................................. 310 Create the Command Line File.......................................................................310 Set up Scout (Method 2) ................................................................................310 Method 3.................................................................................................. 311 Set up Scout (Method 3) ................................................................................312 Elixir Property Parameters.................................................................313 Input Property Parameters .................................................................315 AFPDS Input Property Parameters.......................................................... 315 GDF/Elixir Form Input Property Parameters .......................................... 321 OGL Input Property Parameters .............................................................. 324 Contents 11 PCL Input Property Parameters............................................................... 326 PPFA Input Property Parameters............................................................. 327 ElixirPDW Input Property Parameters .................................................... 330 Output Property Parameters...............................................................331 AFPDS Output Property Parameters ....................................................... 331 GDF/Elixir Form Output Property Parameters........................................ 343 Image Output Property Parameters ......................................................... 349 OGL Output Property Parameters ........................................................... 356 PCL Output Property Parameters ............................................................ 361 PDF Output Property Parameters ............................................................ 367 PostScript Output Property Parameters ................................................... 373 PPFA Output Property Parameters.......................................................... 379 ElixirDoc Output Property Parameters.................................................... 387 Appendix A: Error and Warning Messages 389 Error and Warning Messages Handling.............................................389 Error Messages ........................................................................................ 390 Warning Messages................................................................................... 395 Appendix B: Converting Resources Using Converters 401 Converter Overview ..........................................................................401 Using the Converter................................................................................. 402 Creating a Coded Font ............................................................................ 402 Setting Output Conversion Parameters for Coded Font................................. 404 Creating a Page Segment......................................................................... 404 Setting Output Conversion Parameters for AFP Page Segments................... 405 Creating an AFP Format Overlay............................................................ 406 Setting Output Conversion Parameters for AFP Format Overlay.................. 407 12 Appendix C: Glossary 409 Index 413 DesignPro Manager for AFP User Guide Chapter 1: Introduction This guide provides both background and procedural information for using DesignPro Manager. 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 of the options and preferences described. Similarly, certain selections will require that some tasks be repeated, while other selections will allow you to omit tasks entirely. DesignPro Manager Overview DesignPro Manager is a Windows-based desktop program for launching and managing applications. The DesignPro Manager workspace provides a central location from where you can access the applications and utilities available within the DesignPro suite. DesignPro Manager also provides an Explorer view of all drives, incorporating standard MS-Windows functionality. The Explorer view in the Explorer window can be used to display all of the physical files and folders on your computer and network. The Elixir Resources view in the Resources window can be used to display files and folders in your computer according to resources types. This is done with the help of virtual folders. Additionally, DesignPro Manager has numerous productivity-enhancing features, including those that enable you to: Convert resources from one format to another. This is helpful while printing, when you need your resources in a single format. Link files to applications, thereby allowing you to start an application and load a file in one step. Establish shortcut icons for DOS or Windows-based applications for launching from DesignPro Manager. Helps you to directly access the contents of the physical folder using the virtual folder, providing easy access to resources in a very organized manner. 13 This guide describes all functions and features of the DesignPro Manager, therefore certain options described may not apply to your specific configurations. In such cases, unavailable options display in gray (disabled) on menus and dialog boxes, and some screens and icons may not display at all. Supported File Formats DesignPro Tools opens and saves overlays, fonts, and images in many supported formats. These formats are listed by resource type below: Overlay Formats 14 Input formats – the supported input formats for overlays are as follows: • AFP Overlay Object (*.ove, *.ovl; O1*) • AFP Overlay Source (OGL) (*.ogl) • Elixir Form (*.efr) • Elixir Legacy Forms (*.elx) • Elixir PrintDriver Forms (*.ep) • Windows EMF Files (*.emf) Output formats – the supported output formats for overlays are as follows: • AFP Overlay Object (*.ove; O1*) • AFP Overlay Source (OGL) (*.ogl) • Elixir Forms (*.efr) • Elixir Legacy Forms (*.elx) • PCL Page (*.pcl) • PDF Page (*.pdf) • PostScript (*.ps) • Image File (*.tif,*.lp3,*.img;*.seg) DesignPro Manager for AFP User Guide Font Formats Input formats – the supported input font formats are as follows: • AFP Character Set (C0*; C1*…) • AFP Coded Font (X0*; X1*…) • AFP Code Page (T1*) • Elixir Legacy Font (*. hdr) Includes Legacy and DesignPro Tools fonts; both use the same extension. • Elixir Legacy Coded Font (X0*.cdf; X1*.cdf…) • Elixir Legacy Code Page (*.cod) • PCL Font (*.flj; *.pcl) Output formats – the supported output font formats are listed below: • AFP Character Set (C0*; C1*…) • AFP Coded Font (X0*; X1*…) • AFP Code Page (T1*) • Elixir Legacy Font (*. hdr) • Elixir Legacy Coded Font (X0*.cdf; X1*.cdf…) • Elixir Legacy Code Page (*.cod) • PCL Font (*.flj; *.pcl) Image Formats Input formats (Open) – the supported input image formats are as follows: • AFP Page Segments (S1*) • BMP Files (*.bmp) • Elixir Legacy Graphics (*.lp3) Includes Legacy and DesignPro Tools images; both use the same extension • JPEG Files (*.jpg; *.jpe; *.jpeg) • PCX Files (*.pcx) • PNG File (*.png) • TIFF Files (*.tif) Chapter 1: Introduction 15 Output formats – the supported output image formats are listed below: • AFP Page Segment (S1*.seg) • Bitmap File (*.bmp) • Elixir Legacy Graphic (*.lp3) • Elixir Form (*.efr) • JPEG File (*.jpg; *.jpe; *.jpeg) • PCX File (*.pcx) • PNG File (*.png) • TIFF File (*.tif) The DesignPro Tools supports most of the standard encoding schemes for parsing Tiff images, such as CCITT G3 G4, JPEG etc. For output formats, the supported encoding schemes include PackBit, CCITT G3, and CCITT G4. For more information on TIFF properties, refer to Chapter 6: "File Format Dictionary". Document Formats Input formats – the supported input document formats are listed below: • AFP PageDef Object (P1*.*; P1*.obj) • AFP FormDef Object (F1*.*; F1*.obj) • AFP PPFA Source (*.src; *.pfa) • Elixir PageDef (*.epd) • Elixir FormDef (*.efd) • Elixir AppBuilder 4.xx (Document.dbf) In order to open an Elixir AppBuilder file, you must be on an AppBuilder version 4.10 or greater. If you are on a previous version, upgrading to AppBuilder 4.10 will allow you to open your AppBuilder files in DesignPro Visual PPFA. 16 Output formats – the supported output document formats are as follows: • AFP PageDef Object (P1*.obj) • AFP FormDef Object (F1*.obj) • AFP PPFA Source (*.src; *.pfa) • Elixir PageDef (*.epd) • Elixir FormDef (*.efd) DesignPro Manager for AFP User Guide Associated DesignPro Modules DesignPro Tools for AFP employs five integrated modules to provide advanced functionality for designing forms. Following are the DesignPro Tools for AFP modules: DesignPro Manager – a Windows-based desktop program for launching and managing applications. You can also convert resource files to and from multiple formats using the Converters application in the DesignPro Manager. DesignPro Visual PPFA – a combined form editing and application building tool for creating IBM PPFA PageDefs and FormDefs. DesignPro Form Editor – an advanced forms design tool used to create and edit forms for AFP printers. DesignPro Font Editor – a complete font design application used for creating and editing AFP raster fonts as well as elixir and PCL fonts. You can also open true type fonts in this editor. DesignPro Graphics Editor – a full service bitmap editor providing various transformations and commands for tiling graphics into raster fonts. About this User Guide The DesignPro Manager User Guide provides definitions and step-by-step instructions to help you use the DesignPro Manager efficiently for managing your resources and also provides the how-to instructions for basic resource conversions and property settings. The guide is organized to mimic the resource management and conversion process for resources such as forms, fonts, document. Each chapter describes tasks in the same order you can use while working with multiple resources: Chapter 1: Introduction, provides an overview of DesignPro Manager, and its associated functions and features. It also specifies the supported input and output file formats for DesignPro applications. Chapter 2: DesignPro Manager Environment, provides information on DesignPro Manager for the AFP environment, including the workspace tools and associated navigation operations. Chapter 3: DesignPro Manager Basics, describes the basic features of DesignPro Manager. It explains the use of system and virtual folders for managing different resources and how to create shortcuts for frequently used applications. Chapter 1: Introduction 17 Chapter 4: Customizing DesignPro Manager, provides information on customizing DesignPro Manager for AFP default options. The application default options can be changed to customize the DesignPro Manager’s workspace according to individual requirements. Chapter 5: Using Converters, explains how to convert resource files to different formats, including associated tasks for loading and saving setup (.epm) files and converting Windows fonts. Chapter 6: File Format Dictionary, identifies input format and output format converters supported by DesignPro Tools for AFP, and provides format property field definitions within associated categories. Chapter 7: File Transfers, describes how to transfer files between your PC and host computer. It also explains how to configure host connections, specify font libraries, and download and upload files for subsequent processing. Chapter 8: Stand-Alone Utilities, describes tools that allow you to access Windows and DOS-based utilities. Chapter 9: Elixir Profile Editor, explains the Elixir Profile Editor workspace, its customization options, and tasks for creating new user profiles. Chapter 10: Elixir Viewer, provides an overview of the functions and features of Viewer. Chapter 11: Command Line Converters, describes command line parameters and methods for setting up and running the DesignPro Tools for AFP Command Line Converter, and automating the Converter using Elixir Scout Manager. Appendix A: Error and Warning Messages, provides a list of error and warning messages that can be encountered while performing varying DesignPro Manager for AFP and Converters operations, along with explanations for each occurrence. Appendix B: Converting Resources Using Converters, explains how to convert Elixir Legacy resources to AFP resource files using Converters in the DesignPro Manager. Appendix C: Glossary, provides DesignPro Manager concepts and terms.. 18 DesignPro Manager for AFP User Guide Who Should Use this Guide? This guide assumes you are already familiar with Microsoft Windows operations, printer and font management operations and PC peripherals. You should also have access to reference manuals for PC software and hardware, including any printers you are using for the design and print process. Related Guides If you require further information about a specific topic or wish to obtain product background information, reference the following resources, all of which are part of the DesignPro Tools for AFP documentation package. DesignPro Tools for AFP Getting Started Guide. DesignPro Visual PPFA User Guide. DesignPro Form Editor for AFP User Guide. DesignPro Font Editor for AFP User Guide. DesignPro Graphics Editor for AFP User Guide. Conventions Elixir products adhere to Microsoft Windows conventions for using menus, menu commands, dialogs, command buttons, icons and mouse. See your Windows manual for more information. This guide uses the following typographic and symbolic conventions to identify special information. Chapter 1: Introduction 19 Typographic Conventions This guide uses the following typographic conventions to identify special information. Convention Information Type/Example < > (angle brackets), Keystrokes <Shift> + <F1>. Example: <Enter> Key combinations are denoted by a plus sign between keys. Example: <Shift> + <F1>. Bold type Italic type Quotation marks 20 Field names within an explanation. Example: Use rules set by selected Start on option. Dialog areas referenced in tasks. Example: Select an item from the List of used Fonts. Click the Options tab. Tool names referenced in dialogs/windows. Example: Make sure the Text tool is selected. Button names with text written on them. Example: Click OK to save settings. Any text that you must type. Example: Enter LPT1 for the following option. References to other guides. Example: For more information, see “Chapter 6: File Format Dictionary” in DesignPro Manager for AFP User Guide. References to other chapters. Example: For more information, see "Managing Images" on page 25 in Chapter 3: "Graphics Editor Basics" Toolbar names. Example: Click any tool on the Drawing toolbar. Window names. Example: Message window displays. File paths and directories. Example: drive:\Elixir\Fonts\Elixir. Captions. References to tasks, activities, or concepts. Example: For more information, see “Using Colors” in Chapter 5: “Editing Images”. DesignPro Manager for AFP User Guide Symbolic Conventions Look for the following symbols as you read through this guide to identify special information. The Note symbol calls your attention to additional information. The Tip symbol highlights a helpful tip. The Shortcut symbol calls your attention to an easier way of accomplishing a task. The Warning symbol warns you of problems you might encounter. Chapter 1: Introduction 21 Getting the Answers You Need Elixir Technologies provides you with multiple ways to learn and use DesignPro Manager: "Customer Support" on page 22 "Elixir Web Site Support" on page 23 "Elixir Training" on page 23 "Product Help" on page 23 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. [email protected] Asia Pacific: [email protected] Europe: +44 (0) 207 993-4811 Monday - Friday, 6:00 am to 4:00 pm Central European Time +1 805 641 5900 ext. 3 Monday - Friday, 4:00 pm to 2:00 am Central European Time [email protected] An Elixir Product Specialist will take your call and ask for the following information: 22 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. DesignPro Manager for AFP User Guide Elixir Web Site Support You can obtain product support from the Elixir web page at www.elixir.com. Select Support to: Ask a question of Elixir Support. Find answers from a list of Frequently Asked Questions. Review the latest Tips and Techniques for increasing productivity. Download the latest Product Releases and Patches. View the latest product Release Notes. Access newsgroups to see how others are using Elixir products. Sign up for an Elixir Learning Program. Elixir Training Elixir Technologies offers training for its full-range of Windows-based products. For more information, contact: Elixir Learning +1 805 641 5900, ext. 4 Product Help Elixir software uses the Microsoft Windows Help program to provide online help for all product functions. This online tool includes step-by-step procedures that you can follow as you work. Context-Sensitive Help can be activated from within the software for dialogs by clicking in the upper-right corner of a dialog. You can also get this information by right-clicking the control and selecting What’s This? from pop-up menu or selecting a dialog control such as an input field, radio button, or drop-down list, and then pressing Shift + F1. Online Help can be opened by selecting Help>Contents from the menu. Chapter 1: Introduction 23 24 DesignPro Manager for AFP User Guide Chapter 2: DesignPro Manager Environment In this chapter... Understanding the Workspace Using the Workspace Tools Navigating the Workspace Keyboard Shortcuts This chapter provides information on DesignPro Manager for AFP environment, including the workspace tools and associated navigation operations. Understanding the Workspace When you start DesignPro Manager, the workspace and all associated components are displayed. The workspace provides a central location from where you can access the applications and utilities available within the DesignPro suite. DesignPro Manager also provides an Explorer view of all drives, incorporating standard MS-Windows functionality. The DesignPro Manager workspace comprises the following main components: Navigation window Resources window Explorer window Details pane Messages window Status bar 25 The DesignPro Manager components. Navigation window The Navigation window consists of the following three tabs that you can use for switching between different views: Applications Tools And Utilities My Shortcuts By default, the Navigation window is docked on the left side of the Applications window although you can move the window anywhere within the workspace. Applications Tab The Applications tab contains icons that you can click to launch the installed DesignPro Tools applications such as Visual PPFA, Form Editor, Font Editor, Graphics Editor, Converters, Elixir Scout Manager, and Elixir Viewer. To launch the Converters, drag and drop the required file(s) onto the Converters icon. For more information on using Converters, refer to "Converting Files to Different Formats" on page 57 in Chapter 5: "Using Converters". 26 DesignPro Manager for AFP User Guide Tools And Utilities Tab The Tools And Utilities tab contains icons that you can click to start the installed tools and utilities. My Shortcuts Tab My Shortcuts tab displays user-defined shortcut icons for different applications. You can launch the applications directly through the icons available on this pane; thus, saving time in having to locate the application.exe files. You can create shortcut icons for any application using the Shortcut wizard. You can choose to view large or small shortcut icons in the Navigation window. To change view options: 1 Select My Shortcuts tab. 2 Right-click in the window area. A popup menu is displayed. 3 Select View>Large icons to view large icons in My Shortcuts view. You can view small icons by selecting View>Small Icons. For more information on shortcuts, refer to "Creating Application Shortcuts" on page 42 in Chapter 3: "DesignPro Manager Basics". Resources Window The Resources window displays the Elixir resources virtual folders tree. Virtual folders are an abstract representation of the DesignPro Tools file folder structure. You can map the physical folder in the Explorer window to a folder in the Resources window. This is useful for organizing data by its specific type. You can map a physical folder to a virtual folder. This will display the mapped folder in the Resources window. For more information on virtual folders, refer to Chapter 3: "DesignPro Manager Basics". Explorer Window Explorer window displays a Windows explorer view of the system folders. You can perform all of the standard MS-Windows operations on the system folders in this window. Chapter 2: DesignPro Manager Environment 27 Details Pane The Details pane displays the contents of the virtual or system folders selected from the Elixir resources or Explorer window respectively. To view resources: 1 Select the required folder using the Explorer or Resources window. 2 The contents of the selected folder display in the Details window. 3 You can select the type of file you want to display from the Filter drop-down menu. This menu is enabled only when you select a virtual folder from the Resources window. For example, Select Forms>Elixir>Elixir1 from the Resources window. The contents of Elixir1 display in the Details window. You can select Elixir Form (*.hdr) or Elixir Legacy Form (*.elx) from the Filter drop-down list to display the associated resource files. Messages Window The Messages window is docked at the bottom of the workspace. You can change the position to any other window as required. The Messages window displays processing and compilation errors, warnings, and informational messages as generated by the application. For information on error messages and warnings, refer to Appendix A: "Error and Warning Messages". Working with Messages Window The options available in the Messages window include: 28 To clear messages in this window, press <Ctrl >+ <D> on the keyboard, or by selecting View>Clear Messages from the menu bar. To close the Messages window, press <Ctrl> + <Shift> + <M> on the keyboard or deselect the Messages option in the View menu. Closing the Messages window provides more space within which you can work. However, the window automatically redisplays whenever a message is generated by the application. To change the Messages window display settings to your preferences, go to Tools>Options and select the Messages category. You can also change the display settings by right clicking in the Messages window. DesignPro Manager for AFP User Guide Status Bar The status bar displays along the lower edge of the DesignPro Manager workspace. When you move the mouse pointer over a folder (and/or its contents) selected from the Explorer window, the status bar displays the number of contents in the folder, size of the selected folder, and the free space available on the hard drive. In addition, the status bar also displays the description associated with the menu bar and toolbar items, as shown in the figure below: Using the Workspace Tools DesignPro Manager toolbar provides easy access to the most commonly used application commands. You can perform standard Windows operations to hide or display toolbar, or dock a toolbar at the edge of the workspace. Menu bar and Toolbars The menu bar displays below the application title bar and contains the drop-down menu providing the standard MS-Windows operations along with the application-specific options. Selecting a menu performs an associated action or displays a submenu or a dialog. You can dock the menu bar anywhere in the Application window. Directly below the menu bar are toolbars with buttons that provide access to the most commonly used commands and tools. You can hide or display toolbars by selecting View> toolbar name from the menu bar. Chapter 2: DesignPro Manager Environment 29 Navigating the Workspace Workspace components are organized according to their functions and use. You can navigate to the workspace components and choose a command as follows: To use the menu bar: Click the appropriate menu and then select the required option from the drop-down list. For example, from the main menu, select File>Save to save a file. To show a toolbar: Select View>toolbar name from the view the specified toolbar . A check mark next to the required toolbar indicates selection. For example, from the main menu, select View>Messages to show or hide the Messages window. To use a toolbar: Click the required icon on the toolbar to perform an operation. For example, click to open a resource file using the toolbar. 30 To use right-click menu: Position the cursor on tools or windows in the Manager workspace. Right-click the mouse, and then select the required option. For example, right-click in the Messages window and select Show Date. This will display the date along with the generated messages. You can also use short-cut menus and short-cut keys to perform a specific action. 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 action. DesignPro Manager for AFP User Guide Keyboard Shortcuts The following keyboard shortcuts (hot keys) provide quick access to the DesignPro Manager commands. Commands Hot keys Open <Ctrl> + <O> Print <Ctrl> + <P> Exit <Alt> + <F4> Undo <Ctrl> + <Z> Cut <Ctrl> + <X> Copy <Ctrl> + <C> Paste <Ctrl> + <V> Rename <F2> Select All <Ctrl> + <A> Invert Selection <Ctrl> + <I> Messages <Ctrl> + <Shift> + <M> Elixir Resources <Ctrl> + <Shift> + <X> Explorer <Ctrl> + <Shift> + <E> Navigation Bar <Ctrl> + <Shift> + <N> Refresh <F5> Help <F1> Clear Messages <Ctrl> + <D> Chapter 2: DesignPro Manager Environment 31 32 DesignPro Manager for AFP User Guide Chapter 3: DesignPro Manager Basics In this chapter... Browsing the Workspace Working with Folders Defining Virtual and Physical Folders Mapping a Physical Folder to a Virtual Folder Creating Application Shortcuts This chapter describes in detail the basic features of DesignPro Manager. It explains how you can use system and virtual folders for managing different resources, and how to create shortcuts for frequently used applications. Browsing the Workspace DesignPro Manager workspace acts as the central point to all of the DesignPro Tools applications. It provides easy access to the installed applications, tools, and utilities. It also provides Explorer view to all drives with standard MS-Windows functionality incorporated. For the purpose of easy navigation and file management, DesignPro Manager provides a directory structure for: Virtual Folders – display in the Resources window from the Elixir resources root directory to provide a hierarchy or tree view of all Elixir specific resource types. Windows Explorer Folders – display in the Explorer window from the Desktop root directory to provide a tree view of the computer contents, including each drive and folder on your computer, as well as any network connected drives. 33 The DesignPro Manager Workspace. The DesignPro Manager tree structure of folders, subfolders, and files makes it easy to manage input and output files during mass conversion operations. It also helps to locate files by keeping all related folders in a single repository. This directory structure also allows you to view and edit form, font, and image files with different formats. 34 DesignPro Manager for AFP User Guide Working with Folders DesignPro Manager provides an Explorer window and Resources window for easy management and access of resources. The Explorer window displays the physical files and folders on your computer and network. The Resources window displays the Elixir resource files and folders in your computer. The resources are displayed according to their resource types, which is done with the help of virtual folders. To learn more about Manager workspace, refer to Chapter 2: "DesignPro Manager Environment". Defining Virtual and Physical Folders DesignPro Manager provides access to two types of folders: Physical folders – folders that are created on your computer and can have a number of other physical subfolders and files in them. Virtual folders – abstract representation of the physical file folder structure underlying DesignPro Tools. Virtual folders can have a number of virtual subfolders in them. Displayed as a tree structure in the DesignPro Manager, virtual folders are organized by resource type, then resource format. At the lowest level of each branch, one or more folders are listed, each representing a physical location on a mapped drive. This feature helps you to directly access the contents of the physical folder using the virtual folder, providing easy access to resources in a very organized manner. Selecting AFP Fonts using the virtual folder to access the physical files directly. Chapter 3: DesignPro Manager Basics 35 Locating Virtual and Physical Folders The location of the virtual folder tree is in the Resources window and contains folders that are organized by resource types, i.e. Document, Fonts, Forms (overlays), Graphics, and Jobs. These folders are mapped with the actual folders in the hard drive. Underneath the resource format folders (e.g. AFP, Elixir), there are sub folders representing a physical location on your drive or network (AFP1, Elixir1, etc.). The names for these folders are automatically generated. However, you can change these names according to your environment specifications. Placing your cursor over the mapped file folder displays the absolute path of the virtual folder references. The physical folders tree is located in the Explorer window and shows the Desktop on your computer. You can navigate in the folders to any location in your computer or network, as in Windows Explorer. You can also map a physical folder to the virtual folder to display its resources in the Resources window. For instructions on navigating in the Resources window, see Chapter 2: "DesignPro Manager Environment". Using Virtual Folders System parsers, writers, and editors use the virtual folders to locate resources. The following figure depicts the virtual folder organization: Virtual Folders Format Virtual Folder Selection The following sections briefly describe each resource type and their subordinate folders. 36 DesignPro Manager for AFP User Guide Documents Folder The Documents folder represents the Drive:\Elixir\Docs directory containing fully composed multi-page documents for Advanced Function Presentation (*.AFP), Elixir (*.GDF), Enhanced Metafile (*.EMF), Print Control Language (*.PCL;*.PRN), Portable Document Format (*.PDF), and PostScript formats. To navigate in the Documents folder, click adjacent to the Documents folder in the Resources window. The folders in the location Drive:\Elixir\Docs are displayed in the tree. Select the required folder to expand and view its resources. The resources are displayed in the Details window. Documents subfolders correspond to the following subdirectories: Document Folders Subdirectory AFP Documents Elixir\ Docs\ AFP\ Elixir Documents Elixir\ Docs\ Elixir\ EMF Documents Elixir\ Docs\ EMF\ PCL Documents Elixir\ Docs\ PCL\ PDF Documents Elixir\ Docs\ PDF\ PostScript Documents Elixir\ Docs\ PS\ Fonts Folder The Fonts folder represents the Drive:\Elixir\Fonts directory. This directory contains AFP Coded Fonts (X0*; X1*; X2*; X3*, X4*), AFP Character Set (C0*; C1*; C2*; C3*; C4*), AFP CodePage (T1*), Elixir Legacy Coded Font (X0* .cdf; X1*.cdf; X2*.cdf; X3*.cdf; X4*.cdf), and Windows font files. To navigate in the Fonts folder, click adjacent to the Fonts folder in the Resources window. The folders in the location Drive:\Elixir\Fonts are displayed in the tree. Select the required folder to expand and view its resources. The resources are displayed in the Details window. Chapter 3: DesignPro Manager Basics 37 Fonts subfolders correspond to the following DOS subdirectories: Fonts Folder Subdirectory AFP Elixr\ Fonts\ AFP\ Elixir Elixir\ Fonts\ Elixir\ Adobe Type 1 Elixir\ Fonts\ ATMT1\ System Resides in Windows directory. Forms Folder The Forms folder represents the Drive:\Elixir\Forms directory containing AFP Overlay Object (*.OVE; .OVL; 01), AFP Overlay Source (*.OGL), Elixir, Elixir Metafile, Print Control Language, Portable Document Format, and PostScript. To navigate in the Forms folder, click adjacent to the Forms folder in the Resources window. The folders in the location Drive:\Elixir\Forms are displayed in the tree. Select the required folder to expand and view its resources. The resources are displayed in the Details window. Forms subfolders correspond to the following DOS subdirectories: 38 Forms Folder Subdirectory OGL Elixir\Forms\OGL\ OVE Elixir\Forms\AFP\ Elixir Forms Elixir\Forms\ELIXIR\ EMF Forms Elixir\Docs\EMF\ PCL Forms Elixir\Docs\PCL\ PDF Forms Elixir\Docs\PDF\ PostScript Forms Elixir\Docs\PS\ DesignPro Manager for AFP User Guide Graphics Folder The Graphics folder represents the Drive:\Elixir\Pics directory containing AFP Page Segment (S1*) and Elixir Legacy Graphic files (*.LP3). To navigate in the Graphics folder, click adjacent to the Graphics folder in the Resources window. The folders in the location Drive:\Elixir\Pics are displayed in the tree. Select the required folder to expand and view its resources. The resources are displayed in the Details window. Graphics subfolders correspond to the following DOS subdirectories: Graphics Folder Subdirectory AFP Graphics Elixir\Pics\AFP\ Elixir Graphics Elixir\Pics\Elixir\ Jobs Folder The Jobs folder represents The Drive:\Elixir\Jobs directory containing AFP FormDef Objects (F1*.*, F1*.OBJ), AFP PageDef Objects(P1*.*;P1.OBJ), Elixir FormDef (*.EFD) and Elixir PageDef (*.EPD) job folders, and AFP PPFA Source (*.SRC, *.PFA) folders. To navigate in the Jobs folder, click adjacent to the Jobs folder in the Resources window. The folders in the location Drive:\Elixir\Jobs are displayed in the tree. Select the required folder to expand and view its resources. The resources are displayed in the Details window. Jobs subfolders correspond to the following DOS subdirectories: Jobs Folder Subdirectory AFP PageDef or FormDef Objects Elixir\Jobs\AFP\ Elixir Job Folders Elixir\Jobs\Elixir\ AFP PPFA Source Elixir\Jobs\PPFA\ Virtual folder settings can be changed within any DesignPro application using either the Manager or the Profile Editor. Changes made are saved in the current application profile. If the settings are changed using the Manager, any active DesignPro application, except DesignPro Manager, must be closed and re-launched for the changes to take effect. However, changes made using Profile Editor require that all applications, including DesignPro Manager, be closed and re-launched in order for changes to take effect. Chapter 3: DesignPro Manager Basics 39 Creating a New Physical Folder To create a new physical folder: 1 Browse to the desired location in the Explorer window. 2 Select File>New>Folder from the menu bar. 3 The new folder is created and displayed in the Details window. Mapping a Physical Folder to a Virtual Folder You can organize your design resources anywhere in your computer using the DesignPro Manager. Instead of keeping your design resources in the default Elixir directory (drive:/ Elixir/resources), you can map these folders in the virtual directory structure to access these folders from the Resources window. To map a new physical folder to the virtual folder structure: 1 In the Resources window, browse to the target resource folder. 2 Right-click the target resource folder and select Map New Folder from the pop-up menu. 3 Browse to map an existing folder and click OK. You can also create a new folder and map it to a virtual folder by browsing to a location in the Browse for Folder dialog. Click New Folder to create a new folder. 4 Click OK to map the folder to the virtual folder. The virtual folder is named by default. You can change the display name of the virtual folder by right-clicking the folder. Select Rename and enter a new display name for the folder. This will not change the name of the physical folder. 5 The name of the physical folder displays in the Details window header bar. A physical folder can be mapped to a number of virtual folders. 40 DesignPro Manager for AFP User Guide Moving Files Across Virtual and Physical Folders You can move files from a physical or virtual folder to another using a simple drag and drop operation. Similarly, you can move a physical folder up or down a tree structure by dragging and dropping it from one location to another. You cannot move a virtual folder from its default position in the tree. Unmapping Virtual Folders To remove a virtual folder from the directory structure: 1 Right-click the required folder in the Resources window and select Unmap Folder from the pop-up menu. 2 A message displays to confirm the delete operation. Click Yes to unmap the virtual folder. Deleting a Physical Folder To delete a physical folder: 1 Right click the desired folder in the Details window. You can also select the folder from the Explorer window. 2 Select Delete from the pop-up menu. You can also press the Delete button on the keyboard. 3 A message is displayed to confirm the delete operation. Click Yes to delete the folder. Right click the physical folder in the Details window or the Explorer window to perform standard MS-Windows operations, like delete, rename, copy, etc. Chapter 3: DesignPro Manager Basics 41 Creating Application Shortcuts DesignPro Manager provides a My Shortcuts tab in the navigation bar to create and maintain custom application shortcuts. These shortcuts are used to quickly launch Windows and DOS based applications from the Manager. Using this tab, you can create a shortcut icon to launch the Elixir website. You can also delete shortcut icons and view or edit shortcut icon properties. Creating a Shortcut To create a shortcut in the DesignPro Manager: 42 1 Select My Shortcuts tab in the DesignPro Manager. 2 Right-click in the My Shortcuts view, and select New Shortcut from the pop-up menu. The Elixir Shortcut Wizard displays. DesignPro Manager for AFP User Guide 3 Click Next to continue creating a shortcut. The General dialog displays. 4 Select the appropriate option in the Application Type. The options include: Windows – selecting this option implies that the shortcut points to a Windowsbased file. Dos – selecting this option implies that the shortcut points to a DOS-based file. 5 In the Link Name entry box, type a shortcut name for the link. You can use any name that is meaningful to refer to this shortcut. 6 In the Target entry box, enter the required path and filename or click to launch the Open dialog, and specify the following: File name – displays the name of the selected file. Files of type – select an appropriate option from the drop-down list. The options include Program Files, Batch files and All Files. The shortcut will use this path to execute the shortcut command. 7 Enter a value in the Program Arguments field. This option specifies user-defined shortcut parameters. Entering a command in the Program Arguments option executes the same command every time the shortcut is run. Chapter 3: DesignPro Manager Basics 43 8 Click Next. The Settings dialog displays. 9 In the Start In entry box, enter the required path or click to locate the following: Drive:\Program Files\Elixir Technologies\Bin. This path identifies the location for temporary files when a DesignPro application runs. The path specified in the Start In entry box can be in any location on your PC. Using the default path, which contains the DesignPro application executables, is strongly recommended. 10 As appropriate, select one of the following Run drop-down list options: Normal Window – displays the application window in the normal state. Minimized – opens the application in a minimized state. Maximized – utilizes as much room available on the screen. Select an option from the Icon drop-down list to specify an icon for the shortcut program. The preview of the selected option is displayed in the Icon Preview. 44 DesignPro Manager for AFP User Guide 11 Click Next to continue creating the shortcut. The Elixir Shortcut Wizard dialog displays. 12 Click Finish to create a shortcut in the DesignPro Manager My Shortcuts view. The shortcut displays in the My Shortcuts view. Chapter 3: DesignPro Manager Basics 45 Creating a Shortcut to Elixir Website To create a shortcut to the Elixir website: 46 1 Right click the My Shortcuts view and select the New Shortcut option from the pop-up menu. The Elixir Shortcut Wizard dialog displays. 2 Click Next to continue. The General dialog displays. 3 Select Windows in the Application Type. 4 Enter a name for the shortcut in the Link Name entry box. 5 In the Target entry box, enter the browser location or click target file. 6 Enter http://www.elixir.com in the Program Arguments field. 7 Click Next to go to the next dialog. 8 Set the appropriate shortcut preferences from Run and Icon, according to the requirement. 9 Press Finish to finish creating the shortcut. The shortcut displays in the My Shortcuts tab in the navigation bar. to browse to the DesignPro Manager for AFP User Guide Deleting a Shortcut To delete a shortcut: 1 Right click the required shortcut from the My Shortcuts view in the navigation bar. 2 Select Delete from the pop-up menu. A confirmation message displays. 3 Click Yes to delete the selected shortcut. Chapter 3: DesignPro Manager Basics 47 48 DesignPro Manager for AFP User Guide Chapter 4: Customizing DesignPro Manager In this chapter... Changing Application Default Options Viewing Parser and Converter Properties This chapter provides information on customizing DesignPro Manager for AFP. The Manager workspace default options can be changed to meet individual requirements and preferences. Included are instructions for changing the application’s default options. Changing Application Default Options DesignPro Manager allows you to customize the application’s operations and appearance by changing the default options. You can review or edit the available options for customization in the Options dialog. The Options dialog in the DesignPro Manager displays default settings in six category pages. Customization can be done by selecting checkboxes and field values, or by entering field information in each category page. To set or review the default application options: 1 Select Tools>Options from the menu bar. The Options dialog displays the available Category options. 2 Select the required Category option. 3 Review the dialog selections and make your changes; for information on each category, see below. 4 Click Apply to save the settings, then click OK to return to the Application window. 49 New settings take effect when you either select another category or close the Options dialog after applying the changes. The new settings remain in effect until changed Setting General Parameters The General category in the Options dialog allows you to customize general application parameters. To set options in the General category, review the following options: Save state on exit – saves the application interface state at the time of exit. The application is launched with the same settings in the next session. Send all messages to window – sends all messages to be displayed in the Messages window. If this option is not selected, messages are displayed in a Popup window. Setting Conversion Parameters The Conversion category provides options related to the conversion process. You can set and review the available options to change the conversion parameters. Automatically create directories that do not exist – automatically creates an output directory for placing the output, if the directory does not exist. Overwrite files – overwrites the previously converted output file with a new file. Stop all conversions if one fails – stops conversion process when a resource cannot be converted. Setting Symbols Properties The Symbols category allows you to set default properties for items in the System Data.ini file and displays the predefined symbols along with the user-defined symbols. Each item represents a Key (variable) and associated Value (path). Key and Value pairs indicate where to find certain types of computer information. In DesignPro Manager, Keys identify application objects; Values indicate associated object paths and types. 50 DesignPro Manager for AFP User Guide To set properties for Symbols category: 1 Click the Symbols category to display the available options. The various options are illustrated in the figure below: Review the options and set the object key path and type in the Value entry box. You can click to display the Browse for Folder dialog for selecting the required path. 2 The value for the selected object key is displayed in the Real entry box. 3 Click Set to set the selected object key path and type. The SystemData category is a subset of the Symbols category. It includes information on the system symbols that are predefined by Elixir, however, the list of information for SystemData comes from the same file i.e. SystemData.ini file. You can define new symbols using the Elixir Profile Editor and use them in the Resource category in parsers property pages. For more information on user profiles, refer to Chapter 9: "Elixir Profile Editor". Chapter 4: Customizing DesignPro Manager 51 Setting Message Preferences DesignPro Manger generates informational, warning, and error messages. In the Messages category, you can set the message type and display options. Specifying the message type economizes data logging by limiting the message display criteria. Message time, date, and color display options can help identify a message type and severity. To set message preferences, specify the following: Messages to View Information – displays informational messages in the Messages window. Show Message time – displays the message generation time in the Messages window. Message date – displays the message generation date in the Messages window. Use color – displays messages preceded by color-coded boxes in the Messages window. These color-coded boxes are used to specify the different types of messages. You can also type or select the maximum number of message text lines using the line maximum box. The default value is 200. 52 DesignPro Manager for AFP User Guide Logging Messages You can save the messages generated by DesignPro Manager in a file for future use. Logging options provided in the Messages Category allow you to save all messages displayed in the Messages window. To log the generated messages: Log Options Log to File – writes messages to the log file. Type the destination path adjacent to the Log to File entry box,where you want to save the log file. The default value of “.\” saves the log file in the same directory as the resource file. Type the name of the log file in the next entry box as shown below: The default log file name is “MSG.LOG,” however, you can change the file name and save it in any format, e.g. *.doc. Selecting Log to File, enables the following options: Unicode –creates the log file using the Unicode character set. Overwrite – overwrites any existing log file messages. Append – appends messages to the existing log file. Append by date – appends messages to the log file by date. View Log File – displays the Notepad window for viewing or editing the log file contents. Chapter 4: Customizing DesignPro Manager 53 Viewing Parser and Converter Properties You can view the properties for all of the available parsers and converters using the Info Server category options. The available options in the folder tree include: Input Parsers Output Converts Output Data Converters To view the properties of a particular parser or converter: 54 1 Click adjacent to the required Input Parsers or Output Converters folder to view associated resource folders. 2 Select the required resource folder to view the related information, as shown in the image below: DesignPro Manager for AFP User Guide 3 As appropriate, select or review the following: View Show all components/Hide unlicensed components – click this button to display all components or only licensed components in the tree. The button alternates between Show all components and Hide unlicensed components options. Refresh – click this button to save any changes and refresh the folder tree. Component Name – displays a unique name identifying the selected converter or parser. ID – displays a unique code identifying the selected converter or parser. Presentation – displays the text that appears in the file filters of the Open and Save dialogs corresponding to the selected converter or parser. Changing Resource Extensions You can register file extensions for a selected converter or parser using the Info Server category. For example, if an AFPDS input parser document category displays *.afp, you can change and register the extension of the AFPDS document by changing it in the Extensions entry box. This will change the input or output Files of type filter in the Open or Save dialogs. The options available in the Resources field display information for the individual resource types. For example, select Input Parser>AFPDS>Document to view the Document properties as explained below: Presentation – specifies a unique name identifying the selected resource node of specified component (parser or converter). Default –sets the selected resource extension as default. Extensions – displays the extension(s) for the selected resource. The Extensions setting applies to file extensions only, and does not affect the supported file formats. Chapter 4: Customizing DesignPro Manager 55 You can type the new file extension in this text box. Multiple extensions can be specified separated by semicolons. To change extensions: 56 1 Select an input or output parser component (e.g. Input Parser>AFPDS>Document) from the Info Server category. 2 Change values in the Extensions entry box. 3 To view the applied changes, you need to re-launch DesignPro Manager. DesignPro Manager for AFP User Guide Chapter 5: Using Converters In this chapter... Converting Files to Different Formats File Types Supported by Converters File Conversion Process Understanding Setup Files Working with Windows Fonts This chapter explains how to convert resource files using DesignPro Manager Converters including associated tasks for loading and saving setup (.EPM) files and converting Windows fonts. Converting Files to Different Formats The DesignPro Manager Converters provides the facility of converting resources to different formats. Resource files can be converted to and from multiple formats using the Converters application. You can also convert resources from the Tools menu of DesignPro Tools applications, like Form Editor, Graphics Editor, and Font Editor. Converting resources is necessary when you want to use documents, images, fonts, or overlays in a design that does not support the format of the resource file in use. Conversion is often required while printing, when you need all of the resources in the same format as the target printer. For example, while working with AFP printers, you need your resources to be in AFP format, i.e. AFP forms (overlays), AFP document, AFP fonts, and AFP page segments. You can create resources for AFP printers by coding or by using an application that creates those formats. You can also change the default file format property options for supported file types before conversion. For more information on property options and category information, see Chapter 6: "File Format Dictionary". 57 The Converters allows you to create multiple target formats from a single resource. You can also convert multiple resources with the same file extensions simultaneously to a single, or multiple target format. This facilitates the conversion of several resource types without using each DesignPro Editor individually. Converters in the Applications tab within the DesignPro Manager. File Types Supported by Converters The DesignPro Manager Converters can convert any of the following supported input formats to any supported output formats: Input Formats Document Files – the supported input document formats are listed below: • • • • • • • • • 58 Elixir Document – Multiple-page Elixir document. Elixir PrintDriver Document – Elixir Print Driver for Windows. AFP PPFA Source – Advance Function Printing PPFA Source. Elixir FormDef – Elixir FormDef. AFP PageDef Object – Advance Function Printing PageDef Object. Elixir PageDef – Elixir PageDef. Elixir Dat File – ASCII file containing a list of Elixir Forms and other commands. ElixirGDF – Legacy Elixir Generic Document (*.GDF). PCL – HP Printer Control Language. DesignPro Manager for AFP User Guide Font Files – the supported input font formats are as follows: • • • • • • • • • AFP Code Page – AFP Code Page (T1 Prefix). Elixir Legacy Code Page – Elixir Legacy Code Page. Elixir Legacy Font – Elixir Legacy Font. AFP Coded Font – AFP Coded Font (X0 or X1, X2, etc., prefix). Elixir Legacy Coded Font –Elixir Legacy Coded Font. PCL Font – HP Printer Control Language font. ATM Type 1 – Adobe Type Manager using Type 1 fonts. True Type – Windows-based outline fonts. AFP Character Set – Advance Function Printing Character Set (C0 or C1, C2, etc., prefix). Form Files – the supported input formats for forms (overlays) are as follows: • AFPDS – Multiple-page MO:DCA (AFP) and single-page Overlay (*.OVE). • Elixir Form – Elixir Form (*.efr). • Elixir Legacy Form – Elixir Legacy Form (*.elx). • Elixir PrintDriver Form – Elixir PrintDriver Form (*.ep). • AFP Form Object – Advance Function Printing Form Object (*.OVE, *.OVL, O1). • AFP Overlay Object – Advance Function Printing Overlay Object (*.OVE, *.OVL, O1). • AFP Overlay Source (OGL) – Advance Function Printing Overlay Source (*.OGL). • AFP Page Segment – Advance Function Printing Page Segment (S1*). Image Files – the supported input formats for image files are listed below: • • • • • • Elixir Legacy Graphic – Elixir Legacy Graphic (*.lp3). Bitmap Files – BMP Files (*.bmp). JPEG Files – JPEG Files (*.jpg; *.jpe; *.jpeg). PCX Files – PCX Files (*.pcx). PNG File – PNG File (*.png). TIFF Files – TIFF Files (*.tif). Chapter 5: Using Converters 59 Output Formats Document Files – the supported output document formats are as follows: • • • • • • • • • Font Files – the supported output font formats are listed below: • • • • Elixir Legacy Font – Elixir Legacy Font. Elixir Legacy Coded Font – Elixir Legacy Coded Font. PostScript Font – Adobe PostScript font. PCL Font – HP Printer Control Language font. Form Files – the supported output formats for forms (overlays) are as follows: • • • • ElixirDocument – Multiple-page Elixir document. Elixir Legacy Form – Elixir Legacy Form. AFP PPFA Source – Advance Function Printing PPFA Source. PDF Page – Portable Document Format. Elixir FormDef – Elixir FormDef. Elixir PageDef – Elixir PageDef. OGL – Overlay Generation Language. PCL Page – HP Printer Control Language. PostScript – Adobe page description language. AFPDS – Multiple-page MO:DCA (AFP) and single-page Overlay (.OVE). Elixir Form – Elixir Form. Elixir Legacy Form – Elixir Legacy Form. AFP Overlay Source (OGL) – Advance Function Printing Overlay Source. Image Files – the supported output image formats are listed below: • Image File – Image format. • Elixir – Elixir Legacy Graphic (*.lp3). 60 DesignPro Manager for AFP User Guide File Conversion Process Converters is an efficient resource conversion program that provides a central location for converting all resource types (documents, overlays, fonts, and images). You can convert resources for your application to single or multiple supported formats without leaving DesignPro Manager. For example, you can convert an Elixir legacy font to an AFP font using Converters instead of converting through DesignPro Font Editor. Following is a typical file conversion processing sequence using Converters: 1 Identify, prepare, and stage the resources for conversion. 2 Load the required setup (*.EPM) file. 3 Set up the conversion. 4 Define input and output conversion settings. 5 Start the conversion. Each activity and associated tasks are explained as follows: Identify, Prepare, and Stage the Resources Converters emulate printing systems used to process supported data streams; therefore, it must have access to all resources used by the printing device. These resources can be in either Elixir legacy format (for existing users upgraded from earlier Elixir Desktop and Converters versions) or printer device native format. Each resource must be identified before staging to Converters. AFP Resources Identify the following print file resources and their locations before conversion: Overlays (electronic forms), fonts (coded fonts, character sets, and code pages), and page segments (images). Form definitions (Formdefs). Pagedefs and Formdefs used to create the resource reference files must be identified and examined before conversion. Any overlay used for Font and Page Segment references must also be inspected. Chapter 5: Using Converters 61 Converters do not require specific file extensions for resources; however, Elixir products traditionally support the following resources: Overlays (forms) – .OVE (O1 prefix on stem name). Coded Fonts – no extension (X0 or X1, X2, etc., prefix on stem name). Code Pages – no extension (T1 prefix on stem name). Character Sets – .240 or .300 (depending on character set resolution and C0 or C1, C2, etc., prefix on stem name). Page Segments (images) – .SEG (S1 prefix on stem name). Formdefs (compiled) – .OBJ (F1 prefix on stem name). Documents – .AFP (MO:DCA) Document. You can convert an AFP document to an ELX form output format through DPT Manager. One ELX file will be produced per page in source document. A DAT file will also be written with the listing of form files created during the conversion process. To achieve this conversion: Drag and drop an AFP document onto the Converters icon in the Applications view in the DesignPro Manager. Select Elixir Legacy Formfrom the Output Formats list. Selecting this output format will produce a DAT file and the ELX file(s). 62 DesignPro Manager for AFP User Guide Understanding Setup Files The DesignPro Manager Converters uses the .EPM file to facilitate the handling of user selected file format options during file conversion. This setup file can be copied to other PCs or archived for later use. The setup (.EPM) file is used to store individual input and output property settings and help the system read the resource settings before and during the conversion process. Choosing a Setup (.EPM) File The DPTManager.epm is the default .EPM file, which is located at the following path: drive:/Documents and Settings/username/Application Data/Elixir Technologies/ Default .EPM file settings can be changed before starting the conversion process. You need to access the required file format property dialogs from the Tools>Application Format Setting>Input Formats or Output Formats menu, in the DesignPro Manager. Custom input and output conversion settings can be saved in a new setup file and loaded for use in the appropriate conversion session. For more information on saving a setup file, see "Saving a Setup (.EPM) File" on page 70. After loading the setup file, conversion property options may be changed for both input and output formats. To overwrite customized conversion settings with default conversion settings, reload the default setup file. Input and Output property options set in the Conversions dialog are automatically updated in the .EPM file loaded for the current session. Loading a Setup File To load a setup (.EPM) file: 1 Select Tools>Application Format Setting>Load from the menu bar. 2 Browse for the required target folder. 3 Select the following: File name – specifies a unique name identifying the file. Files of type – list of file types available for selection. Chapter 5: Using Converters 63 4 Click Open to load the selected setup file for the current conversion session. On loading the EPM file, its settings will be copied to the default EPM file. The Load dialog for EPM files will point towards the last accessed file and folder, even after relaunching the application. If some conversion resource paths are not present in the loaded setup file (.EPM), Converters picks the missing resource paths from the paths specified in the .INI file associated with your selected profile. For more information on profile selection, see Chapter 9: "Elixir Profile Editor". Setting up the Conversion To set up the conversion process, you will select resource files, and then drag and drop the file(s) onto the Converters icon in the Applications view. The Converters dialog will open, enabling you to set input and output conversion settings before initiating the conversion. You can set default options related to the conversion process using the Options dialog. For more information on using default settings, see "Changing Application Default Options" on page 49 in Chapter 4: "Customizing DesignPro Manager". Selecting Resource Files in Manager To select files for conversion from DesignPro Manager: 64 1 From the DesignPro Manager Explorer or Resources window, select the required resource input file to convert. 2 Select the required file extension from the filter drop down menu. DesignPro Manager for AFP User Guide Dragging and dropping Windows fonts onto the Converters icon launches the Registered Font Properties dialog, requiring you to register Windows fonts by specifying settings before initializing conversion. For more information on registering and converting Windows fonts, see "Working with Windows Fonts " on page 71. 3 Drag and drop the selected file onto the Converters icon, in the Applications view. The selected resource input file and associated outputs display in the Conversions dialog. The Conversion dialog displaying the selected output format. In case of converting multiple resources having the same file extension, input and output conversion settings defined for one resource are automatically applied to all resources of the same type. However, you need to initiate a new conversion process to convert a different resource type. Chapter 5: Using Converters 65 Changing Input Format Properties To change input format properties for conversion: 1 In the Converters dialog, select the required format from the Input Format dropdown list. 2 Optionally, click to view the path for selected input file(s). You cannot change the selected input files once they are dropped onto the Converters icon in the current session. 3 Click to set properties for the selected input format. The Input Properties dialogs contain the following Category selections: Category Encoding Error Handling Font(s) FormDef General Main Page Paper Prefix Resources Resources - Fonts 66 DesignPro Manager for AFP User Guide Category Resources - Forms Resources - Images Resources - ResGroups Shading Synthesizer Tags Category selections displaying in properties dialogs depend on the selected Input format. 1 As appropriate, set properties for each category. The property definitions for each category are provided in Chapter 6: "File Format Dictionary". 2 Click Apply and then OK to save the settings and return to the Applications window. Changing Output Format Properties The Outputs area of the Conversions dialog populates according to the input file selection. To change output format properties for conversion: 1 In the Outputs area, select one or more available Output Formats for conversion by using the check boxes under Output Formats. You can also check the All available formats option to select all of the Output Formats. DesignPro Converter only converts output formats selected in the Conversions dialog. Chapter 5: Using Converters 67 The Conversions dialog displaying the selected output formats. 2 Click adjacent to the selected output format to set properties for specified input files. This will set the properties for the output format. The Output Properties dialogs contain the following category selections: Category Active objects Code Pages Colors Drawing Options Encoding Encryption Environment Error Handling Fonts 68 DesignPro Manager for AFP User Guide Category Formdef Forms General Images Main Output Formats Page Page Def Page Objects Paper Printer Properties Simplifier 3 As appropriate, set the required properties for each category. Property definitions for each category are provided in Chapter 6: "File Format Dictionary". 4 The Paths column specifies the default output file path and name. Click to open the Browse for Folder dialog to change the default output file path and name. 5 Click OK to return to the Conversions dialog. Start the Conversion After input and output options have been defined in the Conversions dialog, the file conversion can be initiated. To start the conversion process, click OK in the Conversions dialog. Messages window displays the conversion status and error and warning messages, if any. For information on error and warning messages, refer to Appendix A: "Error and Warning Messages". Chapter 5: Using Converters 69 Saving a Setup (.EPM) File All input and output conversion settings selected in DesignPro Manager or the Conversions dialog, are saved in the default or loaded setup file. These settings can be exported or saved in a new setup file before or at the time of conversion. You can load the customized setup file for converting selected resources. Any input and output conversion settings made during conversion are then saved in the customized setup (.EPM) file. To export or save input and output conversion settings in a new file: 1 Select Tools>Application Format Setting>Save from DesignPro Manager menu bar. 2 Browse for the required target folder. 3 As appropriate, enter or select the select the following: File name – specifies a unique name identifying the file. Save as type – displays the list of file save types available for selection. 4 Click Save to save changes in the loaded file. The Save dialog for EPM will point towards the last accessed file and folder, even after relaunching the application. Resetting Customized Conversion Settings to Default You can revert your customized input and output conversion settings made in the loaded setup file through the Conversions dialog to the default .EPM file during or after conversion by selecting Tools>Application Format Setting>Clear from the menu bar in DesignPro Manager. 70 DesignPro Manager for AFP User Guide Working with Windows Fonts DesignPro Manager Converters requires information such as font size, style, orientation, and resolution for converting fonts. Unlike Elixir fonts, Windows fonts do not have required information for conversion. Therefore, DesignPro Manager allows you to customize selected Windows fonts to required output settings before initializing conversion. Required Windows fonts are customized using the Registered Font Properties dialog. Registering Windows Fonts for Conversion To register Windows fonts for conversion: 1 Drag and drop required Windows font onto Registered Font Properties dialog displays. 2 As appropriate, review selections and make your changes: Selected fonts – displays a list of selected fonts. Script – list of font script types available for selection. Size – list of font size, in points, available for selection. 3 Select an option in the Output Name field. Custom –sets custom font names in the Custom Name entry box. Auto – uses pre-defined font names. 4 As appropriate, review or select the following options: Output fonts – displays the list of added fonts. You can add fonts selected for conversion in the Output Fonts list by clicking Add and delete selected fonts from the Output Fonts list by clicking Del. Sample Text – displays the preview of selected text. 5 Select appropriate options from Character Set Mapping for the following options. Map Font – select this option to map between target and windows fonts. The list displays start and end range of character values available for selection. • Target – displays list of available Keyboard Mapping Files for selection. • Windows – displays the Keyboard Mapping Files for Windows fonts available for selection. Chapter 5: Using Converters in the Applications view. 71 72 6 Select appropriate options from Style for Windows fonts. Bold – sets the font style to bold. Italic – sets the font style to italics. Underline– underlines the selected text. Overstrike – draws a line over the selected text. 7 Select appropriate options from Resolution for Windows fonts. Dpi – sets the font resolution, in dpi. Hor – sets font horizontal resolution, in dpi. Vert – sets font vertical resolution, in dpi. 8 Select appropriate options from Orientation for Windows fonts. Portrait –sets page to portrait. Inv. Portrait – sets page to inverse portrait. Landscape – sets page to landscape. Inv. Landscape – sets page to inverse landscape. 9 Click OK to save the settings. Conversions dialog displays for converting the selected Windows fonts. DesignPro Manager for AFP User Guide Chapter 6: File Format Dictionary In this chapter... DesignPro Tools Formats Setting Parser Parameters Setting Converter Parameters Working with Elixir Properties This chapter identifies input format and output format converters supported by DesignPro Tools for AFP, and provides format settings property field definitions within associated categories. DesignPro Tools Formats This dictionary provides a definition of Elixir converter format options available in DesignPro Tools for AFP. Supported Input and Output formats are listed below: AFPDS – converts AFP Overlay Object Files (*.Ove;*.Ovl, .O1*), AFP Code Page Files (T1*), AFP Coded Font Files (X0*; X1*; X2*; X3*; X4*), AFP (MO:DCA) Document Files (*.afp), AFP Character Set Files (C0*, C1*, C2*, C3*, C4*), and AFP Page Segment Files (S1*). AFPDS also supports common PC font and image formats and Elixir Legacy formats. AFP overlay, font, image, and barcode formats are supported with user control over AFP prefixes and file extensions. DAT Parser – DAT input parser allows Dat file conversion of one or more single page forms to other formats like Metacode (including Normalized Metacode for DocuTag users) and AFP. In Form Editor, the Dat input parser properties are accessed from the Application Format Setting menu. Elixir PDW – (Windows EMF) reads Form Editor files from Windows application documents that have been converted using Elixir PrintDriver, and provides property settings for page objects. 73 GDF/ElixirForm (Elixir) – provides conversion to current document library from old Elixir format to preserve compatibility of new Elixir applications with older (EAS, Opus) applications. The input format Tags category provides support for EZ Tags and tag file localization. Output format categories provide general conversion settings for resource object simplification, color fidelity model, destination, and replacement. Image category settings specify preferences for exporting external image resources as either BMP or LP3 image output. The Fonts category has an option for exporting external fonts. Image – provides output format image conversion settings for Graphics Editor and Form Editor, including image file format, compression, and pixel settings. Native Input Parser (ElixirForm) – converts Dat file resources into the Elixir document library. Native parser is accessed from the Dat Parser Form Input Parsers list. Main and Resources property categories are used for searching and maintaining resources. OGL – reads AFP overlay (.ogl) source file format and maps it to Elixir DocLib objects. Form Editor uses this input format to import OGL form objects, specify object properties, and handle form resources. Output format categories allow you to specify form, font and color settings, general options for source encoding, etc., and environment settings. PCL – optimizes PCL and font (.pcl, .prn, .flj) files to significantly reduce file size as produced by Windows drivers, and creates AFP fonts from True Type or Adobe fonts. Output format Page and Paper categories allow you to specify printer setup options and Simplifier settings for converting complex page objects to simple objects. PDF – Output format provides settings for PDF file optimization and password encryption. Postscript – Output format includes a Printer Properties category for specifying options for PostScript interpreter devices. Options include settings for color print quality, image down sampling, and resource handling. PPFA – provides for conversion of AFP PPFA PageDef and FormDef resources to Elixir internal format. The component uses the standard Elixir error library to handle common errors and notify the user. Property settings allow you to specify comment support and overlay name options. 74 DesignPro Manager for AFP User Guide Setting Parser Parameters While working with resources, you can set the input settings using the DesignPro Manager for AFP. This will set the properties for the required format at the application level. The property dialog for the input parser can be accessed using the DesignPro Manager by selecting Tools>Application Format Setting>Input Formats. The sub menu displays the available output format options. You can also access the input settings from DesignPro Manager Converters. For more information, see Chapter 5: "Using Converters". Setting AFPDS Parser Parameters To set the appropriate parser parameters for AFPDS using DesignPro Manager: 1 From the Tools menu in the menu bar, go to Application Format Settings>Input Formats and select AFPDS. The AFPDS dialog displays. 2 Select the required Category option. Chapter 6: File Format Dictionary 75 3 Review the dialog selections and make your changes. For information on each category, see below. 4 Click Apply to save the settings, then click OK to return to the application window. You can also access the AFPDS parser settings from DesignPro Manager Converters. For more information, see Chapter 5: "Using Converters". General The General category lets you set the overlay and segment name prefix, as well as the embedding and import options. The available options include: Overlay Name With 01 prefix - uses AFP Bounded Box O1 prefix with overlay name. Without AFP prefix - does not use AFP prefix with overlay name. Segment Name With S1 prefix - uses AFP Bounded Box S1 prefix with segment name. Without AFP prefix - does not use AFP prefix with segment name. Options 76 Embed resources – embeds resources in Elixir document structure. Import document structure (Page groups) – imports named AFP Page Group records (BNG/ENG) into Elixir document structure. DesignPro Manager for AFP User Guide Paper The Paper category provides options for setting the page properties like page size, height, width, and the units. You can also specify the rotation for the page or form from the options available. The Paper category options display. Select or review the following options: Paper Properties Use this page size – uses selected page size. Paper size – page size options. Either: • Custom Size – sets custom page size. • 11 x 17 - uses (11 x 17 inch) page. • A3 - uses standard European 297 x 420 mm (11.69 x 16.54 inch) page. • A4 - uses standard European 210 x 297 mm (8.27 x 11.69 inch) page. • Legal - uses standard U.S. Legal (8.5 x 14 inch) page. • Letter - uses standard U.S. Letter (8.5 x 11 inch) page. Height – custom page vertical length specified in set Units. Width – custom page horizontal length specified in set Units. Chapter 6: File Format Dictionary 77 Units – page size unit of measurement available for selection. Either: • Cm – sets to centimeters. • In – sets to inches. • Pels – sets to pels. Rotate Page/Form By 0 Degree – no page or form rotation. 90 Degree – rotates page or form clockwise at 90 degrees. 180 Degree – rotates clockwise at 180 degrees. 270 Degree – rotates clockwise at 270 degrees. Fonts The Fonts category lets you set the font prefix options for print file font references and embedded fonts. You can also set the font mapping options and select appropriate encoding options for AFP input. The AFPDS Fonts category input property settings are displayed. 78 DesignPro Manager for AFP User Guide Font prefix Universal X0 – naming convention for both print file font references and embedded fonts imported into Resource library. This option specifies to use AFP Bounded Box X0 prefix to reference fonts. Separate X1 – X4 – uses Unbounded Box X1- X4 prefix to reference fonts. No AFP Prefix – removes AFP prefix from font name. Font mapping Use Font Mapping – activates DBCS CodePoint to Unicode mapping. DBCS - Codepoint to unicode mapping Japanese – uses Japanese encoding for the AFP input double byte encoding used (for double byte documents). IBM double byte characters are mapped to the Unicode values. Korean – uses Korean encoding. Traditional Chinese – uses Traditional Chinese encoding. Simplified Chinese – uses Simplified Chinese encoding. Thai – uses Thai encoding (feature currently inactive). Chapter 6: File Format Dictionary 79 FormDef Using the FormDef category, you can select the active FormDef name to be used by the AFP file. The AFPDS FormDef category displays. FormDef Setting 80 Active Formdef – optional name of FormDef used by AFP file. Entry can be FormDef name or full name and path to FormDef file. The list displays the Open dialog for selecting a file. DesignPro Manager for AFP User Guide Synthesizer The Synthesizer category represents a specialized component used to combine and render simple page objects into complex objects. The Synthesizer is generally used when an output format can print or image a single complex object more efficiently than a series of discrete, primitive objects. An example is when an input stream renders a box as four individual lines. The Synthesizer can combine these lines into a single vector box object for those output formats that support it. The Synthesizer category displays. Chapter 6: File Format Dictionary 81 1 Select the Synthesizer category, and then select the Use synthesizer check box. This option facilitates parsing irregular drawing shapes in a single operation, thus avoiding the use of multiple operations. Otherwise, to parse irregular drawing shapes. Options associated with the Use synthesizer check box are described below: Box To Line – performs box to line synthesis. Boxes To Box – performs boxes to box synthesis. Shade To Box – performs shade to box synthesis. Lines To Box – performs lines to box synthesis. Lines To Line – performs line to line synthesis. Lines To Path – performs lines to path synthesis. Text Join – performs text join synthesis. Images To Image – performs images to image synthesis. (This options is available only when the Synthesizer is invoked by Windows EMF parser). Default view of Synthesizer category when the Use Synthesizer option is selected. 82 DesignPro Manager for AFP User Guide 2 Review or select the following options for Box To Line. Perform ‘box to line’ synthesis – merges thin solid boxes into true line objects. Maximum allowed line width (14400 dpi) – maximum line width; value between 1-14400 DPI. Box To Line options for the Synthesizer. 3 Review the following options for Shade To Box. Perform ‘shade to box’ synthesis – transforms shaded boxes into solid lined boxes. Epsilon Value (14400 Dpi) – sets the maximum allowable distance between the shaded boxes; value is between 1-14400 DPI. The Synthesizer searches for irregular shaped boxes with the specified value and transforms them into regular shapes. Shade To Box options for the Synthesizer. 4 Review the following options for Boxes To Box. Perform ‘boxes to box’ synthesis – merges boxes with the same width and Xcoordinate, or same height and Y-coordinate, or completely overlapping boxes into one box object. Chapter 6: File Format Dictionary 83 Space Epsilon (14400 dpi) – specifies the maximum allowable space between two boxes in dots per inch; value is between 1-14400 DPI. If the boxes are placed within the specified space value, then they will be merged into one box object. Dimension Epsilon (14400 dpi) – specifies the maximum allowable difference within dimensions of two boxes in dots per inch. If the difference in dimensions is within the specified epsilon value, the boxes will be merged into one box object. The value is between 1-14400 DPI. Boxes To Box options for the Synthesizer. 5 84 Review the following options for Lines To Line. Perform ‘lines to line’ synthesis – transforms irregular (broken) lines into solid lines. Epsilon for Solid lines (14400 dpi) – specifies the maximum allowable difference between two solid lines in dots per inch. If the distance between two adjacent lines is within the specified epsilon value, they will be merged into one line object. The value is between 1-14400 DPI. Epsilon for Patterned Lines (14400 dpi) – specifies the maximum allowable difference between two patterned lines in dots per inch. If the distance between two adjacent lines is within the specified epsilon value, they will be merged into one line object. The value is between 1-14400 DPI. Epsilon value (14400 DPI) – sets the maximum allowable distance that separates irregular line fragments; value is between 1-14400 DPI. The Synthesizer searches for irregular line fragments with the specified value and transforms them into regular lines. DesignPro Manager for AFP User Guide Lines To Line options for the Synthesizer. 6 Review the following options for Lines To Box. Perform ‘lines to box’ synthesis – transforms irregular (broken) lines into solid boxes. Epsilon value (14400 DPI) – sets the maximum allowable distance that separates irregular line fragments; value is between 1-14400 DPI. The Synthesizer searches for irregular line fragments with the specified value and transforms them into regular box.. Allow shared lines – synthesizes lines that are common to multiple objects. Lines To Box options for the Synthesizer. 7 Review the following options for Lines To Path. Perform ‘lines to path’ synthesis – transforms irregular (broken) lines into solid lined paths. Epsilon value (14400 DPI) – sets the maximum allowable distance separating line fragments for synthesis; value is between 1-14400 DPI. The Synthesizer searches for irregular line fragments with the specified value and transforms them into solid line paths. Allow shared lines – synthesizes lines and paths that are common to multiple objects. Chapter 6: File Format Dictionary 85 Lines To Path options for the Synthesizer. 8 86 Review the following options for Text Join. Perform ‘text join’ synthesis – merges text fragments into a single text object. Base line join threshold (14400 DPI) – maximum allowable vertical distance separating text fragments for synthesis; value between 1-14400 DPI. Paragraph join threshold (% of line spacing) – maximum allowable vertical distance separating text objects for synthesis, as percent of average font character width. Character join threshold (% avg char width) – maximum allowable horizontal distance separating text characters for synthesis, as percent of average font character width. Perform horizontal pass – performs horizontal scan to merge all text objects into a single line. Perform vertical pass – performs vertical scan to merge all text objects into a single text object. Smart mode – activates smart mode for inserting separator characters between joined text objects. Column separator – column separator options. Either: • Tabulator – uses tabulator. • Space – uses space. • Semicolon – uses semicolon. • Vertical line – uses vertical line. DesignPro Manager for AFP User Guide The Text Join options for the Synthesizer are displayed. 9 Review the following options for Images To Image. Space Epsilon (14400 dpi) – specifies the maximum allowable space between two image objects in dots per inch; value is between 1-14400 DPI. If the objects are placed within the specified space value, then they will be merged into one image object. Dimension Epsilon (14400 dpi) – specifies the maximum allowable difference within dimensions of two image objects in dots per inch. If the difference in dimensions is within the specified epsilon value, the objects will be merged into one image object. The value is between 1-14400 DPI. Images To Image options for the Synthesizer. Chapter 6: File Format Dictionary 87 Resources DesignPro Tools looks for specific resources in its default or assigned resource path. For this reason, the resources are divided into subcategories. The specific resource is located by its subcategory (starting with the first listed folder) and, if the resource is not found in any of the paths specified, it searches the entries in the Resources category. Paths can be added to each resource category for searching multiple folders. You can set the resource paths for the following four subcategories: Resource Groups – defines the path to folders containing (an) external AFP resource group file(s). Fonts – defines the path to folders containing font resources. Forms – defines the path to folders containing the form resources. Images – defines the path to folders containing the image resources. Setting Resource Paths To set the resource path, select the required subcategory from Category. 88 Click to add a new resource path. Click to insert a new resource path. Click to edit the selected resource path. Clicking Click To move the resource path one level up, click Clicking deletes the selected resource path. deletes all resource paths. . moves the resource path one level down. DesignPro Manager for AFP User Guide Setting OGL Parser Parameters To set appropriate parser parameters for OGL using DesignPro Manager: 1 From the Tools menu in the menu bar, go to Application Format Settings>Input Formats and select OGL. The OGL dialog displays. 2 Select the required Category option. 3 Review the dialog selections and make your changes. For information on each category, see below. 4 Click Apply to save the settings, then click OK to return to the application window. You can also access the OGL parser settings from DesignPro Manager Converters. For more information, see Chapter 5: "Using Converters". Chapter 6: File Format Dictionary 89 General Using the General category, you can set the record format options and assign sequence numbers. You can also set the encoding options for the OGL input resources. Record Format Record Format – record length options. Either: • Variable – sets to variable record length. • Fixed – sets to fixed record length. • Record Length – fixed record length. Sequence Number – assigns sequence number to parsed objects. Source Encoding Source encoding – source encoding options. Either: • ASCII – uses ASCII encoding. • EBCDIC – uses EBCDIC encoding. Prefix The Prefix category allows you to set the font name and segment name prefix options. The Prefix category options display. 90 DesignPro Manager for AFP User Guide Font – font name prefix options. Either: • Universal X0 Prefix – uses AFP Bounded Box X0 prefix with font name. • Maintain Respective Prefixes (X0 to X4) – uses Unbounded Box X0–X4 prefix with font name. • No AFP Prefix – does not use AFP prefix with font name. Segment – segment name prefix options. Either: • S1 Prefix – uses AFP S1 prefix with segment name. • No AFP Prefix – does not use AFP prefix with segment name. Font Using the Font category, you can activate the font mapping option, and select the appropriate character set for windows. The Font category options display. Chapter 6: File Format Dictionary 91 Options Use Font Map – activates converter to perform CodePoint to Unicode Mapping for selected encoding type. Windows Charset – font character set options. Either: • Western – sets to Western. • Baltic – sets to Baltic. • Greek – sets to Greek. • Central European – sets to Central European. • OEM/DOS – sets to OEM/DOS. • Cyrillic – sets to Cyrillic. • Symbol – sets to Symbol. • Turkish – sets to Turkish. • Johab – sets to Johab. • Herbew – sets to Herbew. • Arabic – sets to Arabic. Synthesizer For information on using the Synthesizer category, refer to "Synthesizer" on page 81. Resources Using the Resources category, you can set the resource paths for the OGL file. For more information on setting resource paths, refer to the "Resources" on page 88. 92 DesignPro Manager for AFP User Guide Setting PCL Parser Parameters To set appropriate parser parameters for PCL using DesignPro Manager: 1 From the Tools menu in the menu bar, go to Application Format Settings>Input Formats and select PCL. The PCL dialog displays. 2 Select the required Category option. 3 Review the dialog selections and make your changes. For information on each category, see below. 4 Click Apply to save the settings, then click OK to return to the application window. You can also access the PCL parser settings from DesignPro Manager Converters. For more information, see Chapter 5: "Using Converters". Chapter 6: File Format Dictionary 93 Shading Using the Shadings category, you can select the appropriate shadings conversion option. Shadings conversion – shade mapping options. Either: • PCL Style (Interval Mapping) – maps closest to Elixir shades. • Precise Input Value – maps to matching gray shade. • DIB Pattern – maps to DIB (Device Independent Bitmap) pattern. Page For information on using the Page category, refer to the "Page" on page 100. Synthesizer For information on using the Synthesizer category, refer to "Synthesizer" on page 81. 94 DesignPro Manager for AFP User Guide Setting ElixirGDF Parser Parameters To set appropriate parser parameters for ElixirGDF using DesignPro Manager: 1 From the Tools menu in the menu bar, go to Application Format Settings>Input Formats and select ElixirGDF. The GDF/Elixir Form dialog displays. 2 Select the required Category option. 3 Review the dialog selections and make your changes. For information on each category, see below. 4 Click Apply to save the settings, then click OK to return to the application window. You can also access the ElixirGDF parser settings from DesignPro Manager Converters. For more information, see Chapter 5: "Using Converters". Chapter 6: File Format Dictionary 95 Main The options in the Main category include text formatting options and outline fonts resolution options. You can also specify the resource managing preferences and DBCS mapping options. Text Formatting Text formatting – text formatting options. Either: • Compatible With Older Versions – format text compatible with earlier Converter versions. • Advanced – format text compatible with latest Converter version only. Preferred outline fonts resolution (GDF input only) – outline font resolution options. Either: • Default – sets to default. • 300 DPI – sets resolution to 300 dots per inch. Resource Management Remove unused fonts (elx input only) – removes unused font references in ElixirForm font list to ensure these fonts are not converted. Use code page mapping – uses character set and code page name to reference fonts. DBCS (Codepoint To Unicode Mapping) Preferred Mapping – preferred font mapping options. Either: • Japanese – uses Japanese encoding to map fonts. • Korean – uses Korean encoding to map fonts. • Traditional Chinese – uses traditional Chinese encoding to map fonts. • Simplified Chinese – uses simplified Chinese encoding to map fonts. Resources Using the Resources category, you can set the resource paths for the Elixir GDF file. For more information on setting resource paths, refer to "Resources" on page 88. 96 DesignPro Manager for AFP User Guide Tags The Tags category allows you to change the tag file preferences. The GDF/Elixir Form Tags category options display. Tag file localization From ELX File – indicates tag definition file name is stored in ELX file. Source Path – specifies the path and name of the tag file. The default path is set in Profile Server opens the Browse for Folder dialog for searching tag file name. This option is enabled when from ELX File is set. User Defined – indicates user defined tag file name and path. Chapter 6: File Format Dictionary 97 Active Controls EZ Tag Options – EZ tags are a special set of standard tags (form variables) indicated by keywords in the tag name. The keyword specifies the active object type created from the tag (edit box, radio button, combo box). However, tags can also be interpreted as standard tags. Options indicate tag interpretation. Either: • Ignore EZ Tags – interprets all tags as standard tags; no active object is created. • Include EZ Tags – interprets all tags with keyword in tag name as EZ Tag; other tags as standard tags. • All Tags as EZ Tags – interprets all tags with keyword in tag name as EZ Tag; other tags as EZ Tag edit box with text formatting; No standard tag is created. Global Info File – Specifies text file containing additional information for EZ Tags (object border color, edit box background color, etc.). displays the Open dialog for selecting information about the file. Synthesizer For information on using the Synthesizer category, refer to the "Synthesizer" on page 81. 98 DesignPro Manager for AFP User Guide Setting ElxirPDW Parser Parameters To set appropriate parser parameters for ElixirPDW using DesignPro Manager: 1 From the Tools menu in the menu bar, go to Application Format Settings>Input Formats and select ElixirPDW. The ElixirPDW dialog displays. 2 Select the required Category option. 3 Review the dialog selections and make your changes. For information on each category, see below. 4 Click Apply to save the settings, then click OK to return to the application window. You can also access the ElixirPDW parser settings from DesignPro Manager Converters. For more information, see Chapter 5: "Using Converters". Chapter 6: File Format Dictionary 99 Page Using the Page category, you can set the page size of the ElixirPDW input file. You can also customize the horizontal and vertical length of the page in this category. Page Size – page size options. Either: • Custom - uses non-standard sized page. • 11 x 17 - uses (11 x 17 inch) page. • A3 - uses standard European 297 x 420 mm (11.69 x 16.54 inch) page. • A4 - uses standard European 210 x 297 mm (8.27 x 11.69 inch) page. • Legal - uses standard U.S. Legal (8.5 x 14 inch) page. • Letter - uses standard U.S. Letter (8.5 x 11 inch) page. • Custom Size – sets to custom page size. • Default – sets default page size. • Minimal Size – sets minimal size. Custom Size (14400 DPI) 100 Height – page vertical length in DPI. Width – page horizontal length in DPI. DesignPro Manager for AFP User Guide General The General category lets you specify the option for invisible boxes on the form. The ElixirPDW General category option displays. Select or review the following option: Ignore invisible boxes – ignores the invisible boxes in the form. Synthesizer For information on using the Synthesizer category, refer to to the "Synthesizer" on page 81. Chapter 6: File Format Dictionary 101 Setting WindowsEMF Parser Parameters To set appropriate parser parameters for WindowsEMF using DesignPro Manager: 102 1 From the Tools menu in the menu bar, go to Application Format Settings>Input Formats and select WindowsEMF. The WindowsEMF dialog displays. 2 Select the required Category option. 3 Review the dialog selections and make your changes. For information on each category, see below. 4 Click Apply to save the settings, then click OK to return to the application window. You can also access the WindowsEMF parser settings from DesignPro Manager Converters. For more information, see Chapter 5: "Using Converters". DesignPro Manager for AFP User Guide Page For information on using the Page category, refer to the "Page" on page 100. General The General category lets you specify the option for invisible boxes in the form. Select or review the following option: Ignore invisible boxes – ignores the invisible boxes in the form. Synthesizer For information on using the Synthesizer category, refer to the "Synthesizer" on page 81. Chapter 6: File Format Dictionary 103 Setting PPFA Parser Parameters To set appropriate parser parameters for PPFA using DesignPro Manager: 104 1 From the Tools menu in the menu bar, go to Application Format Settings>Input Formats and select PPFA. The PPFA dialog displays. 2 Select the required Category option. 3 Review the dialog selections and make your changes. For information on each category, see below. 4 Click Apply to save the settings, then click OK to return to the application window. You can also access the PPFA parser settings from DesignPro Manager Converters. For more information, see Chapter 5: "Using Converters". DesignPro Manager for AFP User Guide General In the General category, you can set the comment support options along with the resource embedding options. Select or review the following options: Comment Support Import Comments – import comments placement options. Either: • Preceding Command – adds comments before command. • Embedded Within Command – embeds comments within command. • Following Command – appends comments to command. • Import Object Names From Comments – includes object names with comments. Resource Embedding Embed Resources – embeds resources in the Elixir document structure. Chapter 6: File Format Dictionary 105 Prefix The Prefix category lets you set the prefix for font name, overlay name, and segment name. The Prefix category options display. 106 Font Name Option – font name prefix options. Either: • Universal X0 Prefix – uses AFP Bounded Box X0 prefix with font name. • Maintain Respective Prefixes (X0 to X4) – uses Unbounded Box X0–X4 prefix with font name. • No AFP Prefix – does not use AFP prefix with font name. Overlay Name Option – overlay name prefix options. Either: • O1 Prefix – uses AFP O1 prefix with overlay name. • No AFP Prefix – does not use AFP prefix with overlay name. Segment Name Option– segment name prefix options. Either: • S1 Prefix – uses AFP S1 prefix with segment name. • No AFP Prefix – does not use AFP prefix with segment name. DesignPro Manager for AFP User Guide Font Select or review the Font category. The PPFA Font category dialog displays. Font Search options Use Font Map – starts a search in the font directory. Chapter 6: File Format Dictionary 107 Encoding The Encoding option allows you to specify the source encoding options along with the record format and text encoding preferences. PPFA Encoding category displays. Select or review the following options: Source encoding – source encoding options. Either: • ASCII – uses ASCII encoding. • EBCDIC – uses EBCDIC encoding. Record Format 108 Variable – sets record format to variable record length. Fixed – sets to fixed record length. Record Length – fixed record length. Sequence Numbers or System Information – assigns sequence number or system information to parsed objects; active for fixed Record Format only. DesignPro Manager for AFP User Guide Text Encoding Condition – condition text coding options. Either: • None – no text coding. • ASCII – uses ASCII coding. • EBCDIC – uses EBCDIC coding. Delimiter – delimiter text coding options. Either: • None – no text coding. • ASCII – uses ASCII coding. • EBCDIC – uses EBCDIC coding. Fixed Text – fixed text coding options. Either: • None – no text coding. • ASCII – uses ASCII coding. • EBCDIC – uses EBCDIC coding. Record ID – record ID text coding options. Either: • None – no text coding. • ASCII – uses ASCII coding. • EBCDIC – uses EBCDIC coding. Chapter 6: File Format Dictionary 109 Error Handling The Error Handling option allows you to specify the error handling options for PPFA. Error Handling category options for PPFA. Error Handling 110 Treat Warnings as errors – displays warning messages as errors. PageDefs and FormDefs cannot be processed until all warnings are addressed. DesignPro Manager for AFP User Guide Setting Converter Parameters While converting resources to a specific target format, you can set the output conversion parameters using the DesignPro Manager for AFP. This will set the properties for the required format on the application level. To set the appropriate converter parameters, open DesignPro Manager. From the main menu, go to Tools>Application format settings>Output settings. The submenu displays the available output format options. You can also set the conversion properties while saving a form from File>Save as from the main menu. The Save As dialog displays. 1 Select the required output format from the Save As dropdown list. 2 Click Edit Property Settings to select the required output format options. You can set the input and output settings using converters in the DesignPro Manager as well. This will, however, specify the settings on the document level. For more information on format settings using converters, refer to Chapter 5: "Using Converters". Chapter 6: File Format Dictionary 111 Setting AFPDS Converter Parameters To set appropriate conversion parameters for AFPDS using DesignPro Manager: 1 From the Tools menu in the menu bar, go to Application Format Settings>Output Formats and select AFPDS. The AFPDS dialog displays. AFPDS dialog displays options in the Main category. 112 2 Select the required Category option. 3 Review the dialog selections and make your changes. For information on each category, see below. 4 Click Apply to save the settings, then click OK to return to the application window. You can also access the AFPDS output settings from DesignPro Manager Converters. For more information, refer to Chapter 5: "Using Converters". DesignPro Manager for AFP User Guide Main The Main category allows you to set the resolution, as well as the record format of the AFPDS output file. You can add and remove spaces between characters and words using the text justification option. This category also lets you shift the generated output along the X or Y-axis and rotate it as required. You can also set the required external resources of the generated AFPDS file from here. The options in the Main category include: Resolution 240 Pels – sets output resolution to 240 pels. 300 R-Units – sets output resolution to 300 resolution units. 600 R-Units – sets output resolution to 600 resolution units. Record Format VBM –creates files formatted for transferring to MVS and VM hosts using IBM 3270 (IND$File) compatible file transfer packages. AS400 – creates files formatted for transfer to AS/400 hosts (feature currently inactive). IRMA – creates files formatted for transferring to MVS hosts using IRMA FTTSO and the compatible file transfer packages to these hosts. AFPDS – creates pure MO: DCA files (with no added formatting) for use in AIX and PC environments and for transfer to MVS and VM hosts (must be reblocked using the AFP reblocking utility of IBM). DOS/VSE – creates files formatted for transfer to DOS/VSE hosts. The resource limit for the DOS/VSE format is 16.7 MB. If a resource in the design exceeds this capacity, an error message is thrown, and conversion is aborted. Text Justification Inter-Word – inserts inline shifts between words to achieve correct word positioning. Inter-Character – places every character at the absolute position. Offset (inch) Use Internal Offset – enables horizontal and vertical offset settings. • X – sets horizontal pixels. • Y – sets vertical pixels. Chapter 6: File Format Dictionary 113 Rotation 0 – rotates pages to 0 degrees. 90 – rotates pages to 90 degrees. 180 – rotates pages to 180 degrees. 270 – rotates pages to 270 degrees. External Resources Destination Directory – options for selecting the destination directory for resources. • Default (from Profile Server) – uses the directory specified in the profile server. • Same as Output File – uses the path of the output file. Replace Existing Resources – uses external resources in lieu of existing resources. Colors The Colors category allows you to set the color format for the AFPDS output file. You can use additive colors, as well as set the maximum color resolution for the generated AFPDS output file. AFPDS Colors category options display. 114 DesignPro Manager for AFP User Guide Color Format Black & white – maps all output colors to black and. Highlight color – maps all output colors to the color selected in the drop down menu. Selecting this option enables the Dithering method drop-down list. Specify the dithering method used during transfer of image to highlight system. OCA color – maps all output colors to the standard 8 OCA colors. Full color (RGB) – maps all output colors to the RGB color patterns. Full color (CMYK) – maps all output colors to the CMYK color patterns. Grayscale – maps all output colors to shaded patterns of black and white. Use Additive Colors Never – does not use additive colors. Only For IM Images – creates full color IM images using a color mapping technique. Use Maximum Resolution – sets the maximum image resolution. Chapter 6: File Format Dictionary 115 Fonts The Fonts category contains options for setting the coded fonts mapping option and the related font resources for the AFPDS output file. You can specify the True Type and Raster fonts output options, as well as use font mapping for the generated AFPDS output file. The Fonts category options display. As appropriate, select or review the following: Map Coded Font 116 MCF format 2 – references all fonts in the overlay using the Map Coded Font format 2 command. • CharSet+CodePage Name – uses character set and code page name to reference fonts. • Coded Font Name – uses coded font name to reference fonts. MCF format 1 – references all fonts in the overlay using the Map Coded Font format 1 command. The available options include: • CharSet+CodePage Name – uses character set and code page name to reference fonts. • Coded Font Name – uses coded font name to reference fonts. DesignPro Manager for AFP User Guide Include Font Resources Never – does not embed fonts. To Inline Resource Group – embeds fonts as part of the overlay or other resource at the beginning of the file which is reserved for “resource groups.” To External Resource File – embeds fonts in the external resource file. The other options available in the Fonts category are: Use Font Mapping – if checked, the font mapping set in the Elixir Resource Map is used. True Type Fonts Output Raster – True Type fonts are converted to AFP raster fonts. Outline (Type 1 PFB) – True Type fonts are converted to AFP outline fonts. True Type – True Type fonts will not be converted, True Type fonts will be retained in the output overlay. Enable Fractional Pointsize – enables support for fonts with fractional point sizes. Raster Fonts Output Bounded – raster fonts are converted as bounded fonts. Unbounded – raster fonts are converted as unbounded fonts. Unbounded fonts are only used on AFP 3800 printers. Full AFP Font – generates a coded font instead of a characterset. Only Used Chars – when a font is exported, only the characters used in the overlay will save in the character set. Set MICR Flag – sets Magnetic Ink Character Recognition (MICR) to magnetically code characters that can be read by special MICR readers. Chapter 6: File Format Dictionary 117 Images The Images category allows you to set image options for the AFPDS output file. You can set the format as well as the size of the image. Images category options display. Include Images Never – does not include images in the output file. To Inline Resource Group – embeds fonts as part of the overlay or any other resource at the beginning of the file, which is reserved for the Resource groups. To External Resource File – embeds the font resources in the External Resource file. Image format 118 IOCA – uses IOCA (Image Object Content Architecture) for all embedded images. IM Image – uses IM image (migration image object) format for all embedded images. GOCA Raw – uses GOCA (Graphics Object Content Architecture) Raw format for all embedded images. DesignPro Manager for AFP User Guide Object Container – sets the image format to Object Container and allows you to select the required Object Container. You can also add a compression type. There are two you can choose from: CCITT G4 (bilevel image) – uses CCITT G4 (bilevel image) for compressing all embedded images. JPEG (full color image) – uses JPEG (full color image) for compressing all embedded images. As appropriate, review or select the following option: Resample to target resolution – changes the image resolution to the resolution specified in the Main category. The change in image resolution will affect the file size, not the image dimensions. Forms The Forms category allows you to include forms in the AFPDS output file. You can also set the AFP printer IPO/PMO rotation feature for the selected overlay in the output file. AFPDS dialog displays the Forms category. Chapter 6: File Format Dictionary 119 In the Forms category, select or review the following: Include Forms Never – never includes forms in the output file. To Inline Resource Group – embeds forms in Inline Resource group (Default). To External Resource File – embeds forms in External Resource file. As appropriate, select or review the following option: Overlay Rotation Support – activates AFP printer IPO/PMO rotation feature for selected overlay. Code Pages Select Code Pages and specify the code page to be used for conversion. The Code Pages category allows you to select the preferred code pages for the required AFPDS output file. AFPDS dialog displays the Code Pages category options. 120 DesignPro Manager for AFP User Guide Preferred Code Pages Name – sets the name of the preferred code page. List displays the names of the added preferred code page names. If no code page is specified, then the converter will use the Default "T1V10500." The list of added code page names. Add – adds the code page name entered in the Name entry box to the list. Delete – deletes the selected code page name from the list. Up – moves the selected code page up in the list. Down – moves the selected code page down in the list. Chapter 6: File Format Dictionary 121 Formdef The Formdef category allows you to include FormDef, as well as the required FormDef support in the AFPDS output file. Formdef category options display. Include FormDef 122 Never – omits FormDef and IMM references from the output file. To Inline Resource Group – embeds FormDef in Inline Resource Group and writes IMM references to the output file. To External Resource File – converts FormDef to External Resources file and writes IMM references to the output file. DesignPro Manager for AFP User Guide Formdef FontFID Support – uses Font FID support feature with the output file. This feature specifies the default behavior of the printer when FormDef uses fonts that cannot be found on the printer. Color Value Support – uses Color Value printer settings. Finish Support – uses Finish support feature with the output file; set for printer supported finishing options, such as folding. Processing Support – uses Processing support feature with the output file; enables post-processing options supported by printer, such as perforation cuts or separation cuts. Nup Support – uses NUP support feature with the output file. Invoke Support – uses Invoke support feature with the output file; enables compatibility to 3800 AFP printers. Verification Id Support – uses Verification ID support feature with the output file; use with IBM InfoPrint 4000 Highlight Color postprocessor to transmit the setup IDs to all CopyGroups in the FormDef. View Support – enables IBM’s Workbench Viewer. Tonersaver Support – uses Toner Saver support feature with the output file. Flash Support – uses Flash support feature with the output file; use with 3800 printers to make carbon copies of printed documents using a “flash” of light during the printing process; flash settings are defined in SubGroup. Adjust Support – uses Adjust support feature with the output file, (available for 3800 printers only); reduces logical page size using L-units; useful when creating booklets that require a gutter for binding. Quality Support – uses Quality support feature with the output file; for AFP printers having a quality setting, where a set value prints a certain quality. Cutsheet Support – uses Cut Sheet support feature with the output file. Input Bin Support – uses Input Bin support feature with the output file. Outbin Support – uses Out Bin support feature with the output file; allows selection of specific bin at the CopyGroup or SubGroup level. Binerror Support – uses Bin Error support feature with the output file; sets command to stop printing if the wrong media is loaded in the printer. Finerror Support – uses Fin Error support feature with output file; sets command to stop printing if the wrong finishing option is set. Chapter 6: File Format Dictionary 123 Pagedef In the Pagedef category, you can set the properties for Pagedef and appropriate encoding options for the required AFPDS output file. The Pagedef category options display. 124 DesignPro Manager for AFP User Guide Select or review the following options: Pagedef Ansi Carriage Control – uses ANSI carriage control with the output file. Set if file contains a carriage control character and PageDef contains a condition. Color Support – uses Color support in PageDef; target printer must support color. Graphic Support – uses Graphic support in PageDef; enables Drawgraphic information to be written to PageDef. Only applicable to record format PageDefs, using Drawgraphics. Object Support – uses Object support in PageDef; enables Object Container information to be written to PageDef. Set when PageDef objects have been defined in an Object List and inserted under a record. Suppress Support – uses Suppress support feature with the output file. Use Internal Pels Per Inch – uses pels per inch value from the Margin category in PageDef properties instead of the resolution set in the AFPDS dialog Main category. Encoding Condition – condition encoding options. Either: • ASCII – uses ASCII encoding. • EBCDIC – uses EBCDIC encoding. Delimiter – delimiter encoding options. Either: • ASCII – uses ASCII encoding. • EBCDIC – uses EBCDIC encoding. Fixed Text – fixed text encoding options. Either: • ASCII – uses ASCII encoding. • EBCDIC – uses EBCDIC encoding. Record Id – record ID encoding options. Either: • ASCII – uses ASCII encoding. • EBCDIC – uses EBCDIC encoding. Chapter 6: File Format Dictionary 125 Page Objects The Page Objects category specifies the various options available for graphics. You can also set options for using barcodes and overlapping objects. The Page Objects category options display. Graphics Use GOCA Graphics – activates IBM Graphics Object Content Architecture. The graphic objects in IBM AFP/MO:DCA data stream are not rasterized (Default). Draw Area Borders Separately – draws graphics object area borders separately. GOCA border and interior Set Process Color method are not used. Either: • Checked – draws graphics object area borders separately. • Unchecked – does not draw graphics object area borders separately; Use GOCA border and interior Set Process Color method (Default). Barcodes 126 Use BCOCA Barcodes – if checked, activates IBM Bar Code Object Content Architecture; does not rasterize bar code objects in IBM AFP/MO:DCA data stream (Default). DesignPro Manager for AFP User Guide Overlapping Object (with unsupported mixing mode) All Rastertize to image – all overlapping objects are rasterized to image. Selection requires greater conversion time. As appropriate, select the following option: Rasterize page contents to image – contents of the input form (or each page of input document) will be converted into an image and will be referenced in the output AFP file (form or document). Setting OGL Converter Parameters To set appropriate conversion parameters for OGL using DesignPro Manager: 1 From the Tools menu in the menu bar, go to Application Format Settings>Output Formats and select OGL. The OGL dialog displays. OGL dialog displays General category options. Chapter 6: File Format Dictionary 127 2 Select the required Category option. 3 Review the dialog selections and make your changes. For information on each category, see below. 4 Click Apply to save the settings, then click OK to return to the application window. You can also access the OGL output settings dialog from DesignPro Manager Converters. For more information, refer to Chapter 5: "Using Converters". General The General category allows you to set the unit of measurement, as well as the record length of the OGL output file. You set the offset using the Offset Values option and required orientation option from the Orientation field. This category also lets you set the source encoding options. The available options include: Unit of Measure Export in units – export unit of measurement options. Either: • IN – sets to inches. • MM – sets to millimeters. • CM – sets to centimeters. • POINTS – sets to points. • PELS – sets to pixels. • CPI/LPI – sets to characters per inches/lines per inch. Offset Values Horizontal – object horizontal offset, per specified unit of conversion. Vertical – object vertical offset, per specified unit of conversion. Use Internal Offset – uses the internal offset feature. Orientation 128 0 – sets to 0 degrees. 90 – sets to 90 degrees. 180 – sets to 180 degrees. 270 – sets to 270 degrees. DesignPro Manager for AFP User Guide Record Length & Sequence Number Record length – fixed record length value. Generate Sequence Numbers – assigns sequence numbers to source code commands. Source Encoding ASCII – uses ASCII encoding. EBCDIC – uses EBCDIC encoding. Use CR/LF – generates a new line (Carriage Return/Line Feed) after each record of OGL output. Misc Keep texts boxed – retains text boxes. Include form description – includes form description in the output file. Keep Fidelity – processes special spacing to persevere actual text positioning. It may result in the generation of separate text commands for each character in the text – varies from case to case. Generate BPSD Tags – generates BPSD tags in the output OGL file. If the input form contains tags, the OGL output will contain BPSD tags; these tags are used via a utility on the mainframe, in response to used tags. Ignore text with white FG & BG color (B/W output) – selecting this option, OGL converter discards the text objects with white foreground and background color, hence, eliminating the undesired text objects. This option works if Black & White color model has been selected. When Black & White color medel is selected, the OGL files use black color for text by default to make the text visible in OGL output. If a PDF file contains some text objects with white foreground and background color (providing an invisible look to the text), then using this option will remove such text to maintain form fidelity. Adjust graphic objects position – shifts the graphic objects placed partially outside the top or left page boundary, inside the page. However, if an object is completely outside the top or left page boundary, it will be ignored. Chapter 6: File Format Dictionary 129 Form The Form category allows you to set overlay properties. You can set the message, storage, and other related options. You can also set switching between double and single byte font using the SOSI feature. OGL Form category displays. Overlay 130 Messages – Determines the printer error modes that display. Either: • All - displays all error and warning messages. • Warnings – displays only warning messages. • Errors – display only error messages. Storage – Storage options for compiled overlays. Either: • Store – saves overlay as a new member (file) in the host dataset (host file). • Do not store - compiles and lists the results but does not store the compiled overlay (use for debugging the source). • Replace – compiles overlay and overwrites existing member (file) having the same name. DesignPro Manager for AFP User Guide Options Generate Summary – sets compiler command to generate summary report as printing ends; summary details on number of resources used and similar statistics is placed at the end of the compiler listing. Recognize Shift Out shift in (SOSI) – enables switching between double and single byte font if the SOSI character is recognized in the text; when checkbox is clear, SOSI character is skipped in the text command and single byte font is used. Font The Font category contains options for enabling the font map and the related font resources. You can also specify the True Type and Raster fonts output options, as well as Text encoding options for the generated OGL output file. OGL Font category options display. Chapter 6: File Format Dictionary 131 As appropriate, review or select the following: Options Use font map – specifies font name exported as a coded font name. Use character set/code page names – specifies font name exported as a charset and code page name pair format. Round Point Size – rounds point size to whole numbers. For instance, 10.8 will round off to 11. True type fonts output Raster – sets to Raster. Outline (Type 1 PFB) – sets to Outline (Type 1 PFB). Font name generation Autogenerate user font names – specifies automatic generation of local font names, such as Ft0000, Ft0001. If not set, the original local names are exported to the file for selection in the overlay list. Text Encoding 132 Character – Windows Charset – font character set options. Either: • Western – sets to Western. • Baltic – sets to Baltic. • Greek – sets to Greek. • Central European – sets to Central European. • OEM/DOS – sets to OEM/DOS. • Cyrillic – sets to Cyrillic. • Symbol – sets to Symbol. • Turkish – sets to Turkish. • Johab – sets to Johab. • Herbew – sets to Herbew. • Arabic – sets to Arabic. Hex – text data will be written to the OGL file in the form of hexadecimal code points. DesignPro Manager for AFP User Guide Color You can specify the Color Model to be used in the OGL output file using the Color category. Color category option displays. Color Model – color format mapping options. Either: • Default – does not use additive colors. • B/W – maps all colors to black and white. • RGB – maps all colors to Red, Green, Blue model. • CMYK - maps all colors to Cyan, Magenta, Yellow, and Black model. Chapter 6: File Format Dictionary 133 Environment The Environment category allows you to set the environment and resource options for the OGL output format. Environment category options display. Select or review the following options: Environment 134 Type – Target environment types. Either: • MVS – sets to IBM Multiple Virtual Storage (MVS) operating system. • VM – sets Virtual Machine (VM). • VSE – sets to Virtual Storage Extended (VSE). Resource – Associated resource names or files for MVS and VM environments. • Fonts – DDNAME of fonts, corresponding to data control block containing the same name for MVS or font file types available for selection for VM. • Page Segments - DDNAME of page segments corresponding to data control block containing the same name for MVS environment, or page segment file types for VM. DesignPro Manager for AFP User Guide Setting PostScript Converter Parameters DesignPro Tools provides print capability for devices that contain PostScript interpreters through the use of PPD files and the PostScript converter. PostScript Printer Description files (PPD) are text files that provide DesignPro Tools with the necessary information about device features, default values for those features, and the PostScript language code to invoke each feature. You are required to obtain PPD files from the device manufacturer, and locate the files to drive:\ELIXIR\PPD_FILES directory. Once PPD files are installed, you can open the Printers dialog through the PostScript converter, and view the manufacturer list of associated devices found in the PPD file. The features of selected devices appear in the PostScript Printer Properties, where they can be changed or accepted with default values. To set appropriate conversion parameters for the PostScript format using DesignPro Manager: 1 From the Tools menu in the menu bar, go to Application Format Settings>Output Formats and select PostScript. The PostScript dialog displays. Chapter 6: File Format Dictionary 135 PostScript dialog displays options for the Printer Properties. 136 2 Select the required Category option. 3 Review the dialog selections and make your changes. For information on each category, see below. 4 Click Apply to save the settings, then click OK to return to the application window. You can also access the PostScript output settings from DesignPro Manager Converters. Please refer to Chapter 5: "Using Converters". DesignPro Manager for AFP User Guide Printer Properties The Printer Properties opens the Printers dialog for selecting appropriate output preferences for language and data type. You can also select the color, fonts, and various resource handling options. In the Printer Properties, review or select the following: Output File Language - postscript output file language level options. Either: • Level 1 – sets to Level 1. • Level 2 – sets to Level 2. • Level 3 – sets to Level 3. • Level 1 with extensions – sets to Level 1 with Level 2 for imaging & color features. Data Type – output file character options. Either: • Clean 7 Bit (Most Portable) – sets to ASCII 27-127 and CR, LF, and TAB. • Clean 8 Bit – sets to “Clean 7 Bit” plus ASCII 128-256. • Binary (Most Efficient) – sets to 256 characters (ASCII 0 – 255). Optimization Optimize For – output file optimization options. Either: • Small File Size – creates as small a file as possible, utilizing printer memory. • Low Printer Memory – uses as little printer memory as possible, can create a file substantially bigger in size than the Small File Size option. Preference – output file processing preference options. Either: • Conversion Speed – substitutes non-equivalent PS graphical features with the nearest PS feature. • Graphics Fidelity – stores transparent graphic objects as images. Color Output Color – output color conversion options. Either: • Black & White – converts colors to gray shades. • Full color – converts colors as defined. • CIE Based – converts colors to the CIELab model colors. Substitute Solid Color for Shades – replaces shades with solid colors, not patterns (not available when Language Level 1 set). CMYK Separations – uses the CYMK model for color separation. Chapter 6: File Format Dictionary 137 Fonts Use Font Mapping – uses font mapping defined by the Elixir Resource Map. Convert True Type Fonts to – converts True Type fonts to either: • Type 1 – Type 1 post script font (default). • Type 3 (Rasterize) – enables the user to rasterize True Type fonts to Type 3 in a Postscript/ VPS document. Preserve name during font conversion – preserves the name of the source font after conversion to target (ATM Type1) font. For instance, selecting this option, font name Ariel will be preserved in the converted Postscript file. Resources Resource Handling – sets image and form embedding and reference option. • Embed All – embeds all images and forms. • Embed Images – embeds images and reference forms. • Embed Forms – embeds forms and reference images. • Reference All – references all images and forms from external file specified in the Path to External Image/Forms. Path To External Images – specifies file path to external images. Extension For External Images – specifies file format extension for path to external images. Path To External Forms – specifies file path to external forms. Extension for External Forms – specifies file format extension for path to external forms. Monochrome Bitmap Images Downsample Grayscale Images – decreases monochrome grayscale image resolution to set image DPI value. Either: • Yes – downsamples images with resolution greater than set DPI to set DPI value. • No – does not downsample image; DPI value not applicable. DPI – targets image resolution for downsampling. Grayscale Bitmap Images 138 Downsample Grayscale Images – decreases grayscale image resolution to set image DPI value. Either: • Yes – downsamples images with resolution greater than set DPI to set DPI value. • No – does not downsample image; DPI value not applicable. DPI – targets image resolution for downsampling. DesignPro Manager for AFP User Guide Color Bitmap Images Downsample Color Images – decreases color image resolution to set image DPI value. Either: • Yes – downsamples images with resolution greater than set DPI to set DPI value. • No – does not downsample image; DPI value not applicable. DPI – targets image resolution for downsampling. Error Handling The Error Handling option allows you to specify options for how to handles errors. Error Handling options display. Review or select from the following: Stop Conversion After – specifies to stop conversion if the following occurs: • Fatal Error – halts conversion only if fatal error. • Error – halts conversion for any error. If Conversion Fails – specifies an action when conversion fails. • Display all errors – displays all errors if conversion fails. Chapter 6: File Format Dictionary 139 Setting PCL Converter Parameters To set appropriate conversion parameters for PCL using DesignPro Manager: 1 From the Tools menu in the menu bar, go to Application Format Settings>Output Formats and select PCL. The PCL dialog displays. The PCL category options are displayed. 140 2 Click the required Category option. 3 Review the dialog selections and make your changes. For information on each category, see below. 4 Click Apply to save the settings, then click OK to return to the application window. You can also access the AFPDS output settings from DesignPro Manager Converters. For more information, refer to Chapter 5: "Using Converters". DesignPro Manager for AFP User Guide Main The Main category allows you to set the required PCL level along with the Color Output and printer shades options. You can add and remove spaces between characters and words using the Text Justification option. The PCL Converter Main category also lets you shift the generated PCL output along the X or Y-axis, as required. You can also set the required Macro Control options from this dialog. Select from the following options: PCL level Pcl Level – PCL level options. Either: • IV – sets to PCL level 4. • V – sets to PCL level 5. Color Output – activates PCL5c language color output feature. Use Built-In Printer Shades – uses printer shade patterns only; does not use userdefined shades. Output mode PCL Commands Only – prints PCL commands only. Use Rasterization – bitmap object print options. Either: • All objects – prints entire page as bitmap. • Complicated objects – rasterizes complex objects (rounded corners boxes, circles, paths, etc.). Output Shift X (Inch) – output page horizontal shift; value between 0-4 inches. Y (inch) – output page vertical shift; value between 0-4 inches. Macro Control Print as Macro – prints each page as a separate macro. Selecting this option enables the following options: • Macro as Overlay – prints the macro as an overlay. • Macro – unique name identifying a macro. Forms as Macro – prints each form as a separate macro. Chapter 6: File Format Dictionary 141 Text Justification None – no justification provided. Inter-Word – inserts inline shifts between words to achieve correct word positioning. Inter-Character – places every character in the absolute position. The other options in the Main category include: Exclude Job/Page Related Command – does not include job or page related commands in the output file. FormFeed after Last Page – appends form feed command to the end of the output file. Generate Info File – generates dimension and output resolution information file. Preserve EAS Compatibility – creates macros that use separate PCL command sequence for defining macros; fonts present in the defined macro will start with Font ID =0. This option is enabled when Print as Macro is selected. If the Print as Macro option is selected along with the Preserve EAS compatibility option, the Macro as Overlay option will be disabled. If Preserve EAS Compatibility option is selected along with the Macro as Overlay option, and the Enable Edge to Edge printing option from the Margins area in the Page category, the effects of these options will be observed in the output PCL file. 142 DesignPro Manager for AFP User Guide Images The Images category allows you to set image options for the PCL output file. You can specify the image resolution as well as convert images into fonts as an output. You can also select from a number of available compression methods for generating the required PCL output file. PCL Images category options display. Resolution DPI – image resolution options. Either: • 240 – sets to 240 DPI. • 300 – sets to 300 DPI. • 600 – sets to 600 DPI. Graphic Language Use vector graphic (hp–GL/2) – format vector graphics using HP-GL/2 graphic language. Chapter 6: File Format Dictionary 143 Image Output Method Convert images into fonts – converts images to font output (tiles). Max Size of Characters (In Pixels) – maximum character width and height, in pixels. • Width – sets the width of characters. • Height – sets the height of characters. Available Compression Method 144 Run-Length Encoding (Mode 1) – simplest compression mode; for use as single selection only (other modes will override selection). Tiff Rev. 4.0 (Mode 2) – TIFF compression mode; can be used alone or with other modes. Delta Row Compression (Mode 3) – delta row compression mode; can be used alone or with other modes. Adaptive Compression (Mode 5) – exclusive mode for adaptive compression; no other compression modes can be used. DesignPro Manager for AFP User Guide Fonts The Fonts category allows you to set various font options for the PCL output file. You can store the fonts used in the PCL at the beginning of the output file or in a separate file. This category allows you to print fonts located in the file as graphics and set other font-related options. PCL Fonts category options display. As appropriate, select or review the following options: Fonts downloading mode Fonts at Beginning of PCL file – places fonts at the beginning of the output file. Fonts into Separate File – places fonts in a separate output file. • Make Fonts Permanent – generates all fonts as PCL printer permanent fonts. No Fonts – does not download fonts. Print Texts as Graphic – prints all text as bitmap. Use user-defined font mapping – activates font mapping using Elixir Resource Map. Chapter 6: File Format Dictionary 145 Download used Fonts only – downloads used fonts only. De-selecting this option will download all the fonts added in the font list to the output PCL file. Download used Characters only – downloads used text characters only. Deselecting this option will download all printable characters into the output PCL file. True Type mode Download as True Type – downloads as scalable fonts. Download as Raster Font – downloads as raster fonts. Print as Graphic – prints all text as bitmap. Characters Compress Glyph Bitmap – activates compressed character bitmap feature. Paper The Paper category allows you to set the source and size of the paper for the required PCL output. PCL Paper category options display. 146 DesignPro Manager for AFP User Guide As appropriate, select the following: Source – paper feed source options. Either: • No Select – does not select any feed source. • Tray 1 – sets tray 1 as the paper source. • Tray 2 – sets tray 2 as the paper source. • Manual Feed – sets paper feed to manual. • From Document – uses the default document feed source. Size – paper sizes that are available for selection. Page The Page category allows you to set the page orientation and mode (simplex/duplex) for the required PCL output. PCL dialog displaying the Page category options. Chapter 6: File Format Dictionary 147 As appropriate, select the following: Orientation – logical page position and default print direction options that are available for selection. Simplex/Duplex Mode – simplex or duplex printing mode options that are available for selection. Error Handling The Error Handling option allows you to specify the error handling options. For more information on this topic, refer to the "Error Handling" on page 139. Simplifier Simplifier is a specialized component used to convert a complex page object to a series of simple objects. The Simplifier is typically used when an input stream supporting a rich set of drawing objects is transformed to an output stream supporting a simpler set of objects. Normally, the Simplifier is automatically activated when needed. However, under certain circumstances, manual control is required. The following options provide access to the Simplifier settings. PCL dialog displaying the Simplifier category options. 148 DesignPro Manager for AFP User Guide Simplifier Usage – simplifier usage options. Either: • None – never uses the simplifier. • Per Page – uses the simplifier on each page. Selecting Per Page for Simplifier Usage activates the options for setting the Simplifier for each page. The Simplifier properties for Per Page option. As appropriate, select the required option for the following: Simplifier category – simplifier categories available for selection. • Box and Ellipse – displays the box and ellipse options. • Brush – displays the brush types. • Clipping – displays the clipping path combinations. • Color – displays the supported color depths. • Image – displays the image type, coloring, number, and resolution options. • Line – displays the line style, width, caption, and join options. • Media – displays the relative media positioning options. • Opacity – displays the raster operation mode and opacity options. • Path – displays the path types and members. Chapter 6: File Format Dictionary 149 • Text – displays the text orientation, replacement, and consistency features. • Transformation – displays the transformation features. For specific options relating to each Simplifier category, see the required Simplifier category option below. Box and Ellipse Selecting Box and Ellipse for the Simplifier category displays Box and Ellipse options in the PCL dialog allowing you to set properties, common or otherwise, for the boxes and ellipses located in the PCL output file. Simplifier properties for Box and Ellipse. 150 DesignPro Manager for AFP User Guide Common Properties Horizontal Splits – uses horizontal lines in split box or table. Vertical Splits – uses vertical lines in split box or table. Diagonals – uses diagonal lines within box. Multiple Fills – uses more than one fill style in shape object. Gaps on Axis Placement – uses empty space to separate two adjacent drawing objects. Box Different Corner Types – uses different corner styles within advanced box. Elliptical Corners – uses elliptical corners on advanced box. Square Corners – uses square corners on simple box. Round Corners – uses rounded corners on advanced box. Zebras – uses gray/green horizontal bar shades on box. Ellipse Circle – supports circles in the PCL file. Arc – supports semicircle (arc) shapes in the PCL file. Pie – supports ellipses resembling Pie chart in the PCL file. Chord – supports the PCL file containing ellipses with a line segment joining two points on the ellipse. Full Ellipse – supports a full ellipse in the PCL file. Chapter 6: File Format Dictionary 151 Brush Selecting Brush for the Simplifier category displays the Brush options in the PCL dialog allowing you to set the Brush Types used in the output file. Simplifier properties for Brush category. Brush Types 152 Tristate – uses three-level shades (light, medium, dark). Standard – uses IBM standard OGL shades. Screen – uses IBM screen OGL shades. Pattern – uses Windows DIB shades. Gradient – uses gradient shading. Solid – uses solid fill shading. Hatched – uses crosshatched shading. DesignPro Manager for AFP User Guide Clipping Selecting Clipping for the Simplifier category displays the Clipping options in the PCL dialog allowing you to set the Clipping Path Combinations for the output file. Simplifier properties for Clipping Path Combinations. Clipping Path Combinations Clipping Path Combinations are used when a portion of the output file overlaps the other. In such cases, the Converter takes out a file clipping of the output file on the basis of the selected operator described below: Copy – selects clipping paths; copies one portion of the output file to the other. And – combines clipping paths using the And operation; selects only that part of the output file where both portions overlap. Or – combines clipping paths using the Or operation; selects only that part of the output file where either of the overlapping portions is located. Xor – combines clipping paths using the Xor operation; selects only that part of the output file where one of the overlapping portions is blank. Chapter 6: File Format Dictionary 153 Difference – combines clipping paths using the Difference operation; selects the smallest combination of the two overlapped portions that contain all elements of both portions. Color Selecting Color for the Simplifier category displays the Color options in the PCL dialog allowing you to set the color depths that are supported in the output file. Simplifier properties for the Color option. 154 DesignPro Manager for AFP User Guide As appropriate, select the following: Supported Color Depths bits per pixel - 1 – supports 1 bit per pixel (2 colors). bits per pixel - 2 – supports 2 bits per pixel (4 colors). bits per pixel - 4 – supports 4 bits per pixel (16 colors). bits per pixel - 8 – supports 8 bits per pixel (256 colors). bits per pixel - 16 – supports 16 bits per pixel (216 colors). bits per pixel - 24 – supports 24 bits per pixel (224 colors). bits per pixel - 32 – supports 32 bits per pixel (232 colors). Image Selecting Image for the Simplifier category displays the Image options in the PCL dialog. You can specify image types and image coloring for the image resources located in the output file. You can also convert images located in the PCL file to fonts and reference as text. The Image option of the Simplifier category allows you to include multiple images in the PCL file and also allows setting the Image Resolution. Simplifier properties for the Image option. Chapter 6: File Format Dictionary 155 As appropriate, enter or select the following: Image Types Inline Image – embeds an image within the document pages. Logo Object Referencing Image Resources – sets references to external images. Image Coloring Multiple Coloring of a Single Image Resource – allows a single image to reference multiple color palettes. Tile to Font Tile Image into Font – converts an image located in the PCL file to a font and references it as text. Image Number Multiple Images – supports multiple images to be included in the PCL file. Image Resolution 156 Horizontal – sets the horizontal resolution of the images included in the PCL file. Vertical – sets the vertical resolution of the images included in the PCL file. DesignPro Manager for AFP User Guide Line Selecting Line for the Simplifier category displays the Line options in the PCL dialog. You can specify the Pen Styles and Pen Fills for lines. For the lines that are used in the output document, you can perform various operations including joining them and specifying the width of the line. Simplifier properties for the Line option. As appropriate, select the following: Pen Styles Solid – supports solid lines in the PCL file. Dash – supports dashed (broken) lines in the PCL file. Dot – supports dotted (broken) lines in the PCL file. Dash Dot – supports broken lines in the sequence of dashes and dots in the PCL file. Dash Dot Dot – supports broken lines in the sequence of dashes and double dots in the PCL file. Long Dash – supports broken lines in the form of long dashes in the PCL file. User Style – supports all lines drawn in any style in the PCL file. Chapter 6: File Format Dictionary 157 Pen Fills Solid Color – supports lines with solid (completely filled) colors in the PCL file. Pattern – supports different patterns of lines in the PCL file. Captions Round – supports a rounded style for the end of a line. Square – supports a squared style for the end of a line. Flat – supports a flat style for the end of a line. Trimmed – supports a trimmed style for the end of a line. Joins Round – supports a rounded style for line intersections. Bevel – supports a beveled style for line intersections. Miter – supports a mitered style for line intersections. Select or review the following option: 158 Thinnest Line Width – sets the minimum line width allowed by the output stream (in 14400 dpi). Thinner lines thicken to the value specified here. DesignPro Manager for AFP User Guide Media Selecting Media for the Simplifier category displays the Media options in the PCL dialog. You can specify the Media settings at the page level and the Relative Positioning of media objects in the generated output file. The Simplifier category displays Media options. As appropriate, select from the following options: Media Media On Page – specifies the media settings at the page level. Relative Positioning AFP – sets AFP relative positioning technique. VIPP – sets VIPP relative positioning technique. Opus – sets Opus relative positioning technique. Chapter 6: File Format Dictionary 159 Opacity Selecting Opacity for the Simplifier category displays the Opacity options in the PCL dialog allowing you to set the Opacity and rasterization operation modes. Simplifier properties for the Opacity option. As appropriate, select the following: Opacity 160 Opaque – fills gaps in dashed lines. Transparent – does not fill gaps in dashed lines. DesignPro Manager for AFP User Guide Raster Operation Modes The Simplifier rasterizes objects into images with correct visibility. An Opacity option must be selected for operation modes to function. Operation modes represent various key combinations: S – uses the Source operation to rasterize objects into images. Sn – uses the Source not operation to rasterize objects into images. Dn – uses the Destination not operation to rasterize objects into images. SDo – uses the Source Destination OR operation to rasterize objects into images. SDx – uses the Source Destination Xor operation to rasterize objects into images. SDa – Uses the Source Destination AND operation to rasterize objects into images. SnDo – uses the Source not Destination OR operation to rasterize objects into images. SnDa – uses the Source not Destination AND operation to rasterize objects into images. SDno – uses the Source Destination not OR operation to rasterize objects into images. SDna – uses the Source Destination not AND operation to rasterize objects into images. SDon – uses the Source Destination OR not operation to rasterize objects into images. SDxn – uses the Source Destination Xor not operation to rasterize objects into images. SDan – uses the Source Destination AND not operation to rasterize objects into images Chapter 6: File Format Dictionary 161 Path Selecting Path for the Simplifier category displays the Path options in the PCL dialog allowing you to set the Path Type and options for the Path Members. Simplifier properties for the Path option. As appropriate, select the following: Path Type Open – supports open paths. Closed – supports closed paths. Closed Only Once – supports the path which is closed from one point. Filled – supports shaded paths. Path Members 162 Move To – uses paths containing Move To segments. Line To – uses paths containing Line To segments. Bezier – use paths with Bezier curves. DesignPro Manager for AFP User Guide A Bezier curve is a curve that is calculated mathematically to connect separate points in smooth, free-form curves and surfaces. Text Selecting Text for the Simplifier category displays the Text options in the PCL dialog allowing you to set text orientation and replacement options. Simplifier properties for the Text option. Chapter 6: File Format Dictionary 163 As appropriate, select the following: Orientation Portrait Print Direction – sets the portrait print direction. Right Angle Print Direction – rotates the print direction to 90 degrees from the direction of the page. Any Print Direction – sets the print direction to 0, 90, 180, or 270 degrees. Right Angle Inline Rotation – sets the character rotation to 0, 90, 180, or 270 degrees. Texts to be replaced by an image Raster font – forces all text to be rasterized. Unmapped raster font – converts all rasterized text to an image object if the original font is not successfully rasterized. System font (True Type) – forces all text referencing TrueType fonts to be rasterized. Consistent Text 164 Not only Consistent text – splits text strings containing inline attribute changes (for example, font, color, style, character rotation, etc.) into discrete attribute strings. DesignPro Manager for AFP User Guide Transformation Selecting Transformation for the Simplifier category displays the Transformation options in the PCL dialog. Simplifier properties for the Transformation option are displayed. As appropriate, select the following: Transformation Stretch – stretches the object. Right Angle Rotation – rotates fonts to 0, 90, 180, or 270 degrees. Arbitrary Rotation – rotates the page object to any degree. Any Transformation – sets unspecified object transformation. Chapter 6: File Format Dictionary 165 Setting PDF Converter Parameters To set the appropriate conversion parameters for PDF using DesignPro Manager: 1 From the Tools menu in the menu bar, go to Application Format Settings>Output Formats and select PDF. The PDF dialog displays the Category options. PDF dialog displaying the Main category options. 166 2 Click the required Category option. 3 Review the dialog selections and make your changes. For information on each category, see below. 4 Click Apply to save the settings, then click OK to return to the application window. You can also access the PDF output settings from DesignPro Manager Converters. For more information, refer to Chapter 5: "Using Converters". DesignPro Manager for AFP User Guide Main The Main category allows you to set miscellaneous options for the PDF output file. You can perform ZIP compression of the output, generate the ASCII output, optimize the file, and convert the file URL into hot spots. The optimization feature lets you set preferences on the basis of conversion speed and graphics fidelity. You can also use user-defined Font Mapping and set non-mapped True Type, ATM, and Raster Font options. Output File ZIP compression – compresses the file using standard PDF compression. Optimize for fast web view – reduces the size of the PDF file so that it can be easily loaded on the web. ASCII output – uses ASCII 32 - 127 characters in the output stream. Optimization Preferences – optimizes the size of the PDF output file on the basis of the specified preference. The options include: • Conversion Speed – substitutes non-equivalent PDF graphical features with the closest PDF feature. • Graphics Fidelity – stores the transparent graphic objects as images. Substitute Solid Color for Shades – optimizes the size of the PDF file by replacing solid colors located in the file with shaded patterns of that color. Preserve Original Page Rotation – preserves the actual page rotation of the file being converted. Omit Blank Pages – discards blank pages located in the output file. Chapter 6: File Format Dictionary 167 Fonts Use User-defined font mapping – uses Font Mapping defined by the Elixir Resource Map. Nonmapped TrueType and ATM fonts – non-mapped TrueType and ATM font handling options. Either: • Embed in the output file – embeds all document fonts in the PDF file. Fonts are embedded as Adobe Type 1 outline format. • Reference to Original Fonts – creates references to external fonts. • Auto Select – automatically creates Multiple Master fonts or embeds fonts in the PDF file. • Replace All with Multiple Master Fonts – creates Multiple Master versions of all fonts in the document. Nonmapped Raster fonts – conversion options for non-mapped Raster Font. Either: • Embed in the Output File – embeds all document fonts into the PDF file as Adobe Type 3 Raster fonts. Use this option when the document fonts are comprised of special characters or images, such as a logo. Embedding character Raster graphics enlarges the PDF file size. • Auto Select – automatically creates Multiple Master fonts or embeds fonts in the PDF file. • Replace All with Multiple Master Fonts – creates Multiple Master versions of all fonts in the document. Images 168 JPEG Compression – converts images using JPEG compression. It reduces PDF file size; however, it may result in some loss of image quality. Quality – specifies the quality level associated with JPEG compression. DesignPro Manager for AFP User Guide Encryption The Encryption category allows you to set password encryption for the PDF output file. You can exclusively set the password options for printing the document, changing it, selecting text and graphics, and adding or changing form fields. PDF dialog displaying the Encryption category options. Use Encryption – enables the encryption of the PDF output. Passwords – options for password protection. The available options include: • Static – uses the password as is; stores it unsecured in the setup file. • Dynamic from Indexes – uses the password from the index in the document. Passwords/Names of Indexes Open Document – sets the password for opening the PDF file or document. Change Security – sets the password for allowing the editing of the document. Chapter 6: File Format Dictionary 169 Do Not Allow Printing – prohibits the user from printing the document. Changing the document – prohibits the user from making any changes to the document. Selecting Text and Graphic – prohibits the user from copying any text or graphics in the document to the Windows clipboard. Adding or Changing Notes or Form Fields – prohibits the user from editing notes or form fields of the PDF document. Active Objects The Active objects category allows you to set border and text attributes. You can also browse for a tag attribute file to attach to the PDF file. PDF options for Active objects displays. 170 DesignPro Manager for AFP User Guide Process Text for Active Objects – processes text tags and EZ Tags and converts them to PDF active objects. Use 3D Border – generates a 3D border for active objects. The settings below apply only to active objects generated from text tags or EZ Tags. EZ Tags Use Options From File – uses the options specified in the tag attribute file. For specifying the tag file, see Tag Attribute File below. Selecting this option will disable the Border Color and Text Color options below. Show Replacement Characters – displays the replacement characters inside the edit boxes created using tags. By default this option is unchecked. Border Color – border color selections for active objects. Text Color – text color selections for active objects. Tag Attribute File – specifies tag file name and path, displays the Open dialog for tag file selection. This file is used to refer to information about linked tags (if any) in the input file. Chapter 6: File Format Dictionary 171 Setting Raster image output in TIFF/BMP format To set the appropriate conversion parameters for TIFF/BMP format using DesignPro Manager: 1 From the Tools menu in the menu bar, go to Application Format Settings>Output Formats and select Image. The Image dialog displays the Category options. The Output Formats option displays in the Image dialog. 172 2 Click the required Category option. 3 Review the dialog selections and make your changes. For information on each category, see below. 4 Click Apply to save the settings, then click OK to return to the application window. You can also access the Image output settings from DesignPro Manager Converters. For more information, refer to Chapter 5: "Using Converters". DesignPro Manager for AFP User Guide Output Formats The Output Formats option allows you to set the appropriate conversion quality options. You can also set the various output formats from the available options. The Autodetect format from file name enables you to automatically identify the format from the extension of the file. Conversion Quality Settings Prefer Image Quality – simplifies images when some objects are not supported by the image format. Prefer Speed – preference conversion speed; normal processing without simplification. Dithering method – specifies dithering method used during transfer of image to highlight system. List displays methods available for selection. The other available options include: Output Formats TIFF – sets to TIFF (Tagged Image File Format). BMP – sets to BMP (Windows Bitmap). PCX – sets to PCX (PC-Paintbrush Format). JPEG – sets to JPEG (Joint Photographic Experts Group). IOCA – sets to IOCA (Image Object Content Architecture). PNG – sets to PNG (Portable Network Graphics). IMG - sets to IMG (GEM Paint). LP3 – sets toLP3 (Elixir Legacy Graphic). Select or review the following option: Autodetect format from file name – automatically identifies format from extension. Chapter 6: File Format Dictionary 173 Drawing Options You can select the appropriate drawing options from the Drawing Options category. The Drawing Options category displays in the Image dialog. 174 Substitute Solid Color for Brushes – replaces brushes with solid color. Halftone bitmaps – uses image halftoning to print bitmaps. Halftone raster fonts – use image halftoning to print raster fonts. DesignPro Manager for AFP User Guide Image The Image category allows you to set image options for the Image output file. You can set the required resolution, the image, as well as the image format compression type. You can also set the available color depths using the Bits Per Pixel option. The Drawing Options category options display. Horizontal Resolution – image horizontal resolution, in dots per inch. Vertical Resolution – image vertical resolution, in dots per inch. Image format – image file format options. Either: • TIFF – sets to TIFF (Tagged Image File Format). • BMP – sets to BMP (Windows Bitmap). • PCX – sets to PCX (PC-Paintbrush Format). • JPEG – sets to JPEG (Joint Photographic Experts Group). • IOCA – sets to IOCA (Image Object Content Architecture). • PNG – sets to PNG (Portable Network Graphics). • IMG – sets to IMG (GEM Paint). • LP3 – sets toLP3 (Elixir Legacy Graphic). Resolution same as source – uses the same resolution as the source. Chapter 6: File Format Dictionary 175 The other options include: Multiple File – selection enables TIFF output to create a separate file for each document page, wherein the converter overwrites the image files. If checkbox is clear, the converter creates one file with embedded multiple images (pages) and appends the TIFF image to the old file. Bits Per Pixel – specifies available color depths (number of bits per one image pixel) for the selected image format. Either: • 1 – sets to 1 bit per pixel (2 colors). • 4 – sets to 4 bits per pixel (16 colors). • 8 – sets to 8 bits per pixel (256 colors). • 16 – sets to 16 bits per pixel (216 colors). • 24 – sets to 24 bits per pixel (224 colors). • 32 – sets to 32 bits per pixel (232 colors). Higher resolutions and higher color depths require larger memory space for processing and storage. Therefore, if the memory limit is reached depending on the specified page size, color depth, and resolution, an error message is generated. 176 Compression – specifies image format compression type. Either: • None – does not use compression. • RLE – uses RLE (Run Length Encoding). • PackBits – uses PackBits • CCITT G3 – uses CCITT Group 3. • CCITT G4 – uses CCITT Group 4. Generate TIFF Class F – saves the image in TIFF class format. Scale To Fit – generates the image according to TIFF Class F specifications (Width=1728, Height=2167, Horizontal Resolution=204, Vertical Resolution=196). De-selecting this option, the output image will be either padded/clipped to make it 1728 x 2167, which is the standard size for TIFF Class F images. DesignPro Manager for AFP User Guide Setting ElxirGDF Converter Parameters To set appropriate conversion parameters for ElixirGDF using DesignPro Manager: 1 From the Tools menu in the menu bar, go to Application Format Settings>Output Formats and select Elixir Form. The ElixirForm dialog displays. 2 Click the required Category option. 3 Review the dialog selections and make your changes. For information on each category, see below. 4 Click Apply to save the settings, then click OK to return to the application window. You can also access the ElixirGDF output settings from DesignPro Manager Converters. For more information, refer to Chapter 5: "Using Converters". Chapter 6: File Format Dictionary 177 Main The options in the Main category include the object preferences for the target format. You can select the various resource options and also set the color category for the output format. Preference Editability (Simplify Unsupported Objects) – changes complex objects into a series of simple objects by replacing unsupported object properties with similar "simple" properties (Defalut). Fidelity (Rasterize Unsupported Objects) – ensures fidelity level of object in .ELX format is the same as the original file by rasterizing object image instead of an .ELX-compatible version of the object. Objects converted to raster image are not easily editable. Resources Destination Directory – resource destination directory options. Either: • Default (from Profile Server) – uses directory specified in the profile server. • Same as Output File – uses the output file path. Replace Existing Resources – uses external resources in lieu of existing resources. Max length of resource name – specifies maximum characters used for resource name. Colors 178 Only BLACK & WHITE output – converts all input file colors to black and white. Map CMYK colors to RBG – maps all CMYK colors (Cyan, Magenta, Yellow, and Black) to RGB color model. Convert Background Gray Color to Pattern – converts all input file gray background color to a pattern. DesignPro Manager for AFP User Guide Images The Images category specifies the image resource options. Images category options for ElixirForm are displayed. As appropriate, select or review the following options: Export External Image Resources – exports external image resources during conversion. Image Type – image format options. Either: • BMP – sets to Windows Bitmap. • LP3 – sets to Elixir Legacy Graphic. Chapter 6: File Format Dictionary 179 Fonts The Fonts category specifies the available font preferences. Export Fonts (External Resources) – exports all font resources to the external files during conversion to ElixirForm; External resources destination directory is specified in the Resources category, Destination Directory. Raster Fonts Output 180 Simple Elixir – creates Elixir fonts. Bounded – creates bounded fonts. Unbounded – creates unbounded fonts. Create PC Mapped Font – converts coded fonts to Elixir fonts with user preferred KMP file. Selecting this option enables the KMP option. • KMP – refers to the Keyboard Map File. Same as source – uses the same font type as source font. • X1 – sets to unbounded X1 type font. • X2 – sets to unbounded X2 type font. • X4 – sets to unbounded X4 type font. DesignPro Manager for AFP User Guide Embedded Outline Fonts (PostScript, Pdf) Use User-Defined Font Mapping – activates font mapping using Elixir Resource Map. Non Mapped Outline Fonts – options for outline fonts that are not mapped. Either: • Reference to TrueType by Original Name – replaces with system TrueType fonts using original font name. • Rasterize – rasterizes font. Rasterize fonts not available on system – converts outline fonts to AFP raster fonts, if font name is not found in the system. True Type Fonts – True Type font output conversion options. Either: • Rasterize all – rasterizes all TrueType fonts. • Rasterize Temporary TT Fonts – rasterizes only temporary TT fonts. Round Pointsize – rounds font point size to full value. Select or review the following options: Text Encoding – font character set options. Either: • Western – sets to Western. • Baltic – sets to Baltic. • Hangul – sets to Hangul. • Hebrew – sets to Hebrew. • Greek – sets to Greek. • OEM/DOS – sets to OEM/DOS. • Symbol – sets to Symbol. • Turkish – sets to Turkish. • Thai – sets to Thai. • Central European – sets to Central European. • Cyrillic – sets to Cyrillic. • Vietnamese – sets to Vietnamese. • Arabic – sets to Arabic. Use also for TT fonts – uses selected character set option for TrueType fonts. Use Unicode always – always uses Unicode for text encoding. Chapter 6: File Format Dictionary 181 Setting Elixir Form Converter Parameters To set appropriate converter parameters for Elixir Form using DesignPro Manager: 182 1 Select resource files, and then drag and drop the file(s) onto the Converters icon in the Applications view. The Converters dialog will open, enabling you to set input and output conversion settings before initiating the conversion. For more information on using converters, refer to Chapter 5: "Using Converters". 2 Select Elixir Form from the Output Formats list. The Elixir dialog displays. 3 Click the required Category option. 4 Review the dialog selections and make your changes. For information on each category, see below. 5 Click Apply to save the settings, then click OK to return to the application window. DesignPro Manager for AFP User Guide Resources In the Resources category, you can select the appropriate preferences for embedding and archicing resources. Select or review the following options: Embedding Resources in the Output File – apecify the appropriate resource embedding options from: • None – does not embed resources in the output file. • All – embeds all of the resources in the output file. • Only Selected – embeds only the selected resources in the output file. Archiving – (feature currently inactive). Fonts Specify the font mapping options for Elixir resources. Select or review the following option: Use Font Mapping – activates font mapping using Elixir Resource Map. Chapter 6: File Format Dictionary 183 Setting PPFA Converter Parameters To set appropriate conversion parameters for ElixirGDF using DesignPro Manager: 1 From the Tools menu in the menu bar, go to Application Format Settings>Output Formats and select Elixir Form. The PPFA dialog displays. The PPFA General category options are displayed. 184 2 Click the required Category option. 3 Review the dialog selections and make your changes. For information on each category, see below. 4 Click Apply to save the settings, then click OK to return to the application window. You can also access the PPFA output settings from DesignPro Manager Converters. For more information, refer to Chapter 5: "Using Converters". DesignPro Manager for AFP User Guide The resource limit for the DOS/VSE format is 16.7 MB. If a resource in the design exceeds the capacity, an error message is thrown. General The General category allows you to set miscellaneous options for the PPFA output file. You can replace existing page and form definitions with new output using the Replace in Library option. You can generate smart code and comments for the PPFA output file. You can also specify the default document options for the measurement units. General Replace in Library – replaces existing page and form definitions with new output; must be set to overwrite files on the host. Generate Smart Code – uses smart codes to suppress output PPFA defaults. Comments Generate Comments – comment inclusion options. Selecting this option enables the following options: • Preceding Command – adds comments before source code commands. • Embedded Within Command – embeds comments in source code. • Following Command – appends comments to commands termination. Measurement Units Document Defaults – uses same measurement unit specified for the document. Custom – export unit of measurement options. Either: • IN – sets to inches. • MM – sets to millimeters. • CM – sets to centimeters. • POINTS – sets to points. • PELS – sets to pixels. • CPI/LPI – sets to characters per inches/lines per inch. Chapter 6: File Format Dictionary 185 Font The Font category allows you to set various font options for the PPFA output file. You can store the fonts used in the PCL at the beginning of the output file or in a separate file. This category allows you to print fonts located in the file as graphics and set other font-related options. The PPFA Font category options display. Fonts Suppress Font References – suppresses font references in output. Use Font Map – activates Font Map, which enables the converters to use userdefined mappings in the Resource Map. Use Coded Font Name – uses coded font name to reference fonts. Round Point Size – rounds point size to whole numbers. Resolution 186 240 – sets resolution to 240 DPI. 300 – sets resolution to 300 DPI. DesignPro Manager for AFP User Guide True Type Fonts Output Raster – sets to AFP raster fonts. Outline (Type1 PFB) – sets to AFP outline (Type1 PFB). FormDef The FormDef category allows you to include FormDef support options, as well as the required printer specific settings. The settings also include Post Printing and Error Handling options for the PPFA output file. PPFA FormDef category options display. Chapter 6: File Format Dictionary 187 Select or review the following options: FormDef Supports 188 General – general options available are displayed. • Adjust – (available for 3800 printers only), reduces logical page size using Lunits; useful when creating booklets that require a gutter for binding • CutSheet – enables support for cut sheet printer. • Invoke – enables compatibility to 3800 AFP printers. • N_UP – enables support for NUP in FormDefs. • Presentation – enables presentation (i.e., orientation, print direction, simplex/ duplex printing, etc.) support on 3800 printers. • PelsPerInch – uses internal pels per inch for FormDef. Printer Specific – includes the following printer specific options: • Flash – uses with 3800 printers to make carbon copies of printed documents using a “flash” of light during the printing process; flash settings are defined in SubGroup. • FontFID – uses if FormDef uses specified fonts, or when a raster font of a specified resolution and metric-technology cannot be found on the printer. • Media – uses with cut sheet printers that have a media setting to differentiate between bins. • Quality – uses for AFP printers having a quality setting, where a set value prints a certain quality. • TonerSaver – uses to enable support for toner saver. • VerificationID – uses with IBM InfoPrint 4000 Highlight Color postprocessor to transmit the setup IDs to all CopyGroups in the FormDef. Post Printing – specifies the following post printing options: • Finish – sets for printer supported finishing options, such as folding. • OutBin – sets for selection of specific bin at the CopyGroup or SubGroup level. • Processing - enables post-processing options supported by printer, such as perforation cuts or separation cuts. Error Handling – error handling options include: • BinError – sets command to stop printing if the wrong media is loaded in the printer. • FinError – sets Finishing Error warnings. • ColorValue - uses Color Value printer settings. DesignPro Manager for AFP User Guide PageDef The PageDef category allows you to select the General color and object options along with the Barcode options. PPFA dialog displays the PageDef category options. General Color – uses the Color support feature with the output file. Object – uses the Object support feature with the output file. PelsPerInch – enables support for pels per inch in PageDefs. Uses line spacing defined in form properties. If it is not specified, printer's default settings will be used. Chapter 6: File Format Dictionary 189 Barcodes Ratio – specify ratio for barcodes in PageDefs. Uses ratio settings for barcode specified in PPFA record properties. If it is not specified, the default settings for the printer will be used. Height – specifies height for barcodes in PageDefs. If it is not specified, the default settings for the printer will be used. ModWidth – specifies width for barcodes in PageDefs. If it is not specified, the default settings for the pringer will be used. Encoding The Encoding category for PPFA specifies the source encoding options. You can also select the record length and generate sequence numbers option. Various text encoding options are also available. The PPFA Encoding category options display. 190 DesignPro Manager for AFP User Guide As appropriate, select or review the following options: Source Encoding ASCII – uses ASCII encoding. EBCDIC – uses EBCDIC encoding. Use CR / LF – generates a new line (Carriage Return/Line Feed) after each record. Record Length & Sequence Number Record Length – fixed record length value. Generate Sequence Numbers – assigns sequence numbers to source code commands. Text Encoding Fixed Text Charset – fixed text encoding option. Either: • ASCII – uses ASCII encoding. • EBCDIC – uses EBCDIC encoding. Condition – condition encoding options. Either: • ASCII – uses ASCII encoding. • EBCDIC – uses EBCDIC encoding. Record ID – record ID encoding options. Either: • ASCII – uses ASCII encoding. • EBCDIC – uses EBCDIC encoding. Delimiter – delimiter encoding options. Either: • ASCII – uses ASCII encoding. • EBCDIC – uses EBCDIC encoding. Chapter 6: File Format Dictionary 191 Working with Elixir Properties The Elixir properties settings in the Visual PPFA, Manager, and Form Editor modules are used to configure the Elixir Internal Setup file (.EPM). The .EPM file is used for storing the individual converter (input and output) properties and the internal settings for resource handling. A single .EPM file can be used to store all input, output, and internal settings for a single instance. Alternatively, a combination of the .EPM files can be used. For example, a single .EPM file could be used to store the settings for PDF output format, while another stores settings for the AFPDS input, and another for the PPFA input. The .EPM for PDF files could then be used with both inputs to provide consistency. The resources settings control the methods used to locate document resources by directing the input converters to find resources if they are not found in the paths specified for the converters property page. The input converters use the following order when searching for resources: 192 1 Native-format resources: paths specified for the input converter property page. 2 Native-format resources: default paths specified in the Options dialog, System Data category. 3 Elixir-format resources: paths specified in the input converter property page. 4 Elixir-format resources: default paths specified in the Options dialog, System Data category. 5 Resource options specified in the internal settings: once a converter completes the resource search methods described in items 1 through 4, it uses the internal settings look-up scheme if the resource location remains irretrievable. DesignPro Manager for AFP User Guide Elixir Properties Definitions To set Elixir Properties using the DesignPro Manager: 1 From the Tools menu in the menu bar Tools>Application Format Setting and select Elixir Properties. The Elixir dialog displays. 2 Click the required Category option. 3 Review the dialog selections and make your changes. For information on each category, see below. 4 Click Apply to save the settings, then click OK to return to the application window. Chapter 6: File Format Dictionary 193 Resources In the Resources category, you can select the resource converters and assign the converting order to resources. You can also specify the option to replace missing resources. Select or review the following options: Resource Searching Available resource converters – resource converter formats available for selection. Resource Searching Order – resource converter search order ([Input Parser] is built-in resource handler for input file resources). Resource Replacing Replace Missing Resources With Defaults – use defaults for missing resources. To search for resources: 194 1 Click and to move items between the Resource searching box. 2 Click and to move items between the Resource Searching Order box. DesignPro Manager for AFP User Guide Resource Library In the Resource Library, you can set the preferences for importing resources. The Resource Library category options display. Rules for Importing Resources to Libraries – resource import rules options. Either: • Do not Import Resources – does not import resources. • Import Missing Resources Only – imports missing Elixir Resource Library resources only. • All Resources, Overwrite any existing – imports all resources; overwrites existing resources. • All Resources, Prompt before overwriting – imports all resources; prompts before overwriting existing resources. Chapter 6: File Format Dictionary 195 Caching Caching options control the number of pages kept in memory during conversion. The Caching category options are displayed. Caching 196 Cache Size – number of document pages to be kept in memory; Set at 0 to retain an unlimited number of pages in memory. Virtual Memory Usage Limit – maximum available virtual memory, in megabytes. “0” setting allows unlimited caching. DesignPro Manager for AFP User Guide Chapter 7: File Transfers In this chapter... PC-to-z/OS (MVS) Host File Transfer PC-to-IBM z/VSE Host File Transfer PC-to-IBM iSeries (AS/400) File Transfer Extracting Object Files from the AS/400 to a PC This chapter describes procedures for files transfer between your PC and a MVS host computer, between your PC and a DOS/VSE host and between your PC and an AS/400 computer using a PC-to-host file transfer package. It also provides information on how to configure host connections, specify font libraries, and download and upload files between an AFP host and a PC. PC-to-z/OS (MVS) Host File Transfer You can use any host-to-PC file transfer package that allows binary file transmission to transfer AFP font, page segment image, one-page overlay, multi-page AFPDS and object Pagedef and Formdef files between a z/OS host and your PC. There are two most common file transfer methods are: IND$FILE – this method uses IBM’s host file transfer program. PC-based terminal emulation and file transfer packages (like IBM’s Personal Communications) communicate with this program to transfer files. FTP – this method uses standard FTP protocols. Binary file transfer ensures that character code translation does not occur. This requirement is necessary because all AFP files (except OGL and PPFA source files) generated on your PC by DesignPro Tools are similar to programs and must not be modified during file transfer. 197 Text-based files like OGL and PPFA source code, on the other hand, must typically be translated from the PC-based ASCII character encoding to the EBCDIC encoding used by the host. Most transfer packages that support binary transfer also support text transfer. Downloading Files Note the following before downloading files to your PC. Downloading Object files Object-format AFP files are not in human-readable format, and are typically stored in datasets with the following DCB specifications: RECFM =VBM LRECL = 8205 BLKSIZE =8209 The LRECL and BLKSIZE settings for fonts may be different. To download object format AFP files (all except OGL and PPFA source files), use the “binary” transfer mode. Files can be transferred directly from host system libraries to the appropriate PC folders. 198 IND$FILE transfer – specify the Binary option. FTP transfer – set the transfer type to BINARY. DesignPro Manager for AFP User Guide Downloading Source files OGL and PPFA source code files can be downloaded in one of two formats: With character code translation This method converts the source code from host EBCDIC to PC ASCII encoding. This is the typical transfer method and allows the source files to be read in Windows-based editors like Wordpad or Notepad. Note that while using this method, it is possible that some character code mistranslation could occur (due to the mapping table used by the transfer program). If this occurs, use the second method described below: IND$FILE transfer – specifies the Text and CRLF options. FTP transfer – sets the transfer type to ASCII. The ASCII parameter specifies that the file be converted from EBCDIC to ASCII, whereas the CRLF parameter specifies that records in the PC files should be separated by carriage return/line feed combinations. Without character code translation This method preserves the EBCDIC character encoding used by the host. Since the characters are not translated during the transfer, there is no risk of character code mistranslation. Files transferred using this method cannot be viewed in Windows-based editors like Wordpad or Notepad. IND$FILE transfer – specifies the Binary and CRLF options. FTP – sets the transfer type to Binary. This method can only be used if the host dataset uses fixed-length records (i.e. RECFM=FB). Note the record length (LRECL) value. This length must be specified when loading the OGL or PPFA files into the DesignPro Tools applications. Chapter 7: File Transfers 199 Working with Overlay and MO:DCA Document files If you want to download and edit one-page overlay (OVE) or multi-page MO:DCA document, first download all fonts and images referenced by the OVE or AFPDS files to then convert them to Elixir font, image, and screen format files. Since conversion to Elixir isn’t mandatory, it might be better to make this para more generic and emphasize the need to make sure all fonts and page segments are downloaded before editing or converting the form or document. Working with Fonts DesignPro Tools can work directly with AFP raster fonts in bounded and unbounded box formats. DPT can also work with overlays and documents that reference AFP outline and TrueType fonts, but rather than directly processing the fonts, the names must be mapped to Windows fonts in the Resource Map. The default folder for downloaded AFP fonts is drive:\Elixir\Fonts\AFP. Each AFP bounded box and unbounded box font consists of the following three files, all of which you must download: Coded font file Code page file Character set file The coded font file contains the code page file name and the character set file name. The first two prefix characters of a coded font file name are as follows: If the AFP font is a bounded box font, the first two characters are X0. If the AFP font is an unbounded box font, the first two characters range from X1 - XG. The code page file is a table file that assigns hexadecimal positions to each character in the character set file. The code page file name starts with prefix T1. You can use one code page file for multiple character set files. 200 DesignPro Manager for AFP User Guide The character set file contains the bit-map font characters. The first two prefix characters of a character set file name are as follows: For a bounded box font, the first two characters are C0. For an unbounded box font, the first two characters range from C1 - CG. Input Directory Information The following table shows the directories to which you must download the AFP files for use by the DesignPro Tools applications: File Type Extension Input Directory Coded Font None \Elixir\Fonts\Afp Code Page None \Elixir\Fonts\Afp Character Set .300, .240 \Elixir\Fonts\Afp AFPDS (document) .AFP \Elixir\docs\afp Overlay (object) .OVE \Elixir\Forms\Afp Overlay (source) .OGL \Elixir\Forms\Ogl Page Segment .SEG \Elixir\pics\afp Pagedef (object) .OBJ \Elixir\Jobs\Afp Formdef (object) .OBJ \Elixir\Jobs\Afp Pagedef (source) .SRC \Elixir\Jobs\PPFA Formdef (source) .SRC \Elixir\Jobs\PPFA Chapter 7: File Transfers 201 Uploading Files The file transfer procedure is determined by the type of file you want to upload or download: Object-format AFP files such as multi-page AFPDS, one-page overlays (OVE), AFP fonts, page segment images, Pagedefs or Formdefs. Source text files such as OGL and PPFA. Uploading Object-Format AFP Files There are two file transfer methods that can be used for uploading object-format AFP files to z/OS hosts. IND$FILE – this method uses IBM’s host file transfer program. PC-based terminal emulation and file transfer packages (like IBM’s Personal Communications) communicate with this program to transfer files. Files are transferred directly to the target printer resource dataset. FTP – this method uses standard FTP protocols to transfer files to an intermediate host dataset. IBM’s reblocking program AFRREBLK is then used to reformat and copy the resources to the appropriate printer resource dataset. AFRREBLK is a host program installed with Print Services Facility. To upload an AFP object-format file to your host using the IND$FILE method: 1 Save or convert the resource to AFP format using one of the DesignPro Tools applications. In the output properties, set the Output Format option to VBM. 2 Transfer the file to the target host dataset using the Binary and CRLF settings. To upload an AFP object-format file to your host using the FTP method: 202 1 Save or convert the resource to AFP format using one of the DesignPro Tools applications. In the output properties, set the Output Format option to AFPDS. 2 Transfer the resource to the intermediate dataset on the host using the Binary transfer setting. 3 Run the AFRREBLK program using the intermediate dataset as the source and the printer resource dataset as the target. See IBM’s’AFRREBLK documentation for details. DesignPro Manager for AFP User Guide Uploading Text Files OGL and PPFA source code files can be uploaded in one of two formats: With character code translation This method converts the source code from PC ASCII to host EBCDIC encoding. This is the typical transfer method used for text-based files. When using this method, it is possible that some character code mistranslation could occur (due to the mapping table used by the transfer program). If this occurs, use the second method described below. When saving or converting forms, Pagedefs and Formdefs to OGL or PPFA source code format, select the ASCII and Use CR/LF options in the Source Encoding section of the output property page. Use the following options for file transfer: IND$FILE transfer – specifies the Text and CRLF options. FTP transfer – sets the transfer type to ASCII. The ASCII parameter specifies that the file be converted from ASCII to EBCDIC, whereas the CRLF parameter specifies that records in the files are delimited with carriage return/line feed characters. Without character code translation This method preserves the character encoding used in the file. Since the characters are not translated during the transfer, there is no risk of character code mistranslation. The host uses EBCDIC encoding, so the DesignPro Tools application must be set up to write the OGL and PPFA source files using this encoding. In the output property page, set the Source Encoding option to EBCDIC and deselect the Use CR/LF option. Next, in the Record Length & Sequence Number section, set the Record Length to match the LRECL of the target host dataset (typically 80). This is only valid for fixed-length record datasets (RECFM=FB, FBA or FBM). Use the following options for file transfer: IND$FILE transfer – specify the Binary option. FTP – set the transfer type to Binary. Chapter 7: File Transfers 203 PC-to-IBM z/VSE Host File Transfer You can use ICCF (or a comparable program that supports binary file transmission) to transfer AFP font, page segment image, one-page overlay, multi-page AFPDS and object Pagedef and Formdef files between a z/VSE host and your PC. Downloading Files The instructions for downloading files are as follows: Downloading Object files Object-format resources cannot be downloaded to a PC directly from a phase format library. Instead, they must be first be reblocked to fixed-length 80 byte records using IBM’s AFPREBLK program. Note that all input data must consist of AFP structured field records with a x’5A’ control character at the beginning of each record. 204 1 Run the AFPREBLK program using the PARM=’AFP2PC’ setting. The input file will be SYS001, DLBL AFPVBIN (variable-length blocked file). The output will be written to SYS002,DLBL AFPPCOT (fixed-length 80 byte file). 2 Copy the contents of the output file (AFPPCOT) to the POWER spool queue. 3 Use ICCF (or a comparable transfer program) to download from the spool to the PC. DesignPro Manager for AFP User Guide Uploading Files The instructions for uploading files are as follows: Uploading Object Files AFP object-format require special formatting to be uploaded to a z/VSE host. This formatting wraps the AFP information in z/VSE link editor statements. The file is then transferred to a host spool file, where it is transferred to the target printer library file. 1 The first step is to customize the JECL/JCL template file. This file is named CL4.DEF and resides in C:\Program Files\Elixir Technologies\Bin. The file can be edited using a text editor, for example Notepad or Wordpad. The CL4.def file contains the following JECL and JCL. Any of the POWER or JCL statements can be edited. Do not modify the contents of the “{TXT}” line. * $$ JOB JNM={JOB},DISP=D,CLASS=0 * $$ LST DISP=H,CLASS=X,DEST=(*,NAME) // JOB {JOB} // LIBDEF PHASE,CATALOG=LIB.SUB // OPTION CATAL INCLUDE PHASE {JOB},S {TXT} text delimiter ** do not touch ** /* // EXEC LNKEDT /& * $$ EOJ 2 In a DesignPro Tools application, save or convert the desired resource to AFP format, selecting DOS/VSE as the Output Format in the output property page. This process will merge the AFP object with the JECL/JCL from CL4.def. 3 Transfer the file from the PC to the host, using ICCF option 386 with the SENDFILE command: SEND file A:file (BINARY LRECL=80 NOCRLF) Where file is the PC filename and A:file is the terminal emulation session and spool file name. 4 Use ICCF option 385 to transfer the file to an ICCF library, then save to a SAM file (use DITTO or IDCAMS REPRO). Chapter 7: File Transfers 205 PC-to-IBM iSeries (AS/400) File Transfer This section describes how to upload your files to an iSeries computer. The requirements for file transfer are: You must install PC Support on your PC. You must attach your PC to an AS/400. You must activate the Shared Folders function of your PC Support session. Transferring PC-to-IBM AS/400 File The main steps involved in the transfer are as follows: 206 1 Convert form, image, font, or document files to AFP format. Specify [AS400] as the output format in the appropriate converters dialog. For information on file conversions, refer to Chapter 5: "Using Converters". 2 Create an AS/400 library and file to use as a temporary storage area for the uploaded resources. 3 Copy the AFP resource(s) to a Shared Folder directory. 4 Move the resource(s) from the Shared Folder to the temporary file using the CPYFRMPCD command (Copy From PC Document). 5 Install the resource(s) into the appropriate AFP library using one of the OS/400 AFP resource creation commands (CRTFNTRSC, CRTPAGSEG, or CRTOVL). You must identify the libraries your installation uses for storing print-ready AFP resources. DesignPro Manager for AFP User Guide The following sections describe these steps in more detail. Creating a Temporary Holding Library and File on the AS/400 To create a library and file on the AS/400, enter the following commands on the command line in your AS/400 session (in the following examples, the library and file that generate are ELXLIB and TEMP, respectively). CRTLIB LIB (ELXLIB) <Enter> This command creates the ELXLIB library. CRTPF FILE (ELXLIB/TEMP) RCDLEN(1024) LVLCHK (*NO) <Enter> This command creates a physical file with the following attributes: Record length = 1024 Record Format Level Check = NO Copying to the Shared Folder DesignPro Manager sees the Shared folder as a standard PC hard drive and typically assigns the drive letter I. You may want to create a directory on the Shared folder drive for holding the resources you copy (in the following example, we use the \Elxfold directory). 1 To create the directory, pull down the System menu and select [Make Directory], or press <CTRL> + <M>. In the dialog that displays, type: I:\Elxfold 2 Click OK to create the new directory. 3 To copy resources to the new Shared folder directory, open the output folder for the resource you want to upload (for example, for overlays, open the AFP OVE folder). 4 Select the resources and copy them to the User Files icon. In the dialog box that displays, enter I:\Elxfold on a blank line and click on OK. The resource(s) copy to the Shared folder. Chapter 7: File Transfers 207 Installing the Resources in the AFP Libraries You must now move the resource file(s) from the Shared folder into the temporary file and then reformat them to AS/400 database format. First move the resource from the Shared folder to the temporary file by issuing the Copy From PC Document command at the AS/ 400 console session. The syntax for the command is as follows: CPYFRMPCD FROMFLR(ELXFOLD) TOFILE(ELXLIB/TEMP) FROMDOC(resource.nam) TRNTBL(*NONE) where resource.nam is the name of the resource file you are uploading. Next, reformat the resource into an AS/400 database object by issuing one of the following commands. Note that the resource name is used without the 3-character extension: Overlays - CRTOVL (Create Overlay) CRTOVL OVL(OVE300/resource) FILE(ELXLIB/TEMP) where OVE300 is the installation name for the AFP Overlay library. Fonts - CRTFNTRSC (Create Font Resource) CRTFNTRSC FNTRSC(FONT300/resource) FILE(ELXLIB/TEMP) where FONT300 is the installation name for the AFP Font library. Page Segments - CRTPAGSEG (Create Page Segment) CRTPAGSEG PAGSEG(SEG300/resource) FILE(ELXLIB/TEMP) where SEG300 is the installation name for the AFP Page Segment library. The resource(s) are now ready for use with your AFP printer. 208 DesignPro Manager for AFP User Guide Printing Fully Composed AFPDS Documents You can also upload and print fully composed AFPDS documents. To upload AFPDS files, follow the steps above for moving the file from the PC to the Shared Folder. Issue the CPYFRMPCD command as above (you may want to move the document into a file other than TEMP if you want to save the document). To print, issue the following command: PRTAFPDTA FILE(DOC300/TEST) [FIDELITY(*CONTENT)] where DOC300 is the installation AFP Document Library and TEST is the file to print. FIDELITY(*CONTENT) is optional. Extracting Object Files from the AS/400 to a PC Extracting files from the AS/400 involves creating a special type of AS/400 file called a save file, then saving the AS/400 AFP resource object (a font, overlay etc.) to the save file. To convert the file into AS/400 database file format, you must: Send the file to your own userid. Receive the file into an AS/400 database file that you created. Both files (AFP resource object file and save file) must have the same record length. Use the following commands and procedures on the AS/400 to extract AS/400 objects to a standard AS/400 database file: 1 CRTSAVF Objname <Enter>. Make a note of where (which library) you created this file (displays in the return message). 2 SAVOBJ objname LIB (libname) DEV(*SAVF) OBJTYPE(*objtype) SAVF(libname/objname) <Enter>. 3 SNDNETF objname TOUSRID ((YourUserID SameSystem)) <Enter>. 4 WRKNETF YourUserID <Enter>. Chapter 7: File Transfers 209 5 Press PF11 (Display Type/Records). Make a note of the record length (recl) of the file you just sent yourself. 6 CRTPF afpfile RCDLEN (recl) FILETYPE(*DATA) LVLCHK(*NO) <Enter>. (This step might be redundant if completed earlier.) 7 Select option 1 (receive network file) from the WRKNETF screen. 8 Receive the file into the AFPFile you created earlier. Once the objects migrate to a database file, you can download them to the PC using: 210 AS/400 PC Support (specify transfer type 6 - no ASCII to EBCDIC conversion) CPYTOPCD (Copy to PC Document) command on the AS/400 to copy the member to the shared folder using a translation table of (*NONE). DesignPro Manager for AFP User Guide Chapter 8: Stand-Alone Utilities In this chapter... Using the Utilities Supplied Utilities Additional Utilities This chapter describes how to use the stand-alone utilities provided with DesignPro Manager and explains the additional utilities that come with the DesignPro Tools Suite. Using the Utilities DesignPro Manager provides a number of DOS-based and Windows-based stand-alone Utilities. Utilities are service programs that are designed to perform everyday tasks, such as verifying the validity of your product license, etc. Running Windows-Based Utilities To run Windows-based utilities, click the icon associated with the utility in the Tools and Utilities view in the DesignPro Manager. Running DOS-Based Utilities Run DOS-based utilities from a DOS window. To open a DOS window: Windows NT - Click Start>Programs>Command Prompt. or Windows 2000 and Windows XP- Click Start>Run… then type Command in the Run dialog and click OK. 211 To display parameters required to run a utility, select the appropriate program files folder and enter the name of the utility (without following keywords). To run a utility, select an appropriate Program Files folder and enter the utility name, filename (including path and extension), and utility parameters. To use defaults, omit all parameters. Otherwise, enter all parameters. For optional utility parameters enclosed in brackets [ ], enter the appropriate option parameter. Most utilities accept DOS wild card characters. To facilitate running DOS utilities, add the Elixir Technologies\Bin folder to the Windows PATH environment variables. This will allow running utilities from any folder without adding the full path to the utility location. Supplied Utilities This version of DesignPro Manager installs utilities to %ElixirBinDir%. Details about these utilities are provided in the following sections: Tools and Utilities Additional Utilities Tools and Utilities DesignPro Manager for AFP installs shortcut icons to the following supplied tools and utilities for easy access from the Manager workspace: 212 Shortcut Name Executable Product Registration Password.exe Display Password File Disppw.exe Display Key Showbd32.exe Display PC Serial Number Showpc.exe Update Key Updkey.exe AFPDS Tree AfpdsTreeu.exe Icon DesignPro Manager for AFP User Guide Product Registration – Password.exe When you connect to the Internet after installing the software, running Password.exe triggers the online registration process and generates a soft key based on the supplied user information. On successful completion of the registration process, a Password.epw file is created in drive:\Elixir. To run Password.exe, click in the Tools and Utilities view. The Elixir Product Registration dialog launches and guides the user through the complete registration process. Display Password File – Disppw.exe Display Password File displays information about your PC and Elixir applications after successful completion of the online registration process. To run Disppw.exe, click in Tools and Utilities view. The Disppw.exe window displays. Disppw.exe window displays with password details of the machine. Display Key – Showbd32.exe Display Key shows information about any Elixikeys attached to your PC and the Elixir applications you have authorization to run. To run Showbd32.exe, click Chapter 8: Stand-Alone Utilities in the Tools and Utilities view. 213 The Display Key window opens showing the soft key security details of the machine. Display PC Serial Number – Showpc.exe Display PC Serial Number is a licensing utility that generates your PC’s serial umber for password file generation. The serial number is generated as a text file at the following path: drive:\Elixir\ To run Showpc.exe, click in Tools and Utilities view. The SHOWPC.EXE window displays indicating the location of showpc.exe file. Update Key – UPDKEY.exe Update Key updates the hard key (only if it is plugged into your computer) by copying all of the key codes from the password.epw to the hard key. To run UPDKEY.exe, click displays. 214 in the Tools and Utilities view. The Updkey.exe window DesignPro Manager for AFP User Guide AfpdsTree – AFPDSTREEU.EXE AfpdsTree is a Windows application that displays the internal structure of AFP (MO:DCA) files, and provides on-screen information dumps. Once AFP files are opened in the AfpdsTree, you can customize the view and easily browse through the tree using either a mouse or the keyboard. AFP file content is displayed within two window panes: Document Tree window displays the AFP file structure in a collapsible tree. Individual AFP structured field records are represented using AFP mnemonic and structured field titles. Dump window displays the AFP file binary content using hexademical notation. The AFP identifier (x’D3xxxx’) displays for each structured field. EBCDIC translation is provided in a column right of the dump. Opening a File in AfpdsTree To launch AfpdsTree and open an AFP file: 1 Click in the the Tools and Utilities view. The AfdpdsTree window displays. 2 Select File>Open from the menu bar. The Open dialog displays. 3 Browse to locate the required target folder. 4 Select the following: File name – specifies unique name identifying the file. Files of type – specifies the type of file. Dropdown list displays formats available for selection. 5 Click Open to view the selected AFP file. Selected AFP file loads in the Application window. Chapter 8: Stand-Alone Utilities 215 Navigating in AfpdsTree To expand or collapse the Document Tree branches, click the the desired structured field object. or icon to the left of Clicking on the structured field name in the Document Tree window causes the Dump window contents to reposition with the selected structured field at the top of the window. The layout of both windows can be changed using the Splitter function. Use the horizontal splitter window. Use the vertical splitter window side-by-side. to display the Document Tree window above the Dump to display the Document Tree window and the Dump The AFPDS Tree window displays the Document Tree and Dump window. 216 DesignPro Manager for AFP User Guide Additional Utilities In addition to the utilities that are immediately accessible from the Manager workspace, DesignPro Tools also provides additional utilities to make it more efficient. The additional utilities that it provides are: AFPVIEW.EXE AU.EXE DOSVSE DTAFP ELX2VSE CodePage Builder ElxTag PDF plug-in CharmapUpdt AFPVIEW.EXE Overview The DesignPro Tools provides a utility specifically to view AFP datastreams. Using the AFPVIEW, you can view the internal structure of an AFP file. This is useful when looking for resources, or to check the file to make sure that file transfer has corrupted your datastream. Usage: AFPVIEW.EXE drive:filename [Enter] Where: Filename – file name, including path and extension, for instance, specify drive:\elixir\forms\afp\o1inv.ove) To run the AFPVIEW utility: 1 Launch the command prompt. 2 Change directory to drive:\program files\elixir technologies\bin. 3 Enter afpview <drive>: <filename> Chapter 8: Stand-Alone Utilities 217 Enter syntax to view the AFP datastream. 4 Press <Enter>. The resource and document details display. The resource and document details of the AFP file display. 218 DesignPro Manager for AFP User Guide AU.EXE Overview The AU.EXE utility reformats the record structure of an AFP file. You can read an AFP file to VBM (crlf-delimited), OS2 (pure AFP - no wrappers), AS/400, DOS/VSE, and IRMA formats. Usage: AU <command> <source_files> <target_file> [options…][Enter] Where: Command – defines the action that is to be performed. • REWRITE - rewrites the entire AFP file to the defined record format. • LIST - dumps the entire AFP file into the structured field info text file. source_file – name of the input file (e.g. drive:\elixir\forms\afp\o1inv.ove). target_file – name of the output file (drive:\elixir\forms\afp\inv.afp). The input and output file names can include wildcards. Options – the following non-positional options for record format are available: • -Faaa: record-format - record format for AFP object out. The available options include OS2, VBM, AS400, IRMA, DOSVSE. While writing the record-format, you need to write –F as the default value, preceded by any of the above mentioned options (e.g. –FVBM). To run the AU.exe: 1 Launch the command prompt. 2 Change directory to drive:\program files\elixir technologies\bin. Chapter 8: Stand-Alone Utilities 219 3 Enter au rewrite <source_file> <target_file> –Faaa. Enter syntax to reformat the record structure of the AFP file. 4 Press <Enter>. The AFP file is transformed to an OVE. The transformation is completed. 5 Close the window. You can verify the transformation by viewing the structure of the file using the AFPVIEW utility. 220 DesignPro Manager for AFP User Guide DOSVSE Overview DosVse.exe reblocks AFP output files to DOS VSE 80-byte card record format for file transfer. The DOSVSE utility extracts AFP structured file information from the downloaded phase file in preparation for conversion to the Elixir generic format. The utility converts the file into an Elixir readable file (structured field records only). It is important to make a backup of the existing file before running the conversion because it might be over-written. Usage: DOSVSE Filename[Enter] Where: Filename – any filename, including path and extension. You cannot use wildcards in the filenames. To run the DOSVSE utility: 1 Launch the command prompt. 2 Change directory to drive:\program files\elixir technologies\bin. Chapter 8: Stand-Alone Utilities 221 3 Enter dosvse <filename> and press <Enter> to convert the overlay to an Elixir readable file. Enter syntax to run the utility. 4 222 Close the window. DesignPro Manager for AFP User Guide DTAFP Overview DTAFP utility converts DAT files into Normalized AFPDS format. Normalized AFPDS supports the BPSD tags required by the DocuMerge utility, a utility used to merge forms with live data during the print process. Converting Elixir Legacy Form Files to Normalized AFPDS To convert forms into Normalized AFPDS format, you need to: Save all forms in .ELX format. Create a DAT file. Run the conversion. Saving Forms to Elixir Format Before running the conversion, you need to save all of the forms in the DesignPro Form Editor. All forms for a Normalized AFPDS document must be saved in the ELX format. All images must be in the LP3 format, and all fonts must be in the HDR format (the HDA, GLH, and GLY versions of the font should also be available). To save a form to ELX, select Elixir Legacy Form (*.elx) from the Save as drop-down list in the Save As dialog. Subsequent sections include details on the conversion process. For more information about the ELX format and creating DAT files, refer to DesignPro Form Editor for AFP User Guide. Active objects are ignored when saving to the ELX format in DesignPro Tools 2.00. Chapter 8: Stand-Alone Utilities 223 Creating a DAT File The next step is to create a DAT file containing the required form references. For more information on how to create a DAT file, refer to “Creating a DAT File” in “Chapter 8: Data Tagging” in DesignPro Form Editor for AFP User Guide. All forms referenced by the DAT file must be in the ELX format in order for the NorAFPDS converter to complete the conversion successfully. Running the Conversion The last step involves converting the DAT file to Normalized AFPDS, using the Dtafp utility, however, before using the DTAFP utility, you also need to create three folders/ directories using the following specified paths: drive:\Elixir\Docs\Doclist drive:\Elixir\Docs\Nrafpout drive:\Elixir\Docs\Afpout The Doclist folder holds the input .DAT file, the Nrafpout folder receives the Normalized AFPDS output file, and the Afpout folder holds the temporary files generated during the conversion process. You can launch the DTAFP utility using: 224 The Command Prompt The DesignPro Manager DesignPro Manager for AFP User Guide Converting DAT Files to Normalized AFPDS using the Command Prompt For this conversion exercise, you will specify the input file name (DAT file) and a location for the output file. However, in addition to these, you can also specify other directories as listed below. The command line parameters for Dtafp.exe are as follows: dtafp <Filename> <-Cmd> [-O:Outputname] [-Port] [-Allfonts] [-t:tagdirectory] [m:mapdirectory] [-s:fontdirectory] [-f:formdirectory] [-a:afpoutputdirectory] Where: Filename – specifies the name of the input DAT file, including path and file extension, for instance, drive:\elixir\docs\doclist\test.dat. In the command line mode, it is recommended that all file names be in 8.3 format, i.e., maximum eight characters for the filename and three characters for the extension. If a file name is specified with spaces, correct output file will not be obtained. - Cmd – specifies the command line mode. -O:outputname – specifies the path and name of the output file. In the command line mode, it is recommended that all file names be in 8.3 format, i.e, maximum eight characters for the filename and three characters for the extension. -Port – sets the output to portrait orientation regardless of original orientation. -allfonts – exports all fonts specified in the font list, instead of exporting the used fonts only. -t:tagdirectory – specifies the directory that contains the referenced tag files used in a form. For instance, specify -t:drive:\elixir\ -m:mapdirectory – specifies the directory that contains the font map files. For instance, -m: drive:\elixir\fonts\maps\ -s:fontdirectory – specifies the fonts directory, for example, -s:drive:\elixir\fonts\screen\ -f:formdirectory – specifies the forms directory. For instance, specify: -f:drive:\elixir\forms\ -a:afpoutputdirectory – specifies the AFP output directory. If this switch is not specified, DTAFP assumes it to be drive:\elixir\docs\afpout\. Chapter 8: Stand-Alone Utilities 225 To convert to Normalized AFPDS using the Command Prompt: 1 Launch the Command Prompt. 2 Change the directory to drive:\program files\elixir technologies\bin. 3 Enter dtafp drive:\Elixir\Docs\DocList\Demo1.dat -cmd -o: drive:\Elixir\Docs\ The conversion runs. The Merge complete message displays indicating that the conversion has run Accessing the DTAFP Utility using the DesignPro Manager Before using the DTAFP utility, you must first create a shortcut for DTAFP in the DesignPro Manager. To add the DTAFP utility shortcut in the DesignPro Manager, refer to "Creating Application Shortcuts" on page 42 in Chapter 3: "DesignPro Manager Basics". 226 DesignPro Manager for AFP User Guide Converting DAT Files to Normalized AFPDS After creating the DTAFP utility shortcut, you can convert .DAT files to the Normalized AFPDS format using the following steps: 1 Click the DTAFP shortcut in the DesignPro Manager, My Shortcuts view. The DTAFP.EXE launches in the command prompt window. 2 Select the Convert menu using the arrow keys and then press <Enter>. The list of DAT files that are located at the path: drive:\Elixir\Docs\Doclist are displayed. 3 Select the required file using the arrow keys. 4 Press <Enter> to start the conversion process. By default, the converted file is placed in the Nrafpout folder. 5 Use <Esc> to go back to the main menu. Chapter 8: Stand-Alone Utilities 227 Working with DTAFP You can configure the DTAFP utility before converting to Normalized AFPDS (.NOR) as needed. The Setup menu provided in the utility includes options for setting resource directory paths, as well as other format settings. It also allows you to edit and tag the form lists. The DTAFP resource settings are saved in the configuration file Dtafp.cfg, located at drive:\Elixir. You can open this file in Notepad and view the contents, as shown below: The DTAFP.CFG file contents showing the resource paths and settings. Specifying a Form List Directory To specify a Form List Directory, select Setup>Form List Directory from the menu. A window displays where you can specify the name and path of a new Form List Directory. This is the location of DAT files used when converting .ELX files to Normalized AFPDS. 228 DesignPro Manager for AFP User Guide Specifying a Form Directory To specify a Form Directory, select Setup>Form Directory from the menu. A window displays where you can specify the name and path of a new Form Directory. This is the location of .ELX forms used in the conversion to Normalized AFPDS. Specifying a Fonts Directory To specify a Fonts Directory, select Setup>Fonts Directory from the menu. A window displays where you can specify the name and path of a new Fonts Directory. Justifying the Text To select appropriate justification options, select Setup>Justify text between and press <Enter> to select the following text justification options: Words – justifies text between words. Chars – justifies text between characters. The Justification option refers to how the Normalized AFPDS code places text on the page: either by individual words or word groups, or by characters and character groups. Using the Words setting will use less memory, but words may be slightly out of justification with another. Using the Chars setting uses more memory, but assures very high quality. For typical applications, the Words setting is adequate. Chapter 8: Stand-Alone Utilities 229 Specifying an External Tag Attribute File To specify an External Tag Attribute File, select Setup>External Tag Attribute File from the menu. A window displays where you can specify the new tag file name. The file name can be 8 characters long. Dttags.tag is the default tag file for conversions. The DTAFP resource settings are saved in the configuration file DTAFP.CFG located at drive:\Elixir. Default Tag Settings To view Default Tag settings, select Setup>Default Tag Settings from the menu. A window displays with a list of attributes/options. Press <Enter> to move through the following options: 230 Replacement Chars – replacement characters are used to display tags while viewing or editing forms. The replacement character is usually @, !, #, or " character. Mandatory or Optional – sets the specified variable data field as either: • Mandatory – if set, an error occurs when the data field is empty during print processing. • Optional – if set, no error occurs when a data field is empty. Delete After Use – deletes the field after it is used. Choose no if you wish to use the same field again in the document. Choose yes if you wish to use the same field name for a different data value, such as transactions on a statement. DesignPro Manager for AFP User Guide Field End Char – marks the end of a field in the data. The default value is $. To use characters not available on your keyboard, use the <Alt> key on the keyboard plus the decimal value of the character. Multi Data – adds a carriage return/line feed after the tag is printed; useful for aligning tags. Field Gen – formats a data string using non-replacement characters in a string of replacement characters. Enter non-replacement characters as you want them to display in relation to the replacement characters. For example, if your replacement character is an @, and you wish to format a US Social Security Number, you would enter “@@@-@@-@@@@.” Setting a Work File Directory To set a Work File Directory, select Setup>Work File Directory from the menu. A window displays where you can specify the new Work File Directory. This directory contains the temporary files created when the DTAFP utility is run. Setting the Printer Resolution To set the Printer Resolution in dots per inch (DPI), select Setup>Printer Resolution <DPI> from the menu. A window displays where you can specify the new Printer Resolution. This setting must match the target printer resolution. Chapter 8: Stand-Alone Utilities 231 Specifying an Output Format To set the Output Format, select Setup>Output Format from the menu. Press <Enter> to move through the following options and select the required format. VBM – creates files formatted for transferring to MVS and VM hosts using IBM 3270 (IND$ File) compatible transfer packages. AS4000 – creates AFP format files for uploading to AS/400 hosts. IRMA – creates files formatted for transferring to MVS hosts using IRMA FTTSO and the compatible file transfer packages to these hosts. OS/2 – creates MO:DCA files for use in AIX,and InfoPrint NT environments, and for transfer to MVS hosts using IBM's AFP reblocking utility. Setting Font Type To set the Font Type, select Setup>Font Type from the menu. Press <Enter> to move through the following options and select the required Font Type. X0 – used for bounded box fonts. X1-4 – used for unbounded box fonts (3800 printers). Setting AFP Form Format To set the Form Format, select Setup>AFP Format from the menu. Press <Enter> to move through the following options and select the required Form Format. AFP – forms are converted to compiled format. OGL – forms are converted to source format. Compiling occurs when forms are uploaded to the host. Setting Page Rotation To set the Page Rotation, select Setup>Rotate Page from the menu. Press <Enter> to move through the following options and select the required rotation angle: 232 0 – rotates the page 0 degrees. 90 – rotates the page 90 degrees. 180 – rotates the page 180 degrees. 270 – rotates the page 270 degrees. DesignPro Manager for AFP User Guide Specifying an ASCII to EBCDIC Table Name To specify an ASCII to EBCDIC Table name, select Setup>ASCII to EBCDIC Table Name from the menu. A window displays where you can specify the new table name. The file name can be up to 8 characters long. Specifying the Last Page Bottom This option is used to specify the location where the last character will print at the bottom of the last page. This information is sent to DocuMerge for printing so that it can merge additional data onto the page if space allows. Either: AUTO – automatically determines the position for the last character. DPI – specifies a number in Dots Per Inch (e.g. 300 DPI). For a letter sized page, the options ranges from 0 to 3300. Saving Setup Options To save the Setup Options, select Setup>Save Setup Options from the menu. Chapter 8: Stand-Alone Utilities 233 Editing File Options The DTAFP utility allows you to edit DAT files and Tag Form lists. The following sections include tasks that enable you to edit the DAT files and Tag Form lists. Editing a Form List A .DAT file contains a list of forms that you can add to or delete from as required. To edit the Form List in a DAT file, select Edit>Edit Form List from the menu, and then press <Enter>. The list of .DAT and data files located at the path: drive:\Elixir\Docs\Doclist display. Creating a New DAT File To create a new DAT file: 234 1 Select Edit>Edit Form List from the menu, and then press <Enter>. The list of .DAT and data files located at the path drive:\Elixir\Docs\Doclist display. 2 Select @NEWFILE from the list, and then press <Enter> to create a new DAT file. 3 A window displays where you can specify the Data File name. This name refers to the new DAT file. DesignPro Manager for AFP User Guide 4 Enter the name of the DAT file, and then press <Enter>. A new DAT file is created. File names may contain up to 8 characters. To add forms to the DAT file, refer to "Editing a DAT File" on page 235. Editing a DAT File 1 Select a DAT file from the list using the arrow keys, and then press <Enter>. A dialog displays the forms listed in the DAT file. Use the right arrow key to move the cursor in the dialog. When editing .DAT files, you can only choose ELX forms located at the specified Forms Directory. The default Forms Directory is located at: drive:\Elixir\Forms\Elixir. 2 To add a form in the DAT file, press <Insert>. A window displays showing a list of forms. 3 Select the required form, and then press <Enter> to add the form to the DAT file. You can also delete an existing form in the DAT file by selecting the form and pressing <Delete>. Chapter 8: Stand-Alone Utilities 235 Editing a Tag Form List You can view and edit tag properties of forms in a DAT file. To edit a Tag Form List: 1 Select Edit>Tag Form List from the menu, and then press <Enter>. A window displays showing a list of file names with the extension *.dat located at the path: drive:\Elixir\Docs\Doclist. 2 Select the required DAT file from the list using the arrow keys, and then press <Enter>. A window displays showing a list of forms within the respective DAT file. 3 Move to the required position, and then press <Insert>. A window displays showing a list of tag lists that can be added to the DAT file. 4 Use the arrow keys to move to the required tag list, and then press <Enter> on a tag list to add it to the DAT file. You can also delete an existing tag list from the .DAT file by selecting the tag list and then pressing <Delete>. Selecting a Tag File To select a Tag File for converting a .DAT file: 236 1 Select Edit>Write Tag File from the menu, and then press <Enter>. The list of DAT files located at drive:\Elixir\Docs\Doclist display. 2 Select the required DAT file from the list with the help of arrow keys, and then press <Enter>. 3 A window displays where you can enter the name of the new tag file to be associated with the selected DAT file. The tag file created is stored at the path drive:\Elixir. DesignPro Manager for AFP User Guide Printing Tags To print tags: 1 Select Edit>Print Tags from the menu, and then press <Enter>. The list of DAT files located at drive:\Elixir\Docs\Doclist display. 2 Select the required DAT file from the list with the help of arrow keys, and then press <Enter>. The selected tag file is printed at the local printer attached with your PC. This feature sends the print file to a device using PRN. As a result, DTAFP does not provide support for printing to network printers. MakePub Overview The MakePub utility zips and unzips the resources used in a file/folder into a single file with a .PUB extension. This is useful while creating or moving form files, when users have to keep a track of all of the resources being used (e.g., fonts, images, etc). It helps to reduce the file size and time for file transmission. This utility can archive and extract Elixir Legacy Documents (.ELX), Elixir Forms (.EFR) and Data Files (.DAT) and their resources. You can also extract files from an existing pub file. Archive – creates a pub file by zipping the resources into one file. Extract – extracts files from an existing pub file. Settings – by default, makepub uses Elixir default paths; however you can set the paths of the resources being used in the pub file. Usage: makepub <zipname> <filespec> [-x] [-u] [-l] [-o] [-f:fontdir] [-d:formdir] [p:picsdir] [-e:elixirdir] [-t:textsdir] [Enter] Where: Zipname – specifies the path, name and extension of the pub file to be created. (e.g. drive:\elixir\forms\afp\o1test.pub). In case of extracting files, the zipname specifies the name of the PUB file to be extracted. Filespec – specifies the name and path of the file or folder for which a PUB file is to be created- filespec can be any file name or wildcard. Chapter 8: Stand-Alone Utilities 237 [options…] – the following options are available when creating a pub file: • -x – specifies that pub files are to be extracted. • -l – displays the list of resources in a pub file. • -o – overwrites resource files while extracting. • -u – specifies that user-specified command line directories are to be used while creating the PUB files or while extracting files from pub. The MakePub utility will search in the user-specified paths for the referenced resources. The available options are; -f:fontdir – specifies the location for the fonts. By default, uses drive: \elixir\fonts\elixir. -d:formdir – specifies the form directory that the pub file will refer to. The default path for form directory is drive:\elixir\forms\elixir\demo. -p:picsdir – specifies the directory for image resources to be used in the pub file. The default path for images directory is drive:\elixir\pics\printer. -e:elixirdir – specifies the path for Elixir Folder. The default path is drive: \elixir. -t:textsdir – specifies a text directory. The default path is drive:\elixir\texts. You can enter more than one option in a single command. To run the MakePub utility: 1 Launch the command prompt. 2 Change the directory to drive:\program files\elixir technologies\bin. 3 Enter makepub <zipname> <filespec> [options]. The <filespec> names can include wildcards. 238 DesignPro Manager for AFP User Guide Enter the name of the file/folder to be archived. 4 Press <Enter> to create the PUB file. Creating a .Pub file. Using the MakePub utility, you can specify paths for the resources, both during the making of a pub file and extracting a pub file. If a pub file is being made, the utility will search in the user specified paths for the resources referenced from efr, elx, and dat files. If pub is being unzipped, the files in the pub will be placed in the user supplied paths. 5 To change the resource directory path, use the command: makepub <zipname> <filespec> -u [-f:fontdir] [-d:formdir] [-p:picsdir] [e:elixirdir] [-t:textsdir]. 6 Press <Enter>. Chapter 8: Stand-Alone Utilities 239 The resource directory paths for o1test.pub. Listing Files To list files, you can use the list option to list the resources added in the pub file. Enter the command: makepub <zipname> <filespec> -l Enter command to list files. Extracting Files To extract files: 240 1 In the command prompt, enter: makepub <zipname> <filespec> -x. 2 To overwrite existing resources, use the command: makepub <zipname> <filespec> -x –o. DesignPro Manager for AFP User Guide Enter command to extract files. If the MakePub utility is being run from drive X ( meaning user installed DPT in: X:\program file\elixir technologies\bin ), the above paths will resolve relative to X. ElX2VSE Overview The DesignPro Tools provides a utility to convert AFP data stream files (.SEG, .OVE, and font files) to VSE linkage editor statements. The ELX2VSE utility uses the Cl4.Def file to obtain the job control information included in the object deck. You can edit the Cl4.Def file using any standard text editor. You need to examine this file and modify it to your installation standards. The parameters that may require modification include CATALOG (the destination for the phase file), DISP, and CLASS. Usage: ELX2VSE <drive> <filename.ext> Where: Drive – specifies the path of the file to be converted. filename.ext – specifies the name of the file followed by the extension. Chapter 8: Stand-Alone Utilities 241 Using ELX2VSE You can run ELX2VSE using the DOS command line utility. To run the ELX2VSE: 1 Launch the command prompt. 2 Change directory to drive:\program files\elixir technologies\bin. 3 Enter ELX2VSE <drive> <filename.ext> Enter syntax for converting AFP files. 4 Press <Enter> AFP files are converted to .DCK files. You can view the .DCK files in the same directory where the original file resides. 242 DesignPro Manager for AFP User Guide Elixir CodePage Builder Overview A Code Page is a font file that associates code points and graphic character identifiers. It might be required to modify this association in some cases. The DesignPro Tools provides the Elixir Code Page Builder utility, ElxCPBuilderu.exe to associate code points with GCID identifiers. This utility operates in two different mode - AFP mode and the Normal mode. The AFP mode is used to define Unicode to GCID mapping for an existing AFP coded font, while the Normal mode allows full functionality of creating or modifying a code page. Launching Elixir Code Page Builder Utility To launch the Elixir Code Page Editor utility: 1 Browse to drive:\Program Files\Elixir Technologies\Bin. 2 Double click icon to display the Elixir Code Page Editor window. The Elixir Code Page Editor window is split into two panels. Initially, the sample font is displayed in both panels. On loading a font, the left-hand side displays the loaded font along with its mapping to the sample font, and the right hand side displays the sample font. Setting Elixir Code Page Utility Modes This Elixir Code Page Utility operates in two different modes: Normal Mode – allows full functionality of creating or modifying a code page. AFP Mode – used to define Unicode to GCID mapping for an existing AFP coded font. Chapter 8: Stand-Alone Utilities 243 Working in Normal Mode To work in Normal mode in the Elixir Code Page Utility, select the View menu and uncheck the AFP Mode option if checked. Loading a Code Page To select a sample font: 1 Select a font from the drop-down list displaying fonts in the toolbar. The sample font is displayed in the right-hand side of the Elixir Code Page Editor window. The sample font will have no impact on the code page created. If the Toolbar is not visible in the Elixir Code Page Editor window, select View>Toolbar to display the Toolbar. 244 2 To load an Elixir font, select Unmapped font>Load from the menu bar. An Open dialog displays. 3 Browse to select the required font and then click Open. The selected font loads on the left side of the Elixir Code Page Editor window. DesignPro Manager for AFP User Guide Elixir Code Page Editor window is displayed. In the Elixir Code Page Editor window, each code point represents: - A hex number shown in pink color indicates its position in the code page. - The glyph in gray color is the character from the loaded font at this position. - The glyph in blue color is the sample character mapped against the loaded font. - The character in black color indicates that they have no mapping to the loaded font left panel. Each codepoint displays options in different colors, as described above. Chapter 8: Stand-Alone Utilities 245 You can zoom in and zoom out the fonts in the Elixir Code Page Editor window. Select the following menu options from the Sample font, Unmapped font (in Normal mode)/ Coded font (in AFP mode) menu: Zoom In – select this menu option to zoom in the selected font area. Zoom Out – select this menu option to zoom out the selected font area. Native Size – select this menu option to bring the selected font back to the native size. While working in Normal mode, the name Unmapped font is displayed in the menu, where as in the AFP mode, the font in the left panel is referred to as Coded font in the menu. Setting Properties of a Code Point To set properties for a Code point: 1 In the left panel, select a code point that you want to edit. 2 From the main menu, select Code Point>Properties to view the Code Point Properties dialog. You can also right click the code point and select Properties to view this dialog. You can review the following options: Position – specifies the position of the Code point in the Code page. Unicode – specifies the Unicode value of the Code point. It is unique for every character and can be changed. The glyph (in blue) represents the character specified by this Unicode value. GCID – uses the graphics character identification option. Code point unused – specifies that the code point will not be used in the Code page. The unused Code points display in gray colored boxes in the left panel. If a code point is not required, select Code point unused in the Code Point Properties dialog. Similarly, to use an unused code point, clear Code point unused. 3 246 Click OK to return to the Elixir Code Page Editor window. DesignPro Manager for AFP User Guide Mapping a Code Point You can map a Code point in the loaded font (for example ‘S’), to a Code point in the Sample font area e.g., the symbol, £. This will result in replacing S in the code point selected in the left panel with the sign and will change the glyph ( in blue) to the sign in the loaded fonts area. To map a Code point in the left panel to a Code point in the Sample font: 1 Select the Code point you want to edit in the left panel. 2 Locate the Sample character you want to map in the Sample font area, and double click it to map it to the loaded font. Mapping a Code point in the left panel to a Code point in the Sample font. You can also map a code point by selecting the properties of a code point in the loaded fonts area by entering the Unicode value of the required character in the Unicode entry box in the Code Point Properties dialog. Chapter 8: Stand-Alone Utilities 247 Saving the Code Page To save the Code page: 1 Select File > Save from the main menu. The Select Resource Library for Writing dialog displays. 2 Browse to drive:\Elixir and select lib.erc. The drive:\Elixir\ lib.erc dialog displays. 3 Expand the Library root tree structure and select Code Pages. 4 Enter a name of the Code page in the Resource Name entry box and click OK. The new code page is added in the Code Pages tree structure. You can view the Code pages in lib.erc using the Elixir Resource Librarian. Creating a New Code Page To create a new code page using a Windows code page: 1 Select File>New from the menu bar. The New Code Page dialog displays. You can also open a new Code page by clicking the keyboard shortcut <Ctrl+N>. 248 on the toolbar or by using 2 Select or review the following options: Use selected Windows code page as template – specifies that a Windows code page is used. Select an appropriate option from the dropdown list adjacent to the Use selected Windows code page as template option. Simple direct code page (with 256 code points) – specifies that a Simple direct code page is used. Blank code page (with no code points) – specifies that a Blank code page is used. 3 Click OK to return to the Elixir Code Page Editor window. DesignPro Manager for AFP User Guide You can map and save the new Code point in the same way described above. For more information, refer to "Mapping a Code Point" on page 247 and "Saving the Code Page" on page 248. Properties of a Code Page To set properties for the Code page: 1 Select Code Page>Properties in the main menu. The Elixir Code Page Properties dialog displays. 2 Select the Entry category and review the Codepage entries table. This table displays the decimal values against the entry values for Position, Unicode, and GCID in the Code page. 3 You can select an entry in the table, and click Remove to remove the entry from the table. This is the same as setting the Code point unused option in the Code Point Properties dialog. 4 In the Glyph Preview, click Demo Font to display the Font dialog. You can select a demo font and preview the Code page entries in the specified font. 5 To add a value in the Code page entries table, enter values for Position, Unicode, and GCID in the Current field in the Entries category and click Add. You can view the added entries in the table. Chapter 8: Stand-Alone Utilities 249 Working in AFP Mode To set the Code Page Builder utility to AFP mode, select View>AFP Mode from the menu bar. This will run the Elixir Code Page Builder utility in the AFP mode. Selecting a Template Code Page To begin the mapping, you need to choose a template code page: 1 Select File>New from the main menu to display the New Code Page dialog. The Simple direct code page and the Blank code page options are not available in the AFP mode. They are available in the Normal mode to be used for creating code pages. 2 Select a Windows code page from the list available in the Use selected Windows code page as template box and click OK. 3 You can select a sample font from the drop down list in the menu bar. The sample font will have no impact on the code page created. 4 Load the coded AFP font in the Code Page Builder window by selecting Coded Font>Load from the menu bar. The Open dialog displays. 5 Browse to the required Coded font you want to load and then click Open. The selected font loads on the left side of the Elixir Code Page Editor window. While working in the AFP mode: - The gray boxes represent the unused Code points. - The green boxes represent the standard GCIDs in the Code page - White boxes represent the non-standard GCIDs in the Code page. 250 DesignPro Manager for AFP User Guide In AFP mode the Coded font is displayed in green boxes. 6 To view properties of a Code point, select Code Point>Properties. For more information on Code point properties, refer to "Setting Properties of a Code Point" on page 246. 7 To map a Code point in the loaded Code page, refer to "Mapping a Code Point" on page 247. 8 To save the Code page, select File>Save from the main menu. For information on saving options, refer to "Saving the Code Page" on page 248. The mapping will be according to the template code page selected earlier for a non standard GCID. For a standard GCID, it will be according to the code page associated with it. Exporting the Code Page to Resource Map While working in AFP mode, to use the defined mapping, you need to export it to the Resource Map. The Resource Map has a table of pre-defined mappings available. To export the mapped code page to Resource Map, select File>Export to Resource Map from the main menu. The Unicode values you mapped with the characters (GCIDs) here will now become effective for typing in the Visual PPFA and the Form Editor. Chapter 8: Stand-Alone Utilities 251 Elixir Code Page Builder utility provides an option of changing from Normal to AFP mode during the application session. However, before changing the mode, you need to save the Code page that you are working on. To change the mode in the Elixir Code Page Builder utility, refer to the "Setting Elixir Code Page Utility Modes" on page 243. Customizing Elixir Code Page Builder Elixir Code Page Builder helps to customize operations and appearance of the utility by changing the default options. You can review or edit the available options in the Code Page Editor Options dialog for customization. The Code Page Editor Options dialog in the Elixir Code Page Builder displays default settings in four category tabs. You can select the appropriate options in checkboxes in each category page. To set or review the default Elixir Code Page Builder utility options: 252 1 Select View>Options from the menu bar. The Code Page Editor Options dialog displays the available Category options. 2 Select the Main category tab and review or select the following options: Show error messages on status bar – displays error messages on the status bar. Show selected code points on status bar – displays selected Code points on the status bar. 3 Select the Code Page category tab to review or select appropriate options from the following: Show mapping as – specifies the mapping display options: • Glyphs of the sample font – displays Glyphs of the Sample font. • Unicode values – displays Unicode values of the Code page. Show unmapped font – displays unmapped fonts. Show Code point numbers – displays Code point numbers. Show Tooltips – displays tool tips. Hexadecimal display – displays Hexadecimal values. DesignPro Manager for AFP User Guide 4 In the Unmapped font/Coded font category tab, select the appropriate option from: Show baseline – specifies the option to view the baselines in the code points in the left panel. Click the box adjacent to Show baseline to select the color of the baseline. Cell color for registered characters – specifies a cell color for registered characters. You can change the color from the box adjacent to the option. This option is only available in AFP mode. 5 Review the dialog selections in Sample fonts and make your changes. For information on each category, see below. Point size – specifies the point size of the sample font. Colorize mapped positions – displays the mapped positions in the specified color. Show Unicode values – displays Unicode values. Show Tooltips – displays tool tips. Hexadecimal display – displays Hexadecimal values. 6 Click Apply to save the settings, then click OK to return to the Elixir Code Page Editor window. Profile Selection You can also use the profile selection feature in the Elixir Code Page Builder utility. To select a profile, go to View>Profile Selection in the main menu. For information on profile selection preferences, refer to Chapter 9: "Elixir Profile Editor". ElixiTag Overview Data fields must be defined and added to a form to indicate where specific variable data will be placed. Adding data fields to a form is called tagging a form. You can tag an Elixir form or Windows-based document by creating an external tag attribute file and referencing fields within that file in your document. ElixiTag is a simple utility for creating Tag Definition lists independent of form creation. You can create, as well as edit the existing data tags. Starting ElixiTag To run ElixiTag: 1 Launch the command prompt. 2 Change directory to drive:\program files\elixir technologies\bin. Chapter 8: Stand-Alone Utilities 253 254 3 Enter elxtag. 4 Press <Enter> The ElixiTag dialog displays. DesignPro Manager for AFP User Guide Working with ElixiTag ElixiTag dialog allows you to create and edit data tags. You can set various fields of data tags. These fields are: Search by Name – allows you to search by field name in the tag list to display the tag attributes. You can enter a field name that exists in the current tag list and apply the same parameters to the current field. If DataMerge finds a match in the current tag list, the parameters of that field display. Number – specifies the name of the variable data field. In case you don’t specify the number, ElixiTag increments the default field numbers that are sequential and starts from 01. The largest field number allowed is 700. Name – specifies the name of the variable data field. The maximum allowed length of the field name is 30. Use the name prefix to specify different types of tags. The tag name prefixes are described below: • CHECK_ – the FDF field in the PDF file will display an empty box. When the user selects the checkbox, the character will display. • CHECKB_ – the FDF field in the PDF file will display an empty box surrounded by a border. • DROP_ – the FDF field in the PDF file will display the list of entries entered in • the Comment field as a drop-down selectable list. See the Comment field for adding entries to be used by a drop-down selection. • DROPEDIT_ – the FDF field in the PDF file will display the list of entries entered in the Comment field as a drop-down selectable list and also allows additional text entry in the FDF field. See the Comment field for adding entries to be used by a drop-down selection. • GRAY_ – the FDF field will be filled with a shade pattern. • BORDER_ – the FDF field in the PDF file will be surrounded by a border and the color of the border is defined in the PDF.txt file. • SUBMIT – reserved keyword. • COMPLETE – reserved keyword. • SIGNATURE – reserved keyword. • $_ – the FDF field will display data entered as right justified using the comma separator and two decimal places. For example 2004.28 will be displayed in the field as $ 2,004.28. • #_ – The FDF field will display data entered as right justified using the comma separator with two decimal places. For example 2004.28 will be displayed in the field as 2,004.28. • TOTAL$_ – totals the data entered in those fields listed in the Comment field and displays the result as dollar currency, right justified using the comma separator and two decimal places. Chapter 8: Stand-Alone Utilities 255 • TOTAL_ – totals the data entered in those fields listed in the Comment field and • • 256 displays the result as right justified, using the comma separator and two decimal places. MULT$_ – multiplies the data entered in those fields listed in the Comment field and displays the result as right justified dollar currency amount. MULT_ – multiplies the data entered in those fields listed in the Comment field and displays the result as right justified amount. Length – specifies the maximum number of characters allowable in the specified field. If the variable data item requires less than the maximum number of characters, the paragraph will be formatted so that there are no extra spaces between the variable data item and any following text. Non-replacement characters are also included in the field length. Replacement Char – specifies the replacement character to be used by the data tag. DocuMerge variable data fields display in the document as a string of replacement characters. The replacement character is usually a @, !, #, or "character. Replacement characters should not be characters used in the text data. If you want to specify your own replacement character, backspace over the default character and enter a new one. Mandatory – specifies whether the tagged data is mandatory or optional. It allows you to tell DocuMerge if the specified variable data field is mandatory or optional when printing the document. If you specify it as M (mandatory), DocuMerge flags the document with an error flag if the variable data is missing. If it is specified as O (optional), the document prints with blank spaces in place of the replacement characters, if the data is missing. Delete After Use – indicates whether or not the tagged data should be deleted after its use in a replacement field to keep it from being used in a subsequent reference to the same tag name. The valid values are Y (yes) or N (no). Specify Y if you use the same field name in multiple forms, but require different values for each use. Specify N if you use the same field name in multiple forms with the same data value for each use. The default is N. Field End – specifies the character that matches the field end character found in the DocuMerge variable data. The default is $. Only those field end characters can be specified that are not passed as variable data by DocuMerge. Multi-Data – specifies the number of line skips to be issued between elements during merging into a block. This option links two different data fields when printing. N specifies there is only one variable data item associated with the tag name (the default). 0 through 9 indicates the number of line feeds you want generated between line breaks. DesignPro Manager for AFP User Guide Align – specifies a two-digit code to link this Field Name with another for printing purposes. Depth – specifies the number of lines in the specified variable data field. The default is 01. Field Gen – specifies the non-replacement characters to be used in the middle of a string of replacement characters. This is useful when formatting date fields or telephone numbers. For example, to separate the month, day, and year in the date field with slashes, type **/**/** (where * is the replacement character you specified). Comment – allows you to enter a comment relating to the field (up to 31 characters). For example, you may want to enter a comment to distinguish the field from another field that is similar. Scroll by Number – allows you to scroll through the current tag list by clicking on the left or right arrow in the Scroll by Number option. If the tag list contains many fields, press and drag the scroll box forward or backwards. Delete After Use option is to be set as YES when specifying a value for Multi-Data field and the Length should allow for the number of line feeds you generate. Saving a Tag File You can save an external tag attribute file with the same name or with a different name. To save the file with the same name select File>Save from the menu. Select File>Save As from the menu to save the file with a different name. The tag file gets saved at the location drive:\elixir by default. Chapter 8: Stand-Alone Utilities 257 Editing an Existing Tag ElixiTag allows you to edit the existing tag files. To edit a tag file: 1 Select File>Open from the menu. The Open dialog displays 2 Select the file that you want to edit. 3 Use Scroll by Number to display the data field you want to edit. 4 Edit an option by backspacing over the current parameter and entering a new parameter. 5 Save the file with the same name or with a different name. Adding a Tag To add a tag: 1 Click Add New Tag. An empty tag gets added at the end of the file. 2 Fill in the required fields. 3 Save the file by selecting File>Save option from the menu to save the file with the same name. In order to save the file with a different name, select File>Save As from the menu. The tags are added to the file DTTAGS.TAG by default. 258 DesignPro Manager for AFP User Guide Deleting a Tag To delete a tag: 1 Select the required tag using the Scroll by Number scroll bar. 2 Click 3 Click Delete Tag. The selected tag is deleted. or to scroll through the list of tags. Copying a Tag To copy an ElixiTag to a Windows-based document: 1 Click Copy to copy the tag information to the clipboard. 2 Open the document you want to tag. 3 Position the cursor on the document where you want to place the tag and click the left mouse button. 4 Press <Ctrl> + <V> or select the Paste option in your application. 5 The control characters, field number, and any tag replacement characters display in the document. It takes five characters to define a tag. Replacement characters are added in the tag if the field length is more than five characters so that the tag is approximately the length of the field. Exiting ElixiTag To close the ElixiTag utility, select File>Exit from the menu. Chapter 8: Stand-Alone Utilities 259 PDF plug-in The PDF Plug-In utility provides the facility of converting PDF files to AFP files while using Elixir Print Driver Pro for printing. This is required because during printing, the Adobe Acrobat passes temporary font names (e.g. ZTR1.tmp) to Elixir Print Driver Pro for Embedded fonts and Referenced Type1 fonts. This plug-in modifies the functionality of documents containing embedded True Type fonts, referenced Type 1 fonts, and embedded Type 1 fonts provided that: If True Type fonts are being used in PDF file, then they must be installed on the user system before conversion. If Type1 fonts are being used in the system (either referenced or embedded), then the equivalent True Type version of these fonts with exactly the same name must be installed on the user machine before conversion. Using PDF Plug-In 1 Close all running instances of Adobe Acrobat 6.x (or 7.x). 2 Place ElixirAcroPlug.Api in the following location: drive:\Program Files\Adobe\Acrobat 6.x (or 7.x)\Acrobat\plug_ins. The ElixirAcroPlug.Api does not come with the DesignPro Utilities. It is provided on demand. 260 3 Restart the Adobe Acrobat 6.x (or 7.x) application. 4 Open any PDF file that you want to print. DesignPro Manager for AFP User Guide 5 Select the File menu. A menu item Print with Referenced Fonts is added to the menu. This will convert the Embedded fonts to Referenced fonts before printing. Print with Referenced fonts option is added to the File menu. 6 To print with referenced fonts, select Print with Referenced Fonts. Use File>Print to print the document without the effects of the Pdf plug-in utility. Chapter 8: Stand-Alone Utilities 261 CharmapUpdt Overview CHARMAPUPDT.EXE is a back end utility. It is used to update elxmap.mdb at the time of installation. Usage: CHARMAPUPDT <Enter> To run the CHARMAPUPDT utility: 262 1 Launch the command prompt. 2 Change directory to drive:\program files\elixir technologies\bin. 3 Enter charmapupdt. 4 Press <Enter>. The file elxmap.mdb gets updated. 5 Close the window. DesignPro Manager for AFP User Guide Chapter 9: Elixir Profile Editor In this chapter... Elixir Profile Editor Overview Elixir Profile Editor Workspace Creating Custom Profiles Customizing Elixir Profile Editor This chapter provides information on Profile Editor, which may be used across all DesignPro Tools application modules. It also explains the Profile Editor workspace, its customization options, and tasks for creating new user profiles. Elixir Profile Editor Overview Elixir applications can be customized to fulfill the requirements of your specific working environment by creating and maintaining unique user profiles. Profile is a system file used to save important file locations and information about Elixir applications. You can customize the Elixir applications to suit a particular user, workgroup, or enterprise by creating, selecting, and modifying unique user profiles. Elixir installer creates a Default profile using information provided during installation of an Elixir application. This file creates the basic workspace for the current user and is located in drive:\Documents and Settings\current user\Application Data\Elixir Technologies\Profiles in SystemData.ini file. Default profile settings can be overridden by creating a version of the SystemData.ini file that contains the parameters slated for customization. This file becomes an Elixir user profile. You can set up multiple profiles to create alternate processing environments, or a single profile can be used to initialize all users in a particular working group. 263 Profiles can be used to facilitate: Service bureaus to define unique resource (forms, fonts, images, etc.) repositories for each customer. System administrators to create a single set of resource directories and default settings for all Elixir users in a working group. Users to move from workstation to workstation and maintain the same configuration. Profile Editor is easily accessed in all DesignPro Tools applications to offer the same capabilities. The Profile Selection feature allows you to select the profile you want to use within any application. The profile selected for one application is applied separately and does not result in profile changes for other applications. The changes take effect once the application is restarted. In DesignPro Manager, Profile Editor saves the mapping paths of virtual folders to physical folders and default paths for Elixir resources. Conversion resources are selected from paths specified in the setup (.EPM) file. If the resources are not present at the specified setup file location, converters and parsers select the required resources from paths specified in the user profile loaded for that session. Any changes made to the virtual folders are also updated in the profile file currently in use. If changes to folders are made through Profile Editor, all applications including the DesignPro Manager must be closed and reopened for the changes to take effect. 264 DesignPro Manager for AFP User Guide Elixir Profile Editor Workspace Profile Editor can be started from all of the DesignPro Tools applications by selecting Tools>Profile Editor from the menu bar. The following illustration identifies main parts of the Elixir Profile Editor. The Profile Editor workspace is comprised of a Profile window and a Messages window. The Profile Editor workspace. Profile Window The main Profile window presents the Profile tree in the left pane, and the associated details are displayed in the Details view in the right pane. The Profile window title bar displays the name of the node currently selected in the Profile tree. The Profile tree depicts the Default and custom profiles under the current user Windows login name. By default, only two nodes display under the root node. The first node is the Default profile denoting the Default profile for all Elixir applications and the second node is Elixir PrintDriver denoting the Elixir PrintDriver default profile. You can add or remove profiles and view or change required profile properties. Chapter 9: Elixir Profile Editor 265 Default profile tree displays. Default profile is associated with SystemData.ini; whereas Elixir PrintDriver profile is associated with Elixir_PrintDriver.ini located at %CommonAppData%\%Vendor%\DesignPro Tools\Elixir_PrintDriver.ini. The Details view displays the contents of the node selected in the Profile tree. Profile Editor sorts these profile items by their associated color-coded icons for easy identification and location: Symbol Description Gray – (default, hard coded value) item not defined in selected profile but inherited from an ancestor profile. Green – item defined in currently selected profile. Red – item inherited from parent profile and not re-defined in selected profile. Yellow – [default directories] and environment variables inherited from parent profile and redefined in selected profile. Select View>Available Views from the menu bar to sort profile items in the following three views: 266 DesignPro Manager for AFP User Guide Flat View Flat view displays default environment variables and categorization of profile keys. These variables are also displayed in the System Data or Symbols category of the Options dialog in all DesignPro Tools applications. See the "Default Environment Variables" on page 267. Flat view displays the default environment variables. Default Environment Variables The Default Environment Variables are as follows: Key Default Value Description PATHEXT .COM; .EXT; .BAT; .CMD; .VBS; .VBE; .JS; .JSE; .WSF; .WSH Extensions for executable files. COMPUTERNAME System specific Name of the computer. WINDIR System specific Windows system folder. SYSTEMROOT System specific Windows system folder. PROCESSOR_REVISION System specific Version number of the processor on the local machine. ALLUSERSPROFILE drive:\Documents and Settings\All Users Location for application settings stored under All Users profile. TMP System specific Specifies the location of temporary files. Chapter 9: Elixir Profile Editor 267 268 Key Default Value Description COMMONPROGRAM FILES drive:\Program Files\Common Files Location for shared application files. HOMEDRIVE drive:\ Primary local drive. COMSPEC System Specific Executable file for the command prompt. OS System specific Installed operating system. CLIENTNAME System specific Name of client. USERNAME System specific User logon name. USERDOMAIN System specific Logon domain. USERDNSDOMAIN System specific Logon domain. TEMP drive:\ Specifies the location of temporary files. PATH System specific Lookup path for executables. ELIXIRPASSWORD FOLDER drive:\Program Files\Elixir Technologies\Bin Location of Elixir password file (password.epw). APPDATA drive:\Documents and Settings\user logon name \Application Data Default path to Application Data files. PROCESSOR_LEVEL System specific Processor level for the local machine. HOMESHARE System specific Fully qualified path to server based profile. PROCESSOR_ ARCHITECTURE System specific Processor type for the local machine. PROGRAMFILES drive:\Program Files Default path to Program Files. LOGONSERVER System specific Name of the server currently logged into. NUMBER_OF_ PROCESSORS System specific Number of processors in PC system. SESSIONNAME Console Name of current login session. SYSTEMDRIVE drive: Drive containing the MS-DOS system files necessary to start MS-DOS. PROCESSOR_IDENTIFIER System specific PC processor size, model, and manufacturer. DesignPro Manager for AFP User Guide Key Default Value Description USERPROFILE C:\Douments and Settings\user logon name File containing configuration information for a specific user, such as desktop settings, persistent network connections, and application settings. HOMEPATH C:\Douments and Settings\user logon name Location of application settings for current user. Formats View This view sorts and displays profile keys by file format type. For example, AFP resources display under the AFP node; PPFA resources display under the root node of PPFA, etc. The Format view dispalys the profile keys by file format type. Chapter 9: Elixir Profile Editor 269 Formats and Resources Details The resource details for different formats are shown in the table below: AFP Format 270 Key Default Value Description SYSTEM_AFPIN_IMAGES _DIR %Elixirdir%\PICS\AFP\ Input path to AFP images. SYSTEM_FONTS_AFP_ DIR %Elixirdir%\FONTS\AFP\ Path to AFP fonts. SYSTEM_AFPOUT_JOBS_ DIR %Elixirdir%\JOBS\AFP\ Output path of AFP files. SYSTEM_ JOBS_AFP_DIR %Elixirdir%\JOBS\AFP\ Path to AFP files. SYSTEM_AFPIN_FORMS_ DIR %Elixirdir%\FORMS\AFP\ Input path to AFP forms. SYSTEM_AFPOUT_ FORMS_DIR %Elixirdir%\FORMS\AFP\ Output path of AFP forms. SYSTEM_AFPOUT_ IMAGES_DIR %Elixirdir%\PICS\AFP\ Output path of AFP images. SYSTEM_AFPIN_FONTS_ DIR %Elixirdir%\FONTS\AFP\ Input path to AFP fonts. SYSTEM_AFPIN_DOCS_ DIR %Elixirdir%\DOCS\AFP\ Input path to AFP documents. SYSTEM_GRAPHICS_AFP _ DIR %Elixirdir%\PICS\AFP\ Path to AFP graphics. SYSTEM_FORMS_AFP_ DIR %Elixirdir%\FORMS\AFP\ Path to AFP forms. SYSTEM_DOCS_AFP_ DIR %Elixirdir%\DOCS\AFP\ Path to AFP documents. SYSTEM_AFPIN_JOBS_ DIR %Elixirdir%\JOBS\AFP\ Input path to AFP files. SYSTEM_AFPOUT_ FONTS_DIR %Elixirdir%\FONTS\AFP\ Output path of AFP fonts. SYSTEM_AFPOUT_ DOCS_DIR %Elixirdir%\DOCS\AFP\ Output path of AFP documents. DesignPro Manager for AFP User Guide OGL Format Key Default Value Description SYSTEM_FORMS_OGL_ DIR %Elixirdir%\FORMS\OGL\ Path to OGL forms. SYSTEM_OGLOUT_ FORMS_DIR %Elixirdir%\FORMS\OGL\ Output path of OGL forms. SYSTEM_OGLIN_ FORMS_DIR %Elixirdir%\FORMS\OGL\ Input path to source OGL forms. Key Default Value Description SYSTEM_METAIN_ IMAGES_DIR %Elixirdir%\PICS\METAIN\ Input path to Xerox Metacode images. SYSTEM_METAIN_ FONTS_DIR %Elixirdir%\FONTS\ METAIN\ Input path to Xerox Metacode fonts. SYSTEM_METAIN_DOCS _DIR %Elixirdir%\DOCS\META\ Input path to Xerox Metacode documents. SYSTEM_METAOUT_ DOCS_DIR %Elixirdir%\DOCS\META\ Output path of Xerox Metacode documents. SYSTEM_METAOUT_ IMAGES_DIR %Elixirdir%\PICS \METAOUT\ Output path of Xerox Metacode images. SYSTEM_METAOUT_ FORMS_DIR %Elixirdir%\FORMS\ METAOUT\ Output path to Xerox Metacode forms. SYSTEM_METAIN_ FORMS_DIR %Elixirdir%\FORMS\ METAIN\ Input path to Xerox Metacode forms. SYSTEM_METAOUT_ FONTS_DIR %Elixirdir%\FONTS \METAOUT\ Output path to Xerox Metacode fonts. Metacode Chapter 9: Elixir Profile Editor 271 FRM 272 Key Default Value Description SYSTEM_FRMIN_ IMAGES_DIR %Elixirdir%\PICS\IMG\ Input path to Xerox IMG images. SYSTEM_FORMS_FRM_ DIR %Elixirdir%\FORMS\FRM\ Path to Xerox FRM forms. SYSTEM_FRMIN_FORMS _DIR %Elixirdir%\FORMS\FRM\ Input path to Xerox FRM forms. SYSTEM_FRMOUT_ IMAGES_DIR %Elixirdir%\PICS\IMG\ Output path of Xerox IMG images. SYSTEM_FRMOUT_ FORMS_DIR %Elixirdir%\FORMS\FRM\ Output path of Xerox FRM forms. SYSTEM_FRMIN_FONTS _DIR %Elixirdir%\FONTS\Xerox\ Input path to Xerox fonts. SYSTEM_FRMOUT_LGOS _DIR %Elixirdir%\PICS\LGO\ Output path of Xerox LGO images. SYSTEM_FRMIN_DIR %Elixirdir%\FORMS\ FRMIN\ Input path to Xerox forms. SYSTEM_FRMOUT_ FONTS_DIR %Elixirdir%\FONTS\Xerox\ Output path to Xerox fonts. SYSTEM_FRMOUT_ DOCS_DIR %Elixirdir%\DOCS\ FRMOUT\ Output path to Xerox FRM documents. SYSTEM_FRMIN_LGOS_ DIR %Elixirdir%\PICS\LGO\ Input path to Xerox LGO images. DesignPro Manager for AFP User Guide FSL Key Default Value Description SYSTEM_FSLOUT_ IMAGES_DIR %Elixirdir%\PICS\FSLOUT\ Output path to Xerox images. SYSTEM_FSLOUT_ FONTS_DIR %Elixirdir%\FONTS\ FSLOUT\ Output path to Xerox fonts. SYSTEM_FSLOUT_DOCS _DIR %Elixirdir%\DOCS\ FSLOUT\ Output path to Xerox FSL documents. SYSTEM_FSLOUT_ FORMS_DIR %Elixirdir%\FORMS\ FSLOUT\ Output path to Xerox FSL forms. SYSTEM_FORMS_FSL_ DIR %Elixirdir%\FORMS\FSL\ Path to Xerox FSL forms. Key Default Value Description SYSTEM_GRAPHICS_ IMG_DIR %Elixirdir%\PICS\IMG\ Path to Xerox IMG images. SYSTEM_IMGIN_ GRAPHIC_DIR %Elixirdir%\PICS\IMG\ Input path to Xerox IMG images. Key Default Value Description SYSTEM_GRAPHICS_ LGO_DIR %Elixirdir%\PICS\LGO\ Path to Xerox LGO images. SYSTEM_LGOIN_ GRAPHIC_DIR %Elixirdir%\PICS\LGO\ Input path to Xerox LGO images. SYSTEM_FRMOUT_ LGOS_DIR %Elixirdir%\PICS\LGO\ Output path of Xerox LGO images. SYSTEM_FRMIN_LGOS_ DIR %Elixirdir%\PICS\LGO\ Input path to Xerox LGO images. IMG LGO Chapter 9: Elixir Profile Editor 273 PCL Key Default Value Description SYSTEM_HPOUT_FORMS _DIR %Elixirdir%\DOCS\PCL\ Path to PCL pages. SYSTEM_HPIN_FORMS_ DIR %Elixirdir%\DOCS\PCL\ Input path to PCL pages. SYSTEM_HPOUT_I MAGES_DIR %Elixirdir%\PICS\HPOUT\ Output path of PCL pages. SYSTEM_HPIN_FONTS_ DIR %Elixirdir%\FONTS\PCL\ Input path to PCL fonts. SYSTEM_HPOUT_FONTS _DIR %Elixirdir%\FONTS\PCL\ Output path of PCL fonts. SYSTEM_HPIN_DOCS_ DIR %Elixirdir%\DOCS\PCL\ Input path of HP/PCL documents. SYSTEM_HPIN_IMAGES_ DIR %Elixirdir%\PICS\HPIN\ Input path to PCL images. SYSTEM_HPOUT_DOCS_ DIR %Elixirdir%\DOCS\PCL\ Output path of HP/PCL documents. Key Default Value Description SYSTEM_PSIN_FONTS_ DIR %Elixirdir%\FONTS\ATMT3\ Input path to PostScript fonts. SYSTEM_PSJOB_ DATABASE_DIR %Elixirdir%\PSJOBS\ELIXIR \ Path to Elixir Opus Design database. SYSTEM_PSOUT_DOCS_ DIR %Elixirdir%\DOCS\PS\ Output path of Postscript documents. SYSTEM_PSIN_DOCS_ DIR %Elixirdir%\DOCS\PS\ Input path to Postscript documents. SYSTEM_DOCS_PS_DIR %Elixirdir%\DOCS\PS\ Path to Postscript documents. SYSTEM_PSOUT_FORMS _DIR %Elixirdir%\DOCS\PS\ Output path to Postscript forms. SYSTEM_PSIN_FORMS_ DIR %Elixirdir%\DOCS\PS\ Input path to Postscript forms. SYSTEM_PSOUT_ IMAGES_DIR %Elixirdir%\PICS\PSOUT\ Output path to Postscript images. PostScript 274 DesignPro Manager for AFP User Guide Key Default Value Description SYSTEM_PSOUT_FONTS _DIR %Elixirdir%\FONTS\ATMT3\ Output path of Postscript fonts. SYSTEM_PSIN_IMAGES_ DIR %Elixirdir%\PICS\PSIN\ Input path to Postscript images. Key Default Value Description SYSTEM_PDFIN_IMAGES _DIR %Elixirdir%\PICS\PDFIN\ Input path to PDF images. SYSTEM_PDFIN_FORMS_ DIR %Elixirdir%\DOCS\PDF\ Input path to PDF forms. SYSTEM_PDFOUT_ IMAGES_DIR %Elixirdir%\PICS\PDFOUT\ Output path of PDF images. SYSTEM_PDFOUT_ FORMS_DIR %Elixirdir%\DOCS\PDF\ Output path of PDF forms. SYSTEM_PDFIN_FONTS_ DIR %Elixirdir%\FONTS\PDFIN\ Input path to PDF fonts. SYSTEM_PDFIN_DOCS_ DIR %Elixirdir%\DOCS\PDF\ Input path to PDF documents. SYSTEM_DOCS_PDF_DIR %Elixirdir%\DOCS\PDF\ Path to PDF documents. SYSTEM_PDFOUT_DOCS _DIR %Elixirdir%\DOCS\PDF\ Output path to PDF documents. SYSTEM_PDFOUT_ FONTS_DIR %Elixirdir%\FONTS\ PDFOUT\ Output path of PDF fonts. PDF Chapter 9: Elixir Profile Editor 275 TIFF Key Default Value Description SYSTEM_TIFFOUT_ GRAPHIC_FONTS_DIR %Elixirdir%\FONTS\TIFFO UT_GRAPHIC\ Output path to TIFF fonts. SYSTEM_ TIFFOUT_GRAPHIC_ IMAGES_DIR %Elixirdir%\PICS\TIFFOUT _GRAPHIC\ Output path to TIFF images. SYSTEM_TIFFOUT_ GRAPHIC _DIR %Elixirdir%\PICS\TIFF\ Input path to TIFF images. SYSTEM_TIFFOUT_ GRAPHIC _FORMS_DIR %Elixirdir%\FORMS\TIFFO UT_GRAPHIC\ Output path to TIFF forms. Resources Type View This view sorts and displays profile keys according to the resource types. Resources are listed under their respective node, as displayed in the figure below. Forms resources display under the Forms root node. The Resource view displays the profile keys according to the resource types. 276 DesignPro Manager for AFP User Guide Messages Window The Messages window displays the processing and compilation errors, warning, and informational messages generated by the application. For information on error and warning messages, refer to Appendix A: "Error and Warning Messages". The Messages window is displayed behind the main window initially and can be moved to any required position. Select View>Clear all Messages from the menu bar to clear all messages displayed in the Messages window. You can close the Messages window to allow more space while working in the main window and the Messages window will automatically open whenever a message is generated. Working with Elixir Profile Editor You can add new profiles for use in DesignPro Tools applications and modify or remove existing profiles. Profile item properties may also be changed and new ones created. Profile Editor provides the following features. Creating Custom Profiles A customized user profile is based on the structure of the SystemData.ini file. System Data.ini contains the default directories, Resource Maps, and Resource Libraries used by Elixir Applications, as well as various system settings. When you create a new profile, Profile Editor automatically creates a corresponding INI file on the following path in the system drive:\Documents and Settings\username\Application Data\Elixir Technologies\Profiles. Removing a profile deletes the corresponding INI file from the hard disk. Profiles can be of three types: New Default Profile – uses all system defined profile items to create a new profile. This profile does not directly inherit its values from any existing profile file. The values defined in this profile are predefined by the system. After creating the Default profile, you can customize the profile items as required. Derived Profile – inherits the missing profile item values from its parent profile. Profile Editor adds a reference from the parent profile in the derived profile file. Any updates to the parent profile are automatically inherited by the derived profile. However, changes to the derived profile (add, remove, and edits) are not reflected in the parent file; changes are only reflected in the INI file for the derived profile. Chapter 9: Elixir Profile Editor 277 Cloned Profile – an exact replica of the parent profile. Unlike derived profile, this profile is not dependent on the parent profile for any of its profile item values. Therefore, changes made in either the parent or child profile do not affect the other profile. Adding a New Default Profile To add a new Default profile to the Profile tree: 1 In the Profile tree, right click the root node denoting your Windows user name, then select Add new default profile from menu. The Profile Properties dialog displays. 2 As appropriate, enter or select the following: Profile name – unique name identifying the profile. Profile INI File Path – sets the path for profile configuration file Open Profile Configuration File dialog for INI file selection. . displays If you enter a profile file name that does not exist, Profile Editor automatically creates an associated INI file at the specified location. 3 278 Description – brief narrative describing item. Click OK to create a new profile and return to Applications window. DesignPro Manager for AFP User Guide Adding a Derived Profile To add a derived profile: 1 Right click the parent profile from which you are deriving the new profile in the Profile tree. 2 Select Add derived profile from the pop-up menu. The Profile Properties dialog displays. 3 Make the selections as required and then click OK to add the new Derived profile to the tree. For more information on the Profile Properties dialog, refer to, "Adding a New Default Profile" on page 278. Cloning a Profile To add a clone profile: 1 Right click the parent profile from which you are cloning in the Profile tree. 2 Select Clone profile from the pop-up menu. The Profile Properties dialog displays. 3 Make appropriate selections and then click OK to add a new Clone profile to the tree. For more information on the Profile Properties dialog, refer to the "Adding a New Default Profile" on page 278. Deleting a Profile To delete a profile, right click the required profile node from the Profile tree and select Remove profile from the pop-up menu. A confirmation message displays. Click Yes to delete the selected profile and corresponding INI file. Chapter 9: Elixir Profile Editor 279 Changing Profile Properties The Profile Editor allows you to specify multiple symbol values (paths/file name) against one profile item. You can set the profile item type to any of the four supported options, Single, Multiple, File, or Path. The first two options are used for display purposes. The last two Profile item types, File and Path, allow you to specify a directory or a file for a particular profile item. Before changing a profile, it is suggested that you create and modify a new INI file to specify any customized resource locations rather than modifying the default System data.ini file. The following tasks detail how to add a new profile item or modify an existing one. Adding a Profile Item To add a profile item: 1 Select the required profile node from the Profile window. 2 Right click the required root node in Details view, then select New item. The Properties of Profile Item dialog displays. 3 As appropriate, enter or select the following: Symbol ID – symbol that uniquely identifies profile item. Type – sets the profile item type. This selection changes the available dialog options. The following options are available: • Single – displays values in a single row in the Details window; multiple values are separated by a semi-colon. • Multi – displays all values in separate rows in the Details window. • Path – sets the directory path. Double click in the Value(s) area to display icon. You can browse to set the directory path for the profile item. • File – selects the appropriate file. Double click in the Value(s) area to display . You can browse to select the appropriate file. 4 280 As appropriate, enter or select the following: Name – unique name identifying the profile. Description – brief narrative describing item. Value(s) – enter profile item(s) and path(s). DesignPro Manager for AFP User Guide 5 Click OK to add the newly defined profile item. The profile item displays in the Details view. Single You can specify multiple symbol values against a Single type profile item, but these values are displayed in a single row in the view area separated by a semi-colon. The search order is determined by the order of display. Multiple Multiple displays all values in separate rows in the view area. Click to move the selected value one level up. To move the selected value one level down in the symbol values list, click Click Clicking an empty line once selects it and clicking it a second time makes the line editable for entering the required symbol value. . to delete the selected value. Empty line for adding a new symbol value. File File type allows you to choose a specific file for the profile item. You can select multiple files for symbol values. Clicking an empty line once selects it and clicking it a second time makes the line editable. Clicking will launch the Open dialog. Browse for the required *.SINI file and click Open to set the profile item. Chapter 9: Elixir Profile Editor 281 Empty line for specifying required file. Path Path type allows you to specify a path for the profile item. As in the rest of the profile item types, you can specify multiple symbol values. Clicking an empty line once selects it. Clicking it a second time makes the line editable and displays . Empty line for specifying the required path. Click to launch the Browse for Folder dialog to select the required path. Browse to the required directory. Click OK to set the selected path and return to the Properties of Profile Item dialog. Modifying a Profile Item You can quickly access profile item properties by right clicking on the required item in the Details view and selecting Properties from the pop-up menu for making changes. The Properties of Profile Item dialog displays for modifying the selected item. You can modify all of the properties of a profile item except the Symbol ID. For more information on Profile Item types, see "Adding a New Default Profile" on page 278. 282 DesignPro Manager for AFP User Guide Modifying a Default profile is not recommended. You can also access profile item properties by selecting the required profile and clicking toolbar. on the Deleting a Profile Item To remove a profile item, right click the required profile item in the Details window and select Delete item from the pop-up menu. A confirmation message displays. Click Yes to delete the selected profile item and return to the Applications window. Selecting a Pre-defined User Profile Default profile is loaded automatically when the application is launched for the first time. New profiles can be created using the Profile Editor, and custom profiles can be selected using the Profile Selection feature. The custom profiles can be specified for all DesignPro Tools applications. If the current user ID is different from the ID used during DesignPro Tools installation, every application before launching for the first time will prompt for profile selection; users store profile settings. To select a pre-defined profile: 1 Select Tools>Profile Selection on the menu bar. The Profile Selection dialog displays. 2 In the Profile Selection dialog, set or view the following options in the Current Profile. Profile name – selects the required profile available in the drop down list. INI file path – specifies the location and name of the selected profile. Description – displays a legend of the selected profile. 3 Select or review the following options in Pre-defined symbols. Symbols – displays a list of pre-defined symbols specifying application objects. Symbol value – displays the location of a selected symbol (path of specified application object). 4 Click OK to select the pre-defined profile. Chapter 9: Elixir Profile Editor 283 Loading a New Profile in DesignPro Tools You need to load or register a new profile to select a profile that is not available in the Profile name drop-down list in the Profile Selection dialog. To register a new profile: 1 Click New in the Profile Selection dialog. The Register New Profile dialog displays. 2 In the Register New Profile dialog set the following options: Profile name – unique name identifying the new profile you are registering. Description – legend for the new profile. Profile INI file path – unique file name and location for the new profile. You can also browse for the required profile. 3 To browse to the required profile, click . The Open Profile Configuration File dialog displays. Select the profile and click Open. You will return to the Register New Profile dialog with the Profile INI file path updated. 4 Click OK to register the new profile. Customizing Elixir Profile Editor Profile Editor includes an Options dialog that allows you to review, enter, and change the default settings that control the operation and appearance of the application. The Options dialog provides three tabs. Preferences are selected from these tabs by using checkboxes and entering or changing field information. New settings take effect when you either select another tab or close the Options dialog. They remain in effect until changed. Use the following steps to view and set options. 284 1 Select View>Options from the menu bar in the Profile Editor. The Options dialog displays. 2 Click the required Options tab. 3 Review tab selections and make your changes. 4 Click Apply to save the settings, then click OK to return to Profile Editor, Applications window. DesignPro Manager for AFP User Guide Profile Selection Profile Selection is available in all DesignPro applications and allows you to select the required profile for the current application. You can also review the INI file path that is in use for the currently loaded profile. Symbols and Symbol values provide the same functionality that Environment Variables provide for Windows. Environment Variables indicate where to find certain types of computer information. In Profile Editor, Symbols identify application objects; Symbol values identify object paths and types. 1 In the Current Profile, review or select from the following options: Profile name – specifies the required profile available in the drop-down list. INI file path – specifies the location and name of the selected profile. Description – displays a legend of the selected profile. 2 Select the appropriate options from the Pre-defined symbols field from the following: Symbols – displays a list of pre-defined symbols specifying application objects. Symbol value – displays the location of a selected symbol (path of specified application object). For information on Messages and Info Server category, refer to Chapter 4: "Customizing DesignPro Manager". Chapter 9: Elixir Profile Editor 285 286 DesignPro Manager for AFP User Guide Chapter 10: Elixir Viewer In this chapter... About Elixir Viewer Elixir Viewer Workspace Getting Ready to Use Viewer Viewing and Printing Customizing Viewer This chapter provides an overview of the Elixir Viewer operating environment, functions, and features so you can easily display and view fully composed documents and pages. About Elixir Viewer While working with Elixir resources, you encounter documents with different formats like (.ove, .efr, etc.). The Elixir Viewer provides on-screen viewing and test-printing of documents and forms to check object and text placement before final printing. Supported formats include Elixir Document (*.EDF), Elixir Form (*.EFR), AFP (MO:DCA) Document (*.AFP), AFP Overlay Object (*.OVE;01), AFP Overlay Source (*.OGL), PCL (*.PCL;*.PRN), Elixir GDF(*.GDF), Elixir Legacy Form (*.ELX), Postscript (*.PS), Windows EMF (*.EMF), Elixir Dat files (*.DAT), Elixir PrintDriver Document (*.EPL), and Elixir PrintDriver Form (*.EP) . The Elixir Viewer uses the same configuration and conversion capabilities as Elixir input parsers to display pages on-the-fly. Elixir setup files (.EPM) configured using the Converters dialog can be loaded into the Viewer to set up properties for input formats. Most configuration operations performed in Viewer are identical to those in the Elixir Converter. For information on using Converters, refer to Chapter 5: "Using Converters". 287 Elixir Viewer Workspace You can start Elixir Viewer from the Windows Start menu or by the Viewer shortcut icon located in the Applications tab of DesignPro Manager. When you open a document in Viewer, the Application window and its working components are displayed. You can cascade displayed windows in the work area, tile them horizontally, dock them to any side, and split an active window into two or four panes. To revert to the default state, select Default State from the Windows menu. Elixir Viewer showing the Application and Messages window. The workspace is comprised of two windows: Applications window –views all files supported by Viewer. Messages window – displays processing and compilation errors, warning, and informational messages generated by the application. For information on error and warning messages, refer to Appendix A: "Error and Warning Messages". The Messages window is displayed behind the main window initially and can be moved to any required position. Select View>Clear all Messages from the menu bar to clear all messages displayed in the Messages window. You can close the Messages window to allow more space while working in the main window, and the Messages window will automatically open whenever a message is generated. 288 DesignPro Manager for AFP User Guide Using Workspace Tools Using the Elixir Viewer workspace, you can view/print proof documents before sending them for production. The following image illustrates each part of the Elixir Viewer workspace: The Viewer workspace displays the workspace tools. Viewer toolbars provide easy access to the most commonly used application commands. You can hide or display toolbars by selecting View>Toolbars>Desired toolbar from the menu bar. Menu bar and Toolbars 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 performs an associated action or displays a submenu or dialog. Directly below the menu bar are toolbars with buttons that provide access to the most commonly used commands and tools. You can hide or display toolbars by selecting View>toolbar name from the menu bar. Chapter 10: Elixir Viewer 289 Grid You can activate the grid by selecting from the Zoom toolbar or by View>Grid from the menu bar. You can also press <F4> on the keyboard to activate it. The grid feature allows you to position and align objects accurately in the Applications window. Ruler You can activate the Ruler by selecting either from the Zoom toolbar or View>Ruler from the menu bar. The Ruler feature aids accurate object placement in the Applications window. The Viewer workspace shows the Grid and Ruler. 290 DesignPro Manager for AFP User Guide Elixir Viewer Toolbars Viewer toolbars provide access to the most commonly used application commands. It provides the following toolbars: Standard toolbar Zoom toolbar Go toolbar Standard Toolbar The Standard toolbar provides one-click access to basic File and Edit menu commands. Button Purpose Opens selected file. Prints selection. Starts proof of sample data for display in design area. Searches for first occurrence of specified data. Searches for next occurrence of specified data. Launches online help. Chapter 10: Elixir Viewer 291 Zoom Toolbar The Zoom toolbar provides shortcuts to workspace viewing commands. Button Prupose Increases window object magnification. Reduces window object magnification. Sets window display zoom percentage. Sets window display to predefined measurement unit. Shows or hides the graphical ruler. Shows or hides Grid. Sets the page rotation. Go Toolbar The Go toolbar allows you to quickly traverse pages. Button Purpose Displays first page of multi-page document. Displays previous page of multi-page document. Displays page numbers of multi-page document. 292 DesignPro Manager for AFP User Guide Button Purpose Displays next page of multi-page document. Displays last page of multi-page document. Getting Ready to Use Viewer Elixir Viewer uses parsers to read input files for syntactical correctness, and for the presence of required resource settings, which allows Viewer to accurately render the display. Resource paths and input format settings are stored in a required setup file (.EPM). By default, Elixir Viewer uses the setup file ElxView.epm located at: drive:/Documents and Settings/%username%/Application Data/Elixir Technologies. To customize input settings, access the required file format property dialogs from Tools>File Format Properties>Input Formats from the menu bar. Any changes made in the property dialogs are saved in the .EPM file loaded for the current session. You can also specify resource search priorities and cache settings for the parser through the Elixir dialog, by selecting Tools>File Format Properties>Elixir Properties. For more information on setup files, refer to Chapter 5: "Using Converters". The following section includes step by step procedures for loading, modifying, and unloading setup files. Chapter 10: Elixir Viewer 293 Loading a Setup File To load a predefined setup file to view your input: 1 Select Tools>File Format Properties>Load from the menu bar. The Load Setup File dialog displays. 2 Browse to locate the required target folder. 3 Select the following: File name – unique name identifying the file. Files of type – select type of file format from the drop-down list. 4 Click Open to load the selected setup file. Modifying Setup File To modify input settings in a setup file, select Tools>File Format Properties>Input Formats from the menu bar. A menu displays the supported input formats: Input format – the supported input formats include: • • • • • • • AFPDS – sets Advanced Function Presentation Data Stream properties. OGL – sets Overlay Generation Language properties. PCL – sets Print Control Language properties. Elixir GDF – sets Generic Document Format properties. Elixir PDW – sets Elixir Print Driver for Windows properties. Windows EMF – sets Windows Enhanced Metafile properties. Dat Parser – sets .dat file properties. For details on setting or modifying Input properties, see Chapter 6: "File Format Dictionary". Unloading a Setup File To unload the setup file, select Tools>File Format Properties>Clear from the menu bar. The setup (.EPM) file property settings clear and the default settings are applied. 294 DesignPro Manager for AFP User Guide Viewing and Printing Using DesignPro Viewer, you can open files in supported formats to view and print your fully composed documents. It provides accurate viewing and print capabilities by allowing you to view and print one page at a time. For a multi-page document, you can traverse pages using the Go toolbar to view and print each page individually. You can also preview your document and configure printer settings before print time. The following section includes tasks for opening files in Viewer, and previewing and printing a document. Opening a File to View To open a file for Viewing: 1 Select File>Open from the menu bar. The Open dialog displays. 2 Search for the required target folder. 3 Select the following: File name – specifies a unique name identifying the file. Files of type – specifies the type of file formats available for selection. 4 Click Open to view the selected file in the Viewer window. Handling Unrecognized Files If Viewer does not recognize the file format or extension of a file you are trying to view, an ambiguity dialog displays. The ambiguity dialog displays. Chapter 10: Elixir Viewer 295 When this dialog displays, select the appropriate file format from the list and click OK to open the file in the Viewer window. Previewing a Document To proof print a form: 1 Load the document in the Viewer window. 2 Select File>Print Preview from the menu bar. The preview displays in the Viewer window. 3 As appropriate, select the following: Print – displays the Print dialog for setting print properties. Next Page – displays the next page. Prev Page – displays the previous page. One Page/Two Page – displays one or two pages at a time. Zoom In – increases current page magnification. Zoom Out – decreases the current page magnification. Close – exits Print Preview and returns to the previous form view. Printing a Document To print a document: 1 Load the document in the Applications window. 2 Select File>Print from the menu bar. The Print dialog displays. 3 Select the appropriate printing options. 4 Select a value in Page Shift for: X Shift – specifies the horizontal page shift in dots per inch. Y Shift – specifies the vertical page shift in dots per inch. To print a form using internal horizontal and vertical offsets specified in the Options dialog of Form Editor, select the File>Print Setup option from the menu bar. In the Print Setup dialog, select Accept form offset at print and then select Print from the menu bar. 296 DesignPro Manager for AFP User Guide Customizing Viewer Viewer includes an Options dialog that allows you to review, enter, and change the default settings that control the operation and appearance of the application. The Options dialog provides seven category settings. Preferences are selected from these categories by using checkboxes and entering or changing field information. New settings apply when you select a different category and close the Options dialog. They remain in effect until changed. Use the following steps to view and set preferences for listed categories: 1 Select Tools>Options from the menu bar. The Options dialog displays. 2 Select the required Category option. 3 Review the dialog selections and make your changes. 4 Click Apply to save settings and OK to apply the settings. For information on General, Symbols, System Data, Messages, and Info Server categories, refer to Chapter 4: "Customizing DesignPro Manager". Grid Category The Grid category provides function and display options for an invisible network of lines overlaying the Viewer area. You can specify exact grid coordinates for object placement, as well as the number of partitions within each major grid division. For rapid document design, objects can be set to automatically align with specified horizontal and vertical grid coordinates without having to set object dimension properties. However, horizontal and vertical grid options are enabled only when grid is active. To set the spacing for horizontal grid points: 1 Set the required value in Horizontal for the following fields: Major spacing – specifies the distance between horizontal grid lines, per specified unit of measurement. The default value is 1 inch. Number of Subdivisions – specifies the number of splits between grid lines. Chapter 10: Elixir Viewer 297 To set the spacing for vertical grid points: 2 Set the required value in Vertical for the following fields: Major spacing– specifies the distance between vertical grid lines, per specified unit of measurement; default is 1 inch. Number of subdivisions – specifies the number of splits between grid lines. 3 Select or review the following options: Show grid – displays grid in the Viewer area. Hide Major Spacing – hides the Major spacing value set for horizontal and vertical grid. You can also set the horizontal and vertical Grid spacing by selecting Tools>Rulers and Grids>Grid. Ruler Category The Ruler category provides options for setting scale and/or units of measurement for ruler in the Viewer workspace. Select or review the following options: 298 Units – specifies the graphic ruler unit of measurement. The drop-down list displays the values available for selection. Use grid settings for graphic ruler – uses the grid settings for the graphic ruler scale. DesignPro Manager for AFP User Guide Chapter 11: Command Line Converters In this chapter... About DesignPro Tools Command Line Converter Automating Command Line Converter with Scout Elixir Property Parameters Input Property Parameters Output Property Parameters This chapter describes command line parameters and methods for setting up and running the DesignPro Tools for AFP Command Line Converter, and automating the Converter using Elixir Scout Manager. Information in this chapter assumes familiarity with the Elixir Scout component. For a detailed description of Scout, see the Elixir Scout User Guide included in the DesignPro Tools documentation package. It also identifies the Command Line Converter input and output property parameters, and values and corresponding descriptions supported by DesignPro Tools for AFP. About DesignPro Tools Command Line Converter DesignPro Tools Command Line Converter (DPTCLCu.exe) is a command-line executable version of the DesignPro Tools Converters. A series of command line options can be passed to this program to perform all conversions provided by the DesignPro Tools Converters user interface. Elixir Scout Manager can also be configured to run this program with command line parameters to provide complete automation facilities. 299 Elixir Scout Manager runs as a Windows service and “watches” for specified files in one or more disk folders. When files of that type are placed in a watched folder, Scout runs a user-defined process. Scout allows for user selection of watched folders, definition of processes to be performed, and specification of criteria for activating those processes. Using DPTCLCu.exe The DesignPro Tools Command Line Converter is specially designed for automated batch operation. The program file (DPTCLCu.exe) is installed as part of DesignPro Tools for AFP. The default location is: C:\Program Files\Elixir Technologies\Bin Syntax for executing Command Line Converter is: Drive:path\DPTCLCu.exe [parameters] The following sections describe associated command line parameters, and provide usage examples. Command Line Parameters Command line parameters can either be passed on the command line immediately following the program name or placed in a text file whose file name is then passed as a parameter. In each section below, individual command line parameters are listed first, followed by descriptions of property settings for associated input and output files. Examples of command line usage are provided last. -I InputFormat “InputFileName” [property1=value] [property2=value] where: InputFormat - input file format (APFDS, OGL, PCL, etc.). “InputFileName” - fully qualified name of an input file. [property1=value][property2=value] - property settings for InputFormat. See the property descriptions following this section for details. -T InputType where: 300 InputType - input type supported by the InputFormat used. DesignPro Manager for AFP User Guide This table lists supported format types for each Input format. Form is the default Input Type for each Input Format. Input Format Format Supported Types AFPDS AFP Code Page, Coded Font, Font, Form*, FormDef*, Image, PageDef*, * Compiled version ElixirDoc Elixir Form (.EFR) Form Elixir FormDef (.EFD) FormDef Elixir PageDef (.EPD) PageDef Elixir Legacy Coded Font (.CDF) Coded Font Elixir Legacy Code Page (.COD) Code Page Elixir Legacy Font (.HDR) Font Elixir Legacy Form (.ELX) Form Elixir Legacy Graphic (.LP3), BMP, JPEG, TIF, PCX, PNG Image OGL OGL Form PCL HP-PCL Font PPFA PPFA source code PageDef, FormDef ElixirPDW Enhanced Meta Files list (.epl) Document Enhanced Meta File (.ep) Form ElixirGDF -O OutputFormat “OutputFileName” [property1=value] [property2=value]. where: OutputFormat – output file format – Supported options are AFPDS, ElixirGDF, Image, OGL, PCL, PDF, and Postscript. “OutputFileName” - fully qualified output file name. [property1=value][property2=value] – property settings for the OutputFormat. See the property descriptions following this section for details. Chapter 11: Command Line Converters 301 If auto naming of the output file is required, the “-A” parameter (described later) must be specified. The auto name symbolic characters can be used in “OutputFileName.” The following table lists supported format types for each Output format. Output Format Format Suppoted Types AFPDS AFP Code Page, Coded Font, Font, Form, FormDef, Image, PageDef ElixirDoc Elixir Form (.EFR) Form Elixir FormDef (.EFD) FormDef Elixir PageDef (.EPD) PageDef Elixir Legacy Coded Font (.CDF) Coded Font Elixir Legacy Code Page (.COD) Code Page Elixir Legacy Font (.HDR) Font Elixir Legacy Form (.ELX) Form Elixir Legacy Graphic (.LP3, BMP) Image Image Elixir Legacy Graphic (.LP3), BMP, IOCA, JPEG, PCX, PNG, TIFF Image OGL OGL Form PCL HP-PCL Font, Form PDF PDF Form PostScript Postscript Form PPFA PPFA source code PageDef, FormDef ElixirGDF Image output type is determined by either the commands passed at the command-line or from the .epm file. Converter do not explicitly determine the image type produced. 302 DesignPro Manager for AFP User Guide -C ”ConfigFileName.EPM” where: “ConfigFileName” – fully qualified name of Settings file (.EPM). -E[option] “ErrorLogFileName” where: [option] - specifies the overwrite option: • -E – appends new information to existing information in the log. • -Eo – overwrites existing information. • -Ed – appends new information to existing information on a daily basis. After midnight, the next day’s information overwrites information from the previous day. • -Em – appends new information to existing information on a monthly basis. After midnight on the first day of a new month, the new information begins overwriting information from the previous month. “ErrorLogFileName” – is the fully qualified name of an error log file. -P where: -P – sets Parallel Mode Conversion. This command converts a document to two or more output formats simultaneously. For instance, while converting a DAT file to AFP and PDF formats, the converter will convert each page of the DAT file to AFP format, and then convert the same page to the PDF format. The converter will then proceed on to convert the next page in the file. If this option is not set, then the converter will convert the whole file to one output format at a time. -A where: -A – sets Auto Rename of output files. If auto naming of the output file is required, the “-A” parameter must be specified. Specifying this parameter automatically generates the name of the output file (e.g, form1.afp will be converted to form10.pdf) when the file is converted. The auto name symbolic characters can be used in “OutputFileName” (see description for the “-O” parameter). Chapter 11: Command Line Converters 303 -D [property1=value] [property2=value]. where: -D – specifies resource handling options as specified on Elixir Properties property page in form of Property = Value pairs. You can view these options from View>Options>Elixir Internal Setup File settings in the Transformation Suite/Elixir Converter. [property1=value] [property2=value] – specifies the Elixir Property Descriptions of Property = Value pairs. For information on corresponding values for the Elixir properties, see section "Elixir Property Parameters" on page 313. -S where: -S – opens Property page for specified Input Format and saves the settings to “ConfigFileName.” -U – takes settings from ElxConverter UI. @FileName where: 304 FileName – fully qualified name of a file containing the command line parameters. DesignPro Manager for AFP User Guide Command Line Examples Specifying Parameters Directly on a Command Line Example 1: Conversion of Elixir form to AFP overlay Uses default options for overlay output. DPTCLCu.exe –I ElixirDoc c:\elixir\forms\elixir\myform.efr –O AFPDS c:\elixir\forms\afp\ Example 2: Conversion of Elixir Legacy Graphic to AFP Page Segment using properties passed in the command line. The “VBM” option will be used. The page segment will be created in IOCA format. DPTCLCu.exe –I ElixirGDF c:\elixir\pics\elixir\myimage.lp3 –T Image –O AFPDS c:\elixir\pics\afp\s1mypic.seg RecordFormat=2 ImageFormat=3 Example 3: Conversion of multiple Elixir Legacy forms to OGL All Elixir Legacy forms found in input folder are the converted Name of original form used for all OGL forms. Elixir Settings file (.EPM) used to specify conversion parameters for the output OGL files. Conversion results will be written to a log file. DPTCLCu –I ElixirGDF C:\Elixir\Forms\Elixir\*.elx –O OGL C:\Elixir\Forms\OGL\ –C C:\Elixir\MySettings.epm –E C:\Elixir\Conversion.log Chapter 11: Command Line Converters 305 Specifying Parameters in an Unstructured File Command line parameters can be placed in a simple text file. The name of the command line parameters file is then passed to the DesignPro Tools Command Line Converter. Example 1: Elixir form conversion to AFP overlay using external command line parameters All input and output settings were created using the Manager UI and saved to a single .EPM file. Errors and messages written to Conversion.log. AFP overlay file is created using the stem name of the input file and .OVE as the extension. All parameters are stored in command line parameter file called “MyCommandFile.txt.” MyCommandFile.txt contains: -T Form –I ElixirDoc C:\Elixir\Forms\Elixir\MyForm.efr –O AFPDS C:\Elixir\Forms\AFP\ –C C:\Elixir\MySettings.epm –E C:\Elixir\Conversion.log Command line syntax: DPTCLCu.exe @C:\MyFiles\MyCommandFile.txt 306 DesignPro Manager for AFP User Guide Specifying Parameters in a Structured File All command line parameters can be placed in a simple text file using comments and labels to structure the file for improved readability. Comments consist of text strings enclosed within /* and */ pairs. Comments cannot span lines; Command Line Converter ignores them. Labels can be used to structure the file into organized blocks. Labels consist of text strings enclosed within bracket pairs ( [ and ] ). Labels cannot span lines; Command Line Converter ignores them. Example 1: Conversion of Elixir Legacy Graphic (.lp3) to multiple image formats (AFP, TIFF, BMP, and JPG) using a structured parameters file. All parameters are stored in a command line parameter file called “MyCommandFile.txt.” The AFP page segment will be generated in IOCA format using the VBM record format. The AutoDetectFormatFromExtension option is used for TIFF, BMP, and JPG outputs to trigger creation of the default file extension for each format. MyCommandFile.txt contains: /* Sample job */ /* Default settings for inputs and */ /* outputs are defined under */ /* [initial settings]. The properties */ /* listed for the inputs and outputs */ /* override the default settings */ [Input] -I ElixirGDF C:\Elixir\Pics\Elixir\*.lp3 –T Image Chapter 11: Command Line Converters 307 [Outputs] -O AFPDS C:\MyImages\AFP\ RecordFormat=2 ImageFormat=3 -O Image C:\MyImages\TIFF\ CreateTIFF=TRUE AutoDetectFormatFromExtension=FALSE -O Image C:\MyImages\BMP\ CreateBMP=TRUE AutoDetectFormatFromExtension=FALSE -O Image C:\MyImages\JPEG\ CreateJPEG=TRUE AutoDetectFormatFromExtension=FALSE [Default Settings] -C C:\Elixir\MySettings.epm [Message Log] -E C:\Elixir\Message.log Command line syntax: DPTCLCu.exe @C:\MyFiles\MyCommandFile.txt 308 DesignPro Manager for AFP User Guide Automating Command Line Converter with Scout This section describes suggested methods for using Scout with the DesignPro Tools Command Line Converter. Each method listed includes general directions for Scout options and Converter setup. For further details about Scout options and operation, see the Elixir Scout User Guide. To configure Scout for use with the Command Line Converter, follow these steps for setting up a normal Scout operation: Add Watched folder Define Directory Settings Define Action Three suggested methods for configuring Watched folders for use with Scout and Command Line Converter follow: Method 1 The simplest method is to set up a single watched folder for a single input data format and pass command line parameters on the Scout Arguments line. Method 1 assumes: Input file structure and settings are always the same. Output format and settings are always the same. Input data files are dropped into watched folders. Set Up Scout (Method 1) 1 Create a folder to receive input data files. 2 Add the created folder to Scout’s list of watched folders. 3 Configure Scout Directory Settings; set File Filter to match extension used for input data files. Chapter 11: Command Line Converters 309 4 Specify DesignPro Tools Command Line Converter as Executable Action to be launched. File Name – browse for Command Line Converter program file. Default path is: drive:\Program Files\Elixir Technologies\Bin\DPTCLCu.exe, where drive is the drive where the DesignPro Tools program files reside. Arguments – specify command line parameters, as follows: -T InputType -I InputFormat “%INPUT” [property1=value] [property2=value]…[additional parameters as required] Scout will substitute the input file name for %INPUT. Method 2 Instead of all conversion parameters being passed on Scout’s Arguments line as in the first method, this method places them in an external file to be referenced by Command Line Converter when it is executed. Method 2 assumes: Input file structure and settings are always the same. Output format and settings are always the same. Setting file is stored in a single location. Input data files are dropped into a watched folder. Create the Command Line File Create text file containing all input and output property settings (including paths for output files). Do not supply input file path or name, as these are provided when Scout picks up a data file from a watched folder. Save the file to a folder defined to Scout as command line parameter file location. Set up Scout (Method 2) 310 1 Create folder to receive input data files. 2 Add folder to Scout’s watched folders list. 3 Configure Scout Directory Settings. Set File Filter to match extension used for input data files. DesignPro Manager for AFP User Guide 4 Specify DesignPro Tools Command Line Converter as Executable Action to be launched. File Name – browse for Command Line Converter program file. Default path is drive:\Program Files\Elixir Technologies\Bin\DPTCLCu.exe, where drive is the drive where the DesignPro Tools program files reside. Arguments – specify command line parameters, as follows: -I %INPUT @drive:\path\filename.ext, where drive:\path\filename.ext is the path and name of the command line parameter file. When Scout detects an input data file in the watched folder, it will substitute %INPUT with the name of the data file. Method 3 This method uses a command line parameter file placed in a single watched folder to activate conversion operation on a resource file stored in a different folder. Because the command line parameter file contains all conversion parameters, resource files in any supported input format can be processed. Method 3 assumes: User defined front-end process to generate a unique command line parameter file for each resource file to be processed. Command line parameter files are dropped into the watched folder. Command line parameter file must contain: Input resource file full path and file name, and full path of output file(s). All property settings for input and each desired output. Chapter 11: Command Line Converters 311 Set up Scout (Method 3) To set up Scout to process the command line parameter file: 312 1 Create a folder to receive command line parameter files. 2 Add the created folder to Scout’s list of watched folders. 3 Configure Scout Directory Settings. Set File Filter to match extension used for command line parameter files. 4 Specify DesignPro Tools Command Line Converter as Executable Action to be launched. File Name – browse for Command Line Converter program file. Default path is: drive:\Program Files\Elixir Technologies\Bin\DPTCLCu.exe, where drive is the drive where the DesignPro Tools program files reside. Arguments – specify command line parameters, as follows: @%INPUT When Scout detects a command line parameter file in the watched folder, it will substitute %INPUT with the path and name of the file. DesignPro Manager for AFP User Guide Elixir Property Parameters This section identifies the Elixir property parameters, values, and corresponding descriptions for Command Line Converter that are supported by DesignPro Tools for AFP. The default values are in Bold. Category/ [Area] Command Value Description Resources IPSearchOrder UseDefault Resources InputParser/ ElixirGDF Specifies the parser’s priority to search and load the resources. Nonprogrammable through CLC. 0 Does not replace the missing resources with default resources. 1 Replaces the missing resources with default resources (Default). 0 Does not import resources (Default). 1 Imports missing resources only 2 Imports all resources, and overwrites any existing resources. 3 Imports all resources, prompt before overwriting. Resource Library ExportResource Mode Chapter 11: Command Line Converters 313 Category/ [Area] Command Value Description Caching CacheSize 0-30000 Specifies the number of pages to be kept in memory. The default value is 5. 0 specifies unlimited cache. VMemUsageLimit 0-2000 Maximum amount of virtual memory in MB used at a time. Default value is 0, which specifies unlimited virtual memory. 314 DesignPro Manager for AFP User Guide Input Property Parameters This section identifies Command Line Converter input property parameters, values, and corresponding descriptions supported by DesignPro Tools for AFP. AFPDS Input Property Parameters This table describes AFPDS input property parameters (default values in bold). Category/ [Area] Command Value Description OverlayNamePrefix Type Overlay name prefix options. Either: General 0 Use AFP Bounded Box O1 prefix with overlay name (Default). 1 Do not use AFP prefix with overlay name. Segment name prefix options. Either: SegmentNamePrefix Type CreateEmbed Resources ImportDocument Structure Chapter 11: Command Line Converters 0 Use AFP Bounded Box S1 prefix with segment name (Default). 1 Do not use AFP prefix with segment name. 0 Do not embed resources in Elixir document structure (Default). 1 Embed resources in Elixir document structure. 0 Do not import named AFP Page Group records (BNG/ ENG) into Elixir document structure. 1 Import named AFP Page Group records (BNG/ ENG) into Elixir document structure (Default). 315 Category/ [Area] Command Value Description Paper UsePageSize 0 Do not use specified page size (Default). 1 Use specified page size. PageHeight Number Page vertical length specified in “pels” units (Default = 0). PageWidth Number Page horizontal length specified in “pels” units (Default = 0). RotatePageBy 316 Specifies rotation of page or form in degrees with respect to paper. Either: 0 No form rotation (Default). 1 Rotate clockwise at 90 degrees. 2 Rotate clockwise at 180 degrees. 3 Rotate clockwise at 270 degrees. DesignPro Manager for AFP User Guide Category/ [Area] Command Value Description FontNamePrefix Type Naming convention for both print file font references and embedded fonts imported into Resource library. Either: Fonts FontSearch Option DefaultCodepage Name 0 Use AFP Bounded Box X0 prefix to reference fonts (Default). 1 Use Unbounded Box X1X4 prefix to reference fonts. 2 Remove AFP prefix from font name. 0 Do not activate DBCS CodePoint to Unicode mapping (Default). 1 Activate DBCS CodePoint to Unicode mapping. string Name of the codepage to be used for interpretation of text objects with no codepoints specified. (e.g pdf bookmarks). If default codepage is not specified, the data is assumed to be Ebcdic encoded. Chapter 11: Command Line Converters 317 Category/ [Area] Command Value Description DBCSDefault MappingScheme Specifies the AFP input double byte encoding used (for double byte documents). IBM double byte characters are mapped to Unicode values. Either: 0 Use Japanese encoding (Default). 1 Use Korean encoding. 2 Use Traditional Chinese encoding. 3 Use Simplified Chinese encoding. PageDef FixedTextEncoding ConditionEncoding RecordIDEncoding DelimeterEncoding 318 Fixed text encoding option. Either: 0 None 1 ASCII Encoding 2 EBCDIC Encoding (Default) Condition text encoding option. Either: 0 None 1 ASCII Encoding 2 EBCDIC Encoding (Default) Record ID encoding option. Either: 0 None 1 ASCII Encoding 2 EBCDIC Encoding (Default) Delimiter encoding option. Either: 0 None 1 ASCII Encoding 2 EBCDIC Encoding (Default) DesignPro Manager for AFP User Guide Category/ [Area] Command Value CreateTRCTable Create Table Reference Character table; allows use of TRC byte in data to select and switch fonts. Either: GenerateRecord Repeats Description 0 Do not create TRC Table 1 Create TRC Table (Default) Generate record repeats. Either: 0 Donot generate record repeats. 1 Generate repeats for records (default). FormDef ActiveFormdef String Optional name of FormDef used by AFP file. Entry can be FormDef name or full name and path to FormDef file. ExtResourceLibrary String Defines the path to folders containing resources. If a resource is not found in any of the paths specified for that specific resource type, it searches the entries in the path specified in this property. Multiple paths are to be separated by a semicolon. ExtResGroups String Defines the path to folders containing (an) external AFP resource group file(s). Multiple paths are to be separated by a semicolon. Resources ResGroups Chapter 11: Command Line Converters 319 Category/ [Area] Fonts Images Forms 320 Command Value Description FontsPath String Defines the path to folders containing font resources. Multiple paths are to be separated by a semicolon (Default = “%SYSTEM_AFPIN_FO NTS_DIR%”). ImagesPath String Defines the path to folders containing image resources. Multiple paths are to be separated by a semicolon (Default = “%SYSTEM_AFPIN_IM AGES_DIR%”). FormsPath String Defines the path to folders containing form resources. Multiple paths are to be separated by a semicolon (Default = “%SYSTEM_AFPIN_FO RMS_DIR%”). DesignPro Manager for AFP User Guide GDF/Elixir Form Input Property Parameters This table describes Elixir GDF input property parameters (default values are in bold). Category/ [Area] Command Value Description TextFormatting32 Text formatting options. Either: Main Text Formatting GDFFontResolution Resource Management RemoveUnused Fonts UseCodePage Mapping EmbedResources Chapter 11: Command Line Converters 0 Format text compatible with earlier Converter versions (Default). 1 Format text compatible with later Converter version only. Outline font resolution options. Either: 0 Set resolution to 14400 dots per inch (Default). 1 Set resolution to 300 dots per inch. 0 Do not remove unused font references. 1 Remove unused font references in ElixirForm font list to ensure these fonts are not converted. 0 Do not use character set and code page name to reference fonts. 1 Use character set and code page name to reference fonts (Default). 0 Preserve the embedded status of resources in ElixirForm (Default). 321 Category/ [Area] Command Value Description GDFMapping Scheme Preferred font mapping options. Either: 0 Use Japanese encoding to map fonts (Default). 1 Use Korean encoding to map fonts. 2 Use traditional Chinese encoding to map fonts. 3 Use simplified Chinese encoding to map fonts. Resources Fonts Images Forms 322 DefaultPaths String Defines path to folder containing all font, images, and forms resources. FontsPath String Defines the path to folders containing font resources. The default value is the path against the %SYSTEM_FONTS_FIL EPATH% value defined in the .INI file. FormsPath String Defines the path to folders containing image resources. The default value is the path against the %SYSTEM_Image_FILE PATH% value defined in the .INI file. ImagesPath String Defines the path to folders containing form resources. The default value is the path against the %SYSTEM_FORM_FILE PATH% value defined in the .INI file. DesignPro Manager for AFP User Guide Category/ [Area] Command Value Description Tags Tag File TagFile Active Controls EZOption EZInfoFile Chapter 11: Command Line Converters String Specify tag file name or path to tag file. Default path is set in Profile Server. EZ tags are a special set of standard tags (form variables) indicated by keywords in the tag name. The keyword specifies the active object type created from the tag (edit box, radio button, combo box). However, tags can also be interpreted as standard tags. Options indicate tag interpretation. Either: 0 Ignore different tag options. Interpret all tags as standard tags; no active object is created. 1 Interpret all tags with keyword in tag name as EZ Tag; other tags as standard tags. 2 Interpret all tags with keyword in tag name as EZ tag; other tags as EZ tag edit box with text formatting; no standard tag is created. String Specifies text file containing additional information for EZ tags (object border color, edit box background color, etc.). File does not apply when EZOption is set to 0. 323 OGL Input Property Parameters This table describes OGL input property parameters (default values in bold). Category/ [Area] Command Value Description RecordFormat Record length options. Either: General RecordLength GenerateSeqnum SourceEncoding 0 Set to variable record length (Default). 1 Set to fixed record length. Number Fixed record length (Default = 80; Min = 80, Max = 200). 0 Sequence numbers are not present in the source file (Default). 1 Sequence numbers are present in the source file. 0 Use ASCII encoding (Default). 1 Use EBCDIC encoding. Prefix FontNamePrefix Type SegmentName Prefix 324 Font prefix options. Either: 0 Use AFP Bounded Box X0 prefix with font name. 1 Use Unbounded Box X0– X4 prefix with font name. 2 Do not use AFP prefix with font name (Default). Segment name prefix options. either: 0 Use AFP S1 prefix with segment name. 1 Do not use AFP prefix with segment name (Default). DesignPro Manager for AFP User Guide Category/ [Area] Command Value Description Font FontSearch Option WinCodePage 0 Do not activate converter to perform CodePoint to Unicode Mapping for selected encoding type. 1 Activate converter to perform CodePoint to Unicode Mapping for selected encoding type (Default). 0/1252 Text with ASCII fonts will be translated w.r.t. specified Windows Code Page. Default code page is Western (1252). 1250 Central European 1251 Cyrillic 1253 Greek 1254 Turkish 1255 Hebrew 1256 Arabic 1257 Baltic 1361 Johab 1200 OEM 42 Symbol Resources Forms FormsPath Chapter 11: Command Line Converters String Path to Forms (path is searched before any paths or Resource Libraries set in Elixir Internal Setup file) (Ex: FormsPath=”c:\elixir\form s\oglin\”). Paths are separated by ‘;’. 325 PCL Input Property Parameters This table describes PCL input property parameters (default values in bold). Command Value Description Shading ShadingType Shade mapping options. Either: 0 Map closest to Elixir shades (Default). 1 Map to matching Gray shades. 2 Map to DIB (Device Independent Bitmap) pattern. Page PageSize 326 Page size selection. Either: 0 CUSTOM page size 1 A3 page size 2 A4 page size 3 LEGAL page size 4 LETTER page size 5 LEDGER page size 6 EXECUTIVE page size DesignPro Manager for AFP User Guide PPFA Input Property Parameters This table describes PPFA input property parameters (default values in bold). Command Value Description General Comment Support Import comments placement options. Either: 0 Do not import any comment from source file. 1 Add comments before command. 2 Embed comments within command (Default). 3 Append comments to command. PpfaObject NameFrom Comment 0 Do not include object names with comments (Default). 1 Include object names with comments; names are enclosed in comments. First 32 characters are reserved for names. LinkResources 0 Do not embed resources in Elixir document structure (Default). 1 Embed resources in Elixir document structure. Prefix FontName PrefixType SegmentName PrefixType OverlayName PrefixType Font name prefix options. Either: 0 Use AFP Bounded Box X0 prefix with font name. 1 Use Unbounded Box X0–X4 prefix with font name. 2 Do not use AFP prefix with font name (Default). Segment name prefix options. Either: 0 Use AFP S1 prefix with segment name. 1 Do not use AFP prefix with segment name (Default). Overlay name prefix options. Either: Chapter 11: Command Line Converters 0 Use AFP O1 prefix with overlay name. 1 Do not use AFP prefix with overlay name (Default). 327 Command Value Description Font FontSearchOption 0 Do not search for font mappings in Resource Map (Default). 1 Search for font mappings in Resource Map. Encoding RecordFormatType RecordLength SequenceNumber EncodingType Condition Encoding RecordID Encoding 328 Record length options. Either: 0 Set to variable record length (Default). 1 Set to fixed record length. Number Fixed record length (Default = 80; Min = 80, Max = 200). 0 Sequence numbers are not present in the source file (Default). 1 Sequence numbers are present in the source file. Source encoding options. Either: 0 Use ASCII encoding (Default). 1 Use EBCDIC encoding. Condition text coding options. Either: 11 Use ASCII coding (Default). 12 Use EBCDIC coding. Record ID text coding options. Either: 11 Use ASCII coding (Default). 12 Use EBCDIC coding. DesignPro Manager for AFP User Guide Command Value Delimiter Encoding Delimiter text coding options. Either: WinCodePage Description 11 Use ASCII coding (Default). 12 Use EBCDIC coding. 0/1252 1250 Text with ASCII fonts will be translated w.r.t. specified Windows Code Page. Default code page is Western (1252). Central European 1251 Cyrillic 1253 Greek 1254 Turkish 1255 Hebrew 1256 Arabic 1257 Baltic 1361 Johab 1200 OEM 42 Symbol 0 Do not display warning messages as errors. PageDefs and FormDefs cannot be processed until all warnings are addressed (Default). 1 Display warning messages as errors. PageDefs and FormDefs cannot be processed until all warnings are addressed. Error Handling TreatWarningAsError Chapter 11: Command Line Converters 329 ElixirPDW Input Property Parameters This table describes ElixirPDW input property parameters (default values in bold). Category/ [Area] Command Value Description PageSizeType Page Size options. Either: Page PageHeight PageWidth 330 0 Default page size (Default). 1 Custom page size. 2 Minimum page size. Dimensions for custom page size. Number Custom page width in 14400 DPI. Number Custom page height in 14400 DPI. DesignPro Manager for AFP User Guide Output Property Parameters Command Line Converter output property parameters, values, and corresponding descriptions supported by DesignPro Tools for AFP are identified in this section. AFPDS Output Property Parameters This table describes AFPDS output converter property parameters (default values in bold). Command Value Description Main Resolution RecordFormat TextJustification Object resolution options. Either: 240 Set to 240 pels. 300 Set to 300 resolution units (Default). 600 Set to 600 resolution units. Record format options. Either: 0 Create pure MO:DCA files (with no added formatting) for use in AIX and PC environments, and for transfer to MVS and VM hosts (must be reblocked using IBM’s AFP reblocking utility) (Default). 1 Create files formatted for transfer to AS/400 hosts. 2 Create files formatted for transferring to MVS and VM hosts using IBM 3270 (IND$File) compatible file transfer packages. 4 Create files for transfer to DOS or VSE (Virtual Storage Extended) environments. Text justification type options. Either: UserInternal Offset Chapter 11: Command Line Converters 0 No justification provided. 1 Insert inline shifts between words to achieve correct word positioning (Default). 2 Place every character in absolute position. 0 Do not use internal offset feature (Default). 1 Use internal offset feature. 331 Command Value Description PageOffsetX Number Object horizontal offset, per specified in 14400 units per inch. Applicable only if “UseInternalOffset” property has value “1”.(Default = 0). PageOffsetY Number Object vertical offset, per specified in 14400 units per inch. Applicable only if “UseInternalOffset” property has value “1” (Default = 0). PageRotation Object rotation options. Either: 0 DestDirectoryFor ExtResources ReplaceExisting ExternalResources Set to 0 degrees (Default). 270 Set to 90 degrees. 180 Set to 180 degrees. 90 Set to 90 degrees. External resource destination directory options. Either: 0 Use directory specified in profile server (Default) 1 Use output file path. 0 Do not use external resources in lieu of existing resources. 1 Use external resources in lieu of existing resources (Default). Colors ColorFormat 332 Color format mapping options. Either: 0 Map all output colors to black and white shade patterns (Default). 1 Map all colors to black, white, and selected drop down menu color. 2 Map all colors to standard AFP (OCA) colors. 3 Map all colors to Red, Green, Blue model. 4 Map all colors to Cyan, Magenta, Yellow, and Black model. 5 Map all colors to black and white; convert color images to Grayscale. DesignPro Manager for AFP User Guide Command Value HighlightColor Highlight colors available for selection. Either: ImageDithering AdditiveColors Description 1 Set to Blue. 2 Set to Red. 3 Set to Magenta. 4 Set to Green. 5 Set to Cyan. 6 Set to Yellow. 16 Set to Brown (Default). Dithering methods available for selection. Either: (Applicable only if property ColorFormat has value=1 ) 0 Burkes 1 Cluste 2 Floyd-Stein 3 Jarvis 4 Order 5 Sierra 6 Stevenson-Arce 7 Struck Additive colors usage options. Either: AdditiveMax Resolution Chapter 11: Command Line Converters 0 Do not use additive colors (Default). 1 Use additive colors for IM images only. 0 Do not use maximum resolution for IM image (Default). 1 Use maximum resolution for IM image. Applicable only if “AdditiveColors” property has value “1.” 333 Command Value Description Fonts MCFFormat MCF1 MCF2 IncludeFontRes UseFontMapping UseFixedMetric 334 0 Map Coded Font Format 1 reference option (Default). 1 Map Coded Font Format 2 reference option. 0 Use character set and code page name to reference fonts. Applicable only if “MCFFormat” property has value “0” (Default). 1 Use coded font name to reference fonts. Applicable only if “MCFFormat” property has value “0.” 0 Use character set and code page name to reference fonts. Applicable only if “MCFFormat” property has value “1” (Default). 1 Use coded font name to reference fonts. Applicable only if “MCFFormat” property has value “1.” Font embedding options. Either: 16 Do not embed fonts. 17 Embed fonts as part of the overlay or other resource at the beginning of the file, which is reserved for “resource groups” (Default). 18 Embed fonts in external resource file. 0 Do not activate Font Map that enables the converters to use user-defined mappings in the Resource Map (Default) 1 Activate Font Map, which enables the converters to use user-defined mappings in the Resource Map. 0 Do not use fixed metrics to generate AFP fonts. Relative metrics is used. 1 Use fixed metric to generate AFP fonts at 300 pels and 600 pels. DesignPro Manager for AFP User Guide Command Value TTFontOutput True Type font output conversion options. Either: EnableFractPoint Size RasterFontOutput Description 0 Create AFP raster fonts (Default). 1 Create AFP outline (Type1 PFB). 2 Create True Type font. 0 Do not enable fractional pointsize (Default). 1 Enable fractional pointsize. Raster font output conversion options. Either: IncludeFontRes 0 Creates bounded fonts (Default). 1 Creates unbounded fonts. 0 Do not include only used characters (Default). 16777216 Allow600DPIFonts SetMICRFlag GenerateFullFont TextRotation Include only used characters. 0 Do not enable use of 600 DPI fonts. Printer must support 600 DPI fonts to use this option (Default). 1 Enable use of 600 DPI fonts. Printer must support 600 DPI fonts to use this option. 0 Do not set Magnetic Ink Character Resolution (MICR) for all AFP bounded Fonts (Default). 1 Set Magnetic Ink Character Resolution (MICR) for all AFP bounded Fonts. 0 Only write AFP Character Set. Do not write Coded Font and Code Page. 1 Also write AFP Coded Font and Code Page with Character set. Text rotation options. Either (Applicable only if RasterFontOutput property has value = 1): 0 Chapter 11: Command Line Converters Set to source. 1 Set to All (Default). 2 Set to portrait. 3 Set to landscape. 5 Set to inverse landscape. 335 Command Value Description CharRotation Character rotation options. Either (Applicable only if RasterFontOutput property has value = 1): 0 Set to source. 1 Set to All (Default). 2 Set to portrait. 3 Set to landscape. 5 Set to inverse landscape. Images IncludeImages ImageFormat 336 Image embedding options. Either: 16 Never embed images in output file. 17 Embed images in inline resource group (Default). 18 Embed images in external resource file. Image format options. Either: 1 Use IM image (migration image object). 3 Use IOCA (Image Object Content Architecture) without compression (Default). 4 Use GOCA (Graphics Object Content Architecture) Raw. 5 Use object container file type; an AFP wrapper around “DIB Win” image type. 6 Use object container file type; an AFP wrapper around “TIFF” image type. 7 Use object container file type; an AFP wrapper around “JPEG” image type. 8 Use object container file type; an AFP wrapper around “PCX” image type. 16777219 Use IOCA (Image Object Content Architecture) with JPEG (Joint Photographic Experts Group) compression. 33554435 Use IOCA (Image Object Content Architecture) without compression and resize IOCA image to target resolution or OBD size. DesignPro Manager for AFP User Guide Command Value Description 50331651 Use IOCA (Image Object Content Architecture) with JPEG (Joint Photographic Experts Group) compression and resize IOCA image to target resolution or OBD size. 268435459 Use IOCA (Image Object Content Architecture) with CCITT group 4 (bilevel image) compression. 285212675 Use IOCA (Image Object Content Architecture) with CCITT group 4 (bilevel image) compression and JPEG (Joint Photographic Experts Group) compression. 301989891 Use IOCA (Image Object Content Architecture) with CCITT group 4 (bilevel image) compression and resize IOCA image to target resolution or OBD size. 318767107 Use IOCA (Image Object Content Architecture) with CCITT group 4 (bilevel image) compression and JPEG (Joint Photographic Experts Group) compression and resize IOCA image to target resolution or OBD size. Forms IncludeForms Form inclusion options. Either: OverlayRotation Support 16 Never include forms in output file. 17 Embed forms in Inline Resource group (Default). 18 Embed forms in External Resource file. 0 Do not activate AFP printer IPO/PMO rotation feature for selected overlay (Default). 1 Activate AFP printer IPO/PMO rotation feature for selected overlay. CodePages CodePagesNameList String Chapter 11: Command Line Converters Code pages available for associating with character sets when converting non-AFP fonts to AFP raster fonts. Multiple code page names are separated using a semi-colon. 337 Command Value Description FormDef IncludeFormdef FontFID ColorValue Finish ProcessingSupport 338 FormDef inclusion options. Either: 16 Omit FormDef and IMM references from output file. 17 Embed FormDef in Inline Resource Group and write IMM references to output file (Default). 18 Convert FormDef to External Resources file and write IMM references to output file. 0 Do not use Font ID support feature with output file; use if FormDef uses specified fonts when a raster font of a specified resolution and metric-technology cannot be found on the printer (Default). 1 Use Font ID support feature with output file; use if FormDef uses specified fonts when a raster font of a specified resolution and metrictechnology cannot be found on the printer. 0 Do not use Color Value printer settings (Default). 1 Use Color Value printer settings. 0 Do not use Finish support feature with output file; set for printer supported finishing options, such as folding (Default). 1 Use Finish support feature with output file; set for printer supported finishing options, such as folding. 0 Do not use Processing support feature with output file; enables post-processing options supported by printer, such as perforation cuts or separation cuts (Default). 1 Use Processing support feature with output file; enables post-processing options supported by printer, such as perforation cuts or separation cuts. DesignPro Manager for AFP User Guide Command Value NUPSupport InvokeSupport VfySetup View TonerSaver FlashSupport Chapter 11: Command Line Converters Description 0 Do not use NUP support feature with output file. 1 Use NUP support feature with output file (Default). 0 Do not use Invoke support feature with output file; enables compatibility to 3800 AFP printers (Default). 1 Use Invoke support feature with output file; enables compatibility to 3800 AFP printers. 0 Do not use Verification ID support feature with output file; use with IBM InfoPrint 4000 Highlight Color postprocessor to transmit the setup IDs to all CopyGroups in the FormDef (Default). 1 Use Verification ID support feature with output file; use with IBM InfoPrint 4000 Highlight Color postprocessor to transmit the setup IDs to all CopyGroups in the FormDef. 0 Do not enable IBM’s Workbench Viewer (Default). 1 Enables IBM’s Workbench Viewer. 0 Do not use Toner Saver support feature with output file (Default). 1 Use Toner Saver support feature with output file. 0 Do not use Flash support feature with output file; use with 3800 printers to make carbon copies of printed documents using a “flash” of light during the printing process; flash settings are defined in SubGroup (Default). 1 Use Flash support feature with output file; use with 3800 printers to make carbon copies of printed documents using a “flash” of light during the printing process; flash settings are defined in SubGroup. 339 Command AdjustSupport QualitySupport CutSheet Media OutBin BinError 340 Value Description 0 Do not use Adjust support feature with output file, (available for 3800 printers only); reduces logical page size using L-units; useful when creating booklets that require a gutter for binding (Default). 1 Use Adjust support feature with output file, (available for 3800 printers only); reduces logical page size using L-units; useful when creating booklets that require a gutter for binding. 0 Do not use Quality support feature with output file; for AFP printers having a quality setting, where a set value prints a certain quality (Default). 1 Use Quality support feature with output file; for AFP printers having a quality setting, where a set value prints a certain quality. 0 Do not use Cut Sheet support feature with output file. 1 Use Cut Sheet support feature with output file (Default). 0 Do not use Input Bin support feature with output file (Default). 1 Use Input Bin support feature with output file. 0 Do not use Out Bin support feature with output file; allows you selection of specific bin at the CopyGroup or SubGroup level (Default). 1 Use Out Bin support feature with output file; allows you selection of specific bin at the CopyGroup or SubGroup level. 0 Do not use Bin Error support feature with output file; sets command to stop printing if the wrong media is loaded in the printer (Default). 1 Use Bin Error support feature with output file; sets command to stop printing if the wrong media is loaded in the printer. DesignPro Manager for AFP User Guide Command Value FinError Description 0 Do not use Fin Error support feature with output file; sets command to stop printing if the wrong finishing option is set (Default). 1 Use Fin Error support feature with output file; sets command to stop printing if the wrong finishing option is set. 0 Do not use Pels Per Inch value from Margin category in PageDef properties (Default). 1 Pels Per Inch value from Margin category in PageDef properties instead of resolution set in the AFPDS dialog Main category. 0 Do not use ANSI carriage control with output file. Set if file contains a carriage control character and PageDef contains a condition (Default). 1 Use ANSI carriage control with output file. Set if file contains a carriage control character and PageDef contains a condition. 0 Do not enable Object Container information to be written to PageDef (Default). 1 Enable Object Container information to be written to PageDef. Set when PageDef objects have been defined in an Object List and inserted under a record. 0 Do not use Graphic support in PageDef; Do not enable Drawgraphic information to be written to PageDef (Default). 1 Use Graphic support in PageDef; enable Drawgraphic information to be written to PageDef. Only applicable to Record format PageDefs using Drawgraphics. 0 Do not suppress callouts to the master font list (Default). 1 Suppress callouts to the master font list. PageDef UseInternalPels PerInch AnsiCC ObjectSupport GraphicsSupport SuppressFont Chapter 11: Command Line Converters 341 Command PageDefColorSupport FixedTextEncoding ConditionEncoding RecordIDEncoding DelimeterEncoding Value Description 0 Do not use Color support in PageDef (Default). 1 Use Color support in PageDef; target printer must support color. Fixed text encoding options. Either: 0 Use ASCII encoding. 1 Use EBCDIC encoding (Default). Condition encoding options. Either: 0 Use ASCII encoding. 1 Use EBCDIC encoding (Default). Record ID encoding options. Either: 0 Use ASCII encoding. 1 Use EBCDIC encoding (Default). Delimiter encoding options. Either: 0 Use ASCII encoding. 1 Use EBCDIC encoding (Default). 0 Do not activate IBM Graphics Object Content Architecture; Rasterize graphics objects in IBM AFP/MO:DCA data stream. 1 Activate IBM Graphics Object Content Architecture; do not rasterize graphics objects in IBM AFP/MO:DCA data stream (Default). 0 Do not draw graphics object area borders separately; Use GOCA border and interior Set Process Color method (Default). 1 Draw graphics object area borders separately; do not use GOCA border and interior Set Process Color method. 0 Do not activate IBM Bar Code Object Content Architecture; Rasterize bar code objects in IBM AFP/MO:DCA data stream. 1 Activate IBM Bar Code Object Content Architecture; do not rasterize bar code objects in IBM AFP/MO:DCA data stream (Default). Page Objects UseGOCAGraphics DrawGOCASeparate Borders UseBCOCABarcodes 342 DesignPro Manager for AFP User Guide Command Value SimplifyWholePage ConvertFormToImage Description 0 All overlapping objects are not rasterized to image (Default). 1 All overlapping objects are rasterized to image. Selection requires greater conversion time. 0 Do not rasterize whole page/form. 1 Rasterize contents of entire page/form to a single image. GDF/Elixir Form Output Property Parameters This table describes GDF/Elixir Form output converter property parameters (default values in bold). Category/ [Area] Command Value Description Main Preference Chapter 11: Command Line Converters 0 Ensure fidelity level of object in .ELX format is the same as the original file by rasterizing object image, instead of an .ELXcompatible version of the object. Objects converted to raster image are not easily editable. 1 Change complex objects into a series of simple objects by replacing unsupported object properties with similar "simple" properties (Default). 343 Category/ [Area] Resources Command ReplaceExisting Resources DestDirectory ForResource MaxLengthRes Name Colors OnlyBlackAnd White MapCMYKtoRGB SubstituteGray 344 Value Description 0 Do not use external resources in lieu of existing resources. 1 Use external resources in lieu of existing resources (Default). Resource destination directory options. Either: 0 Use directory specified in profile server (Default). 1 Use output file path. Specifies maximum characters used for resource name. Either: 6 Set to 6 characters (Default). 8 Set to 8 characters. 0 Do not convert all input file color to black and white (Default). 1 Convert all input file color to black and white. 0 Do not map all CMYK colors to RGB color model. 1 Map all CMYK colors (Cyan, Magenta, Yellow, and Black) to RGB color model (Default). 0 Do not convert all input file gray background color to a pattern (Default). 1 Convert all input file gray background color to a pattern. DesignPro Manager for AFP User Guide Category/ [Area] Command Value Description Images Color Format ExportImages ImageType 0 Do not export external image resources during conversion (Default). 1 Export external image resources during conversion. Image format options. Either: 0 Set to Windows Bitmap (Default). 1 Set to Elixir Legacy Graphic. 0 Do not export all font resources to external files during conversion to ElixirForm (Default). 1 Export all font resources to external files during conversion to ElixirForm. Fonts ExportFonts Chapter 11: Command Line Converters 345 Category/ [Area] Rasterize Font Output Command Value FontType Raster font output conversion options. Either: FontDirection UseSource PrintDirection CreatePCMapped TTF 0 Create bounded fonts (Default). 1 Create unbounded fonts. 2 Create Elixir fonts. Font type options. Either: 0 Set to unbounded X1 type font (Default). 1 Set to unbounded X2 type font. 2 Set to unbounded X4 type font. 0 Do not use same font type as source font (Default). 1 Use same font type as source font. 0 Do not create PC mapped fonts (Default). 1 Create PC mapped fonts. KMPFileName Select KMP file name for creating PC mapped fonts. RasterizeTT Fonts True Type font output conversion options. Either: RoundPointSize 346 Description 0 Rasterize only temporary True Type fonts (Default). 1 Rasterize all TrueType fonts. 0 Do not round font point size to full value (Default). 1 Round font point size to full value. DesignPro Manager for AFP User Guide Category/ [Area] Embedded Outline Fonts Command UseFontMapping OutlineFont Handling Value Description 0 Do not activate font mapping using Elixir Resource Map (Default). 1 Activate font mapping using Elixir Resource Map. Options for outline fonts that are not mapped. Either: 0 RasterizeNon ExistingTT Fonts Chapter 11: Command Line Converters Replace with system TrueType fonts using original font name (Default). 1 Rasterize font. 0 Do not convert outline fonts to AFP raster fonts if font name is not found in system (Default). 1 Convert outline fonts to AFP raster fonts if font name not found in system. 347 Category/ [Area] Command Value Default Encoding Font character set options. Either: UseDefaultEncoding ForTTFonts UseUnicode Encoding 348 Description 0/1252 Set to Western (Default). 1250 Central European 1251 Cyrillic 1253 Greek 1254 Turkish 1255 Hebrew 1256 Arabic 1257 Baltic 1361 Johab 42 Symbol 0 Do not use selected character set option for TrueType fonts (Default). 1 Use selected character set option for TrueType fonts. 0 Do not use Unicode for text encoding (Default). 1 Always use Unicode for text encoding. DesignPro Manager for AFP User Guide Image Output Property Parameters This table describes Image output converter property parameters (default values in bold). Category/ [Area] Command Value Description Output Formats Dithering Method AutoDetect FormatFrom Extension Conversion Settings Chapter 11: Command Line Converters Specifies dithering method used during transfer of image to highlight system. Either: 1 Set to Floyd-Stein. 2 Set to Stuck. 3 Set to Burkes. 4 Set to Sierra. 5 Set to Stevenson-Arce. 6 Set to Jarvis. 7 Set to Order (Default). 8 Set to Clustered. 0 Do not detect image format type from file name. 1 Automatically identify image format type from file name; allows only one output file at a time (Default). Image conversion options. Either: 0 Preference conversion speed; normal processing without simplification (Default). 1 Simplify images when some objects are not supported by Image format. 349 Category/ [Area] Command CreateTIFF CreateBMP CreatePCX CreateIMG CreateLP3 CreatePNG CreateIOCA 350 Value Description 0 Do not use TIFF (Tagged Image File Format) (Default). 1 Use TIFF (Tagged Image File Format). 0 Do not use BMP (Windows Bitmap) (Default). 1 Use BMP (Windows Bitmap). 0 Do not use PCX (PC – Paintbrush Format) (Default). 1 Use PCX (PC – Paintbrush Format). 0 Do not use IMG (GEM Paint) (Default). 1 Use IMG (GEM Paint). 0 Do not use LP3 (Elixir Legacy Graphic) (Default). 1 Use LP3 (Elixir Legacy Graphic). 0 Do not use PNG (Portable Network Graphics) (Default). 1 Use PNG (Portable Network Graphics). 0 Do not use IOCA (Image Object Content Architecture) (Default). 1 Use IOCA (Image Object Content Architecture). DesignPro Manager for AFP User Guide Category/ [Area] Command CreateJPEG Value Description 0 Do not use JPEG (Joint Photographic Experts Group) (Default). 1 Use JPEG (Joint Photographic Experts Group). 0 Do not use solid colors in place of color shading (Default). 1 Use solid colors in place of color shading. 0 Do not use image halftoning to print bitmaps (Default). 1 Use image halftoning to print bitmaps. 0 Do not use image halftoning to print raster fonts (Default). 1 Use image halftoning to print raster fonts. Drawing Options SubstituDIB BrushesBySolid Color HalftoneLogos HalftoneRaster Fonts Image LHorResolution Number Horizontal image resolution, in dots per inch (Default = 300). LVerResolution Number Vertical image resolution, in dots per inch (Default = 300). 0 Do not use same resolution as source (Default). 1 Use same resolution as source. ResolutionAs Source Chapter 11: Command Line Converters 351 Category/ [Area] TIFF Command Value TiffBitsPer Pixel Available color depths (number of bits per one image pixel) for specified image format. Tiff Compression TiffMultipage 352 Description 0 Set color depth to monochrome (Default). 1 Set color depth to 4 bits per pixel. 2 Set color depth to 8 bits per pixel. 3 Set color depth to 24 bits per pixel. 0 Set to PackBits (Default). 1 Set to CCITT G3. 2 Set to CCITT G4. 0 Converter creates one file with embedded multiple images (pages) and appends TIFF image to the old file (Default). 1 Selection enables TIFF output to create a separate file for each document page (image) wherein the converter overwrites the image files. DesignPro Manager for AFP User Guide Category/ [Area] BMP Command BmpBitsPer Pixel BmpCompression PCX JPEG PcxBitsPer Pixel JPEGBitsPer Pixel JPEGImage Quality Chapter 11: Command Line Converters Value Description 0 Set to monochrome image (Default). 1 Set color depth to 4 bits per pixel. 2 Set color depth to 8 bits per pixel. 3 Set color depth to16 bits per pixel. 4 Set color depth to 24 bits per pixel. 5 Set color depth to 32 bits per pixel. 0 Do not use image compression (Default). 1 Set image compression to RLE. 0 Set to monochrome image (Default). 1 Set color depth to 4 bits per pixel. 2 Set color depth to 8 bits per pixel. 3 Set color depth to 24 bits per pixel. 0 Set color depth to 8 bits per pixel (Default). 1 Set color depth to 24 bits per pixel. Number JPEG image quality; value between 1 –100 (Default = 50). 353 Category/ [Area] IOCA Command IocaRecord Format IocaColor Format IocaHLColor Ioca Compression PNG 354 PngBitsPer Pixel Value Description 0 Set to AFPDS (Default). 1 Set to AS400. 2 Set to DOS/VSE. 3 Set to VBM. 0 Set to Black & White (Default). 1 Set to Highlight Color. 2 Set to OCA color. 3 Set to Full color (RGB). 4 Set to Full color (CMYK). 5 Set to Grayscale. 0 Set to Blue (Default). 1 Set to Red. 2 Set to Magenta. 3 Set to Green. 4 Set to Cyan. 5 Set to Yellow. 6 Set to Brown. 0 Set to CCITT G3 (Default). 1 Set to CCITT G4. 0 Set to monochrome image (Default). 1 Set color depth to 4 bits per pixel. 2 Set color depth to 8 bits per pixel. 3 Set color depth to 24 bits per pixel. DesignPro Manager for AFP User Guide Category/ [Area] Command IMG ImgFormat ImgCompression ImgUseSimple Pal ImgColor Palette LP3 Lp3FormatIndex Chapter 11: Command Line Converters Value Description 0 Black & White image format (Default). 1 Color image format. 0 Do not activate image compression (Default). 1 Activate image compression. 0 Do not activate simple Palette Form usage. 1 Activate simple Palette Form usage (Default). String Combinations of possible Catalogs & Palettes (Catalog.Palette) (Default = Xerox1, Red). 0 Set to Black & White (Default). 1 Set to Full Color. 2 Set to Highlight Red. 3 Set to Highlight Green. 4 Set to Highlight Blue. 355 OGL Output Property Parameters This table describes OGL output converter property parameters (default values in bold). Command Value Description General UnitValue Internal Offset 0 Set to pels. 1 Set to inches (Default). 2 Set to millimeters. 0 Do not use internal offset feature (Default). 1 Use internal offset feature. Horizontal Offset Number Object horizontal offset, per specified unit of conversion. VerticalOff set Number Object vertical offset, per specified unit of conversion. Orientation RecordLength GenerateSequence Number Source Encoding 356 Export unit of measure options. Either: Print orientation options. Either: 0 Set to 0 degrees (Default). 90 Set to 90 degrees. 180 Set to 180 degrees. 270 Set to 270 degrees. Number Fixed record length (Default = 80; Min = 80, Max = 200). 0 Generate sequence numbers for each record (Default). 1 Do not generate sequence numbers. Source encoding options. Either: 0 Use ASCII encoding (Default). 1 Use EBCDIC encoding. IncludeForm Desc 0 Do not include form description in output file. 1 Include form description in output file (Default). KeepTexts Boxed 0 Do not retain text boxes (Default). 1 Retain text boxes. DesignPro Manager for AFP User Guide Command Value UseCRLF KeepFidelity GenerateBPSDTags Description 0 Do not output CRLF (new line) after each record (Default). 1 Output CRLF after each record. 0 Sometimes the characters in a text have special spacing associated with them, usually MS. Word documents. With this option, this special spacing is ignored (Default). 1 Special spacing is processed to persist actual text positioning. It may result into the generation of separate text commands for each character in the text – varies from case to case. 0 Ignore the tags and generate simple text against the tags used in the form (Default). 1 Generate tag commands against the tags used in the form. Form Overlay Messages Overlay Storage Determines the printer error modes that display. Either: 0 Display all error and warning messages (Default). 1 Display only warning messages. 2 Display only error messages. Storage options for compiled overlays. Either: Overlay Summary Chapter 11: Command Line Converters 0 Save overlay as a new member (file) in host dataset (host file). 1 Compile and list the results, but do not store compiled overlay (use for debugging the source) (Default). 2 Compile overlay and overwrite existing member (file) having the same name. 0 Do not set compiler command to generate summary report as printing ends (Default). 1 Set compiler command to generate summary report as printing ends; summary details on number of resources used and similar statistics is placed at end of compiler listing. 357 Command OverlaySOSI Value Description 0 Do not enable switching between double and single byte font if SOSI character is recognized in text. 1 Enable switching between double and single byte font if SOSI character is recognized in text; when checkbox is clear, SOSI character is skipped in text command and single byte font is used (Default). 0 Do not use font map. 1 Use Resource Map to pick font mappings (Default). 0 Specify font name exported as charset and code page name pair format. 1 Do not export font name as charset and code page name pair format (Default). 0 Do not round font point size to full value. 1 Round font point size to full value (Default). Font UseFontMap CodedFont RoundPoint Size TTFontOutput AutogenerateUserFont Name TextEncoding 358 True type fonts output options. Either: 0 Set to Raster (Default). 1 Set to Outline (Type 1 PFB). 0 Export original local font names to the file for selection in overlay list. 1 Specify automatic generation of local font names, such as Ft0000, Ft0001 (Default). 0 Output text in Character form. 1 Output text in EBCDIC HEX code points. DesignPro Manager for AFP User Guide Command Value WinCodePage Description 0/1252 Text with ASCII fonts will be translated w.r.t. specified Windows Code Page. Default code page is Western (1252). 1250 Central European 1251 Cyrillic 1253 Greek 1254 Turkish 1255 Hebrew 1256 Arabic 1257 Baltic 1361 Johab 1200 OEM 42 Symbol Color OutputColor Color format mapping options. Either: Chapter 11: Command Line Converters 0 Do not use additive colors (Default). 1 Map all colors to Black and White. 2 Map all colors to Red, Green, Blue model. 3 Map all colors to Cyan, Magenta, Yellow, and Black model. 359 Command Value Description Environment TargetEnvironment 360 Target environment types. Either: 0 Set to IBM Multiple Virtual Storage (MVS) operating system (Default). 1 Set Virtual Machine (VM). 2 Set to Virtual Storage Extended (VSE). Environment Font String DDNAME of fonts corresponding to data control block containing same name for MVS or Font file types available for selection for VM. Environment Pseg String DDNAME of page segments corresponding to data control block containing same name for MVS environment, or Page segment file types for VM. DesignPro Manager for AFP User Guide PCL Output Property Parameters This table describes PCL output converter property parameters (default values in bold). Command Value PCLLevel PCL level options. Either: ColorMode Shades OutputMode RasterizeObject TextJustification Description 0 Set to PCL level 4. 1 Set to PCL level 5 (Default). 0 Do not activate PCL5c language color output feature (Default). 1 Activate PCL5c language color output feature. 0 Do not use printer shade patterns only; do not use user-defined shades. 1 Use printer shade patterns only; do not use user-defined shades (Default). 0 Print PCL commands only. 1 Use Bitmap object print option (Default). 0 Print entire page as bitmap. Applicable only if “OutputMode” option has value “1.” 1 Rasterize complex objects (rounded corners boxes, circles, paths, etc.). Applicable only if “OutputMode” option has value “1” (Default). Text justification type options. Either: 0 No justification provided (Default). 1 Insert inline shifts between words to achieve correct word positioning. 2 Place every character in absolute position. ShiftX Number Output page horizontal shift; value between 04 inches (Default = 0). ShiftY Number Output page vertical shift; value between 0-4 inches (Default = 0). AsMacro Chapter 11: Command Line Converters 0 Do not print each page as separate macro (Default). 1 Print each page as separate macro. 361 Command MacroOverlay MacroID Description 0 Do not create a macro overlay. (Default). 1 Creates a macro overlay. This option works if "As Macro" property has value "1". Number Unique name identifying macro. This option works if “AsMacro” property has value “1” (Default = 1). FormsAsMacro 0 Do not print each form as separate macro. 1 Print each form as separate macro (Default). ExcludeCommand 0 Include job or page related commands in output file (Default). 1 Do not include job or page related commands in output file. 0 Do not append form feed command to end of output file (Default). 1 Append form feed command to end of output file. 0 Do not generate dimension and output resolution information file (Default). 1 Generate dimension and output resolution information file. 0 Do not create a PCL macro file compatible with EAS. (Default) 1 Creates a PCL macro file compatible with EAS. This option works if "As Macro" property has value "1". FormFeed InfoFile PreserveCompatibility 362 Value DesignPro Manager for AFP User Guide Command Value Description Images Resolution Image resolution options. Either: HPGLMode ImagesIntoFonts 300 Set to 300 DPI (Default). 600 Set to 600 DPI. 0 Do not format vector graphics using HP-GL/2 graphic language (Default). 1 Format vector graphics using HP-GL/2 graphic language. 0 Do not convert images to font output (tiles) (Default). 1 Convert images to font output (tiles). CharMaxX Number Maximum character width in pixels. Applicable only if “ImagesIntoFonts” property has value “1” (Default = 128). CharMaxY Number Maximum character height in pixels. Applicable only if “ImagesIntoFonts” property has value “1” (Default = 128). CompressMode Chapter 11: Command Line Converters 0 Do not use compression. 1 Simplest compression mode (Run-length encoding); for use as single selection only (other modes will override selection). 2 TIFF compression mode; can be used alone or with other modes. 3 Delta row compression mode; can be used alone or with other modes (Default). 4 Combination of TIFF compression mode and Delta Row compression mode. 5 Exclusive mode for adaptive compression; no other compression modes can be used. 363 Command Value Description Fonts UsedFontsOnly DownloadMode 0 Download all fonts defined in the font list. 1 Download only used fonts. (Default) Font download placement options. Either: 0 Place fonts at beginning of output file (Default). 1 Place fonts in separate output file. 2 Do not download fonts. 3 Print all text as bitmap. 0 Do not generate all fonts as PCL printer permanent fonts (Default). 1 Generate all fonts as PCL printer permanent fonts. Requires “DownloadMode” property to have value “1.” 0 Do not activate font mapping using Elixir Resource Map (Default). 1 Activate font mapping using Elixir Resource Map. 0 Download as scalable fonts (TrueType). 1 Download as raster fonts. (Default) 2 Print all text as bitmap. UsedCharsOnly 0 Do not download text characters only. 1 Download text characters only (Default). GlyphCompress 0 Do not activate compressed character bitmap feature (Default). 1 Activate compressed character bitmap feature. PermanentFonts FontMapping TrueTypeMode 364 Font Download option. Either DesignPro Manager for AFP User Guide Command Value Description Paper PaperSource PaperSize Paper feed source options. Either: 0 Set to tray 1. 1 Set to tray 2. 2 Set to manual feed. 3 Do not select feed source (Default). 4 Use document feed source default. Page sizes available for selection. Either: Chapter 11: Command Line Converters 0 Use A4 (210 x 297 mm) (Default). 1 Use A3 (297 x 420 mm). 2 Use Letter (8.5 x 11 inch). 3 Use Legal (8.5 x 14 inch). 4 Use Ledger (11 x 17 inch). 5 Use Executive (7.25 x 10.5 inch). 6 Use Automatic (designed size). 7 Use Monarch (Letter – 3 7/8 x 7.5 inch). 8 Use Commercial – 10 (Business – 4 1/8 x 9.5 inch). 9 Use International DL (110 x 220 mm). 10 Use International C5 (162 x 229 mm). 11 Use International B5 (176 x 250 mm). 365 Command Value Description Page Orientation DuplexMode EdgetoEdge 366 Paper orientation options. Either: 0 Set page top to print along short side of paper. 1 Set page top to print along long side of paper. 2 Set to page-dependent orientation (Default). 3 Set to document printing default. Print mode options. Either: 0 Single-sided printing (Default). 1 Double-sided printing aligned to longest paper edge. 2 Double-sided printing aligned to shortest paper edge. 3 Set to document printing default. 0 Do not create a PCL file that can print Edge to Edge. (Default) 1 Enable edge to sdge printing for the PCL file. From Top-Left to Right-Bottom ignoring margins on both sides. DesignPro Manager for AFP User Guide PDF Output Property Parameters This table describes PDF output converter property parameters (default values in bold). Category/ [Area] Command Value Description Main FlateCompression ASCIIOutput OptimizePDF Optimization OptimizeVisibility SubstitutePDF Chapter 11: Command Line Converters 0 Do not Compress file using standard PDF compression. 1 Compress file using standard PDF compression (Default). 0 Do not use ASCII 32-127 characters in output stream (Default). 1 Use ASCII 32-127 characters in output stream. 0 Do not create optimized PDF file (Default). 1 Create optimized PDF file. Non-equivalent PDF graphical handling options. Either: 0 Substitute non-equivalent PDF graphical features with closest PDF feature (Default). 1 Convert graphic to PDF image. 0 Do not convert shadings to solid opaque colors. 1 Convert shadings to solid opaque colors (Default). 367 Category/ [Area] Command Preserve Rotation OmitBlanks Font UseFontMapping TrueTypeFont ConversionType 368 Value Description 0 Do not keep original rotation of backward duplex pages (Tumble duplex rotates pages upside down in output PDF file) (Default). 1 Keep original rotation of backward duplex pages (Tumble duplex rotates pages upside down in output PDF file). 0 Convert blank pages in output file. 1 Do not convert blank pages in output file (Default). 0 Do not map fonts defined by Elixir Resource map. 1 Map fonts defined by Elixir Resource map (Default). (Non-mapped) True Type and ATM font handling options. Either: 0 Embed document fonts in PDF file as Adobe Type 3 raster fonts (Default). 1 Create references to external fonts. 2 Let converter automatically create Multiple Master fonts or embed fonts in PDF file. 3 Create multiple master versions of all fonts in document. DesignPro Manager for AFP User Guide Category/ [Area] Command Value RasterFont ConversionType (Non-mapped) Raster font handling options. Either: TagAttributeFile Description 0 Embed document fonts in PDF file as Adobe Type 3 raster fonts (Default). 2 Let converter automatically create Multiple Master fonts or embed fonts in PDF file. 3 Create multiple master versions of all fonts in document. String Path for the external tags definition file 0 Do not activate password encryption feature (Default). 1 Activate password encryption feature. Encryption UseEncryption PasswordForm UserPassword Chapter 11: Command Line Converters Password encryption options. Either: 0 Enter password “as is”; store unsecured in setup file (Default). 1 Enter index names in Passwords fields to serve as dynamic sources for passwords; index values (real passwords) can be generated using PageMiner. String Password for opening document, if “PasswordForm” option is “0.” 369 Category/ [Area] Command Description OwnerPassword String Password for changing document access, if “PasswordForm” option is “0.” UserIndex String Index for opening document, if “PasswordForm” option is “1.” OwnerIndex String Index for changing document access, if “PasswordForm” option is “1.” 0 Enable document printing (Default). 1 Disable document printing. 0 Enable document editing (Default). 1 Disable document editing. 0 Enable copying document text or graphics (Default). 1 Disable copying document text or graphics. 0 Enable editing document notes or form fields (Default). 1 Disable editing document notes or form fields. Printing Changing Copying Adding 370 Value DesignPro Manager for AFP User Guide Category/ [Area] Command Value Description Active Objects ProcessTagsFor ActiveObjects AOUseBorder AOUseOptionsFrom File Chapter 11: Command Line Converters 0 Do not process text tags and EZ tags and convert them to PDF active objects. 1 Process text tags and EZ tags and convert them to PDF active objects (Default). 0 Do not generate border for active objects (Default). 1 Generate border for active objects. 0 Uses output options for active objects generated from EzTags. This is for compatibility with EAS. 1 Reads settings from the PDF.txt file located in the elixir root folder. 371 Category/ [Area] Command UseReplacement Chars AOBorderColor AOTextColor 372 Value Description 0 Do not Replace actual text with replacement characters in EzTags. 1 Replace actual text with replacement characters in EzTags. Border color selections for active objects. Either: 0 Set to Black (Default). 1 Set to Red. 2 Set to Green. 3 Set to Blue. Text color selections for active objects. 0 Set to Black (Default). 1 Set to Red. 2 Set to Green. 3 Set to Blue. DesignPro Manager for AFP User Guide PostScript Output Property Parameters This table describes PostScript output converter property parameters (default values in bold). Category/ [Area] Command Value Description Printer Properties Output File LanguageLevel LanguageLevel Extension DocumentData FlateCompression Chapter 11: Command Line Converters Postscript output file language level options. Either: 1 Set to Level 1. 2 Set to Level 2 (Default). 3 Set to Level 3. 0 Do not set to Level 1 with Level 2 for imaging & color features. 1 Set to Level 1 with Level 2 for imaging & color features. Document data options. Either: 0 Set to ASCII 27-127 and CR, LF, and TAB (Default). 1 Set to “Clean 7 Bit” plus ASCII 128-256. 2 Set to 256 characters (ASCII 0 – 255). 0 Do not compress output file (Default). 1 Compress output file. Only applicable if “LanguageLevel” is set to “3.” 373 Category/ [Area] Command Value Optimization Optimize Output file optimization options. Either: UseSimplifier Color ColorType Substitute Brushes 374 Description 0 Create as small a file as possible, utilizing printer memory (Default). 1 Use as little printer memory as possible, can create a file substantially bigger in size than Small File Size option. Output file processing preference options. Either: 0 Substitute non-equivalent PS graphical features with nearest PS feature (Default). 1 Store transparent graphic objects as images. Output color conversion options. Either: 0 Convert colors to gray shades. 1 Limited color handling (Not available on UI). 2 Convert colors as defined (Default). 3 Convert colors to CIELab model colors. 0 Do not replace shades with solid colors (not available when Language Level 1 set). 1 Replace shades with solid colors, not patterns (not available when Language Level 1 set) (Default). DesignPro Manager for AFP User Guide Category/ [Area] Command CMYK Value Description 0 Do not use CYMK model for color separation (Default). 1 Use CYMK model for color separation. 0 Do not use font mapping defined by Elixir Resource Map. 1 Use font mapping defined by Elixir Resource Map (Default). 0 Convert TrueType fonts to Type 1. 1 Convert TrueType fonts to Type 3. 0 Postscript converter may change font name in case of font conversion from DPTManager. 1 Preserves font name in case of font conversion from DPTManager. Separations Fonts UserFont Mapping RasteriseTrueType Fonts PreserveFontName Chapter 11: Command Line Converters 375 Category/ [Area] Command Resources EmbedImages EmbedForms Monochrome Bitmap Images Description 0 References all images from external file specified in ‘PathToExternalImages’. 1 Embed all images (Default). 0 Reference all forms from external file specified in ‘PathToExternalForms’. 1 Embed all forms (Default). PathToExternal Images String Specify file path to external images. ExtensionFor ExternalImages String Specify file format extension for path to external images. PathToExternal Forms String Specify file path to external forms. ExtensionFor ExternalForms String Specify file format extension for path to external forms. DownSampleMono Images MonoImagesDPI 376 Value Decrease monochrome grayscale image resolution to set image “MonoImagesDPI” value. Either: 0 Do not down sample image. “MonoImagesDPI” value not applicable (Default). 1 Down sample images with resolution greater than set DPI to set “MonoImagesDPI” value. Number Target image resolution for down sampling (Default = 75). DesignPro Manager for AFP User Guide Category/ [Area] Command Value Grayscale Bitmap Images DownSampleGray Images Decrease grayscale image resolution to set image “GrayImagesDPI” value. Either: GrayImagesDPI Color Bitmap Images Comments DownSample ColorImages Description 0 Do not down sample image. “GrayImagesDPI” value not applicable (Default). 1 Downsample images with resolution greater than set DPI to set “GrayImagesDPI” value. Number Target image resolution for down sampling (Default = 75). Decrease color image resolution to set image “ColorImagesDPI” value. Either: 0 Do not down sample image. “ColorImagesDPI” value not applicable (Default). 1 Down sample images with resolution greater than set DPI to set “ColorImagesDPI” value. ColorImagesDPI Number Target image resolution for down sampling (Default =75). WriteComments withText 0 No comments with text. 1 Write comments with text in Postscript file. Currently only LCDS Parser adds comments to text. Chapter 11: Command Line Converters 377 Category/ [Area] Command Value Description Error Handling StopConversionOn ShowAllErrors 378 0 Stop conversion only if fatal error (Default). 1 Stop conversion for any error. 0 Do not display all errors if conversion fails. 1 Display all errors if conversion fails (Default). DesignPro Manager for AFP User Guide PPFA Output Property Parameters This table describes PPFA output property parameters (default values in bold). Category/ [Area] Command Value Description General Replace bGenerateSmart Code GenerateComments UseDocUnit Chapter 11: Command Line Converters 0 Do not replace existing page and form definitions with new output. 1 Replace existing page and form definitions with new output; must be set to overwrite files on the host (Default). 0 Do not use smart codes to suppress output PPFA defaults. 1 Use smart codes to suppress output PPFA defaults (Default). Comment inclusion options. Either: 0 Do not export any comment to target file. 1 Add comments before source code commands. 2 Embed comments in source code (Default). 3 Append comments to commands termination. 0 Use same measure unit specified for document (Default). 1 Use custom units. 379 Category/ [Area] Command Unit Value Description Export unit of measure options. Either: 0 Set to inches (Default). 1 Set to millimeters. 2 Set to centimeters. 3 Set to points. 4 Set to pels. 5 Set to characters per inches/lines per inch. 0 Do not suppress font references in output (Default). 1 Suppress font references in output. 0 Do not activate Font Map, which enables the converters to use userdefined mappings in the Resource Map (Default). 1 Activate Font Map, which enables the converters to use user-defined mappings in the Resource Map. 0 Do not use coded font name to reference fonts. 1 Use coded font name to reference fonts (Default). 0 Do not round font point size to full value. 1 Round font point size to full value (Default). For example, 11.4 is rounded off to 11.0. Font bSuppressFont UseFontMap bUseCodedFont Name RoundPointSize 380 DesignPro Manager for AFP User Guide Category/ [Area] Command FontResolution FontType Value Description Font resolution options. Either: 240 Set to 240 DPI (Default). 300 Set to 300 DPI. True Type font output conversion option. Either: 0 Set to AFP raster fonts (Default). 1 Set to AFP outline (Type1 PFB). 0 Do not reduce logical page size using L-units. 1 Reduce logical page size using L-units (available for 3800 printers only); useful when creating booklets that require a gutter for binding (Default). 0 Disable support for cut sheet printer (Default). 1 Enable support for cut sheet printer. 0 Disable compatibility to 3800 AFP printers. 1 Enable compatibility to 3800 AFP printers (Default). 0 Do not use NUP support in FormDefs. 1 Enable support for NUP in FormDefs (Default). FormDef General Adjust bCutSheetSupport Invoke Nup Chapter 11: Command Line Converters 381 Category/ [Area] Command Presentation bFDefPelsPerInch Support Printer Specifions Flash bFontFIDSupport bMediaSupport 382 Value Description 0 Do not enable presentation (i.e., orientation, print direction, simplex/duplex printing, etc.) support on 3800 printers. 1 Enable presentation (i.e., orientation, print direction, simplex/duplex printing, etc.) support on 3800 printers (Default). 0 Do not use pels per inch support in FormDefs. 1 Enable support for pels per inch in FormDefs (Default). 0 Do not use flash settings with 3800 printers. 1 Use with 3800 printers to make carbon copies of printed documents using a “flash” of light during the printing process; flash settings are defined in SubGroup (Default). 0 Do not use if FormDef does not use specified fonts (Default). 1 Use if FormDef uses specified fonts, when a raster font of a specified resolution and metrictechnology cannot be found on the printer. 0 Do not use media setting with cut sheet printers (Default). 1 Use with cut sheet printers that have a media setting to differentiate between bins. DesignPro Manager for AFP User Guide Category/ [Area] Command Quality bTonerSaver Support VFID Chapter 11: Command Line Converters Value Description 0 Do not use quality setting for AFP printers. 1 Use for AFP printers having a quality setting, where a set value prints a certain quality (Default). 0 Disable support for toner saver (Default). 1 Use to enable support for toner saver. 0 Do not transmit the setup Ids to all CopyGroups in the FormDef (Default). 1 Use with IBM InfoPrint 4000 Highlight Color postprocessor to transmit the setup IDs to all CopyGroups in the FormDef. 383 Category/ [Area] Post Printing Command bFinishSupport bOutBinSupport Processing Error Handling bBinErrorSupport bFinErrorSupport bColorValueErr Support 384 Value Description 0 Do not set finishing options, such as folding (Default). 1 Set for printer supported finishing options, such as folding. 0 Do not select specific bin at CopyGroup or SubGroup level (Default). 1 Set for selection of specific bin at the CopyGroup or SubGroup level. 0 Do not enable postprocessing options supported by printer, such as perforation cuts or separation cuts. 1 Enable post-processing options supported by printer, such as perforation cuts or separation cuts (Default). 0 Do not set command to stop printing wrong media if loaded in the printer (Default). 1 Set command to stop printing if the wrong media is loaded in the printer. 0 Do not set Finishing Error warnings (Default). 1 Set Finishing Error warnings. 0 Do not use Color Value printer settings (Default). 1 Use Color Value printer settings. DesignPro Manager for AFP User Guide Category/ [Area] Command Value Description PageDef General bColorSupport bObjectSupport bPelsPerInch Support Barcode bRatioSupport bHeightSupport bModWidthSupport Chapter 11: Command Line Converters 0 Do not use Color support feature with output file (Default). 1 Use Color support feature with output file. 0 Do not use Object support feature with output file. 1 Use Object support feature with output file (Default). 0 Do not use pels per inch support in PageDefs. 1 Enable support for pels per inch in PageDefs (Default). 0 Do not specify ratio for barcodes in PageDefs. 1 Specify ratio for barcodes in PageDefs (Default). 0 Do not specify height for barcodes in PageDefs. 1 Specify height for barcodes in PageDefs (Default). 0 Do not specify width for barcodes in PageDefs. 1 Specify width for barcodes in PageDefs (Default). 385 Category/ [Area] Command Value Description Encoding RecordLength Number Fixed record length (Default = 80; Min = 80, Max = 200). GenerateSeqNo 0 Generate sequence numbers for each record (Default). 1 Do not generate sequence numbers. EbcdicEncoding InsertCrLf ConditionEncoding RecordIDEncoding DelimeterEncoding 386 Source encoding options. Either: 0 Use ASCII encoding (Default). 1 Use EBCDIC encoding. 0 Do not insert CRLF (new line) after each record. 1 Insert CRLF after each record (Default). Condition text coding options. Either: 11 Use ASCII coding (Default). 12 Use EBCDIC coding. Record ID text coding options. Either: 11 Use ASCII coding (Default). 12 Use EBCDIC coding. Delimiter text coding options. Either: 11 Use ASCII coding (Default). 12 Use EBCDIC coding. DesignPro Manager for AFP User Guide Category/ [Area] Command WinCodePage Value Description 0/1252 Text with ASCII fonts will be translated w.r.t. specified Windows Code Page. Default code page is Western (1252). 1250 Central European 1251 Cyrillic 1253 Greek 1254 Turkish 1255 Hebrew 1256 Arabic 1257 Baltic 1361 Johab 1200 OEM 42 Symbol ElixirDoc Output Property Parameters Command Value Description Fonts UseFontMapping Chapter 11: Command Line Converters 0 Do not activate font mapping using Elixir Resource Map (Default). 1 Activate font mapping using Elixir Resource Map. 387 388 DesignPro Manager for AFP User Guide Appendix A: Error and Warning Messages In this appendix... Error and Warning Messages Handling Error Messages Warning Messages This appendix provides a list of error and warning messages that can be encountered while performing varying DesignPro Manager for AFP and Converters operations. Explanations for each occurrence are also provided. Error and Warning Messages Handling DesignPro Manager displays processing and compilation errors, warning and informational messages generated by the application in the Messages window. Right-click in the Messages window and select Show Color from the popup menu to display color-coded boxes associated with each message type: - A red box precedes the error messages. - A blue box precedes the warning messages. Informational messages are displayed in black; no box precedes them. The figure below depicts typical errors and warnings that may display during resource conversion. 389 Messages window - typical display during resource conversion. Error Messages Invalid Liscence Key Error Message Explanation Solution License key not found. Cannot activate converters. Cannot find the license key to run the application. Download the updated and correct license key to run the application. Error Message Explanation Solution Font "%1" not found The associated font was not found on path specified in the Resources, Fonts tab of the input property page. Specify the correct path for the associated font in the Resources category, Fonts tab of the input property page. Form "%1" not found The associated form was not found on path specified in the Resources, Forms tab of the input property page. Specify the correct path for the form referred in the error message, in the Resources category, Forms tab of the input property page. Missing Resources 390 DesignPro Manager for AFP User Guide Error Message Explanation Solution Image "%1" not found The associated image was not found on path specified in the Resources, Images tab of the input property page. Specify the correct path for the Image referred in the error message, in the Resources category, Images tab of the input property page. Missing GDF/ELX Parser: Font “C0AR10” not found. The font file has not been downloaded completely, or it maybe corrupt. Download all required font components properly and place them in the corresponding fonts folder. Missing GDF/ELX Parser: Font “C0AR10” not found. Font file is not downloaded completely or it maybe corrupt. Download all required font components properly and place them in the corresponding fonts folder. Cannot retrieve resource “C0AR10”. Font file is not downloaded completely or it maybe corrupt or missing. Download all required font components properly and place them in the corresponding folder. Using default resource instead of “C0AR10”. Cannot find selected resource at the specified path. The specified font has been replaced with the default resource. Resources not present in the specified folder. Specify the corresponding folder for the reffered resources. Cannot retrieve Image name. Image resource is absent or corrupted. Specify the correct location for image resources, or replace the corrupted image file. Cannot retrieve form name. Form resource is absent or corrupted. Specify the correct location for form, or replace the corrupted form file. AFPDS Parser: Specified Formdef 'C:\ELIXIR\F1ELX' not found. The formdef does not exist at the specified path. Specify the correct path for resources in the AFPDS parser, Formdef category, Active Formdef field. The formdef category is visble when the AFPDS converter in invoked from the Elixir Viewer. Appendix A: Error and Warning Messages 391 Invalid Resource Path Error Message Explanation Solution Cannot find resource file “C:\Documents and Settings\username\Desktop\i mage.bmp”. The resource (e.g., form) has been downloaded from another user’s machine, which contains a linked image. Cannot find the linked image path referred in the form. Redefine the path for the linked image. Object Extends Page Boundary Error Message Explanation Solution Object of type Image or another rasterized object extends beyond top or left page boundary. Object will be ignored. Cannot convert object outside the page boundary. Resize or move the object to place it within page boundaries. Object of type Line extends beyond bottom or right page boundary. Object will be processed. Cannot convert part of object outside the page boundary. Resize or move the object to place it within page boundaries. Error Message Explanation Solution Line(42) : Value 1181 out of range. Valid range is between 1 to 254. The given command/ subcommand specifies a value that does not lie in the range defined in the PPFA standard for that command. Specify a value between 1 to 254. Error Message Explanation Solution Error: Line(42) : Invalid PPFA Command 'DOT011' encountered. The PPFA command/ subcommand specifies an invalid user supplied value. Specify a correct value for PPFA command/subcommand. Value Out of Range Invalid Command 392 DesignPro Manager for AFP User Guide Record Format Page Definitions Error Message Explanation Solution Line(22) : A record-format page definition requires at least one font definition The record format PPFA source file does not contain any font definition. Define a font in the source file. Error Message Explanation Solution Error: Unable to perform transform operation due to low memory resource. Transformation fails due to low memory. Low memory issue. The user can either expand the available memory or kill some running processes to free some space. Error Message Explanation Solution Insufficient rights. Cannot open map table C:\Documents and Settings\All Users\Application Data\Elixir Technologies\MAPS\ElxMa p.mdb. The user does not have sufficient rights to open the mapping database. Give appropriate rights to the user for opening the mapping database. Error Message Explanation Solution Enumeration of mapping entries failed. The mapping database file does not exist, or it has not been succesfully opened. Place the mapping database file on the specified path and also give rights to the user to open the mapping database file. Low Memory Cannot Open Map Table Enumeration Failed Appendix A: Error and Warning Messages 393 Unmapped Records Error Message Explanation Solution AFPDS output converter: Records are Unmapped, Can not output PageFormat 1. A Page format with unmapped records was encountered while attempting to save the pagedef. Map the unmapped records. Error Message Explanation Solution Wizard could not connect to the remote Drive x. The PrintDriver could not connect to the mapped Drive x for converting output file(s). Make sure the remote drive is accessible to perform the conversion. Error Message Explanation Solution Text object “__” was badly constructed. Please repair input parser. This error appears when input parser has not set the commands of text object string properly. Recreate the text object. Cannot get font for text “___”. Textlib can not retrieve font for the text object. Recreate the text object. Error Message Explanation Solution Empty document. No PostScript file produced. The document contains only blank pages. Specify a valid input. Mapped Drive Text Strings Note: “___” displays a text string in the form. Zero Pages 394 DesignPro Manager for AFP User Guide File Size Limit Error Message Explanation Solution Output file has grown over x GB. Architectural limits reached. No file produced. A file of maximum xGB size can be generated. It’s an architectural limit. Reduce the file size. Note: In the above message, ‘x’ specifies the file size. The limit for PS files is 2 GB, and that for PDF files is 10 GB. Warning Messages Linked Resource Conversion Warning Message Explanation Conversion of linked resource ‘image’ was unsuccessful through original linkage settings. The resource (e.g., form) was downloaded from another user’s pc with a linked image; cannot find the linked image path referenced in the form; redefine the path for the linked image. Resource File Name Truncated Warning Message Explanation Overlay name ‘ElxForm130’ exceeds the maximum length allowed by the OGL OVERLAY command. The internal name has been truncated to ‘ElxFor’. The file name for the output file created remains unchanged, however internal overlay name is reduced to 6 characters in the OVERLAY command. AFPDS output converter: File name ‘01ElxForm1’ exceeds 8 characters. May be illegal in some AFP environment. The file name exceeds 8 characters, which may be illegal in some specific AFP environment. OGL Converter: Name of resource ‘ElxImage1’ exceeds OGL 6 character maximum. Changed to ‘ElxIma’ The resource name is reduced to 6 characters conforming to the AFP naming conventions. Appendix A: Error and Warning Messages 395 Mixing Mode not Supported Warning Message Explanation AFPDS output converter: Mixing mode is not supported now. It works only if All Rasterize to Image (AFPDS properties) is checked. The Mixing mode feature cannot be used for converting resources unless all Rasterize to Image option is checked. Undefined Font Warning Message Explanation Font facename undefined. Using “Arial”. The specified font name has not been recognized; replaced with the default font, Arial. Resource Naming Warning Message Explanation ELX output converter: The resource file already exists 'c:\Elixir\FONTS\ELIXIR\C0D0GT.hdr' (not replaced) The resource with the same name already exists. Specify a different name to save the resource. OGL output converter: Overlay name ‘COLOR’ is an OGL keyword. It is recommended to save the OGL with a different name. The specified overlay name is an OGL keyword and may result into errors while processing/printing the OGL. It is recommended to save the overlay with a different name. Mapped Drive 396 Warning Message Explanation Warning: Wizard could not disconnect from the remote drive x. PrintDriver could not succesfully disconnect from the mapped drive x after converting the output file. DesignPro Manager for AFP User Guide Invalid Input Warning Message Explanation Warning: C:\Testing.pdf file is invalid for given 'Input Type' and 'Input Format'.When a pdf file is droped on Converters tool in DPT Manager. PDF parsing is not supported in DesignPro Tools, therefore, when a pdf file is droped onto the Converter, this message is recieved. Missing File Association Warning Message Explanation Association is missing. PrintDriver could not find a system association for the file extension to an application. Specify the appropriate associations for output files. Undefined Font Warning Message Explanation System or True Type font with facename "My Arial" not found on the local computer. Using "Arial" instead. System or True Type Font is not installed on local computer using system default font instead. Unicode not Found in Codepage Warning Message Explanation AFPDS output converter: The unicode character U+0020 used in text (or in charset 'C0AR11NP'), but not found in the code page 'T1V10500' A character used in text, or present in the character set was not found in the code page. Missing Default Codepage Warning Message Explanation AFPDS output converter: Using default codepage for remapped font, the text coding may be incorrect. The mapped codepage was not found, therefore, the default codepage will be used instead. Appendix A: Error and Warning Messages 397 Missing Character Code Warning Message Explanation Character 53 missing in font Arial. The character ‘54’ of Character code is not available in font ‘Ariel’. Skipping the missing character code. Mapping Database does not Exist Warning Message Explanation Mapping database "C:\Documents and Settings\All Users\Application Data\Elixir Technologies\MAPS\ElxMap.mdb" doesn't exist. Mapping database file does not exist on the specified path. Same Passwords Warning Message Explanation The Open Document and Change Security Passwords should be different to apply security checks. Adobe Acrobat requires the user and owner passwords to be different in order to apply proper security restrictions. Duplicate Group Name Warning Message Explanation Duplicate Radio Group(s) renamed Each radio button group should have a unique name. The group is renamed if a group with similar name already exists. Field Length Out of Range 398 Warning Message Explanation DocInJd: Field ('Field #14.69.1') with out of range length (65535) encountered, changing length to 65534 The field length has been changed to 65534 for conforming the PPFA manual. (The valid range for field values is from 1 to 65534). DesignPro Manager for AFP User Guide Adjust Value Out of Range Warning Message Explanation Value of ADJUST is exceeding the limits. Setting value to 0. The ADJUST command exceeds its maximum value limits, and has been set to its default value, 0. (The valid range for field values for ADJUST command is from 0 to 20). Duplicate Copy Group Name Warning Message Explanation COPYGROUP name must be unique. Multiple copygroups with identical names exist in the PPFA source file. Color Format not Supported Warning Message Explanation AFPDS property: Color format (RGB,CMYK,CIELAB) not supported for this Image type (IMImage) used OCA colors instead Cannot use RGB,CMYK,CIELAB color formats while creating an IM image. IM image supports OCA colors only. Font Resources Warning Message Explanation AFPDS output converter: Afp overlay cannot include resources to inline resource group. Font resources will be exported to external files. The AFPDS converter cannot include font resources as inline resources in the overlay. They can only be referred and exported externally. Appendix A: Error and Warning Messages 399 400 DesignPro Manager for AFP User Guide Appendix B: Converting Resources Using Converters In this appendix... Converter Overview Using the Converter Creating a Coded Font Creating a Page Segment Creating an AFP Format Overlay This appendix provides information on how to convert resource files using Converters in the DesignPro Manager. Converter Overview Converting resources (overlays, fonts, and page segments) to different formats is often required while working in the AFP environment. A Converter is an application that can convert resource files into multiple file formats and can also save conversion parameters to facilitate resource conversion. When printing, you need allof your resources in the same format used by the target printer. For instance, the AFP format is specific to the AFP printer. Any other format needs to be saved in the AFP format before printing. You can save forms, fonts, and images in their respective DesignPro Editors to a target format. In this appendix, the Elixir Legacy resources are being converted to AFP resources. However, the converter supports other formats for conversion as well. For detailed information on other supported formats, refer to Chapter 5: "Using Converters". 401 Using the Converter To use Converters, open DesignPro Manager and click the Applications tab. You need to drag and drop the selected files in the Converters icon conversions. for Creating a Coded Font To convert an Elixir Legacy Font into an AFP character set: 1 From the Resources window, browse to locate Fonts\Elixir\Elixir1. 2 Select Elixir Legacy Font (*.hdr) from the filter drop-down list if it is not already selected. Elixir fonts display in the Details window. 3 Drag and drop the selected file onto view. in the DesignPro Manager - Applications Drag and drop the selected font onto the Converters icon. The Conversions dialog displays. 402 DesignPro Manager for AFP User Guide The Conversion dialog displays the input and output format properties. 4 Select AFP Character Set from the options available in the Output Formats. An Elixir Legacy Font can also be converted to other formats shown in the Output Formats window simultaneously. For more information on multiple conversions, see Chapter 5: "Using Converters". 5 Click to view the properties for the input format. You can change the properties of the input format. For more information on changing input formats, refer to "Setting ElixirGDF Parser Parameters" on page 95 in Chapter 6: "File Format Dictionary". In case of converting a single resource to multiple formats, the same input conversion settings defined for the resource are applied to all of the target files created. 6 Click to view the path for the input file. Appendix B: Converting Resources Using Converters 403 Setting Output Conversion Parameters for Coded Font This section describes how to set the properties for the output format. 1 Click 2 Select the required Category option. 3 Review the dialog selections and make your changes. For information on each category, refer to the "Setting AFPDS Converter Parameters" on page 112in Chapter 6: "File Format Dictionary". 4 The default path for saving an AFP font is drive:\Elixir\Fonts\AFP\. You can click to open the AFPDS dialog for setting output format properties. to save the file at a different location. 5 Click Apply to save the settings, then click OK to return to the Applications window. The Elixir Legacy Code Page (*.cod) and Elixir Legacy Code Page (*.cod) can also be converted to AFP Character Set by following the same process. Creating a Page Segment This section describes how to convert an Elixir Legacy Graphic (*.lp3) to AFP format (page segments). 1 2 404 From the Resources window, select Graphics\Elixir\Elixir1. Select Elixir Legacy Graphic (*.lp3) fom the filter drop-down menu if it is not already selected. The Elixir Legacy Graphics are displayed in the Details window. Drag and drop the selected file onto the The Conversions dialog is displayed. icon. 3 Click 4 Click 5 Select AFP Page Segment from the options available in the Output Formats. to view the properties for the input format. to view the path for the input file. DesignPro Manager for AFP User Guide The Conversions dialog displays. Setting Output Conversion Parameters for AFP Page Segments 1 Click 2 Select the required Category option. 3 Review the dialog selections and make your changes. For information on each category, refer to the "Setting AFPDS Converter Parameters" on page 112 in Chapter 6: "File Format Dictionary". 4 The default path for saving an AFP page segment is drive:\Elixir\Graphics\AFP\. to open the AFPDS dialog for setting output format properties. You can click to save the file at a different location. 5 Click Apply to save the settings, then click OK to return to the Application window. 6 The Messages window displays the conversion process and the destination directory of the AFP page segment created. Appendix B: Converting Resources Using Converters 405 Creating an AFP Format Overlay This section describes how to convert an Elixir form to an AFP format overlay. To convert an Elixir Form (*.efr) to AFP Overlay Object (*.ove;*.ovl;01*): 406 1 From the Resources window, browse to locate Forms\Elixir\Elixir1. Select Elixir Form (*.efr) from the filter drop-down list if it is not already selected. Elixir forms display in the Details window. 2 Drag and drop the selected file view. The Conversions dialog displays. 3 Click 4 Click 5 Select AFP Overlay Object from the options available in the Output Formats. in the DesignPro Manager - Applications to view the properties for the input format. to view the path for the input file. DesignPro Manager for AFP User Guide Setting Output Conversion Parameters for AFP Format Overlay 1 Click 2 Select the required Category option. 3 Review the dialog selections and make your changes. For information on each category, refer to the "Setting AFPDS Converter Parameters" on page 112 in Chapter 6: "File Format Dictionary". 4 The default path for saving an AFP page segment is drive:\Elixir\Forms\AFP\Ove\. Click to open the AFPDS dialog for setting output format properties. to change output file path and save the file to a different location. 5 Click Apply to save the settings, then click OK to return to the Applications window. 6 The Messages window displays the conversion process and the destination directory of the AFP format overlay created. The Elixir Legacy Forms (*.elx) can also be converted to AFP Overlay Objects by following the same process. Appendix B: Converting Resources Using Converters 407 408 DesignPro Manager for AFP User Guide Appendix C: Glossary Following is an alphabetical listing of product-specific or unique terms and abbreviations used in this guide. AFPDS tree Windows component displaying AFP (MO:DCA) internal file structure and associated information. Application tab A tab page that can be used to launch the installed DesignPro Tools applications. Cloned profile Profile that is an exact replica of its parent profile. See Profile. Default profile Profile that uses all system defined profile items to create a new profile. See Profile. Details view A view displaying the contents of a node selected in the Profile Tree. See Profile Tree. Derived profile Profile that inherits the missing profile item values from its parent profile. See Profile. DesignPro Command Line Converter A command-line executable version of the DesignPro Tools Converters. DesignPro Converters A service that can be used to convert resource files to and from multiple formats. Converting resources is necessary when you want to use documents, images, fonts or overlays in a design that does not support the format of the file in use. DesignPro Font Editor A complete font design application for creating and editing AFP raster fonts, as well as elixir and PCL fonts. Also supports the true type fonts. DesignPro Form Editor An advanced form of design tool for creating and editing forms for AFP and PCL printers. 409 DesignPro Graphics Editor A full service bitmap editor providing commands for tiling graphics into raster fonts. DesignPro Manager An application for launching and using Elixir applications, tools and utilities such as Visual PPFA, Form Editor, Graphics Editor, Font Editor, Profile Editor and Resource Map. DesignPro Scout A service that allows you to automate various jobs and activities. It is designed to automate conversions by watching directories for a file or event. DesignPro Viewer A service where you can view/print proof the documents before sending them for production. Also see Elixir Viewer. DesignPro Visual PPFA An application that provides an easy-to-use visual interface for creating and editing PageDefs and FormDefs to make the print job easy. Details pane A pane that displays selected virtual or system folder filtered contents. Documents folder A directory containing the fully composed multi-page documents for Advanced Function Presentation (*.afp), Elixir (*.gdf), Enhanced Metafile (*.emf), Print Control Language (*.pcl;*.prn), Portable Document Format (*.pdf), and PostScript formats. Elixir Resource Map An application containing font and character resources mapped to supported print and display formats. Elixir Viewer A product component providing on-screen viewing and test-printing of documents. Explorer window A window displaying Windows Explorer view of system folders. Flat View A view displaying default environment variables and categorization of profile keys. Fonts folder A directory containing AFP Coded Fonts (X0*; X1*; X2*; X3*, X4*), AFP Character Set (C0*; C1*; C2*; C3*; C4*), AFP CodePage (T1*) Elixir Legacy Coded Font (X0* .cdf; X1*.cdf; X2*.cdf; X3*.cdf; X4*.cdf), and Windows font files. 410 DesignPro Manager for AFP User Guide Formats View A view displaying the profile keys sorted by file format type. Forms folder A directory containing AFP Overlay Object (*.ove; .ovl; 01), AFP Overlay Source (*.ogl), Elixir, Elixir Metafile, Print Control Language, Portable Document Format, and PostScript form files. Graphics folder A directory containing AFP Page Segment (S1*) and Elixir Legacy Graphic files (*.lp3). Hot key See Keyboard shortcut. Jobs folder A directory containing AFP FormDef Objects (F1*.*, F1*.obj), AFP PageDef Objects (P1*.*;P1.obj), Elixir FormDef (*.efd) and Elixir PageDef (*.epd) job folders, and AFP PPFA Source (*.src, *.pfa) folders. Keyboard shortcut A Special key or key combination for executing operation without using mouse; also called hot key(s). Mapping folder The process of associating a physical folder path to virtual folders. See Virtual folder. Mappings window A window displaying Resource Map contents and assigned associations. See Resource Map Editor. Messages window A window displaying informational, error and warning messages. Navigation pane A pane displaying the page tabs for switching between installed DesignPro Suite applications, utilities and tools and user-defined application shortcuts. Profile A system file that stores important file locations for Elixir applications. Profile Editor An application for creating, modifying, deleting profiles and associated symbols and values. See Profile and Symbol. Profile Tree A tree depicting Default and custom profiles under the current user Windows login name. Appendix C: Glossary 411 Resource Map Editor A product component used to display, define and edit font input to output format mappings, and provide instructions for storing information in the Elixir Resource Map. Resource Type View A view displaying profile keys sorted by resource type. Resources window A window displaying Elixir Resources virtual folders tree. Setup (.epm) file A file that stores individual input and output property settings to facilitate conversion. My Shortcuts tab Applications can be launched directly from icons available on this tab page. My Shortcuts tab displays user-defined shortcuts for different applications. Standard toolbar A toolbar that provides easy access to the most commonly used application commands. Symbol A key representing application objects with associated paths and types. Tools and Utilities tab A tab page that can be used to launch the installed DesignPro tools and utilities. Utilities Service programs designed to perform everyday tasks such as verifying the validity of product license. Virtual folder Abstract representation of a DesignPro Tools physical file folder; displays in a tree in DesignPro Manager, organized by resource type, then format. 412 DesignPro Manager for AFP User Guide Index A additional utilities 217 AFPVIEW.EXE 217 AU.EXE 219 CharmapUpdt 262 DOSVSE 221 DTAFP 223 Elixir Code Page Builder 243 ELX2VSE 241 ElxTag 253 Makepub 237 Pdg plug-in 260 AFP character set 15 code page 15 coded font 15 FormDef object 16 overlay object 14 overlay source 14 page segment 15, 16 PageDef object 16 PPFA source 16 AFP Format Overlays conversion, settings 407 creating 406 AFP page segments conversion, settings 405 AFP resources 61 AFPDS dialog, input format command line parameters 315 Fonts 78 Codepoint to unicode mapping 79 DBCS 79 Font mapping 79 Font prefix 79 FormDef,settings 80 General 75 Options 76 Overlay name 76 Segment name 76 Index Paper Paper Properties 77 Rotate Page/Form 78 Resources resource groups 88 Synthesizer 81 Box To Line 83 Boxes To Box 83 Images To Image 87 Lines To Box 85 Lines To Line 84 Lines To Path 85 Shade To Box 83 Text Join 86 AFPDS dialog, output format Code Pages,preferred 120 Colors 114 Color Format 115 Use Additive Colors 115 ExternalResources 114 Fonts 116 Include Font Resources 117 Map Coded Font 116 Raster Fonts Output 117 True Type Fonts Output 117 Forms,include 119 Images 118 Image Format 118 Include Images 118 Main 112 Offset 113 Record Format 113 Resolution 113 Rotation 114 Text Justification 113 Page Objects 126 Barcodes 126 Graphics 126 Overlapping 127 Pagedef 124 Encoding 125 413 AFPDS tree 215 navigating 216 opening files 215 AFPVIEW utility 217, 219 applications creating shortcuts 42 launching 13 managing 13 Applications tab 26 AS/400 file transfer 209 automating command line converter method 1 309 method 2 310 method 3 311 B BMP 15, 16, 59 browsing workspace 33 C categories main 182 CDF 15 changing default options 49 resource extensions 55 CharmapUpdt utility 262 cloning profiles 279 COD 15 coded fonts conversion,settings 404 creating 402 command line converters 299 creating files 310 DPTCLCu.exe 300 examples 305 input properties 313, 315 output properties 331 specifying, parameters 305 unstructured files 306 conventions 19 symbolic 21 typographic 20 conversions 414 AFP Format overlays, settings 407 AFP page segments, settings 405 coded font, settings 404 Converters overview 401 dialog options input format 403, 405, 406 output formats 403, 405, 406 resource type 403, 405, 406 files 57 fonts 200 process 61 resources 13 setting parameters 50 using Converters 402 Converters AFPDS 112 command line 299 Elixir Form 182 ElixirGDF 177 Image 172 OGL 127 PCL 140 PDF 166 PostScript 135 PPFA 184 setting parameters 111 supported files 58 input 58 output 60 using 57 viewing properties 54 creating AFP Format Overlays 406 application shortcuts 42 coded fonts 402 command line file 310 Elixir web site shortcut 46 page segment 404 physical folder,new 40 shortcuts 42 temporary holding library 207 custom profiles 277 customer support 22 customizing DesignPro Manager 49 Elixir Profile Editor 284 DesignPro Manager for AFP User Guide Elixir Viewer 297 grid 297 ruler 298 D DBF 16 default environment variables 267 options, changing 49 profiles 278 defining physical folders 35 virtual folder 35 definitions Elixir properties 193 deleting physical folders 41 profiles 279 shortcut 47 derived profiles 279 DesignPro Manager Converters window 58 customizing 49 environment 25 workspace 13 Applications tab 26 Details window 26 Explorer window 26 My Shortcuts tab 26 Resources window 26 Tools and Utilities tab 26 windows 26 workspace tools 29 DesignPro modules 17 DesignPro Tools 14 file formats 73 images 15 supported file formats See extensions 14 supported file formats See input formats 14 supported file formats See output formats 14 details resource and formats 270 Details pane 28 dialogs AFPDS, input format Fonts 78 Index FormDef 80 General 75 Synthesizer 81 AFPDS, output format Code Pages 120 Colors 114 Fonts 116 Forms 119 Images 118 Main 112 Page Objects 126 Pagedef 124 Confirm Shortcut Delete 47 Conversions 403, 405, 406 Elixir Properties Caching 196 Resource Library 195 Resources 193 Elixir Shortcut Wizard 43 ElixirForm, output format Fonts 180, 182 Images 179 Main 177 ElixirGDF, input format Main 95 Tags 97 ElixirPDW, input format Page 99 General 43, 46 Image, output format Drawing Options 174 Image 175 Output Formats 172 OGL, input format Font 91 General 89 OGL, output format Color 133 Environment 134 Font 131 Form 130 General 127 Options 55 PCL, output format Printer Fonts 145 Printer Images 143 415 Printer Page 147 Printer Paper 146 Simplifier 148 PDF, output format Active Objects 170 Encryption 169 Main 166 PostScript, output format Error Handling 139 Printer Properties 136 PPFA, input format Encoding 108 Error Handling 110 Font 107 General 104 Prefix 106 PPFA, output format Encoding 190 Font 186 FormDef 187 General 184 PageDef 189 Settings 44 WindowsEMF, input format Page 102 display key 213 display toolbars 30 documents virtual folder 37 DOSVSE utility 221 downloading files 198, 204 from AS/400 209 IBM 3270 198, 204 IRMA FT/3270 198, 204 object files 199 DPTCLCu.exe command line,parameters 300 using 300 DTAFP utility 223 accessing 226 ASCII to EBCDIC table name 233 converting files 227 default tag settings 230 editing creating a DAT file 234 DAT file 235 416 file options 234 form list 234 selecting tag files 236 tag form list 236 external tag attribute file 230 fonts directory 229 form list directory 228 forms directory 229 justifying text 229 last page bottom 233 output format 232 printing tags 237 setting AFP form format 232 font type 232 printer resolution 231 work file directory 231 working 228 E EFD 16 EFR 14, 16 Elixir fonts 15 legacy code page 15 legacy coded 15 FormDef See also EFD 16 forms legacy 14 images 15, 16 overlays 14 PageDef See also EPD 16 PrintDriver 14 Elixir Code Page Builder utility 243 AFP mode 250 Code page creating 248 exporting to Resource map 251 loading 244 properties 249 saving 248 template Code page 250 Code point mapping 247 property setting 246 customizing 252 DesignPro Manager for AFP User Guide launching 243 normal mode 244 profile selection 253 setting modes 243 Elixir Profile Editor 263 customizing 284 overview 263 profiles cloning 279 custom 277 default 278 deleting 279 derived 279 properties 280 windows details view 265 menubar 265 Messages window 265 profile tree 265 working 277 workspace 265 flat view 267 Messages window 277 Profile window 265 Elixir properties Caching 196 definitions 193 Resource Library 195 Resources 193 settings 192 Elixir Shortcut Wizard dialogs 43 Elixir Viewer 287, 288 about 287 customizing 297 grid 297 ruler 298 loading input file 295 previewing forms 296 printing 295 forms 296 setup file loading 294 modifying 294 toolbars 291 Go 292 Index Standard 291 Zoom 292 unrecognized files, handling 295 using 293 viewing 295 workspace 288, 289 grid 290 menu bar 289 ruler 290 tool bars 289 ElixirDoc command line parameters 387 ElixirForm Fonts 180 Embedded outline fonts 181 Raster Fonts Output 180 Images 179 Main 177 Preference 178 main 182 ElixirGDF Main 95 DBCS, codepoint to Unicode mapping 96 Resource Management 96 Text Formatting 96 Tags 97 Active Controls 98 Tag file localization 97 ElixirPDW command line parameters 330 Page 99 Custom Size 100 Page Size 100 ELX 14 ELX2VSE utility 241 using 242 ElxTag utility 253 adding tags 258 copying tags 259 deleting tags 259 editing tags 258 exiting tags 259 saving 257 starting 253 working 255 EMF 14 417 EP 14 EPD 16 error messages 389, 390 handling 389 examples command line 305 Explorer view 13 Explorer window 27 extensions BMP 15, 16, 59 CDF 15 COD 15 EFD 16 EFR 14, 16 ELX 14 EMF 14 EP 14 EPD 16 FLJ 15 HDR 15 JPE 15, 16, 59 JPEG 15, 16, 59 JPG 15, 16, 59 LP3 15, 16, 59 OGL 14 OVE 14 OVL 14 PCL 14, 15 PCX 15, 16, 59 PDF 14 PFA 16 PS 14 SRC 16 TIF 15, 16, 59 extracting object files 209 F File Format Dictionary 73 converter parameters 111 file formats 73 parser parameters 75 file transfer 197 AS/400 206 converting fonts 200 input directories 201 418 OVE/AFPDS files 200 PC to MVS Host 197 uploading 202, 205 uploading AFP files 202, 205 uploading text files 203 files conversion process 61 converting 57 downloading 198, 204 supported Converters 58 flat view 267 default environment variables 267 format details 270 formats view 269 resource details 270 resource type view 276 FLJ 15 folders physical folders 35 virtual folders 35 working 35 fonts 14 AFP character set 15 code page 15 coded 15 Elixir CDF 15 COD 15 HDR 15 legacy code page 15 legacy coded 15 input formats 15 output formats 15 PCL 15 virtual folder 37 formats format details 270 view 269 forms virtual folder 38 G GDF/Elixir command line parameters 321, 343 General dialog DesignPro Manager for AFP User Guide Link Name 43, 46 Target 43, 46 general parameters settings 50 graphics virtual folder 39 Grid 290 ELixirPDW 330 GDF/Elixir 321 OGL 324 PCL 326 PPFA 327 installing resources 208 H J handling error messages 389 unrecognized files 295 warning messages 389 HDR 15 help context-sensitive 23 customer support 22 opening Online Help 23 jobs I L identifying resources 61 Image dialog, output format command line parameters 349 images 14 AFP page segment 15, 16 BMP 15, 16, 59 Elixir 15, 16 LP3 16 overlays 16 input formats 15 JPEG 15, 16, 59 output formats 16 PCX 15, 16, 59 TIFF 15, 16 input formats AFPDS 301 ElixirDoc 301 ElixirGDF 301 ElixirPDW 301 OGL 301 PCL 301 supported 58 input properties AFPDS 315 command line converter 313, 315 legacy fonts 15 images 15 linking files 13 loading input file 295 setup file 294 locating physical folder 36 virtual folder 36 logging messages 53 Index virtual folder 39 JPE 15, 16, 59 JPEG 15, 16, 59 JPG 15, 16, 59 K keyboard shortcuts 31 M Makepub utility 237 extracting files 240 listing files 240 mapping physical folder 40 virtual folder 40 menu bar 29, 289 messages error messages 389 logging 53 warning messages 389 Messages window 28, 277 419 setting preferences 52 show date 30 working 28 method 1 command line converter automating 309 Scout,setup 309 method 2 310 command line converter automating 310 command line file,creating 310 Scout,setup 310 method 3 311 command line converter automating 311 Scout,setup 312 modifying setup file 294 moving files physical folder 41 virtual folders 41 My Shortcuts tab 27 N navigating workspace 30 Navigation window 26 O O1 14 object files extracting 209 OGL 14 OGL dialog, input format command line parameters 324 Font 91 Use font map 92 General 89 Record Format 90 Source Encoding 90 Prefix Font 91 Segment 91 OGL dialog, output format Color,model 133 command line parameters 356 420 Environment 134 Font 131 Options 132 True Type Fonts Output 132 Form 130 Overlay 130 General 127 Record Length 129 Unit of Measure 128 Options dialog 55 output formats AFPDS 302 ElixirDoc 302 ElixirGDF 302 Image 302 OGL 302 PCL 302 PDF 302 PostScript 302 PPFA 301, 302 supported 60 output properties AFPDS 331 command line converter 331 ElixirDoc 387 GDF/Elixir 343 Image 349 OGL 356 PCL 361 PDF 367 PostScript 373 PPFA 379 OVE 14 overlays 14 Elixir 14 legacy 14 PrintDriver 14 input formats 14 OGL 14 output formats 14 OVE 14 OVL 14 PCL 14 PDF 14 PostScript 14 Windows EMF 14 DesignPro Manager for AFP User Guide overview Converters 401 DesignPro Manager 13 Elixir Profile Editor 263 file transfer 197 OVL 14 P page segment creating 404 parameters command line, specifying 305 input properties AFPDS 315 ElixirPDW 330 GDF/Elixir 321 OGL 324 PCL 326 PPFA 327 output properties AFPDS 331 ElixirDoc 387 GDF/Elixir 343 Image 349 OGL 356 PCL 361 PDF 367 PostScript 373 PPFA 379 unstructured file,specifying 306 parser parameters settings 75 AFPDS 75 ElixirGDF 95 ElixirPDW 99 OGL 89 PCL 93 PPFA 104 WindowsEMF 102 parser properties viewing 54 password file display 213 PC serial number 214 PC to MVS Host file transfer 197 PCL 14, 15 Index PCL dialog command line parameters 326, 361 PCL dialog, output format Fonts 145 Charachters 146 downloading mode 145 Images 143 Available Compression Method 144 Graphic language 143 Main Output mode 141 PCL level 141 Page Error Handling 147 Simplifier 148 Paper 146 Simplifier 148 Box and Ellipse 150 Brush 152 Clipping 153 Color 154 Image 155 Line 157 Media 159 Opacity 160 Path 162 Text 163 Transformation 165 PC-to-IBM AS/400 file transfer 206 PCX 15, 16, 59 PDF 14 PDF dialog, output format Active Objects 170 command line parameters 367 Drawing Options 174 Encryption 169 Name of Index 169 Password 169 Image 175 Main 166 Fonts 168 Images 168 Optimization 167 Output Formats 172 PDF plug-in utility 260 421 using 260 PFA 16 physical folder creating,new 40 defining 35 deleting 41 files,moving 41 locating 36 mapping 40 PostScript dialog, output format command line parameters 373 Error Handling 139 Printer Properties 136 Color 137 Color Bitmap Images 139 Data Type 137 Monochrome Bitmap Images 138 Optimization 137 Output File 137 Resource Handling 138 PostScript See PS 14 PPFA dialog, input format command line parameters 327 Encoding 108 Record Format 108 source 108 Text Encoding 109 Error Handling 110 Font,search options 107 General 104 Comment Support 105 Resource Embedding 105 Prefix,options 106 PPFA dialog, output format command line parameters 379 PPFA, output format Encoding 190 Record length 191 Source encoding 191 Font 186 FormDef 187 Support 188 General 184 Comments 185 PageDef 189 Barcodes 190 422 preferences message settings 52 prefix O1 14 S1 16 X0 15 X1 15 preparing resources 61 previewing forms 296 printing AFPDS documents 209 Elixir Viewer 295 forms 296 product registration 213 profile properties 280 profile item adding 280 deleting 283 modifying 282 profile selection 283 customizing 285 new profile,loading 284 Profile window 265 profiles loading new profile 284 selection 283, 285 properties Symbol settings 50 PS 14 R Related guides 19 resource extensions changing 55 resource type view 276 resources fonts 14, 15 identifying 61 images 14, 15 installing 208 overlays 14 preparing 61 staging 61 Resources window 27 DesignPro Manager for AFP User Guide Ruler 290 Running DOS based utilities 211 Windows based utilities 211 S S1 16 Scout command line converter method 2 310 method 3 311 Command Line Converters method 1 309 method 1 setup 309 method 2 setup 310 method 3 setup 312 settings AFP Format Overlays,conversion 407 AFP page segments,conversion 405 coded fonts,conversion 404 conversion parameters 50 converter parameters 111 AFPDS 112 ElixirGDF 177 Image 172 OGL 127 PCL 140 PDF 166 PostScript 135 PPFA 184 Elixir properties 192 general parameters 50 message preferences 52 parser parameters 75 AFPDS 75 ElixirGDF 95 ElixirPDW 99 OGL 89 PCL 93 PPFA 104 WindowsEMF 102 Symbol properties 50 Settings dialog 44 Index setup file loading 294 modifying 294 understanding 63 unloading 294 shortcuts creating 42 deleting 47 Elixir web site, creating 46 keyboard 31 specifying command line,parameters 305 SRC 16 staging resources 61 status bar 29 supplied utilities 212 support 22 supported file formats 14 Symbol properties, setting 50 T tabs Applications 26 My shortcut 27 Tools and Utilities 27 TIFF 15, 16, 59 toolbars 29 Elixir Viewer 291 Go toolbar 292 Standard toolbar 291 Zoom toolbar 292 tools and utilities 212 AFPDS tree 215 display key 213 password file display 213 PC serial number 214 product registration 213 update key 214 Tools and Utilities tab 27 training 23 transferring PC-to-IBM AS/400 files 206 Typographic Conventions 20 423 U understanding setup files 63 unmapping virtual folders 41 unstructured file specifying parameters 306 update key 214 uploading AS/400 files 206 object files 202, 205 text files 203 uploading files 202, 205 using Converters 57, 402 DPTCLCu.exe 300 Elixir Viewer 293 menu bar 30 right click menu 30 Stand-Alone utilities 211 toolbars 30 Viewer unloading setup file 294 virtual folder 36 workspace tools 29 utilities additional 217 Stand-Alone utilities 211 supplied 212 using 211 V Viewer window Applications window 288 grid 289 Messages window 288 ruler 289 workspace tools 289 viewing converter properties 54 Elixir Viewer 295 parser properties 54 virtual folder defining 35 documents 37 fonts 37 424 forms 38 graphics 39 jobs 39 locating 36 mapping 40 using 36 virtual folders 13 files,moving 41 unmapping 41 Visual PPFA AFP FormDef Object 16 PageDef Object 16 PPFA Source 16 PPFA source 16 DBF 16 Elixir FormDef 16 PageDef 16 input formats 16 output formats 16 W warning messages 389 handling 389 Who Should Use this Guide? 19 windows DesignPro Manager Converters 402 My Shortcuts 45 workspace 26 DesignPro Manager, Converters 58 Elixir Profile Editor 265 Explorer 27 Messages 28 Navigation 26 Resources 13, 27 Viewer 288, 289 WindowsEMF 14 WindowsEMF dialog, input format General 103 Page 102 Synthesizer 103 working Elixir Profile Editor 277 folders 35 DesignPro Manager for AFP User Guide Messages window 28 workspace browsing 33 Elixir Profile Editor 265 Elixir Viewer 288 using 289 navigating 30 workspace tools using 29 X X0 15 X1 15 Index 425 426 DesignPro Manager for AFP User Guide
advertisement
* Your assessment is very important for improving the workof artificial intelligence, which forms the content of this project