write an image file from an AVS/Express field
Mesh_Unif+Dim2+Space2+Node_Data+Iparam ∈
string+Iparam filename;
int+opt output; /* oneshot write the file */
int+IPort flip;
int+nonotify+opt format;
int+nonotify+opt filetype;
int+nonotify+opt depth;
int+nonotify+opt colortype;
int+nonotify+opt compresstype;
float+nonotify+opt compressqual;
int+nonotify+opt reducetype;
int+IPort+nonotify+opt overwrite;
method+notify_val+notify_inst write_image_update<status=1> = "DVwrite_image_update";
method+notify_deinst write_image_delete = "DVwrite_image_delete";
};
DVwrite_image writes an image file of a specified format from an AVS/Express Field.
A string. Names the input file to be written. The string can be either the complete absolute pathname, or a relative pathname. If it is relative, it will be interpreted relative to the user's working directory when AVS/Express was started.
Boolean indicating whether to invert the image about the x axis, i.e. in the vertical direction.
An integer value indicating the image file format to write. The following image formats are currently supported:
Developer Edition users wishing to create runtimes that include support for writing GIF image format, which uses the patented LZW compression algorithm, must first obtain a license from Unisys Corporation:
WARNING : Use of this software for providing LZW capability for any purpose is not authorized unless user first enters into a license agreement with Unisys under U.S. Patent No. 4,558,302 and foreign counterparts. For information concering licensing, please contact:
Unisys Corporation
Welch Licensing Department - C1SW19
Township Line & Union Meeting Roads
P.O. Box 500
Blue Bell, PA 19422
Once you have entered into such a license agreement with Unisys Corp, runtime generation support for GIF can be enabled in AVS/Express at no additional cost. Contact Advanced Visual Systems customer support for details.
Support for additional image formats can be provided by creating new writers using available API calls (see ). To obtain a current list of the supported image formats, you can open v/modules.v and search for "Write_Image" -- the list can be found in the defined radioBox labels.
An integer indicating whether the output file should be written in binary or ASCII. This option is only appropriate for certain formats, e.g. PBM.
An integer indicating how many bits per pixel should be written. For many formats this is fixed, e.g. GIF is always 8, AVS .x always 32.
An integer indicating whether separate red, green and blue values, or grey levels, or dithered black and white 2 level values should be written. This option is only appropriate for certain formats, e.g. GIF.
An integer indicating the type of compression to be used when writing the file. For most formats there is no choice, e.g. GIF is always written using LZW and AVS .x files are always uncompressed. TIFF, however, can support a number of different compression types.
An integer indicating which method to use when the 8 bit red, green and blue values of the input field have to be reduced ("quantized") to 8 bit colormap indices, for example.
Overwrite
An integer indicating whether to choose to automatically over write a file, or ask the user if they want the file over written.
Libraries.Main.Writers.Write_image
v/dv.v
modules/rd_image.c
modules/image.h