File: README

package info (click to toggle)
mowitz 0.2.0-1
  • links: PTS
  • area: main
  • in suites: woody
  • size: 4,168 kB
  • ctags: 4,214
  • sloc: ansic: 30,869; sh: 9,051; makefile: 169
file content (153 lines) | stat: -rw-r--r-- 3,500 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
This is the Mowitz ("More widgets) library.

The project's goal is to create a library of widgets for X applications
to use. The widgets have been snarfed from various sources and are
all open source (GPL or MIT licenses).


Available widgets
-----------------

 - Animator
 - Canvas
 - Check
 - Combo
 - Frame
 - Handle
 - Html
 - Image
 - ListTree
 - Notebook
 - Richtext
 - Rudegrid
 - Ruler
 - Slider
 - Spinner
 - Tabbing
 - Table
 - Tabs
 - TextField
 - Tooltip
 - VSlider

And a complete menu kit.

The original reason for creating this library is that the Athena
widget set lacks a lot of widgets that would be useful, and many
of the existing widgets leave a lot to be desired in appearance
and behaviour.

Once upon a time there was a project called the Free Widget Foundation.
It started out with goals similar to those of Mowitz, but later
turned into a project to create a complete, standalone widget set.
That is not something that will happen here.


Namespace
---------

All external symbols are prefixed with "Mw" in order to avoid
name space clashes with other libraries. So for example, the
spinner widget is called MwSpinner.


Applications using Mowitz
-------------------------

Since most of these widgets were previously distributed with
Siag Office, it is natural that the upcoming release of that
package will use (and require) the Mowitz library.

Many existing X applications can be trivially updated to use
the widgets in the Mowitz library.


Utility routines
----------------

In addition to the widgets themselves, Mowitz includes several
utility functions that are used within the library, but useful
to application writers as well. The functionality includes:

 - Loading and caching pixmaps
 - Allocating and caching pixel values



Mowitz  la carte
-----------------

It is possible to pick and choose among the widgets within Mowitz.
Normally there is no reason to do so, but it can be a way to add
a single widget to an application without having to depend on
another library. It can also be a way to avoid licensing issues.

To do this, copy the MwUtils.c and MwUtils.h files to the application,
plus the files for the widget. All widgets use the routines in
MwUtils, so it must always be included.

Some widgets are subclassed from other widgets in the library. The
Handle widget, for example, is subclassed from Frame. In that case,
both widgets must be included.


Widget hierarchy
----------------

Names in brackets are Intrinsic widgets, not part of Mowitz.

[RectObj]
  |-BaseME
  |  |-LabelME
  |  |  |-CheckME
  |  |  |-MBButton
  |  |  `-SubME
  |  `-LineME
[Core]
  |-Base
  |  `-SButton
  |     `-Button
  |        `-MenuButton
  |-Canvas
  |-Check
  |-[Composite]
  |   |-Animator
  |   |-BaseComp
  |   |-[Constraint]
  |   |   |-BaseConst
  |   |   |   |-Row
  |   |   |   `-MenuBar
  |   |   |-Rudegrid
  |   |   |  `-Filesel
  |   |   `-Tabs
  |   |-Frame
  |   |  |-Combo
  |   |  |-Handle
  |   |  `-Spinner
  |   |-Richtext
  |   |-[Shell]
  |   |   `-[OverrideShell]
  |   |       |-Menu
  |   |       |-PopText
  |   |       `-Tooltip
  |   `-Table
  |-Image
  |-ListTree
  |-Notebook
  |-Ruler
  |-Slider
  |  `-VSlider
  |-Tabstop
  `-TextField


Authors
-------

Ondrejicka Stefan: Menus
Edward A. Falk: Frame, Ruler, Slider, VSlider, Tabs
Robert W. McMullen: ListTree, TextField
Ulric Eriksson: Animator, Canvas, Check, Combo, Filesel,
		Handle, Image, Notebook, Richtext,
		Rudegrid, Spinner, Tabbing, Table, Tabs, Tabstop, Tooltip