Mesa (master): st/mesa: updated comments for st_texture_image_map()

[Brian Paul]

Module: Mesa
Branch: master
Commit: fe3332da788fa3b17619b0ca9e368b2d5e77ffae
URL:    http://cgit.freedesktop.org/mesa/mesa/commit/?id=fe3332da788fa3b17619b0ca9e368b2d5e77ffae

Author: Brian Paul <brianp at vmware.com>
Date:   Mon May  3 15:47:29 2010 -0600

st/mesa: updated comments for st_texture_image_map()

---

 src/mesa/state_tracker/st_texture.c |   10 ++++++----
 1 files changed, 6 insertions(+), 4 deletions(-)

diff --git a/src/mesa/state_tracker/st_texture.c b/src/mesa/state_tracker/st_texture.c
index be45008..6a42789 100644
--- a/src/mesa/state_tracker/st_texture.c
+++ b/src/mesa/state_tracker/st_texture.c
@@ -125,10 +125,12 @@ st_texture_match_image(const struct pipe_resource *pt,
 
 
 /**
- * Map a teximage in a mipmap texture.
- * \param row_stride  returns row stride in bytes
- * \param image_stride  returns image stride in bytes (for 3D textures).
- * \return address of mapping
+ * Map a texture image and return the address for a particular 2D face/slice/
+ * layer.  The stImage indicates the cube face and mipmap level.  The slice
+ * of the 3D texture is passed in 'zoffset'.
+ * \param usage  one of the PIPE_TRANSFER_x values
+ * \param x, y, w, h  the region of interest of the 2D image.
+ * \return address of mapping or NULL if any error
  */
 GLubyte *
 st_texture_image_map(struct st_context *st, struct st_texture_image *stImage,