"SfR Fresh" - the SfR Freeware/Shareware Archive

Member "i_options.txt" of archive iview410g.zip:


As a special service "SfR Fresh" has tried to format the requested source page into HTML format using source code syntax highlighting with prefixed line numbers. Alternatively you can here view or download the uninterpreted source code file. That can be also achieved for any archive member file by clicking within an archive contents listing on the first character of the file(path) respectively on the according byte size field.
    1 -------------------------------------------------------------------------------
    2 File  : 'options.txt' - Command line options for IrfanView
    3 Author: Irfan Skiljan
    4 E-Mail: irfanview@gmx.net
    5 WWW   : http://www.irfanview.com
    6 -------------------------------------------------------------------------------
    7 
    8 List of all command line options supported in IrfanView:
    9 --------------------------------------------------------
   10 
   11   /one                  - force "only one instance"
   12   /fs                   - force Full Screen display
   13   /bf                   - force "Fit images to desktop" display option
   14   /title=text           - set window title to "text"
   15   /pos=(x,y)            - move IrfanView window to x,y
   16   /convert=filename     - convert input file to "filename" and CLOSE IrfanView
   17                           (Note: See pattern help file page for more options)
   18   /slideshow=txtfile    - play slideshow with the files from "txtfile"
   19   /slideshow=folder     - play slideshow with the files from "folder"
   20   /thumbs               - force thumbnails
   21   /killmesoftly         - close all IrfanView instances
   22   /closeslideshow       - close slideshow and IrfanView after the last image
   23   /page=X               - open page number X from a multipage input image
   24   /crop=(x,y,w,h)       - crop input image: x-start, y-start, width, height
   25   /print                - print to default printer and CLOSE IrfanView
   26   /print="Name"         - print to specific printer and CLOSE IrfanView
   27   /resize=(w,h)         - resize input image to w (width) and h (height)
   28   /resize_long=X        - resize input image: set long side to X
   29   /resize_short=X       - resize input image: set short side to X
   30   /resample             - for resize: use Resample option (better quality)
   31   /capture=X            - capture the screen or window
   32   /ini                  - use the Windows folder for INI/LST files (read/save)
   33   /ini="Folder"         - use the folder "Folder" for INI/LST files (read/save)
   34   /clippaste            - paste image from the clipboard
   35   /clipcopy             - copy image to the clipboard
   36   /silent               - don't show messages for command line read/save errors
   37   /invert               - invert the input image
   38   /dpi=(x,y)            - change image DPI values, set DPIs for scanning
   39   /scan                 - acquire the image from the TWAIN device (show TWAIN dialog)
   40   /scanhidden           - acquire the image from the TWAIN device (hide TWAIN dialog)
   41   /batchscan=(options)  - simulate menu: File->Batch Scan, see below for example
   42   /bpp=BitsPerPixel     - change color depth of the input image to BitsPerPixel
   43   /swap_bw              - swap black and white color
   44   /gray                 - convert input image to grayscale
   45   /rotate_r             - rotate input image to right
   46   /rotate_l             - rotate input image to left
   47   /filepattern="x"      - browse only specific files
   48   /sharpen=X            - open image and apply the sharpen filter value X
   49   /contrast=X           - open image and apply the contrast value X
   50   /bright=X             - open image and apply the brighntess value X
   51   /gamma=X              - open image and apply the gamma correction value X
   52   /advancedbatch        - apply Advanced Batch Dialog options to image (from INI file)
   53   /hide=X               - hide toolbar, status bar, menu and/or caption of the main window
   54   /aspectratio          - used for resizes: keep image proportions
   55   /info=txtfile         - write image infos to "txtfile"
   56   /fullinfo             - used for /info, write EXIF, IPTC, Comment data
   57   /append=tiffile       - append image as (TIF) page to "tiffile"
   58   /multitif=(tif,files) - create multipage TIF from input files
   59   /panorama=(X,files)   - create panorama image from input files; X = direction (1 or 2)
   60   /jpgq=X               - set JPG save quality
   61   /tifc=X               - set TIF save compression
   62   /wall=X               - set image as wallpaper
   63   /extract=(folder,ext) - extract all pages from a multipage file
   64   /import_pal=palfile   - import and apply a special palette to the image (PAL format)
   65   /monitor=X            - start EXE-Slideshow on monitor X
   66 
   67 
   68 Important notes:
   69 - Only lower case options are supported (don't type any UPPERCASE letters) !
   70 - Input file name (if required) is always the first parameter!
   71 - Use "" for file names with spaces, example: "c:\images\dummy test file.jpg"
   72 - Write always the FULL paths for file names
   73 - You can combine several options in one command
   74 - Wildcards supported only for /convert, /print and /info
   75 - Maximal command line length is limited by Windows
   76 
   77 
   78 Example for conversion: 
   79   i_view32.exe c:\test.bmp /convert=c:\giftest.gif
   80   => Convert file: 'c:\test.bmp' to 'c:\giftest.gif' without GUI ;-)
   81   i_view32.exe c:\*.jpg /convert=d:\temp\*.gif
   82   i_view32.exe c:\*.jpg /resize=(500,300) /aspectratio /resample /convert=d:\temp\*.png
   83   i_view32.exe c:\test.bmp /convert=c:\test_$Wx$H.jpg
   84   i_view32.exe c:\*.jpg /advancedbatch /convert=c:\temp\*.jpg
   85   (Note: supported are all IrfanView read/save formats except audio/video)
   86 
   87 Example for slideshow: 
   88   i_view32.exe /slideshow=c:\mypics.txt
   89   (Note: The file 'c:\mypics.txt' contains, in each line, a name of an image file,
   90          including the full path OR path relative to "i_view32.exe") 
   91   i_view32.exe /slideshow=c:\images\
   92   i_view32.exe /slideshow=c:\images\*.jpg
   93   i_view32.exe /slideshow=c:\images\test*.jpg
   94 
   95 Example for closeslideshow: 
   96   i_view32.exe /slideshow=c:\mypics.txt /closeslideshow
   97   => IrfanView will be closed after the last image from 'c:\mypics.txt'
   98 
   99 Example for thumbnails: 
  100   i_view32.exe c:\test\image1.jpg /thumbs
  101   => open 'image1.jpg' and display thumbnails from directory 'c:\test'
  102   or
  103   i_view32.exe c:\test /thumbs
  104   => display thumbnails from directory 'c:\test'
  105 
  106 Example for close: 
  107   i_view32.exe /killmesoftly
  108   => close IrfanView and terminate all instances
  109 
  110 Example for page:
  111   i_view32.exe c:\test.tif /page=3
  112   => Open page number 3 from the multipage image 'c:\test.tif'
  113 
  114 Example for crop:
  115   i_view32.exe c:\test.jpg /crop=(10,10,300,300)
  116   => Open 'c:\test.jpg' and crop: x-start=10, y-start=10, width=300, height=300
  117 
  118 Example for print:
  119   i_view32.exe c:\test.jpg /print
  120   => Open 'c:\test.jpg', print the image to default printer and close IrfanView
  121   i_view32.exe c:\test.jpg /print="Printer Name"
  122   => Open 'c:\test.jpg', print the image to specific printer and close IrfanView
  123   i_view32.exe c:\*.jpg /print
  124   => Print all JPGs from "C:\" and close IrfanView
  125 
  126 Example for resize:
  127   i_view32.exe c:\test.jpg /resize=(300,300) /resample
  128   => Open 'c:\test.jpg' and resample: width=300, height=300
  129   (Note: Resample uses the the active resample filter from the INI file)
  130   i_view32.exe c:\test.jpg /resize=(300,300) /aspectratio
  131   => Open 'c:\test.jpg' and resize: width = max. 300, height = max. 300, proportional
  132   i_view32.exe c:\test.jpg /resize=(300,0) /aspectratio
  133   => Open 'c:\test.jpg' and resize: width=300, height=proportional
  134   i_view32.exe c:\test.jpg /resize_long=300 /aspectratio /resample
  135   => Open 'c:\test.jpg' and resample: long side=300, short side=proportional
  136   i_view32.exe c:\test.jpg /resize=(300,0)
  137   => Open 'c:\test.jpg' and resize: width=300, height=original
  138   i_view32 c:\test.jpg /resize=(150p,150p)
  139   => Open 'c:\test.jpg' and resize: width=150%, height=150%
  140 
  141 Example for capture:
  142   i_view32.exe /capture=0
  143   => Capture the whole screen
  144   i_view32.exe /capture=1
  145   => Capture the foreground window
  146   i_view32.exe /capture=2
  147   => Capture the client area of the foreground window
  148   Advanced examples:
  149   i_view32.exe /capture=1 /convert=c:\test.jpg
  150   Capture foreground window and save result as file.
  151   i_view32.exe /capture=1 /convert=c:\capture_$U(%d%m%Y_%H%M%S).jpg
  152   Capture foreground window and save result as file; the file name contains time stamp.
  153 
  154 Example for ini:
  155   i_view32.exe /ini
  156   i_view32.exe c:\test.jpg /ini
  157   i_view32.exe c:\test.jpg /ini="c:\temp\"
  158 
  159 Example for clipboard paste:
  160   i_view32.exe /clippaste
  161   i_view32.exe /clippaste /convert=c:\test.gif
  162 
  163 Example for clipboard copy:
  164   i_view32.exe c:\test.jpg /clipcopy
  165   i_view32.exe c:\test.jpg /clipcopy /killmesoftly
  166 
  167 Example for /invert:
  168   i_view32.exe c:\test.jpg /invert
  169 
  170 Example for /dpi:
  171   i_view32.exe c:\test.jpg /dpi=(72,72)
  172 
  173 Example for /scan:
  174   i_view32.exe /scan
  175   i_view32.exe /scanhidden
  176   i_view32.exe /scanhidden /dpi=(150,150)
  177   i_view32.exe /scan /convert=c:\test.gif
  178   i_view32.exe /scanhidden /convert=c:\test.gif
  179   i_view32.exe /print /scan
  180 
  181 Example for /batchscan=(options):
  182   options = all 8 options from the batch scan dialog:
  183   filename, index, increment, digits, skip, dest-folder, save-extension, multi-tif
  184   i_view32.exe /batchscan=(scanfile,1,1,2,1,c:\temp,bmp,0)
  185   i_view32.exe /batchscan=(scanfile,1,1,2,1,c:\temp,bmp,0) /dpi=(150,150)
  186   i_view32.exe /batchscan=(scanfile,1,1,2,0,c:\temp,tif,1)
  187   i_view32.exe /batchscan=(scanfile,1,1,2,1,c:\temp,bmp,0) /scanhidden
  188 
  189 Example for /bpp:
  190   Example: i_view32.exe c:\test.jpg /bpp=8
  191   Supported BPP-values: 1, 4, 8 and 24 (decrease/increase color depth)
  192   => Open 'c:\test.jpg' and reduce to 256 colors
  193 
  194 Example for /filepattern:
  195   i_view32.exe c:\images\ /thumbs /filepattern="*.jpg"
  196   => Go to folder "c:\images\" and show JPG thumbnails only 
  197   i_view32.exe c:\images\ /thumbs /filepattern="123*.jpg"
  198   => Go to folder "c:\images\" and show JPG with names "123*" as thumbnails
  199 
  200 Example for /sharpen:
  201   i_view32.exe c:\test.jpg /sharpen=33
  202 
  203 Examples for /hide:
  204   Values (can be combined (add values)):
  205     Toolbar     1
  206     Status bar  2
  207     Menu bar    4
  208     Caption     8
  209   i_view32.exe c:\test.jpg /hide=1
  210   => Open 'c:\test.jpg', hide toolbar only
  211   i_view32.exe c:\test.jpg /hide=3
  212   => Open 'c:\test.jpg', hide toolbar and status bar
  213   i_view32.exe c:\test.jpg /hide=12
  214   => Open 'c:\test.jpg', hide caption and menu bar
  215   i_view32.exe c:\test.jpg /hide=15
  216   => Open 'c:\test.jpg', hide all
  217 
  218 Examples for /info:
  219   i_view32.exe c:\test.jpg /info=c:\test.txt
  220   i_view32.exe c:\*.jpg /info=c:\jpgs.txt
  221   i_view32.exe c:\test.jpg /info=c:\test.txt /fullinfo
  222 
  223 Example for /append:
  224   i_view32.exe c:\test.jpg /append=c:\test.tif
  225   => Open 'c:\test.jpg' and append it as page to 'c:\test.tif'
  226 
  227 Example for /multitif:
  228   Syntax: /multitif=(tifname,file1,...,fileN)
  229   First file is the name of the result TIF file.
  230   i_view32.exe /multitif=(c:\test.tif,c:\test1.bmp,c:\dummy.jpg)
  231   => Create multipage TIF (c:\test.tif) from 2 other files
  232 
  233 Example for /panorama:
  234   Syntax: /panorama=(X,file1,...,fileN)
  235   First parameter (X) is the direction: 1 = horizontal, 2 = vertical.
  236   i_view32.exe /panorama=(1,c:\test1.bmp,c:\dummy.jpg)
  237   => Create horizontal panorama image from 2 other files
  238 
  239 Example for /jpgq:
  240   i_view32.exe c:\test.jpg /jpgq=75 /convert=c:\new.jpg
  241   => Open 'c:\test.jpg' and save it as c:\new.jpg, quality = 75
  242   Quality range: 1 - 100.
  243 
  244 Example for /tifc:
  245   i_view32.exe c:\test.jpg /tifc=4 /convert=c:\new.tif
  246   => Open 'c:\test.jpg' and save it as c:\new.tif, compression = Fax4
  247   Compressions: 0 = None, 1 = LZW, 2 = Packbits, 3 = Fax3, 4 = Fax4, 5 = Huffman, 
  248   6 = JPG, 7 = ZIP
  249 
  250 Example for wallpaper:
  251   i_view32.exe c:\test.jpg /wall=0
  252   => Open 'c:\test.jpg' and set is as wallpaper (centered)
  253   i_view32.exe c:\test.jpg /wall=1
  254   => Open 'c:\test.jpg' and set is as wallpaper (tiled)
  255   i_view32.exe c:\test.jpg /wall=2
  256   => Open 'c:\test.jpg' and set is as wallpaper (stretched)
  257 
  258 Example for /extract:
  259   i_view32.exe c:\multipage.tif /extract=(c:\temp,jpg)
  260   => Open 'c:\multipage.tif' and save all pages to folder 'c:\temp' as JPGs
  261 
  262 Example for /monitor:
  263   MySlideshow.exe /monitor=2
  264   => Start standalone slideshow on monitor 2
  265 
  266 Example for /advancedbatch:
  267   i_view32.exe c:\test.jpg /advancedbatch /convert=c:\image.jpg
  268   (some Misc. Advanced Batch options are not supported: overwrite, delete, subfolders, all pages)
  269   => Open 'c:\test.jpg', apply Advanced Batch options and save as new file