summaryrefslogtreecommitdiff
path: root/pjmedia/include/pjmedia/types.h
diff options
context:
space:
mode:
Diffstat (limited to 'pjmedia/include/pjmedia/types.h')
-rw-r--r--pjmedia/include/pjmedia/types.h18
1 files changed, 13 insertions, 5 deletions
diff --git a/pjmedia/include/pjmedia/types.h b/pjmedia/include/pjmedia/types.h
index 20e93d69..486f0ed8 100644
--- a/pjmedia/include/pjmedia/types.h
+++ b/pjmedia/include/pjmedia/types.h
@@ -202,26 +202,34 @@ typedef enum pjmedia_orient
PJMEDIA_ORIENT_UNKNOWN,
/**
- * Natural orientation, e.g: sky upside on landscape view, head upside
- * on human portrait.
+ * Natural orientation, i.e. the original orientation video will be
+ * displayed/captured without rotation.
*/
PJMEDIA_ORIENT_NATURAL,
/**
* Specifies that the video/picture needs to be rotated 90 degrees
- * clockwise to be displayed in natural orientation.
+ * from its natural orientation in clockwise direction from the user's
+ * perspective.
+ * Note that for devices with back cameras (which faces away
+ * from the user), the video will actually need to be rotated
+ * 270 degrees clockwise instead.
*/
PJMEDIA_ORIENT_ROTATE_90DEG,
/**
* Specifies that the video/picture needs to be rotated 180 degrees
- * clockwise to be displayed in natural orientation.
+ * from its natural orientation.
*/
PJMEDIA_ORIENT_ROTATE_180DEG,
/**
* Specifies that the video/picture needs to be rotated 270 degrees
- * clockwise to be displayed in natural orientation.
+ * from its natural orientation in clockwise direction from the user's
+ * perspective.
+ * Note that for devices with back cameras (which faces away
+ * from the user), the video will actually need to be rotated
+ * 90 degrees clockwise instead.
*/
PJMEDIA_ORIENT_ROTATE_270DEG