diff options
author | Robert Bragg <robert@linux.intel.com> | 2011-11-20 18:56:44 +0000 |
---|---|---|
committer | Robert Bragg <robert@linux.intel.com> | 2011-12-06 18:51:56 +0000 |
commit | a81458f5b9b7e11a90d2f0b7bc5b988d5d9ade34 (patch) | |
tree | 75d834e5dbf3b92d5ad8a799612fe5ed407ec7d0 /cogl/cogl.h | |
parent | ccde191191dc8560b1d8f625c36c27caccadcbb5 (diff) | |
download | cogl-a81458f5b9b7e11a90d2f0b7bc5b988d5d9ade34.tar.gz |
docs: make cogl.h matrix stack documentation consistent
This updates the cogl.h matrix stack documentation consistent with the
corresponding documentation in cogl-framebuffer.h for the framebuffer
matrix stack methods.
Reviewed-by: Neil Roberts <neil@linux.intel.com>
Diffstat (limited to 'cogl/cogl.h')
-rw-r--r-- | cogl/cogl.h | 32 |
1 files changed, 21 insertions, 11 deletions
diff --git a/cogl/cogl.h b/cogl/cogl.h index 0630a27e..bef39d45 100644 --- a/cogl/cogl.h +++ b/cogl/cogl.h @@ -367,13 +367,18 @@ cogl_get_bitmasks (int *red, /** * cogl_perspective: - * @fovy: Vertical of view angle in degrees. - * @aspect: Aspect ratio of diesplay - * @z_near: Nearest visible point - * @z_far: Furthest visible point along the z-axis + * @fovy: Vertical field of view angle in degrees. + * @aspect: The (width over height) aspect ratio for display + * @z_near: The distance to the near clipping plane (Must be positive) + * @z_far: The distance to the far clipping plane (Must be positive) * * Replaces the current projection matrix with a perspective matrix * based on the provided values. + * + * <note>You should be careful not to have to great a @z_far / @z_near + * ratio since that will reduce the effectiveness of depth testing + * since there wont be enough precision to identify the depth of + * objects near to each other.</note> */ void cogl_perspective (float fovy, @@ -383,15 +388,20 @@ cogl_perspective (float fovy, /** * cogl_frustum: - * @left: Left clipping plane - * @right: Right clipping plane - * @bottom: Bottom clipping plane - * @top: Top clipping plane - * @z_near: Nearest visible point - * @z_far: Furthest visible point along the z-axis + * @left: X position of the left clipping plane where it + * intersects the near clipping plane + * @right: X position of the right clipping plane where it + * intersects the near clipping plane + * @bottom: Y position of the bottom clipping plane where it + * intersects the near clipping plane + * @top: Y position of the top clipping plane where it intersects + * the near clipping plane + * @z_near: The distance to the near clipping plane (Must be positive) + * @z_far: The distance to the far clipping plane (Must be positive) * * Replaces the current projection matrix with a perspective matrix - * for the given viewing frustum. + * for a given viewing frustum defined by 4 side clip planes that + * all cross through the origin and 2 near and far clip planes. * * Since: 0.8.2 */ |