MODULE NAME : Multiformat read VERSION : 2.0 DATE : June 19, 1994 INPUTS : image 2D 4-vector byte PARAMETERS : filename file browser image file format choice MODULE DESCRIPTION : This module reads an image from disk into AVS in any of a variety of formats. Some of the formats which this module supports are from San Diego Supercomputing Center's image tools package, others are supported from John Cristy's ImageMagick package, still others require tools from GNU's Ghostscript, and the NetPBM package. Depending on how the module is configured, it can read and about 30 to 40 image formats. This module contains a superset of the formats in the READ_ANY_IMAGE module, with several new formats added and improved support for several of the original file types. [ I have added several sample image files to the distribution of this module, for you to test out its functionality. Each of these files should be readable withOUT uncompressing them first, as the module itself will take care of this for you. Sample_Image.gif Sample_Image.pict Sample_Image.ppm.Z Sample_Image.ps.Z Sample_Image.rgb.Z Sample_Image.rle.Z Sample_Image.tiff.Z Sample_Image.xwd.Z Sample_Image.yuv.Z - Steve Thorpe avs@ncsc.org ] Please note that this module calls several executable files, including imconv, convert, and gzip. Platform specific binaries for several of these programs are available from the IAC ftp site with this module. Source code for these programs is also available on the internet. See below or the file multiio.h for further details on the sources for this module's tools. [ Probably it will be most convient to find those tools that you don't already have at the IAC, where the following tools are stored in one large compressed tar file: GhostScript2.6.1 IMagickExtended SDSC_Image_Tools gzip-1.2.4 netpbmplus The address of this compressed tar file is avs.ncsc.org:/misc_tools/multiio_tools/multiio_tools.tar.Z This file is ~ 11MB in size. - Steve Thorpe avs@ncsc.org ] NEW FEATURES : This module is a retread of READ_ANY_IMAGE, written by Terry Myerson and Steve Thorpe at the International AVS Center. It has several new image formats added (denoted with "+" below), several changed (denoted with "*"), as well as the following features: No temp files are written to disk (except reading from tiff). The process is now all done in memory, which is usually much faster and reduces disk wear. Avs .x images are read and written without unnecessary conversion. Compressed and gziped files are read without any extra effort of the user. Simply choose the file in the browser or enter the full filename (with extensions) in the dialog box. Execution is not fired when changing file types, only when changing names. This allows one to seamlessly go between heterogenous filetypes without having to stop the network's flow. Any of the following image file formats can be read by this module : *bmp Microsoft Windows bitmap image file cur Microsoft Windows cursor image file #*eps Adobe Encapsulated PostScript file #+epsi Adobe Encapsulated PostScript Interchange format. +fits Flexible Image Transport System (monochrome only). *gif Compuserve Graphics image file hdf Hierarchical Data File ico Microsoft Windows icon image file icon Sun Icon and Cursor file iff Sun TAAC Image File Format +iris SGI RGB image file. (ImageMagick conversion) +jpeg JPEG/JFIF Rev. 1.02 +miff Magick image file format. (ImageMagick native format) mpnt Apple Macintosh MacPaint file +mtv Mark VanDeWettering's MTV ray tracer image format. *pbm binary or ASCII PBM Portable Bit Map +pcd Photo CD. *pcx ZSoft IBM PC Paintbrush file *pgm binary or ASCII PBM Portable Gray Map pic PIXAR picture file *pict Apple Macintosh QuickDraw/PICT file pix Alias image file *pnm binary or ASCII PBM Portable aNy Map *ppm binary or ASCII PBM Portable Pixel Map #*ps Adobe PostScript file (read available with Ghostscript only) +rad Radiance image file. ras Sun Rasterfile (SDSC Image tools conversion) rgb SGI RGB image file (SDSC Image tools conversion) rla Wavefront raster image file rlb Wavefront raster image file rle Utah Run length encoded image file +sun Sun Rasterfile (ImageMagick conversion) synu SDSC Synu image file *tga Truevision Targa image file *tiff Tagged image file viff Khoros Visualization image file *x AVS X image file xbm X11 bitmap file xwd X Window System window dump image file +xpm X11 pixmap file. &+yuv CCIR 601 1:1:1 file. (Quantel NTSC) (720x486 size only) * = file format that has been modified from READ_ANY_IMAGE. + = file format that was not previously available with READ_ANY_IMAGE. # = file format available for reading only with Ghostscript. & = file format available for reading only with yuvtoppm from Netpbm(pbmPlus). NOTE: Formats pbm, pgm, pnm, and ppm, will read ASCII or (raw) binary files. CREDITS ------- This module relies in part on the San Diego Supercomputer Center's Image Tools, which are available via anonymous ftp to ftp.sdsc.edu. For more information, send email to info@sdsc.edu. This module relies in part on John Cristy's ImageMagick programs which are available via anonymous ftp to ftp.x.org:contrib/applications/ ImageMagick/ImageMagick-3.0.tar.gz. For more information, contact John Cristy at . Also useful is the Netpbm(plus) package which contains many standalone conversions, several of which are used in this module. It is available by anon ftp from ftp.x.org:R5contrib/netpbm-1mar1994.tar.gz Also necessary for postscript support is Ghostscript from GNU at prep.ai.mit.edu:/pub/gnu. Compression support includes unix compress available on most platforms, and gzip, available from GNU at prep.ai.mit.edu:/pub/gnu. Portions based on the /usr/avs/examples/read_image.c example code which is provided by Advanced Visual Systems, Inc. Several contributed modules at the IAC ftp site were also visited in the process of putting this together.