29 |
// |
// |
30 |
//The 3 programs in the 3-program suite are: |
//The 3 programs in the 3-program suite are: |
31 |
// |
// |
32 |
// pics_filenames_canonize.php (this program): |
// pics_filenames_canonize.php (this script): |
33 |
// Converts all names of files in a directory to lower-case, and makes substitutions for any |
// Converts all names of files in a directory to lower-case, and makes substitutions for any |
34 |
// unusual characters. |
// unusual characters. |
35 |
// |
// |
36 |
// pics_thumbnails_make.php: |
// pics_thumbnails_make.php: |
37 |
// Creates thumbnails from recognized image types. The thumbnails are named relative to the |
// Creates thumbnails from recognized image types. The thumbnails are named relative to the |
38 |
// original image file with the suffix "_small". Only 20 files are converted on each |
// original image file with the suffix "_small". To support shared hosting environments where |
39 |
// invocation of the program, to avoid the involuntary process termination that typically |
// CPU utilization of a script may be capped, there is a configuration constant in the script |
40 |
// occurs in a shared hosting environment when a process uses too much CPU time. The program |
// that will perform only a fixed number of conversions per invocation. If this configuration |
41 |
// should be run repeatedly until it indicates that it has no more thumbnails to create. |
// option is used, the script should be run repeatedly until it indicates that it has no more |
42 |
|
// thumbnails to create. |
43 |
// |
// |
44 |
// If any full-sized photos are modified, any corresponding thumbnails should be deleted and |
// If any full-sized photos are modified, any corresponding thumbnails should be deleted and |
45 |
// pics_thumbnails_make.php and pics_indexfile_make.php should be run again. |
// pics_thumbnails_make.php and pics_indexfile_make.php should be run again. |
46 |
// |
// |
47 |
// pics_indexfile_make.php |
// pics_indexfile_make.php: |
48 |
// Scans a directory and makes an index file ("index2.php") displaying all the thumbnail |
// Scans a directory and makes an index file ("index2.php") displaying all the thumbnail |
49 |
// images, each of which link to the corresponding full-sized image. The index file is |
// images, each of which link to the corresponding full-sized image. The index file is |
50 |
// tailored to Dave Ashley's needs, but the created file can be edited and most of the |
// tailored to Dave Ashley's needs, but the created file can be edited and most of the |
56 |
//hosting company Dave Ashley used at the time these scripts were written) has as part of its |
//hosting company Dave Ashley used at the time these scripts were written) has as part of its |
57 |
//hosting environment PHP with the ImageMagick library compiled in. |
//hosting environment PHP with the ImageMagick library compiled in. |
58 |
// |
// |
59 |
//Usually, this script is invoked using "php <path>/filenames_canonize.php", but the method of |
//Usually, this script is invoked using "php <path>/pics_filenames_canonize.php", but the method of |
60 |
//invocation may vary based on computing platform details. |
//invocation may vary based on computing platform details. |
61 |
//------------------------------------------------------------------------------------------------- |
//------------------------------------------------------------------------------------------------- |
62 |
//C O N F I G U R A T I O N |
//C O N F I G U R A T I O N |