TUMULT

IntroductionNewsThe listClass descriptionsRegistrationResourcesGalleryFeedback

Class descriptions

BetterString.mcc

Description

BetterString is a stringgadget replacement. It is created for MUI so using it should eliminate the problems with the original BOOPSI stringclass.
The class offers several new features such as filename completion, number arithmetic, clipboard support etc.

Used in the following programs

YAM


Cardgame.mcc

Description

Cardgame class easily allows you to create a cardgame. You define and position some piles on the playfield. You can put cards on these piles and the player moves them from one pile to another. You will be notified of these drag'n'drop operations and you can decide if they are legal or not. You need to subclass Cardgame.mcc and override the appropriate methods to control gameplay.

Used in the following programs

Soliton


ColorButton.mcc

Description

ColorButton is a GadTools-like palette gadget that allows you to choose a color from a given set (usually the screen palette).
MUI usually handles color selection in a more abstract way, but then someone might need to do things as they used to be.

Used in the following programs

MagicASL


ColorSlider.mcc

Description

ColorSlider is a slider which displays its value as two raised to the real MUIA_Numeric_Value. Bigger values are abbreviated with standard suffixes such as 'K' for thousands and 'M' for millions.
This class is especially useful for representing a screen depth as an easier-to-understand number of colors, hence the name.

Used in the following programs

MagicASL


DataList.mcc

Description

DataList.mcc is a subclass of list class which provides easy support for sorting, pattern-match searching, multiple columns and bounded data. You can "attach" other GUI objects to the fields of the DataList. Data entered into those fields may be added to the list with a single method call. This class allows you to set up a list with full add, edit and delete capabilities in a few minutes. Just create your window as usual then attach objects to list fields with the MUIM_DataList_Attach method.

Used in the following programs

OOGABOOGA


Date.mcc

Description

Date is an abstract Custom Class of the Magic User Interface (c) by Stefan Stuntz. It's a subclass of notify-class and only usable for developers who want to build subclasses of Date.mcc!
The idea of this class was born during developing my Gregor application.
MUI abstract public custom class allowing easy handling of dates. Because it is abstract it is only usefull for developers who are working with classes that are based on Date.mcc (like DateString.mcc), or who want to build their own classes based on Date.mcc.
Date.mcc features:
- Handles years from 8 to 8000
- Supports the Gregorian calendar reform
- Supports MUIM_Import and MUIM_Export
- Supports drops of other date objects and date-strings
- A week can begin with any weekday
- The date can be read as day/month/year format or as JD or MJD
- The date range can be restricted
- Method to set the current date
- Methods for increasing and decreasing the date
- Method to compare with another date object

Used in the following programs

DateString.mcc, DateText.mcc, MonthNavigator.mcc


DateString.mcc

Description

DateString is a Custom Class of the Magic User Interface (c) by Stefan Stuntz. It's a subclass of string-class and date-class.
The idea of this class was born during developing my Gregor application.
MUI public custom class displaying a string gadget for date strings. The display format of the date string can be freely defined. An input string can be parsed by the given format string (see below), or in over 40 known formats.

DateString.mcc features that are of interest for users:
- Handles years from 8 to 8000
- Supports the Gregorian calendar reform
- Supports 21 languages
- Supports drops of other date objects and date-strings
- Can be dragged around
- A week can begin with any weekday
- Supports various string formats via template
- Can autodetect over 40 date-string formats

DateString.mcc features of interest for developers:
- Based on Date.mcc
- Supports MUIM_Import and MUIM_Export
- The date can be read as day/month/year format or as JD or MJD
- The date range can be restricted
- Method to set the current date
- Methods for increasing and decreasing the date
- Method to compare with another date object


DateText.mcc

Description

DateText is a Custom Class of the Magic User Interface (c) by Stefan Stuntz. It's a subclass of string-class and date-class.
The idea of this class was born during developing my Gregor application.
MUI public custom class displaying a text gadget for date strings. The display format of the date string can be freely defined.

DateText.mcc features that are of interest for users:
- Handles years from 8 to 8000
- Supports the Gregorian calendar reform
- Supports 21 languages
- Can be dragged around
- A week can begin with any weekday
- Supports various string formats

DateText.mcc features of interest for developers:
- Based on Date.mcc
- Supports MUIM_Import and MUIM_Export
- The date can be read as day/month/year format or as JD or MJD
- The date range can be restricted
- Method to set the current date
- Methods for increasing and decreasing the date
- Method to compare with another date object


Envelope.mcc

Description

This is a custom MUI gadget for editing envelopes as used by various MIDI synthesizers.

Used in the following programs

Apache


FileList.mcc

Description

MUI's Dirlist didn't suit all my needs, so I wrote this replacement: FileList is basically a clone of Dirlist, but with some more methods.
Some Dirlist attributes I don't need have not been reimplemented yet. The missing attributes are: SortHighLow.
This class is *not* intended to replace ASL in your applications! Only MagicASL can use it for that purpose. ;)

Used in the following programs

MagicASL


FontDisplay.mcc

Description

FontDisplay shows a given font's appearance. You can set font name, size and style, and you can change foreground and background pens.
A simple Text object wasn't enough because MUIA_Font is [I.G].

Used in the following programs

MagicASL


FontList.mcc

Description

FontList displays a list of available fonts. It can control a numeric list (see NumericList.mcc) for displaying available font sizes.
Traditional MUI applications don't have to bother about fonts, but then someone might need to render things in an user-chosen font. What about a MUI word processor, for example?

Used in the following programs

MagicASL


GLArea.mcc

Description

GLArea let you integrate OpenGL (via StormMesa libraries) renderings in your MUI. V 0.9 fixes some major bugs.

Used in the following programs

VRMLEditor V0.7+, VRMLViewer V0.6+


Guigfx.mcc

Description

Guigfx.mcc can display image data from four different sources: - files - guigfx.library pictures - bitmaps - Intuition images It does the pen remapping and dithering for different displays and can scale the image.

Used in the following programs

MRQ


HexEdit.mcc

Description

This class provides you with an easy way to present hexadecimal dump of a memory region to the user. Additionally, memory contents are visible in ASCII representation. Editing in both modes is possible. HexEdit class is very flexible, with many settable parameters and some critical methods (like byte reading and writing) waiting to be overloaded.

Used in the following programs

DeDe


HotkeyString.mcc

Description

HotkeyString is a subclass of BetterString.mcc. It overloads the input method, and converts inputevents to the alphabetical representation. This is useful when you allow the user to customize keybindings.

Used in the following programs

TextEditor.mcp


HTMLtext.mcc

Description

The HTMLtext Class is a custom class for MUI that is used to display a subset of HTML 3.2 (Hypertext Markup Language). You may use it in occassions like you used the TextObject or FloattextObject. You may also use it as base of an hypertext browser or HTML editor.
The development of this class has been stopped, but the source is freely available. You can download it by pressing here.

Used in the following programs

moreHTML


HTMLview.mcc

Description

HTMLview is a MUI class that will load, parse and display HTML formatted text.
The class supports most of the HTML 4.0 standard as defined by W3C, it is infact often more accurate than most browsers.
It is very well suited for mail programs or similar, which just wants to display HTML fast, and the class really is fast, I have still not seen anything like it :-)

Used in the following programs

IProbe


ImageDB.mcc

Description

Load images in a custom database (via guigfx.library). Ideal to load textures for GLArea.mcc (StormMesa).


InfoText.mcc

Description

This is simply a subclass of Text.mui which features a fancy border and some timeout-abilities. This is especially useful for a class such as Toolbar.mcc, but can also be used for other purposes.

Used in the following programs

IProbe


IPC.mcc

Description

IPC.mcc is a class that allows several objects to share the same message port. This is useful because each port takes up a signalbit, and there is only a limited amount of these bits pr. application.

Used in the following programs

IProbe


LEDGauge.mcc

Description

LEDGauge.mcc is a small MUI Custom Class that displays a gauge composed of a row of HiFi equalizer-like LEDs. The colors, width and spacing of the LEDs can be controlled by the user via the MUI Prefs program, using an external MCP. The class can be used for VU-meter displays in music players, or just as a normal gauge.


Mailtext.mcc

Description

The Mailtext MUI custom class package is especially designed to display electronic messages. Its main features cover:
- Handling of font attributes: *bold*, /italics/, _underline_ and #coloured#. The text between the attribute characters '*', '/', '_' and '#' will be printed with the repective style. To accomplish this, Mailtext has a powerful analysis engine which is aware of many special cases so best results can be obtained. Also, processing can be switched off for certain textpassages, i.e. uuencoded binaries, signatures, PGP messages.
- Highlighting of quoted textpasses: Mailtext is able to display up to five levels of quoted text in different colours. Quotes are recognized by specifying the quote characters that may be used to introduce a quoted textpassage. The most common quote character is '>'.
- Highlighting and handling of URLs: Uniform Resource Locators (URLs) may be highlighted. Also, an AmigaDOS command can be triggered whenever an URL is double clicked with the clicked URL as an argument. By using an ARexx script you could forward http:// URLs to your webbrowser, mailto: URLs back to your Mailer and ftp:// URLs to your FTP client. Mailtext supports all URL types specified in RFC 1738 "Uniform Resource Locators", Section 3.

Used in the following programs

FFNews II, GoodNews, IntuiNews, MUIReaderX, PINT


MathString.mcc

Description

MathString is a subclass of the String class that adds mathematical abilities to its superclass.
A MathString object can accept complex floating-point expressions, including algebraic operators, functions, and measuring units. The application only receives the value of the expression, while all the calculations are performed by the class.
MathString supports custom measuring units, custom functions, custom constants, single- or double-precision IEEE and FFP modes, automatic error handling, several built-in measuring systems and more.


Mesa.mcc

Description

This Custom Class allows to use OpenGL graphics in MUI applications. Currently only AmigaMesaRTL implementation is supported.

Used in the following programs

Framsticks - Artificial Life Simulator


MimeEditor.mcc

Description

MimeEditor.mcc is a class for dealing with MIME messages. It is a subclass of group.mui.

Used in the following programs

IProbe


MonthNavigator.mcc

Description

MonthNavigator is a Custom Class of the Magic User Interface by Stefan Stuntz. It is a subclass of group-class. The idea of this class was born during developing my Gregor application.
MUI public custom class showing a field with the days of a specified month in a specified year. The user decides if the names of the weekdays and the weeknumbers will be shown. Also it is possible for the user to set which weekday should be the day on which a week was started - the language for the weekday names can also be chosen. A special feature of this class is, that it correctly handles October 1582. In this month the days 5-14 didn't exist, because they were removed by the Gregorian calendar reform. This calendar reform happens in different years for different countries, so the user can set his country with the user preferences.

Users can change the display of MonthNavigator with the following features:
- Show/Hide names of the weekdays
- Select name of weekday with which a week starts
- Select the language to use for the names of weekdays (out of 21)
- Show/Hide weeknumbers
- Select the country for the Gregorian calendar reform (unusable as long as the date.library has not fully implemented this feature)
- Set the distance between the day-field and the names of weekdays/weeknumbers
- Fix the day-field to 6 rows
- Use frames for day-fields
- Show/Hide unused day-fields
- Display the last/first days of the previous/next month within the unused day-fields.
- Define how days of the previous/next month should be highlighted.
- Define how the internal 'mark today' hook should highlight today.

MonthNavigator supports also the following features which might be of interest for developers:
- Based on Date.mcc
- Dropping a date-object onto a MonthNavigator will set this date as the actual one
- Objects can be dropped onto the days
- Days can be dragged around
- Days can be marked by changing the following attributes:
* MUIA_Text_PreParse
* MUIA_Background
* MUI_ShortHelp
* MUIA_Disabled
- Supporting MUIM_Import and MUIM_Export
- Dates can be correctly selected from 0008-01-01 to 8000-12-31 by using the DateLib (TM)
The MonthNavigator also supports three input modes: read-only, relverify and the immediate mode.

Used in the following programs

MailDemon, MUITime


NewListTree.mcc

Description

New listtree class. Alpha state, public source.


NListtree.mcc

Description

NListtree.mcc provides you with an easy way of displaying list entries in a sorted form, a so called tree-structure. NListtree is easy to use and easy to convert from Listtree.mcc ((c) Klaus Melchior) which was not updated a long time. So far as implemented by the programmer and needfull in the application environment, this class allows the fully free recreation of the list using drag&drop with support of multiselection.
First time in a list tree class it is possible to move complete structures. That means, that the complete tree of the moved entry, back to the root-list, is recreated at the destination if the programmer allows this. The same for copying entries, which is also implemented.


NumericList.mcc

Description

NumericList displays a list of LONG values.

Used in the following programs

MagicASL


NumericString.mcc

Description

MUI's String class allows you to get and set its contents as a LONG, but that's it: you don't have a real numeric string gadget that takes input validation upon itself, and maybe offers some additional useful services.
On the other side, there are at least three numeric input classes available in MUI, but some applications could need a traditional string gadget because the acceptable range of input values doesn't fit well in the limits of a slider or a knob.
NumericString is a subclass of Group class which features a string and two arrow buttons for incrementing/decrementing the numeric value, like other platforms' numeric strings have.
This class understands almost all String attributes plus some Numeric attributes and methods that let it behave like a real numeric string object should. This autodoc covers methods and attributes inherited from Numeric class and String attributes whose behaviour is changed. Please refer to the String class autodoc for additional attributes.

Used in the following programs

MagicASL


Pkb.mcc

Description

This MUI class is aimed towards music applications. It shows a piano keyboard, like DeLuxe Music Construction Set, which provided inspiration for this. It handles a maximum of 11 octaves and includes some special features. A preferences module is also provided to edit colours of keys in different modes.

Used in the following programs

PianoPlayer


Popmenu.mcc

Description

This class handles fully configurable popup-menus and was created as a substitute for MUI's built-in menus. You'll be able to see the class in action, whenever MUI 3.9 is released...


Popplaceholder.mcc

Description

Popplaceholder class is a simple but useful class ;) Most applications are fully configurable nowadays, offering wide range of various parameters for further user modifications. Not only functions options or forms of behaviour are configurable but often most of program strings can now be changed by the user. The latter applies to internet (communication) related programs mostly, (e.g. AmIRC, AmTelnet, YAM and so on...) which needs to send various string to other different people. So they allow you to define e.g. own welcome phrase or kick reason sentence. Because e.g. your welcome phrase for e.g. John and phrase for Mary will differ only with the name, most of these strings uses so called placeholders, to describe varable, dynamically modified string part (e.g. mentioned receipient name). For example "On %d, %u wrote:". The "%d" and "%u" ares just the placeholders, program will replace on use by for instance mail date and the sender's name (of course placeholder can look like "@name" or "%{date}" or "my lovely grandma", but the idea behind remains).

Used in the following programs

AmIRC, AmTelnet, OpenURL, Voyager


SpeedBar.mcc

Description

SpeedBar.mcc and SpeedButton.mcc allow you to easily create toolbars similar to those you can see in Windows programs (although you can get a standard look as well ;)

Used in the following programs

Contact Manager, MetalWEB 4, mFTP II, STFax 4.x, V


TableGroup.mcc

Description

This mui custom class offers a table like layout with the possibility to join cells as known from HTML tables. It has a more logical order of placing its childs than the original group class of MUI has. That means that the row groups realized by TableGroup.mcc are filled from top to bottom and from left to right. This class was created to allow several independent parts of a program to add their childs to one table group so that it appear as it would be made of one piece. For example you are able to build a column group with a horizontal bar but with the same column alignment of the upper and the lower part.

Used in the following programs

some unreleased projects


TearOffBay.mcc

Description

Companion class for TearOffPanel.


TearOffPanel.mcc

Description

This class is a movable MUI group. Group can be dragged with mouse and even torn off from its parent, becoming a separate window.


TextEditor.mcc

Description

TextEditor.mcc is a fast multiline stringgadget. It can hold quite large texts without noticeable slowdowns. It supports the clipboard, it can show text with different styles, alignments and colors. It can hold separators, it has multilevel undo/redo and it can easily be configured to use an external spell checker for type'n'spell and word guessing.

Used in the following programs

YAM


Time.mcc

Description

Time is an abstract Custom Class of the Magic User Interface (c) by Stefan Stuntz. It's a subclass of notify-class and only usable for developers who want to build subclasses of Time.mcc!
The idea of this class was born during developing my Gregor application.
MUI abstract public custom class that allowing easy handling of time. Because it is abstract it is only usefull for developers working with classes that are based on Time.mcc (like TimeString.mcc), or those who want to build their own Time.mcc based classes.

Time.mcc features:
- Handles daylight savings time
- Handles time zones
- Supports MUIM_Import and MUIM_Export
- Supports drops of other time objects and time-strings
- The time can be read in hour/minutes/seconds format or as seconds from midnight on
- The time range can be restricted
- It's possible to notify a Date.mcc object when the next or previous day was reached
- Method to set the current time
- Methods for increasing and decreasing the time
- Method to compare with another time object

Used in the following programs

TimeString.mcc, TimeText.mcc


TimeString.mcc

Description

TimeString is a Custom Class of the Magic User Interface (c) by Stefan Stuntz. It's a subclass of string-class and time-class.
The idea of this class was born during developing my Gregor application.
TimeString is a MUI public custom class that displays a string gadget for time strings. The display format of the time string can be freely defined. An input string can be parsed by the given format string, or in various standard formates.

TimeString.mcc features that are of interest for users:
- Can be dragged around
- Accepts drops of other Time.mcc objects and time-strings
- Handles daylight savings time
- Handles time zones
- Supports 12h and 24h clocks
- Supports various string formats

TimeString.mcc features of interest for developers:
- Based on Time.mcc
- Supports MUIM_Import and MUIM_Export
- The time can be read in hour/minutes/seconds format or as seconds from midnight on
- The time range can be restricted - so the user can only input time that lies within his/her working time
- It's possible to notify a Date.mcc object when the next or previous day was reached
- Method to set the current time
- Methods for increasing and decreasing the time
- Method to compare with another time object


TimeText.mcc

Description

TimeText is a Custom Class of the Magic User Interface (c) by Stefan Stuntz. It's a subclass of text-class and time-class.
The idea of this class was born during developing my Gregor application.
MUI public custom class that displaying a text gadget for time strings. The display format of the time string can be freely defined.

TimeText.mcc features that are of interest for users:
- Can be dragged around
- Handles daylight savings time
- Handles time zones
- Supports 12h and 24h clocks
- Supports various string formats

TimeText.mcc features of interest for developers:
- Based on Time.mcc
- Supports MUIM_Import and MUIM_Export
- The time can be read in hour/minutes/seconds format or as seconds from midnight on
- The time range can be restricted
- It's possible to notify a Date.mcc object when the next or previous day was reached
- Method to set the current time
- Methods for increasing and decreasing the time
- Method to compare with another time object


TipOfTheDay.mcc

Description

Many programs on other operating systems often offer so called "Tip of the day" stickers. It's mostly a small window opened on program startup, showing valuable (more or less) information about the program, some useful information, keyboard shortcuts or just neat tips or quick how-to solutions...
I think, that from the user's point of view it's good idea to have such a feature, especially if the tips can be turned off if you felt bored. As you probably guessed, this class is supposed to handle such tips for your MUI based application almost in a fully automatic manner (you only need to add 3 lines of code to have a fully functional Tip Of The Day implemented). See the enclosed demonstration for more details.


TipOfTheDay.mcc

Description

Anyone who has ever used a piece of windows software will surely have come accross that damn tip of the day window that never gives you a really good tip. Well, here's the MUI version! A subclass of Group, any programmer using MUI can give his/her users a quick handy tip on how to use the software that he/her beholds. Easy to implement, easy to add loads of tips. Crackin' stuff!.

Used in the following programs

aMozillaX


Toolbar.mcc

Description

The toolbar custom class supplies an easy way of implementing a toolbar in your programs. It features a multitude of different settings and the majority of these are configurable for the user via the MUI preferences system.
The class is distributed as Polymorph-ware. Please read the docs for more information about this concept.

Used in the following programs

IProbe, MimeEditor.mcc, YAM


TransferAnim.mcc

Description

The TransferAnim mcc is a class to display progress-, busy- or wait-animations within your graphical interface. It can handle most transferanimation formats as known from browsers, it can be set to display the animation normal, scaled or repeated.
The user has also the option to choose a default animation from the MUI prefs as well as remapping precision and whether to play always, when the window is active or never. Also transparent animations are now supported.

Used in the following programs

BlackIRC


TreeList.mcc

Description

TreeList.mcc is a subclass of list class which provides an easy-to-use hierarchical listview.
The development of this class has been stopped, but if you follow this link then you can find the sources.



TWFmultiLED.mcc

Description

This class is a fairly simple implementation of a "LED-like" indicator which provides the programmer with a new method for communicating program state to the user. Unlike other implementations, TWFmultiLED allows both the user and programmer to specify both the shape of the indicator and it's colour.
The user can specify the RGB makeup of the 10 internal colours, the default shape of the indicator and the default "turn off" period using the class preferences. The programmer can abide by the user's choice of shape and turn off period, or override them. The programmer can also set the indicator to any of the 10 user defined colours or to a custom colour the programmer specifies.

Used in the following programs

StartPanel


Wheel.mcc

Description

Wheel.mcc simulates a wheel where you look at the side. It's like the modulation or pitch bender wheel on a music keyboard.