From 4ff212aac3764565675c9c83af378671162bc4f2 Mon Sep 17 00:00:00 2001 From: Brian Paul Date: Mon, 28 Nov 2011 18:09:14 -0700 Subject: [PATCH] mesa: update comments for _mesa_format_matches_format_and_type(), 80-column wrapping --- src/mesa/main/formats.c | 19 +++++++++---------- 1 file changed, 9 insertions(+), 10 deletions(-) diff --git a/src/mesa/main/formats.c b/src/mesa/main/formats.c index c884646..d3b12d0 100644 --- a/src/mesa/main/formats.c +++ b/src/mesa/main/formats.c @@ -2480,11 +2480,12 @@ _mesa_format_to_type_and_comps(gl_format format, } /** - * Returns a MESA_FORMAT describing pixels with the given format/type if - * available, or MESA_FORMAT_NONE. + * Check if a gl_format exactly matches a GL formaat/type combination + * such that we can use memcpy() from one to the other. * - * If a format is returned, it should be suitable to memcpy - * _mesa_get_format_bytes() at a time to move the pixel data. + * Note: this matching assumes that GL_PACK/UNPACK_SWAP_BYTES is unset. + * + * \return GL_TRUE if the formats match, GL_FALSE otherwise. */ GLboolean _mesa_format_matches_format_and_type(gl_format gl_format, @@ -2494,13 +2495,11 @@ _mesa_format_matches_format_and_type(gl_format gl_format, /* Note: When reading a GL format/type combination, the format lists channel * assignments from most significant channel in the type to least - * significant. A type with _REV indicates that the assignments are swapped, - * so they are listed from least significant to most significant. - * - * For sanity, please keep this switch statement ordered the same as the enum - * in formats.h. + * significant. A type with _REV indicates that the assignments are + * swapped, so they are listed from least significant to most significant. * - * This matching assumes that GL_PACK/UNPACK_SWAP_BYTES is unset. + * For sanity, please keep this switch statement ordered the same as the + * enums in formats.h. */ switch (gl_format) { -- 2.7.4