Figure 1-1 shows the calling sequence and scope requirements you need to be aware of when using session functions. The diagram shows, for example, that you can call
PMSessionEnableColorSync
only after
PMSessionBeginPage
.
In general, functions may be called in any order with respect to other functions at the same or lower scope level (represented in the diagram by indentation). This does not mean that you should call
PMSessionConvertOldPrintRecord
in the middle of your page drawing code, it simply means that the Carbon Printing Manager does not restrict you from doing so. The exception is functions relating to dialog boxes. These can be called at any time after
PMCreateSession
, except after calling
PMSessionBeginDocument
.
The universal functions
PMIsPostScriptDriver
through
PMPrinterGetLanguageInfo
are also included in the diagram, to show their scope restrictions with respect to the session functions.