StdComment

The default Quickdraw picture-comment handler

#include <Quickdraw.h> Quickdraw

void StdComment(dataKind, dataSize, dataHandle );

short dataKind ; arbitrary; supplied by application

short dataSize ; size, in bytes, of data in the comment

Handle dataHandle ; handle leading to content of the comment

This is Quickdraw's default low-level routine for processing picture

comments. It is executed when a comment is en countered while drawing a

picture via DrawPicture The default action is to ignore the comment.

dataKind is a short whose meaning is defined by the application that supplies

the comment handler.

dataSize is the size, in bytes, of the comment data to be processed or ignored.

dataHandle is a handle leading to any arbitrarily- defined structure or buffer.

The buffer or structure will contain the contents of the comment. A

value of NIL indicates no comment data; in that case, only dataKind is

significant.

Notes: Use StdComment only if your application intercepts the Quickdraw

bottleneck routines (see SetStdProcs).

StdComment does nothing. Its only use is as a bottleneck routine, to be

intercepted by an application that wishes to perform special processing

while drawing a picture. See SetStdProcs for an example of usage.

Some possible reasons for intercepting this bottleneck:

• Take special action on embedded Postscript printer-control sequences.

• Unpack compressed picture data; e.g., data stored in a picture as a result

of a CopyBits call may be full of white space, which if compressed, would

take less memory/disk storage.

• Perform macro operations in one step; e.g. you could create a custom

"comment" command that frames and fills an oval, or even reads data from

a disk.

Of course, special comment handling implies cooperation with the

application that generated the picture; i.e., tha application must store the

expected comments (in the expected data structures) into the picture

definition via PicComment.

Referenced by (8):