The command-line switches (or parameters) let you create thumbnails and Web pages without using the program's interface. This is particularly useful if you want to use Easy Thumbnails to create thumbnails from other applications. Furthermore, you can use these switches to create simple Web pages of your images — the layout and appearance can be controlled through template files.
You can specify as many parameters as the command line can take. Each parameter must be separated by a space. Use double quotes around values that contain blank characters. The first parameter should be used to specify which file(s) to process. The order of the other parameters is not important. You can either use a forward slash (/) or a hyphen (-) to mark the start of a switch.
EzThumbs.exe Files [Switches]
The following examples show all the available switches:
EzThumbs.exe "c:\My Documents\*.jpg;*.png" /D="C:\temp" /P="tn_" /W=200 /H=200 /Z= ShrinkToFit /F=Mitchell /Q=70 /B=+10 /C=+5 /S=+20 /R=90 /HTML=Pictures.html /T=Template.html /L
EzThumbs.exe "c:\Web\tn_*.jpg" /HTML=Index.html /T=MyTemplate.htm /L /OnlyHtml
EzThumbs.exe -Log -List="c:\My Documents\Images.lst"
Examples using the /Log switch:
EzThumbs.exe "test\*.jpg" /Log
EzThumbs.exe "c:\temp\*.jpg" /Log=Output
EzThumbs.exe "*.jpg" /Log="c:\My Documents\Thumbnails.dat"
Definitions
Defines the image file(s) to process. If used, this parameter should be the first one. You can use DOS wildcards (*, ?) to specify multiple files. Use a semicolon to separate multiple criteria. If no pathname is specified, Easy Thumbnails will search for the images in the current folder. Relative pathnames may be used. Use double quotes around filenames that contain blank characters. Note that Easy Thumbnails will automatically close after processing instructions when you use this command-line parameter.
|
Defines the output folder for saving the thumbnail files. Relative pathnames may be used and are expanded based on the location specified by the "Files" parameter. If this switch is not used, the "Save in" folder specified in the Easy Thumbnails settings is used.
| | /P=ThumbPrefix | Defines the prefix to use for the generated thumbnail files. If you prefer to have the thumbnail prefix text added as the filename suffix, just use an underscore character at the beginning. Example: _tn. If you don't want a prefix added to the filename, just leave the switch value empty. If this switch is not used, the Prefix specified in the Easy Thumbnails settings is used.
|
| /W=MaxImageWidth | Use this switch to define the maximum image width in pixels used to resize the images. A value of 0 (zero) indicates no resizing. If you don't specify the /H switch, this value will also be used for the maximum image height. If neither the /W and /H switches are used, the "Max. width" value specified in the Easy Thumbnails settings is used.
|
| /H=MaxImageHeight | Use this switch to define the maximum image height in pixels used to resize the images. A value of 0 (zero) indicates no resizing. If you don't specify the /W switch, this value will also be used for the maximum image width. If neither the /W and /H switches are used, the "Max. height" value specified in the Easy Thumbnails settings is used.
|
| /Z=ResizeMode | Defines how the image should be resized. The following values are available and correspond to the settings available in the Resize drop-down list: BestFit, EnlargeToFit, NoResize, ShrinkToFit, StretchToFit.
|
| /F=ResizeFilter | Defines the resampling method to use when resizing images. The following values are available and correspond to the settings available in the Algorithm drop-down list: Smart, Bell, BSpline, FastLinear, Hermite, Lanczos3, Linear, Lossless, Mitchell, Nearest, None, Triangle.
|
| /Q=JpegQuality | This switch accepts a value between 1 and 100. It defines the quality and degree of compression used for creating Jpeg thumbnail images. Higher values produce better quality images, but with bigger file sizes. A value of 75 generally produces good results. If this switch is not used, the "JPG quality" value specified in the Easy Thumbnails settings is used.
|
| /B=Brightness | Use this switch to change the brightness of the generated images. Values can range from -100 to +100. Negative values darken the image and positive values lighten it. A value of 0 (zero) leaves the brightness unchanged. If this switch is not used, the "Brightness" value specified in the Easy Thumbnails settings is used.
|
| /C=Contrast | Use this switch to change the contrast of the generated images. Values can range from -100 to +100. Negative values reduce contrast and positive values increase it. A value of 0 (zero) leaves the contrast unchanged. If this switch is not used, the "Contrast" value specified in the Easy Thumbnails settings is used.
|
| /S=Sharpness | Use this switch to change the sharpness of the generated images. Values can range from -100 to +100. Negative values soften the image and positive values sharpen it. A value of 0 (zero) leaves the sharpness unchanged. If this switch is not used, the "Sharpness" value specified in the Easy Thumbnails settings is used.
|
| /R=RotationAngle | Use this switch to change the angle of the generated images. Values represent degrees and can range from -180 to +180. Negative values rotate the image anti-clockwise and positive values clockwise. A value of 0 (zero) leaves the angle unchanged. If this switch is not used, the "Rotate" value specified in the Easy Thumbnails settings is used.
|
| /HTML=OutputName | If you want to create a Web page of the generated thumbnail images, specify a filename for the switch value. The file is always created in the same folder as the thumbnail images, so you should not include a pathname. The ".html" extension is assumed if the specified filename does not have an extension. The Web page layout and appearance can be customized through the use of template files. See the /T switch below to define which template file to use. Use the /L switch to convert image names to lowercase in the Web page. Add the /OnlyHtml switch if you don't want to produce new images but just want a Web page.
|
| /T=TemplateName | Use this switch to use a different template file for the layout of your images Web page. If this switch is not specified, Easy Thumbnails will use the default template file "Template.html". When used together with the Files parameter, a Web page with the pictures is saved as index.html if you omit the /HTML switch. See the topic about Web Page Templates for more information.
|
| /LIST=ListName | You can instruct Easy Thumbnails to process images based on a file containing a list of filenames. For more details, see the topic about File Lists.
|
| /L | Use this switch to convert image names to lowercase in the Web page created through the /HTML switch.
|
| /M | When creating thumbnails through the command-line, Easy Thumbnails does not show how many thumbnails it created. You can override this behavior with the /M switch. Easy Thumbnails will then display a message window with the number of thumbnails it created.
|
| /Log | When you use this switch, status and error messages are stored in a log file instead of being displayed on the screen. You can specify a filename for the log results by using an equal sign after /LOG followed by the filename (see the examples above). If you don't specify a log file, results will be stored in a file called "EzThumbs.log" in the program's folder.
|
| /OnlyHtml | Use this switch together with the /HTML switch to create a Web page of the specified images without producing new images (or thumbnails). The "Files" switch is required and thumbnail-related switches are ignored (/D /P /W /H /Z /F /Q /B /C /S /R).
|
Important note
Thanks to these command-line switches, Easy Thumbnails is an ideal companion for applications that need to process images. If you would like to bundle Easy Thumbnails with your product or run it on a server as a process for another application, please contact Fookes Software to discuss a licensing agreement.