|
| 1 | + |
| 2 | + |
| 3 | +The Example Processing Files are... |
| 4 | + |
| 5 | +Toplevel... |
| 6 | + generate_all - accept some flags and run all "generate" scripts |
| 7 | + using those flags |
| 8 | + generate_options - convert command line flags into shell options to |
| 9 | + control image generation. Also provides the |
| 10 | + 'usage' output |
| 11 | + index.html |
| 12 | + generate - generate script for just the top level |
| 13 | + also contains specific index creation for the |
| 14 | + four 'image' stores |
| 15 | + |
| 16 | +Each Sub-Directory (crop is a good general section to study) |
| 17 | + index.html |
| 18 | + generate - generate for each sub-direcory all very simular |
| 19 | + * process command line options |
| 20 | + * clear/backup existing examples |
| 21 | + * link/copy source images into current directory |
| 22 | + * generate examples from "index.html" |
| 23 | + * run any other scripts needed |
| 24 | + * compare examples against backup |
| 25 | + * and finally do any special cleanup! |
| 26 | + generate_* - other generation scripts need for this section |
| 27 | + |
| 28 | +Processing Scripts (toplevel) |
| 29 | + generate_clear - either deletes all image files, or backs them up |
| 30 | + for compares. Backup images are prefexed with '_' |
| 31 | + generate_examples - THE MAIN WORKHORSE |
| 32 | + This is the one that reads the HTML index files, |
| 33 | + extracts the commands |
| 34 | + from 'CODE' blocks. It then runs the command |
| 35 | + according to command line flags, or flags in each |
| 36 | + 'CODE' |
| 37 | + generate_compare - compare backed up images against the just |
| 38 | + generated images to find examples where the |
| 39 | + results have changed. |
| 40 | + Backups are deleted (or not) after comparison |
| 41 | + generate_font_chars - extract specific characters from of array of |
| 42 | + an array of characters (for append/montage examples) |
| 43 | + generate_symbols - extract images from specific fonts, usually used |
| 44 | + to display mathematical processing (morphology) |
| 45 | + generate_tags - generate a "tags" index file for vim editor |
| 46 | + (you can ignore) |
| 47 | + generate_version - create a image of the current IM version during the |
| 48 | + example creation of a specific "index.html" |
| 49 | + |
| 50 | +Helper Scripts |
| 51 | + |
| 52 | + cmp_backups - look at backup images that was left behind as |
| 53 | + they fails the image compare. I manually |
| 54 | + deletes the backup images when satisfied all is |
| 55 | + okay. |
| 56 | + forum_link.cgi - redirect links to the User Forums appropriately. |
| 57 | + The user forum moved three times during those 10 |
| 58 | + years, and I got sick of having to change all the |
| 59 | + links in all the index.html, so I have it go thru |
| 60 | + this script. |
| 61 | + |
| 62 | + |
| 63 | +The scripts sub-directory is just scripts for processing images using |
| 64 | +imagemagick. Many are referred to and even used by specific examples. |
| 65 | +The directory should be in your PATH. |
| 66 | + |
| 67 | +Note in any specific section (sub-directory) I typically tried to keep |
| 68 | +what source images are used to a minimum. |
| 69 | + |
| 70 | +I preferred to reuse the source image in multiple examples, |
| 71 | +or use previously generated example results for later example input. |
| 72 | + |
| 73 | + |
| 74 | + |
| 75 | + |
| 76 | + Anthony Thyssen ( System Programmer ) <A.Thyssen@griffith.edu.au> |
| 77 | + -------------------------------------------------------------------------- |
| 78 | + My religious faith is a private matter bettween me and my God. |
| 79 | + -- Robert A. Heinlein "If this Goes On..." |
| 80 | + -------------------------------------------------------------------------- |
| 81 | + Anthony's Castle http://www.ict.griffith.edu.au/anthony/ |
| 82 | + |
0 commit comments