File: dbp.html

package info (click to toggle)
gimp-plugin-registry 9.20200927
  • links: PTS, VCS
  • area: main
  • in suites: bullseye
  • size: 67,064 kB
  • sloc: ansic: 27,119; lisp: 20,560; python: 14,721; cpp: 2,528; sh: 2,220; makefile: 635; xml: 21
file content (270 lines) | stat: -rw-r--r-- 15,472 bytes parent folder | download | duplicates (7)
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
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
<html>
<head>
<title>DBP - David's Batch Processor</title>
</head>
<body>
<h1>What is it?</h1>
<p><b>DBP</b> <i>(David's Batch Processor)</i> is a simple batch processing
plugin for the Gimp - it allows the user to automatically perform operations (such
as resize) on a collection of image files. Its main advantage is that the user
does not have to learn a scripting language. Like the Gimp itself, DBP
relies on a graphical interface. 
The user creates a list of images, and sets up the processing required for
each image. The results of the current settings can be displayed. Once the
required sequence of operations has been set up,
DBP performs the same processing on each image in turn.
The images can be colour corrected, resized, cropped, and sharpened, then
renamed and saved to a different file in a specified image format. All
the steps (except loading and saving the image!) are optional; so the simplest
use of DBP is just to convert a number of image files from one format
to another.</p>
<p>Note that DBP is intended for RGB, not indexed images. Trying to process
an indexed image will probably just cause an error, and DBP will halt.
Also, DBP will <b>not</b> overwrite
the original image (in fact, it should not overwrite any file) - images must at least
be either renamed (possibly by changing the image format) or moved to a different
directory.</p>
<h1>Where do I get it?</h1>
<p>
DBP is licensed under the GPL.
The latest version is 1.1.9. It has been updated
to work with recent Gimp 2.6 versions, but will probably work with earlier
versions. The source is available at:
<br/><a href="http://www.ozemail.com.au/~hodsond/dbpSrc-1-1-9.tgz"
>http://www.ozemail.com.au/~hodsond/dbpSrc-1-1-9.tgz</a>.
<br/>If you have problems with this version, earlier versions are still
around at:
<br/><a href="http://www.ozemail.com.au/~hodsond/dbpSrc-1-1-8.tgz"
>http://www.ozemail.com.au/~hodsond/dbpSrc-1-1-8.tgz</a>
and:
<br/><a href="http://www.ozemail.com.au/~hodsond/dbpSrc-1-1-5.tgz"
>http://www.ozemail.com.au/~hodsond/dbpSrc-1-1-5.tgz</a>.
<br/>There is no configure file, use <b>make install</b> to build and install
in your local gimp plugins directory. You will need g++ and the gimp development
packages for the appropriate Gimp version - if you can compile C++ and
can build any other Gimp plugin, you should have no problems.
The Makefiles are very primitive and can be edited directly if needed.
<h2>Windows Users</h2>
<p>I don't have the facilities to create Windows versions myself, but other
people have done so and sent them to me. Rodrigo Flores kindly provided me
with a Windows binary version of 1.1.8 which is available at:
<br/><a href="http://www.ozemail.com.au/~hodsond/dbp-1.1.8.zip"
>http://members.ozemail.com.au/~hodsond/dbp-1.1.8.zip</a>,
<br/>and 
Michael Schumacher provided me with an earlier version:
<br/><a href="http://www.ozemail.com.au/~hodsond/dbp-1.1.3.zip"
>http://www.ozemail.com.au/~hodsond/dbp-1.1.3.zip</a>
Just download and unzip the file, and copy dbp.exe into your plugins folder -
check Edit/Preferences/Folders/Plug-ins to find out where it should go.
</p>
<h1>How does it work?</h1>
<img src="dbp-main.png" alt="Main window"/>
<p>From the <i>Filters</i> menu in the main Gimp window (or <i>Xtns</i> in earlier versions),
select <b>Batch Process...</b>
to bring up the DBP window. The top section lets you set up the processing
steps; the bottom section starts and stops the processing, and shows
its progress. Note that some of the controls are inactive; DBP disables controls
which currently have no effect.</p>
<p>The processing steps
are laid out on a series of pages, one for each step.
<br/><i>Hint:</i> start at the <b>Input</b> page and set up each one in order.
<br/><i>Hint:</i> use the <b>Test</b> button to see the effect of the
processing.
<br/><i>ToDo:</i> need to see which steps are enabled without having to
go to their page.
<br/><i>ToDo:</i> save and load processing settings.</p>
<h2>Input</h2>
<p>DBP starts with the <b>Input</b> page open.
The <b>Input</b> page is used to specify the images to process. The
<b>Add Files</b> button raises a standard GTK+-2 file selector. Note that
you can select multiple files, using shift-click to select a range of files,
and control-click to select and deselect individual files. Note also that
the input files can be in different image formats. (However, they should
all have different names when the file extension is removed.)
<br/><img src="dbp-fileSelector.png">
<br/>The <b>Open</b> button adds the selected files to the input list
and closes the file selector.
The <b>Add</b> button adds the
selected files to the list and clears the selection, but does not close
the dialog, so that you can add files from other directories. <b>Close</b>
simply closes the file selector without adding any more files.
Once the
file selector is closed, the file list can be edited by selecting
one or more entries and using the <b>Remove Files</b> button to
remove them, by using <b>Clear List</b> to clear the list completely.
You can add more files by pressing <b>Add Files</b> to reopen the
file selector.
<br/><i>Note:</i> the file selector is modal, so you must close it before
you can adjust any controls in the main window.
<br/><i>ToDo:</i> save and load input lists.</p>
<h2>Processing</h2>
<p>The next pages control the processing. Each page starts with an
<b>Enable</b> toggle, which turns on the image operation for that
page and lets you set the controls. To see the effect of all the
active operations (on the first image in the file list) at any
time, press the <b>Test</b> button. The operations are applied to
the images in the order shown on the pages.
<h3>Turn</h3>
<p>If enabled, rotates the image through 90, 180, or 270 degrees.
<h3>Blur</h3>
<p>If enabled, blurs the image.
<br/><i>Hint:</i> uses <b>Gauss IIR</b>.</p>
<h3>Colour</h3>
<p>If enabled, adjusts brightness and contrast of the image, either
through the Gimp Auto Levels function, or by the control settings. The
image saturation can be adjusted, and the image can be converted to black
and white (although the image Mode will still be RGB, not Grayscale).
<br/><i>Note:</i> converting to black and white does not give the same
result as reducing the saturation to zero.
<br/><i>ToDo:</i> add gamma control.</p>
<h3>Resize</h3>
<p>If enabled, resizes the image. Resizing can be either relative to the
input image size, or to an absolute target size. Fixing the aspect ratio
of a relative resize locks the x and y sliders to the same value. There are
four options for an absolute resize. <b>Exact</b> will change the aspect
ratio of the image, if necessary, to fit the target size. <b>Pad</b> fits
the resized image inside the target size, then pads it to fit. <b>Inside</b>
creates the largest image which fits inside the target size, <b>Outside</b>
the smallest which fits outside.
<br/><i>Hint:</i> padding uses the Gimp's current background colour.
<br/><i>Hint:</i> resize uses the Gimp's <b>Interpolation Type</b> settings.
<h3>Crop</h3>
<p>If enabled, crops a region from the image.
<br/><i>Warning:</i> The region must be contained within the image area.</p>
<h3>Sharpen</h3>
<p>If enabled, sharpens the image.
<br/><i>Hint:</i> uses <b>Unsharp Mask</b>.</p>
<h2>Rename</h2>
<p>Sets the directory and file name to use when saving the processed image.
<b>Source Dir</b> refers
to the directory containing the original image. If another directory is
chosen, the image will be saved there instead. The original file name
can have a prefix or postfix added; its extension will be replaced by
the appropriate extension for the image format chosen on the next page.
An example of the renaming is shown (using an imaginary extension).
<br/><i>Hint:</i> DBP will <b>not</b> overwrite an existing file. The output
file must be renamed, have its extension changed, or be put into a different
directory.
<br/><i>ToDo:</i> add relative directory path.</p>
<p>Also includes a toggle to flatten the image before saving, which will
mostly just remove the alpha channel. This doesn't really belong here, but
I needed this for a job and didn't want to add a new control page.</p>
<h2>Output</h2>
<p>Selects the image format for the processed file (and therefore its
extension). Appropriate extra controls will appear for different formats.
<br/><i>Warning:</i> The format selection may include output formats that
are not installed on your system.
<br/><i>ToDo:</i> fix that.</p>
<h2>Common Controls</h2>
<p>The <b>Test</b> button processes and displays, but does not save, the
first image in the file list. Use this to adjust the settings.
Once all the controls have been set as desired, click the <b>Start</b> button.
DBP will process each file in the file list. If <b>Show Images</b> is pressed,
then the images will be displayed as they are being processed.
<br/><i>Hint:</i> if any process fails, the entire sequence will finish.
<br/><i>Hint:</i> the <b>Cancel</b> button will not respond until the current
processing step finishes.
<br/><i>Hint:</i> cancelling any of the processing steps (from the Gimp's popup
window for that step) will cancel processing.
<br/><i>Hint:</i> DBP <b>will not</b> overwrite existing images. If you cancel
(or decide to repeat) a sequence you will need to delete any output images
before starting again.
<br/><i>Hint:</i> the image displays are managed by DBP. Do not draw on, close,
or save from them.
<br/><i>Hint:</i> untoggling the <b>Show Images</b> button, or quitting DBP,
will remove a leftover display.
<br/><i>ToDo:</i> use separate thread for processing (don't lock up user interface).
<br/><i>ToDo:</i> improve processing feedback.
<br/><i>ToDo:</i> improve error reporting (what error reporting?)</p>
<h2>History</h2>
<p>
<ul>
<li>0.1
  <br/>original Dec 2001</li>
<li>0.2
  <br/>removed some C++(C99?)-isms, to compile under gcc 2.95 (I hope)</li>
<li>0.3
  <br/>fixed crash on OK, close after processing
  <br/>rearranged processing controls
  <br/>many minor tidyups
  <br/>(unreleased)</li>
<li>0.4
  <br/>converted to C++, I'm sick of working in C</li>
<li>0.5
  <br/>added test mode, seems to be working OK</li>
<li>0.5.1
  <br/>minor fix(?) to getting directory from multiple file selector.</li>
<li>0.5.2
  <br/>fix some show/hide problems in output page.</li>
<li>0.5.3
  <br/>add flatten, add cineon output format, minor gui tweaks.</li>
<li>0.5.4
  <br/>add tiff output</li>
<li>0.5.5
  <br/>made output formats generic, added option menu gui</li>
<li>0.5.6
  <br/>fixes for gimp-1.3</li>
<li>0.5.7
  <br/>fixes for gimp-1.3 past version 20...</li>
<li>1.0
  <br/>tidied up, release for Gimp 2.x</li>
<li>1.0.1
  <br/>changed gui of output formats to closer match Gimp versions
  <br/>pre-test for output files
  <br/>warning if no file to test</li>
<li>1.0.2
  <br/>added auto levels to colour page</li>
<li>1.0.3
  <br/>added conversion to black and white
  <br/>reuse same display window</li>
<li>1.0.4
  <br/>removed (unused) pthread code, to compile under Windows
  <br/>added Gimp 2.2 specific code to hide progress popups</li>
<li>1.0.5 (unreleased)
  <br/>added image rotation
  <br/>indexed gif output</li>
<li>1.1
  <br/>removed all Gimp and Gtk deprecated features</li>
<li>1.1.1
  <br/>fixed Windows path bug</li>
<li>1.1.2
  <br/>moved code from dbp.cc to op and gui
  <br/>fixed flatten on resize with padding
  <br/>fixed sharpen parameter type error in Gimp &gt; 2.2.9 or 2.3.5
  <br/>changed sharpen radius range to match Gimp
  <br/>changed threshold control to match Gimp
  <br/>added saturation to colour controls
  <br/>changed file selector Cancel to Close
  <br/>(probably) fixed &quot;missing sentinel&quot; warning on gcc 4.0</li>
<li>1.1.3
  <br/>fixed another missing sentinel warning
  <br/>removed -DGIMP_DISABLE_DEPRECATED from Makefile, to compile under 2.3.8(?)</li>
<li>1.1.4
  <br/>added PAT format by request</li>
<li>1.1.5
  <br/>fixed loading bug that halted DBP after processing a few images</li>
<li>1.1.6
  <br/>added convert to greyscale / convert to indexed</li>
<li>1.1.7
  <br/>fixed bug in colour controls
  <br/>use new progress api for 2.3 and above</li>
<li>1.1.8
  <br/>started to add gettext stuff
  <br/>removed another gtk_file_selector, fixed breakage on gtk-2.6</li>
<li>1.1.9
  <br/>fix longstanding deprecated Gtk problems</li>
</ul></p>
<p>Comments, requests, complaints, or donations to:
<br/><address>
<a href="mailto:hodsond@ozemail.com.au">hodsond@ozemail.com.au</a>
</address></p>
<p>
<form action="https://www.paypal.com/cgi-bin/webscr" method="post">
<input type="hidden" name="cmd" value="_s-xclick">
<input type="image" src="https://www.paypal.com/en_AU/i/btn/btn_donate_SM.gif" border="0" name="submit" alt="Make payments with PayPal - it's fast, free and secure!">
<img alt="" border="0" src="https://www.paypal.com/en_AU/i/scr/pixel.gif" width="1" height="1">
<input type="hidden" name="encrypted" value="-----BEGIN PKCS7-----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-----END PKCS7-----
">
</form></p>
</body>
</html>