Parâmetros da linha de comando

Light Image Resizer can be run by command line. Please refer to the following reference and examples.

Single file or folder

To process a single file or folder, simply use the following syntax:

resize.exe <File/Folder> [Options]

Exemplo:

resize.exe c:\photos /profile=original /format=bmp /run

The example above will load all supported image files from the folder c:\photos and create copies of them in bitmap format (BMP) while keeping the original dimensions.

You can also use wildcards to load specific file types from a folder. If you want to convert all bitmap images from a folder to PNG format:

resize.exe "c:\my images\*.bmp" /profile=original /format=png /run

Observação: If a path contains spaces, it needs to be wrapped in quotes, like this: “c:\my photos”
This applies to all parameters where values may contain spaces!

Multiple files

You can process several files in one operation. Make sure to use quotes if needed (as explained above):

resize.exe <Filename1> <Filename2> ... [Options]

Exemplo:

resize.exe "c:\my photos\image1.jpg" "c:\my photos\image2.jpg" /profile=desktop /run

Observação: O número máximo de caracteres numa linha de comandos pode ser limitado.
Se quiser processar uma grande quantidade de ficheiros, ou se os nomes dos caminhos forem muito longos, por favor considere usar uma lista de ficheiros (ver secção seguinte para detalhes).

Lista de ficheiros

Para processar um grande número de ficheiros de uma só vez, recomendamos utilizar uma lista de ficheiros. Basicamente, um ficheiro de texto simples, que contém o caminho completo de cada ficheiro de imagem (separado por quebras de linha). A linha de comandos utiliza esta sintaxe:

resize.exe /fl=<Filename> [Options]

Exemplo:

resize.exe /fl="c:\my path\filelist.txt" /w=800 /h=600 /action=original /run

Conteúdo de filelist.txt:

c:\photos\image1.jpg
c:\photos\image2.jpg
c:\photos\image3.jpg

O exemplo acima carrega os 3 ficheiros de imagem especificados na lista de ficheiros e redimensiona-os para 800 x 600 píxeis, substituindo os ficheiros originais.

Código de saída / código de erro

A aplicação devolverá um dos seguintes códigos de erro ao sair:

  • 0: Todos os ficheiros foram processados com sucesso
  • 1: One or more errors occurred during processing
  • 2: One or more warnings occurred during processing

Opções

The parameters below can be used to set processing options. Parameters are case-insensitive.

/Profile=[original|desktop|"<profile name>"]

Defines the profile to use:

  • original = original resolution (default)
  • desktop = desktop resolution
  • or one of the available profile names, like “Watermark”

Observação: If the profile name contains spaces, make sure to use quotes. For example:
/profile=“my custom profile”

/W=<width>

Defines the output width for images.

/H=<height>

Defines the output height for images.

/Unit=[pixel|percent]

Defines the unit used for width and height, default is “pixel”.

/Mode=[fit|stretch|center|crop|extend]

Defines the resize mode to use, default is “fit”.

Possible values:

  • fit: Resize and fit image into the target dimensions, keeping the original aspect ratio. This is the default.
  • stretch: Resize and stretch image to the target aspect ratio. Width and height will always be as specified, but result can be deformed.
  • center: Center image in the target dimensions. Remaining background (canvas) will be filled with a replacement color.
  • crop: Crop image to center with target dimensions. If image is larger than target dimensions, it will be centered.
  • extend: Make image square by extending short sides with blurred content.
/Filter=[fastlinear|linear|lanczos|cubic|nearest]

Defines the filtering mode used to scale images, default is “lanczos”.

Possible values:

  • fastlinear: Fast linear interpolation (fastest, lowest quality)
  • linear: Linear interpolation (fast, medium quality)
  • lanczos: Lanczos interpolation (slow, best quality)
  • cubic: Cubic interpolation (slow, best quality)
  • nearest: nearest neighbor interpolation
/Format=[original|bmp|jpg|gif|png|tif|jp2|pdf|psd|pcx|tga|webp|ico]

Defines the output image format (default is “original”).

/BitDepth=[auto|32|24|8|4|1]

Defines the bit depth to save with (only available if output format is BMP ou PNG).

Supported values for BMP: auto, 32, 24, 8, 4, 1
Supported values for PNG: auto, 32, 24, 8

/ColorDepth=[auto|RGB|YCbCr|CMYK|Grayscale|CIELAB]

Defines the color depth to save with (only available if output format is JPG ou TIFF)

Supported values for JPG: auto, RGB, YCbCr, CMYK, Grayscale
Supported values for TIFF: auto, RGB, CMYK, CIELAB

/Quality=[1-100]

Defines the compression quality from 1 to 100, only valid for JPG (default 80).

/AdjustPortrait=[0|1]

Adjust resolution for portrait images:

  • 0 = Off
  • 1 = On (default)
/Exif=[0|1]

Copy EXIF metadata (for JPG):

  • 0 = Off
  • 1 = On (default)
/Xmp=[0|1]

Copy XMP metadata (for JPG):

  • 0 = Off
  • 1 = On (default)
/Iptc=[0|1]

Copy IPTC metadata (for JPG):

  • 0 = Off
  • 1 = On (default)
/Icc=[0|1]

Copy embedded ICC profiles (for JPG):

  • 0 = Off
  • 1 = On (default)
/WmFile="<filename>"

Embed watermark from specified image file.

/WmAlpha=[0-255]

Transparency for watermark from 0 (fully transparent) to 255 (opaque), default is 255.

/WmPosition=[0-6]

Watermark position in output image:

  • 0 = Top Left
  • 1 = Top Center
  • 2 = Top Right
  • 3 = Bottom Left
  • 4 = Bottom Center
  • 5 = Bottom Right
  • 6 = Center (default)
/WmSpaceX=<value>

Horizontal spacing (in pixels) for watermark if not centered, default is 0.

/WmSpaceY=<value>

Vertical spacing (in pixels) for watermark if not centered, default is 0.

/Mask="<filename mask>"

Output filename mask to be used, default is “%F [%P]”. The mask can contain the following variables:

%FOriginal filename
%EOriginal file extension
%DIROriginal folder name
%PSelected profile
%WOutput image width
%HOutput image height
%NConsecutive number
Number of N’s determines number of digits:
%NN = 01, %NNN = 001, etc.
%N=xStart counting from x, where x is a number
%DCurrent day (01-31)
%MCurrent month (01-12)
%YYCurrent year (2 digits)
%YYYYCurrent year (4 digits)
X-ArtistEXIF artist information
%X-CameraEXIF camera information
%X-CopyrightEXIF copyright information
%X-DateEXIF date
%X-DescriptionEXIF description
%X-SoftwareEXIF software information
/FileDate=[0|1]

If enabled (1), keeps file date of original file. Default is disabled (0).

/Dpi=<value>

Change DPI value for formats that support it (JPEG, TIFF). Value can be between 1 and 1000.

/Invert=[0|1]

If enabled (1), colors will be inverted. Default is disabled (0).

/Grayscale=[0|1]

If enabled (1), converts images to grayscale. Default is disabled (0).

/Sepia=[0|1]

If enabled (1), adds sepia effect to images. Default is disabled (0).

/AutoEnhance=[0|1]

If enabled (1), an automatic enhancement filter is applied to images. Default is disabled (0).

/Brightness=<value>

Decrease or increase brightness by specified value (-100 to 100).

/Contrast=<value>

Decrease or increase contrast by specified value (-100 to 100).

/Split=<v>,<h>

Split images into parts, where <v> is the number of vertical rows, and <h> the number of horizontal columns. For example: /split=2,4
The maximum value for <v> e <h> is 8.

/Policy=[always|enlarge|reduce]

Resize policy to use:

  • always = Always resize
  • enlarge = Only enlarge images smaller than specified width and height
  • reduce = Only reduce images larger than specified width and height
/Rotate=<value>

Rotate image by specified value in degree (-180 to 180).
Positive values will rotate clockwise, negative values counter-clockwise.

/Flip=[horizontal|vertical]

Flip the image either horizontally or vertically.

/FixGamma=[0|1]

If enabled (1), gamma value is improved when resizing. This can prevent images from getting darker. Default is disabled (0).

/OptimizePng=[0-7]

Optimize compression of PNG images with specified level from 0 (fast) to 7 (very slow).

/OptimizeJpeg=[0|1]

If enabled (1), JPEG compression is optimized. This can be useful for images targeted for the web. Default is disabled (0).

/Action=[copy|original|move|zip|pdf|gif]

One of these actions to be performed:

  • copy = Create copies
  • original = Replace original files
  • move = Move files
  • zip = Compress in a ZIP file
  • pdf = Create a PDF
  • gif = Create animated GIF from input files
/Dest=[same|desktop|<path>]

Destination for output:

  • same = Same folder as original (default)
  • desktop = Desktop
  • <path> = A custom path, for example: “c:\my path”
/ForceDest

Create destination directory if it doesn’t exist yet without prompting

/Details

Show details (log) during operation.

/Minimized

Minimize progress window during operation.

/AutoClose

Close after images have been processed.
If you want to close only if there were no errors or warnings, use:
/AutoClose=1

/Subfolders=[0|1]

If a folder is specified as the first parameter, this determines if subfolders will be searched as well:

  • 0 = Off (default)
  • 1 = On
/Conflict=[ask|overwrite|skip|rename]

Defines what to do in case of a filename conflict:

  • ask = Display prompt to user
  • overwrite = Overwrite without warning
  • skip = Don’t touch and skip file
  • rename = Rename new file, like “file (2)”
/Run

Start processing immediately.

/OptionsPage

Go to options page directly after launch. Useful if you add files by command line, and just need to review options.