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 > 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 "missing sentinel" 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>
|