close panorama

Tools / Droplets

kmaketiles Tool Version 1.0.8.15
Select Version:

The kmaketiles tool can be used to tile, re-tile, resize or convert image files. The tool is optimized for low-memory-need, it can process several gigabyte big images just by using a few megabytes of memory.

Usage

The kmaketiles tool need to be called from command line or from batch / script files.

Syntax

kmaketiles inputfile outputfile tilesize [options]

Parameters:
  • inputfile
    • The input image file - either a single image or a tiled image.
    • When using a tiled image as input then a tile template filename and additional options with information about the source image need to used:
      • Tile template filename placeholders:
        • %h = horizontal tile index
        • %v = vertical tile index
        Use optionally one or more '0' characters between the % and the h/v for number padding.
      • Additional options:
        • -insize=#x# ... input image size - [width]x[height]
        • -intilesize=#x# ... input image tilesize - [width] or [width]x[height]
        • -inindexbase=# ... input tile start-index (default=1)
  • outputfile
    • Output image tile template filename (paths will be created automatically).
    • Tile template filename placeholders:
      • %h = horizontal tile index
      • %v = vertical tile index
      Use optionally one or more '0' characters between the % and the h/v for number padding.
  • tilesize
    • The tilesize of the output tiles.
    • Use #x# for non-quad tiles.
    • Use 0 to disable tiling.
    • When the input image can't be divided exactly by the tilesize, then right column and bottom row tiles can be smaller than the tile size.
  • options (optionally)
    • -indexbase=# ... set tile start-index (default=1)
    • -jpegquality=# ... set jpeg quality (0-100, default=85)
    • -jpegsubsamp=# ... set jpeg color subsampling (444,422,420,411, default=444)
    • -jpegprogressive ... use progressive jpeg compression
    • -jpegoptimize ... optimize jpeg compression
    • -tiffcompress=# ... set tiff compression (none,lzw,zip,jpeg, default=lzw)
    • -noalpha ... remove any alpha channel if present
    • -8bit ... convert the output to 8bit (for 16bit inputs)
    • -q / -quiet ... suppress any output messages
    • -resize=#x# ... resize the image to [width]x[height] (* for proportional)
    • -keepaspect ... keep the original image aspect when resizing
    • -hwrap ... wrap around horizontally when filtering (for 360x* panos)
    • -filter=# ... resize filter (default=LANCZOS)
      Available filters: POINT, LINEAR, GAUSS, CUBIC, HAMMING, MITCHELL, LANCZOS
Supported input and output image formats:
  • Tiff (.tif, .tiff)
  • BigTiff (.btf, .tf8, .bigtiff)
  • JPEG (.jpg, .jpeg)
  • Photoshop Document (.psd)
  • Photoshop Big Document (.psb)
  • Kolor RAW (.kro)
  • All formats only in 8 or 16bit RGB or RGBA format.

Examples

Tile an image

To tile a big input image with the size 8192x4092 into smaller tiles with a tilesize of 512x512:
kmaketiles bigimage.jpg tiles_%v_%h.jpg 512

Re-tile an image

Use the tile template name and set the input information about the tiles:
kmaketiles tiles_%v_%h.jpg retiled.tif 0 -insize=8192x4096 -intilesize=512

Convert the image format

Use 0 as tilesize to disable the tiling and just set the input and output names:
kmaketiles input.kro output.psb 0

Resize an image

Resize an image by using 0 as tilesize and set the new size:
kmaketiles input.tif output.tif 0 -resize=500x250

Resize an 360 degree pano

Enable horizontally wrap-around filtering when resizing pano images:
kmaketiles input.tif output.tif 0 -resize=500x250 -hwrap

Resize an image proportionally

Use * as placeholder for the size that should be scaled proportionally:
kmaketiles input.tif output.tif 0 -resize=500x*

Resize an image proportionally while keeping the size within limits

The image will be resized either to 500x* or *x500 depending on the input size:
kmaketiles input.tif output.tif 0 -resize=500x500 -keepaspect

Batch process several files at once (Windows)

Resize all tif images in the folder to small jpeg thumbnail images:
for %d in (*.tif) do kmaketiles %d thumbs/%~nd.jpg 0 -resize=200x*