BRAFPDS (BRowse Advanced Function Print Data Stream)

IBM License Agreement for BRFPDS IF YOU DOWNLOAD OR USE THIS PROGRAM YOU AGREE TO THESE TERMS. International Business Machines corporation grants you a license to use the Program only in the country where you acquired it. The Program is copyrighted and licensed (not sold). We do not transfer title to the Program to you. You obtain no rights other that those granted you under this license. Under this license, you may: 1. use the Program on one or more machines at a time; 2. make copies of the Program for use or backup purposes within your Enterprise; and 3. modify the Program and merge it into another program. You must reproduce the copyright notice and any other legend of ownership on each copy or partial copy, of the Program. Except as expressly provided in the DAPTOOLS LIBRARY License Agreement (TOOLIC.TXT), you may NOT: 1. distribute the program in any manner, including through electronic bulletin board systems or other means; 2. sublicense, rent, lease, or assign the Program; and 3. reverse assemble, reverse compile, or otherwise translate the object code of the Program. We do not warrant that the Program is free from claims by a third party of copyright, patent, trademark, trade secret, or any other intellectual property infringement. Under no circumstances are we liable for any of the following: 1. third-party claims against you for losses or damages; 2. loss of, or damage to, your records or data; or 3. economic consequential damages (including lost profits or savings) or incidental damages, even if we are informed of their possibility. Some jurisdictions do no allow these limitations or exclusions, so they may not apply to you. We do not warrant uninterrupted or error free operation of the Program. We have no obligation to provide service, defect correction, or any maintenance for the Program. We have no obligation to supply any Program updates or enhancements to you even in such are or later become available. IF YOU DOWNLOAD OR USE THIS PROGRAM YOU AGREE TO THESE TERMS. THIS PROGRAM IS PROVIDED "AS IS" WITHOUT ANY WARRANTIES, EXPRESS OR IMPLIED, INCLUDING THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. Some jurisdictions do not allow the exclusion of implied warranties, so the above exclusion may not apply to you. You may terminate this license at any time. We may terminate this license if you fail to comply with any of its terms. In either event, you must destroy all your copies of the Program. You are responsible for the payment of any taxes resulting from this license. You may not sell, transfer, assign, or subcontract any of your rights or obligations under this license. Any atdttempt to do so is void. Neither of us may bring a legal action more than two years after the cause of action arose. If you acquired the Program in the United States, this license is governed by the laws of the State of New York. If you acquired the Program in Canada, this license is governed by the laws of the Province of Ontario. Otherwise, this license is governed by the laws of the country in which you acquired the Program. ----------------------------------------------------------------------------- IBM DAPTOOLS Use Only BRAFPDS DESCRIPTION BRAFPDS is an OS/2 2.0 application that will allow one to browse A(dvanced) F(unction) P(rint) D(ata) S(tream) documents on the workstation. It avoids the use of GDDM on the host, and thus the rather slow drawing caused by I/O intensity. It is especially usefull when you are connected via a slow (= not-coax) communication link. USAGE Do the following to use BRAFPDS on your workstation. 1. Download the executable file BRAFPDS in binary - The ALMCOPY default for LIST3820 is ASCII/CRLF. This is why I've renamed the file to L38BIN. RECEIVE has the correct default. If you want to download other LIST3820 files, be sure to specify /BIN when using ALMCOPY. 2. Put the executable somewhere where you can find it. 3. Download the L38BIN file to the workstation in BINARY. INVOCATION The following syntax is used: þ BRAFPDS (no parameters) þ BRAFPDS filename.ext þ BRAFPDS file*.pat If the parameter specifies an existing file, it will be displayed automatically. If it is a pattern with wildcards, you will automaticcaly get the FILE/OPEN dialog to specify the file you want to browse. This will also happen if the file that you specified is not a valid AFPDS data set. Not specifying any parameters at all will have similar effect. ACTION BAR Action bar items are: FILE/OPEN Specify the file you want to browse. You will get an OS/2 Standard File Dialog. Just press OKE when you have selected the right file (or double click the required file). FILE/EXIT Stop NEXT PAGE Display next page. The current window views a particular cut-out of the page. When you use the NEXT PAGE action, this same cut-out will be displayed for the next page. PREV PAGE Display the previous page, similar to NEXT PAGE, but in the other direction. GOTO PAGE Display a pop-up dialog, with a spin button, where you can specify the page you want to display next. The page numbers are just the count of sheets from the start of the document, and have no relation to the text being displayed at the bottom of your pages. The maximum allowed page number may not be that of the last page of the document, as it may take some time to count all the pages. OPTIONS/ZOOM Display of a ZOOM slider that allows you to specify a relative size of the pages. The two detents indicate usual sizes for A4 and an SVGA (8514) screen. Press APPLY to display the current page with the new ZOOM factor. Press OKE to display the page, and discard the dialog. Press CANCEL to use the original ZOOM factor from before the activation of the ZOOM dialog and close the dialog. OPTIONS/ZOOM to Fit Zoom the displayed pages such that the current page just fits inside the current window on the screen. You can select whether the Horizontal or Vertical direction of the current window should be used to control the page size. The size of the window in the other direction is adapted to just fit the page. In summary: if you "Zoom to Fit Horizontal" the width of the window will be unchanged. The height of the window will be adapted to fit the aspect ratio of the current page, and the zoom factor will be modified to fit the entire page. OPTIONS/Full Page Similar to the ZOOM to FIT VERTICAL, but now the SCREEN size instead of the current window size will be used to control the size of the new window. OPTIONS/IMAGE Toggle the display or non-display of images in the data stream. Defualt setting is to only draw a box at the place where an image could be displayed. ABOUT Just some text. KEYS AND SCROLLING Please read this section carefully, as it explains shortcuts for those of you who are to lazy to move the mouse (like me). PAGE-UP Scroll the current size of the window into the direction of the beginning of the file. If you can't go further within the current page, this will cause the display of the bottom of the previous page. PAGE-DOWN Scroll the current size of the window into the direction of the end of the file. If you can't go further within the current page, this will cause the display of the top of the next page. HOME Nothing yet, but you can guess what it will do the next release. END Nothing yet, but you can guess what it will do the next release. UP-ARROW Scroll towards the direction of the beginning of the file, but more slowly than PAGE-UP. This will NOT move to the previous page. DOWN-ARROW Scroll towards the direction of the end of the file, but more slowly than PAGE-UP. This will NOT move to the next page. ALT-N Display the same cut-out of the current page for the next page. ALT-P Display the same cut-out of the current page for the previous page. F10 (or ALT) Z Display the ZOOM dialog. F10 (or ALT) V Do the ZOOM to FIT VERTICAL processing. F10 (or ALT) H Do the ZOOM to FIT HORIZONTAL processing. F10 (or ALT) L Do the FULL PAGE processing. F10 (or ALT) I Toggle IMAGE processing. ALT-G Display the GOTO dialog. F10 (or ALT) X Exit BRAFPDS, with a prompt for "Are you sure?". ALT-F4 KILL (CLOSE) current window or dialog without further questions. ESC CLOSE current dialog window like pressing the CANCEL button. Enter CLOSE current dialog window like pressing the OKE button. ENHANCEMENTS I'm still working at the following enhancements: þ Building a TOC asynchronously, and putting it in a Listbox, so that you can see some info about the page you're jumping to. þ Better Character Support and NLS issues. þ Rotated pages and pictures. þ Print interface, so that you can get the current page to a printer. GOODBYE Guus Bonnes, CCS-BNL MVS Systems Programming. ----------------------------------------------------------------------------- ************************************************************************ * * * BRAFPDS * * * ************************************************************************ 1993, August 15: Updated version (1.15) Modifications: - Re-did some of the later changes. I had to recover some files after MS-DOS 6.0 install tricked me into deleting my hard disk partition table. Also started on a restructure of the code. During this process, I found some coding errors which must have caused some problems (but which????). - Still used my own ICON, as I couldn't decide between the two others that I received. You may cast your vote in the forum (left or right). - Included a crude version of the GOTO function. It will only display absolute sheet-numbers. Usually these are offset by the number of ROMAN NUMERAL pages at the start of your document. - Exchanged order of NEXT_PAGE and PREF-PAGE on ACTION BAR. - Included a ZOOM TO FIT option. You can select horizontal or vertical fit. The other direction is adapted to fit the paper-dimensions. - Included a FULL PAGE option. This will adapt zoom and window size, such that exactly one page can be viewed in full-page mode. - Corrected Zoom, such that OK does really perform APPLY and Close. - Fixed loop problem with command line invocation of non-afpds file. - Corrected all the default selections of push buttons. - SAVEd the current settings of the ZOOM dialog. - Included Page X of Y in TITLE. The Y may be incorrect during the first few displays, as it takes some time to count all pages. - The ZOOM dialog is now modeless. Maybe the OS/2 Guide should be adapted to better explain how simple it really is to go modeless. Restrictions: - Most of the 1.12 restrictions are still there. 1993, May 27: Updated version (1.12) Modifications: - Redid the PSEG processing. It's now unacceptably slow, but at least it works on all displays I tested with. Could not find anything causing the reported traps, hope it went away. - PSEGs should not have any "modern-art" effects anymore. - New item under OPTION: IMAGE. If checked, images are displayed. If not, then not. The default is *not* to display images. - Initial size no longer maximised. (No saving yet.) - Zoom slider does now only start redraw when APPLY is selected. CANCEL resets to previous state, while OK ends the slider bar. No more undue delays when trying to move the slider. However, it still is a MODAL dialog. - Pages are now created asynchronously. This means that the system will now no longer hang during a Next-page or Prev-page request. If it takes longer then 10 seconds to get the next page, the currently stacked next-page is aborted. - Egg-timer POINTER displayed when busy with next/prev-page. - Automatic drop into OPEN when no file-name specified as parameter. - Zoom slider no longer truncated at 80 on standard VGA screens. - Initial display of a document is at the top-half of the page, instead of at the bottom-half. - Did something about .tb with fill characters (doesn't look nice though). - Used an example from Stephen Kress for the LOGO display time of the ABOUT dialog. Thank you Stephen! - Included an ICON. If you've got a better one ...... Restrictions: - No National Language Support yet. - Not all special chars processed (superscripts, (c), Isil Screen corners). - No rotated text yet. - Nonproportional fonts are lousy (OS2V2WIG page 1-25 is error free!). - Still no GOTO. - No IOCA images yet. - No direct display of PSEGs or OVLYs yet. - No print interface yet. - No Italic or Bold text yet. - The HELP/INFO menu-item is still empty. 1993, May 17: Updated version (1.01) Modifications: - Fixed background color usage resulting in raster patterns being displayed, which rendered complete display unreadable. - Included one more CGRAPHIC character (forgot one). - Reached better approximation for fixed pitch fonts. 1993, May 08: Updated version (1.00) First bug fix already Modifications: - Oops, error in ZOOMing after images in datastream. Fixed. 1993, May 01: Updated version (1.00) First version on OS2TOOLS Modifications: - Got most of the special symbols now. - Fixed problem with dots in BookMasters Table of Contents. - Fixed problems with *REAL* bad alignment in CGRAPHIC's. It's now only limited misalignment. - Enhanced PSEG support. If you've still got some pictures that come out as black squares, please tell me. - Made the cursor and page up/down keys scroll through the window. - Replaced ZOOM Scroll bar by a slider, and changed its speed. - Inserted an ABOUT box to tell everybody who I am. Open problems: - Not yet all symbols displayed correctly (Copyright). - PSEGS have some trouble with rastering (moire). - Found that BOLD and ITALIC don't work. - Little feedback from field testers. 1992, May 25: Updated version (0.30) available via request Modifications: - Fixed some more bugs - Reduced working set by another factor 4 (now around 750K) - Images working for all zoom-factors Open problems: - performance unchanged - not yet all symbols displayed correctly - little feedback from field testers 1992, May 08: Updated version (0.20) available via request Modifications: - Fixed some bugs - BGA support - Scrolling support - Zoom support - Implemented file-name argument - Images working for maximum size display (but clumsy if smaller) Open problems: - Painting still takes a bit too long in my opinion - Needs too much working storage (about 3MByte) - Images are not correctly scaled - Some more, but please tell me !!! 1992, April 13: Initial version (0.10) available via request Pre-beta prototype shows that it can be done. ????????: Following niceties considered (not yet done). - Multitasking the file-read and screen handling. - Building a TOC asynchronously, and putting it in a Listbox - Allowing a double click on the TOC to jump to a specific page COMMENTS ??? Let me know what you think about it. Bye, Guus Bonnes, CCS-NL systems programming, NL10255 at EAMSVM1