Update documentation about video orientation

PR #4441 <https://github.com/Genymobile/scrcpy/pull/4441>
Add --orientation
2026-03-26 22:14:30 +01:00 · 2023-11-23 23:34:46 +01:00 · 2023-11-23 23:34:46 +01:00 · 2023-11-23 23:34:46 +01:00 · 2023-11-23 23:27:32 +01:00 · 2023-11-23 23:27:28 +01:00
3 changed files with 7 additions and 6 deletions
--- a/app/src/cli.c
+++ b/app/src/cli.c
@@ -2138,7 +2138,7 @@ parse_args_with_getopt(struct scrcpy_cli_args *args, int argc, char *argv[],
                        opts->display_orientation = SC_ORIENTATION_180;
                        break;
                    case 3:
-                        // rotation 1 was 270° counterclockwise, but orientation
+                        // rotation 3 was 270° counterclockwise, but orientation
                        // is expressed clockwise
                        opts->display_orientation = SC_ORIENTATION_90;
                        break;
@@ -2531,7 +2531,8 @@ parse_args_with_getopt(struct scrcpy_cli_args *args, int argc, char *argv[],
        if (opts->record_orientation != SC_ORIENTATION_0) {
            if (sc_orientation_is_mirror(opts->record_orientation)) {
                LOGE("Record orientation only supports rotation, not "
-                     "flipping: %s", optarg);
+                     "flipping: %s",
+                     sc_orientation_get_name(opts->record_orientation));
                return false;
            }
        }
--- a/app/src/options.c
+++ b/app/src/options.c
@@ -113,10 +113,10 @@ sc_orientation_apply(enum sc_orientation src, enum sc_orientation transform) {
        // In the final result, we want all the hflips then all the rotations,
        // so we must move hflip2 to the left:
        //
-        //     hflip1 × hflip2 × f(rotate1) × rotate2
+        //     hflip1 × hflip2 × rotate1' × rotate2
        //
-        // with f(rotate1) = | rotate1          if src is 0 or 180
-        //                   | rotate1 + 180    if src is 90 or 270
+        // with rotate1' = | rotate1           if src is 0° or 180°
+        //                 | rotate1 + 180°    if src is 90° or 270°

        src_rotation += 2;
    }
--- a/doc/video.md
+++ b/doc/video.md
@@ -130,7 +130,7 @@ scrcpy --orientation=270      # 270° clockwise
 scrcpy --orientation=flip0    # hflip
 scrcpy --orientation=flip90   # hflip + 90° clockwise
 scrcpy --orientation=flip180  # vflip (hflip + 180°)
-scrcpy --orientation=flip270  # hflip + 270°
+scrcpy --orientation=flip270  # hflip + 270° clockwise
 ```

 The orientation can be set separately for display and record if necessary, via
Author	SHA1	Message	Date
Romain Vimont	94031dfe97	Update documentation about video orientation PR #4441 <https://github.com/Genymobile/scrcpy/pull/4441>	2023-11-23 23:34:46 +01:00
Romain Vimont	b43a9e8e7a	Add --orientation Add a shortcut to set both the display and record orientations. PR #4441 <https://github.com/Genymobile/scrcpy/pull/4441>	2023-11-23 23:34:46 +01:00
Romain Vimont	a9d6cb5837	Add --record-orientation Add an option to store the orientation to apply in a recorded file. Only rotations are supported (not flips). PR #4441 <https://github.com/Genymobile/scrcpy/pull/4441>	2023-11-23 23:34:46 +01:00
Romain Vimont	2f92686930	Pass --lock-video-orientation argument in degrees For consistency with the new --display-orientation option, express the --lock-video-orientation in degrees clockwise: * --lock-video-orientation=0 -> --lock-video-orientation=0 * --lock-video-orientation=3 -> --lock-video-orientation=90 * --lock-video-orientation=2 -> --lock-video-orientation=180 * --lock-video-orientation=1 -> --lock-video-orientation=270 PR #4441 <https://github.com/Genymobile/scrcpy/pull/4441>	2023-11-23 23:27:32 +01:00
Romain Vimont	bb88b60227	Add --display-orientation Deprecate the option --rotation and introduce a new option --display-orientation with the 8 possible orientations (0, 90, 180, 270, flip0, flip90, flip180 and flip270). New shortcuts MOD+Shift+(arrow) dynamically change the display (horizontal or vertical) flip. Fixes #1380 <https://github.com/Genymobile/scrcpy/issues/1380> Fixes #3819 <https://github.com/Genymobile/scrcpy/issues/3819> PR #4441 <https://github.com/Genymobile/scrcpy/pull/4441>	2023-11-23 23:27:28 +01:00