Mercurial > cgi-bin > hgweb.cgi > ImagePrep
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 & 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> |