gecko-dev/widget/gonk/nsAppShell.h

/* ***** BEGIN LICENSE BLOCK *****
 * Version: MPL 1.1/GPL 2.0/LGPL 2.1
 *
 * The contents of this file are subject to the Mozilla Public License Version
 * 1.1 (the "License"); you may not use this file except in compliance with
 * the License. You may obtain a copy of the License at
 * http://www.mozilla.org/MPL/
 *
 * Software distributed under the License is distributed on an "AS IS" basis,
 * WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License
 * for the specific language governing rights and limitations under the
 * License.
 *
 * The Original Code is Gonk.
 *
 * The Initial Developer of the Original Code is
 * the Mozilla Foundation.
 * Portions created by the Initial Developer are Copyright (C) 2011
 * the Initial Developer. All Rights Reserved.
 *
 * Contributor(s):
 *   Michael Wu <mwu@mozilla.com>
 *
 * Alternatively, the contents of this file may be used under the terms of
 * either the GNU General Public License Version 2 or later (the "GPL"), or
 * the GNU Lesser General Public License Version 2.1 or later (the "LGPL"),
 * in which case the provisions of the GPL or the LGPL are applicable instead
 * of those above. If you wish to allow use of your version of this file only
 * under the terms of either the GPL or the LGPL, and not to allow others to
 * use your version of this file under the terms of the MPL, indicate your
 * decision by deleting the provisions above and replace them with the notice
 * and other provisions required by the GPL or the LGPL. If you do not delete
 * the provisions above, a recipient may use your version of this file under
 * the terms of any one of the MPL, the GPL or the LGPL.
 *
 * ***** END LICENSE BLOCK ***** */

#ifndef nsAppShell_h
#define nsAppShell_h

#include "nsBaseAppShell.h"
#include "nsRect.h"
#include "nsTArray.h"

namespace mozilla {
bool ProcessNextEvent();
void NotifyEvent();
}

extern bool gDrawRequest;

class FdHandler;
typedef void(*FdHandlerCallback)(int, FdHandler *);

class FdHandler {
public:
    FdHandler()
        : mtState(MT_START)
        , keyCode(0)
        , mtDown(false)
        , calibrated(false)
    {
        memset(name, 0, sizeof(name));
    }

    int fd;
    char name[64];
    FdHandlerCallback func;
    enum mtStates {
        MT_START,
        MT_COLLECT,
        MT_IGNORE
    } mtState;
    int mtX, mtY;
    int mtMajor;
    int keyCode;
    bool mtDown;
    // FIXME/bug 712973: we should be using libui here instead of
    // recreating all that logic ourselves.  Please don't extend the
    // hacks here further than what's below.
    bool calibrated;
    // Multitouch events are delivered to us in "input space", which
    // is a coordinate space defined by the multitouch device driver.
    // The coordinate space has top-left at P_min = <inputMinX,
    // inputMinY> when in normal-portrait orientation.  The input
    // device and the screen might have different resolutions.  The
    // resolution difference is Scale = <inputToScreenScaleX,
    // inputToScreenScaleY>.  So going from input to screen space
    // (when in normal portrait orientation) is an affine transform
    // defined by
    //
    //   P_screen = Scale * (P_input - P_min)
    //
    int inputMinX, inputMinY;
    float inputToScreenScaleX, inputToScreenScaleY;
    // Some touch devices use virtual buttons instead of hardware
    // buttons.  When the device uses vbuttons, we convert touch
    // events into key events of type |keyCode| when the start of the
    // touch is within |buttonRect|.  |buttonRect| must be disjoint
    // from the screen rect.
    static const size_t kMaxVButtons = 4;
    struct VButton {
        nsIntRect buttonRect;   // in screen space
        int keyCode;
    } vbuttons[kMaxVButtons];

    void run()
    {
        func(fd, this);
    }

    int inputXToScreenX(int inputX) {
        return inputToScreenScaleX * (inputX - inputMinX);
    }
    int inputYToScreenY(int inputY) {
        return inputToScreenScaleY * (inputY - inputMinY);
    }
};

class nsAppShell : public nsBaseAppShell {
public:
    nsAppShell();

    nsresult Init();
    virtual bool ProcessNextNativeEvent(bool maywait);

    void NotifyNativeEvent();

protected:
    virtual ~nsAppShell();

    virtual void ScheduleNativeEventCallback();

private:
    nsresult AddFdHandler(int fd, FdHandlerCallback handlerFunc,
                          const char* deviceName);

    // This is somewhat racy but is perfectly safe given how the callback works
    bool mNativeCallbackRequest;
    nsTArray<FdHandler> mHandlers;
};

#endif /* nsAppShell_h */