comparison Readme.html @ 10:70b4d11ebbb9

Update Readme.html.
author David Barts <n5jrn@me.com>
date Fri, 17 Jul 2020 23:25:33 -0700
parents e0efe7848130
children 404eb7e57fe6
comparison
equal deleted inserted replaced
9:9e9fe34052a6 10:70b4d11ebbb9
14 <p>This is a simple program mainly created for my own benefit.</p> 14 <p>This is a simple program mainly created for my own benefit.</p>
15 <p>Because it is primarily for my own benefit, it does not build to a 15 <p>Because it is primarily for my own benefit, it does not build to a
16 “clickable” app. That is too much of a pain to implement.</p> 16 “clickable” app. That is too much of a pain to implement.</p>
17 <p>Because I have code to crib, it does contain a help file. It’s pretty 17 <p>Because I have code to crib, it does contain a help file. It’s pretty
18 rudimentary, however.</p> 18 rudimentary, however.</p>
19 <p>Because I have code to crib, it does run on a <code>.preferences</code> 19 <p>Because I have code to crib, it does run on a <code>.properties</code>
20 file, but because coding preferences dialogs is something of a pain, it 20 file, but because coding preferences dialogs is something of a pain, it
21 does not contain a preferences or settings dialog, even though there is 21 does not contain a preferences or settings dialog, even though there is
22 some code to crib for both. The <code>.preferences</code> file must be 22 some code to crib for both. The <code>.</code><code>properties</code>
23 edited by hand* (it will live in the normal place for such files on the 23 file must be edited by hand* (it will live in the normal place for such
24 system being run under). If no such file exists, a default one will be 24 files on the system being run under). If no such file exists, a default
25 created. The only things in it will be the maximum dimension to clamp to, 25 one will be created. The only things in it will be the maximum dimension
26 where the output file goes by default, and maybe what the output file’s 26 to clamp to, where the output file goes by default, and maybe what the
27 name is by default (i.e. a name suffix).</p> 27 output file’s name is by default (i.e. a name suffix).</p>
28 <p>* This program is <em>for my own benefit</em>, and <em>I</em> have no 28 <p>* This program is <em>for my own benefit</em>, and <em>I</em> have no
29 problem editing text files, therefore this is reasonable.</p> 29 problem editing text files, therefore this is reasonable.</p>
30 <p>Contrary to JpegWasher, which is designed for batch processing, this will 30 <p>Contrary to JpegWasher, which is designed for batch processing, this will
31 have more of a “document editor” style of design. Meaning, you open a 31 have more of a “document editor” style of design. Meaning, you open a
32 file, you edit it, you save it, you close it.</p> 32 file, you edit it, you save it, you close it.</p>
33 <p>Upon opening a file, it will be auto-scaled to the specified maximum 33 <p>Upon opening a file, it will be auto-scaled to the specified maximum
34 dimension. This will default to the value in the preferences file, but the 34 dimension. This will default to the value in the preferences file, but the
35 user will be able to change it at open time.</p> 35 user will be able to override it with a command-line argument.</p>
36 <p>Ah, the command-line. Because it’s not a full “clickable” app, it is
37 launched from the command line, and accepts arguments, much like the old
38 days of using X Windows. This is actually <em>more</em> user-friendly for
39 my purposes, because it ends up honoring the concept of the current
40 working directory. (Directory management is one area where GUI programs
41 fall short.)</p>
42 <p>The current working directory is the input files directory. Depending on
43 how the properties are configured, the output directory is either the
44 current working directory, or a specified output file directory. Both
45 directories act like a current working directory; the next time an input
46 or output dialog is brought up in a given session, it will be in the same
47 spot the previous dialog was when it was closed. All this makes it easy to
48 rapidly edit files in a directory of images downloaded from a camera,
49 without polluting that directory with the edited files.</p>
36 <p>At that point, the editing step begins. It is extremely simple and is 50 <p>At that point, the editing step begins. It is extremely simple and is
37 limited to rotation. Three types of rotation will be offered, 90° 51 limited to rotation. Three types of rotation will be offered, 90°
38 clockwise, 180°, and 90° counterclockwise.</p> 52 clockwise, 180°, and 90° counterclockwise.</p>
39 <p>The user can rotate the file as many times as s/he wants. Sort of silly, 53 <p>The user can rotate the file as many times as s/he wants. Sort of silly,
40 but sometimes people are tired and get clockwise and counterclockwise 54 but sometimes people are tired and get clockwise and counterclockwise
41 confused, so might as well give ’em a chance to fix their mistakes. Plus, 55 confused, so might as well give ’em a chance to fix their mistakes. Plus,
42 it would take special effort <em>not</em> to allow this.</p> 56 it would take special effort <em>not</em> to allow this.</p>
43 <p>Then comes the closing and saving. It <em>might</em> make the most sense 57 <p>Then comes the closing and saving. They are one operation, because that
44 to wrap these two up into one operation, given that there are two 58 makes the program easier <em>for me</em> to use.</p>
45 operations in one when one opens the thing, too*. (Sort of a compromise
46 between a classic “document editor” design and a batch-processing design.)
47 This will default to the name and directory consistent with the
48 preferences settings, but it will be based around a file dialog so that
49 the user can save the resized image anyplace, with any name.</p>
50 <p>* Leaning towards making “close &amp; save” one operation; again, this
51 program is primarily for <em>my</em> benefit.</p>
52 <p>Ideally, I wouldn’t even puts around with making this a GUI app in the 59 <p>Ideally, I wouldn’t even puts around with making this a GUI app in the
53 first place. It’s for my own use, so the command line would be good 60 first place. It’s for my own use, so the command line would be good
54 enough. The problem is rotation: it’s a hot mess. There’s really no way to 61 enough. The problem is rotation: it’s a hot mess. There’s really no way to
55 do it right save to show the image to a human and let him (me) decide 62 do it right save to show the image to a human and let him (me) decide
56 which way is up.</p> 63 which way is up.</p>