'\" -*- coding: us-ascii -*-
.if \n(.g .ds T< \\FC
.if \n(.g .ds T> \\F[\n[.fam]]
.de URL
\\$2 \(la\\$1\(ra\\$3
..
.if \n(.g .mso www.tmac
.TH osgearth_cache 1 "19 April 2019" "" ""
.SH NAME
osgearth_cache \- manage osgEarth's cache
.SH SYNOPSIS
'nh
.fi
.ad l
\fBosgearth_cache\fR \kx
.if (\nx>(\n(.l/2)) .nr x (\n(.l/5)
'in \n(.iu+\nxu
[\fB--list\fR | \fB--seed\fR | \fB--estimate\fR | \fB--threads\fR | \fB--min-level\fR \fIlevel\fR | \fB--max-level\fR \fIlevel\fR | \fB--bounds\fR \fIxmin\fR \fIymin\fR \fIxmax\fR \fIymax\fR | \fB--index\fR \fIshapefile\fR | \fB--cache-path\fR \fIpath\fR | \fB--cache-type\fR \fItype\fR | \fB--purge\fR] \fIfile.earth\fR 
'in \n(.iu-\nxu
.ad b
'hy
.SH DESCRIPTION
\fBosgearth_cache\fR can be used to manage osgEarth's cache.
The most common usage of \fBosgearth_cache\fR is to populate
a cache in a non-interactive manner using the \*(T<\fB\-\-seed\fR\*(T>
argument. See
.URL http://docs.osgearth.org/en/latest/user/caching.html Caching
for more information on caching.
.SH OPTIONS
.TP 
\*(T<\fB\-\-list\fR\*(T>
Lists info about the cache in a .earth file
.TP 
\*(T<\fB\-\-seed\fR\*(T>
Seeds the cache in a .earth file
.TP 
\*(T<\fB\-\-estimate\fR\*(T>
Print out an estimation of the number of tiles, disk space and time it will take to perform this seed operation
.TP 
\*(T<\fB\-\-threads\fR\*(T>
The number of threads to use for the seed operation (default=1)
.TP 
\*(T<\fB\-\-min\-level\fR\*(T> \fIlevel\fR
Lowest LOD level to seed (default=0)
.TP 
\*(T<\fB\-\-max\-level\fR\*(T> \fIlevel\fR
Highest LOD level to seed (default=highest available)
.TP 
\*(T<\fB\-\-bounds\fR\*(T> \fIxmin\fR \fIymin\fR \fIxmax\fR \fIymax\fR
Geospatial bounding box to seed (in map coordinates; default=entire map)
.TP 
\*(T<\fB\-\-index\fR\*(T> \fIshapefile\fR
Loads a shapefile (.shp) and uses the feature extents to set the
cache seeding bounding box(es). For each feature in the shapefile,
adds a bounding box (similar to \*(T<\fB\-\-bounds\fR\*(T>) to
constrain the region you wish to cache.
.TP 
\*(T<\fB\-\-cache\-path\fR\*(T> \fIpath\fR
Overrides the cache path in the .earth file
.TP 
\*(T<\fB\-\-cache\-type\fR\*(T> \fItype\fR
Overrides the cache type in the .earth file
.TP 
\*(T<\fB\-\-purge\fR\*(T>
Purges a layer cache in a .earth file
.TP 
\fIfile.earth\fR
Path to the earth file