GRAPHCT3.TXT--Use SETUP.EXE to print these docs, NOT WordPerfect! G R A P H C A T (tm) V 3 . 2 ================================================== Clip Art Graphics Catalog Builder Requires WordPerfect 6.1, 6.0, 5.1, or 5.1+ (DOS versions), WP51 Must be Interim Release 6/29/90 or Newer A Shareware Package from: Jerry Stern Science Translations P. O. Box 20234 Baltimore, MD 21284-0234 NOW ON THE WORLD WIDE WEB: http://www.execpc.com/scitrans _______ ____|__ | (R) --| | |------------------- | ____|__ | Association of | | |_| Shareware |__| o | Professionals -----| | |--------------------- |___|___| MEMBER All materials (C) Copyright 1991-95 Jerry L. Stern All Rights Reserved Quick-Start Guide Begins on Page 9 NEW in version 3.2--Horizontal Catalogs--See page 7 GRAPHCAT is a copyrighted program distributed as SHAREWARE. All rights are reserved. You may try out the program for up to 30 days for free. If you continue to use this program, you must pay a registration fee of $20.00. Registered users will receive an enhanced version of the main macro, a megabyte of Wood Clips graphics, newsletters announcing updates, and voice/FAX/email support. G R A P H C A T V. 3.2 / DOS 2 Table of Contents ================= REGISTRATION . . . . . . . . . . . . . . . . . . . . . . . . 3 ASP Ombudsman . . . . . . . . . . . . . . . . . . . . . 3 OTHER FILES . . . . . . . . . . . . . . . . . . . . . . 4 DEFINITION OF SHAREWARE . . . . . . . . . . . . . . . . 4 LIMITED WARRANTY . . . . . . . . . . . . . . . . . . . . 5 TRIAL USE LICENSE . . . . . . . . . . . . . . . . . . . 5 LIMITED DISTRIBUTION LICENSE . . . . . . . . . . . . . . 5 INTRODUCTION & QUICK START . . . . . . . . . . . . . . . . . 7 QUICK START . . . . . . . . . . . . . . . . . . . . . . 7 INTRODUCTION . . . . . . . . . . . . . . . . . . . . . . 7 NEW IN GRAPHCAT 3.2 for WP51 . . . . . . . . . . . . . . 7 NEW IN GRAPHCAT 3.2 for WP6 . . . . . . . . . . . . . . 7 WORDPERFECT 6.1 OR 6.0 OR 5.1 OR 5.1+? . . . . . . . . . 8 WHAT IS GRAPHCAT? . . . . . . . . . . . . . . . . . . . . . . 9 INTERNATIONAL USERS: . . . . . . . . . . . . . . . . . . 11 WOOD CLIPS . . . . . . . . . . . . . . . . . . . . . . . 11 INSTALLATION . . . . . . . . . . . . . . . . . . . . . . . . 12 PROMPTS--THE INPUT SCREEN . . . . . . . . . . . . . . . . . . 12 DRIVE:\PATH . . . . . . . . . . . . . . . . . . . . . . 12 EXTENSION OR FILE MASK . . . . . . . . . . . . . . . . . 13 CATALOG TITLE . . . . . . . . . . . . . . . . . . . . . 13 COLUMNS . . . . . . . . . . . . . . . . . . . . . . . . 14 HEIGHT . . . . . . . . . . . . . . . . . . . . . . . . . 14 WP6 ONLY: GRAPHIC ON DISK . . . . . . . . . . . . . . . 14 WP6 ONLY: PARTIAL CATALOGS . . . . . . . . . . . . . . . 15 LAYOUT OPTIONS . . . . . . . . . . . . . . . . . . . . . 15 CENTERING . . . . . . . . . . . . . . . . . . . . . . . 15 ALTERNATING PAGE HEADERS . . . . . . . . . . . . . . . . 15 HORIZONTAL CATALOGS . . . . . . . . . . . . . . . . . . 16 BORDER STYLE . . . . . . . . . . . . . . . . . . . . . . 16 FORCED MATCHING BOXES . . . . . . . . . . . . . . . . . 16 WORKING ON THE GRAPHIC... . . . . . . . . . . . . . . . 16 IN GENERAL . . . . . . . . . . . . . . . . . . . . . . . 17 EDITING ALL THE IMAGES AT ONCE . . . . . . . . . . . . . 17 TROUBLE-SHOOTER'S GUIDE . . . . . . . . . . . . . . . . . . . 19 INDEX . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23 All Rights Reserved (C) Copyright 1991-95 Jerry Stern G R A P H C A T V. 3.2 / DOS 3 REGISTRATION ============ GRAPHCAT/DOS V. 3.2 is available both as shareware, or "Try before you buy" software, and in registered form. You may copy the entire shareware edition and pass it on unchanged to other WordPerfect users. If you use the program for more than 30 days, you must register. Basic registration is $US 20., and a variety of payment types are listed in the files REGISTER.TXT and PRODUCTS.TXT, including Visa, MasterCard, and American Express. Send registrations to: Or Phone or FAX to: Jerry Stern 1-410-661-2224 Science Translations PO Box 20234 Add $2.00 Shipping Baltimore, Maryland 21284-0234 on all orders below $30. Maryland residents add 5 per cent sales tax. Purchasers receive the registered version of the GRAPHCAT macro with registration reminders removed, a selection of Wood Clips graphics, and newsletter notification of upgrades, with discounted pricing for registered users. The registered version of GRAPHCAT includes additional layout options, including horizontal cataloging, border selection, justification, resettable defaults, and drop shadows. Support is by mail, FAX, or phone, at the same address and phone number used for registration, or via the SciTrans World Wide Web page on the Internet, located at http://www.execpc.com/scitrans, or on the SciTrans support conference on GEnie--in the WordPerfect RT, Third-Party Support category, SciTrans topic. You may contact the author as Jerry.Stern on GEnie, as 72144,1241 on Compuserve, or on the Internet as 72144.1241@compuserve.com. Look in the VENDINFO.DIZ file for support boards and additional contact info. Jerry Stern is a member of the Association of Shareware Professionals (ASP). ASP wants to make sure that the shareware principle works for you. If you are unable to resolve a shareware-related problem with an ASP member by contacting the member directly, ASP may be able to help. The ASP Ombudsman can help you resolve a dispute or problem with an ASP member, but does not provide technical support for members' products. Please write to The ASP Ombudsman, at 545 Grover Road, Muskegon, MI 49442, or send a CompuServe message via CompuServe Mail to: ASP Ombudsman 70007,3536. WordPerfect is a registered trademark of Novell, Inc. in the United States and other countries. All Rights Reserved (C) Copyright 1991-95 Jerry Stern G R A P H C A T V. 3.2 / DOS 4 OTHER FILES ----------- The shareware edition contains product information in the VENDINFO.DIZ file, including a list of al the files in this release of Graphcat for DOS. If any are missing or if the sizes and dates do not match that list, the package has been tampered with. Any additional files are not part of Graphcat. Registered users receive a current and complete copy. For more information, see these files: REGISTER.TXT Order form for registering Graphcat for DOS and other products. PRODUCTS.TXT Product information. Includes other wonderful products from Jerry Stern and Science Translations, including GRAPHCAT, BOOKBILD, the Letterhead Kit, each available for both DOS and Windows, and the Wood Clips collections of clip art. The files with .WPG extensions are clip art. These Wood Clips sample graphics are provided as handy files for learning to use GRAPHCAT. When you register, your bonus disk will contain additional Wood Clips, and additional collections are available by subject. DEFINITION OF SHAREWARE ----------------------- Shareware distribution gives users a chance to try software before buying it. If you try a Shareware program and continue using it, you are legally required to register. With registration, you get anything from the simple right to continue using the software to an updated program with printed manual. Copyright laws apply to both Shareware and commercial software, and the copyright holder retains all rights, with a few specific exceptions as stated below. Shareware authors are accomplished programmers, just like commercial authors, and the programs are of comparable quality. (In both cases, there are good programs and bad ones!) The main difference is in the method of distribution. The author specifically grants the right to copy and distribute the software, either to all and sundry or to a specific group. For example, some authors require written permission before a commercial disk vendor may copy their Shareware. Shareware is a distribution method, not a type of software. You should find software that suits your needs and pocketbook, All Rights Reserved (C) Copyright 1991-95 Jerry Stern G R A P H C A T V. 3.2 / DOS 5 whether it's commercial or Shareware. The Shareware system makes fitting your needs easier, because you can try before you buy. And because the overhead is low, prices are low also. Shareware has the ultimate money-back guarantee--if you don't use the product, you don't pay for it. LIMITED WARRANTY THIS SOFTWARE AND MANUAL ARE PROVIDED FOR EVALUATION ONLY, ON AN "AS IS" BASIS. SCIENCE TRANSLATIONS DISCLAIMS ALL WARRANTIES RELATING TO THIS SOFTWARE, WHETHER EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. NEITHER SCIENCE TRANSLATIONS NOR ANYONE ELSE WHO HAS BEEN INVOLVED IN THE CREATION, PRODUCTION, OR DELIVERY OF THIS SOFTWARE SHALL BE LIABLE FOR ANY INDIRECT, CONSEQUENTIAL, OR INCIDENTAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE SUCH SOFTWARE, EVEN IF SCIENCE TRANSLATIONS HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES OR CLAIMS. THE PERSON USING THE SOFTWARE BEARS ALL RISK AS TO THE QUALITY AND PERFORMANCE OF THE SOFTWARE. This agreement shall be governed by the laws of the State of Maryland and shall inure to the benefit of Science Translations and any successors, administrators, heirs and assigns. Any action or proceeding brought by either party against the other arising out of or related to this agreement shall be brought only in a STATE or FEDERAL COURT of competent jurisdiction located in Baltimore County, Maryland. The parties hereby consent to in personam jurisdiction of said courts. TRIAL USE LICENSE Graphcat is NOT a public domain program. It is copyrighted by Science Translations. This software and accompanying documentation are protected by United States Copyright law and also by International Treaty provisions. Science Translations grants you a limited license to use this software for evaluation purposes for a period not to exceed thirty days. If you continue using this software after the thirty-day evaluation period, you MUST make a registration payment to Science Translations. LIMITED DISTRIBUTION LICENSE INDIVIDUALS may distribute Graphcat to friends or associates, provided they charge no fees for this service, and they convey a complete and unaltered copy of the shareware version of this product. All Rights Reserved (C) Copyright 1991-95 Jerry Stern G R A P H C A T V. 3.2 / DOS 6 All other distribution is allowed only under the terms of the attached VENDINFO data record, which is hereby incorporated by reference. Any distribution satisfying all the distribution requirements expressed in that data record is hereby authorized. You may not distribute this product, modify it, or bundle it with other products except as specifically allowed therein. You may not use, copy, rent, lease, sell, modify, decompile, disassemble, otherwise reverse engineer, or transfer the licensed program except as provided in this agreement. Any such unauthorized use shall result in immediate and automatic termination of this license. Permission to distribute the Graphcat package is not transferable, assignable, saleable, or franchisable. Each vendor wishing to distribute the package must independently satisfy the terms of this limited distribution license. U.S. Government Information: Use, duplication, or disclosure by the U.S. Government of the computer software and documentation in this package shall be subject to the restricted rights applicable to commercial computer software as set forth in subdivision (b)(3)(ii) of the Rights in Technical Data and Computer Software clause at 252.227-7013 (DFARS 52.227-7013). The Contractor/ manufacturer is Science Translations, Box 20234, Baltimore, MD 21284-0234. Science Translations may revoke any permissions granted here, by notifying you in writing. All rights not expressly granted here are reserved to Science Translations. You are encouraged to pass a copy of the unregistered version of GRAPHCAT along to your friends for evaluation. Please encourage them to register their copy if they find that they can use it. All registered users will receive a copy of the latest version of GRAPHCAT, an enhanced version of the GRAPHCAT macro, a megabyte of Wood Clips graphics, discounted upgrades, newsletter announcements of upgrades and new products, and technical support for at least one year. Site Licenses, volume discounts, and additional INTERNATIONAL registration information are in the file PRODUCTS.TXT. All Rights Reserved (C) Copyright 1991-95 Jerry Stern G R A P H C A T V. 3.2 / DOS 7 INTRODUCTION & QUICK START ========================== QUICK START ----------- 1) Run Setup to install in WP51, print the manual, or read the WP61/60 install instructions. Short version of the WP6x instructions: From inside WP6, press Macro (Alt-F10), type the current path to the install.wpm file, and 'install', and press Enter. (Example: Macro (Alt-F10), a:\install, Enter). 2) From inside WP, press Macro (Alt-F10), type 'GRAPHCAT' & press Enter. Follow the on-screen instructions. INTRODUCTION ------------ GRAPHCAT/DOS 3.2 requires EITHER WordPerfect 6.1 or 6.0, any release date, or WordPerfect 5.1, interim release date 6/29/90 or later. GRAPHCAT is a shareware package of WordPerfect macros that read any disk or directory, and create a pictorial listing of all the graphics found. After running the INSTALL.WPM macro for WP6 or SETUP.BAT file for WP51, run the main macro by pressing Macro (Alt-F10), and entering GRAPHCAT. Answer the prompts for the drive and directory, file extension, catalog title, number of columns, and graphic height. The default values for columns and height allow 28 graphics per page. NEW IN GRAPHCAT 3.2 for WP51 ---------------------------- Since version 3.1, horizontal cataloging (left-to-right) has been added. These changes have been made in the 5.1 version of Graphcat since version 3.00: Added 5.1+ support and full compatibility with the DOS Share command, and horizontal (left-to-right) catalogs. NEW IN GRAPHCAT 3.2 for WP6 --------------------------- These enhancements have been made to Graphcat 3.2 since version 3.00: Added CD-ROM support, horizontal (left-to-right) catalogs, directory searching, filename searching, partial catalogs, caption autosizing, and it is no longer necessary to avoid the "WP Documents Only" setting in file manager. All Rights Reserved (C) Copyright 1991-95 Jerry Stern G R A P H C A T V. 3.2 / DOS 8 To use the new directory searching feature, simply click on the `Search' button next to the first prompt on Graphcat's main screen, and use the arrow keys to move to the directory to search. Use 2) Other Drive to change to another drive letter, Home to go to the top of the listing, End to go to the bottom of the listing, F2 or N to search, and Enter or 1 to select a directory. (Mice do not work inside the search screens.) To use the new partial catalogs feature, enter your choices in the second dialog box, or simply press Enter, or click on OK to accept the default choices and begin building the catalog. The defaults will usually be to start with the first image found (the filename will be blank), and use page number 1 for the first page of the catalog. If Graphcat detects that your last catalog was not a complete catalog of the directory, it will suggest that you start with the next available file name, and a page number that will be the next after your previous catalog. You may press Enter or click on OK to accept these choices, or click on Search, and select a new starting file. Graphcat will remember your settings from one run of the macro to the next, within the same WordPerfect session. If Graphcat detects a partial catalog has been created, then you can simply press Enter at both dialog boxes to build another catalog of the same length and settings as the previous one. Hint: For partial catalogs, set the number of images equal to enough images to fill one or several pages. For example, if you use the default settings of 1" and 4 columns, use 28, 56, or 84 images per catalog. Remember that Graphcat can build catalogs that are too big to print on some computers, so break up your catalogs so that you can print them easily. WORDPERFECT 6.1 OR 6.0 OR 5.1 OR 5.1+? -------------------------------------- Throughout this manual, when the keystrokes and procedures are the same for both WordPerfect versions, the steps will be listed only once. However, when the steps are different, you will see this: WP51: Do these steps in WordPerfect 5.1 or 5.1+ WP6 : Or these in WordPerfect 6.1 or 6.0. WordPerfect 6.x has greatly enhanced graphics and macro power, so there are a few features available in the WP 6 version of Graphcat that are not in the 5.1 edition. The WP6 version has these enhancements: 1) The sort order that you have set in the File Manager is the order that your files will be listed in Graphcat. All Rights Reserved (C) Copyright 1991-95 Jerry Stern G R A P H C A T V. 3.2 / DOS 9 You can choose to sort by filename, extension, size, date, and in ascending or descending order. 2) A Graphics-on-Disk option can save workspace--check the radio button in the main Graphcat screen to turn it on. 3) All the graphics may be converted to black and white, or adjusted in many other ways, by editing the Graphics style named "GRAPHCAT" or the Border style named "GCAT- BRD". (See the instructions on page 17.) 4) New graphics formats added to WP60, initial release, include BMP and WMF. 5) Support for WordPerfect Graphics (WPG) includes version 1.0 (WP51), version 1e (Presentations 2.0/DOS), and 2.0 (WP6x shipping graphics). NOTE: WP60 does NO LONGER SUPPORTS DHP, GEM, IMG, MSP, PNTG, & PPIC. Keep a copy of the GRAPHCNV program from WP51 to convert these into WPG format. ADDITIONAL GRAPHICS DRIVERS: The formats DXF, MGX, and TGA require extra conversion drivers--call WP for order info. TIF FILES: TIF formats through revision 5.0 are supported, except those using LZW compression. Some version 6.0 files are supported, but not all--call WP support for details. Version 5.1+ of WordPerfect adds partial support for the new versions of the WPG files used by Presentations and WPWin60. However, when WP5.1+ reads in these images, gradient patterns will change to solid colors, and the color set of the image will change to a 16-color palette. These changes may result in odd color choices or substantial changes in how images print. WHAT IS GRAPHCAT? ================= I've been collecting clip art for different projects. A small book, some newsletters, signs, and still more pictorial projects. I've drawn some, scanned some paper clip art, and bought some disks of pictures. I was beginning to lose track of which disk had what pictures. I needed an index, a printout of every graphic I had, so I could keep them handy for reference. The WPG files shipped with WordPerfect have their own printed picture indexes of art in the manual, but disks of PCX or TIF files from computer show rack vendors are escapees from that elusive paperless office we all keep hearing about. And clip art All Rights Reserved (C) Copyright 1991-95 Jerry Stern G R A P H C A T V. 3.2 / DOS 10 disks are uneven; some of them are full disks of excellent art on related topics, but others are totally unrelated pictures. Worse, because there are several flavors of each of the graphics file formats, some files will not be recognized by WordPerfect, and will read as bad. Overall, clip art disks are worthwhile, but a printed index would help sort the good files from the fuzzy junk. And the commercial clip art isn't much better. Oh, the graphics are better, but the printed indexes are printed too small, or on newsprint, or are all mixed in with the pictures of every other graphic collection sold by that company. Meanwhile, my co-workers on a newsletter project wanted to see all their clip art. I kept their graphics on a separate disk, but they wanted paper copies to refer to, so they could tell me, "Use that butterfly picture from page two." I began to create a sample document, with every graphic shown, and the file names, and the disk titles, and immediately found that there was too much work involved. I had two options: I could delegate the job, or write a macro to do the job. Since I couldn't find anyone who would spend three hours to create the index for each disk, I wrote GRAPHCAT. It's a lot faster than an assistant; it only takes from a few seconds to a few minutes to complete the job, depending on the speed of the computer and the size of the graphics files. GRAPHCAT makes this task easy, so easy that nearly no effort is needed to create a new catalog for each directory or floppy of pictures. If the macro is told the drive and path of the files, the computer should do the rest. With just that information, the WordPerfect macro reads the appropriate directory, identifies the graphics files, sets their sizes, locations, and options in a catalog, and leaves that catalog ready to print. Once the catalog is built, you may preview it, print it, and save it if you want. WP51: WordPerfect corporation has a habit of tinkering with their software. There are many different versions of WordPerfect 5.1 for MS-DOS systems. Some of their interim releases are mostly bug fixes, and a few new drivers for new hardware; the new releases also include minor new features. The 6/29/90 release included a new macro command, {SYSTEM}entry, or in international editions, {SYSTEM}29. It can copy a file name off a List Files (F5) menu. GRAPHCAT uses that macro command, so users of earlier versions of WP MUST upgrade. To check your WP51 release date, press Help (F3) from the document screen of WP. The release date will be in the top right corner of the introductory help screen. In 6.0, select Help, WP Info. To upgrade to the newest release of WP 5.1+ or 6.0, call All Rights Reserved (C) Copyright 1991-95 Jerry Stern G R A P H C A T V. 3.2 / DOS 11 your local WordPerfect sales office. Instructions for installing the upgrade come with the disks, but be sure to check for, and read, a README file on the first disk of each type. That README file will list the features added to the program in that release. Interim Releases of WP: Writing software in a macro language is tricky, like controlling a rowboat by towing it from a distance of five parsecs. However, GRAPHCAT for DOS has been tested on all releases of WordPerfect 5.1, and the macro language in WP 6.0 is feature-oriented rather than the old keystroke-recorder, so all the macro features should work in all future releases. BUT, sometimes new "features" disable old features. If this happens, try turning "off" the new features if the macros don't seem to like the new release. When in doubt, write for support--there will be either a fix or a new release, as needed, to fix any problems caused by new features. INTERNATIONAL USERS: -------------------- All of Graphcat's internal macro commands and menu choices have been set using international equivalents. GRAPHCAT should work properly with ANY WP language module, and the column height measurements will be accepted in your default measurement. However, I have not been able to test every possible international combination of software, interim release, and hardware. Please write if you find that GRAPHCAT fails in any way on your system. Also note: the interim release requirement of the 6/29/90 release applies to US WordPerfect 5.1. Other language versions may require a newer release. If you aren't sure whether your release of WP has the needed added feature, just go ahead and run GRAPHCAT: the macro automatically tests for the needed new feature. WOOD CLIPS ---------- The files with .WPG extensions are clip art. The patterns and styles vary greatly, and they are provided as handy files for testing GRAPHCAT. They are all wood cut engravings, known as Wood Clips. A collection of 1.4Mb of clip art is included with the registered edition of GRAPHCAT. All Rights Reserved (C) Copyright 1991-95 Jerry Stern G R A P H C A T V. 3.2 / DOS 12 INSTALLATION ============ If you are reading these files on screen, you may print them with the SETUP program. (Don't print them from WordPerfect--they are formatted with page breaks for printing from DOS.) WP6: GRAPHCAT is installed by running the macro INSTALL.WPM. (This macro will not run in WP51--see the explanation of SETUP.EXE below for WP51.) The macro will display a box showing three directories: 1) The source drive for the GRAPHCAT files, initially a:. Edit this line as needed if your files are in another area, such as c:\download, for example. 2) The macro directory for WP6. This entry will generally be correct, unless you use more than one macro directory. 3) The new directory to create for the GRAPHCAT sample graphics and instruction files, c:\graphcat initially. Edit this entry if you would like the text and graphics elsewhere. WP51: To install the GRAPHCAT macros to the WordPerfect 5.1 macro directory, run the SETUP.EXE program from the DOS prompt while logged to the GRAPHCAT distribution disk or directory. PROMPTS--THE INPUT SCREEN ========================= Start GRAPHCAT from a blank document screen by pressing Macro (Alt-F10), typing GRAPHCAT, and pressing Enter. A second document screen must be blank as well, but not to worry: GRAPHCAT checks for workspace and will not let you do anything dangerous. A full- screen display will appear. DRIVE:\PATH ----------- At the first prompt, enter the drive name and path for the subdirectory to be searched. You may omit the ending backslash if you like. GRAPHCAT is smart enough to accept the path name either way. WP51: Pressing Cancel (F1) at this prompt will stop the macro. Pressing Cancel at any of the following prompts will move the cursor back up to the prompt immediately above. All Rights Reserved (C) Copyright 1991-95 Jerry Stern G R A P H C A T V. 3.2 / DOS 13 WP6: Pressing Cancel (Esc) at any time, or clicking on Cancel, will end the macro. You may move between the prompts with Tab or the arrow keys. Click on OK when done. Click on the Search button to let WordPerfect help you find your graphics directory. EXTENSION OR FILE MASK ---------------------- The second prompt asks for the file type. Any type of graphics file readable by WordPerfect may be entered here. If your files are kept sorted by what they are, such as DrawPerfect pictures together as WPG files, or scanned artwork as TIF files, they will be easier to keep track of, but if they are mixed together with lots of different types of files, that's o.k., too. WP51: You may enter up to three characters at this prompt--only the file extension may be chosen in GRAPHCAT for WP51. However, you can use standard DOS wild cards. These include the asterisk, meaning "any characters, any length," and the question mark, meaning "any character, just one." A request for files with the P* or P?? extension would cause GRAPHCAT to hunt for files whose extensions begin with P, including graphic files such as PCX and PIC images. WP6: The default selection for files to examine is *.WPG, and you may use standard DOS wild cards, as for WP51, to specify the extension. In 6.x, you may also use wild cards for the file name. For example, to look only at WPG files starting with W, enter W*.WPG at this prompt. WP6 AND WP51: It's very easy to just choose * or *.* at this prompt, and try to read every file. Don't do it! The wild cards are intended for cataloging mixed disks of graphics files. If you use the * choice for directories containing program files, GRAPHCAT will run far more slowly, because it must load and identify as bad every program file in the directory. For best and fastest results, use the real file extension of the graphics you are looking for, unless you really do intend * or *.* to mean ALL the files in the directory. CATALOG TITLE ------------- The third prompt asks for a title, and the macro will place that title in a header on each page of the catalog. I recommend entering the name of the graphics collection or the name of the archived backup for that collection, such as "Business Graphics-- BUSINESS.ZIP" in this area. All Rights Reserved (C) Copyright 1991-95 Jerry Stern G R A P H C A T V. 3.2 / DOS 14 If you do not enter a title, GRAPHCAT will make one up for you. The default title is "Clip Art in" plus the location where the graphics were found. (A typical title will be "Clip Art in c:\wp51\graphics\*.*".) COLUMNS ------- Enter the number of columns to use for the catalog. If you do not want your catalog divided into columns, enter "1". HEIGHT ------ Enter the height for the graphics. WordPerfect will calculate the width to keep the graphics true to scale, room permitting. If less than about twice the height of a graphic is available for the width, some graphics in horizontal format will be compressed to fit the column. Very wide graphics, like address labels or scanned signatures, may require fewer columns than typical images, for graphics of the same height. For four columns, a height of one inch allows ample room for most images, and 28 images fit on one page. These combinations work well, and will show on screen: five columns with a height of 3/4", resulting in 45 graphics per page, or 3 columns and 1.2" (18 per page), or two columns and 1.8" (8 per page). International Users of WP51: the default height set by GRAPHCAT is 1", but you may enter a graphic height as you normally would. If your default measurement is centimeters, you do not need to specifically tell WP and GRAPHCAT; the program and the macro will use your default measurement unit automatically. International Users of WP6: the default height set by GRAPHCAT is 2.5cm if you have set WP to use centimeters, 25mm for millimeters, or 1" if you use inches. Enter measurement values as you do normally. WP6 ONLY: GRAPHIC ON DISK ------------------------- WP6 ONLY: You may choose to have GRAPHCAT retrieve all the graphic images (default), or to let it read them off the disk as it needs them, known as "Graphics on disk" or external graphics. CAUTION: If you choose the "on disk" option, DO NOT SAVE the catalog. Generally, printing it later will not work. If cataloging a floppy disk of graphics, that disk must remain in the drive during printing. Although this option saves large amounts of temporary drive space, use it carefully. If All Rights Reserved (C) Copyright 1991-95 Jerry Stern G R A P H C A T V. 3.2 / DOS 15 WordPerfect 6.0 cannot find your graphics when it comes time to print, your catalog will contain only empty boxes and captions. WP6 ONLY: PARTIAL CATALOGS -------------------------- The options box allows partial catalogs in WP6 only. 1) The starting file name is the name of the first file in the directory that Graphcat should place in the catalog. Click the search button to look in a directory listing to find the file you want. If Graphcat notices that you did not go to the end of the last directory of graphics cataloged (within the same WP session), then it will automatically display the next filename here when the options box appears. 2) First page number. Set this manually, or if creating several catalogs from a large directory of files, let Graphcat set it for you as the last page number created in the previous catalog, plus one. 3) Number of images to catalog: This number will carry over from one catalog to the next within the same WP session. This number is fixed at 60 in the shareware version. When cataloging very large directories of graphics, and especially CD-ROMs of clip art, set the number of images to fill a set of pages that you can easily print, perhaps two or four at a time. After printing that catalog, run Graphcat again, and click on OK in both boxes to continue the catalog where you the previous set ended. LAYOUT OPTIONS -------------- These options are available only in the registered edition of GRAPHCAT, and work similarly in WP51 and WP6x. CENTERING: By default, graphics are lined up on the left side of each column. Enter 'y' here in WP51, or check the box in WP6x, to center the graphics within the columns. ALTERNATING PAGE HEADERS: By default, GRAPHCAT places the page numbers at the top right corner of each page. If you are going to print the catalog on both sides of the paper, choose this option to let GRAPHCAT place the page numbers on the outside corners of each page, top All Rights Reserved (C) Copyright 1991-95 Jerry Stern G R A P H C A T V. 3.2 / DOS 16 right on odd-number pages, and top left on even-number pages. HORIZONTAL CATALOGS (NEW in 3.2): By default, GRAPHCAT builds catalogs arranged in order down each column, like a newspaper. Choose this option to position the graphics in order across the rows of the page, left-to- right. Note: If you plan to make extensive editing changes to the completed catalog, the default newspaper style can tolerate more changes. The left-to-right format can easily become disorganized and messy if you change page layout features. BORDER STYLE: GRAPHCAT adds a dashed border to each image by default. You may select a different border here from among those listed on-screen. FORCED MATCHING BOXES: Some users have told me that they want all these borders to be the same size, no matter what shape the graphic inside the box is. Not recommended--this will distort or shrink the graphics, just for a pretty page design: Back at the Columns setting, choose one more column than you would normally use for the image height, OR increase the image height by about 30%. For example, try 5 columns of 1" graphics or 4 columns of 1.3" graphics. Yuck. Nice square boxes. Your choice. WORKING ON THE GRAPHIC... ------------------------- After the last entry has been made, GRAPHCAT will begin loading the graphics into the document. As each graphic is loaded, the macro announces the new graphic on screen. When the directory of graphics is large, this process will be considerably faster if there is additional memory available for WordPerfect to use, but hard disk space will be substituted automatically. If your system does not have additional memory, be sure that your default directory is set to a hard drive, rather than a floppy. If WordPerfect decides that a graphic in your sample directory is not a proper graphics file, GRAPHCAT will add that file name to a list of files that could not be loaded, and that list will be printed at the end of the catalog. You may delete that message after the catalog is prepared, or you may try to convert the bad graphic or edit it with a graphics program, resave it, and run GRAPHCAT again. Because not every version of every graphic format is supported by WordPerfect, I prefer to leave the file list in All Rights Reserved (C) Copyright 1991-95 Jerry Stern G R A P H C A T V. 3.2 / DOS 17 the catalog to identify a file that may be usable in other software, but not in WordPerfect. (Or the disk may contain non- graphic files, such as a README.1ST or FILE_ID.DIZ, and these files will be listed automatically at the end of the catalog.) When the catalog is finished, the screen display will be replaced by the new catalog page. You may, and should, preview the page before printing. GRAPHCAT may be stopped in mid-inventory by pressing the Cancel key just once; there may be a time lag of a few seconds before the macro stops. If you use the Cancel key to stop GRAPHCAT, the macro will leave behind a warning at the top of the document that the file is incomplete. The warning is just a comment box, and may be deleted if the partial catalog is useful. IN GENERAL ---------- GRAPHCAT has error trapping routines built in to prevent garbage entries, and to turn off Reveal Codes if needed, and will not try to run if you start it without enough available open document space. If you wish to import the catalog or the file list into a document, run the macro first, and then add the other text or formatting into the catalog or file list. GRAPHCAT builds very large documents. Your system will run faster with 1) more memory, 2) better memory software, such as QEMM, and 3) more available disk space. This was true with WP51, and with WP6, it is more important than ever. Since starting to catalog my clip art collection, I've found pictures I didn't know I had, and I've used some of those in new projects. Now that I don't have to hire extra help to create the listings, I can find the picture I want in no time, and, better yet, I can take the picture notebook with me to a co-worker, a client, or a conference, and I don't need to borrow someone else's computer and be at the mercy of someone else's operating system. EDITING ALL THE IMAGES AT ONCE ------------------------------ You may edit the finished catalog just as you would any other document, but do turn on Reveal Codes (Alt-F3)--there are a lot of codes in the document. WP51: The borders may be changed by finding the [Fig Opt] code, deleting it, and adding a new code in the same location. You can All Rights Reserved (C) Copyright 1991-95 Jerry Stern G R A P H C A T V. 3.2 / DOS 18 also add a Justification:Center code at the beginning of the document. WP6: To edit the images all at once, press Graphics (Alt-F9), (1) Graphics, (4) Styles, choose the style named GRAPHCAT, choose (3) Edit, (3) Image Settings, and make any changes you like, including turning off color, increasing contrast, or rotating images. Don't change the borders from this screen. Exit out of the screen normally when done. To change borders, press Graphics (Alt-F9), (3) Borders, (4) Styles, choose the style named GCAT-BRD, choose (3) Edit, (2) Lines, and make any changes you like. Exit the screen normally when done. All Rights Reserved (C) Copyright 1991-95 Jerry Stern G R A P H C A T V. 3.2 / DOS 19 TROUBLE-SHOOTER'S GUIDE ======================= 1) GRAPHCAT won't read my graphics files. Why? GRAPHCAT supports all graphics formats supported by WordPerfect, and that list is quite large, and the new WP6 reads several new file formats. However, the list is misleading. According to the WP51 instruction manuals, TIF and PCX files are supported. That is partially true. Sixteen-color PCX files are supported, but two-color PCX files are not. (The number of colors refers to the format of the image, and not the visible colors in the image.) TIF files come in multiple flavors, and only a few of them are supported. To make matters worse, many scanner programs create non-standard files, unreadable by WordPerfect. Before claiming that GRAPHCAT can't read a good graphics file, test the files by manually retrieving the suspect files, and see if they work. If they work manually, but not with GRAPHCAT, contact Science Translations for assistance. As of this writing, no graphics files have been found that work with WP but not with GRAPHCAT. 2) My scanner makes graphics in several formats. Some are showing up reversed as white-on-black. What do I do? This is not a GRAPHCAT problem, but... Most scanner programs can save in several formats. Not all of these formats are the same "flavors" as those that WordPerfect likes (see #1 above). Try scanning an image normally, and then saving it in EVERY format that your scanner software supports. Run the whole bunch through GRAPHCAT to load them, and see which ones work. Use those formats for all your scanning. In general, IMG files seem to work most often, followed by PCX. (IMG is supported by WP51, but not by WP6.) TIF is frequently a problem, because of the difference between the multitude of TIF "flavors." 3) My images are squashed, and printed much too narrow. Run GRAPHCAT again for that set of images, using fewer columns, but the same image height. Or, if you are comfortable with editing in Reveal Codes, you can delete the Column Def code, and replace it with a new code for fewer columns. 4) My file names wrap to the next line. WP51: On the completed catalog, change your initial base font. Press Format (Shift-F8), (3) Document, (3) Initial Base Font, and choose a smaller font. All Rights Reserved (C) Copyright 1991-95 Jerry Stern G R A P H C A T V. 3.2 / DOS 20 WP6: Graphcat automatically shrinks the point size of the document initial font to fit the column settings you have chosen, if needed. However, your default initial font must be scalable for Graphcat to automatically set its size. 5) My document prints slowly. The graphics quality setting affects speed--higher quality takes longer. If a coarse image is acceptable, choose Draft graphics quality before printing. Additional computer memory will help, as will a disk cache program. Ask your local dealer for help. In WP6, using the partial catalog feature to break your catalog into pieces will help, especially on systems with limited memory and hard drive space. 6) Only half of my catalog page prints. Some laser printers may not have enough internal memory to print a page of that complexity. On a laser printer, if the entire page does not print, try printing the page at a lower setting for graphics quality, or use fewer columns. Adding memory is a more expensive fix, but worthwhile. 7) GRAPHCAT loads properly in WP51, and the big box appears on screen, but when I tell it what directory to catalog, An error message box appears. But I have checked--the files are good graphics files in the directory I've entered. This is an inconsistent error that occurs mostly with releases of WP from 6/90 to 12/90, although I have seen it more rarely with newer releases. Some of the settings in your configuration file are corrupt. To test this, start WP from the DOS prompt (No menus!) with the start up switch /x, like this: C:\WP51:> wp /x The x switch temporarily restores your copy of WP to the original defaults--it ignores all the choices you've made in Setup. Try running GRAPHCAT with this switch. If GRAPHCAT runs properly, then exit WP, restart WP normally, go into Setup and write down your options and settings. Next, exit WP, rename the file WP{WP}.SET to WPSET.OLD, and restart WP normally. Re-enter your options, and both WP and GRAPHCAT should run correctly. Alternative solution--upgrade to the newest release of WP; the problem does not seem to occur with any releases dated 9/91 or newer. 8) GRAPHCAT runs perfectly, but I cannot print the result file. The error messages say I don't have enough memory. This is strictly a WP problem, and it is just what it says. Try running WP without any popup programs or TSR software, from the All Rights Reserved (C) Copyright 1991-95 Jerry Stern G R A P H C A T V. 3.2 / DOS 21 command line (No menus!). Consider investing in a good memory manager program to give WP more usable memory. Print each page separately, or when running GRAPHCAT, try using fewer columns--there will be more white space on each page, but less strain on limited system resources during printing. 9) When I try to print a catalog of graphics found on a floppy disk, WP51 reads and writes to the floppy drive, and printing is extremely slow. WordPerfect 5.1 is placing its temporary print queue files on the floppy. There is an easy fix for this. Start WP with the command: WP /PF=(path) For example, try WP /pf-c: This command, which was added in the 3/90 release of WP, will divert the temporary printing files to the drive and path chosen. Printing speed should be improved considerably over allowing WP to use the floppy. 10) I am using WP 5.1 dated 3/9/92 or newer, and whenever I run GRAPHCAT, the error box appears that says that the Sort option in List Files is turned off. Huh? The 3/9/92 interim release of WP 5.1 added a new feature--it can show directories in the list files screen in the order the files are on the disk. This is faster than the usual way, but less organized. Who wants a list of graphics that isn't in alphabetical order? To run GRAPHCAT, you must do what the box tells you: Enter Setup (Shift-F1), choose (3) Environment, (4) Document Management/Summary, (5) Sort List Files, and choose Yes, and then Exit (F7) to return to your document screen. GRAPHCAT will now run normally. 11) The message "Position Hyphen" appears when I try to run GRAPHCAT on a directory of mixed graphics and text files. This only happens when some of the documents contain a "Hyphenation On" code, using the * choice on GRAPHCAT's extension line. The hyphenation message will occur only with hyphenated documents. You can avoid them by 1) Not using the * wild card extension, but instead choosing the extension of the graphics files, or 2) resetting the hyphenation options by pressing Setup (Shift-F1), (3)-Environment, (7) Prompt for Hyphenation, (1) Never, and Exit (F7) 12) Sometimes when I use the * or *.* wild cards, GRAPHCAT loads a file as a graphic that isn't one. The document loads and prints normally, but the box is either empty or contains a random pattern. All Rights Reserved (C) Copyright 1991-95 Jerry Stern G R A P H C A T V. 3.2 / DOS 22 The * wild card choice was intended for reading disks containing mixed graphics in different formats, such as WPG and PCX and CGM graphics mixed together, NOT for attempting to load every program file on your hard drive in the attempt to see if any of them are graphics. GRAPHCAT will correctly identify nearly every file as a graphic or not a graphic, but there are exceptions. For example, try loading the WordPerfect file LIBRARY.STY as a graphic--the resulting empty graphics box is harmless, but it shouldn't happen, and since it does not cause any error messages, GRAPHCAT can't eliminate it. To avoid these problems, when cataloging a directory of mixed graphics and program files, use the appropriate extension, such as PCX or WPG on the second line of GRAPHCAT's menu, and save the wild card use for disks holding only graphics. 13) Some of my images display or print in WP6 with very pale dots in the background. This happens occasionally with bitmapped images. To fix it from the finished catalog, press Graphics (Alt-F9), (1) Graphics, (4) Styles, page down to the style named GRAPHCAT, and choose (3) Edit, (3) Image Settings, (2) Color Adjust, (2) Contrast, type 1.0, and press (Enter). Press Exit (F7) enough times to return to your document--all the images will be fixed at once. 14) I'm running WP5.1+, and my WP.EXE file has a time setting of 5:11am. Graphcat says my software is defective. OR: With 5.1+, 5:11am edition and QEMM, when I first start Graphcat, QEMM announces an Exception 13 error. The 5:11am release was shipped with a defective {SYSTEM}entry command. Depending on your memory management software, macros that use that command will fail, and possibly crash WP as well. Notify WP that you have a 5:11am release with a defective {SYSTEM}entry command, and that your macros need that command to work. They should ship you the 5:11pm release, or newer, at no charge. WP's memo ID for this defect is 37979M. 15) Graphcat goes into an infinite loop EVERY time I run it, counting bad graphics that don't exist forever, or until I hit the Cancel key. Go into WP's Setup (Shift-F1) screen, choose Location of Files, and check all the entries--at least one of your entries is to a directory that doesn't exist, probably the entry for Graphic files. All Rights Reserved (C) Copyright 1991-95 Jerry Stern G R A P H C A T V. 3.2 / DOS 23 INDEX ===== ASP . . . . . . . . . . . . . . . 3 BMP . . . . . . . . . . . . . . . 9 bonus . . . . . . . . . . . . . . 4 borders . . . . . . . . . . . 16-18 caption . . . . . . . . . . . . . 7 centimeters . . . . . . . . . . 14 CGM . . . . . . . . . . . . . . 22 color . . . . . . . . 9, 18, 19, 22 columns . . . . 7, 8, 14-16, 19-21 DHP . . . . . . . . . . . . . . . 9 DXF . . . . . . . . . . . . . . . 9 editing . . . . . . . 9, 16, 17, 19 error messages . . . . . . 20, 22 FAX . . . . . . . . . . . . . 1, 3 FILE_ID.DIZ . . . . . . . . . . 17 font . . . . . . . . . . . 19, 20 GEM . . . . . . . . . . . . . . . 9 IMG . . . . . . . . . . . . . 9, 19 interim release . . . 1, 7, 11, 21 International . . 5, 6, 10, 11, 14 Internet . . . . . . . . . . . . 3 labels . . . . . . . . . . . . 14 laser printers . . . . . . . . 20 LETTER . . . . . . . . . . . . . 8 memory . . . . . . . 16, 17, 20-22 MGX . . . . . . . . . . . . . . . 9 MSP . . . . . . . . . . . . . . . 9 Novell . . . . . . . . . . . . . 3 ombudsman . . . . . . . . . . . . 3 page numbers . . . . . . . . . 15 PNTG . . . . . . . . . . . . . . 9 PPIC . . . . . . . . . . . . . . 9 Presentations . . . . . . . . . . 9 registration . . . . . . . 1, 3-6 SETUP . . . . . . . 1, 7, 12, 20-22 shareware . . . . . . 1, 3-5, 7, 15 support . . . . . 1, 3, 6, 7, 9, 11 TGA . . . . . . . . . . . . . . . 9 TIF . . . . . . . . . . . 9, 13, 19 trouble . . . . . . . . . . . . 19 VENDINFO.DIZ . . . . . . . . 3, 4 Wood Clips . . . . 1, 3, 4, 6, 11 WP{WP}.SET . . . . . . . . . . 20 WPG . . . . . . . 4, 9, 11, 13, 22 WWW . . . . . . . . . . . . . 1, 3 All Rights Reserved (C) Copyright 1991-95 Jerry Stern