The Atari Compendium

home *** CD-ROM | disk | FTP | other *** search

/ The Atari Compendium / The Atari Compendium (Toad Computers) (1994).iso / files / umich / apps / other / cled122s.lzh / CLED / DOCS / CLED.DOC next >

Wrap

Text File | 1991-05-14 | 18.5 KB | 463 lines

066010303050000132002006006010000 1CLEDUsers Manual1 2Page #1 F0110030001 9[..◆..◆..◆..◆..◆..◆..◆..◆..◆..◆..◆..◆..◆..◆..◆..◆..◆..◆..◆..◆..◆..◆..]0110 ü ::::::::::::::::::::::::: :::::::::: :::::::::: :::::::::::::: :::::::::: :::::::::: :::::::::assette::::::::::abel::::::::::::::itor ëUSERSMANUAL ü Lastrevision(Thisdocument):28/12/90 Version(CLED):1.21 Lastrevision(CLED):28/12/90 Ç ü üëCassetteLabelEDitor-UsersManual Ç êTableofContents Ç Section# Description Page -------------------------------------------------------------- 1 Introduction. 1.1 Identification..........................3  1.2 Programfunction........................3 1.3Accessingandrunningtheprogram.......3 2 Input/Output. 2.1 Input...................................4 2.2 Output..................................4 2.2.1 Saving..................................4 2.2.2 Printing................................4 2.3 Screenlayout...........................5 2.3.1 Menubar.................................5  2.3.2Thewindows.............................5 3 Diagnosticsanderrors. 3.1 Diagnosticreports......................6 3.2 Knownfaults............................6 4 Closingnotes. 4.1 Printerssupported......................8 4.2 Copyright/Disclaimer....................8 4.3 Plannedupgrades........................8 4.4Thanks..................................8 AppendixA Printerconfigurationfiles.............9 AppendixB Printerssupported.....................11 Çê1. Introduction Ç CLEDisasmallprogramoriginallywritteninCommodore64basicby myselftoproducecassetteboxinserts.Sincetheoriginalprogram thecodehasbeenportedtoATARIST(andhopefullytheproposedANSII standard)compatibleCandgreatlyupgraded.ThemainreasonIhave continuedtodevelop(fix?repair?)thisprogramistogainsome familiaritywiththeGEMsystem. Theinsertsproducedhaveasmalluserdefinedgraphicemblem(for grouplogosetc.)inthetopcentreandaresizedtofitinastandard cassetteboxexactlywhenfolded. 1.1 Identification. NAME : CLED.PRG VERSION : 1.21 DATE :28/12/90 AUTHOR : Robert Alley Lot1590GaySt. Huntingdale. WA6110 Australia (09)490-1105 LANGUAGE : Mark Williams C 1.2 ProgramFunction. This program allows you to edit and print labels forcassette boxes. Each label consists of asmallgraphicinthetopcentre, thirteen lines of song titles and twolinesofspinelabels. The label is 48 characters wide, with 22 characters per line for side one and 23 for side two. Spine labels are afull46 characters. 1.3 Accessingandrunningtheprogram. TheprogramisaccessedbydoubleclickingontheCLED.PRGiconfrom thedesktop,theprogramwillthenloadandrun. 1.4 Environment. TheprogramrunsontheAtariSTseriesofcomputers(Onlytested on520STFM,TOS1.0and520STe,TOS1.6)adotmatrix(Orcompatible) printerisrequiredforhardcopy.CLED.RSCmustbepresentinthe samedirectoryasthemainprogram,aswell,atstartuptheprogram willattempttoloadPRINT.DRVfromthecurrentdirectory.No additionalenvironmentisrequired. ♪≡Ç FILES: CLED.DOC This1stwordformattextfile. CLED.PRG TheCassetteLabelEDitorprogram. CLED.RSC ResourcefileforCLED.PRG PRINT.DRV Defaultprinterdriver. Fileextensionexpectedforgraphicfilesis.GRA.Theonlytimes thisprogramaccessesthediskare:atstartupwhenitloadsthe resourcefilesanddefaultprinterdriver,andwhenyouloadorsavea graphicfileorloadanewprinterdriver.Ifyounoticedisk accessesatanyothertimeBEWAREyoumayhaveavirusorTrojanHorse present. ê2 Input\Output. Ç 2.1 Input. Inputsongtitlesetc.usingthekeyboard.Pointsinthegraphic areplottedusingtheleftmousebuttonanderasedwiththeright button.Youmayswitchbetweenthedifferentwindowsbyclickingthe mouseonanypartofthewindowyouwishtobringtothetop. When usingthegraphicswindowthetoolboxontheleftofthescreen becomesactive.Clickonthearrowiconsinthetoolboxtoscrollthe image(withwraparound)inthegivendirection.Invertunplotsthe plottedsquaresandplotsunplotedsquares,mirrormirrorstheimage lefttoright.GraphicsmaybereadfromdiskbyselectingLOADfrom thediskmenu. 2.2 Output. Theonlyoutputsavailablearetodisk(Savingagraphic)ora printer(Printingthelabel). 2.2.1Saving  GraphicsaresavedtodiskbyselectingSAVEfromthediskmenu. Youwillthenbepromptedtochooseapath/filenamefromthe standardGEMfileselectorbox.Clickonorentertherequired filefromthekeyboardandpress<RETURN>orclickon'OK'tosave. Clickingon'CANCEL'willabortthesaveoperation. 2.2.2 PrintingLabels  Graphicsmaybeoutputtoadotmatrixprinterbyselecting 'PRINTLABEL'fromthePRINTmenu,andthenclickingonthevarious optionsintheprinterdialog.Unavailableoptions(basedon informationintheprinterdriver)cannotbeselected.Theoptions areallselfexplanatory.Intheprintdialogyoumayalsochange thestandardsidelabelsthatareprintedatthetopofthelabel, oneeithersideofthegraphic.Youmayedittheseasyouwould anyothereditabletextfield,<TAB>andthecursorup/downkeys Çmovesbetweenthefields,<ESC>erasesafield,<DEL>,<BS>andany otherkeysworkasnormal.  Ifthedefaultprinterdriver(PRINT.DRV)waspresentatload timeyoumaysimplyselect'PRINTLABEL'fromthemenubar,adjust theoptionsandprint.Ifthedefaultprinterdrivercouldntbe loadedforsomereason,ifitwasntpresentorhadanerror,you mustfirstloadacorrectdriver.Loadanewdriverbyselecting LOADSETUPfromthePRINTmenu,andchooseadriverwiththe standardfileselector. ♪④2.3 Screenlayout. Thescreenconsistsofthemenubaralongthetop,thegraphicsand textwindowsandthegraphicstoolbox.Boththewindowsandthe graphicstoolboxmaybemovedbyclickingintheirtitlebars, draggingthemousetothenewpositionandreleasingthebutton.The toolboxmayonlybemovedwhenthegraphicswindowisactive. 2.3.1 Themenubar  Selecting'ABOUTCLED'fromtheDESKmenubringsupadialogbox showingabriefintroductiontotheprogram,press<RETURN>or clickonthe'CLED'boxtoreturn.  TheFILEmenuallowsyoutoloadorsavegraphicsto/fromany attacheddiskdrive.Selectingeither'LOADGRAPHIC'or'SAVE GRAPHIC'bringsupthestandardfileselectorfromwhichyoushould selectthefile. Select'PRINTLABEL'fromthePRINTmenuwhen youwishtocommityourdesigntopaper.Adialogboxallowingyou tosetvariousprintingoptionswillthenbedisplayed.Selectthe colouryouwishtoprintinandthestyle,clickingon'PRINT'or hitting<RETURN>willstartthelabelprinting.Clicking'ABORT' willabandontheprint.Selecting'LOADSETUP'fromthePRINTmenu allowsyoutoloadanewprinterdriver.  Thetwooptions;GRAPHICandTEXTeitheropenorbringtothe toptheappropriatewindow.Awindowisopenedifitiscurrently closedortoppedifitisallreadyopen.  Twolevelsofhelpareavailable,bothareactivatedfromthe 'HELP'menu.'GENERALHELP'givesaguidetothemenubar functions,while'THISWINDOW'giveshelponthecurrenttopwindow (IfitbelongstoCLED). 2.3.2 TheWindows  Tochangetothegraphicortexteditingwindows,simplyclick onanexposedportionofthewindowtobringittothetop,or selecttheappropriatewindownamefromtheWINDOWmenu.Windows thathavebeenclosedmayalsobereopenedbyclickingonthe appropriatenameintheWINDOWmenu.Editing in the graphic is done with the mouse, theleftbutton plots a point, right erases a point. Songtitleeditingisstraightforward, simply enter the songtitles,spinelabelsetc.fromthe keyboard. Ç Special keysusedinthetextwindoware : <TAB> : Acts as return for side two <HELP> : Move cursor to top of side one. <UNDO> : Move cursor to top of side two. <INSERT> : Insert aspaceat thecurrent cursor location. <CLR HOME> : Clear screen. Arrow keys : Move the cursor. <DELETE> : Erase character under cursor and close up the space <BACKSPACE> : Erase the character to the left of cursor and close up space. Thespecial toolsusedinthegraphicswindoware : <INVERT> : Invert theimage. Arrow icons : Scrolltheimage,withwrap-around. <MIRROR>:Mirrortheimagelefttoright.  The window full size gadget(Toprightcornerofwindow) clears thewindow. ê3 Diagnosticsanderrors. Ç Atthisstageverylittleerrorcheckingiscarriedoutbythe program:bewarediskandprintererrors. 3.1 Diagnosticreports. Allerrormessagesareshownindialogboxes,thepossible messages,thebuttonsprovidedandthereasonforeacherrorareshown below: "Couldntopenthewindowtryclosingsomeothers" "OK" AmaximumofsixGEMwindowscanbeopenedatanyonetime.Ifyou trytoopenanotherwindowwiththemaximumnumberallreadyopened youwillrecievethismessage.Hit<RETURN>orclickon"OK"to acknowledgetheerror.Beforetryingtoopenthewindowagain closeanother,non-CLED,window. "PrinterNotReadyCheckpower,online,connectionsetc.""Retry" "Abort" Thismessagesappearsifyoutrytoprintandtheprinterisnot responding.Checkitisturnedon,switchedon-lineandconnected beforeretrying.Clickingon"Retry"checkstheprinteragain, "Abort"returnsyoutotheCLEDeditingwindowswithoutprinting. NOTE:Theprinterisnotcheckedduringtheprintrun,so switchingoffwhileprintingwillnotbedetected. ÇCLEDwillappearedtobepausedforaboutoneminute whileitcontinuestosendinformationtotheprinter. "Drivernotloaded,cantprint" "OK" Thiswarningindicatesthatavalidprinterdriverhasnotyetbeen loaded,youcanloadaprinterdriverbyselecting'LOADSETUP' fromthePRINTmenu. 3.2 Knownfaults. 1.This program does very little error checking, beware disk and printer errors. 2. Only High andMediumResolutionsare supported, high resolutionisstillbetter. 3. Windowupdatesareslow,sorrythisismycode,justbe patient(BetterstilluseQuickST).Ihavehadsomeproblems withthedeskaccessory'TINYTOOL'usedinconjunctionwith thisprogram(Idontthinktheyaremyfault). Ifyoufindanyproblemswithotherprogramsetc.pleaseinformme attheaboveaddressorleaveamessageonParagonBBS(09325-5160). Whenreportingbugsetc.pleasetellmeyourfullsystem configuration:yourcomputertype,memory,TOSversion,Blitterand anyresidentprograms(TSR's,deskaccessoriesetc.).Suggestionsfor improvementsetc.wouldalsobewelcomed.Sorrythatnosourcecode accompaniesthisprogram,butI'mnotquitereadytoshowmysickC codetotheworld.Ifyouwouldlikeacopyofthesourcecontactme. Çê4 Closingnotes. Ç 4.1 PRINTERS SUPPORTED ------------------------------------------------- Star NX-1000 CL ------------------------------------------------- If you writeaprinterdriverorfindanyotherprintersthatwork pleaseaddthem to this list, noting any restrictions,DIPswitch settings,specialcables/interfacesetc. 4.2 Copyright/Disclaimer THIS PROGRAM IS FREE AND MAY BE COPIED FREELYASLONGASITREMAINS COMPLETEANDUN-MODIFIEDANDALLACCOMPANYINGFILESAREALSOSUPPLIED. THEAUTHORACCEPTSNORESPONSIBILITYFORANYDAMAGESINCURREDASA RESULTOFTHISPRODUCT. 4.3 Plannedrevisions. Coming up(WhenIgetthetimeandinspiration) : V 1.? ¯¯¯¯¯ Better error checking. AbilitytoloadDEGASetc.files. Moregraphicstools(Linesetc.) Improvedprintersupport 4.4 Thanks. Duringthelongtimeithastakenformetowriteanddebugthis programmanypeoplehavehelpedme,myapologiesfornotmentioning anyonespecifically.ThankstoalltheguysontheParagonComputers BBSwhoregularlyansweredmysometimessillyquestions.Manythanks toJimCharltonfordistributinghissourcecodefortheXXEDfile editor,thishelpedunravelmanythings.ThankstoTimOrenforthe AnticOnlineProGemseriesofarticles.Alsothankstoallthe conversationalistsontheUSENETwhoboughtupmanyinteresting subjects. êAppendixA Ç 1. Intro. ---------- This appendix describes the format of the printer configuration files used by the cassette label editor program CLED. Use this document and thesample configuration file to create drivers for any printers you own. This document describes the configuration file for the current version (1.2) ofCLED. I make no guarantees that future versions will have compatible config files. However I see no reason why this configuration will change unless it turns out to have some major flaws or I add substantial new features. IfyoufindyoucannotconfigureCLEDtoworkwithyourprinter, pleasecontactme. 2. Syntax: ----------- Semicolon (;) marks beginning of a comment, rest of line ignored Hexidecimal numbers may be in upper or lower case,butmustbe precededbyadollarsign($). All commands are assumedtobedecimal(base10)unlessproceededbya dollarsign($)inwhichcasetheyareassumedtobein hexidecimal (base 16) Codes within each command are seperated by commas All spaces except within printer name are ignored. Printer name may not contain a semi colon. Trailing spaces are ignored. Blank lines are ignored. Colour commands arent listed for mono printers, likewise mode switch commands for draft only printers. Codes greater than hexidecimal 80 indicate a variable value, value sent is code - 80 + variable. Only used for line spacing. The graphics on command is followed by n1 n2 m1 m2.... where n1 and n2 are the high and low bytes of the number of points to follow and m1,m2... are the actual graphic bytes. The version number given in the ID string matches the version number of CLED that supports that format of file. CLED will NOT allow the use of a configuration file with a later version number than itself, but may be able to use older configurations. (Hey we gotta have progress!) Asyntaxerrorwillonlybegeneratedforunknowncharacters,ie.any nondigitsfordecimalmodeoranyanynon-hexdigits(a-f,A-F,0-9 allowable). Numbersmustbethreeorlesscharacters(including$prefix). Acommandmustconsistof80orlessseperatecommandnumbers. 3. Commands are in the following order: Ç---------------------------------------- 1. ID string (Magic word CLED, followed by a version number, no spaces) 2. Printer name (Max 40 chars) 3. Colour or mono (y=colour, n=mono) If colour { 3.1 Change to black 3.2 Change to red 3.3 Change to blue } 4. Set line spacing to n/216 of an inch 5. Set elite pitch, 12 CPI 6. Do we have NLQ (y=Yes, n=No) If NLQ { 6.1 Enter NLQ 6.2 Enter draft } 7. Underline on 8. Underline off 9. Enter 8 bit graphics mode, single density, (60 DPI) 10. Draw a solid vertical bar in the middle of a character cell (| char, often not solid on printer) 4. Valid version numbers. -------------------------- 1.2 - First version of CLED to offer printer config files. ÇAppendixB. Printers currently supported: ------------------------------ NAME: LIMITATIONS: ---------------------------------------------------------------------- STAR NX-1000 COLOUR Noneknown. ---------------------------------------------------------------------- If you write a printer driver, send me a copy of the file noting any limitations, dip switch settings etc. andIwilladdittothislist. Iwill also try and include the driver (With a note saying who wrote it!) inany future releases. Thanks.