nuttx-apps/libnxwidgets/include/cnxserver.hxx

/****************************************************************************
 * NxWidgets/libnxwidgets/include/cnxserver.hxx
 *
 *   Copyright (C) 2012 Gregory Nutt. All rights reserved.
 *   Author: Gregory Nutt <gnutt@nuttx.org>
 *
 * 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.
 *
 ****************************************************************************/

#ifndef __INCLUDE_CNXSERVER_HXX
#define __INCLUDE_CNXSERVER_HXX

/****************************************************************************
 * Included Files
 ****************************************************************************/

#include <nuttx/config.h>

#include <stdint.h>
#include <stdbool.h>
#include <semaphore.h>

#include <nuttx/nx/nx.h>

#include "cnxwindow.hxx"
#include "cnxtkwindow.hxx"
#include "cbgwindow.hxx"

/****************************************************************************
 * Pre-Processor Definitions
 ****************************************************************************/

/****************************************************************************
 * Implementation Classes
 ****************************************************************************/

#if defined(__cplusplus)

namespace NXWidgets
{
  /**
   * Forward references
   */

  class CBgWindow;

  /**
   * This class represents the NX server.  It includes methods to connect to
   * and disconnect form the NX server, methods to manage the background, and
   * "factory" methods to create window objects on the NX server.  NXWidget
   * objects them may be created on the window objects.
   */

  class CNxServer
  {
  private:
    FAR NX_DRIVERTYPE *m_hDevice;    /**< LCD/Framebuffer device handle */
    NXHANDLE           m_hNxServer;  /**< NX server handle */
#ifdef CONFIG_NX_MULTIUSER
    volatile bool      m_running;    /**< True: The listener thread is running */
    volatile bool      m_connected;  /**< True: Connected to the server */
    volatile bool      m_stop;       /**< True: Waiting for the listener thread to stop */
    sem_t              m_connsem;    /**< Wait for server connection */
#endif
    static uint8_t     m_nServers;   /**< The number of NX server instances */

    /**
     * NX server thread.  This is the entry point into the server thread that
     * serializes the multi-threaded accesses to the display.
     */

#if defined(CONFIG_NX_MULTIUSER) && defined(CONFIG_NXWIDGET_SERVERINIT)
    static int server(int argc, char *argv[]);
#endif

    /**
     * NX listener thread.  This is the entry point of a thread that listeners for and
     * dispatches events from the NX server.
     */

#ifdef CONFIG_NX_MULTIUSER
    static FAR void *listener(FAR void *arg);
#endif

  public:

    /**
     * CNXServer constructor.  The CNxServer is a normally singleton.  However, that
     * not enforced:  This constructor could run more than one in the situation where
     * there are multiple physical displays.  However, that configuration has never
     * been texted.
     */

    CNxServer(void);

    /**
     * CNXServer destructor
     */

    ~CNxServer(void);

    /**
     * Connect to the NX Server
     */

    virtual bool connect(void);

    /**
     * Disconnect from the NX Server
     */

    virtual void disconnect(void);

    /**
     * Get the NX server handle
     *
     * @return The NX server handler (NULL is not connected)
     */

    inline NXHANDLE getServer(void)
    {
      return m_hNxServer;
    }

    /**
     * Test if we are connected to the NX server.
     *
     * @return True is connected; false is not connected.
     */

    inline bool connected(void)
    {
#ifdef CONFIG_NX_MULTIUSER
      return m_connected;
#else
      return true;
#endif
    }

    /**
     * Set the background color
     */

     inline bool setBackgroundColor(nxgl_mxpixel_t color)
     {
       return nx_setbgcolor(m_hNxServer, &color) == OK;
     }

    /**
     * Get an instance of a raw NX window.
     */

    inline CNxWindow *createRawWindow(CWidgetControl *widgetControl)
    {
      return new CNxWindow(m_hNxServer, widgetControl);
    }

    /**
     * Get an instance of the framed NX window.
     */

    inline CNxTkWindow *createFramedWindow(CWidgetControl *widgetControl)
    {
      return new CNxTkWindow(m_hNxServer, widgetControl);
    }

    /**
     * Get an instance of the background window.
     */

    inline CBgWindow *getBgWindow(CWidgetControl *widgetControl)
    {
      return new CBgWindow(m_hNxServer, widgetControl);
    }
  };
}

#endif // __cplusplus

#endif // __INCLUDE_CNXSERVER_HXX