Using the Pixillion Command-line Tool

Contents | Previous | Next

Pixillion Image Converter

Help v 13.02

The Pixillion command-line tool allows you to use Pixillion to convert files from the Windows command line. This can be used to let other software convert files with Pixillion or to automate batch conversion.

The Pixillion executable is installed here: "C:\Program Files\NCH Software\Pixillion\Pixillion.exe"

Usage:

Pixillion.exe [command/conversion property] [parameter/property value]

Examples of usage are found at the bottom of this page.

Command parameters and property values need to be enclosed with double quotation marks (") if they contain spaces.


Commands

Command Parameter Description
-exit -Close Pixillion
-convert -Send convert command and wait for Pixillion to finish
-selectall -Set all images in Pixillion's image list to selected
-selectnone -Set all images in Pixillion's image list to unselected
-removeall -Removes all images from Pixillion's image list
-useinputfolder -Equivalent to '-outputfolder "[Same as source image]"'
-add image pathImage is added to Pixillion's image list (if not already there) and selected
-remove image pathRemove a single image from Pixillion's image list
-select image pathSet a single image from Pixillion's image list to selected


Properties

Property Valid Entries
-outputfolder
  • Absolute or relative folder path. Enclose in double quotation marks if there are spaces in the path.
-outputformat
  • Enclose in double quotation marks if there's a space in the format name (e.g. "Maya IFF").
  • AVIF
  • BMP
  • DIB
  • DOCX
  • EPS
  • GIF
  • ICO
  • Maya IFF
  • JPEG
  • JPEG 2000
  • JPEG XR
  • PCX
  • PDF
  • PGF
  • PNG
  • PNM
  • PBM
  • PGM
  • PPM
  • PSD
  • RAS
  • SVG
  • TGA
  • TIFF
  • WBMP
  • WEBP
  • WMF/EMF/EMF+/EMFDual
-scaling
  • 0 = No change
  • 1 = Percentage
  • 2 = Long side
  • 3 = Original aspect ratio
  • 4 = Custom frame size
-percent
  • 1 to 10000
-longside
  • 0 = Keep original image size
  • 1+ = Keep aspect ratio, and scale the longer side of the image to this value
-width
  • 0 = Use original image width
  • 1+ = Maximum pixel width
-height
  • 0 = Use original image height
  • 1+ = Maximum pixel height
-filter
  • 0 = Sharp square pixels for converted images
  • 1 = Smooth blurry pixels for converted images
-rotation
  • 0 = No change
  • 1 = 90 degrees clockwise
  • 2 = 180 degrees clockwise
  • 3 = 270 degrees clockwise
-flip
  • 1 = Flip Horizontal
  • 2 = Flip Vertical
-transparencycolor
  • HTML notation for color, example: #FFFF00 = yellow
-overwrite
  • 0 = Skip existing images
  • 1 = Replace existing images
  • 2 = Append number to filename
-jpeg_quality
  • 0 to 100
  • 0 = Maximum compression
  • 100 = Best quality
-textvisible
  • 0 = No watermark text applied to converted images
  • 1 = Watermark text is applied to converted images
-text
  • Watermark text content
-textfont
  • Font name. Enclose in double quotation marks if there are spaces in the name.
-textbold
  • 0 = Non-bold watermark text
  • 1 = Bold watermark text
-textitalic
  • 0 = Non-Italicized watermark text
  • 1 = Italicized watermark text
-textunderline
  • 0 = Non-underlined watermark text
  • 1 = Underlined watermark text
-textcolor
  • HTML notation for color, example: #0080FF = blue
-textbackground
  • HTML notation for color, example: #FFFFFF = white
  • 0 = No watermark text background
-textalignment
  • 0 = Top-Left corner
  • 1 = Top edge
  • 2 = Top-Right corner
  • 3 = Left edge
  • 4 = Center
  • 5 = Right edge
  • 6 = Bottom-Left corner
  • 7 = Bottom edge
  • 8 = Bottom-Right corner
-textoffsetx
  • 0 to 99
  • It is horizontal offset from Top-Left corner in percentage of the converted image width.
  • It is valid only if TextAlignment is Top-Left corner.
-textoffsety
  • 0 to 99
  • It is vertical offset from Top-Left corner in percentage of the converted image height.
  • It is valid only if TextAlignment is Top-Left corner.
-textsizedimension
  • 0 = Text size is with respect to image width.
  • 1 = Text size is with respect to image height.
-textsizemode
  • 0 = Text size is specified as number of pixels. Use TextSizeAbsolute to specify the pixel width (if TextSizeDimension=0) or height (if TextSizeDimension=1).
  • 1 = Text size is specified as a percentage of the image width (if TextSizeDimension=0) or height (if TextSizeDimension=1). Use TextSizeRelative to specify the percentage.
-textsizeabsolute
  • Text pixel width or height.
  • 1 to 32767
-textsizerelative
  • Text dimension as percentage of converted image width or height.
  • 5 to 100
-textopacity
  • 5 to 100
-image
  • Watermark image file path. Enclose in double quotation marks if there are spaces in the path.
-imagevisible
  • 0 = No watermark image applied to converted images
  • 1 = Watermark image is applied to converted images
-imagealignment
  • Watermark image alignment on main image
  • 0 = Top-Left corner
  • 1 = Top edge
  • 2 = Top-Right corner
  • 3 = Left edge
  • 4 = Center
  • 5 = Right edge
  • 6 = Bottom-Left corner
  • 7 = Bottom edge
  • 8 = Bottom-Right corner
-imageoffsetx
  • 0 to 99
  • It is horizontal offset from Top-Left corner in percentage of the converted image width.
  • It is valid only if ImageAlignment is Top-Left corner.
-imageoffsety
  • 0 to 99
  • It is vertical offset from Top-Left corner in percentage of the converted image height.
  • It is valid only if ImageAlignment is Top-Left corner.
-imagefilter
  • Watermark image scaling filter
  • 0 = Sharp square pixels
  • 1 = Smooth blurry pixels
-imagesize
  • Watermark image scale percent
  • 5 to 100
-imageopacity
  • Watermark image opacity percent
  • 5 to 100


Encoder Settings

These are additional encoder settings for the different output formats.

Encoder Setting Valid Entries
-BMP_PixelFormat
  • BMP Pixel Format
  • 0 = 8 bits (256 colors)
  • 1 = 24 bits (True color)
  • 2 = 32 bits (True color with transparency)
-ICO_Preset
  • ICO Preset
  • 0 = Windows 2000
  • 1 = Windows Vista
-ICO_Formats
  • ICO Formats (Bits per pixel combinations)
  • A number between 1 and 1023. The input number is the decimal equivalent of an 8-bit number where the 1's or true bits correspond to the ticks in the bpp checkboxes. Check the ICO encoder settings window for more details.
-PDF_PaperSize
  • PDF Paper Size
  • 0 = A0
  • 1 = A1
  • 2 = A2
  • 3 = A3
  • 4 = A4
  • 5 = Legal
  • 6 = Letter
-PDF_Orientation
  • PDF Orientation
  • 0 = Portrait
  • 1 = Landscape
-PDF_Margin
  • PDF Margin
  • 0.0 to 20.0
-PDF_ScalingMode
  • PDF Scaling Mode
  • 0 = Original Size
  • 1 = Fit to page
  • 2 = Stretch to page
-PDF_PositioningMode
  • PDF Positioning Mode
  • 0 = Left Top
  • 1 = Central
  • 2 = Left Bottom
-PDF_ImageQuality
  • PDF Image Quality
  • 0 to 100
-PDF_RotateAutomatically
  • PDF Rotate Automatically
  • 0 = False
  • 1 = True
-PNM_Format
  • PNM Format
  • 0 = Monochrome Plain (PBM ASCII)
  • 1 = Greyscale Plain (PGM ASCII)
  • 2 = RGB Plain (PPM ASCII)
  • 3 = Monochrome Binary (PBM Raw)
  • 4 = Grayscale Binary (PGM Raw)
  • 5 = RGB Binary (PPM Raw)
-TIFF_Color
  • TIFF Color
  • 0 = True color (24/32bits per pixel)
  • 1 = Less colors (256 Colors)
-WMF_Format
  • WMF/EMF Format
  • 1 = WMF: 16-bit GDI
  • 2 = WMF: 16-bit GDI with placeable header
  • 3 = EMF: 32-bit GDI
  • 4 = EMF+: GDI+
  • 5 = Contains both EMF and EMF+
-JPEGXR_CompressionMode / -JPEG2000_CompressionMode
  • JPEGXR / JPEG2000 Compression Mode
  • 0 = Lossless
  • 1 = Use Quality Settings
-JPEGXR_CompressionQuality / -JPEG2000_CompressionQuality
  • JPEGXR / JPEG2000 Compression Quality
  • 0 to 100
  • 0 = Maximum compression
  • 100 = Best quality
-PGF_CompressionMode
  • PGF Compression Mode
  • 0 = Lossless
  • 1 = Use Quality Settings
-PGF_CompressionQuality
  • PGF Compression Quality
  • 0 to 100
  • 0 = Maximum compression
  • 100 = Best quality
-PNG_Color
  • PNG Color
  • 0 = True color (24/32bits per pixel)
  • 1 = Less colors (256 Colors)
-WEBP_CompressionMode
  • WEBP Compression Mode
  • 0 = Lossless
  • 1 = Use Quality Settings
-WEBP_CompressionQuality
  • WEBP Compression Quality
  • 0 to 100
  • 0 = Maximum compression
  • 100 = Best quality


Examples

Please note examples are written as though the user has navigated to the Pixillion install location in the Command prompt.

Command Line Description
Pixillion.exe -removeall -add C:\MyImage.jpg -outputformat PNG -text "Sample Text" -convertLoads MyImage.jpg, adds watermark text, and saves the result as MyImage.png.
Pixillion.exe -removeall -add C:\MyInputFolder -outputfolder = C:\MyOutputFolder -outputformat JPG -scaling 1 -width 128 -height 128 -convert -exitLoads all images found in MyInputFolder, resizes them all to fit in 128x128 pixels, saves them all as JPEG files in MyOutputFolder, and exits Pixillion.
Pixillion.exe -add "C:\My Other Input Folder\MyImage.png" -outputformat TGA -convert -exitLoads MyImage.png found in 'My Other Input Folder', and saves the result as MyImage.tga, and exits Pixillion.

Using the Pixillion Command-line Tool
Contents | Previous | Next
© NCH Software
NCH Software