summaryrefslogtreecommitdiff
path: root/obsolete/support/png2pdf/DOCU/usage.html
diff options
context:
space:
mode:
Diffstat (limited to 'obsolete/support/png2pdf/DOCU/usage.html')
-rw-r--r--obsolete/support/png2pdf/DOCU/usage.html288
1 files changed, 0 insertions, 288 deletions
diff --git a/obsolete/support/png2pdf/DOCU/usage.html b/obsolete/support/png2pdf/DOCU/usage.html
deleted file mode 100644
index 15bd3916ff..0000000000
--- a/obsolete/support/png2pdf/DOCU/usage.html
+++ /dev/null
@@ -1,288 +0,0 @@
-<html>
-<head>
-<title>png2pdf - Convert PNG images to PDF</title>
-<link rel="stylesheet" type="text/css" href="style.css">
-</head>
-<body>
-<div class="header">
-<p>
-<table width="100%" class="headertable">
-<tr class="headertr">
-<td class="headertdleft" rowspan="2"><img src="./png2pdf-logo.png"></td>
-<td class="headertdleft"><h1>png2pdf</h1></td>
-<td class="headertdright" rowspan="2">
-<a target="_blank" href="http://sourceforge.net/"><img src="sflogo.png" width="210" height="62" border="0" alt="SourceForge.net Logo"/></a>
-</td>
-</tr>
-<td class="headertdleft"><span class="subtitle">Convert <u>PNG</u> images <u>to</u> <u>PDF</u></span></td>
-</tr>
-</table>
-<table width="100%" class="navimenutable">
-<tr class="navimenutr">
-<td class="navimenutd">
-<a class="navimenulink" href="index.html">Overview</a>&nbsp;&nbsp;&nbsp;/&nbsp;&nbsp;&nbsp;<a class="navimenulink" href="install.html">Installation</a>&nbsp;&nbsp;&nbsp;/&nbsp;&nbsp;&nbsp;<span class="navimenucurrent">Usage</span>&nbsp;&nbsp;&nbsp;/&nbsp;&nbsp;&nbsp;<a class="navimenulink" href="ppgui.html">GUI</a>&nbsp;&nbsp;&nbsp;/&nbsp;&nbsp;&nbsp;<a class="navimenulink" href="faq.html">FAQ</a>&nbsp;&nbsp;&nbsp;/&nbsp;&nbsp;&nbsp;<a class="navimenulink" href="changes.html">Change&nbsp;Log</a>&nbsp;&nbsp;&nbsp;/&nbsp;&nbsp;&nbsp;<a class="navimenulink" href="projects.html">Other&nbsp;Projects</a>
-</td>
-</tr>
-</table>
-</p>
-</div>
-<div class="text">
-
-<table width="100%">
-<tr>
-<td class="h2tdleft"><h2>Usage</h2></td>
-<td class="h2tdright"><a class="smallotherlink" href="png2pdf.pdf">PDF manual "png2pdf.pdf" available</a></td>
-</tr>
-</table>
-
-<table width="100%" class="toctable">
-<tr class="tocrow">
-<td width="5%"></td>
-<td class="toctd" colspan="6"><a class="toclink" href="#h301">Overview</a></td>
-</tr>
-<tr class="tocrow">
-<td width="5%"></td>
-<td class="toctd" colspan="6"><a class="toclink" href="#h302">Options</a></td>
-</tr>
-<tr class="tocrow">
-<td width="5%"></td>
-<td class="toctd" colspan="6"><a class="toclink" href="#h303">Example</a></td>
-</tr>
-<tr class="tocrow">
-<td width="5%"></td>
-<td width="5%"></td>
-<td class="toctd" colspan="5"><a class="toclink" href="#h401">Original image and pdfLaTeX source</a></td>
-</tr>
-<tr class="tocrow">
-<td width="5%"></td>
-<td width="5%"></td>
-<td class="toctd" colspan="5"><a class="toclink" href="#h402">PDF image, white background</a></td>
-</tr>
-<tr class="tocrow">
-<td width="5%"></td>
-<td width="5%"></td>
-<td class="toctd" colspan="5"><a class="toclink" href="#h403">Background color</a></td>
-</tr>
-<tr class="tocrow">
-<td width="5%"></td>
-<td width="5%"></td>
-<td class="toctd" colspan="5"><a class="toclink" href="#h404">Background effects</a></td>
-</tr>
-</table>
-
-<a name="h301"><h3>Overview</h3></a>
-<p>
-The program can be invoked by typing
-<pre>
- png2pdf [&lt;options&gt;]
- png2pdf [&lt;options&gt;] &lt;input-file&gt; &lt;output-file&gt;
- png2pdf [&lt;options&gt;] &lt;directory&gt;
-</pre>
-If no file name is specified the program runs on the current directory.
-When running on a directory the program checks the directory for
-PNG file and converts all PNG files to PDF.<br>
-</p>
-<a name="h302"><h3>Options</h3></a>
-<p>
-The following options can be used:
-<ul>
-<li>-p <it>pdf-level</it><br>
---pdf=<it>pdf-level</it><br>
-specifies the PDF level to use (may be "1.2", "1.3" or "1.4"). By default
-PDF&nbsp;1.4 is produced.
-</li>
-<li>-a<br>
--a-<br>
---transparency=<it>boolean</it><br>
-specifies whether or not to transfer an alpha channel from the PNG
-file into the PDF file.
-</li>
-<li>-i<br>
--i-<br>
---image-mask=<it>boolean</it><br>
-specifies whether or not to convert the PNG alpha channel into a
-PDF image mask.<br>Note: alpha channel transfer and image mask creation
-can not be used at same time.
-</li>
-<li>-m <it>RGB-triple</it><br>
---mix-background=<it>RGB-triple</it><br>
-mixes all pixels against the background color specified in the PNG
-file's background chunk. If there is no background chunk the <it>RGB-triple</it>
-is used.<br>Note: Mixing and alpha channel transfer (-a) can not be used
-at same time.
-</li>
-<li>-s<br>
--s-<br>
---mix-specified=<it>boolean</it><br>
-sets priority for -m <it>RGB-triple</it> higher than PNG file background chunk.
-The -m <it>RGB-triple</it> is used always.
-</li>
-<li>-l<br>
--l-<br>
---invert-levels=<it>boolean</it><br>
-inverts the trigger level used for image mask creation. By default only
-opacity=0 pixels are masked, inverting results in masking all pixels except
-those having full opacity.
-</li>
-<li>-t<br>
--t-<br>
---alpha-transparency=<it>boolean</it><br>
-interprets alpha channel data as transparency instead of opacity.
-</li>
-<li>-n<br>
---interpolation<br>
-adds an entry to the image dictionary indicating that viewers should
-attempt an image interpolation on the picture (see
-<a class="linkinternal" href="interpolate.html">example</a>).<br>
-Use with care. Different software may use different algorithms.
-The representation of the image may vary depending on the software
-and output device you use.
-</li>
-<li>-f<br>
--f-<br>
---file-time-check=<it>boolean</it><br>
-enables/disables file time check when running on a directory.
-If file time check is enabled, a conversion is only started for PNGs
-which have have no corresponding PDF file or a PDF file older than
-the PNG file.
-</li>
-<li>-h<br>
---help<br>
-prints a help text.
-</li>
-<li>-v<br>
---version<br>
-prints version information.
-</li>
-<li>-c &lt;options&gt;<br>
---configure &lt;options&gt;<br>
-sets <it>options</it> as permanent options, stored in the preferences system.
-</li>
-<li>-C<br>
---show-configuration<br>
-prints a summary information about permanent options.
-</li>
-<li>-r &lt;options&gt;<br>
---reset &lt;options&gt;<br>
-overrides (ignores) the permanent options for this one program invokation.
-The program starts based on compiled-in defaults and processes options
-given explicitely on the command line. This is intended for program usage
-in scripts where we want to have a well-defined startup.
-</li>
-<li>-u<br>
---unconfigure<br>
-removes all permanent options.
-</li>
-</ul>
-</p>
-<a name="h303"><h3>Examples</h3></a>
-<a name="h401"><h4>Original image and pdfLaTeX source</h4></a>
-<p>
-In the examples the image stefan_255_rgba.png from the PNG web site
-is used.<br>
-<img width="162" height="150" src="stefan_255_rgba.png"/>
-<br>&nbsp;<br>
-If the image is included into a pdfLaTeX source
-<pre>
- \documentclass[12pt,a4paper,titlepage]{article}
- \usepackage{ifpdf} % LaTeX or pdfLaTeX
- \usepackage{color} % we want to use background color
- \usepackage{graphicx}
- \ifpdf
- \usepackage{background} % for the background effects, PPower4 necessary
- \fi
- \definecolor{bgred}{rgb}{1.0,0.501961,0.501961}
- ...
- \begin{document}
- ...
- \begin{figure}
- {\centering
- \includegraphics[width=5cm]{stefan_255_rgba.png}
- \caption{Some caption}
- \label{fig:some-label}
- }
- \end{figure}
- ...
- \end{document}
-</pre>
-the result looks like shown in image 1:<br>&nbsp;<br>
-<img width="489" height="253" src="capa01.png"/>
-<br>&nbsp;<br>
-</p>
-<a name="h402"><h4>PDF image, white background</h4></a>
-<p>
-If we create a PDF file using
-<pre>
- png2pdf -m 255,255,255 -s stefan_255_rgba.png x1.pdf
-</pre>
-and change the pdfLaTeX source to
-<pre>
- ...
- \begin{figure}
- {\centering
- \includegraphics[width=5cm]{x1.pdf}
- \caption{Some caption}
- \label{fig:some-label}
- }
- \end{figure}
- ...
-</pre>
-the result looks like shown in image 2:<br>&nbsp;<br>
-<img width="489" height="253" src="capa02.png"/>
-</p>
-<a name="h403"><h4>Background color</h4></a>
-<p>
-To obtain a colored background we add
-<pre>
- \pagecolor{bgred}
-</pre>
-to the pdfLaTeX source and run the conversion
-<pre>
- png2pdf -m 255,128,128 -s stefan_255_rgba.png x1.pdf
-</pre>
-The result is shown in image 3:<br>&nbsp;<br>
-<img width="489" height="253" src="capa03.png"/>
-</p>
-<a name="h404"><h4>Background effects</h4></a>
-<p>
-Now we use
-<pre>
- \vpagecolor{bgred}
-</pre>
-to produce a background effect. Note: Post-processing using PPower4
-is necessary to make the effect visible.<br>
-Using the existing image x1.pdf produces output as shown in
-figure 4:<br>&nbsp;<br>
-<img width="490" height="253" src="capa04.png"/>
-<br>&nbsp;<br>A red rectangle shows the extents of the image.<br>
-Toe remove the rectange we create an image mask while converting
-the picture using
-<pre>
- png2pdf -m 255,128,128 -s -i stefan_255_rgba.png x1.pdf
-</pre>
-Output is shown in image 5. There is still some kind of border
-around the shadow.<br>&nbsp;<br>
-<img width="489" height="253" src="capa05.png"/>
-<br>&nbsp;<br>So we decide to transfer the alpha channel from
-the PNG file into the PDF file using
-<pre>
- png2pdf -m 255,128,128 -s -a stefan_255_rgba.png x1.pdf
-</pre>
-Output is now as expected (image 6).<br>&nbsp;<br>
-<img width="489" height="253" src="capa06.png"/>
-</p>
-</div>
-<div class="footer">
-<p>
-<table width="100%" class="footertable">
-<tr class="footertr">
-<td class="footertdleft">Dirk Krause</td>
-<td class="footertdcenter">http://png2pdf.sourceforge.net</td>
-<td class="footertdright">2005/02/01</td>
-</tr>
-</table>
-</p>
-</div>
-</body>
-</html>
-