[Mesa-dev] [PATCH] gallium/docs: more documentation for pipe_resource::array_size

[Roland Scheidegger]

Am 22.06.2013 00:26, schrieb Brian Paul:
> It should never be zero and for cube/cube_arrays it should be a
> multiple of six.
> ---
>  src/gallium/docs/source/resources.rst |    6 ++++++
>  1 file changed, 6 insertions(+)
> 
> 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
> 

LGTM.

Roland