'\" -*- 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_atlas 1 "19 April 2019" "" ""
.SH NAME
osgearth_atlas \- compile an osgEarth resource catalog into a texture atlas
.SH SYNOPSIS
'nh
.fi
.ad l
\fBosgearth_atlas\fR \kx
.if (\nx>(\n(.l/2)) .nr x (\n(.l/5)
'in \n(.iu+\nxu
[\fB--build\fR \fIcatalog.xml\fR | \fB--size\fR \fIx\fR \fIy\fR | \fB--out-image\fR \fIpath\fR | \fB--aux\fR \fIpattern\fR \fIr\fR \fIg\fR \fIb\fR \fIa\fR] [\fB--show\fR \fIcatalog.xml\fR | \fB--layer\fR \fInum\fR | \fB--labels\fR | \fB--aux\fR \fIpattern\fR]
'in \n(.iu-\nxu
.ad b
'hy
.SH DESCRIPTION
\fBosgearth_atlas\fR will compile an osgEarth resource
catalog into a texture atlas.
.SH OPTIONS
.TP 
\*(T<\fB\-\-build\fR\*(T> \fIcatalog.xml\fR
Build an atlas from the catalog
.RS 
.TP 
\*(T<\fB\-\-size\fR\*(T> \fIx\fR \fIy\fR
Maximum size of atlas textures
.TP 
\*(T<\fB\-\-out\-image\fR\*(T> \fIpath\fR
Output path for the atlas image (defaults to an OSGB file in
the working directory).
The paths in the resulting catalog file will point to this
location using a relative path if possible. Output path for
the atlas image (defaults to an OSGB file in the working
directory). The paths in the resulting catalog file will
point to this location using a relative path if possible.
.TP 
\*(T<\fB\-\-aux\fR\*(T> \fIpattern\fR \fIr\fR \fIg\fR \fIb\fR \fIb\fR \fIa\fR
Build an auxiliary atlas for files matching the pattern
"filename_pattern.ext", e.g., "texture.jpg" will match
"texture_NML.jpg" for pattern = "NML". The RGBA are the
default values to use when no match is found.
.RE
.TP 
\*(T<\fB\-\-show\fR\*(T> \fIcatalog.xml\fR
Display an atlas built with this tool
.RS 
.TP 
\*(T<\fB\-\-layer\fR\*(T> \fInum\fR
Show layer \fInum\fR of the atlas (default = 0)
.TP 
\*(T<\fB\-\-labels\fR\*(T>
Label each atlas entry
.TP 
\*(T<\fB\-\-aux\fR\*(T> \fIpattern\fR
Show atlas matching this auxiliary file pattern
.RE