← Back to branch summary

~darkxst/ubuntu/raring/cogl/lp1163025

« back to all changes in this revision

Viewing changes to cogl/cogl-texture-3d.h

  • Committer: Package Import Robot
  • Author(s): Jeremy Bicha
  • Date: 2012-03-13 19:11:11 UTC
  • mfrom: (1.1.4)
  • Revision ID: package-import@ubuntu.com-20120313191111-3hgk529qkh9m6uk2
Tags: 1.9.8-0ubuntu1
https://launchpad.net/bugs/941617
* New upstream release (LP: #941617)
* Updated symbols & library name for soname update
* debian/control.in: Bump minimum glib to 2.28
* debian/patches/02_disable_armv5t_specific_optimization.patch: Disabled

Show diffs side-by-side

added added

removed removed

Lines of Context:
cogl/cogl-texture-3d.h
45
45
 * account the 'r' texture coordinate to select one of the images.
46
46
 */
47
47
 
48
 
/* All of the cogl-texture-3d API is currently experimental so we
49
 
 * suffix the actual symbols with _EXP so if somone is monitoring for
50
 
 * ABI changes it will hopefully be clearer to them what's going on if
51
 
 * any of the symbols dissapear at a later date.
52
 
 */
53
 
#define cogl_texture_3d_new_with_size cogl_texture_3d_new_with_size_EXP
54
 
#define cogl_texture_3d_new_from_data cogl_texture_3d_new_from_data_EXP
55
 
#define cogl_is_texture_3d cogl_is_texture_3d_EXP
 
48
typedef struct _CoglTexture3D CoglTexture3D;
 
49
 
 
50
#define COGL_TEXTURE_3D(X) ((CoglTexture3D *)X)
56
51
 
57
52
/**
58
53
 * cogl_texture_3d_new_with_size:
 
54
 * @context: a #CoglContext
59
55
 * @width: width of the texture in pixels.
60
56
 * @height: height of the texture in pixels.
61
57
 * @depth: depth of the texture in pixels.
62
 
 * @flags: Optional flags for the texture, or %COGL_TEXTURE_NONE
63
58
 * @internal_format: the #CoglPixelFormat to use for the GPU
64
59
 *    storage of the texture.
65
60
 * @error: A GError return location.
71
66
 * %COGL_FEATURE_TEXTURE_3D is not advertised. It can also fail if the
72
67
 * requested dimensions are not supported by the GPU.
73
68
 *
74
 
 * Return value: a new handle to a CoglTexture3D object or
75
 
 *   %COGL_INVALID_HANDLE on failure.
76
 
 * Since: 1.4
 
69
 * Return value: a new #CoglTexture3D object or
 
70
 *               %NULL on failure and an exception will be returned
 
71
 *               in @error.
 
72
 * Since: 1.10
77
73
 * Stability: Unstable
78
74
 */
79
 
CoglHandle
80
 
cogl_texture_3d_new_with_size (unsigned int     width,
81
 
                               unsigned int     height,
82
 
                               unsigned int     depth,
83
 
                               CoglTextureFlags flags,
 
75
CoglTexture3D *
 
76
cogl_texture_3d_new_with_size (CoglContext *context,
 
77
                               int width,
 
78
                               int height,
 
79
                               int depth,
84
80
                               CoglPixelFormat  internal_format,
85
 
                               GError         **error);
 
81
                               GError **error);
86
82
 
87
83
/**
88
84
 * cogl_texture_3d_new_from_data:
 
85
 * @context: a #CoglContext
89
86
 * @width: width of the texture in pixels.
90
87
 * @height: height of the texture in pixels.
91
88
 * @depth: depth of the texture in pixels.
92
 
 * @flags: Optional flags for the texture, or %COGL_TEXTURE_NONE
93
89
 * @format: the #CoglPixelFormat the buffer is stored in in RAM
94
90
 * @internal_format: the #CoglPixelFormat that will be used for storing
95
91
 *    the buffer on the GPU. If COGL_PIXEL_FORMAT_ANY is given then a
117
113
 * %COGL_FEATURE_TEXTURE_3D is not advertised. It can also fail if the
118
114
 * requested dimensions are not supported by the GPU.
119
115
 *
120
 
 * Return value: the newly created texture or %COGL_INVALID_HANDLE if
121
 
 *   there was an error.
122
 
 * Since: 1.4
 
116
 * Return value: the newly created #CoglTexture3D or %NULL if
 
117
 *               there was an error an an exception will be returned
 
118
 *               through @error.
 
119
 * Since: 1.10
123
120
 * Stability: Unstable
124
121
 */
125
 
CoglHandle
126
 
cogl_texture_3d_new_from_data (unsigned int      width,
127
 
                               unsigned int      height,
128
 
                               unsigned int      depth,
129
 
                               CoglTextureFlags  flags,
130
 
                               CoglPixelFormat   format,
131
 
                               CoglPixelFormat   internal_format,
132
 
                               unsigned int      rowstride,
133
 
                               unsigned int      image_stride,
134
 
                               const guint8     *data,
135
 
                               GError          **error);
 
122
CoglTexture3D *
 
123
cogl_texture_3d_new_from_data (CoglContext *context,
 
124
                               int width,
 
125
                               int height,
 
126
                               int depth,
 
127
                               CoglPixelFormat format,
 
128
                               CoglPixelFormat internal_format,
 
129
                               int rowstride,
 
130
                               int image_stride,
 
131
                               const guint8 *data,
 
132
                               GError **error);
136
133
 
137
134
/**
138
135
 * cogl_is_texture_3d:
139
 
 * @handle: a #CoglHandle
140
 
 *
141
 
 * Checks whether @handle is a #CoglHandle for a 3D texture.
142
 
 *
143
 
 * Return value: %TRUE if the passed handle represents a 3D texture
 
136
 * @object: a #CoglObject
 
137
 *
 
138
 * Checks whether the given object references a #CoglTexture3D
 
139
 *
 
140
 * Return value: %TRUE if the passed object represents a 3D texture
144
141
 *   and %FALSE otherwise
145
142
 *
146
143
 * Since: 1.4
147
144
 * Stability: Unstable
148
145
 */
149
146
gboolean
150
 
cogl_is_texture_3d (CoglHandle handle);
 
147
cogl_is_texture_3d (void *object);
151
148
 
152
149
G_END_DECLS
153
150