24733abf68
Add a CoglFrameInfo object that tracks timing information for frames that are drawn. We track a frame counter and frame timing information for each CoglOnscreen. Internally a CoglFrameInfo is automatically created for each frame, delimited by cogl_onscreen_swap_buffers() or cogl_onscreen_swap_region() calls. CoglFrameInfos are delivered to applications via frame event callbacks that can be registered with a new cogl_onscreen_add_frame_callback() api. Two initial event types (dispatched on all platforms) have been defined; a _SYNC event used for throttling the frame rate of applications and a _COMPLETE event used so signify the end of a frame. Note: This new _add_frame_callback() api makes the cogl_onscreen_add_swap_complete_callback() api redundant and so it should be considered deprecated. Since the _add_swap_complete_callback() api is still experimental api, we will be looking to quickly migrate users to the new api so we can remove the old api. Reviewed-by: Robert Bragg <robert@linux.intel.com> (cherry picked from commit 700401667db2522045e4623d78797b17f9184501)
125 lines
2.9 KiB
C
125 lines
2.9 KiB
C
/*
|
|
* Cogl
|
|
*
|
|
* An object oriented GL/GLES Abstraction/Utility Layer
|
|
*
|
|
* Copyright (C) 2011 Intel Corporation.
|
|
*
|
|
* This library is free software; you can redistribute it and/or
|
|
* modify it under the terms of the GNU Lesser General Public
|
|
* License as published by the Free Software Foundation; either
|
|
* version 2 of the License, or (at your option) any later version.
|
|
*
|
|
* This library is distributed in the hope that it will be useful,
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
* Lesser General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU Lesser General Public
|
|
* License along with this library. If not, see <http://www.gnu.org/licenses/>.
|
|
*
|
|
*
|
|
*/
|
|
|
|
#ifndef __COGL_ONSCREEN_PRIVATE_H
|
|
#define __COGL_ONSCREEN_PRIVATE_H
|
|
|
|
#include "cogl-onscreen.h"
|
|
#include "cogl-framebuffer-private.h"
|
|
#include "cogl-queue.h"
|
|
|
|
#include <glib.h>
|
|
|
|
#ifdef COGL_HAS_WIN32_SUPPORT
|
|
#include <windows.h>
|
|
#endif
|
|
|
|
COGL_TAILQ_HEAD (CoglFrameCallbackList, CoglFrameClosure);
|
|
|
|
struct _CoglFrameClosure
|
|
{
|
|
COGL_TAILQ_ENTRY (CoglFrameClosure) list_node;
|
|
|
|
CoglFrameCallback callback;
|
|
|
|
void *user_data;
|
|
CoglUserDataDestroyCallback destroy;
|
|
};
|
|
|
|
typedef struct _CoglResizeNotifyEntry CoglResizeNotifyEntry;
|
|
|
|
COGL_TAILQ_HEAD (CoglResizeNotifyList, CoglResizeNotifyEntry);
|
|
|
|
struct _CoglResizeNotifyEntry
|
|
{
|
|
COGL_TAILQ_ENTRY (CoglResizeNotifyEntry) list_node;
|
|
|
|
CoglOnscreenResizeCallback callback;
|
|
void *user_data;
|
|
unsigned int id;
|
|
};
|
|
|
|
typedef struct _CoglOnscreenEvent CoglOnscreenEvent;
|
|
|
|
COGL_TAILQ_HEAD (CoglOnscreenEventList, CoglOnscreenEvent);
|
|
|
|
struct _CoglOnscreenEvent
|
|
{
|
|
COGL_TAILQ_ENTRY (CoglOnscreenEvent) list_node;
|
|
|
|
CoglOnscreen *onscreen;
|
|
CoglFrameInfo *info;
|
|
CoglFrameEvent type;
|
|
};
|
|
|
|
struct _CoglOnscreen
|
|
{
|
|
CoglFramebuffer _parent;
|
|
|
|
#ifdef COGL_HAS_X11_SUPPORT
|
|
uint32_t foreign_xid;
|
|
CoglOnscreenX11MaskCallback foreign_update_mask_callback;
|
|
void *foreign_update_mask_data;
|
|
#endif
|
|
|
|
#ifdef COGL_HAS_WIN32_SUPPORT
|
|
HWND foreign_hwnd;
|
|
#endif
|
|
|
|
CoglBool swap_throttled;
|
|
|
|
CoglFrameCallbackList frame_closures;
|
|
|
|
CoglBool resizable;
|
|
CoglResizeNotifyList resize_callbacks;
|
|
|
|
int64_t frame_counter;
|
|
int64_t swap_frame_counter; /* frame counter at last all to
|
|
* cogl_onscreen_swap_region() or
|
|
* cogl_onscreen_swap_buffers() */
|
|
GQueue pending_frame_infos;
|
|
|
|
void *winsys;
|
|
};
|
|
|
|
CoglOnscreen *
|
|
_cogl_onscreen_new (void);
|
|
|
|
void
|
|
_cogl_framebuffer_winsys_update_size (CoglFramebuffer *framebuffer,
|
|
int width, int height);
|
|
|
|
void
|
|
_cogl_onscreen_notify_frame_sync (CoglOnscreen *onscreen, CoglFrameInfo *info);
|
|
|
|
void
|
|
_cogl_onscreen_notify_complete (CoglOnscreen *onscreen, CoglFrameInfo *info);
|
|
|
|
void
|
|
_cogl_onscreen_notify_resize (CoglOnscreen *onscreen);
|
|
|
|
void
|
|
_cogl_dispatch_onscreen_events (CoglContext *context);
|
|
|
|
#endif /* __COGL_ONSCREEN_PRIVATE_H */
|