Changeset 5166 for pjproject/trunk/pjmedia/include/pjmedia/types.h

Timestamp:

Aug 21, 2015 6:46:32 AM (9 years ago)

Author:

ming

Message:

Fixed #1880: Incorrect orientation after switching video capture or when using back camera

Included in this fix:

• Change the spec & doc of pjmedia_orient enumeration
• Change iOS sample app to rotate all video devices upon orientation change event.
• Set orientation as well when fast switching cameras (for iOS and Android)

File:

• pjproject/trunk/pjmedia/include/pjmedia/types.h (modified) (4 diffs)

pjproject/trunk/pjmedia/include/pjmedia/types.h

@@ -203 +203 @@
 
     /**
-     * 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,
@@ -210 +210 @@
     /**
      * 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,
@@ -216 +220 @@
     /**
      * 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,
@@ -222 +226 @@
     /**
      * 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