@database "Envelope" @width 80 ## $VER : Envelope Guide 1.11 @node main "Envelope Guide" @{b}Envelope Printer Guide@{ub} ----------------------- Version 1.11 28th February 1998 WARNING : READ THE DISCLAIMER BEFORE USE @{" Introduction " link Intro} @{" Disclaimer " link Disclaimer} @{" Licence " link Licence} @{" Requirements " link Requirements} @{" Usage " link Usage} @{" Tooltypes " link Tooltypes} @{" Preferences " link Prefs} @{" Arexx " link Arexx} @{" Bugs " link Bugs} @{" History " link History} @{" Future " link Future} @{" The Author " link Author} It's been a busy month, so I haven't had much of a chance to get a lot done with Envelope. Here it is though. © 1997-8 Jason Brown @endnode @node Intro "Introduction" Introduction ------------ Over Christmas 1996, my typewriter became terminally ill. The only thing I used my typewriter for was to address envelopes. So until I could get a new typewriter in the New Year, I decided to use my computer and printer. However, I very quickly got tired of loading a word processor just to type out an address (especially if I was low on memory and had to quit what I was doing at the time). So I decided to write a quick program that would print out the addresses for me, thus Envelope was born. Envelope is very simple. It prints addresses onto envelopes. It is also small program. Because of the vast expanse of E-Mail not everyone will have a use for this program (I use it less often now I'm on the Internet). If fact most will probably send it to the Trashcan immediately. Envelope fully functions as a commodity. Envelope is also fully font-sensitive and font-selectable. @endnode @node Disclaimer "Disclaimer" I M P O R T A N T Although I have tested the program thoroughly and although the program code is very simple, this software is supplied with no form of warranty or guarantee whatsoever. USE IT AT YOUR OWN RISK This does not only apply to crashing a machine with important work being done on it, but also if an important envelope is misaddressed. In the end you must check any envelope as soon as it is printed for any errors. I will not be held responsible for any losses incurred by an important envelope getting lost in the post because it was misaddressed. YOU HAVE BEEN WARNED!!! @endnode @node Licence "Licence" Licence ------- You are free to copy, distribute etc. Envelope as long as the archive is not modified in any way and all files are kept intact and no charge other than reasonable disk copying charges is made. @endnode @node Requirements "Requirements" Requirements ------------ Machine ------- Envelope was programmed and tested on a A4000, so should run on an A1200 without any problems. Furthermore Envelope should run on any machine with Kickstart 37+ (AmigaDos v2 or higher), but since I do not have one of these to hand I have been unable to test this for sure. If there are any problems then please contact the @{" Author " link Author}. Envelope will not run on AmigaDos v1.3 or lower Envelope is fully font sensitive. If the font requested does not fit onto the screen, then Topaz/8 will be used. Memory ------ Envelope is designed to use as little memory as possible, so it can if need be remain in memory permanently. However, one thing to remember is that because Envelope uses the standard printer device, then this will consume approximately 40K when opened if no other program has used the printer device. If memory is low and an error occurs (such as trying to open the main window when there is not enough memory) then Envelope will quit completely. This 'feature' was originally a bug, but I decided to leave it in because if memory is that low, then you will need to quit out of something anyway. @endnode @node Usage "Usage" Usage ----- Envelope can be started from either Workbench or CLI. See @{" Tooltypes " link tooltypes} You will be presented with a requester which will open on the default public screen (almost always Workbench). This screen will also be brought to the front. There are six string gadget into which you should type the name and address of the person you wish the envelope to be addresses to (although you can type whatever you like for that matter). There is a checkbox below these. If you have not set a sender's address in the @{" Preferences " link Prefs} then this will be ghosted and you don't need TO worry about it. If you have entered these details, then the state of the checkbox dictates whether the sender's address will be printed. There are five gadgets at the bottom. They are fairly self-explainatory but just in case:- QUIT - Quits HIDE - Closes down the window, but the program is still in the Amiga's memory. It will re-open the window if :- a) The Hotkey 'Control LeftAlt E' is pressed b) Since Envelope is a commodity, you can use the Commodity Exchange program. PRINT - This prints the data contained in the string gadgets onto an envelope. Envelope first re-initialises the printer, then performs six linefeeds, prints the appropriate data in Boldface, then performs a Form Feed to eject the envelope. Envelope currently indents the address 33 spaces. CLEAR - This button will clear the address fields. Very handy for clearing them so you can easily enter another address. PREFS - This will open a preferences window. See @{" Preferences " link Prefs} It was a bit of a crush making sure that it fitted onto a 640*200 NTSC screen (does anyone use this mode), but on larger screens Envelope will increase the spacing, thus improving the look. @endnode @node Tooltypes "Tooltypes" Tooltypes --------- These are the Tooltypes allowed. If a Tooltype is in brackets, then it is in effect 'switched off' and is ignored by Envelope (the same is true for all programs). For CLI startup, simply use the keywords below in the command line. See @{" Bugs " link bugs}. You may now run more than one version of Envelope at once. So you could have different Tooltypes set for different versions. CX_HOTKEY The Hotkey combination to open the window. If this is not set it will default to 'ctrl lalt e'. CX_POPUP If this is set to YES, then the requester will 'popup' when first loaded. If set to NO, then Envelope will hide in the background until the hotkey is pressed or called as a commodity. Default is YES. CX_PRIORITY Set the priority of the commodity within the commodities broker. This is not the same as the TOOLPRI Tooltype however. TOOLPRI The programs priority. Defaults to 0 and I wouldn't mess around with it too much. PREFSFILE Where Envelope should look for it's preferences file. If this is not set, Envelope will look in ENV: then PROGDIR: @endnode @node Prefs "Preferences" Preferences ----------- You can open the preferences window by clicking on the Prefs button in the main window. You can also edit the preferences by loading the @{" PrefsFile " link PrefsFile} into a text editor. Sender Information ------------------ Sender Here you can enter six lines of the Sender's Address. No other lines will be added, so you may wish to pu "Sender:" on the first line. Style Select the print style for the Sender's Address Xpos The position of the Sender's Address Ypos Print This controls the state of the Print Sender's Address checkbox in the main window. Main Information ---------------- Style Select the print style for the Main address Xpos The position of the main address. Try not to include silly Ypos values so that the Sender's Address is printed on the same line. Other Information ----------------- Init1 Initialisation data. Currently the only supported tool value Init2 is HPLANDSCAPE. This should allow HP printer to print the envelopes in Landscape mode. INIT1 is the data sent to the printer at the start, and INIT2 is the data sent after the envelope has been printed. You need supply the information for both. Device By default Envelope prints to PRT: However, you can select a different device, say PRT2: Window Title You can change the main window title here. This is useful if you have different versions of Envelope for different sized envelopes, different sender's addresses (business & personal) etc. By setting a different title, you can easily tell which is which. Screen Font Check this gadget if you wish to have the screen font. Otherwise click on the Choose button (you will have to uncheck the checkbox first). If a window can't be opened because the font you have chosen is too large, then Envelope will revert to Topaz/8. Although this shouldn't happen with the main window, it could happen with the preferences window on smaller screens with larger fonts. Who said you needed MUI for font sensitive requesters ;-) Buttons ------- Use - Updates the settings and then closes the prefs window. Save - Updates the settings, saves them, then closes the prefs window Test - Updates the settings, but keep the prefs window open. Ideal for tweaking some settings. Cancel - Closes the prefs window, and reverts the settings back to what they were when the prefs window was opened. @endnode @node PrefsFile "PrefsFile" Preferences File ---------------- You can, if you wish, edit the preferences by loading the preferences file into a text editor). These are the keywords that it currently supports. To temporarily "turn off" a command, simply put any character before it, like an asterisk (e.g. "*FONT topaz" will be ignored). Note, that Envelope will completely remove these lines when saving it's own preferences. FONT If you do not wish to use the default screen font, you may type in the name of another font in here. It must be in the format "times.font 11" (without the quotes). The font name must include .font, followed by one space and then the font size. ADDRESSX Where to position the main address. These used to be called ADDRESSY LEFTEDGE and LINEFEEDS. SENDERX As above, but for the Sender's Address. SENDERY WINTITLE The main window title. INIT1 Initialisation data. Same as the equivalent commands in INIT2 the preferences window. PRINTSENDER Controls the state of the checkbox in the main window. If set to YES, the checkbox will be checked, but you can still print the sender's address by selecting the checkbox before printing. You must set some senderline data however SENDERSTYLE Four options are allowed. NORMAL, BOLD, ITALIC, CONDENSED. ADDRSTYLE You can mix them together eg BOLDITALIC, but NORMAL will clear all styles. ADDRSTYLE is the main address style and SENDERSTYLE is the Sender's Address. SENDERLINE1 The lines of the address of the sender. 2, 3, 4 etc DEVICE By default Envelope prints to PRT: However, you can select a different device, say PRT2: @endnode @node Arexx "Arexx" Arexx ----- Envelope supports Arexx. The default port name is ENVELOPE.1, the second ENVELOPE.2 and so on. Up to nine different programs can be run at once. These are the supported functions PUTADDRESS ie PUTADDRESS 1 "Nelson Mandela" HIDE Hides the Interface SHOW Shows the Interface PRINT Prints the envelope QUIT Have a Guess !! OPENPREFS Opens prefs window. No harm will be done if already open. CLOSEPREFS Closes prefs window. No harm will be done if not open. USEPREFS Closes prefs window, but keeps any changes (but doesn't save) SAVEPREFS Saves current preferences You can also adjust all of the settings from Arexx. To do this just prefix the keywords in the @{" PrefsFile " link Prefsfile} with SET. eg SETLINEFEEDS 16 Sets the linefeeds to 16 SETWINTITLE "Arexx Window Title" Sets the window title SETFONT xhelvetica.font 11 Changes the font The SET commands will not have any effect if the preferences window is open however and will return a Warn to the Arexx sender, so it's best to perform a CLOSEPREFS first. One thing to remember is that Arexx converts characters to upper case unless you enclose the in quotes. So although the top example would still work without the quotes it would end up as NELSON MANDELA instead of Nelson Mandela @endnode @node Bugs "Bugs" Bugs ---- - The Cancel/Test still partially exists. If you open the prefs window, change the font, press Test, then press Cancel, the font will not update the window (although the change has taken place). This will take a bit of re-writing. It's such a minor problem though, it will have to wait until the next version. - I can't test the HPLANDSCAPE function since I don't have one of these printers. Let me know how it works. - I've heard reports of Envelope ejecting a blank envelope on systems running Turboprint. Again, since I don't have Turboprint it could be difficult to track down. If you are running Turboprint without this problem, please let me know. If something does go wrong then please contact the @{"Author" link Author} Try to send as much information as you can. A recent bug (crash if no prefs file is found) only caused a crash on some machines. It turned out that it was only on Amigas with WB3.0 or lower. And remember to include the version of Envelope you are running. @endnode @node History "History" 26/01/98 Version 1.10 - Source code completely transferred from AmigaE to ANSI C. You may note that the executable is some 4K smaller than the previous version (and this version has the extra enhancements below). - Envelope will now look for PROGDIR:Envelope.prefs instead of PROGDIR:!Envelope.prefs (slip of the finger when typing in the path :) Envelope will also rename any files for some users that spotted this and renamed the prefs files themselves. - Hiding the interface now saves the data in the address fields for the next time it is opened. - Changing the Window Title just refreshes the main window instead of closing and re-opening the window. - Envelope will automatically correct any out of range figures in the preferences window (Leftedge & Linefeeds) as long as Return or Tab is pressed after the data has been entered. - If you have a custom prefs file in ENV: then Envelope will also save a copy to ENVARC: as well (and vice versa). - CLI startup should now work properly. - Removed some OS3.0 only code. 28/02/97 Version 1.10 - Fixed a memory problem (a consequence of transferring from AmigaE to ANSI C). I'm amazed it never crashed. - Implemented configurable Sender's Address position. This should help those with HP printers. Also renamed Linefeeds & Leftedge to X Pos & Y Pos to match the Sender's Address names (which are probably better suited). Also renamed the appropriate keywords in the @{" Prefsfile " link prefsfile} - Partially fixed the Cancel/Test problem. It was much harder than I first thought. Took a complete rewrite of the way preferences are handled internally. Not absolutely perfect though. See @{" Bugs " link Bugs} - Added a Clear button. This clears all of the address fields to make it easier to enter another address. This button won't stay there. It's just there until I get the menus sorted out. - Finally gave in to all the requests and made the Return button move the cursor down to the next string gadget (only for the address lines) - Some changes to the preferences GUI @endnode @node Future "Things for future releases" Future ------ Ideas for the future - PPC version (if/when we can get the compiler working properly) - Adding menus for things like presets and multiple prefs files. - The ability for the user to set printer initialisation codes for various special commands. Landscaping, printer fonts, different tray etc. - Address Book and Database Scanning options. - Possible MUI & ClassAct version. To be honest, I don't think this is nessesary. I do find writing font-sensitive GUI's very easy indeed (take a look at the prefs window), but if I get enough demands for it, I will certainly consider it. @endnode @node Author "The Author" Contacting the Author --------------------- If you wish to send me bug-reports, requests, etc. my E-Mail address is jason@albatross.co.uk Other programming projects :- AminetConverter - available on Aminet --------------- Converts Aminet INDEX files into files that can be easily imported into database/spreadsheet programs. TaskManager - available on Aminet ----------- A program that handles task priorities. Whilst there may be other programs available that do this task, because this is the sole function of TaskManager, it can be done very quickly and easily. @endnode @endnode