mesa: add some comments about mipmap generation

Trivial.

diff --git a/src/mesa/main/dd.h b/src/mesa/main/dd.h
index e96cf3a95dd78674a13e5ead66db0891654bb78e..0b2b84a65c15b6fdeefd42dbaf601dfafe70e73d 100644 (file)
--- a/src/mesa/main/dd.h
+++ b/src/mesa/main/dd.h
@@ -256,6 +256,10 @@ struct dd_function_table {
 
    /**
     * Called by glGenerateMipmap() or when GL_GENERATE_MIPMAP_SGIS is enabled.
+    * Note that if the texture is a cube map, the <target> parameter will
+    * indicate which cube face to generate (GL_POSITIVE/NEGATIVE_X/Y/Z).
+    * texObj->BaseLevel is the level from which to generate the remaining
+    * mipmap levels.
     */
    void (*GenerateMipmap)(struct gl_context *ctx, GLenum target,
                           struct gl_texture_object *texObj);

diff --git a/src/mesa/main/fbobject.c b/src/mesa/main/fbobject.c
index f63ed8cd3dbf3c609b911b866a63d5551bae2d9d..b5b55fc83d1ab7226b061d0b35ae7c89b2280063 100644 (file)
--- a/src/mesa/main/fbobject.c
+++ b/src/mesa/main/fbobject.c
@@ -2977,6 +2977,11 @@ invalid_pname_enum:
 }
 
 
+/**
+ * Generate all the mipmap levels below the base level.
+ * Note: this GL function would be more useful if one could specify a
+ * cube face, a set of array slices, etc.
+ */
 void GLAPIENTRY
 _mesa_GenerateMipmap(GLenum target)
 {