[osgearth] 14/19: Add manpage for osgearth_sharedlayer.

[Bas Couwenberg]

This is an automated email from the git hooks/post-receive script.

sebastic-guest pushed a commit to branch master
in repository osgearth.

commit bb1a8521e0fd84fe517f2e56a76551a4b4e61ce6
Author: Bas Couwenberg <sebastic at xs4all.nl>
Date:   Sun Jan 26 00:38:18 2014 +0100

    Add manpage for osgearth_sharedlayer.
---
 debian/changelog                      |  3 +-
 debian/man/osgearth_sharedlayer.1.xml | 55 +++++++++++++++++++++++++++++++++++
 debian/osgearth.manpages              |  1 +
 3 files changed, 58 insertions(+), 1 deletion(-)

diff --git a/debian/changelog b/debian/changelog
index bb21c79..c231999 100644
--- a/debian/changelog
+++ b/debian/changelog
@@ -9,7 +9,8 @@ osgearth (2.5.0+dfsg-1) UNRELEASED; urgency=medium
   * Drop MPGeometry-OpenSceneGraph-3.1.8.patch, included in upstream.
   * Drop becuase-typo.patch, applied upstream.
   * Refresh cmake-FindMiniZip.patch.
-  * Add manpage for osgearth_tileindex & osgearth_terraineffects.
+  * Add manpage for osgearth_tileindex, osgearth_terraineffects &
+    osgearth_sharedlayer.
 
  -- Bas Couwenberg <sebastic at xs4all.nl>  Thu, 16 Jan 2014 22:35:07 +0100
 
diff --git a/debian/man/osgearth_sharedlayer.1.xml b/debian/man/osgearth_sharedlayer.1.xml
new file mode 100644
index 0000000..d05fc4b
--- /dev/null
+++ b/debian/man/osgearth_sharedlayer.1.xml
@@ -0,0 +1,55 @@
+<?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_sharedlayer'>
+
+  <refmeta>
+    <refentrytitle>osgearth_sharedlayer</refentrytitle>
+    <manvolnum>1</manvolnum>
+  </refmeta>
+
+  <refnamediv>
+    <refname>osgearth_sharedlayer</refname>
+    <refpurpose>demonstration of shared layers</refpurpose>
+  </refnamediv>
+
+  <refsynopsisdiv id='synopsis'>
+    <cmdsynopsis>
+      <command>osgearth_sharedlayer</command>
+      <arg choice='plain'><option>--shapefile</option> <replaceable>file.shp</replaceable></arg>
+    </cmdsynopsis>
+  </refsynopsisdiv>
+
+  <refsect1 id='description'>
+    <title>DESCRIPTION</title>
+    <para>
+      <command>osgearth_sharedlayer</command> is a sample program which
+      demonstrates the use of shared layers.
+      A shared image layer is one that becomes available to other image layers
+      during the rendering phase.
+      Thus if you share a layer, you can access it in a customer shader
+      and use it to modulate another layer.
+    </para>
+    <para>
+      In this example, we render a masking layer from a shapefile using the
+      rasterization (agglite) driver.
+      We don't draw this layer directly;
+      instead we use it as a mask and use that mask to modulate the imagery
+      layer from a custom shader, drawing random colors where the mask exists.
+    </para>
+  </refsect1>
+
+  <refsect1 id='options'>
+    <title>OPTIONS</title>
+    <variablelist>
+
+      <varlistentry>
+        <term><option>--shapefile</option> <replaceable>file.shp</replaceable></term>
+        <listitem>
+          <para>Path to the shapefile</para>
+        </listitem>
+      </varlistentry>
+
+    </variablelist>
+  </refsect1>
+
+</refentry>
diff --git a/debian/osgearth.manpages b/debian/osgearth.manpages
index 28116c5..3046a92 100644
--- a/debian/osgearth.manpages
+++ b/debian/osgearth.manpages
@@ -8,3 +8,4 @@ debian/man/osgearth_boundarygen.1
 debian/man/osgearth_overlayviewer.1
 debian/man/osgearth_tileindex.1
 debian/man/osgearth_terraineffects.1
+debian/man/osgearth_sharedlayer.1

-- 
Alioth's /usr/local/bin/git-commit-notice on /srv/git.debian.org/git/pkg-grass/osgearth.git