Inside Macintosh: 3D Graphics Programming With QuickDraw 3D /

Chapter 17 - File Objects / File Objects Reference

File Objects Routines / Reading and Writing File Data

Q3RawData_Write

You can use the Q3RawData_Write function to write raw data to a file object.

TQ3Status Q3RawData_Write (
const unsigned char *data, 
unsigned long size, 
TQ3FileObject file);

data

On entry, a pointer to a buffer of raw data whose length is of the specified size.

size

On entry, the number of bytes of raw data to be read from the specified buffer and written to the specified file object. On exit, the number of bytes actually written to the file object.

file

A file object.

DESCRIPTION

The Q3RawData_Write function writes the raw data pointed to by the data parameter to the file object specified by the file parameter. The number of bytes written to the file object is equal to Q3Size_Pad(size). If the number of bytes written to the file object is greater than size, Q3RawData_Write pads the data to the nearest 4-byte boundary with 0's.

In text files, raw data is output in hexadecimal form.