IM Example Contributions (How To)
I reguarly incorperate examples discussed in the IM discussion Forum, so feel free to post examples on how to do something in one of the forums. Input images and example results can be links directly from IM examples images directory, or some other image source. This can be preferable as others can then comment and/or make suggestions, or find better or alternative ways to achieve the same results. You may learn something -- I learn new technques all the time this way.I noticed some areas of the site that are under contruction or awaiting examples. I'm willing to help fill in those blanks. Will simple patches work for the text?
A public Dropbox folder, makes a good place to upload example results, data, or even HTML pages. Unlike specialised image sites dropbox does not place restrictions on the data types that can be seen. And no you do not need to use their 'syncronization' software to use it, I don't! I use dropbox all the time to provide all sorts of results for forum discussion, as long as you keep the images small the 'free' quota is more than enough for hundreds of images. There are of course other solutions for pubilc upload areas of just a few Gigabytes that can be used.
You can sending me a tar/zip archive or link with larger example contributions (give me a day or so heads up before mailing). Either as unformated text. Or you can download and edit the IM Examples "index.html" files directly. The "Usage with Windows" and "Lens Correction" sections of IM Examples were major contributions of this kind, and both sections have been expanded since that initial contribution.
NOTE about IM Usage Examples... Do not use a 'HTML' editor. It screws up my own HTML formating which I do from a plain text editor ("vim" with color syntax highlighting under linux)! I don't use fancy HTML technqiues, PHP, or Server Side Includes, just simple HTML text formating (how HTML was originally intended to be used). This allows the examples to work with just about any browser. My only concession to JAVA, was to allow Windows XP "Internet Explorer" to display PNG images with transparency.
I also use extra HTML codes for <CODE>...</CODE> blocks, which while not 'standard HTML' is completely ignored by web browsers. These non-standard attributes allows a perl script to extract the actual 'commands' shown on the page, and exectute them to generate the examples. That is just about every example image result you see can be re-generated using the command shown. That script also lets me know when an example 'breaks' (major changes to the resulting image), and this has discovered huge numbers of 'bugs' and changes to IM, that were not expected.
I also prefer the use of small images so as to save documentation space (and disk space), the few images 'built-in' to ImageMagick, generated or drawn test images, and the re-use images created by previous examples in the same section, or which has already added to IM Examples. Basically I try to keep the image set as small and versitile as posible. But I understand that some examples need specific images to demonstrate some specific feature.
These are the four 'image' source directories used within IM Examples...
- Test images http://www.imagemagick.org/Usage/images/INDEX.html
- Photos and Real Life (often resized for example use) http://www.imagemagick.org/Usage/img_photos/INDEX.html
- Diagrams (for explaination, rather than processing) http://www.imagemagick.org/Usage/img_di ... INDEX.html
- and Web Images (for display formating) http://www.imagemagick.org/Usage/img_www/INDEX.html
A required source image is linked from the above into the sub-directory of the example section needing the image. That way when an example "command" is extracted from the "index.html" file, it will find its source images in the same directory, and generates its results in the same directory. Text output files are converted into GIF images for inclusion on the "index.html" page, so users can see the actual output, and not something generated when the example was first written.