137 lines
6.2 KiB
Plaintext
137 lines
6.2 KiB
Plaintext
README
|
|
^^^^^^
|
|
|
|
This directory contains tiny graphics support for NuttX. The contents of this directory
|
|
are only build if CONFIG_NX is defined in the NuttX configuration file.
|
|
|
|
Roadmap
|
|
^^^^^^^
|
|
|
|
This directory holds NuttX graphic packages. Not all of these packages are implemented
|
|
at the present, but here is the longer term roadmap:
|
|
|
|
NXWIDGETS - I had originally planned a high level, C++, object-oriented library for
|
|
object-oriented access to graphics widgets. However, because C++ compilers
|
|
are not available for some of the targets supported by NuttX, I have
|
|
decided to implement the entire solution in C -- that makes the solution
|
|
much uglier, but works fine on all platforms.
|
|
NXTOOLKIT - A set of C graphics tools that provide higher-level window drawing
|
|
operations. The toolkit can be used for window-oriented graphics
|
|
without NXWIDGETS and is built on top of NX.
|
|
NXFONTS - A set of C graphics tools for present (bitmap) font images.
|
|
NX - The tiny NuttX windowing system. This includes both a small-footprint,
|
|
single user implementaton (NXSU as described below) and a somewhat
|
|
larger multi-user implentation (NXMU as described below). Both
|
|
conform to the same APIs as defined in include/nuttx/nx.h and, hence,
|
|
are more-or-less interchangable. NX can be used without NXWIDGETS
|
|
and without NXTOOLKIT for raw access to window memory.
|
|
NXGLIB - Low level graphics utilities and direct framebuffer rendering logic.
|
|
NX is built on top of NXGLIB.
|
|
|
|
Related Header Files
|
|
^^^^^^^^^^^^^^^^^^^^
|
|
|
|
include/nuttx/nxglib.h -- Describes the NXGLIB C interfaces
|
|
include/nuttx/nx.h -- Describes the NX C interfaces
|
|
include/nutt/nxtk.h -- Describe the NXTOOLKIT C interfaces
|
|
include/nutt/nxfont.h -- Describe sthe NXFONT C interfaces
|
|
include/nuttx/nxwidgets.h -- Will describe the NXWIDGETS classes (no longer planned)
|
|
|
|
Directories:
|
|
^^^^^^^^^^^^
|
|
|
|
graphics/nxglib
|
|
The NuttX tiny graphics library. The directory contains generic utilities
|
|
support operations on primitive graphics objects and logic to rasterize directly
|
|
into a framebuffer. It has no concept of windows (other than the one, framebuffer
|
|
window).
|
|
|
|
graphics/nxbe
|
|
This is the "back-end" of a tiny windowing system. It can be used with either of
|
|
two front-ends to complete a windowing system (see nxmu and nxsu below). It
|
|
contains most of the important window management logic: clipping, window controls,
|
|
window drawing, etc.
|
|
|
|
graphics/nxsu
|
|
This is the NX single user "front end". When combined with the generic "back-end"
|
|
(nxbe), it implements a single thread, single user windowing system. The files
|
|
in this directory present the window APIs described in include/nuttx/nx.h. The
|
|
single user front-end is selected when CONFIG_NX_MULTIUSER is not defined in the
|
|
NuttX configuration file.
|
|
|
|
graphics/nxsu
|
|
This is the NX multi user "front end". When combined with the generic "back-end"
|
|
(nxbe), it implements a multi-threaded, multi-user windowing system. The files
|
|
in this directory present the window APIs described in include/nuttx/nx.h. The
|
|
multi-user front end includes a graphics server that executes on its own thread;
|
|
multiple graphics clients then communicate with the server via a POSIX message
|
|
queue to serialize window operations from many threads. The multi-user front-end
|
|
is selected when CONFIG_NX_MULTIUSER is defined in the NuttX configuration file.
|
|
|
|
graphics/nxfonts
|
|
This is where the NXFONTS implementation resides. This is a relatively low-
|
|
level set of charset set/glyph management APIs. See include/nuttx/nxfonts.h
|
|
|
|
graphics/nxtk
|
|
This is where the NXTOOLKIT implementation resides. This toolkit is built on
|
|
top of NX and works with either the single-user or multi-user NX version. See
|
|
include/nuttx/nxtk.h
|
|
|
|
graphics/nxwidgets
|
|
At one time, I planned to put NXWIDGETS implementation here, but not anymore.
|
|
|
|
Configuration Settings
|
|
^^^^^^^^^^^^^^^^^^^^^^
|
|
|
|
CONFIG_NX
|
|
Enables overall support for graphics library and NX
|
|
CONFIG_NX_MULTIUSER
|
|
Configures NX in multi-user mode
|
|
CONFIG_NX_NPLANES
|
|
Some YUV color formats requires support for multiple planes, one for each
|
|
color component. Unless you have such special hardware, this value should be
|
|
undefined or set to 1.
|
|
CONFIG_NX_DISABLE_1BPP, CONFIG_NX_DISABLE_2BPP,
|
|
CONFIG_NX_DISABLE_4BPP, CONFIG_NX_DISABLE_8BPP,
|
|
CONFIG_NX_DISABLE_16BPP, CONFIG_NX_DISABLE_24BPP, and
|
|
CONFIG_NX_DISABLE_32BPP
|
|
NX supports a variety of pixel depths. You can save some memory by disabling
|
|
support for unused color depths.
|
|
CONFIG_NX_PACKEDMSFIRST
|
|
If a pixel depth of less than 8-bits is used, then NX needs to know if the
|
|
pixels pack from the MS to LS or from LS to MS
|
|
CONFIG_NX_MOUSE
|
|
Build in support for mouse input.
|
|
CONFIG_NX_KBD
|
|
Build in support of keypad/keyboard input.
|
|
CONFIG_NXTK_BORDERWIDTH
|
|
Specifies with with of the border (in pixels) used with framed windows.
|
|
The default is 4.
|
|
CONFIG_NXTK_BORDERCOLOR1 and CONFIG_NXTK_BORDERCOLOR2
|
|
Specify the colors of the border used with framed windows.
|
|
CONFIG_NXTK_BORDERCOLOR2 is the shadow side color and so is normally darker.
|
|
The default is medium and dark grey, respectively
|
|
CONFIG_NXTK_AUTORAISE
|
|
If set, a window will be raised to the top if the mouse position is over a
|
|
visible portion of the window. Default: A mouse button must be clicked over
|
|
a visible portion of the window.
|
|
CONFIG_NXFONTS_CHARBITS
|
|
The number of bits in the character set. Current options are only 7 and 8.
|
|
The default is 7.
|
|
CONFIG_NXFONT_SANS
|
|
At present, there is only one font. But if there were were more, then this
|
|
option would select the sans serif font.
|
|
|
|
NX Multi-user only options:
|
|
|
|
CONFIG_NX_BLOCKING
|
|
Open the client message queues in blocking mode. In this case,
|
|
nx_eventhandler() will not return until a message is received and processed.
|
|
CONFIG_NX_MXSERVERMSGS and CONFIG_NX_MXCLIENTMSGS
|
|
Specifies the maximum number of messages that can fit in the message queues.
|
|
No additional resources are allocated, but this can be set to prevent
|
|
flooding of the client or server with too many messages (CONFIG_PREALLOC_MQ_MSGS
|
|
controls how many messages are pre-allocated).
|
|
|
|
|