home *** CD-ROM | disk | FTP | other *** search
/ Amiga ISO Collection / AmigaUtilCD2.iso / Programming / Basic / OTL-BBU3.DMS / in.adf / Andre / ReadMe < prev    next >
Encoding:
Text File  |  1994-04-04  |  6.3 KB  |  175 lines
  1. Well, dudes, here are some improved libs and some own crap...
  2. Have a look, hope there is somthing usefull...
  3.  
  4. Improved ones(Basic/):
  5.  
  6. - asllib:
  7.   - Pattern and title bug fixed
  8.   - PathRequest added, syntax:
  9.     ASLPathRequest$ Title$,Pathname$ [,x,y,w,h]
  10.  
  11. - fileiolib(changed by Zippo):
  12.   - No more write to an ReadFile
  13.   - Exists now recognize directories
  14.  
  15. - gtlib:
  16.   - A fistful bugs fixed, enforcer-hits removed
  17.   - SetAttrs added(OS 3.0) ; your routine, a little improved..., syntax:
  18.     GTGetAttrs (GTList#,id,Tag)
  19.   - Toggle flag for button-gadgets = $2000
  20.   - GTShape added, hope it works..., syntax:
  21.     GTShape GTList#,id,x,y,flags,Shape#[,Shape#]
  22.   - GTEnable added, need a redraw it windoe is active, syntax:
  23.     GTEnable GTList#,Id
  24.   - GTDisable added, need a redraw it windoe is active, syntax:
  25.     GTDisable GTList#,Id
  26.   - GTToggle added(for button-gadgets only), added, need a redraw it windoe is active, syntax:
  27.     GTToggle GTList#,Id [,On|Off]
  28.  
  29. - ilbmifflib:
  30.   - ILBMInfo returns now a value(True or False), no need for debuger, let the
  31.     user check it out...
  32.  
  33. - windowslib:
  34.   - WindowTags added, works like ScreenTags, syntax:
  35.     WindowTags Window#,Flags,Title$ [,&TagList] or [[,Tag,Data]...]
  36.  
  37.  
  38.  
  39. Own ones(UserLibs/):
  40.  
  41. - ConsoleLib(a little buggy yet):
  42.   - OpenConsole Window#,Console#
  43.     Open a CON: Port for the window, so ANSI output is possible.
  44.  
  45.   - PrintCon Console#,Expression
  46.     Write text to window-console.
  47.  
  48.   - NPrintCon Console#,Expression
  49.     Write text to window-console, and add a Linefeed.
  50.  
  51.   - CloseConsole Console#
  52.     Close the CON: Port, but NOT the window itself!
  53.  
  54.   Note:
  55.   These command work if you use them only for ONE window...
  56.   If you wanna use the CON's for more windows, so that object
  57.   are use it doesn' t work anymore...
  58.   Ya see, I need ya help, please...
  59.  
  60. - CrunchLib:
  61.   - Implode Error/CrunchedLen=Bufferadr,DataLen,?Callback
  62.     Crunch a buffer using the Imploder algorythm.
  63.     The ?Callback could be a 0 for no own routine or a pointer
  64.     to an own routine for display or abort checking.
  65.     If the Imploder command jump to the callback in register d0
  66.     the current crunch position is presend.
  67.     The callback itself have to return True for cont crunching
  68.     or False for a break!
  69.     The command return the crunched buffer len or of course a break
  70.     or an error.
  71.     If a <0 is returned the callback returned a userbreak,
  72.     a return of 0 means an error happens.
  73.     Else the new buffer len is returned.
  74.  
  75.   - Deplode Success=Startadr
  76.     Decrunch a Imploder-Crunched buffer.
  77.     There is no need to give the crunched buffer len to the command,
  78.     imploder handle this by itself.
  79.     But be careful, if the alloceted buffer hasn' t enought space
  80.     the program crash.
  81.     
  82.     The buffer has to have a header like this:
  83.  
  84.     Type  Offset  Contents                   Function
  85.     LONG  0       "IMP!"                     To recongnize crunched files
  86.     LONG  4       Original Len               Datalen before packing
  87.     LONG  8       Crunched Len-$32           Datalen after packing
  88.     
  89.     So $a is the start of the datas...
  90.  
  91.     The decrunch routine NEED this header to decrunch!!!
  92.     Do memoryallocation for the buffer using a allocate for the Startadr+$4
  93.     size.
  94.  
  95.   - CrMDecrunch Bufferadr [,Destinationadr]
  96.     If the only parameter is the Bufferadr this routine works like the Deplode
  97.     command, but decrunch a CrunchMania crunched file.
  98.     If you use it with to parameters the decrunch will be done from
  99.     Bufferadr to Destinationadr, so 2 buffers have to been allocated.
  100.     The header for CrunchMania files have to look like this:
  101.  
  102.     Type  Offset  Contents                   Function
  103.     LONG  0       "CrM!"/"CrM2"              To recongnize crunched files
  104.     WORD  4       Minimum Security Distance  To savely decrunch Data when
  105.                                              Source AND Dest is in the same Memoryblock
  106.     LONG  6       Original Len               Datalen before packing
  107.     LONG  10 ($a) Crunched Len               Datalen after packing without header
  108.  
  109.     So at $d is the data startadress.
  110.  
  111.     This header is NEEDED for decrunching!
  112.  
  113.   - PPDecrunch Bufferadr,Bufferend,Destinationadr
  114.     This command decrunch a PowerPacker crunched file.
  115.     PowerPacker need two buffers for decrunching.
  116.     Also the lenght of the buffer must be given!
  117.     Sorry, I can' t find my PowerPacker archive where the header is
  118.     descripted...
  119.     Like Imploder and CrunchMania PowerPacker also support his own
  120.     file header.
  121.     Please have a look at the PowerPacker(.library) documentation!
  122.  
  123. - LocaleLib:
  124.   - IsLocale
  125.     There is now way to check the ROM-Version of the Kickstart
  126.     for locale presents.
  127.     Both, OS 2.0 and 2.1 have the ROM-Version 37.175!
  128.     So the command returns if the locale.library exists on the system.
  129.  
  130.   - UseCatalog Catalogname
  131.     Opens the catalog for your programm.
  132.     Might by your program is called BB2Program the catalog should
  133.     be called BB2Program.catalog.
  134.     But you' re also able to open a catalog from an other program,
  135.     like Term.catalog.
  136.     The catalog files are in an IFF format!!!
  137.     Read the Commodore documentation of it...
  138.  
  139.   - FreeCatalog
  140.     Removes the catalog that you opened with UseCatalog.
  141.  
  142.   - GetLocaleStr #StringNumber,DefaultString$
  143.     Read a string from the catalog that you opened with UseCatalog.
  144.     You have to give a defaultstring to that command.
  145.     If the asked string could be find in the catalog the default
  146.     string will be returned.
  147.     Else the string from the catalog will be returned.
  148.  
  149. - PrtLib:
  150.   - PrtText String
  151.     The given String will be send to your printer.
  152.  
  153.   - Hardcopy Screen#,X,Y,Width,Height,PtrWidth,PrtHeight,Flags
  154.     Send an image to your printer.
  155.     
  156.   - PrtCommand Command,Para1,Para2,Para3,Para4
  157.     Sends a command to your printer.
  158.  
  159.   Note:
  160.   Please read the doc files for the PrtLib!!!
  161.  
  162. - RequestLib:
  163.   - EasyRequest Result=EasyRequest([#Window,]title$,body$,gtext$)
  164.     A intuition system requester will be open.
  165.     Optional you could give a window number.
  166.     The title$ is the displayed string in the top.
  167.     body$ is the displayed text in the requester, a Chr$(10)
  168.     means a linefeed.
  169.     gtext$ is the text for the gadgets.
  170.     Every gadgettext will be added by a '|'.
  171.     Examples:
  172.     "Ok" will only display one gadget in the requester.
  173.     "Ok|Cancel" add two gadgets to it.
  174.     "1|2|3|4|5" five gadgets are displayed.
  175.