kmaketiles Tool
Version 1.0.8.15
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.
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.
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
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
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 by using 0 as tilesize and set the new size:
kmaketiles input.tif output.tif 0 -resize=500x250
Enable horizontally wrap-around filtering when resizing pano images:
kmaketiles input.tif output.tif 0 -resize=500x250 -hwrap
Use * as placeholder for the size that should be scaled proportionally:
kmaketiles input.tif output.tif 0 -resize=500x*
The image will be resized either to 500x* or *x500 depending on the input size:
kmaketiles input.tif output.tif 0 -resize=500x500 -keepaspect
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*