WINGs/README

   1
   2                       WINGs - WINGs Is Not GNUstep
   3
   4                                    by
   5
   6                           Alfredo Kengi Kojima
   7
   8                           kojima@windowmaker.org
   9
  10
  11    WINGs is a small widget set with the N*XTSTEP look and feel. It's API
  12 is inspired in OpenStep and it's implementation borrows some ideas
  13 from Tk. It has a reasonable set of widgets, sufficient for building
  14 small applications (like a CDPlayer or hacking something like rxvt). It
  15 also has other functions that are usefull for applications, like a
  16 User Defaults like configuration manager and a notification system.
  17
  18    The library is limited and it's design is a little sloppy,
  19 so it's not intended to build large or complex applications, like
  20 anything more complex than a CDPlayer. GNUstep should be used for such
  21 applications.
  22
  23    Since WINGs is written in C and is sort of low-level it is small
  24 and faster than say, Motif or even Athena. Knowing Xlib will help you to
  25 workaround some of it's limitations, although you'll probably be able to
  26 write something like a trivial tic-tac-toe game without knowing much Xlib.
  27
  28    Some of it's functions are designed to support the Window Maker window
  29 manager (see http://windowmaker.org) In fact, it's primary role is to
  30 support Window Maker. All other uses of it are just an added bonus.
  31
  32    It will help you to understand the API if you read the ApplicationKit
  33 reference manual, distributed as a PDF by Apple. The function names,
  34 structs and most of the intrinsics are very close to OpenStep classes.
  35
  36
  37 Internationalization:
  38 ---------------------
  39
  40     Change ~/GNUstep/Defaults/WMGLOBAL to set the desired font set and
  41 set MultiByteText = YES; to enable support for multibyte text.
  42
  43
  44 Widgets provided by WINGs:
  45 --------------------------
  46
  47 - button (command button, radio, switch etc. - all buttons defined in OpenStep)
  48 - label
  49 - textfield
  50 - frame
  51 - window
  52 - popup menu button
  53 - scroller
  54 - selection list
  55 - browser
  56 - slider
  57 - scrollable view
  58 - color well
  59 - split view (only 2 subviews)
  60 - tabbed view
  61 - progress indicator
  62
  63 - input box
  64 - file panel
  65 - color panel
  66 - alert panel
  67
  68 Planned:
  69 --------
  70
  71 - selection (pasteboard like)
  72 - drag&drop
  73
  74 If you think you can code the following, please do. They are needed by
  75 WPrefs.app, but the number of other things I have to do is huge.
  76
  77 - font panel (the UI part is done. Might require a rewrite of the font list
  78   retrievel code. Might also require a WMFontManager)
  79 - input method support (XIM). I have no idea of how to code it. People who use
  80 different characters than ASCII will have trouble editing menus without it...
  81
  82
  83 Wish list: (I don't have the know-how or time to do them)
  84 ---------------------------------------------------------
  85
  86 - text (with support for RTF)
  87 - matrix (like NSMatrix)
  88 - splitviews with more than 2 subviews
  89 - font manager (like NSFontManager)
  90 - finish other wigets
  91 - optimize list scrolling (XCopyArea() the area that's already drawn)
  92 - InterfaceMaker?
  93 - use XSetWMName and XSetWMIconName for the window/icon title setting.
  94   This requires transforming the received text to a text property with
  95   the proper encoding.
  96
  97 Copyright
  98 ---------
  99
 100 WINGs is copyright (c) Alfredo K. Kojima and is licensed through the GNU
 101 Library General Public License (LGPL).
 102