HomeNewsExamplesDocumentationToolsPluginsMoreDownloadBuyForumContact
close panorama

kmakepreview


syntax:
kmakepreview 1.1 (krpano.com - krpanotools 1.0.6)

    - makes a smooth panorama preview image

syntax: kmakepreview inputfiles [outputfile] [options]

 inputfiles ... jpeg or tiff input images 
                (only 8bit RGB or RGBA supported)
                spherical or cubical images, 
                cubical images should have a suffix like 
                _l,_r,left,front,... in their filename to 
                allow detection of the cubeside, otherwise 
                every image must be specified separately with 
                -l=.. -f=.. -r=.. -b=.. -u=.. -d=..

options:
-o=#            ... name of output image 
                    (jpeg or tiff, default=*preview.jpg)
-cs             ... save as cubestrip image 
                    (better quality)
-size=#x#       ... size of preview image 
                    (default=1024x512, 256x256 on -cs)
-smooth=#       ... preview smoothness 
                    (1-100; default=77)
-jpegquality=#  ... set jpeg quality 
                    (0-100; default=85)
-jpegsubsamp=#  ... set jpeg color subsampling 
                    (444,422,420,411; default=422)
-tiffcompress=# ... set tiff compression 
                    (none,lzw,zip,jpeg; default=lzw)
-q / -quiet     ... suppress output messages


This tool makes a smooth preview image. Smoothing with a normal "Image Editor" would not result the same. The problem of normal smoothing is that the zenit and nadir of the panorama are not smoothed correctly, and the left and right border won't be blended together.


click on the image below to view the differences between:
  • standard gaussian blur smoothing
  • a kmakepreview - spherical preview image
  • a kmakepreview - cubestrip preview image

interactive - click on the hotspots to change the preview image


XML code of this example

Tutorials


1. Make a preview image from a spherical panorama image

kmakepreview inputimage.tif

this command makes the preview image "inputimagepreview.jpg"
click here for a example - spherical preview image



2. Make a cubestrip preview image from a spherical panorama image

kmakepreview -cs inputimage.tif

this command makes the cubestrip preview image "inputimagepreview.jpg"
click here for a example - cubestrip preview image



3. Make a preview image from cubical panorama images (cubeside autodetection)

kmakepreview cube_l.tif cube_f.tif cube_r.tif cube_b.tif cube_u.tif cube_d.tif

this command makes the preview image "cubepreview.jpg"
this is only possible in this way - because each filename has a suffix to identfiy the cube side.



4. Make a preview image from cubical panorama images (manual cubesides)

kmakepreview -l=0.tif -f=1.tif -r=2.tif -b=3.tif -u=4.tif -d=5.tif

this command makes the preview image "preview.jpg"
each cube side is set separately!



5. Make only a little smooth cubestrip preview image

kmakepreview -cs -smooth=10 sphericalimage.jpg

this command makes the preview image "sphericalimagepreview.jpg"



6. Set output image name

kmakepreview -o=mypreview.jpg sphericalimage.jpg

this command makes the preview image "mypreview.jpg"