From: Brian Paul Date: Fri, 21 Jun 2013 19:25:42 +0000 (-0600) Subject: gallium/docs: more documentation for pipe_resource::array_size X-Git-Tag: mesa-9.2.1~687 X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=refs%2Fchanges%2F91%2F7091%2F1;p=platform%2Fupstream%2Fmesa.git gallium/docs: more documentation for pipe_resource::array_size It should never be zero and for cube/cube_arrays it should be a multiple of six. Reviewed-by: Roland Scheidegger --- diff --git a/src/gallium/docs/source/resources.rst b/src/gallium/docs/source/resources.rst index 553e335..56a86d6 100644 --- a/src/gallium/docs/source/resources.rst +++ b/src/gallium/docs/source/resources.rst @@ -85,6 +85,7 @@ PIPE_TEXTURE_1D / PIPE_TEXTURE_1D_ARRAY width must be a power of two - height0 must be 1 - depth0 must be 1 +- array_size must be 1 for PIPE_TEXTURE_1D - Mipmaps can be used - Must use normalized coordinates @@ -99,6 +100,7 @@ PIPE_TEXTURE_RECT 2D surface with OpenGL GL_TEXTURE_RECTANGLE semantics. - depth0 must be 1 +- array_size must be 1 - last_level must be 0 - Must use unnormalized coordinates - Must use a clamp wrap mode @@ -117,6 +119,7 @@ PIPE_TEXTURE_2D / PIPE_TEXTURE_2D_ARRAY - If PIPE_CAP_NPOT_TEXTURES is not supported, width and height must be powers of two - depth0 must be 1 +- array_size must be 1 for PIPE_TEXTURE_2D - Mipmaps can be used - Must use normalized coordinates - No special restrictions on wrap modes @@ -139,6 +142,7 @@ Mipmap dimensions are reduced in all 3 coordinates. - If PIPE_CAP_NPOT_TEXTURES is not supported, width, height and depth must be powers of two +- array_size must be 1 - Must use normalized coordinates OpenGL: GL_TEXTURE_3D in GL 1.2 or GL_EXT_texture3D @@ -161,6 +165,8 @@ Sampling may be optionally seamless if a driver supports it (PIPE_CAP_SEAMLESS_C resulting in filtering taking samples from multiple surfaces near to the edge. - Width and height must be equal +- depth0 must be 1 +- array_size must be a multiple of 6 - If PIPE_CAP_NPOT_TEXTURES is not supported, width and height must be powers of two - Must use normalized coordinates