mirror of
https://github.com/brl/mutter.git
synced 2024-11-26 10:00:45 -05:00
71498a6376
The CoglTexture constructors expose the "max-waste" argument for controlling the maximum amount of wasted areas for slicing or, if set to -1, disables slicing. Slicing is really relevant only for large images that are never repeated, so it's a useful feature only in controlled use cases. Specifying the amount of wasted area is, on the other hand, just a way to mess up this feature; 99% the times, you either pull this number out of thin air, hoping it's right, or you try to do the right thing and you choose the wrong number anyway. Instead, we can use the CoglTextureFlags to control whether the texture should not be sliced (useful for Clutter-GST and for the texture-from-pixmap actors) and provide a reasonable value for enabling the slicing ourself. At some point, we might even provide a way to change the default at compile time or at run time, for particular platforms. Since max_waste is gone, the :tile-waste property of ClutterTexture becomes read-only, and it proxies the cogl_texture_get_max_waste() function. Inside Clutter, the only cases where the max_waste argument was not set to -1 are in the Pango glyph cache (which is a POT texture anyway) and inside the test cases where we want to force slicing; for the latter we can create larger textures that will be bigger than the threshold we set. Signed-off-by: Emmanuele Bassi <ebassi@linux.intel.com> Signed-off-by: Robert Bragg <robert@linux.intel.com> Signed-off-by: Neil Roberts <neil@linux.intel.com>
235 lines
11 KiB
C
235 lines
11 KiB
C
/*
|
|
* Clutter.
|
|
*
|
|
* An OpenGL based 'interactive canvas' library.
|
|
*
|
|
* Authored By Matthew Allum <mallum@openedhand.com>
|
|
*
|
|
* Copyright (C) 2006 OpenedHand
|
|
*
|
|
* 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.1 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/>.
|
|
*/
|
|
|
|
#if !defined(__CLUTTER_H_INSIDE__) && !defined(CLUTTER_COMPILATION)
|
|
#error "Only <clutter/clutter.h> can be included directly."
|
|
#endif
|
|
|
|
#ifndef __CLUTTER_TEXTURE_H__
|
|
#define __CLUTTER_TEXTURE_H__
|
|
|
|
#include <clutter/clutter-actor.h>
|
|
#include <cogl/cogl.h>
|
|
|
|
G_BEGIN_DECLS
|
|
|
|
#define CLUTTER_TYPE_TEXTURE (clutter_texture_get_type ())
|
|
#define CLUTTER_TEXTURE(obj) (G_TYPE_CHECK_INSTANCE_CAST ((obj), CLUTTER_TYPE_TEXTURE, ClutterTexture))
|
|
#define CLUTTER_TEXTURE_CLASS(klass) (G_TYPE_CHECK_CLASS_CAST ((klass), CLUTTER_TYPE_TEXTURE, ClutterTextureClass))
|
|
#define CLUTTER_IS_TEXTURE(obj) (G_TYPE_CHECK_INSTANCE_TYPE ((obj), CLUTTER_TYPE_TEXTURE))
|
|
#define CLUTTER_IS_TEXTURE_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE ((klass), CLUTTER_TYPE_TEXTURE))
|
|
#define CLUTTER_TEXTURE_GET_CLASS(obj) (G_TYPE_INSTANCE_GET_CLASS ((obj), CLUTTER_TYPE_TEXTURE, ClutterTextureClass))
|
|
|
|
/**
|
|
* ClutterTextureError:
|
|
* @CLUTTER_TEXTURE_ERROR_OUT_OF_MEMORY: OOM condition
|
|
* @CLUTTER_TEXTURE_ERROR_NO_YUV: YUV operation attempted but no YUV support
|
|
* found
|
|
* @CLUTTER_TEXTURE_ERROR_BAD_FORMAT: The requested format for
|
|
* clutter_texture_set_from_rgb_data or
|
|
* clutter_texture_set_from_yuv_data is unsupported.
|
|
*
|
|
* Error enumeration for #ClutterTexture
|
|
*
|
|
* Since: 0.4
|
|
*/
|
|
typedef enum {
|
|
CLUTTER_TEXTURE_ERROR_OUT_OF_MEMORY,
|
|
CLUTTER_TEXTURE_ERROR_NO_YUV,
|
|
CLUTTER_TEXTURE_ERROR_BAD_FORMAT
|
|
} ClutterTextureError;
|
|
|
|
/**
|
|
* CLUTTER_TEXTURE_ERROR:
|
|
*
|
|
* Error domain for #ClutterTexture errors
|
|
*
|
|
* Since: 0.4
|
|
*/
|
|
#define CLUTTER_TEXTURE_ERROR (clutter_texture_error_quark ())
|
|
GQuark clutter_texture_error_quark (void);
|
|
|
|
typedef struct _ClutterTexture ClutterTexture;
|
|
typedef struct _ClutterTextureClass ClutterTextureClass;
|
|
typedef struct _ClutterTexturePrivate ClutterTexturePrivate;
|
|
|
|
/**
|
|
* ClutterTexture:
|
|
*
|
|
* The #ClutterTexture structure contains only private data
|
|
* and should be accessed using the provided API
|
|
*
|
|
* Since: 0.1
|
|
*/
|
|
struct _ClutterTexture
|
|
{
|
|
/*< private >*/
|
|
ClutterActor parent;
|
|
|
|
ClutterTexturePrivate *priv;
|
|
};
|
|
|
|
/**
|
|
* ClutterTextureClass:
|
|
* @size_change: handler for the #ClutterTexture::size-change signal
|
|
* @pixbuf_change: handler for the #ClutterTexture::pixbuf-change signal
|
|
* @load_finished: handler for the #ClutterTexture::load-finished signal
|
|
*
|
|
* The #ClutterTextureClass structure contains only private data
|
|
*
|
|
* Since: 0.1
|
|
*/
|
|
struct _ClutterTextureClass
|
|
{
|
|
/*< private >*/
|
|
ClutterActorClass parent_class;
|
|
|
|
/*< public >*/
|
|
void (* size_change) (ClutterTexture *texture,
|
|
gint width,
|
|
gint height);
|
|
void (* pixbuf_change) (ClutterTexture *texture);
|
|
void (* load_finished) (ClutterTexture *texture,
|
|
const GError *error);
|
|
|
|
/*< private >*/
|
|
/* padding, for future expansion */
|
|
void (*_clutter_texture1) (void);
|
|
void (*_clutter_texture2) (void);
|
|
void (*_clutter_texture3) (void);
|
|
void (*_clutter_texture4) (void);
|
|
void (*_clutter_texture5) (void);
|
|
};
|
|
|
|
/**
|
|
* ClutterTextureFlags:
|
|
* @CLUTTER_TEXTURE_NONE: No flags
|
|
* @CLUTTER_TEXTURE_RGB_FLAG_BGR: FIXME
|
|
* @CLUTTER_TEXTURE_RGB_FLAG_PREMULT: FIXME
|
|
* @CLUTTER_TEXTURE_YUV_FLAG_YUV2: FIXME
|
|
*
|
|
* Flags for clutter_texture_set_from_rgb_data() and
|
|
* clutter_texture_set_from_yuv_data().
|
|
*
|
|
* Since: 0.4
|
|
*/
|
|
typedef enum { /*< prefix=CLUTTER_TEXTURE >*/
|
|
CLUTTER_TEXTURE_NONE = 0,
|
|
CLUTTER_TEXTURE_RGB_FLAG_BGR = 1 << 1,
|
|
CLUTTER_TEXTURE_RGB_FLAG_PREMULT = 1 << 2, /* FIXME: not handled */
|
|
CLUTTER_TEXTURE_YUV_FLAG_YUV2 = 1 << 3
|
|
|
|
/* FIXME: add compressed types ? */
|
|
} ClutterTextureFlags;
|
|
|
|
/**
|
|
* ClutterTextureQuality:
|
|
* @CLUTTER_TEXTURE_QUALITY_LOW: fastest rendering will use nearest neighbour
|
|
* interpolation when rendering. good setting.
|
|
* @CLUTTER_TEXTURE_QUALITY_MEDIUM: higher quality rendering without using
|
|
* extra resources.
|
|
* @CLUTTER_TEXTURE_QUALITY_HIGH: render the texture with the best quality
|
|
* available using extra memory.
|
|
*
|
|
* Enumaration controlling the texture quality.
|
|
*
|
|
* Since: 0.8
|
|
*/
|
|
typedef enum { /*< prefix=CLUTTER_TEXTURE_QUALITY >*/
|
|
CLUTTER_TEXTURE_QUALITY_LOW,
|
|
CLUTTER_TEXTURE_QUALITY_MEDIUM,
|
|
CLUTTER_TEXTURE_QUALITY_HIGH
|
|
} ClutterTextureQuality;
|
|
|
|
GType clutter_texture_get_type (void) G_GNUC_CONST;
|
|
|
|
ClutterActor * clutter_texture_new (void);
|
|
ClutterActor * clutter_texture_new_from_file (const gchar *filename,
|
|
GError **error);
|
|
ClutterActor * clutter_texture_new_from_actor (ClutterActor *actor);
|
|
gboolean clutter_texture_set_from_file (ClutterTexture *texture,
|
|
const gchar *filename,
|
|
GError **error);
|
|
gboolean clutter_texture_set_from_rgb_data (ClutterTexture *texture,
|
|
const guchar *data,
|
|
gboolean has_alpha,
|
|
gint width,
|
|
gint height,
|
|
gint rowstride,
|
|
gint bpp,
|
|
ClutterTextureFlags flags,
|
|
GError **error);
|
|
gboolean clutter_texture_set_from_yuv_data (ClutterTexture *texture,
|
|
const guchar *data,
|
|
gint width,
|
|
gint height,
|
|
ClutterTextureFlags flags,
|
|
GError **error);
|
|
gboolean clutter_texture_set_area_from_rgb_data (ClutterTexture *texture,
|
|
const guchar *data,
|
|
gboolean has_alpha,
|
|
gint x,
|
|
gint y,
|
|
gint width,
|
|
gint height,
|
|
gint rowstride,
|
|
gint bpp,
|
|
ClutterTextureFlags flags,
|
|
GError **error);
|
|
void clutter_texture_get_base_size (ClutterTexture *texture,
|
|
gint *width,
|
|
gint *height);
|
|
void clutter_texture_set_filter_quality (ClutterTexture *texture,
|
|
ClutterTextureQuality filter_quality);
|
|
ClutterTextureQuality clutter_texture_get_filter_quality (ClutterTexture *texture);
|
|
CoglHandle clutter_texture_get_cogl_texture (ClutterTexture *texture);
|
|
void clutter_texture_set_cogl_texture (ClutterTexture *texture,
|
|
CoglHandle cogl_tex);
|
|
CoglHandle clutter_texture_get_cogl_material (ClutterTexture *texture);
|
|
void clutter_texture_set_cogl_material (ClutterTexture *texture,
|
|
CoglHandle cogl_material);
|
|
void clutter_texture_set_sync_size (ClutterTexture *texture,
|
|
gboolean sync_size);
|
|
gboolean clutter_texture_get_sync_size (ClutterTexture *texture);
|
|
void clutter_texture_set_repeat (ClutterTexture *texture,
|
|
gboolean repeat_x,
|
|
gboolean repeat_y);
|
|
void clutter_texture_get_repeat (ClutterTexture *texture,
|
|
gboolean *repeat_x,
|
|
gboolean *repeat_y);
|
|
CoglPixelFormat clutter_texture_get_pixel_format (ClutterTexture *texture);
|
|
gint clutter_texture_get_max_tile_waste (ClutterTexture *texture);
|
|
void clutter_texture_set_keep_aspect_ratio (ClutterTexture *texture,
|
|
gboolean keep_aspect);
|
|
gboolean clutter_texture_get_keep_aspect_ratio (ClutterTexture *texture);
|
|
void clutter_texture_set_load_async (ClutterTexture *texture,
|
|
gboolean load_async);
|
|
gboolean clutter_texture_get_load_async (ClutterTexture *texture);
|
|
void clutter_texture_set_load_data_async (ClutterTexture *texture,
|
|
gboolean load_async);
|
|
gboolean clutter_texture_get_load_data_async (ClutterTexture *texture);
|
|
|
|
G_END_DECLS
|
|
|
|
#endif /* __CLUTTER_TEXTURE_H__ */
|