"SfR Fresh" - the SfR Freeware/Shareware Archive

Member "WindowMaker-0.92.0/WINGs/README" of archive WindowMaker-0.92.0.tar.gz:


As a special service "SfR Fresh" has tried to format the requested source page into HTML format using source code syntax highlighting with prefixed line numbers. Alternatively you can here view or download the uninterpreted source code file. That can be also achieved for any archive member file by clicking within an archive contents listing on the first character of the file(path) respectively on the according byte size field.
    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 alike 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
   60 - tabbed view
   61 - progress indicator
   62 
   63 - selection (make pasteboard like?)
   64 - drag&drop
   65 
   66 - input box
   67 - file panel
   68 - color panel
   69 - alert panel 
   70 - font panel
   71 
   72 If you think you can code the following, please do. They are needed by
   73 WPrefs.app, but the number of other things I have to do is huge.
   74 
   75 - input method support (XIM). I have no idea of how to code it. People who use
   76 different characters than ASCII will have trouble editing menus without it...
   77 
   78 
   79 Wish list: (I don't have the know-how or time to do them)
   80 ---------------------------------------------------------
   81 
   82 - text (with support for RTF)
   83 - matrix (like NSMatrix)
   84 - font manager (like NSFontManager)
   85 - finish other wigets
   86 - optimize list scrolling (XCopyArea() the area that's already drawn)
   87 - InterfaceMaker?
   88 - use XSetWMName and XSetWMIconName for the window/icon title setting.
   89   This requires transforming the received text to a text property with
   90   the proper encoding.
   91 
   92 Copyright
   93 ---------
   94 
   95 WINGs is copyright (c) Alfredo K. Kojima and is licensed through the GNU
   96 Library General Public License (LGPL).
   97