[SCM] osgearth branch, master, updated. debian/1.4.1-1-71-gecb0256

[Bas Couwenberg]

The following commit has been merged in the master branch:
commit 5a6b0bc0c22fcea39a43cfeb36e7ab957bcab227
Author: Bas Couwenberg <sebastic at xs4all.nl>
Date:   Mon Sep 16 03:02:16 2013 +0200

    Add man page for: osgearth_backfill.

diff --git a/debian/changelog b/debian/changelog
index d34f5ef..e2d2c65 100644
--- a/debian/changelog
+++ b/debian/changelog
@@ -27,6 +27,7 @@ osgearth (2.4.0+dfsg-4) UNRELEASED; urgency=low
     - osgearth_cache
     - osgearth_package
     - osgearth_tfs
+    - osgearth_backfill
 
  -- Bas Couwenberg <sebastic at xs4all.nl>  Fri, 13 Sep 2013 15:14:27 +0200
 
diff --git a/debian/man/osgearth_backfill.1.xml b/debian/man/osgearth_backfill.1.xml
new file mode 100644
index 0000000..35e3564
--- /dev/null
+++ b/debian/man/osgearth_backfill.1.xml
@@ -0,0 +1,99 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
+<refentry id='osgearth_backfill'>
+
+  <refmeta>
+    <refentrytitle>osgearth_backfill</refentrytitle>
+    <manvolnum>1</manvolnum>
+  </refmeta>
+
+  <refnamediv>
+    <refname>osgearth_backfill</refname>
+    <refpurpose>specialty tool for post-processing TMS datasets</refpurpose>
+  </refnamediv>
+
+  <refsynopsisdiv id='synopsis'>
+    <cmdsynopsis>
+      <command>osgearth_backfill</command>
+      <arg choice='plain'><replaceable>tms.xml</replaceable></arg>
+      <group>
+        <arg choice='opt'><option>--bounds</option> <replaceable>xmin</replaceable> <replaceable>ymin</replaceable> <replaceable>xmax</replaceable> <replaceable>ymax</replaceable></arg>
+        <arg choice='opt'><option>--min-level</option> <replaceable>level</replaceable></arg>
+        <arg choice='opt'><option>--max-level</option> <replaceable>level</replaceable></arg>
+        <arg choice='opt'><option>--db-options</option> <replaceable>options</replaceable></arg>
+      </group>
+    </cmdsynopsis>
+  </refsynopsisdiv>
+
+  <refsect1 id='description'>
+    <title>DESCRIPTION</title>
+    <para>
+      <command>osgearth_backfill</command> is a specialty tool that is used to
+      post-process TMS datasets. Some web mapping services use completely
+      different datasets at different zoom levels. For example, they may use
+      NASA BlueMarble imagery until they reach level 4, then abruptly switch
+      to LANDSAT data. This is fine for 2D slippy map visualization but can be
+      visually distracting when viewed in 3D because neighboring tiles at
+      different LODs look completely different.
+    </para>
+    <para>
+      <command>osgearth_backfill</command> lets you generate a TMS dataset like
+      you normally would (using
+      <citerefentry>
+        <refentrytitle>osgearth_package</refentrytitle>
+        <manvolnum>1</manvolnum>
+      </citerefentry>,
+      or another tool) and then "backfill" lower levels of detail from a
+      specified higher level of detail. For example, you can specify a max
+      level of 10 and LODs 0-9 will be regenerated based on the data found
+      in level 10.
+    </para>
+  </refsect1>
+
+  <refsect1 id='options'>
+    <title>OPTIONS</title>
+    <variablelist>
+
+      <varlistentry>
+        <term><replaceable>tms.xml</replaceable></term>
+        <listitem>
+          <para>Path to the tms.xml file</para>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry>
+        <term><option>--bounds</option> <replaceable>xmin</replaceable> <replaceable>ymin</replaceable> <replaceable>xmax</replaceable> <replaceable>ymax</replaceable></term>
+        <listitem>
+          <para>bounds to backfill (in map coordinates; default=entire map)</para>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry>
+        <term><option>--min-level</option> <replaceable>level</replaceable></term>
+        <listitem>
+          <para>The minimum level to stop backfilling to. (default=0)</para>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry>
+        <term><option>--max-level</option> <replaceable>level</replaceable></term>
+        <listitem>
+          <para>The level to start backfilling from. (default=inf)</para>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry>
+        <term><option>--db-options</option> <replaceable>options</replaceable></term>
+        <listitem>
+          <para>
+            db options string to pass to the image writer in quotes
+            (e.g., "JPEG_QUALITY 60")
+          </para>
+        </listitem>
+      </varlistentry>
+
+    </variablelist>
+
+  </refsect1>
+
+</refentry>
diff --git a/debian/osgearth.manpages b/debian/osgearth.manpages
index 2ae5338..69ec038 100644
--- a/debian/osgearth.manpages
+++ b/debian/osgearth.manpages
@@ -3,3 +3,4 @@ debian/man/osgearth_version.1
 debian/man/osgearth_cache.1
 debian/man/osgearth_package.1
 debian/man/osgearth_tfs.1
+debian/man/osgearth_backfill.1

-- 
osgEarth terrain rendering toolkit