982f1b4bd0
This adds an optional data argument for cogl_vertex_array_new() since it seems that mostly every case where we use this API we follow up with a cogl_buffer_set_data() matching the size of the new array. This simplifies all those cases and whenever we want to delay uploading of data then NULL can simply be passed.
82 lines
2.2 KiB
C
82 lines
2.2 KiB
C
/*
|
|
* 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_VERTEX_ARRAY_H__
|
|
#define __COGL_VERTEX_ARRAY_H__
|
|
|
|
G_BEGIN_DECLS
|
|
|
|
/**
|
|
* SECTION:cogl-vertex-array
|
|
* @short_description: Functions for creating and manipulating vertex arrays
|
|
*
|
|
* FIXME
|
|
*/
|
|
|
|
typedef struct _CoglVertexArray CoglVertexArray;
|
|
|
|
/**
|
|
* cogl_vertex_array_new:
|
|
* @size: The number of bytes to allocate for vertex attribute data.
|
|
* @data: An optional pointer to vertex data to upload immediately.
|
|
*
|
|
* Declares a new #CoglVertexArray of @size bytes to contain arrays of vertex
|
|
* attribute data. 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().
|
|
*
|
|
* If @data isn't %NULL then @size bytes will be read from @data and
|
|
* immediately copied into the new buffer.
|
|
*
|
|
* Since: 1.4
|
|
* Stability: Unstable
|
|
*/
|
|
CoglVertexArray *
|
|
cogl_vertex_array_new (gsize bytes,
|
|
const void *data);
|
|
|
|
/**
|
|
* cogl_is_vertex_array:
|
|
* @object: A #CoglObject
|
|
*
|
|
* Gets whether the given object references a #CoglVertexArray.
|
|
*
|
|
* Returns: %TRUE if the handle references a #CoglVertexArray,
|
|
* %FALSE otherwise
|
|
*
|
|
* Since: 1.4
|
|
* Stability: Unstable
|
|
*/
|
|
gboolean
|
|
cogl_is_vertex_array (void *object);
|
|
|
|
G_END_DECLS
|
|
|
|
#endif /* __COGL_VERTEX_ARRAY_H__ */
|
|
|