Solve reverse coloration and sizing issues for PDF images (INT-1612)

For reasons unknown, most PNG files were showing up in the PDF output
with reverse coloration (or at least significantly shifted. Saving
these files as JPEGs provided a cheap workaround.

Also a number of images were either (a) exceeding the boundaries of the
PDF viewport or (b) scaling down to thumbnail size.

Now using width/contentwidth/scaling attributes in <mediaobject>
elements, as described at http://www.sagehill.net/docbookxsl/ImageSizing.html
to ensure that all images show up correctly scaled in both HTML and PDF
outputs.

docs/src/reference/docbook/overview.xml

@@ -106,11 +106,10 @@
         store any arbitrary key-value pairs in the headers.
         <mediaobject>
           <imageobject role="fo">
-              <imagedata fileref="images/message.png"
-                format="PNG" align="center"/>
+              <imagedata fileref="images/message.jpg" format="JPG" align="center"/>
           </imageobject>
           <imageobject role="html">
-              <imagedata fileref="images/message.png" format="PNG" align="center"/>
+              <imagedata fileref="images/message.jpg" format="JPG" align="center"/>
           </imageobject>
         </mediaobject>
       </para>
@@ -124,11 +123,10 @@
         messaging components, and also provides a convenient point for interception and monitoring of Messages.
         <mediaobject>
           <imageobject role="fo">
-              <imagedata fileref="images/channel.png"
-                format="PNG" align="center"/>
+              <imagedata fileref="images/channel.jpg" format="JPG" align="center" scalefit="1" width="100%" contentdepth="100%" />
           </imageobject>
           <imageobject role="html">
-              <imagedata fileref="images/channel.png" format="PNG" align="center"/>
+              <imagedata fileref="images/channel.jpg" format="JPG" align="center"/>
           </imageobject>
         </mediaobject>
         A Message Channel may follow either Point-to-Point or Publish/Subscribe semantics. With a Point-to-Point
@@ -225,11 +223,10 @@
         proactive alternative to the reactive Message Filters used by multiple subscribers as described above.
         <mediaobject>
           <imageobject role="fo">
-              <imagedata fileref="images/router.png"
-                format="PNG" align="center"/>
+              <imagedata fileref="images/router.jpg" format="JPG" align="center"/>
           </imageobject>
           <imageobject role="html">
-              <imagedata fileref="images/router.png" format="PNG" align="center"/>
+              <imagedata fileref="images/router.jpg" format="JPG" align="center"/>
           </imageobject>
         </mediaobject>
       </para>
@@ -277,11 +274,10 @@
         Message's "return address" if available.
         <mediaobject>
           <imageobject role="fo">
-              <imagedata fileref="images/handler-endpoint.png"
-                format="PNG" align="center"/>
+              <imagedata fileref="images/handler-endpoint.jpg" format="JPG" align="center" scalefit="1" width="100%"/>
           </imageobject>
           <imageobject role="html">
-              <imagedata fileref="images/handler-endpoint.png" format="PNG" align="center"/>
+              <imagedata fileref="images/handler-endpoint.jpg" format="JPG" align="center"/>
           </imageobject>
           <caption>
             A request-reply "Service Activator" endpoint connects a target object's method to input and output
@@ -302,21 +298,19 @@
         chapters.
         <mediaobject>
           <imageobject role="fo">
-              <imagedata fileref="images/source-endpoint.png"
-                format="PNG" align="center"/>
+              <imagedata fileref="images/source-endpoint.jpg" format="JPG" align="center" scalefit="1" width="100%"/>
           </imageobject>
           <imageobject role="html">
-              <imagedata fileref="images/source-endpoint.png" format="PNG" align="center"/>
+              <imagedata fileref="images/source-endpoint.jpg" format="JPG" align="center"/>
           </imageobject>
           <caption>An inbound "Channel Adapter" endpoint connects a source system to a MessageChannel.</caption>
         </mediaobject>
         <mediaobject>
           <imageobject role="fo">
-              <imagedata fileref="images/target-endpoint.png"
-                format="PNG" align="center"/>
+              <imagedata fileref="images/target-endpoint.jpg" format="JPG" align="center" scalefit="1" width="100%"/>
           </imageobject>
           <imageobject role="html">
-              <imagedata fileref="images/target-endpoint.png" format="PNG" align="center"/>
+              <imagedata fileref="images/target-endpoint.jpg" format="JPG" align="center"/>
           </imageobject>
           <caption>An outbound "Channel Adapter" endpoint connects a MessageChannel to a target system.</caption>
         </mediaobject>

docs/src/reference/docbook/samples.xml

@@ -156,8 +156,7 @@ That includes Samples, so if you can't find what you are looking for let us know
         <para>
         <mediaobject>
           <imageobject role="fo">
-              <imagedata fileref="images/loan-broker-eip.png"
-                format="PNG" align="center"/>
+              <imagedata fileref="images/loan-broker-eip.png" format="PNG" align="center" scalefit="1" width="100%" contentdepth="100%" />
           </imageobject>
           <imageobject role="html">
               <imagedata fileref="images/loan-broker-eip.png" format="PNG" align="center"/>
@@ -235,11 +234,10 @@ That includes Samples, so if you can't find what you are looking for let us know
       <para><emphasis>Messaging Gateway</emphasis>
       <mediaobject>
           <imageobject role="fo">
-              <imagedata fileref="images/gateway.png"
-                format="PNG" align="center"/>
+              <imagedata fileref="images/gateway.jpg" format="JPG" align="center"/>
           </imageobject>
           <imageobject role="html">
-              <imagedata fileref="images/gateway.png" format="PNG" align="center"/>
+              <imagedata fileref="images/gateway.jpg" format="JPG" align="center"/>
           </imageobject>
         </mediaobject>
       </para>
@@ -285,8 +283,7 @@ That includes Samples, so if you can't find what you are looking for let us know
       <emphasis>&lt;chain&gt;</emphasis> element.
       <mediaobject>
           <imageobject role="fo">
-              <imagedata fileref="images/chain.png"
-                format="PNG" align="center"/>
+              <imagedata fileref="images/chain.png" format="PNG" align="center"/>
           </imageobject>
           <imageobject role="html">
               <imagedata fileref="images/chain.png" format="PNG" align="center"/>
@@ -301,11 +298,10 @@ That includes Samples, so if you can't find what you are looking for let us know
       <para><emphasis>Message Router</emphasis>
       <mediaobject>
           <imageobject role="fo">
-              <imagedata fileref="images/bank-router.png"
-                format="PNG" align="center"/>
+              <imagedata fileref="images/bank-router.jpg" format="JPG" align="center"/>
           </imageobject>
           <imageobject role="html">
-              <imagedata fileref="images/bank-router.png" format="PNG" align="center"/>
+              <imagedata fileref="images/bank-router.jpg" format="JPG" align="center"/>
           </imageobject>
         </mediaobject>
       </para>
@@ -324,11 +320,10 @@ That includes Samples, so if you can't find what you are looking for let us know
       <para><emphasis>Message Aggregator</emphasis>
       <mediaobject>
           <imageobject role="fo">
-              <imagedata fileref="images/quotes-aggregator.png"
-                format="PNG" align="center"/>
+              <imagedata fileref="images/quotes-aggregator.jpg" format="JPG" align="center"/>
           </imageobject>
           <imageobject role="html">
-              <imagedata fileref="images/quotes-aggregator.png" format="PNG" align="center"/>
+              <imagedata fileref="images/quotes-aggregator.jpg" format="JPG" align="center"/>
           </imageobject>
         </mediaobject>
       </para>
@@ -396,8 +391,7 @@ That includes Samples, so if you can't find what you are looking for let us know
       <para>
         <mediaobject>
           <imageobject role="fo">
-              <imagedata fileref="images/cafe-eip.png"
-                format="PNG" align="center"/>
+              <imagedata fileref="images/cafe-eip.png" format="PNG" align="center" scalefit="1" width="100%" contentdepth="100%" />
           </imageobject>
           <imageobject role="html">
               <imagedata fileref="images/cafe-eip.png" format="PNG" align="center"/>