1d8fd64e1c
CoglMetaTexture is an interface for dealing with high level textures that may be comprised of one or more low-level textures internally. The interface allows the development of primitive drawing APIs that can draw with high-level textures (such as atlas textures) even though the GPU doesn't natively understand these texture types. There is currently just one function that's part of this interface: cogl_meta_texture_foreach_in_region() which allows an application to resolve the internal, low-level textures of a high-level texture. cogl_rectangle() uses this API for example so that it can easily emulate the _REPEAT wrap mode for textures that the hardware can't natively handle repeating of. Reviewed-by: Neil Roberts <neil@linux.intel.com>
392 lines
13 KiB
C
392 lines
13 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>
|
|
*/
|
|
|
|
#ifdef HAVE_CONFIG_H
|
|
#include "config.h"
|
|
#endif
|
|
|
|
#include "cogl-texture.h"
|
|
#include "cogl-matrix.h"
|
|
#include "cogl-spans.h"
|
|
#include "cogl-meta-texture.h"
|
|
#include "cogl-texture-rectangle-private.h"
|
|
|
|
#include <string.h>
|
|
#include <math.h>
|
|
|
|
typedef struct _ForeachData
|
|
{
|
|
float meta_region_coords[4];
|
|
CoglPipelineWrapMode wrap_s;
|
|
CoglPipelineWrapMode wrap_t;
|
|
CoglMetaTextureCallback callback;
|
|
void *user_data;
|
|
|
|
int width;
|
|
int height;
|
|
|
|
CoglTexture *padded_textures[9];
|
|
const float *grid_slice_texture_coords;
|
|
float slice_offset_s;
|
|
float slice_offset_t;
|
|
float slice_range_s;
|
|
float slice_range_t;
|
|
} ForeachData;
|
|
|
|
static void
|
|
padded_grid_repeat_cb (CoglTexture *slice_texture,
|
|
const float *slice_texture_coords,
|
|
const float *meta_coords,
|
|
void *user_data)
|
|
{
|
|
ForeachData *data;
|
|
float mapped_coords[4];
|
|
|
|
/* Ignore padding slices for the current grid */
|
|
if (!slice_texture)
|
|
return;
|
|
|
|
data = user_data;
|
|
|
|
/* NB: the slice_texture_coords[] we get here will always be
|
|
* normalized.
|
|
*
|
|
* We now need to map the normalized slice_texture_coords[] we have
|
|
* here back to the real slice coordinates we saved in the previous
|
|
* stage...
|
|
*/
|
|
mapped_coords[0] =
|
|
slice_texture_coords[0] * data->slice_range_s + data->slice_offset_s;
|
|
mapped_coords[1] =
|
|
slice_texture_coords[1] * data->slice_range_t + data->slice_offset_t;
|
|
mapped_coords[2] =
|
|
slice_texture_coords[2] * data->slice_range_s + data->slice_offset_s;
|
|
mapped_coords[3] =
|
|
slice_texture_coords[3] * data->slice_range_t + data->slice_offset_t;
|
|
|
|
data->callback (slice_texture,
|
|
mapped_coords, meta_coords, data->user_data);
|
|
}
|
|
|
|
static int
|
|
setup_padded_spans (CoglSpan *spans,
|
|
float start,
|
|
float end,
|
|
float range,
|
|
int *real_index)
|
|
{
|
|
int span_index = 0;
|
|
|
|
if (start > 0)
|
|
{
|
|
spans[0].start = 0;
|
|
spans[0].size = start;
|
|
spans[0].waste = 0;
|
|
span_index++;
|
|
spans[1].start = spans[0].size;
|
|
}
|
|
else
|
|
spans[span_index].start = 0;
|
|
|
|
spans[span_index].size = end - start;
|
|
spans[span_index].waste = 0;
|
|
*real_index = span_index;
|
|
span_index++;
|
|
|
|
if (end < range)
|
|
{
|
|
spans[span_index].start =
|
|
spans[span_index - 1].start + spans[span_index - 1].size;
|
|
spans[span_index].size = range - end;
|
|
spans[span_index].waste = 0;
|
|
span_index++;
|
|
}
|
|
|
|
return span_index;
|
|
}
|
|
|
|
/* This handles each sub-texture within the range [0,1] of our
|
|
* original meta texture and repeats each one separately across the
|
|
* users requested virtual texture coordinates.
|
|
*
|
|
* A notable advantage of this approach is that we will batch
|
|
* together callbacks corresponding to the same underlying slice
|
|
* together.
|
|
*/
|
|
void
|
|
create_grid_and_repeat_cb (CoglTexture *slice_texture,
|
|
const float *slice_texture_coords,
|
|
const float *meta_coords,
|
|
void *user_data)
|
|
{
|
|
ForeachData *data = user_data;
|
|
CoglSpan x_spans[3];
|
|
int n_x_spans;
|
|
int x_real_index;
|
|
CoglSpan y_spans[3];
|
|
int n_y_spans;
|
|
int y_real_index;
|
|
|
|
/* NB: This callback is called for each slice of the meta-texture
|
|
* in the range [0,1].
|
|
*
|
|
* We define a "padded grid" for each slice of the meta-texture in
|
|
* the range [0,1]. The x axis and y axis grid lines are defined
|
|
* using CoglSpans.
|
|
*
|
|
* The padded grid maps over the meta-texture coordinates in the
|
|
* range [0,1] but only contains one valid cell that corresponds to
|
|
* current slice being iterated and all the surrounding cells just
|
|
* provide padding.
|
|
*
|
|
* Once we've defined our padded grid we then repeat that across
|
|
* the user's original region, calling their callback whenever
|
|
* we see our current slice - ignoring padding.
|
|
*
|
|
* NB: we can assume meta_coords[] are normalized at this point
|
|
* since TextureRectangles aren't iterated with this code-path.
|
|
*
|
|
* NB: spans are always defined using non-normalized coordinates
|
|
*/
|
|
n_x_spans = setup_padded_spans (x_spans,
|
|
meta_coords[0] * data->width,
|
|
meta_coords[2] * data->width,
|
|
data->width,
|
|
&x_real_index);
|
|
n_y_spans = setup_padded_spans (y_spans,
|
|
meta_coords[1] * data->height,
|
|
meta_coords[3] * data->height,
|
|
data->height,
|
|
&y_real_index);
|
|
|
|
data->padded_textures[n_y_spans * y_real_index + x_real_index] =
|
|
slice_texture;
|
|
|
|
/* Our callback is going to be passed normalized slice texture
|
|
* coordinates, and we will need to map the range [0,1] to the real
|
|
* slice_texture_coords we have here... */
|
|
data->grid_slice_texture_coords = slice_texture_coords;
|
|
data->slice_range_s = fabs (data->grid_slice_texture_coords[2] -
|
|
data->grid_slice_texture_coords[0]);
|
|
data->slice_range_t = fabs (data->grid_slice_texture_coords[3] -
|
|
data->grid_slice_texture_coords[1]);
|
|
data->slice_offset_s = MIN (data->grid_slice_texture_coords[0],
|
|
data->grid_slice_texture_coords[2]);
|
|
data->slice_offset_t = MIN (data->grid_slice_texture_coords[1],
|
|
data->grid_slice_texture_coords[3]);
|
|
|
|
/* Now actually iterate the region the user originally requested
|
|
* using the current padded grid */
|
|
_cogl_texture_spans_foreach_in_region (x_spans,
|
|
n_x_spans,
|
|
y_spans,
|
|
n_y_spans,
|
|
data->padded_textures,
|
|
data->meta_region_coords,
|
|
data->width,
|
|
data->height,
|
|
data->wrap_s,
|
|
data->wrap_t,
|
|
padded_grid_repeat_cb,
|
|
data);
|
|
|
|
/* Clear the padded_textures ready for the next iteration */
|
|
data->padded_textures[n_y_spans * y_real_index + x_real_index] = NULL;
|
|
}
|
|
|
|
typedef struct _NormalizeData
|
|
{
|
|
CoglMetaTextureCallback callback;
|
|
void *user_data;
|
|
float s_normalize_factor;
|
|
float t_normalize_factor;
|
|
} NormalizeData;
|
|
|
|
static void
|
|
normalize_meta_coords_cb (CoglTexture *slice_texture,
|
|
const float *slice_coords,
|
|
const float *meta_coords,
|
|
void *user_data)
|
|
{
|
|
NormalizeData *data = user_data;
|
|
float normalized_meta_coords[4] = {
|
|
meta_coords[0] * data->s_normalize_factor,
|
|
meta_coords[1] * data->t_normalize_factor,
|
|
meta_coords[2] * data->s_normalize_factor,
|
|
meta_coords[3] * data->t_normalize_factor
|
|
};
|
|
|
|
data->callback (slice_texture,
|
|
slice_coords, normalized_meta_coords,
|
|
data->user_data);
|
|
}
|
|
|
|
typedef struct _UnNormalizeData
|
|
{
|
|
CoglMetaTextureCallback callback;
|
|
void *user_data;
|
|
float width;
|
|
float height;
|
|
} UnNormalizeData;
|
|
|
|
static void
|
|
un_normalize_slice_coords_cb (CoglTexture *slice_texture,
|
|
const float *slice_coords,
|
|
const float *meta_coords,
|
|
void *user_data)
|
|
{
|
|
UnNormalizeData *data = user_data;
|
|
float un_normalized_slice_coords[4] = {
|
|
slice_coords[0] * data->width,
|
|
slice_coords[1] * data->height,
|
|
slice_coords[2] * data->width,
|
|
slice_coords[3] * data->height
|
|
};
|
|
|
|
data->callback (slice_texture,
|
|
un_normalized_slice_coords, meta_coords,
|
|
data->user_data);
|
|
}
|
|
|
|
void
|
|
cogl_meta_texture_foreach_in_region (CoglMetaTexture *meta_texture,
|
|
float tx_1,
|
|
float ty_1,
|
|
float tx_2,
|
|
float ty_2,
|
|
CoglPipelineWrapMode wrap_s,
|
|
CoglPipelineWrapMode wrap_t,
|
|
CoglMetaTextureCallback callback,
|
|
void *user_data)
|
|
{
|
|
CoglTexture *texture = COGL_TEXTURE (meta_texture);
|
|
float width = cogl_texture_get_width (texture);
|
|
float height = cogl_texture_get_height (texture);
|
|
NormalizeData normalize_data;
|
|
|
|
/* It makes things simpler to deal with non-normalized region
|
|
* coordinates beyond this point and only re-normalize just before
|
|
* calling the user's callback... */
|
|
|
|
if (!_cogl_is_texture_rectangle (COGL_TEXTURE (meta_texture)))
|
|
{
|
|
normalize_data.callback = callback;
|
|
normalize_data.user_data = user_data;
|
|
normalize_data.s_normalize_factor = 1.0f / width;
|
|
normalize_data.t_normalize_factor = 1.0f / height;
|
|
callback = normalize_meta_coords_cb;
|
|
user_data = &normalize_data;
|
|
tx_1 *= width;
|
|
ty_1 *= height;
|
|
tx_2 *= width;
|
|
ty_2 *= height;
|
|
}
|
|
|
|
/* XXX: at some point this wont be routed through the CoglTexture
|
|
* vtable, instead there will be a separate CoglMetaTexture
|
|
* interface vtable. */
|
|
|
|
if (texture->vtable->foreach_sub_texture_in_region)
|
|
{
|
|
ForeachData data;
|
|
|
|
data.meta_region_coords[0] = tx_1;
|
|
data.meta_region_coords[1] = ty_1;
|
|
data.meta_region_coords[2] = tx_2;
|
|
data.meta_region_coords[3] = ty_2;
|
|
data.wrap_s = wrap_s;
|
|
data.wrap_t = wrap_t;
|
|
data.callback = callback;
|
|
data.user_data = user_data;
|
|
|
|
data.width = width;
|
|
data.height = height;
|
|
|
|
memset (data.padded_textures, 0, sizeof (data.padded_textures));
|
|
|
|
/*
|
|
* 1) We iterate all the slices of the meta-texture only within
|
|
* the range [0,1].
|
|
*
|
|
* 2) We define a "padded grid" for each slice of the
|
|
* meta-texture in the range [0,1].
|
|
*
|
|
* The padded grid maps over the meta-texture coordinates in
|
|
* the range [0,1] but only contains one valid cell that
|
|
* corresponds to current slice being iterated and all the
|
|
* surrounding cells just provide padding.
|
|
*
|
|
* 3) Once we've defined our padded grid we then repeat that
|
|
* across the user's original region, calling their callback
|
|
* whenever we see our current slice - ignoring padding.
|
|
*
|
|
* A notable benefit of this design is that repeating a texture
|
|
* made of multiple slices will result in us repeating each
|
|
* slice in-turn so the user gets repeat callbacks for the same
|
|
* texture batched together. For manual emulation of texture
|
|
* repeats done by drawing geometry this makes it more likely
|
|
* that we can batch geometry.
|
|
*/
|
|
|
|
texture->vtable->foreach_sub_texture_in_region (texture,
|
|
0, 0, 1, 1,
|
|
create_grid_and_repeat_cb,
|
|
&data);
|
|
}
|
|
else
|
|
{
|
|
CoglSpan x_span = { 0, width, 0 };
|
|
CoglSpan y_span = { 0, height, 0 };
|
|
float meta_region_coords[4] = { tx_1, ty_1, tx_2, ty_2 };
|
|
UnNormalizeData un_normalize_data;
|
|
|
|
/* If we are dealing with a CoglTextureRectangle then we need a shim
|
|
* callback that un_normalizes the slice coordinates we get from
|
|
* _cogl_texture_spans_foreach_in_region before passing them to
|
|
* the user's callback. */
|
|
if (_cogl_is_texture_rectangle (meta_texture))
|
|
{
|
|
un_normalize_data.callback = callback;
|
|
un_normalize_data.user_data = user_data;
|
|
un_normalize_data.width = width;
|
|
un_normalize_data.height = height;
|
|
callback = un_normalize_slice_coords_cb;
|
|
user_data = &un_normalize_data;
|
|
}
|
|
|
|
_cogl_texture_spans_foreach_in_region (&x_span, 1,
|
|
&y_span, 1,
|
|
&texture,
|
|
meta_region_coords,
|
|
width,
|
|
height,
|
|
wrap_s,
|
|
wrap_t,
|
|
callback,
|
|
user_data);
|
|
}
|
|
}
|