Title Banner

Previous Book Contents Book Index Next

Inside Macintosh: 3D Graphics Programming With QuickDraw 3D /
Chapter 13 - View Objects / View Objects Reference
View Objects Routines / Writing in a View


Q3View_EndWriting

You can use the Q3View_EndWriting function to end writing to a file.

TQ3ViewStatus Q3View_EndWriting (TQ3ViewObject view);
view
A view.
DESCRIPTION
The Q3View_EndWriting function returns, as its function result, a view status value that indicates the current state of the writing in the view specified by the view parameter. Q3View_EndWriting returns one of these four values:

typedef enum TQ3ViewStatus {
   kQ3ViewStatusDone,
   kQ3ViewStatusRetraverse,
   kQ3ViewStatusError,
   kQ3ViewStatusCancelled
} TQ3ViewStatus;
If Q3View_EndWriting returns kQ3ViewStatusDone, the writing has been completed and the specified view is no longer in writing mode. At that point, it is safe to exit your writing loop.

If Q3View_EndWriting returns kQ3ViewStatusRetraverse, the writing has not yet been completed. You should respecify the model by reentering your writing loop.

If Q3View_EndWriting returns kQ3ViewStatusError, the writing has failed because the renderer associated with the view encountered an error in processing the model. You should exit the writing loop.

If Q3View_EndWriting returns kQ3ViewStatusCancelled, the writing has been canceled. You should exit the writing loop.

SPECIAL CONSIDERATIONS
You should call Q3View_EndWriting only if writing is already occurring.


Previous Book Contents Book Index Next

© Apple Computer, Inc.
11 JUL 1996




Navigation graphic, see text links

Main | Top of Section | What's New | Apple Computer, Inc. | Find It | Feedback | Help