3161f1b0e6
This adds cogl_onscreen_template_set_swap_throttled() api that allows developers to specify their preference for swap buffer throttling up-front as part of the onscreen template that is used to create a CoglDisplay when initializing Cogl. This is desirable because some platforms may not support configuring swap throttling on a per framebuffer basis and also since applications often want to apply the same policy to all onscreen framebuffers anyway.
94 lines
3.0 KiB
C
94 lines
3.0 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/>.
|
|
*
|
|
* Authors:
|
|
* Robert Bragg <robert@linux.intel.com>
|
|
*
|
|
*/
|
|
|
|
#if !defined(__COGL_H_INSIDE__) && !defined(CLUTTER_COMPILATION)
|
|
#error "Only <cogl/cogl.h> can be included directly."
|
|
#endif
|
|
|
|
#ifndef __COGL_ONSCREEN_TEMPLATE_H__
|
|
#define __COGL_ONSCREEN_TEMPLATE_H__
|
|
|
|
#include <cogl/cogl-swap-chain.h>
|
|
|
|
G_BEGIN_DECLS
|
|
|
|
typedef struct _CoglOnscreenTemplate CoglOnscreenTemplate;
|
|
|
|
#define COGL_ONSCREEN_TEMPLATE(OBJECT) ((CoglOnscreenTemplate *)OBJECT)
|
|
|
|
#define cogl_onscreen_template_new cogl_onscreen_template_new_EXP
|
|
CoglOnscreenTemplate *
|
|
cogl_onscreen_template_new (CoglSwapChain *swap_chain);
|
|
|
|
/**
|
|
* cogl_onscreen_template_set_samples_per_pixel:
|
|
* @onscreen: A #CoglOnscreenTemplate template framebuffer
|
|
* @n: The minimum number of samples per pixel
|
|
*
|
|
* Requires that any future CoglOnscreen framebuffers derived from
|
|
* this template must support making at least @n samples per pixel
|
|
* which will all contribute to the final resolved color for that
|
|
* pixel.
|
|
*
|
|
* By default this value is usually set to 0 and that is referred to
|
|
* as "single-sample" rendering. A value of 1 or greater is referred
|
|
* to as "multisample" rendering.
|
|
*
|
|
* <note>There are some semantic differences between single-sample
|
|
* rendering and multisampling with just 1 point sample such as it
|
|
* being redundant to use the cogl_framebuffer_resolve_samples() and
|
|
* cogl_framebuffer_resolve_samples_region() apis with single-sample
|
|
* rendering.</note>
|
|
*
|
|
* Since: 1.10
|
|
* Stability: unstable
|
|
*/
|
|
void
|
|
cogl_onscreen_template_set_samples_per_pixel (
|
|
CoglOnscreenTemplate *onscreen_template,
|
|
int n);
|
|
|
|
/**
|
|
* cogl_onscreen_template_set_swap_throttled:
|
|
* @onscreen_template: A #CoglOnscreenTemplate template framebuffer
|
|
* @throttled: Whether throttling should be enabled
|
|
*
|
|
* Requests that any future #CoglOnscreen framebuffers derived from this
|
|
* template should enable or disable swap throttling according to the given
|
|
* @throttled argument.
|
|
*
|
|
* Since: 1.10
|
|
* Stability: unstable
|
|
*/
|
|
void
|
|
cogl_onscreen_template_set_swap_throttled (
|
|
CoglOnscreenTemplate *onscreen_template,
|
|
gboolean throttled);
|
|
|
|
G_END_DECLS
|
|
|
|
#endif /* __COGL_ONSCREEN_TEMPLATE_H__ */
|