dx-doc 1:4.4.4-7 / usr / share / doc / dx / help / dxall982

#!F-adobe-helvetica-medium-r-normal--18*
#!N 
#!N  #!Rsrfilfm File Formats #!N #!N #!N See  #!Lfiltyp22,dxall982 t Table 22  #!EL  for the 
recognized formats. PostScript** formats may include additional modifiers, separated from the 
format name by white space. See  #!Lpsfmt,dxall982 s PostScript  #!EL  for the recognized modifiers. 
The following example sets the format to PostScript and specifies a 
page size of 4x5 and gamma=1. #!CForestGreen #!N #!N  #!F-adobe-courier-bold-r-normal--18*   #!N 
WriteImage(y,name,"ps page=4x5 gamma=1"); #!EF #!N #!N #!EC #!N #!N The RGB 
( "  #!F-adobe-times-bold-r-normal--18*   rgb #!EF " and "  #!F-adobe-times-bold-r-normal--18*   r+g+b #!EF 
" ) and YUV formats allow an existing file to be 
modified, either by overwriting existing frames or by extending the number 
of frames in the file. The TIFF and PostScript formats do 
not support this capability. MIFF allows appending of images (but not 
overwriting of images). #!N #!N  #!Lfiltyp22,dxall982 t Table 22  #!EL  summarizes the characteristics of each 
format. Descriptive sections follow the table.  #!Rfiltyp22 #!T,1,121,241,401,521,641  #!F-adobe-times-bold-r-normal--18*   #!N TAB 
Table 22. Format Characteristics for WriteImage #!N TAB File Type TAB 
Format Specifier TAB Resulting File Extension(s) TAB Multiframe/ Series TAB Modify 
an Existing #!N TAB - TAB - TAB - TAB Data 
TAB File #!EF #!N TAB gif TAB "gif" TAB .gif TAB 
No TAB No #!N TAB rgb TAB "rgb" TAB .rgb and 
.size TAB Yes TAB Yes #!N TAB - TAB "r+g+b" TAB 
.r, .g, .b, and .size TAB - TAB #!N TAB TIFF 
TAB "tiff" TAB .tiff TAB Yes TAB No #!N TAB yuv 
TAB "yuv" TAB .yuv TAB Yes TAB Yes #!N TAB Color 
PostScript TAB "ps color" TAB .ps TAB Yes TAB No #!N 
TAB - TAB "ps" TAB - TAB - TAB #!N TAB 
Gray PostScript TAB "ps gray" TAB .ps TAB Yes TAB No 
#!N TAB - TAB "ps grey" TAB - TAB - TAB 
#!N TAB Color PostScript TAB "eps" TAB .epsf TAB No TAB 
No #!N TAB (Encapsulated) TAB "eps color" TAB - TAB - 
TAB #!N TAB Gray PostScript TAB "eps gray" TAB .epsf TAB 
No TAB No #!N TAB (Encapsulated) TAB "eps grey" TAB - 
TAB - TAB #!N TAB MIFF TAB "miff" TAB .miff TAB 
Yes TAB Yes #!N #!I0 #!N #!N #!I0 #!N  #!F-adobe-times-bold-r-normal--18*    #!F-adobe-times-bold-r-normal--18*   
gif #!EF #!EF #!I50 #!N Graphics Interchange Format** adheres to the 
87A convention. It includes LZW compression. Images are saved with 24-bit 
colors, with a maximum palette of 256 colors. #!N #!I0 #!N 
 #!F-adobe-times-bold-r-normal--18*    #!F-adobe-times-bold-r-normal--18*   rgb #!EF #!EF #!I50 #!N rgb file format consists 
of two files, a binary  #!F-adobe-times-medium-i-normal--18*   name #!EF .rgb file that 
contains the image pixel values and a  #!F-adobe-times-medium-i-normal--18*   name #!EF .size 
file used to specify the image dimensions and the number of 
images contained in the  #!F-adobe-times-medium-i-normal--18*   name #!EF .rgb file. The  #!F-adobe-times-medium-i-normal--18*   
name #!EF .size file contains a single line of ASCII text 
in the format "  #!F-adobe-times-bold-i-normal--18*   w #!EF *  #!F-adobe-times-bold-i-normal--18*   h #!EF 
*  #!F-adobe-times-bold-i-normal--18*   f #!EF ," where  #!F-adobe-times-bold-i-normal--18*   w #!EF and  #!F-adobe-times-bold-i-normal--18*   
h #!EF give the dimensions of each image and  #!F-adobe-times-bold-i-normal--18*   f 
#!EF indicates the number of images in the  #!F-adobe-times-medium-i-normal--18*   name #!EF 
.rgb file. The  #!F-adobe-times-medium-i-normal--18*   name #!EF .rgb file contains (red, green, 
blue) binary pixel values with 8 bits per color (24 bits/pixel). 
Pixels are read and written from the image in left-to-right, top-to-bottom 
order. #!N #!I0 #!N  #!F-adobe-times-bold-r-normal--18*    #!F-adobe-times-bold-r-normal--18*   r+g+b #!EF #!EF #!I50 #!N 
r+g+b format is similar to rgb format, except that the  #!F-adobe-times-medium-i-normal--18*   
name #!EF .rgb file is replaced by three binary files, one 
for each color. The  #!F-adobe-times-medium-i-normal--18*   name #!EF .r file contains the 
red color values for all images, the  #!F-adobe-times-medium-i-normal--18*   name #!EF .g 
file contains the green color values for all images and the 
 #!F-adobe-times-medium-i-normal--18*   name #!EF .b file contains the blue color values for 
all images. Again, all color values are 8 bits (24 bits/pixel). 
#!N #!I0 #!N  #!F-adobe-times-bold-r-normal--18*    #!F-adobe-times-bold-r-normal--18*   TIFF #!EF #!EF #!I50 #!N TIFF 
(tag image file format) files are binary files that contain 24 
bits/pixel color resolution. For more information on TIFF files see  #!F-adobe-times-medium-i-normal--18*   
Tag Image File Format Specification #!EF , Revision 5.0, available from 
Aldus Corporation or Microsoft Corporation. #!N #!I0 #!N  #!F-adobe-times-bold-r-normal--18*    #!F-adobe-times-bold-r-normal--18*   yuv 
#!EF #!EF #!I50 #!N This format adheres to Abekas YUV format, 
which can be directly imported to a variety of public domain 
MPEG encoders.  #!Rpsfmt #!N #!I0 #!N  #!F-adobe-times-bold-r-normal--18*    #!F-adobe-times-bold-r-normal--18*   PostScript #!EF #!EF 
#!I50 #!N PostScript format files are written out using PostScript's image 
(or color image) operator and require only PostScript Level 1 interpreter 
support. WriteImage supports four different varieties of PostScript. Images can be 
written out in either color or gray-scale and either "Encapsulated" or 
not. Color images are written out at 24 bits/pixel and gray-scale 
at 8 bits/pixel. Encapsulated PostScript is a format intended to be 
used when incorporating images into other documents. For this reason, the 
Encapsulated PostScript formats do not support series image input (i.e., only 
one image per file is acceptable). All PostScript output is run-length 
encoded to reduce the file size. (For more information on PostScript 
see  #!F-adobe-times-medium-i-normal--18*   PostScript Language Reference Manual #!EF , Second Edition; Addison-Wesley 
Publishing Company, 1990.) #!N #!N By default, the image will be 
scaled and oriented to fill the current page size within the 
specified  #!F-adobe-times-bold-r-normal--18*   margin #!EF of the edge, while preserving the original 
aspect ratio of the image. That is, the image will be 
made as large as possible while maintaining the specified margin on 
at least one of the two dimensions. If  #!F-adobe-times-bold-r-normal--18*   Allow Rerendering 
#!EF is off, the pixels in the image will be sized 
appropriately to scale the image to fill the page, but the 
same number of pixels as in the currently displayed image will 
be used. If this results in a grainy image, set  #!F-adobe-times-bold-r-normal--18*   
Allow Rerendering #!EF on, and enter a different  #!F-adobe-times-bold-r-normal--18*   Input image 
size #!EF . For example, if the displayed image is 640x480, 
and you want to double the resolution, just enter 1280 in 
the  #!F-adobe-times-bold-r-normal--18*   Input image size #!EF field and Data Explorer will 
recalculate the new value of y (960) and the new (higher) 
value for  #!F-adobe-times-bold-r-normal--18*   Output PPI #!EF . If  #!F-adobe-times-bold-r-normal--18*   dpi #!EF 
or  #!F-adobe-times-bold-r-normal--18*   width #!EF is specified, these specifications will override the 
autoscaling feature. It is typically only necessary to use the  #!F-adobe-times-bold-r-normal--18*   
page #!EF and  #!F-adobe-times-bold-r-normal--18*   margin #!EF modifiers. #!N Note: The ReadImage 
module does not support the PostScript formats. #!N #!N #!N PostScript 
supports the following format modifiers: #!N #!I0 #!N #!N #!I0 #!N 
 #!F-adobe-times-bold-r-normal--18*    #!F-adobe-times-bold-r-normal--18*   page = w * h #!EF #!EF #!I50 #!N 
Sets the page size in inches (width * height). The width 
is the width of the printer (typically, the dimension perpendicular to 
page motion). The default is 8.5*11. #!N #!I0 #!N  #!F-adobe-times-bold-r-normal--18*    #!F-adobe-times-bold-r-normal--18*   
dpi = #!EF  #!F-adobe-times-medium-i-normal--18*   n #!EF #!EF #!I50 #!N Sets the 
number of dots (pixels) per inch in the hardcopy image. Note 
that  #!F-adobe-times-bold-r-normal--18*   dpi #!EF does  #!F-adobe-helvetica-bold-r-normal--18*    #!F-adobe-times-bold-r-normal--18*   not #!EF #!EF correspond 
to the dpi of the printer. Use this parameter only if 
you want to explicitly set the number of dots per inch. 
Generally it is easier to simply specify the  #!F-adobe-times-bold-r-normal--18*   Input Image 
size #!EF to set the overall resolution of the image if 
the image is too grainy. #!N #!I0 #!N  #!F-adobe-times-bold-r-normal--18*    #!F-adobe-times-bold-r-normal--18*   orient 
= landscape #!EF #!EF  #!F-adobe-times-bold-r-normal--18*   orient = portrait #!EF  #!F-adobe-times-bold-r-normal--18*   orient 
= auto #!EF #!I50 #!N Indicates the orientation of the image 
on the page.  #!F-adobe-times-bold-r-normal--18*   landscape #!EF means that the image's "up 
vector" (bottom to top) runs across the width of the page. 
In  #!F-adobe-times-bold-r-normal--18*   portrait #!EF mode, the up vector runs up the 
length of the page. The default is  #!F-adobe-times-bold-r-normal--18*   auto #!EF . 
#!N #!I0 #!N  #!F-adobe-times-bold-r-normal--18*    #!F-adobe-times-bold-r-normal--18*   width = w #!EF #!EF #!I50 
#!N Specifies the size in inches of the "across the screen" 
dimension of the image as it appears on the page. If 
specified, it overrides the  #!F-adobe-times-bold-r-normal--18*   dpi = #!EF modifier. #!N #!I0 
#!N  #!F-adobe-times-bold-r-normal--18*    #!F-adobe-times-bold-r-normal--18*   margin = m #!EF #!EF #!I50 #!N Sets 
the desired margin around the image on the page. The default 
is .5 inch. #!N #!I0 #!N  #!F-adobe-times-bold-r-normal--18*    #!F-adobe-times-bold-r-normal--18*   height = h 
#!EF #!EF #!I50 #!N Specifies the size in inches of the 
"top to bottom of the screen" dimension of the image as 
it appears on the page. If specified, it overrides the  #!F-adobe-times-bold-r-normal--18*   
margin = #!EF modifier. #!N #!I0 #!N  #!F-adobe-times-bold-r-normal--18*    #!F-adobe-times-bold-r-normal--18*   gamma = 
g #!EF #!EF #!I50 #!N Sets the gamma correction factor for 
the output image. The default is 2.0. This modifier is available 
for all format types. #!N #!I0 #!N  #!F-adobe-times-bold-r-normal--18*    #!F-adobe-times-bold-r-normal--18*   delayed = 
1 #!EF #!EF #!I50 #!N Specifies that a "delayed colors" image 
should be written, that is, an image-with-colormap. This modifier is available 
for PostScript, TIFF, and MIFF formats. In addition, it is set 
by default for GIF format (as all GIF images are in 
image-with-colormap format). #!I0 #!N #!N #!N #!N For example: #!CForestGreen #!N 
#!N  #!F-adobe-courier-bold-r-normal--18*   #!N WriteImage(y, name, "ps color page=4x5 #!N #!N margin=0.4 
#!N #!N orient=landscape"); #!EF #!N #!N #!EC #!N #!N If only 
 #!F-adobe-times-bold-r-normal--18*   width #!EF or  #!F-adobe-times-bold-r-normal--18*   height #!EF is specified (but not 
both), the original aspect ratio of the image is maintained. If 
both are specified, the image may be stretched. #!N #!I0 #!N 
 #!F-adobe-times-bold-r-normal--18*   MIFF #!EF #!I50 #!N is a run-length-encoded format that supports 
image sequences. Writing an image to an existing miff file name 
causes the image to be appended to the file. To start 
a new sequence you must delete the .miff file. #!I0 #!N 
#!N #!N #!N Note: If you are writing out images for 
use later from within Data Explorer, you will probably want to 
set gamma correction to 1 (the default is 2). Otherwise, images 
will be doubly gamma-corrected. (Gamma correction at display time can also 
be controlled using the DXGAMMA environment variable; see  #!Lenvvar,dxall684 h Environment Variables  #!EL  in IBM 
Visualization Data Explorer User's Guide). For printing or viewing images in 
another package, use gamma appropriate for that device. #!N #!N See 
Also #!N #!N  #!Lreadima,dxall915 h ReadImage  #!EL  ,  #!Lqantimg,dxall914 h QuantizeImage  #!EL  #!N #!N #!N  #!F-adobe-times-medium-i-normal--18*   Next 
Topic #!EF #!N #!N  #!Lall982,dxall983 h Programmer's Reference  #!EL  #!N  #!F-adobe-times-medium-i-normal--18*   #!N