Commits

Michele Bini  committed 0142561

Improve description of command-line.

  • Participants
  • Parent commits 0b70151

Comments (0)

Files changed (1)

 #!/usr/bin/perl -w
 
-# Copyright (c) 2009, 2010, 2012 by Michele Bini <michele.bini@gmail.com>
+# Copyright (c) 2009, 2010, 2012 Michele Bini <michele.bini@gmail.com>
 
 # This program is free software: you can redistribute it and/or modify
 # it under the terms of the version 3 of the GNU General Public License
 die "Unrecognized option. Try $0 --help for more information" unless
 GetOptions
 "help" => sub {
-  print STDERR
-      "photocrop - Perspective-correct photo cropping
+  print
+    "photocrop - Perspective-correct photo cropping
 
-$0 [--size <width>x<height>] [--fullscreen] [--verbose] [--debug] image.jpg\n  --delay <ms> - time delay for each frame (1/1000 of a second)\n
+Usage: $0 OPTIONS* image.jpg\n
 
-Vieving options:
+Options:
   --angle ANGLE
-  --viewangle ANGLE      initial angle of perspective view
-  --turn ANGLE           initial right-side turn
-  --tilt ANGLE           initial up-tilt
-  --rotation ANGLE       initial image rotation
-  --viewrotation ANGLE   view rotation
-  --savebmp FILE         Output a screenshot to FILE before exiting
-  --savepovray FILE      Output a povray scene to FILE of the current view before exiting
-  --scaledetectedangle RATIO   # Scale detected aperture angle by RATIO
-  --scaledetectedanglex RATIO  # Same for the X coordinate
-  --scaledetectedangley RATIO  # Same for the Y coordinate
-  ANGLE: <decimal-number> <deg|rad>
-
-Display:
-  --fullscreen
+  --viewangle ANGLE     Initial angle of perspective view
+  --turn ANGLE          Initial right-side turn
+  --tilt ANGLE          Initial up-tilt
+  --rotation ANGLE      Initial image rotation
+  --viewrotation ANGLE  View rotation
 
-Output:
-  --scaleup X       scales up X times the image rendered by povray
-  --savepng FILE    save to file the view rendered with povray
-  --savebmp  FILE   save displayed image to file on exit (low quality,not recommended)
-  --savepovray FILE  save to povray file on exit
+ANGLE: <decimal-number> <deg|rad>
+
+Saving options:
+  --savebmp FILE     Output a screenshot to FILE.
+  --savepovray FILE  Output a povray scene to FILE of the current view.
+
+Files are saved when the program exits.
+
+Scale detected angles:
+  --scaledetectedangle RATIO   Scale detected aperture angle by RATIO
+  --scaledetectedanglex RATIO  Same for the X coordinate
+  --scaledetectedangley RATIO  Same for the Y coordinate
 
-Interactive options
-  --[no-]crosshair   [de]activate a blinking, angle measuring crosshair
+Diagnostic options:
+  --verbose  Verbose operation
+  --debug    Debug program
 
-Program parameters:
-  --screensize WxH   set window/screen size
+Interface options:
+  --screensize WxH   Set window/screen size
   --noscreenresize   Don't allow window resize
-  --rungimp          run gimp on generated file
-  --delay MS         delay frames MS milliseconds
-  --notile           do not tile main texture!
-  --texdim S         use size S for texture tiles (future option)
-  --verbose
-  --debug
-";
-},
+  --rungimp          Run gimp on generated file
+  --delay MS         Delay frames MS milliseconds
+  --notile           Do not tile main texture!
+  --texdim S         Use size S for texture tiles (future option)
+  --fullscreen       Use full screen display
+  --[no-]crosshair   [De]Activate a blinking, angle measuring crosshair
+
+Output:
+  --scaleup X        Scales up X times the image rendered by povray
+  --savepng FILE     Save to file the view rendered with povray
+  --savebmp FILE     Save displayed image to file on exit (low quality,not recommended)
+  --savepovray FILE  Save to povray file on exit
+"; exit},
 "scaledetectedanglex=s" => \$scaledetectedanglex,
 "scaledetectedangley=s" => \$scaledetectedangley,
 "scaledetectedangle=s" => \$scaledetectedangle,