diff --git a/graphics/twm4nx/README.txt b/graphics/twm4nx/README.txt index dc2ae6e91..679767d3b 100644 --- a/graphics/twm4nx/README.txt +++ b/graphics/twm4nx/README.txt @@ -47,14 +47,14 @@ Progress: and eventually hangs. 2019-05-08: I abandoned the VNC interface and found that things are much better using a direct, hardware framebuffer. The background comes up - properly and the Icon Manager appears properly in the upper rightthand - corner. The Icon Manager Window can be iconfified or de-inconified. + properly and the Icon Manager appears properly in the upper right hand + corner. The Icon Manager Window can be iconified or de-iconified. The Icon Manager window can be grabbed by the toolbar title and moved about on the window (the movement is not very smooth on the particular hardware that I am working with). 2019-05-10: A left click on the background brings up the main menu. At present there are only two options: "Desktop" which will iconify all - windows and "Twm4Nx Icon Manager" which will de-configy and/or raise + windows and "Twm4Nx Icon Manager" which will de-iconify and/or raise the Icon Manager window to the top of the hierarchy. That latter option is only meaningful when the desktop is very crowded. 2019-05-13: Added the NxTerm application. If enabled via @@ -64,31 +64,20 @@ Progress: 2019-05-14: We can now move an icon on the desktop. Includes logic to avoid collisions with other icons and with the background image. That later is an issue. The background image image widget needs to be - removed; it can occlude a dektop icon. We need to paint the image + removed; it can occlude a desktop icon. We need to paint the image directly on the background without the use of a widget. 2019-05-15: Resizing now seems to work correctly in Twm4Nx. How To: - Move a Window: - - Grab the title in the toolbar and move the window to the desired - postion. + Icon Manager + - At start up, only the Icon Manager window is shown. The Icon Manager + is a TWM alternative to more common desktop icons. Currently Twm4Nx + supports both desktop icons and the Icon Manager. - Resize a Window: - - A window must have the green resize button with the square or it - cannot be resized. - - Press resize button. A small window should pop-up in the upper - left hand corner showing the current window size. - - Touch anywhere in window (not the toolbar) and slide your finger. - The resize window will show the new size but there will be no other - update to the display. It is thought that continous size updates - would overwhelm lower end MCUs. Movements support include: - - o Move toward the right increases the width of the window - o Move toward the left decreases the width of the window - o Move toward the bottom increases the height of the window - o Move toward the top decreases the heght of the Window - o Other moves will affect both the height and width of the window. + Whenever a new application is started from the Main Menu, its name + shows up in the Icon Manager. Selecting the name will either de- + iconify the window, or just raise it to the top of the display. Main Menu: - A touch/click at any open location on the background (except the @@ -98,7 +87,42 @@ How To: o Desktop. Iconify all windows and show the desktop o Twm4Nx Icom Manager. De-iconify and/or raise the Icon Manager to the top of the display - o NuttShell. Start and instance of NSH runnin in an NxTerm. + o NuttShell. Start and instance of NSH running in an NxTerm. + + Window Toolbar + - Most windows have a toolbar at the top. It is optional but used + in most windows. + - The toolbar contains window title and from zero to 4 buttons: + + o Right side: A menu button may be presented. The menu button + is not used by anything in the current implementation and is + always suppressed + o Left side: The far left is (1)the terminate button (if present). + If present, it will close window when selected. Not all windows can + be closed. You can't close the Icon Manager or menu windows, for + example. Then (2) a resize button. If presented and is selected, + then the resize sequence described below it started. This may + the be preceded by a minimize button that iconifies the window. + + Moving a Window: + - Grab the title in the toolbar and move the window to the desired + position. + + Resizing a Window: + - A window must have the green resize button with the square or it + cannot be resized. + - Press resize button. A small window should pop-up in the upper + left hand corner showing the current window size. + - Touch anywhere in window (not the toolbar) and slide your finger. + The resize window will show the new size but there will be no other + update to the display. It is thought that continuous size updates + would overwhelm lower end MCUs. Movements support include: + + o Move toward the right increases the width of the window + o Move toward the left decreases the width of the window + o Move toward the bottom increases the height of the window + o Move toward the top decreases the height of the Window + o Other moves will affect both the height and width of the window. Issues: