/******************************************************************************************** * NxWidgets/nxwm/src/cstartwindow.cxx * * Copyright (C) 2012 Gregory Nutt. All rights reserved. * Author: Gregory Nutt * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions * are met: * * 1. Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * 2. Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in * the documentation and/or other materials provided with the * distribution. * 3. Neither the name NuttX, NxWidgets, nor the names of its contributors * me be used to endorse or promote products derived from this software * without specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE * COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS * OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED * AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN * ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. * ********************************************************************************************/ /******************************************************************************************** * Included Files ********************************************************************************************/ #include #include #include #include #include #include #include "cwidgetcontrol.hxx" #include "nxwmconfig.hxx" #include "nxwmglyphs.hxx" #include "ctaskbar.hxx" #include "cstartwindow.hxx" /******************************************************************************************** * Pre-Processor Definitions ********************************************************************************************/ /******************************************************************************************** * Global Data ********************************************************************************************/ /** * The well-known name for the Start Window's message queue. */ FAR const char *NxWM::g_startWindowMqName = CONFIG_NXWM_STARTWINDOW_MQNAME; /******************************************************************************************** * CStartWindow Method Implementations ********************************************************************************************/ using namespace NxWM; /** * CStartWindow Constructor * * @param taskbar. A pointer to the parent task bar instance * @param window. The window to be used by this application. */ CStartWindow::CStartWindow(CTaskbar *taskbar, CApplicationWindow *window) { // Save the constructor data m_taskbar = taskbar; m_window = window; // The start window task is not running m_taskId = -1; // Add our personalized window label NXWidgets::CNxString myName = getName(); window->setWindowLabel(myName); // Add our callbacks to the application window window->registerCallbacks(static_cast(this)); } /** * CStartWindow Constructor */ CStartWindow::~CStartWindow(void) { // There would be a problem if we were stopped with the start window task // running... that should never happen but we'll check anyway: stop(); // Although we didn't create it, we are responsible for deleting the // application window delete m_window; // Then stop and delete all applications removeAllApplications(); } /** * Each implementation of IApplication must provide a method to recover * the contained IApplicationWindow instance. */ IApplicationWindow *CStartWindow::getWindow(void) const { return static_cast(m_window); } /** * Get the icon associated with the application * * @return An instance if IBitmap that may be used to rend the * application's icon. This is an new IBitmap instance that must * be deleted by the caller when it is no long needed. */ NXWidgets::IBitmap *CStartWindow::getIcon(void) { NXWidgets::CRlePaletteBitmap *bitmap = new NXWidgets::CRlePaletteBitmap(&CONFIG_NXWM_STARTWINDOW_ICON); return bitmap; } /** * Get the name string associated with the application * * @return A copy if CNxString that contains the name of the application. */ NXWidgets::CNxString CStartWindow::getName(void) { return NXWidgets::CNxString("Start Window"); } /** * Start the application. * * @return True if the application was successfully started. */ bool CStartWindow::run(void) { // Some sanity checking if (m_taskId >= 0) { // The start window task is already running??? return false; } // Start the start window task m_taskId = TASK_CREATE("StartWindow", CONFIG_NXWM_STARTWINDOW_PRIO, CONFIG_NXWM_STARTWINDOW_STACKSIZE, startWindow, (FAR const char **)0); // Did we successfully start the NxConsole task? return m_taskId >= 0; } /** * Stop the application. */ void CStartWindow::stop(void) { // Delete the start window task --- what are we doing? This should never // happen because the start window task is persistent! if (m_taskId >= 0) { // Call task_delete(), possibly stranding resources pid_t pid = m_taskId; m_taskId = -1; // Then delete the NSH task task_delete(pid); } } /** * Destroy the application and free all of its resources. This method * will initiate blocking of messages from the NX server. The server * will flush the window message queue and reply with the blocked * message. When the block message is received by CWindowMessenger, * it will send the destroy message to the start window task which * will, finally, safely delete the application. */ void CStartWindow::destroy(void) { // What are we doing? This should never happen because the start // window task is persistent! // Block any further window messages m_window->block(this); // Make sure that the application is stopped stop(); } /** * The application window is hidden (either it is minimized or it is * maximized, but not at the top of the hierarchy */ void CStartWindow::hide(void) { // Disable drawing and events on all icons for (int i = 0; i < m_slots.size(); i++) { NXWidgets::CImage *image = m_slots.at(i).image; image->disableDrawing(); image->setRaisesEvents(false); } } /** * Redraw the entire window. The application has been maximized or * otherwise moved to the top of the hiearchy */ void CStartWindow::redraw(void) { // Recover the NXTK window instance contained in the application window NXWidgets::INxWindow *window = m_window->getWindow(); // Get the widget control associated with the NXTK window NXWidgets::CWidgetControl *control = window->getWidgetControl(); // Get the graphics port for drawing on the widget control NXWidgets::CGraphicsPort *port = control->getGraphicsPort(); // Get the size of the application window struct nxgl_size_s windowSize; if (!window->getSize(&windowSize)) { return; } // Fill the entire window with the background color port->drawFilledRect(0, 0, windowSize.w, windowSize.h, CONFIG_NXWM_DEFAULT_BACKGROUNDCOLOR); // Begin adding icons in the upper left corner struct nxgl_point_s iconPos; iconPos.x = CONFIG_NXWM_STARTWINDOW_HSPACING; iconPos.y = CONFIG_NXWM_STARTWINDOW_VSPACING; // Add each icon in the list of applications for (int i = 0; i < m_slots.size(); i++) { // Get the icon associated with this application NXWidgets::CImage *image = m_slots.at(i).image; // Disable drawing of the icon image; disable events from the icon image->disableDrawing(); image->setRaisesEvents(false); // Get the size of the icon image NXWidgets::CRect rect; image->getPreferredDimensions(rect); // Center the image in the region defined by the maximum icon size struct nxgl_point_s imagePos; imagePos.x = iconPos.x; imagePos.y = iconPos.y; if (rect.getWidth() < m_iconSize.w) { imagePos.x += ((m_iconSize.w - rect.getWidth()) >> 1); } if (rect.getHeight() < m_iconSize.h) { imagePos.y += ((m_iconSize.h - rect.getHeight()) >> 1); } // Set the position of the icon bitmap image->moveTo(imagePos.x, imagePos.y); // Then re-draw the icon at the new position image->enableDrawing(); image->redraw(); image->setRaisesEvents(true); // Advance the next icon position to the left iconPos.x += m_iconSize.w + CONFIG_NXWM_TASKBAR_HSPACING; // If there is insufficient space on on this row for the next // max-sized icon, then advance to the next row if (iconPos.x + m_iconSize.w >= windowSize.w) { iconPos.x = CONFIG_NXWM_STARTWINDOW_HSPACING; iconPos.y += m_iconSize.h + CONFIG_NXWM_TASKBAR_VSPACING; // Don't try drawing past the bottom of the window if (iconPos.y >= windowSize.w) { break; } } } } /** * Report of this is a "normal" window or a full screen window. The * primary purpose of this method is so that window manager will know * whether or not it show draw the task bar. * * @return True if this is a full screen window. */ bool CStartWindow::isFullScreen(void) const { return m_window->isFullScreen(); } /** * Add the application to the start window. The general sequence is: * * 1. Call IAppicationFactory::create to a new instance of the application * 2. Call CStartWindow::addApplication to add the application to the * start window. * * @param app. The new application to add to the start window * @return true on success */ bool CStartWindow::addApplication(IApplicationFactory *app) { // Recover the NXTK window instance contained in the application window NXWidgets::INxWindow *window = m_window->getWindow(); // Get the widget control associated with the NXTK window NXWidgets::CWidgetControl *control = window->getWidgetControl(); // Get the bitmap icon that goes with this application NXWidgets::IBitmap *bitmap = app->getIcon(); // Create a CImage instance to manage the application icon NXWidgets::CImage *image = new NXWidgets::CImage(control, 0, 0, bitmap->getWidth(), bitmap->getHeight(), bitmap, 0); if (!image) { return false; } // Configure the image, disabling drawing for now image->setBorderless(true); image->disableDrawing(); // Register to get events from the mouse clicks on the image image->addWidgetEventHandler(this); // Add the application to end of the list of applications managed by // the start window struct SStartWindowSlot slot; slot.app = app; slot.image = image; m_slots.push_back(slot); // Re-calculate the icon bounding box getIconBounds(); return true; } /** * Simulate a mouse click or release on the icon at index. This method * is only available during automated testing of NxWM. * * @param index. Selects the icon in the start window * @param click. True to click and false to release */ #if defined(CONFIG_NXWM_UNITTEST) && !defined(CONFIG_NXWM_TOUCHSCREEN) void CStartWindow::clickIcon(int index, bool click) { if (index < m_slots.size()) { // Get the image widget at this index NXWidgets::CImage *image = m_slots.at(index).image; // Get the size and position of the widget struct nxgl_size_s imageSize; image->getSize(imageSize); struct nxgl_point_s imagePos; image->getPos(imagePos); // And click or release the image at its center if (click) { image->click(imagePos.x + (imageSize.w >> 1), imagePos.y + (imageSize.h >> 1)); } else { image->release(imagePos.x + (imageSize.w >> 1), imagePos.y + (imageSize.h >> 1)); } } } #endif /** * Called when the window minimize button is pressed. */ void CStartWindow::minimize(void) { m_taskbar->minimizeApplication(static_cast(this)); } /** * Called when the window minimize close is pressed. */ void CStartWindow::close(void) { // Do nothing... you can't close the start window!!! } /** * Calculate the icon bounding box */ void CStartWindow::getIconBounds(void) { // Visit each icon struct nxgl_size_s maxSize; maxSize.w = 0; maxSize.h = 0; for (int i = 0; i < m_slots.size(); i++) { // Get the icon associated with this application NXWidgets::CImage *image = m_slots.at(i).image; // Get the size of the icon image NXWidgets::CRect rect; image->getPreferredDimensions(rect); // Keep the maximum height and width if (rect.getWidth() > maxSize.h) { maxSize.w = rect.getWidth() ; } if (rect.getHeight() > maxSize.h) { maxSize.h = rect.getHeight(); } } // And save the new maximum size m_iconSize.w = maxSize.w; m_iconSize.h = maxSize.h; } /** * Stop all applications */ void CStartWindow::removeAllApplications(void) { // Stop all applications and remove them from the start window. Clearly, there // are some ordering issues here... On an orderly system shutdown, disconnection // should really occur priority to deleting instances while (!m_slots.empty()) { // Remove the application factory from the start menu IApplicationFactory *app = m_slots.at(0).app; // Now, delete the image and the application delete app; delete m_slots.at(0).image; // And discard the data in this slot m_slots.erase(0); } } /** * Handle a widget action event. For CImage, this is a mouse button pre-release event. * * @param e The event data. */ void CStartWindow::handleActionEvent(const NXWidgets::CWidgetEventArgs &e) { // Was an ICON clicked? for (int i = 0; i < m_slots.size(); i++) { // Is this the clicked icon? NXWidgets::CImage *image = m_slots.at(i).image; if (image->isClicked()) { // Create a new copy of the application IApplication *app = m_slots.at(i).app->create(); if (app) { // Start the new copy of the application if (m_taskbar->startApplication(app, false)) { // Then break out of the loop break; } else { // If we cannot start the app. Destroy the instance we // created and see what happens next. Could be interesting. app->stop(); app->destroy(); } } } } } /** * This is the start window task. This function receives window events from * the NX listener threads indirectly through this sequence: * * 1. NX listener thread receives a windows event. This may be a * positional change notification, a redraw request, or mouse or * keyboard input. * 2. The NX listener thread performs the callback by calling a * NXWidgets::CCallback method associated with the window. * 3. NXWidgets::CCallback calls into NXWidgets::CWidgetControl to process * the event. * 4. NXWidgets::CWidgetControl records the new state data and raises a * window event. * 5. NXWidgets::CWindowEventHandlerList will give the event to * NxWM::CWindowMessenger. * 6. NxWM::CWindowMessenger will send the a message on a well-known message * queue. * 7. This CStartWindow::startWindow task will receive and process that * message. */ int CStartWindow::startWindow(int argc, char *argv[]) { /* Open a well-known message queue for reading */ struct mq_attr attr; attr.mq_maxmsg = CONFIG_NXWM_STARTWINDOW_MXMSGS; attr.mq_msgsize = sizeof(struct SStartWindowMessage); attr.mq_flags = 0; mqd_t mqd = mq_open(g_startWindowMqName, O_RDONLY|O_CREAT, 0666, &attr); if (mqd == (mqd_t)-1) { gdbg("ERROR: mq_open(%s) failed: %d\n", g_startWindowMqName, errno); return EXIT_FAILURE; } // Now loop forever, receiving and processing messages. Ultimately, all // widget driven events (button presses, etc.) are driven by this logic // on this thread. for (;;) { // Receive the next message struct SStartWindowMessage msg; ssize_t nbytes = mq_receive(mqd, &msg, sizeof(struct SStartWindowMessage), 0); if (nbytes < 0) { int errval = errno; // EINTR is not an error. The wait was interrupted by a signal and // we just need to try reading again. if (errval != EINTR) { gdbg("ERROR: mq_receive failed: %d\n", errval); } } while (nbytes < 0); gvdbg("Received msgid=%d nbytes=%d\n", msg.msgId, nbytes); DEBUGASSERT(nbytes = sizeof(struct SStartWindowMessage) && msg.instance); // Dispatch the message to the appropriate CWidgetControl and to the // appropriate CWidgetControl method switch (msg.msgId) { break; case MSGID_MOUSE_INPUT: // New mouse input is available case MSGID_KEYBOARD_INPUT: // New keyboard input is available { // Handle all new window input events by calling the CWidgetControl::pollEvents() method NXWidgets::CWidgetControl *control = (NXWidgets::CWidgetControl *)msg.instance; control->pollEvents(); } break; case MSGID_DESTROY_APP: // Destroy the application { // Handle all destroy application events gdbg("Deleting app=%p\n", msg.instance); IApplication *app = (IApplication *)msg.instance; delete app; } break; case MSGID_POSITIONAL_CHANGE: // Change in window positional data (not used) case MSGID_REDRAW_REQUEST: // Request to redraw a portion of the window (not used) default: gdbg("ERROR: Unrecognized or unsupported msgId: %d\n", (int)msg.msgId); break; } } }