Change crop rectangle format from L,T/WxH to (L,T)/WxH

[media-ctl.git] / options.c

diff --git a/options.c b/options.c
index 5e4c9f7..4f8df71 100644 (file)
--- a/options.c
+++ b/options.c
@@ -30,27 +30,53 @@ struct media_options media_opts = {
        .devname = MEDIA_DEVNAME_DEFAULT,
 };
 
-static void usage(const char *argv0)
+static void usage(const char *argv0, int verbose)
 {
        printf("%s [options] device\n", argv0);
        printf("-d, --device dev        Media device name (default: %s)\n", MEDIA_DEVNAME_DEFAULT);
        printf("-e, --entity name       Print the device name associated with the given entity\n");
-       printf("-f, --formats           Comma-separated list of formats to setup\n");
-       printf("-h, --help              Show this help screen\n");
+       printf("-f, --set-format        Comma-separated list of formats to setup\n");
+       printf("    --get-format pad    Print the active format on a given pad\n");
+       printf("-h, --help              Show verbose help and exit\n");
        printf("-i, --interactive       Modify links interactively\n");
        printf("-l, --links             Comma-separated list of links descriptors to setup\n");
        printf("-p, --print-topology    Print the device topology (implies -v)\n");
        printf("    --print-dot         Print the device topology as a dot graph (implies -v)\n");
        printf("-r, --reset             Reset all links to inactive\n");
        printf("-v, --verbose           Be verbose\n");
+
+       if (!verbose)
+               return;
+
+       printf("\n");
+       printf("Links and formats are defined as\n");
+       printf("\tlink            = pad, '->', pad, '[', flags, ']' ;\n");
+       printf("\tformat          = pad, '[', fcc, ' ', size, [ ' ', crop ], [ ' ', '@', frame interval ], ']' ;\n");
+       printf("\tpad             = entity, ':', pad number ;\n");
+       printf("\tentity          = entity number | ( '\"', entity name, '\"' ) ;\n");
+       printf("\tsize            = width, 'x', height ;\n");
+       printf("\tcrop            = '(', left, ',', top, ')', '/', size ;\n");
+       printf("\tframe interval  = numerator, '/', denominator ;\n");
+       printf("where the fields are\n");
+       printf("\tentity number   Entity numeric identifier\n");
+       printf("\tentity name     Entify name (string) \n");
+       printf("\tpad number      Pad numeric identifier\n");
+       printf("\tflags           Link flags (0: inactive, 1: active)\n");
+       printf("\tfcc             Format FourCC\n");
+       printf("\twidth           Image width in pixels\n");
+       printf("\theight          Image height in pixels\n");
+       printf("\tnumerator       Frame interval numerator\n");
+       printf("\tdenominator     Frame interval denominator\n");
 }
 
-#define OPT_PRINT_DOT  256
+#define OPT_PRINT_DOT          256
+#define OPT_GET_FORMAT         257
 
 static struct option opts[] = {
        {"device", 1, 0, 'd'},
        {"entity", 1, 0, 'e'},
-       {"formats", 1, 0, 'f'},
+       {"set-format", 1, 0, 'f'},
+       {"get-format", 1, 0, OPT_GET_FORMAT},
        {"help", 0, 0, 'h'},
        {"interactive", 0, 0, 'i'},
        {"links", 1, 0, 'l'},
@@ -65,7 +91,7 @@ int parse_cmdline(int argc, char **argv)
        int opt;
 
        if (argc == 1) {
-               usage(argv[0]);
+               usage(argv[0], 0);
                return 1;
        }
 
@@ -85,7 +111,7 @@ int parse_cmdline(int argc, char **argv)
                        break;
 
                case 'h':
-                       usage(argv[0]);
+                       usage(argv[0], 1);
                        exit(0);
 
                case 'i':
@@ -113,6 +139,10 @@ int parse_cmdline(int argc, char **argv)
                        media_opts.print_dot = 1;
                        break;
 
+               case OPT_GET_FORMAT:
+                       media_opts.pad = optarg;
+                       break;
+
                default:
                        printf("Invalid option -%c\n", opt);
                        printf("Run %s -h for help.\n", argv[0]);