commit 2d1e978e3229bb524c6415580ad91fab051f944c
author Mathias Agopian <mathias@google.com> Mon Oct 25 17:20:19 2010 -0700
committer Mathias Agopian <mathias@google.com> Mon Oct 25 17:55:55 2010 -0700
tree 90e78e11e90956c6956f215cd66d32dd04c557f8
parent 937af9b7136a8b692812bc47eaeb9a3e255c46a5

improve hardware.h documentation

Change-Id: I637a1d8924af144a9c2cc4645659e9d23e9527d6

include/hardware/hardware.h

diff --git a/include/hardware/hardware.h b/include/hardware/hardware.h
index c41c81c..598ec2c 100644
--- a/include/hardware/hardware.h
+++ b/include/hardware/hardware.h
@@ -179,18 +179,22 @@
 
 /**
  * Transformation definitions
+ *
+ * IMPORTANT NOTE:
+ * HAL_TRANSFORM_ROT_90 is applied CLOCKWISE and AFTER HAL_TRANSFORM_FLIP_{H|V}.
+ *
  */
 
 enum {
-    /* flip source image horizontally */
+    /* flip source image horizontally (around the vertical axis) */
     HAL_TRANSFORM_FLIP_H    = 0x01,
-    /* flip source image vertically */
+    /* flip source image vertically (around the horizontal axis)*/
     HAL_TRANSFORM_FLIP_V    = 0x02,
-    /* rotate source image 90 degrees */
+    /* rotate source image 90 degrees clockwise */
     HAL_TRANSFORM_ROT_90    = 0x04,
     /* rotate source image 180 degrees */
     HAL_TRANSFORM_ROT_180   = 0x03,
-    /* rotate source image 270 degrees */
+    /* rotate source image 270 degrees clockwise */
     HAL_TRANSFORM_ROT_270   = 0x07,
 };