mirror of
https://github.com/brl/mutter.git
synced 2024-11-12 17:27:03 -05:00
ec718d4ca4
Using 'r' to name the third component is problematic because that is commonly used to represent the red component of a vector representing a color. Under GLSL this is awkward because the texture swizzling for a vector uses a single letter for each component and the names for colors, textures and positions are synonymous. GLSL works around this by naming the components of the texture s, t, p and q. Cogl already effectively already exposes this naming because it exposes GLSL so it makes sense to use that naming consistently. Another alternative could be u, v and w. This is what Blender and Direct3D use. However the w component conflicts with the w component of a position vertex.
97 lines
3.5 KiB
C
97 lines
3.5 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:
|
||
* Neil Roberts <neil@linux.intel.com>
|
||
*/
|
||
|
||
#ifndef __COGL_TEXTURE_3D_PRIVATE_H
|
||
#define __COGL_TEXTURE_3D_PRIVATE_H
|
||
|
||
#include "cogl-handle.h"
|
||
#include "cogl-material-private.h"
|
||
#include "cogl-texture-private.h"
|
||
|
||
#define COGL_TEXTURE_3D(tex) ((CoglTexture3D *) tex)
|
||
|
||
typedef struct _CoglTexture3D CoglTexture3D;
|
||
|
||
struct _CoglTexture3D
|
||
{
|
||
CoglTexture _parent;
|
||
|
||
/* The internal format of the GL texture represented as a
|
||
CoglPixelFormat */
|
||
CoglPixelFormat format;
|
||
/* The internal format of the GL texture represented as a GL enum */
|
||
GLenum gl_format;
|
||
/* The texture object number */
|
||
GLuint gl_texture;
|
||
int width;
|
||
int height;
|
||
int depth;
|
||
GLenum min_filter;
|
||
GLenum mag_filter;
|
||
GLint wrap_mode_s;
|
||
GLint wrap_mode_t;
|
||
GLint wrap_mode_p;
|
||
gboolean auto_mipmap;
|
||
gboolean mipmaps_dirty;
|
||
};
|
||
|
||
GQuark
|
||
_cogl_handle_texture_3d_get_type (void);
|
||
|
||
/*
|
||
* cogl_texture_3d_new_from_bitmap:
|
||
* @bmp_handle: A #CoglHandle to a bitmap.
|
||
* @height: height of the texture in pixels.
|
||
* @depth: depth of the texture in pixels.
|
||
* @flags: Optional flags for the texture, or %COGL_TEXTURE_NONE
|
||
* @internal_format: the #CoglPixelFormat that will be used for storing
|
||
* the buffer on the GPU. If COGL_PIXEL_FORMAT_ANY is given then a
|
||
* premultiplied format similar to the format of the source data will
|
||
* be used. The default blending equations of Cogl expect premultiplied
|
||
* color data; the main use of passing a non-premultiplied format here
|
||
* is if you have non-premultiplied source data and are going to adjust
|
||
* the blend mode (see cogl_material_set_blend()) or use the data for
|
||
* something other than straight blending.
|
||
* @error: A GError return location.
|
||
*
|
||
* Creates a new 3D texture and initializes it with the images in
|
||
* @bmp_handle. The images are assumed to be packed together after one
|
||
* another in the increasing y axis. The height of individual image is
|
||
* given as @height and the number of images is given in @depth. The
|
||
* actual height of the bitmap can be larger than @height × @depth. In
|
||
* this case it assumes there is padding between the images.
|
||
*
|
||
* Return value: the newly created texture or %COGL_INVALID_HANDLE if
|
||
* there was an error.
|
||
*/
|
||
CoglHandle
|
||
_cogl_texture_3d_new_from_bitmap (CoglHandle bmp_handle,
|
||
unsigned int height,
|
||
unsigned int depth,
|
||
CoglTextureFlags flags,
|
||
CoglPixelFormat internal_format,
|
||
GError **error);
|
||
|
||
#endif /* __COGL_TEXTURE_3D_PRIVATE_H */
|