summaryrefslogtreecommitdiff
path: root/libavutil/display.h
diff options
context:
space:
mode:
authorVittorio Giovara <vittorio.giovara@gmail.com>2015-03-17 17:38:48 +0000
committerVittorio Giovara <vittorio.giovara@gmail.com>2015-03-23 20:53:28 +0000
commite4fe535d12f4f30df2dd672e30304af112a5a827 (patch)
tree1ed7edafbb76a3dadaf01e190c681682f8873896 /libavutil/display.h
parente0046bc9c96150fa06146ace9093f06857dd7b23 (diff)
mov: Write the display matrix in order
This will allow to copy the matrix as is and it is just cleaner to keep the matrix in the same order specified by the mov standard (which is also explicitly described in the documentation). In order to preserve compatibility, flip the angle sign in the display API av_display_rotation_set() and av_display_rotation_get(), and improve the documentation mentioning the rotation direction.
Diffstat (limited to 'libavutil/display.h')
-rw-r--r--libavutil/display.h10
1 files changed, 5 insertions, 5 deletions
diff --git a/libavutil/display.h b/libavutil/display.h
index 7e37627637..dba3b1e60d 100644
--- a/libavutil/display.h
+++ b/libavutil/display.h
@@ -55,9 +55,9 @@
* Extract the rotation component of the transformation matrix.
*
* @param matrix the transformation matrix
- * @return the angle (in degrees) by which the transformation rotates the frame.
- * The angle will be in range [-180.0, 180.0], or NaN if the matrix is
- * singular.
+ * @return the angle (in degrees) by which the transformation rotates the frame
+ * counterclockwise. The angle will be in range [-180.0, 180.0],
+ * or NaN if the matrix is singular.
*
* @note floating point numbers are inherently inexact, so callers are
* recommended to round the return value to nearest integer before use.
@@ -65,8 +65,8 @@
double av_display_rotation_get(const int32_t matrix[9]);
/**
- * Initialize a transformation matrix describing a pure rotation by the
- * specified angle (in degrees).
+ * Initialize a transformation matrix describing a pure counterclockwise
+ * rotation by the specified angle (in degrees).
*
* @param matrix an allocated transformation matrix (will be fully overwritten
* by this function)