home *** CD-ROM | disk | FTP | other *** search
/ Amiga ISO Collection / AmigaUtilCD2.iso / Workbench / Libs / GADUTIL.LHA / GadUtil / Docs / GUtilInfo.txt < prev    next >
Encoding:
Text File  |  1995-08-30  |  7.5 KB  |  161 lines
  1.                             GadUtil.library v36.52
  2.                             ~~~~~~~~~~~~~~~~~~~~~~
  3.     GadUtil is another gui library which main goal was to make it easy to
  4.     create font sensitive user interfaces. The library has grown away from
  5.     this main goal, and become another useful-routine-library.
  6.  
  7.   ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  8.     Distribution:
  9.  
  10.         1) Distribution of this library is allowed in two ways:
  11.              ¹) Only the .library file
  12.              ²) The complete distribution
  13.  
  14.         2) Programmers of totally free software can use and distribute this
  15.           library for free.
  16.  
  17.         3) Programmers of Shareware, Licensware, commercial products and other
  18.            programs that the programmer get any kind of profit from shall send
  19.            a fully working (and registered) copy of the program and its docs to
  20.            us. All larger updates of the program should also be sent to us.
  21.           
  22.         4) Programmers of non-free software not covered by 1) and 2) (my Diskware
  23.            concept belongs to this group) shall be treated as in 3) (a fully
  24.            working and registered copy...).
  25.  
  26.         5) All programs (except commercial products in some cases) must state
  27.            that gadutil.library is used. This may be done in either the About
  28.            requester or in the documentation, but best of all in both places.
  29.  
  30.            Demonstration programs for gadutil.library (that includes the full
  31.            source) may be distributed without this note.
  32.  
  33.            Example for inclusion in About requester:
  34.  
  35.                 "This program uses gadutil.library, which
  36.                  is Copyright © 1994-1995 by P-O Yliniemi
  37.                  and Staffan Hämälä."
  38.  
  39.         6) All localized programs that uses this library should include the
  40.            .ct file(s) to allow anyone to translate that program into their
  41.            own language.
  42.  
  43.  
  44.   ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  45.     Below is a list of some of the main functions covered by this library.
  46.  
  47.     * FAST (NO OR VERY SMALL DIFFERENCE AGAINST GADTOOLS) AND SMALL (LESS THAN 10k).
  48.       WRITTEN IN ASSEMBLY LANGUAGE. NO F*CKING 'C' or any other slow language!
  49.  
  50.     * Font adaptive. Use any of the system fonts and most other fonts for
  51.       gadgets, texts and menus. All gadgets are placed relative to each
  52.       other, but can be placed at absolute positions (needed for the first
  53.       gadget).
  54.  
  55.     * No need to use GIMMEZEROZERO windows, as this is automatically handled
  56.       by the library. If you specify a gadget position of 10,10 the gadget
  57.       will be placed at 10,10 within the window's border.
  58.  
  59.     * Localized. It is really easy to localize all your (new) programs by
  60.       using this library. Functions and macros for creating localized menus
  61.       are supplied.
  62.  
  63.     * Both assembly and 'C' language support. This is one of the things that is
  64.       missing in most of the other gui libraries. Some extra macros are defined
  65.       for assembly language users, and will make the gadget and menu creating
  66.       process even more easy.
  67.  
  68.     * All GadTools gadgets are supported. Some extra functions are provided
  69.       for ListViews. BUTTON_KIND (and IMAGE_KIND) gadgets have some extra tags,
  70.       including a toggle-select option.
  71.  
  72.       4 extended gadget types are handled by the library:
  73.     
  74.         · FILE_KIND     - gadget for selecting a file.
  75.  
  76.         · DRAWER_KIND   - gadget for selecting a drawer. Most programs also
  77.                          use this gadget for file selection.
  78.  
  79.         · IMAGE_KIND    - uses an intuition image for the gadget. Can use
  80.                           different images for selected and non-selected state.
  81.  
  82.         · BEVELBOX_KIND - gadtools bevelboxes, with some extensions. All
  83.                           gadtools bevelboxes are supported (even with v37).
  84.                           Extensions allows text to be placed above, in or below
  85.                           the upper line of the box. All kinds can be inverted.
  86.  
  87.                           New for v36.52: Bevelbox text placement extended.
  88.                           3 new placements available together with the old
  89.                           ones: centered, left adjusted & right adjusted.
  90.  
  91.                           BFT_BUTTON   - GT v37 BUTTON_KIND border
  92.                           BFT_RIDGE    - GT v37 STRING_KIND border
  93.                           BFT_DROPBOX  - GT v39 BBFT_ICONDROPBOX border
  94.                           BFT_HORIZBAR - A horizontal shadowed line
  95.                           BFT_VERTBAR  - A vertical shadowed line
  96.  
  97.                           This makes it a total of 100 bevel box types. The bevel
  98.                           boxes are treated as gadgets by the library, and you
  99.                           can obtain the structure for the bevelbox in the same
  100.                           way as you get the gadget pointer.
  101.  
  102.     * A new OpenFont (graphics.library and diskfont.library replacement) is supplied.
  103.       This function will open any font (from RAM, ROM or load it from disk).
  104.  
  105.     * Functions for listviews include adding nodes (memory for the string is
  106.       allocated by the function), counting nodes, getting node pointers, clearing
  107.       a listview, attach and detach lists, moving nodes up and down.
  108.  
  109.     * No need to open gadtools.library anymore, since all gadtools functions are
  110.       provided through this library. Some (the most useable) functions from locale
  111.       library are also provided by gadutil.
  112.  
  113.     * Many libraries are opened through gadutil.library, and these library bases
  114.       are available for your own use (you don't have to open or close some libs).
  115.  
  116.     * All gadgets are created using tag lists. Every next gadget will use the
  117.       previous gadgets values as defaults. Only one call to the gadget making
  118.       routine is needed for every gadget list.
  119.  
  120.     * All gadgets can have their own hotkey. No extra work is needed by the
  121.       programmer (only one extra tag).
  122.  
  123.     * Distributed with lots of examples, mostly in assembly language, but also
  124.       in 'C'.
  125.  
  126.     * Other functions include:
  127.  
  128.         · Status change for toggle select buttons.
  129.  
  130.         · String change for STRING and TEXT_KIND gadgets.
  131.  
  132.         · Disable functions for gadgets that support the GA_Disabled tag.
  133.  
  134.         · Routines to set up a busy-pointer (available for both v37 and v39). These
  135.           routines also blocks the input to the main window of the program.
  136.  
  137.         · Routine to check if the mouse pointer is within a gadgets box. Useful
  138.           for mouse-position sensitive appwindows.
  139.  
  140.         · Bevelbox and window refreshing functions.
  141.  
  142.     * FAST (NO OR VERY SMALL DIFFERENCE AGAINST GADTOOLS) AND SMALL (LESS THAN 10k).
  143.       WRITTEN IN ASSEMBLY LANGUAGE. NO F*CKING 'C' or any other slow language!
  144.  
  145.  
  146.   ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  147.   ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  148.         Per-Olof Yliniemi                           Staffan Hämälä
  149.         Muoniovaara                                 Pellovägen 268
  150.         S-980 64 Muodoslompolo                      S-957 93 Pello
  151.         SWEDEN                                      SWEDEN
  152.  
  153.         email:                                      email:
  154.           P-O_Yliniemi@spectre.talshiar.pp.se         < no address for now >
  155.  
  156.         Don't send programs through e-mail, since I have no way to regulary check
  157.         my mail!
  158.  
  159.   ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  160.   ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  161.