469 lines
21 KiB
Plaintext
469 lines
21 KiB
Plaintext
NxWidgets-1.0
|
|
=============
|
|
|
|
The initial version of NxWidgets was released on March 22, 2012. This
|
|
package has been used in several projects prior to its release to open
|
|
source and is considered stable its initial release (although not all
|
|
features have been fully verified).
|
|
|
|
NxWidgets-1.1
|
|
=============
|
|
|
|
The 2nd release of the NxWidgets package was made on May 19, 2012. The
|
|
headline new feature in this release is:
|
|
|
|
* NxWM, the tiny window manager based on NX and NxWidgets. NxWM is true
|
|
multiple window manager but only one window is displayed at a time.
|
|
This simplification helps performance on LCD based products (in the
|
|
same way that a tiled window manager helps) and also makes the best
|
|
use of small displays. It is awkward from a human factors point-of-view
|
|
trying to manage multiple windows on a small display.
|
|
|
|
The window manager consists of a task bar with icons representing the
|
|
running tasks. If you touch the task's icon, it comes to the top. Each
|
|
window has a toolbar with (1) a title, (2) a minimize button, and (3) a
|
|
stop application button using the standard icons for these things. User
|
|
input via a touchscreen or mouse and keyboard is supported.
|
|
|
|
There is always a start window that is available in the task bar. When
|
|
you touch the start window icon, it brings up the start window containing
|
|
icons representing all of the available applications. If you touch an
|
|
icon in the start window, it will be started and added to the task bar.
|
|
|
|
There is a base class that defines an add-on application and an
|
|
interface that supports incorporation of new application. The only
|
|
application that is provided is NxConsole. This is an NSH session
|
|
running in a window. You should be able to select the NX icon in the start
|
|
menu and create as many NSH sessions in windows as you want. (keybard input
|
|
still comes through serial).
|
|
|
|
This initial realease of NxWM should be considered an alpha release.
|
|
All know issues are listed in the top-level TODO list.
|
|
|
|
Other important new features include:
|
|
|
|
* NxWidgets::IBitmap and NxWidgets::CRlePalettBitmap: Extended to
|
|
support different color look-up-tables (LUTs). This allows images
|
|
to be highlighted when touched, for example.
|
|
* NxWidgets::CImage: Extended to support button-like behavior. CImage
|
|
widgets now work well as touchable icons.
|
|
* NxWidgets::CWidgetControl: Add a semaphore to force clients to wait if the
|
|
size or position of the window is not yet known (multi-user mode only).
|
|
Enabled and verified creation of framed windows.
|
|
* NxWidgets::CWindowEventHandler and NxWidgets::CWindowEventHandler: Add
|
|
support for getting callbacks for window events.
|
|
* DOxygen documentation support. Contributed by Jose Pablo Carballo.
|
|
|
|
An effort is underway to simplify NxWidgets and reduce its memory footprint:
|
|
|
|
* NxWidgets::CNxWidget: Removed support for "shelving" widgets, reference
|
|
constants, and close types. Remove all support for widgets in a "vertical"
|
|
hierarchy. Now widgets exist in a flat, two-dimensional space and should
|
|
not overlap. Removed built-in modal loops.
|
|
|
|
Bug fixes include changes to the following (see the ChangeLog for details):
|
|
|
|
* NxWidgets::CRlePalettBitmap, NxWidgets::CRlePalettBitmap,
|
|
NxWidgets::CGraphicsPort, NxWidgets::CWidgetControl
|
|
|
|
NxWidgets-1.2
|
|
=============
|
|
|
|
The 3rd release of the NxWidgets package was made on June 15, 2012. This
|
|
release depends on NuttX-6.19 or above and should not be used with older
|
|
NuttX releases.
|
|
|
|
New features and enhancements include:
|
|
|
|
* NxWM::CNxConsole: The NxWM NxConsole windows now correctly receive keyboard
|
|
input. In version 1.1, NxConsoles received input from /dev/console. That,
|
|
of course, leads to chaos when there a multiple windows trying to get input
|
|
from the same device. There is now a keyboard listener task that will
|
|
accept input from /dev/console and inject that input into the NX keyboard
|
|
interface. NX will give the keyboard input only to the top window that
|
|
has focus, eliminating the chaos.
|
|
|
|
* NxWM::CHexcalculator: The NxWM demonstration/unit test now includes a hex
|
|
calculator applications. This demonstrates the use of arrays of buttons
|
|
within a window.
|
|
|
|
Bugfixes:
|
|
|
|
* NxWM::CTaskbar: Was inappropriately minimizing some windows. Fixes
|
|
some window raising/lowering bugs.
|
|
|
|
* NXWidgets::CButtonArray: Fix some coloring problems when rending button
|
|
text in cases where we cannot read from the display device.
|
|
|
|
As well as other, less critical bugs (see the ChangeLog for details)
|
|
|
|
NxWidgets-1.3
|
|
=============
|
|
|
|
The 4th release of the NxWidgets package was made on September 29, 2012. This
|
|
release depends on NuttX-6.22 or above and should not be used with older
|
|
NuttX releases.
|
|
|
|
There are no functional changes in this release of NxWidgets. This release
|
|
is required in order to retain compatibility with the most recent versions
|
|
of NuttX. These comptibility changes include:
|
|
|
|
* Naming of function entry points
|
|
* Build system changes
|
|
* Changes needed for the NuttX configuration tool
|
|
|
|
NxWidgets-1.4
|
|
=============
|
|
|
|
The 5th release of the NxWidgets package was made on December 20, 2012. This
|
|
release depends on NuttX-6.24 or above and should not be used with older
|
|
NuttX releases. This release corresponds to SVN revision r5447.
|
|
|
|
Note: Nearly all changes between 1.3 and 1.4 were the result of the efforts
|
|
of Petteri Aimonen.
|
|
|
|
Additional new features and extended functionality in Version 1.4:
|
|
|
|
* NxWdigets::CNxServer: Reduce start-up delay
|
|
* NxWM::CApplicationWindow: Option to eliminate minimize button.
|
|
* NxWM::CTaskbar: Option to eliminte the background image; highlight current
|
|
icon in the task bar.
|
|
* NxWidgets::CNumericEdit: New widget. Basically a CLabel with +/- buttons.
|
|
* NxWidgets::CNxTimer: Replace the original signal-based solution with a
|
|
work queue-based solution. This raises some isses about using the
|
|
internal work queues from user space.
|
|
* Build System: Misc improvements.
|
|
* Tools: bitmap_converter.py will convert images to NxWidgets RLE-encoded format.
|
|
|
|
Bugfixes (see the change log for details). Some of these are very important
|
|
(marked *critical*):
|
|
|
|
* NxWidgets::CCallback: Misplaced #endif
|
|
* NxWM::CCalculator and NxWM::CStartWindow: Add forward declaration for icon images.
|
|
* glych_cycle: Correct width, destructor needs to be public.
|
|
* NxWidgets:CText and NxWidgets:CNumericEdite: Fix some memory freeing bugs
|
|
* NxWidgets::CScrollingPanel: It is borderless for now because there was no
|
|
easy way to redraw only the required part of the border.
|
|
|
|
NxWidgets-1.5
|
|
=============
|
|
|
|
The 6th release of the NxWidgets package was made on February 1, 2013. This
|
|
release depends on NuttX-6.25 or above and should not be used with older
|
|
NuttX releases. This release corresponds to SVN revision r5595.
|
|
|
|
Note: Nearly all of the changes between 1.4 and 1.5 were the result of the
|
|
efforts of Petteri Aimonen.
|
|
|
|
Additional new features and extended functionality in Version 1.5:
|
|
|
|
* CNxWidgets::CTabPanel: A new widget contributed by Petteri Aimonen.
|
|
This widget provides a tab panel, which has a button bar at the top
|
|
and panels below it. Pressing a button will select the corresponding
|
|
panel.
|
|
* NxWidgets::CGraphicsPort: Many times we only want a constant background.
|
|
In that case the old code filled the background, read it back, rendered
|
|
the text and then wrote it back. When used with an LCD this causes
|
|
some screen flicker. Added a variant of drawText that takes background
|
|
color, so that the background and text can both be rendered at one go.
|
|
* NxWM::CScrollingPanel::scrollChildren(): Avoid unnecessary redraws in
|
|
CScrollingPanel
|
|
* Kconfig: Added several "enabling" settings that must be selected to
|
|
override the default setting.
|
|
* UnitTests: Changes for compatibility with NuttX-6.25
|
|
|
|
Bugfixes:
|
|
|
|
* NxWidgets::CGraphicsPort::move(): Fix typo bug in bounding rectangle
|
|
calculation.
|
|
* NxWM::CCycleButton: Remove the separator from CCycleButton. It draws in
|
|
wrong place, and doesn't look very good in the correct place either.
|
|
* NxWidgets::CLabel: The label was drawn as a single rectangular region,
|
|
then a text was added to the on top of this. The result is that the
|
|
text would flicker when the CLabel was updated. With this change, the
|
|
two step update is replaced with a five step update: The background
|
|
is updated as four rectangulear regions (leaving the previous text in
|
|
place), then the new text is updated. This eliminates the flicker.
|
|
* CGraphicsPort::_drawText: Renamed from CGraphicsPort::drawText in order
|
|
to eliminate some naming collisions when overloaded in some configurations
|
|
(i.e., when both bool and nx_pixel_t are uint8_t).
|
|
|
|
NxWidgets-1.6
|
|
=============
|
|
|
|
The 7th release of the NxWidgets package was made on March 15, 2013. This
|
|
release depends on NuttX-6.26 or above and should not be used with older
|
|
NuttX releases. This release corresponds to SVN revision r5745.
|
|
|
|
Note: All of the changes between 1.5 and 1.6 were the result of the
|
|
efforts of Petteri Aimonen.
|
|
|
|
Additional new features and extended functionality in Version 1.6:
|
|
|
|
* NXWidgets::CNxWidget: Add an inline function to get the current style.
|
|
* NXWidgets::CCycleButton: Make CCycleButton change state in onPreRelease().
|
|
This way the new value is already available when a listener gets the
|
|
action event.
|
|
* NxWidgets::CImage: Two enhancements:
|
|
1) Allow changing the bitmap even after the control has been created.
|
|
2) Allow giving 'null' to have the control draw no image at all.
|
|
|
|
* NxWM::CTaskBar: Make a some methods of CTaskbar virtual to allow
|
|
customizations.
|
|
* NxWM::CTaskBar: Allow windows with null icon. This makes sense for e.g.
|
|
full screen windows.
|
|
* NxWM::CApplicationWindow: Add config options to override NxWM
|
|
stop/minimize icons.
|
|
* NwWM::CStartWindow, NxWM::CWindowMessenger: Get rid of the start window
|
|
thread. Instead, handle all events through the USRWORK work queue.
|
|
For me, this was necessary because I would open some files in button
|
|
handlers and close them in NxTimer handlers. If these belonged to
|
|
different tasks, the close operation would fail. Further benefits:
|
|
+ Gets rid of one task and message queue.
|
|
+ Reduces the amount of code required
|
|
+ Decouples CStartWindow from everything else - now it is just a window
|
|
with application icons, not an integral part of the event logic.
|
|
+ All events come from the same thread, which reduces the possibility of
|
|
multithreading errors in user code.
|
|
+ The user code can also send events to USRWORK, so that everything gets
|
|
serialized nicely without having to use so many mutexes.
|
|
Drawbacks:
|
|
- Currently the work state structure is malloc()ed, causing one allocation
|
|
and free per each input event. Could add a memory pool for these later, but
|
|
the speed difference doesn't seem noticeable.
|
|
- The work queue will add ~50 ms latency to input events. This is however
|
|
configurable, and the delay is anyway short enough that it is unnoticeable.
|
|
|
|
Bugfixes:
|
|
|
|
* NxWidgets::CWidgetControl: Added another semaphore, boundssem, which
|
|
is set as soon as the screen bounds are known. This corrects two
|
|
problems:
|
|
1) Due to the way nxgl_rectsize computes the size, it will never
|
|
be 0,0 like CWidgetControl expects. Therefore the size is considered
|
|
valid even though it has not been set yet.
|
|
2) After the check is fixed to test for > 1, NxWM window creation will
|
|
hang. This is due to the fact that it uses the screen bounds for
|
|
determining window size. This was being blocked on geosem, which
|
|
is only posted after the size has been set.
|
|
* NxWidgets::CNxTimer: Previously repeated timers were re-enabled after
|
|
the timer action event. Consequently, if the action event handler tried
|
|
to stop the timer, the request would be ignored. Changes the order
|
|
so that the timer is re-enabled before the callback. There is still
|
|
no risk of re-entrancy, because everything executes on the USRWORK work
|
|
queue.
|
|
* NxWidgets::CLabel: Fix backward conditional compilation in the "flicker
|
|
free" logic.
|
|
* NxWidgets::CMultiLineTestBox: Fix text placement error. From Petteri
|
|
Aimonen.
|
|
|
|
* NxWidgets/tools/bitmap_converter.py: Fix bitmap_converter.py so that
|
|
it works with indexed input images.
|
|
|
|
NxWidgets-1.7
|
|
=============
|
|
|
|
The 8th release of the NxWidgets package was made on April 28, 2013. This
|
|
release depends on NuttX-6.26 or above and should not be used with older
|
|
NuttX releases.
|
|
|
|
Note: All of the changes between 1.6 and 1.7 were the result of the
|
|
efforts of Petteri Aimonen.
|
|
|
|
Additional new features and extended functionality in Version 1.7:
|
|
|
|
* NxWidgets::CGlyphButton: Generate action event, like CButton does.
|
|
* NxWM::CTaskBar: Add option CONFIG_NXWM_TASKBAR_NO_BORDER to suppress
|
|
drawing of the border on the taskbar.
|
|
* NxWidgets::CNxTimer: Add function to check if CNxTimer is running.
|
|
* NxWidgets::CNxWidgets: Allow overriding of the checkCollision() method.
|
|
|
|
Bugfixes:
|
|
|
|
* NxWidgets bitmap_converter.py: Fix bug when image width > 255
|
|
* NxWM::CScrollbarPanel: Fix spelling error in class name: CScollbarPanel
|
|
should be CScrollbarPanel
|
|
* NxWidgets::CGlyphButton: Prevent drawing outside of the bitmap size.
|
|
|
|
NxWidgets-1.8
|
|
=============
|
|
|
|
The 9th release of the NxWidgets package was made on June 14, 2013. This
|
|
release depends on NuttX-6.26 or above and should not be used with older
|
|
NuttX releases.
|
|
|
|
Note: Most of the changes between 1.7 and 1.8 were the result of the
|
|
efforts of Ken Pettit and Petteri Aimonen.
|
|
|
|
Additional new features and extended functionality in Version 1.8:
|
|
|
|
* NxWM::CMediaPlayer: Shell application for an MP3 Media Player (from Ken
|
|
Pettit).
|
|
* NxWidgets::CGlyphSliderHorizontal and NxWidgets::CGlyphSliderHorizontalGrip:
|
|
New widgets added by Ken Pettit. Includes a Unit Test.
|
|
* NxWidgets::CImage: Allow a NULL pointer for a bitmap (from Petteri
|
|
Aimonen).
|
|
* NxWidgets::CNumericEdit: Delay before auto-incrementing now varies: A
|
|
longer delay is required to start auto-incrementing and speed increases
|
|
while pressed (from Petteri Aimonen).
|
|
* NxWM::CTaskbar: Add a method to redraw the taskbar and the current
|
|
application. This should only be necessary if the display loses state due
|
|
to e.g. powerdown or other manual intervention (from Petteri Aimonen).
|
|
|
|
Bugfixes:
|
|
|
|
* NxWM::CCalibration: Fix a race condition that would cause the calibration
|
|
screen to fail to come up when its icon was touched (from Ken Pettit).
|
|
* Default priorities for NxWidget and NxWM threads should be 100, not 50, to
|
|
be consistent with other default priorities.
|
|
* NxWidgets::CGlyphSliderHorizontal: Fix a drawing error (from Ken Pettit).
|
|
* Update the way that NSH the Unit Tests are registered as built-in NSH
|
|
applications.
|
|
|
|
NxWidgets-1.9
|
|
=============
|
|
|
|
The 10th release of the NxWidgets package was made on October 28, 2013. This
|
|
release depends on NuttX-6.26 or above and should not be used with older
|
|
NuttX releases.
|
|
|
|
Additional new features and extended functionality in Version 1.9:
|
|
|
|
* NxWM::CCalibration.cxx/hxx: If CONFIG_NXWM_CALIBRATION_MESSAGES is
|
|
defined then CCalibration will provide some instructions in the center
|
|
of the display.
|
|
* NxWM::CCalibration.cxx/hxx: Add options to collect and average
|
|
multiple samples at each location. Also logic to discard the most
|
|
extreme samples before averaging.
|
|
* NxWidgets::CScaledImage: This new class is a wrapper for an class
|
|
the exports IBitMap. It will perform scaling via bi-linear interpolation
|
|
so that images can be scaled to any size desired.
|
|
* NxWM::CTaskbar:: Can now be configured to scale taskbar icons using
|
|
NxWidgets::CScaledImage.
|
|
* NxWidgets/libnxwidgets/src/glyph_nxlogo320x320.cxx: Add a big, 320x320
|
|
NuttX logo image. The older, smaller NuttX logo was renamed from
|
|
nxlogo to nxlogo160x160 in all places.
|
|
* NxWM::CCalibration and NxWM::CTouchscreen: Add a complex touchscreen
|
|
scaling algorithm to handling the case where the measured X values also
|
|
vary with y position (and vice versa).
|
|
|
|
Bugfixes:
|
|
|
|
(There are no bugfixes recorded for this release).
|
|
|
|
NxWidgets-1.10
|
|
==============
|
|
|
|
The 11th release of the NxWidgets package was made on December 7, 2013. This
|
|
release depends on NuttX-6.26 or above and should not be used with older
|
|
NuttX releases.
|
|
|
|
Additional new features and extended functionality in Version 1.10:
|
|
|
|
* NxWM:Calibration and UnitTests/nxwm: Add logic to enable saving and
|
|
recovering touchscreen calibration data. This depends upon having
|
|
platform-dependent support for storage of configuration data. Portions
|
|
suggested by Ken Pettit.
|
|
|
|
NxWidgets-1.11
|
|
==============
|
|
|
|
The 12th release of the NxWidgets package was made on January 20, 2014. This
|
|
release depends on NuttX-6.33 or above and should not be used with older
|
|
NuttX releases.
|
|
|
|
Additional new features and extended functionality in Version 1.11:
|
|
|
|
* Primarily changes associated with the NuttX kernel build where the
|
|
graphics application lies in user space and the graphics server lies in
|
|
protected kernel space. This change is mostly a matter of repartitioning
|
|
functionality and should not cause in any functional differences.
|
|
|
|
NxWidgets-1.12
|
|
==============
|
|
|
|
The 13th release of the NxWidgets package was made on August 14, 2014. This
|
|
release depends on NuttX-7.3 or above and should not be used with older
|
|
NuttX releases.
|
|
|
|
Additional new features and extended functionality in Version 1.12:
|
|
|
|
* NxWM: Rename all ICON glyph files to include the size of the ICON as part
|
|
of the file name. This allows us to support different sizes for the same
|
|
ICON
|
|
* NxWM: Add larger versions (approx 50x50) versions of all ICONs.
|
|
* NxWM::CToolBar: Toolbar font ID can now be separately configured.
|
|
* NxWM::CMediaPlayer: Will now dynamically position player controls
|
|
based on the display and image sizes.
|
|
* NxWM::CMediaPlayer: Add options to manage spacing of media player
|
|
buttons and borders vs. borderless buttons.
|
|
* NxWidget::CImage: Now includes methods to align images in the widget
|
|
region.
|
|
* NxWM::CMediaPlayer now uses the new CImage methods to align media controls
|
|
in buttons.
|
|
* NxWidgets::CStickyImage: A version of CImage that sticks in the selected
|
|
state when clicked.
|
|
* NxMW::CMediaPlayer: Now supports a pause button.
|
|
* NxMW::CMediaPlayer: Convert CLabel to a CListBox to support selection of
|
|
one of many media files to play. This should be a CScrollingTextBox to
|
|
support an indefinitely large number of media files.
|
|
* NxWidgets::CGlyphSliderHorizontal: No longer uses a hard-coded slider
|
|
height; the slider height is now provided as a parameter, replacing the
|
|
widget height which is now calculated from the glip image height.
|
|
* NxWM::CMediaPlayer: Now calculates the volume slider height from the grip
|
|
image height.
|
|
* NxWidgets:CTabPanel: Make CTabPanel raise action event when tab is
|
|
changed. Also add a function for getting the currently selected tab
|
|
index. From Petteri Aimonen.
|
|
* NxWidgets/Kconfig: Add configuration options to filter CMediaPlayer files
|
|
based on extension.
|
|
* NxWM::CMediaPlayer: Add logic to read files from the media mountpoint,
|
|
filter them by extension, and display the file names in the listbox.
|
|
* NxWM::CMediaPlayer: Now integrated with the NxPlayer library.
|
|
* NxWidgets::CNxString: Add a getAllocSize() method to make it easier to
|
|
convert CNxStrings to NUL-terminated C strings.
|
|
* NxWM::CMediaPlayer: Add a CLabel that show the current fast forward/rewind
|
|
speed.
|
|
* NxWM::CKeyboard: Add support for a USB keyboard as the NxConsole and text
|
|
widget input.
|
|
|
|
Bugfixes:
|
|
|
|
* NxWidgets: Fix typo RBG -> RGB. This makes NxWidgets incompatible with
|
|
versions of NuttX 7.2 and below.
|
|
* NxWidgets::CImage: Fix setImageLeft and setImageTop methods
|
|
* NxMW::CMediaPlayer: Correctly catch the volume level change event.
|
|
* NxWidgets::CGraphicsPort: Fix drawBitmapGreyScale method. Actually drew
|
|
nothing because of several errors in positioning and buffer usage.
|
|
* NxWidgets::CImage: Should not attempt to draw the "empty" regions at the
|
|
top and the bottom of the image box in greyscale.
|
|
* NxWidgets::CNxString: Make destructor virtual. From Petteri Aimonen.
|
|
* NxWidgets::CTaskbar: Fix type of return value from openRawWindow()
|
|
method. From Petteri Aimonen.
|
|
* NxWidgets::CTabPanel: Modify behavior in showPage() method. Eliminate a
|
|
duplicate redraw that caused flickering; re-order some logic so that
|
|
widgets are hidden before operated on. From Petteri Aimonen.
|
|
* NxWidgets::CNxTimer: Make CNxTimer stop itself before destruction.
|
|
Otherwise a call to an invalid work queue entry may occur. From Petteri
|
|
Aimonen.
|
|
* NxWM::IApplicationFactory: Add a do-nothing, virtual destructor to
|
|
eliminate a warning.
|
|
* XWidgets::CNxWidget: Remove an unused bit field.
|
|
|
|
NxWidgets-1.13
|
|
==============
|
|
|
|
The 14th release of the NxWidgets package was made on September 28, 2014. This
|
|
release depends on NuttX-7.5 or above and should not be used with older
|
|
NuttX releases.
|
|
|
|
Additional new features and extended functionality in Version 1.13:
|
|
|
|
* There are no new features in this release. This release simply updates
|
|
some naming that is necessary for NxWidgets to build successfully with
|
|
NuttX-7.5 and above.
|
|
|
|
Bugfixes:
|
|
|
|
* There are no new bug fixes in this release.
|