Mercurial > cgi-bin > hgweb.cgi > ImagePrep
annotate Readme.html @ 13:3feeb953d9ae
val -> var
author | David Barts <n5jrn@me.com> |
---|---|
date | Sat, 18 Jul 2020 14:23:02 -0700 (2020-07-18) |
parents | 70b4d11ebbb9 |
children | 404eb7e57fe6 |
rev | line source |
---|---|
0 | 1 <!DOCTYPE html> |
2 <html> | |
3 <head> | |
4 <meta http-equiv="content-type" content="text/html; charset=UTF-8"> | |
5 <title>ImagePrep Read Me</title> | |
6 <style> | |
7 html { font-family: "TeX Gyre Schola", serif; } | |
8 h1, h2, h3, h4, h5, h6 { font-family: "Avenir Next", sans-serif; } | |
9 pre, code, kbd, samp { font-family: "Menlo", monospace; font-size: 85%; } | |
10 </style> | |
11 </head> | |
12 <body> | |
13 <h1>ImagePrep Read Me</h1> | |
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 | |
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 | |
18 rudimentary, however.</p> | |
10 | 19 <p>Because I have code to crib, it does run on a <code>.properties</code> |
0 | 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 | |
10 | 22 some code to crib for both. The <code>.</code><code>properties</code> |
23 file must be edited by hand* (it will live in the normal place for such | |
24 files on the system being run under). If no such file exists, a default | |
25 one will be created. The only things in it will be the maximum dimension | |
26 to clamp to, where the output file goes by default, and maybe what the | |
27 output file’s name is by default (i.e. a name suffix).</p> | |
0 | 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> | |
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 | |
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 | |
34 dimension. This will default to the value in the preferences file, but the | |
10 | 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> | |
0 | 50 <p>At that point, the editing step begins. It is extremely simple and is |
51 limited to rotation. Three types of rotation will be offered, 90° | |
52 clockwise, 180°, and 90° counterclockwise.</p> | |
53 <p>The user can rotate the file as many times as s/he wants. Sort of silly, | |
54 but sometimes people are tired and get clockwise and counterclockwise | |
55 confused, so might as well give ’em a chance to fix their mistakes. Plus, | |
56 it would take special effort <em>not</em> to allow this.</p> | |
10 | 57 <p>Then comes the closing and saving. They are one operation, because that |
58 makes the program easier <em>for me</em> to use.</p> | |
0 | 59 <p>Ideally, I wouldn’t even puts around with making this a GUI app in the |
60 first place. It’s for my own use, so the command line would be good | |
61 enough. The problem is rotation: it’s a hot mess. There’s really no way to | |
62 do it right save to show the image to a human and let him (me) decide | |
63 which way is up.</p> | |
64 </body> | |
65 </html> |