"Fossies" - the Fresh Open Source Software Archive  

Source code changes of the file "doc/Making-image-pyramids.md" between
vips-8.10.6.tar.gz and vips-8.11.0.tar.gz

About: VIPS is a free image processing system (see also the GUI nip2).

Making-image-pyramids.md  (vips-8.10.6):Making-image-pyramids.md  (vips-8.11.0)
skipping to change at line 12 skipping to change at line 12
<refentrytitle>Image pyramids</refentrytitle> <refentrytitle>Image pyramids</refentrytitle>
<manvolnum>3</manvolnum> <manvolnum>3</manvolnum>
<refmiscinfo>libvips</refmiscinfo> <refmiscinfo>libvips</refmiscinfo>
</refmeta> </refmeta>
<refnamediv> <refnamediv>
<refname>Pyramids</refname> <refname>Pyramids</refname>
<refpurpose>How to use libvips to make image pyramids</refpurpose> <refpurpose>How to use libvips to make image pyramids</refpurpose>
</refnamediv> </refnamediv>
libvips includes `vips_dzsave()`, an operation that can build image pyramids libvips includes `vips_dzsave()`, an operation
compatible with [DeepZoom](http://en.wikipedia.org/wiki/Deep_Zoom), Zoomify that can build image pyramids compatible with <ulink
and [Google Maps](https://developers.google.com/maps/) image viewers. It's url="http://en.wikipedia.org/wiki/Deep_Zoom">DeepZoom</ulink>, Zoomify
fast and can generate pyramids for large images using only a small amount and <ulink url="https://developers.google.com/maps">Google Maps</ulink>
of memory. image viewers. It's fast and can generate pyramids for large images using
only a small amount of memory.
The TIFF writer, `vips_tiffsave()` can also build tiled pyramidal TIFF images, The TIFF writer, `vips_tiffsave()` can also build tiled pyramidal TIFF images,
but that's very simple to use. This page concentrates on the DeepZoom builder. but that's very simple to use. This page concentrates on the DeepZoom builder.
Run dzsave with no arguments to see a summary: Run dzsave with no arguments to see a summary:
``` ```
$ vips dzsave $ vips dzsave
save image to deepzoom file save image to deepzoom file
usage: usage:
skipping to change at line 69 skipping to change at line 70
min: -1, max: 9 min: -1, max: 9
strip - Strip all metadata from image, input gboolean strip - Strip all metadata from image, input gboolean
default: false default: false
background - Background value, input VipsArrayDouble background - Background value, input VipsArrayDouble
operation flags: sequential nocache operation flags: sequential nocache
``` ```
You can also call `vips_dzsave()` from any language with a libvips binding, or You can also call `vips_dzsave()` from any language with a libvips binding, or
by using `.dz` or `.szi` as an output file suffix. by using `.dz` or `.szi` as an output file suffix.
# Writing [DeepZoom](http://en.wikipedia.org/wiki/Deep_Zoom) pyramids # Writing DeepZoom pyramids
The `--layout` option sets the basic mode of operation. With no The `--layout` option sets the basic mode of operation. With no
`--layout`, dzsave writes DeepZoom pyramids. For example: `--layout`, dzsave writes DeepZoom pyramids. For example:
``` ```
$ vips dzsave huge.tif mydz $ vips dzsave huge.tif mydz
``` ```
This will create a directory called `mydz_files` containing the image This will create a directory called `mydz_files` containing the image
tiles, and write a file called `mydz.dzi` containing the image tiles, and write a file called `mydz.dzi` containing the image
skipping to change at line 107 skipping to change at line 108
``` ```
$ vips dzsave huge.tif myzoom --layout zoomify $ vips dzsave huge.tif myzoom --layout zoomify
``` ```
This will create a directory called `myzoom` containing a file called This will create a directory called `myzoom` containing a file called
`ImageProperties.xml` with the image metadata in, and a series of `ImageProperties.xml` with the image metadata in, and a series of
directories called `TileGroupn`, each containing 256 image tiles. directories called `TileGroupn`, each containing 256 image tiles.
As with DeepZoom, you can use `--suffix` to set jpeg quality. As with DeepZoom, you can use `--suffix` to set jpeg quality.
# Writing [Google Maps](https://developers.google.com/maps/) pyramids # Writing Google Maps pyramids
Use `--layout google` to write Google maps-style pyramids. These are Use `--layout google` to write Google maps-style pyramids. These are
compatible with [leaflet](http://leafletjs.com/). For example: compatible with <ulink url="http://leafletjs.com">Leaflet</ulink>. For
example:
``` ```
$ vips dzsave wtc.tif gmapdir --layout google $ vips dzsave wtc.tif gmapdir --layout google
``` ```
Will create a directory called `gmapdir` containing `blank.png`, the Will create a directory called `gmapdir` containing `blank.png`, the
file to display for blank tiles, and a set of numbered directories, one file to display for blank tiles, and a set of numbered directories, one
for each zoom level. The pyramid can be sparse (blank tiles are not for each zoom level. The pyramid can be sparse (blank tiles are not
written). written).
 End of changes. 4 change blocks. 
8 lines changed or deleted 10 lines changed or added

Home  |  About  |  Features  |  All  |  Newest  |  Dox  |  Diffs  |  RSS Feeds  |  Screenshots  |  Comments  |  Imprint  |  Privacy  |  HTTP(S)