summaryrefslogtreecommitdiff
path: root/obsolete/support/png2pdf/Java/Png2PdfGUI/src/ppgui.html
blob: d4a25920df86601e637d710815be2c517486ad7c (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
<html>
<head>
<title>Png2PdfGUI - A graphical user interface to png2pdf</title>
</head>
<body>
<h1>Png2PdfGUI - A graphical user interface to png2pdf</h1>
<hr>
<h2>Overview</h2>
<p>
The Java application Png2PdfGUI provides a graphical user
interface to the png2pdf program.
To convert PNG files to PDF you have to perform the following tasks:
<ul>
<li>Choose the directory containing the PNG files.</li>
<li>Set conversion options.</li>
<li>Run png2pdf.</li>
<li>Exit the application.</li>
</ul>
These main tasks can be performed using buttons in the button bar
or using menu entries.
</p>
<hr>
<h2>Requirements</h2>
<p>
To use the Png2PdfGUI you must have the png2pdf program installed.
Normally this conditions is fullfilled because Png2PdfGUI and png2pdf
are in the same package, so they are installed at the same time.
</p>
<p>
A Java run-time environment (Java 5) must be installed. Previous
versions are not sufficient to run Png2PdfGUI.
</p>
<hr>
<h2>Starting the program</h2>
<h3>On Windows systems</h3>
<p>In a prompt box run
<pre>
java.exe -cp c:\programs\krause\lib\png2pdf.jar;c:\programs\krause\lib\dklibsj.jar Png2PdfGUI
</pre>
You possibly need to replace c:\programs\krause by another directory, depending
on your decisions during installation process.
</p>
<p>Once you have verified the program starts correctly you can create
shortcuts either on the desktop or in the start menu. For shortcuts you
should use javaw.exe instead of java.exe.
</p>
<h3>On Unix/Linux systems</h3>
<p>Run
<pre>
java -c /usr/local/lib/png2pdf.jar:/usr/local/lib/dklibsj.jar Png2PdfGUI
</pre>
to start the program.<br>
</p>
<hr>
<h2>Program appearance at start</h2>
<p>
When running the program for the first time the main window looks like
this:<br>&nbsp;<br>
<table width="100%">
<tr><td align="CENTER"><img src="./ppg01.png" width="341" height="171"></td></tr>
</table>
</p>
<hr>
<h2>Choosing a directory</h2>
<p>
Use either the "Choose&nbsp;directory" button or the menu entry
"Png2pdf&nbsp;/&nbsp;Directory" to choose the directory.<br>&nbsp;<br>
<table width="100%">
<tr>
<td align="CENTER"><img src="./ppg02.png" width="341" height="171"></td>
<td align="CENTER"><img src="./ppg03.png" width="341" height="171"></td>
</tr>
</table><br>&nbsp;<br>
The directory chooser dialog appears.
<br>&nbsp;<br>
<table width="100%">
<tr><td align="CENTER"><img src="./ppg04.png" width="817" height="407"></td></tr>
</table>
<br>&nbsp;<br>
Navigate to the directory
containing your PNG files and confirm the selection.<br>
The new working directory is shown in the main window.<br>&nbsp;<br>
<table width="100%">
<tr><td align="CENTER"><img src="./ppg05.png" width="341" height="171"></td></tr>
</table>
</p>
<p>You can also attempt to use drag'n'drop to drag a directory
from Windows explorer or Nautilus into the Png2PdfGUI main window.
For other Unix/Linux desktops it is not known whether drag'n'drop works,
just try it.
</p>
<hr>
<h2>Set png2pdf options</h2>
<p>Use either the "Set&nbsp;options" button in the button bar or the
"Png2pdf&nbsp;/&nbsp;Options" menu entry to set conversion options.
<br>&nbsp;<br>
<table width="100%">
<tr>
<td align="CENTER"><img src="./ppg06.png" width="341" height="171"></td>
<td align="CENTER"><img src="./ppg07.png" width="341" height="171"></td>
</tr>
</table><br>&nbsp;<br>
<table width="100%">
<tr>
<td align="CENTER"><img src="./ppg08.png" width="460" height="543"></td>
</tr>
</table><br>&nbsp;<br>
In the "Png2pdf Options" dialog you have the following choices:
<ul>
<li>PDF format version<br>
You can either produce PDF version 1.2, 1.3 or 1.4. Smaller version
numbers will be compatible to older PDF viewers, larger version
numbers require a recent viewer but provide more PDF features.</li>
<li>Run in make mode<br>
If make mode is enabled the program checks the modification timestamps
of source and destination files. A destination file is up to date
if the file exists and was last modified after the last modification
of the source file. A conversion is only run for those sources for
which there is no up-to-date destination file.
</li>
<li>Show file names while processing<br>
The status message can either simply show "running" while a conversion
is running or show the file name for each file currently processed.
When processing directories containing many files showing each file name
will show you that the program is still alive.<br>
When showing file names a new png2pdf process is started for each
conversion. If you choose to see the simple "running" status message one
process is running on the directory doing all the conversions, this
is faster than starting a new process for each file to convert.
</li>
<li>Image interpolation<br>
This check box sets the image interpolation flag in output files.
Viewer programs are recommended to do image interpolation, this is
usefull if small images are scaled up.
</li>
<li>Alpha channel handling<br>
Here you can decide how to handle alpha channel data if such data
is present in a PNG file.
<ul>
<li>Input alpha channel expresses transparency<br>
Normally you should leave this checkbox turned off because the
alpha channel expresses opacity.</li>
<li>Mix against a background color<br>
You can choose to mix foreground color (the PNG pixel RGB value) against
the background color depending on the opacity/transparency value of the
pixel. The background color is contained in the background chunk in
the PNG file.<br>
Some PNG files containing an alpha channel do not contain a background chunk,
so it is up to the user to choose a background color. The
"Choose&nbsp;background&nbsp;color" entry allows to choose a default
background color to use if no background chunk is available in the PNG file.
Just click on the color-view rectangle to select a color.<br>
If you always want to use the specified background color (you want to
ignore background chunks from the PNG file) enable the checkbox
"Prefer&nbsp;specified&nbsp;default&nbsp;color...".
</li>
<li>Create image mask<br>
In addition to mixing -- or instead of mixing -- you can convert
the alpha channel into an image mask. The normal mask level is
to paint all opacity&gt;0 pixels and to mask out all opacity=0 pixels.<br>
Enable "Use&nbsp;inverted&nbsp;mask&nbsp;levels" to paint
only opacity=full pixels and to mask out all opacity&lt;full pixels.
</li>
<li>Write alpha channel to output<br>
You can also write alpha channel data to PDF output (for PDF version &gt;= 1.4).
</li>
</ul>
Note: Some of these options are not available for all PDF versions.<br>
Some of the options are exclusive, i.e. you can not use mixing and
alpha channel writing together (the opacity factors from the alpha
channel would be applied twice: once in mixing and once by the PDF
viewer when showing the file).
</li>
</ul>
</p>
<hr>
<h2>Running a conversion</h2>
<p>Use the "Run&nbsp;png2pdf" button from the button bar or the
"Png2pdf&nbsp;/&nbsp;Run" menu entry to start a conversion.
<br>&nbsp;<br>
<table width="100%">
<tr>
<td align="CENTER"><img src="./ppg09.png" width="341" height="171"></td>
<td align="CENTER"><img src="./ppg10.png" width="341" height="171"></td>
</tr>
</table><br>&nbsp;<br>
While the conversion is running the status text color changes to red
and the text changes to "Running". If you decided to see file names
the text changes to "Processing&nbsp;...".
<br>&nbsp;<br>
<table width="100%">
<tr>
<td align="CENTER"><img src="./ppg11.png" width="341" height="171"></td>
</tr>
</table><br>&nbsp;<br>
After all conversions are done the color changes back to green and the
text changes back to "Ready".
</p>
<hr>
<h2>Exiting the program</h2>
<p>Use either the "Exit&nbsp;the&nbsp;GUI" button in the button bar or the
"Png2pdf&nbsp;/&nbsp;Exit" menu entry to exit the program.
<br>&nbsp;<br>
<table width="100%">
<tr>
<td align="CENTER"><img src="./ppg12.png" width="341" height="171"></td>
<td align="CENTER"><img src="./ppg13.png" width="341" height="171"></td>
</tr>
</table><br>&nbsp;<br>
</p>
</body>
</html>