From a92a509ac844fdad796748848d1143b27547173f Mon Sep 17 00:00:00 2001
From: Johannes Schickel
Date: Sat, 14 Jul 2012 05:35:20 +0200
Subject: GRAPHICS: Allow in-place conversion with any color formats in
 crossBlit.

---
 graphics/conversion.h | 9 ++++++---
 1 file changed, 6 insertions(+), 3 deletions(-)

(limited to 'graphics/conversion.h')

diff --git a/graphics/conversion.h b/graphics/conversion.h
index 0dce3cf279..28e64a94fb 100644
--- a/graphics/conversion.h
+++ b/graphics/conversion.h
@@ -60,9 +60,12 @@ inline static void RGB2YUV(byte r, byte g, byte b, byte &y, byte &u, byte &v) {
  *					false if there is an error.
  *
  * @note Blitting to a 3Bpp destination is not supported
- * @note This can convert a rectangle in place, if the source and
- *		 destination format have the same bytedepth.
- *
+ * @note This can convert a surface in place, regardless of the
+ *       source and destination format, as long as there is enough
+ *       space for the destination. The dstPitch / srcPitch ratio
+ *       must at least equal the dstBpp / srcBpp ratio for
+ *       dstPitch >= srcPitch and at most dstBpp / srcBpp for
+ *       dstPitch < srcPitch though.
  */
 bool crossBlit(byte *dst, const byte *src,
                const uint dstPitch, const uint srcPitch,
-- 
cgit v1.2.3