2.1 History
Please read the history bottom-up. Note that the history might list some
features that were implemented in beta versions and removed later but are
still mentioned here. This history is a log of the programmer so that he
can look up what has been done/tried/modified. Things that were implemented
and removed later are marked with [VOID].
Version 1.7 (01-Oct-17)
- Change: Updated documentation
- Fix: Area.ContextMenu didn't work with Group objects (reported by Tony Canazza)
- Fix: Slider.Stringify didn't work for Numericbutton class (reported by Petteri Valli)
- New: Added Notify.ExportID [ISG]; this can be used to load and save the states of certain MUI
gadgets like string, radio, cycle, listview, text, etc. (requested by Artur Ostrowski)
- New: Added Application.Load() and Application.Save() methods to easily load and save the current
GUI state configuration (requested by Artur Ostrowski)
- New: Added mui.FreeImage(); this allows you to free an image in MUI Royale's internal image
cache; you have to pass the number of the brush you want to free or -1 to free all images;
note that you must make sure that the image you free is no longer used by any widget or MUI
Royale might crash; note that normally it isn't necessary to call mui.FreeImage() because all
images are freed automatically when MUI Royale quits; it's only necessary in case you want
to reuse the same brush number with a new image or free memory used by an image (requested by
Lazar Zoltan and Petteri Valli)
- New: Added mui.HaveObject(); this allows you to check whether the specified MUI object exists
(requested by Tony Canazza)
Version 1.6 (08-May-17)
- Change: Updated documentation
- Fix: Virtual groups didn't work inside scrollgroups (reported by Kai Stegemann)
Version 1.5 (06-May-17)
- Change: Updated documentation
- New: Virtgroup class can now also be used outside of groups managed by Scrollgroup
class (requested by Tony Canazza)
- Change: About MUI Royale logo is stored with compression now; saves about 80kb in
the final executable size
- New: Added support for Numericbutton MUI class; it uses exactly the same attributes
as Slider class (requested by Petteri Valli)
- Fix: Button.HiChar and Text.HiChar were documented and implemented as ISG but their
real applicability is just I (reported by Petteri Valli)
- Fix: Application.DoubleStart never triggered (reported by Petteri Valli)
- New: Added Slider.Pressed [N]; this can be used to listen to mouse clicks on the
slider knob (requested by Tony Canazza)
- New: Added Area.ShowSelState; this is only interesting for people wishing to do
advanced stuff with MUI Royale
- Change: Moved Button.Pressed and Button.Selected attributes to Area class; this
is necessary for you to make full use of the new Area.InputMode attribute
- New: Added Area.InputMode [I]; use this with care as typically this is set by the
individual MUI gadgets themselves so setting an alternate input mode is potentially
dangerous (requested by Tony Canazza)
- New: Added Area.BackgroundBrush [IS] (requested by Tony Canazza)
- New: Hollywood class supports the "VanillaKey" event handler now if Hollywood 7 is
available; this event handler allows you to listen to Unicode keys
- New: Added Unicode support if Hollywood 7 is available; of course, AmigaOS doesn't
support Unicode itself so you'll always be limited to the system charset but at
least MUI Royale always uses UTF-8 internally now so as soon as AmigaOS or MUI gets
full Unicode support MUI Royale can support it too
Version 1.4 (25-Sep-16)
- Change: Updated documentation
- Fix: Escape sequences are now filtered from the string gadget created by Poplist class
(reported by Richard Lake)
- New: Added Listview.AutoLineHeight [I] and Listtree.AutoLineHeight [I]; these are more
convenient than xxx.MinLineHeight but they require at least MUI 4.0
- New: Added support for TextEditor.ImportHook and TextEditor.ExportHook (requested by
Jean-Noel Roueste)
- New: Added support for MUI's Busy class; this is useful for indicating progress when
the total processing time is unknown
- Fix: Memory access fault in mui.Set() under special, rare circumstances
- New: Added support for MUI's Scrollbar.mui class; this is a subclass of Prop.mui
- New: mui.Request() supports an additional argument now which allows you to specify an
icon to be shown in the requester; this is currently only supported with the MUI4
maintained by Thore Böckelmann (requested by Jean-Noel Roueste)
- Fix: Wrong virtgroup layout e.g. in Virtual.hws
- Fix: Crash in Register.AddPage() in case an error occurred
- Fix: Crash in mui.CreateObject() in case an error occurred while creating the object
- Fix: Notify on String.Contents didn't work
- Change: Removed TextEditor.FlushColors() and TextEditor.Pen; these are superfluous now
because colored text is no longer pen-based
- Change: TextEditor.SetColor() and TextEditor.Color use TextEditor.mcc's inbuilt RGB text
mode now which is a much better solution than the previous pen-based approach; as a result,
TextEditor.mcc 15.47 is now required by MUI Royale!
- New: Added Listtree.Quiet [S] which can be used to turn off refresh when adding lots of
items (requested by Richard Lake)
- New: Register.InsertPage() allows you to insert tabs into arbitrary position (requested by
Richard Lake)
- Fix: Listtree.Insert() and Listtree.Rename() didn't support images using the \33A sequence
(reported by Richard Lake)
- New: Listtree.MinLineHeight allows you to set a minimum line height for the Listtree object
- Fix: In some rare cases mui.Set() didn't report a correct error message
- Fix: Menuitem.Selected, Poppen.RGB, String/Popfile/Popdrawer/Popfont.Contents, String/
Popfile/Popdrawer/Popfont.Acknowledge notifications didn't set TriggerValue correctly
- New: Listview.Jump() can handle the special values "Active", "Top", "Bottom", "Up", and
"Down" now
- Fix [AROS]: Hollywood class didn't handle satellite bitmap pixel formats correctly; this
didn't have any practical consequences for Hollywood versions <= 6.0 because of a bug in
these Hollywood versions; this bug was fixed in Hollywood 6.1, though, and then prevented
embedded Hollywood displays from working correctly
- New: Added support for palette-based screens; when calling @REQUIRE and the front-most screen
is palette-based, MUI Royale will automatically install a display adapter which supports
palette-based screens; if you want to open Hollywood displays you also need the Plananarama
plugin and you need to @REQUIRE the Plananarama plugin *before* MUI Royale!
Version 1.3 (27-Jun-15)
- Change: Updated documentation
- Change: Installer automatically integrates the MUI Royale examples into Hollywood 6.0's example
tree now so that you can conveniently launch them from the Hollywood GUI
- Fix: Listtree.Remove() didn't remove the nodes and items from MUI Royale's internal object
collection which meant that you could still access them through mui.Set() and mui.Get()
- Fix: Listtree.Insert() returns an error now if the id is already used by another object
- Fix: Listtree.Insert() didn't make new nodes and items available to MUI Royale's internal
object collection which meant that you couldn't access newly inserted nodes and items using
mui.Set() and mui.Get() for example to associate user data with them (reported by Richard Lake)
- Fix: Getting Listviewcolumn.Hidden didn't work correctly when the user manually hid a column
using the context menu in the listview's title bar (reported by Rüdiger Solbach)
- Fix: Getting Group.ActivePage no longer returns "First" for the very first page but numeric
indices for all pages (reported by Lazar Zoltan)
- Fix: Qualifiers like shift, alt, command... didn't work with Hollywood 6.0 (reported by
Jörg Renkert)
- Fix: Memory access fault when calling mui.Request() before mui.CreateGUI() (reported by
Simone Monsignori)
- Fix: Listview.GetEntry() didn't make sure that there is enough stack space for storing the
return values (reported by Lazar Zoltan)
- Fix: Read from recently freed memory in mui.FreeObject() and when shutting down the application
(reported by Thore Böckelmann)
- New: Menuitem.Title supports text formatting codes now if MUI 4.0 is available; please note
that text formatting codes only work for context menus, not for screen bar menus (requested
by Richard Lake)
- New: Added several new functions to deal with string objects: String.Copy(), String.Cut(),
String.Paste(), String.Insert(), String.Undo(), String.Redo() as well as the attributes
String.MarkStart [ISG], String.MarkEnd [ISG] and String.CursorPos [SG]; all of these methods
and attributes require at least MUI 4.0 (suggested by bitRocky)
- Fix: Area.Hide didn't work correctly with text editor objects that have a slider attached
(reported by Lazar Zoltan)
- Fix [Doc]: PopFile.Pattern was wrongly documented as PopFile.InitialPattern (reported by
Jörg Renkert)
- Fix [Doc]: Tutorial code contained a bug concerning the way "ShowWindow" and "HideWindow"
were handled (reported by Damaso Dominguez)
- Change: Merged code of muiroyale.hwc into the main plugin; muiroyale.hwc is no longer
necessary now
- Fix: Setting Group.Title on a group object that hadn't been attached to a register group
yet caused a crash
- Fix: Register.AddPage() ran the text formatter again for the register title which led to
errors in case embedded images were used (reported by Richard Lake)
Version 1.2 (02-Jul-14)
- Change: Updated documentation
- New: Added 4 examples that show how to use the new functions mui.CreateObject() and
mui.FreeObject() to dynamically create MUI objects at runtime (Dynamic1.hws, Dynamic2.hws,
Dynamic3.hws, Dynamic4.hws)
- Change: TextEditor.hws example script now uses TextEditor.Color instead of TextEditor.Pen to
guarantee a consistent visual experience on all systems
- Change [OS3]: Now that MUI 3.9 is also available for OS3, MUI Royale will check on startup
whether 3.9 is installed and will enable all 3.9 features if it is
- New: Added TextEditor.ColorMap [G] attribute to retrieve the current color map; you need this to
parse the text returned by TextEditor.Contents
- New: Added TextEditor.SetColor() method which allows you to change the color of a text block
- New: TextEditor.SetBold(), TextEditor.SetItalic(), TextEditor.SetUnderline() and TextEditor.SetAlign()
support the special values "Min" and "Max" now to conveniently specify the minimum and maximum
positions available
- New: Added TextEditor.FlushColors() method which can be used to flush the internal pen mapping
of a text editor object (in case you're running out of pens)
- New: Added TextEditor.Color which has an applicability of SGN (requested by Marko)
- New: Added Area.BackgroundRGB and Area.BackgroundImage (requested by Marko)
- New: Application.ConfigChange allows you to get notified whenever the user changes the MUI
settings for your application, e.g. moves it to another screen; this is only supported on
MUI 4 (requested by Jörg Renkert)
- Change: Window.PubScreen now always returns the name of the screen the window is currently on
even if it has been set by the user using the MUI preferences (requested by Jörg Renkert)
- New: Group.Title now has an applicability of ISG and it can also handle text formatting tags
now, e.g. it is possible to include images in the tab titles now; both features require MUI 4;
if MUI 4 is unavailable, Group.Title will have the old applicability of just I
- New: Group.ChildList attribute can be used to get a list of children that are members of
the group; Group.ChildList returns a table containing as many elements as the group has
children; each element contains the fields "ID", "Class", and "MUIClass"
- New: Added Application.WindowList attribute [G]; this will return a table containing a list
of all windows currently attached to the application object
- New: mui.IsVersion4() allows you to check whether the user is running MUI 4
- New: Added Register.Position [I] and Register.Pages [G] attributes; these require MUI 4.0
- New: Added Register.Closable [I] and Register.CloseRequest [N] attributes; by using these attributes
you can add a close gadget to the tabs of your Register object and react to the user pressing
these gadgets; these attributes require MUI 4.0
- New: Added Register.GetPageID() method which returns the ID of the group object at the specified
tab index; this method requires MUI 4.0
- New: Added Register.AddPage() and Register.ClosePage() which allow you to dynamically add and
remove tabs from a Register object; these two methods require at least MUI 4.0 (requested by
Richard Lake)
- New: All Menustrip methods are also available to Menu class now
- New: Added Menustrip.AddHead() and Menustrip.AddTail() methods to add menu objects to the head
or tail of a menu
- New: Added Application.AddWindow() and Application.RemoveWindow() to dynamically add/remove
windows to/from the Application object
- New: Added Group.InitChange(), Group.ExitChange(), Group.AddHead(), Group.AddTail(),
Group.Insert(), and Group.Remove() methods which can be used to insert dynamically created MUI
objects into an existing group or remove MUI objects from a group and add them to the loose object
stock; note that you must not call mui.FreeObject() on objects that have been added to a group
because they will be freed with the group then; mui.FreeObject() must only be called with loose
objects which have either been created by mui.CreateObject() or removed from an existing object tree;
note that Group.ExitChange() accepts an additional argument which can be used to specify whether
or not MUI should force a refresh
- New: Added support for dynamic creation of MUI objects: you can create MUI objects at runtime
now using the new mui.CreateObject() and mui.FreeObject() functions; MUI objects created at
runtime can then be added to existing objects using new methods (see above)
- New: Added Listview.SortFunc attribute; this allows you to specify a custom callback function
that will be called whenever your listview requires sorting; this allows you to customize
listview sorting, e.g. implement reverse alphabetical sorting or other customized criteria;
your callback needs to return "-1" if entry 1 should be placed before entry 2 or "1" if it
is to be placed after entry 2; if the two entries are the same, return "0" (requested by
Richard Lake)
- Fix [Doc]: ISGN applicability of Slider.Stringify() wasn't documented
- Fix: Slider.Stringify didn't work with mui.Get()
- New: Added Listview.Quiet attribute which allows you to temporarily disable listview refresh
to quickly add/remove multiple items (requested by Richard Lake)
Version 1.1 (07-May-14)
- Change: Updated documentation
- New: VideoPlayer example allows you to switch between antialias interpolation and simple
scaling
- Fix: Fixed a bug in the Slider.Stringify; it didn't block Hollywood's refresh server which
could lead to a deadlock, for example in the VideoPlayer.hws example; this fix requires a
Hollywood version newer than 5.3
- New: Added Texteditor.GetText method; this allows you to get the partial contents from
a text editor gadget (requested by Richard Lake)
- New: Window.PubScreen allows you to open windows on all public screens; use this only if
you have good reasons because normally this is something that the user should decide
(requested by Richard Lake)
- Fix: Window.Borderless didn't work because MUI Royale enforced a window title (reported by
Jörg Renkert)
- New: Popfile, Popdrawer, Popfont, and Poplist classes support the AdvanceOnCR attribute now
for their string gadgets (requested by Richard Lake)
- New: Window.ActiveObject can also be used as a notification attribute now (requested by
Richard Lake)
- Fix: Application.AboutMUIRoyale() didn't work when MUIRoyale.hwp was in a folder that contained
spaces (reported by Achim Kern)
- New: All of the Column class attributes have an applicability of ISG now which means that
you can also change them during runtime
- New: Added Listviewcolumn.Hidden attribute which can be used to show/hide single columns;
this requires at least MUI 3.9 (requested by Richard Lake)
- New: Added Listview.Rename() method that allows you to rename entries in a listview row
(requested by Richard Lake)
- Fix: Listview.Sort() didn't work correctly; it now accepts an additional argument which
tells according to which column the list view should be sorted (reported by Richard Lake)
- New: Area.ContextMenu can be used with mui.Set() now to change the context menu of a MUI
object; to remove the context menu from an object completely, pass the special constant
"(none)" in mui.Set() (requested by Richard Lake)
- New [OS4/MorphOS]: Listview.TitleClick allows you to get notified about clicks on the title
bars of a listview (requested by Richard Lake)
- Fix [AROS]: MUI Royale uses relative search paths now when looking for TextEditor.mcc and
TheBar.mcc custom classes (reported by Nigel Tromans)
- Fix: Area.ContextMenuTrigger didn't set the TriggerValue correctly (reported by Richard Lake)
- Fix: When using Listview.GetEntry together with "Active" on a Dirlist object in which no entry
was active, MUI Royale crashed (reported by Richard Lake)
- New [OS4]: Pixel-exact virtgroup resizing now possible because it is now supported by OS4's
MUI now, too
- Fix: "Selected" attribute in class <button> did not work when used with "True" or "False"
(reported by Matthias Rustler)
- Fix: Installer didn't work with paths that had spaces in them (reported by Richard Lake)
Version 1.0 (30-Dec-12)
- First Release
Show TOC