/* Copyright (c) 2013 The Chromium Authors. All rights reserved.
* Use of this source code is governed by a BSD-style license that can be
* found in the LICENSE file. */
#ifndef PPAPI_SIMPLE_PS_EVENT_H_
#define PPAPI_SIMPLE_PS_EVENT_H_
#include "ppapi/c/pp_bool.h"
#include "ppapi/c/pp_resource.h"
#include "ppapi/c/pp_var.h"
#include "sdk_util/macros.h"
EXTERN_C_BEGIN
/**
* PSEvent
*
* The PSEvent system provides an in-order event processing mechanism.
* As Pepper events such as input, or focus and view changes arrive on the
* main pepper thread, they are placed on various FIFOs based on event type.
* For any given event type, only a single thread will process those events.
*
* By default, the "EventThread" will receive all messages. However any thread
* can call PSRequestEventsType to request that all new events of that type
* are placed on that particular thread's queue.
*
* This allows the developer to choose which threads handle which event types
* while keeping all events belonging to a particular thread in order. This
* is useful, for example, in the case of graphics to synchronize the size
* of the graphics context, with mouse clicks to correctly interpret location.
*/
typedef enum {
/* Mask off all events. */
PSE_NONE = 0,
/* From HandleInputEvent, conatins an input resource. */
PSE_INSTANCE_HANDLEINPUT = 1,
/* From HandleMessage, contains a PP_Var. */
PSE_INSTANCE_HANDLEMESSAGE = 2,
/* From DidChangeView, contains a view resource */
PSE_INSTANCE_DIDCHANGEVIEW = 4,
/* From DidChangeFocus, contains a PP_Bool with the current focus state. */
PSE_INSTANCE_DIDCHANGEFOCUS = 8,
/* When the 3D context is lost, no resource. */
PSE_GRAPHICS3D_GRAPHICS3DCONTEXTLOST = 16,
/* When the mouse lock is lost. */
PSE_MOUSELOCK_MOUSELOCKLOST = 32,
/* Enable all events. */
PSE_ALL = -1,
} PSEventType;
typedef uint32_t PSEventTypeMask;
// Generic Event
typedef struct {
PSEventType type;
union {
PP_Bool as_bool;
PP_Resource as_resource;
struct PP_Var as_var;
};
} PSEvent;
/**
* Function for queuing, acquiring, and releasing events.
*/
PSEvent* PSEventTryAcquire();
PSEvent* PSEventWaitAcquire();
void PSEventRelease(PSEvent* event);
void PSEventSetFilter(PSEventTypeMask mask);
/**
* Creates and adds an event of the specified type to the event queue if
* that event type is not currently filtered.
*/
void PSEventPost(PSEventType type);
void PSEventPostBool(PSEventType type, PP_Bool state);
void PSEventPostVar(PSEventType type, struct PP_Var var);
void PSEventPostResource(PSEventType type, PP_Resource resource);
EXTERN_C_END
#endif /* PPAPI_SIMPLE_PS_EVENT_H_ */