DC_WRITE_24_BIT Function

Writes 24-bit image data to a file.

Usage

status = DC_WRITE_24_BIT(filename, imgarr)

Input Parameters

A string containing the pathname and filename of the file where the 24-bit image data is to be stored.

imgarr The 3D byte array from which the 24-bit image data is transferred. Either the first or last dimension of imgarr must be 3; see the Discussion section for more details.

Returned Value

The value returned by DC_WRITE_24_BIT; expected values are:


0	Indicates an error, such as an invalid filename.
0	Indicates a successful write.

Keywords

Org

Organization of the 24-bit image data. Allowed values are:


0	Pixel interleaving (RGB triplets).
1	Image interleaving (separate planes).

If not provided, 0 (pixel interleaving) is assumed.

Discussion

DC_WRITE_24_BIT handles many steps that you have to do yourself when using other PV-WAVE functions and procedures. These steps include: 1) opening the file, 2) assigning it a logical unit number (LUN), and 3) closing the file when you are done writing the data.

NOTE: Only one 24-bit image can be stored at a time when using the DC_WRITE_24_BIT function.

If imgarr is not a 3D byte array, DC_WRITE_24_BIT returns an error status and no data is written to the output file. Either the first or last dimension of imgarr must be equal to 3, as shown in the following table:


Interleaving Method	Dimensions of Image Variable
Pixel (RGB triplets)	Dimension imgarr as 3 x w x h, where w and h are the width and length of the image in pixels.
Image (separate planes)	Dimension imgarr as w x h x 3, where w and h are the width and length of the image in pixels.

The difference between pixel-interleaved and image-interleaved data is discussed in the PV-WAVE Programmer's Guide.

Example

If hi_glow is a 400-by-400-by-3 byte array containing 24-bit image data, the function call:

status = DC_WRITE_24_BIT('hi_glow.img', hi_glow, Org=1)

creates the file hi_glow.img and uses it to store the image data contained in the variable hi_glow, using image interleaving. The file that is created contains raw binary data, and is easily read with the function DC_READ_24_BIT.

See Also

See the PV-WAVE Programmer's Guide for or more information about 24-bit (binary) data.

Windows Users: For an example showing how to use DC_WRITE_FREE to export data from PV-WAVE into a Microsoft^® Excel spreadsheet, see the PV-WAVE Programmer's Guide.

doc@boulder.vni.com

Copyright © 1999, Visual Numerics, Inc. All rights reserved.