cogl: Adds experimental CoglIndexArray type

A CoglIndexArray is a subclass of CoglBuffer and will be used to hold
vertex indices. A later commit will add a CoglIndices API which will
allow describing a range of indices inside a CoglIndexArray.
This commit is contained in:
Robert Bragg 2010-10-12 12:36:22 +01:00
parent 7901e30aac
commit 4d990a93a8
5 changed files with 253 additions and 0 deletions

View File

@ -72,6 +72,7 @@ cogl_public_h = \
$(srcdir)/cogl-texture-3d.h \
$(srcdir)/cogl-types.h \
$(srcdir)/cogl-vertex-buffer.h \
$(srcdir)/cogl-index-array.h \
$(srcdir)/cogl.h \
$(NULL)
@ -205,6 +206,8 @@ cogl_sources_c = \
$(srcdir)/cogl-pixel-array.c \
$(srcdir)/cogl-vertex-buffer-private.h \
$(srcdir)/cogl-vertex-buffer.c \
$(srcdir)/cogl-index-array-private.h \
$(srcdir)/cogl-index-array.c \
$(srcdir)/cogl-matrix.c \
$(srcdir)/cogl-vector.c \
$(srcdir)/cogl-matrix-private.h \

View File

@ -0,0 +1,39 @@
/*
* Cogl
*
* An object oriented GL/GLES Abstraction/Utility Layer
*
* Copyright (C) 2010 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>
*/
#ifndef __COGL_INDEX_ARRAY_PRIVATE_H
#define __COGL_INDEX_ARRAY_PRIVATE_H
#include "cogl-buffer-private.h"
struct _CoglIndexArray
{
CoglBuffer _parent;
};
#endif /* __COGL_INDEX_ARRAY_PRIVATE_H */

131
cogl/cogl-index-array.c Normal file
View File

@ -0,0 +1,131 @@
/*
* Cogl
*
* An object oriented GL/GLES Abstraction/Utility Layer
*
* Copyright (C) 2010 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-object-private.h"
#include "cogl-indices.h"
#include "cogl-indices-private.h"
static void _cogl_index_array_free (CoglIndexArray *indices);
COGL_BUFFER_DEFINE (IndexArray, index_array);
/* XXX: Unlike the wiki design this just takes a size. A single
* indices buffer should be able to contain multiple ranges of indices
* which the wiki design doesn't currently consider. */
CoglIndexArray *
cogl_index_array_new (gsize bytes)
{
CoglIndexArray *indices = g_slice_new (CoglIndexArray);
gboolean use_malloc;
if (!cogl_features_available (COGL_FEATURE_VBOS))
use_malloc = TRUE;
else
use_malloc = FALSE;
/* parent's constructor */
_cogl_buffer_initialize (COGL_BUFFER (indices),
bytes,
use_malloc,
COGL_BUFFER_BIND_TARGET_INDEX_ARRAY,
COGL_BUFFER_USAGE_HINT_INDEX_ARRAY,
COGL_BUFFER_UPDATE_HINT_STATIC);
return _cogl_index_array_object_new (indices);
}
static void
_cogl_index_array_free (CoglIndexArray *indices)
{
/* parent's destructor */
_cogl_buffer_fini (COGL_BUFFER (indices));
g_slice_free (CoglIndexArray, indices);
}
gboolean
cogl_index_array_allocate (CoglIndexArray *indices,
GError *error)
{
/* TODO */
return TRUE;
}
/* XXX: do we want a convenience function like this as an alternative
* to using cogl_buffer_set_data? The advantage of this is that we can
* track meta data such as the indices type and max_index_value for a
* range as part of the indices array. If we just leave people to use
* cogl_buffer_set_data then we either need a way to specify the type
* and max index value at draw time or we'll want a separate way to
* declare the type and max value for a range after uploading the
* data.
*
* XXX: I think in the end it'll be that CoglIndices are to
* CoglIndexArrays as CoglVertexAttributes are to CoglVertices. I.e
* a CoglIndexArray is a lite subclass of CoglBuffer that simply
* implies that the buffer will later be bound as indices but doesn't
* track more detailed meta data. CoglIndices build on a
* CoglIndexArray and define the type and max_index_value for some
* sub-range of a CoglIndexArray.
*
* XXX: The double plurel form that "Indices" "Array" implies could be
* a bit confusing. Also to be a bit more consistent with
* CoglVertexArray vs CoglVertexAttribute it might be best to rename so
* we have CoglIndexArray vs CoglIndices? maybe even
* CoglIndexRange :-/ ?
*
* CoglBuffer
* CoglVertexArray (buffer sub-class)
* CoglPrimitive (defines meta data for sub-region of array)
* CoglPixelArray (buffer sub-class)
* CoglIndexArray (buffer sub-class)
* CoglIndices (defines meta data for sub-region of array)
*
*/
#if 0
void
cogl_index_array_set_data (CoglIndexArray *indices,
CoglIndicesType type,
int max_index_value,
gsize write_offset,
void *user_indices,
int n_indices)
{
GList *l;
for (l = indices->ranges; l; l = l->next)
{
}
cogl_buffer_set
}
#endif

79
cogl/cogl-index-array.h Normal file
View File

@ -0,0 +1,79 @@
/*
* Cogl
*
* An object oriented GL/GLES Abstraction/Utility Layer
*
* Copyright (C) 2010 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_INDEX_ARRAY_H__
#define __COGL_INDEX_ARRAY_H__
G_BEGIN_DECLS
/**
* SECTION:cogl-vertex-indices
* @short_description: Functions for creating and manipulating vertex
* indices.
*
* FIXME
*/
typedef struct _CoglIndexArray CoglIndexArray;
/**
* cogl_index_array_new:
* @size: The number of bytes to allocate for vertex attribute data.
*
* Declares a new #CoglIndexArray of @size bytes to contain vertex
* indices. Once declared, data can be set using
* cogl_buffer_set_data() or by mapping it into the application's
* address space using cogl_buffer_map().
*
* Since: 1.4
* Stability: Unstable
*/
CoglIndexArray *
cogl_index_array_new (gsize bytes);
/**
* cogl_is_indices_array:
* @object: A #CoglObject
*
* Gets whether the given object references a #CoglIndexArray.
*
* Returns: %TRUE if the handle references a #CoglIndexArray,
* %FALSE otherwise
*
* Since: 1.4
* Stability: Unstable
*/
gboolean
cogl_is_indices_array (void *object);
G_END_DECLS
#endif /* __COGL_INDEX_ARRAY_H__ */

View File

@ -54,6 +54,7 @@
#include <cogl/cogl-pixel-array.h>
#include <cogl/cogl-vector.h>
#include <cogl/cogl-texture-3d.h>
#include <cogl/cogl-index-array.h>
#endif
G_BEGIN_DECLS