Functional specification
121
CDE/Motif PST
CDEnext
9.4
Attribute Concepts
Much of the functionality of the Xp system is controlled via the setting of various
attributes
. The
attributes both describe the capabilities of the printer, and allow the user and/or the application to control
many aspects of the printed output. Most of the attributes are defined in the ISO 10175 and POSIX 1387.4
standards, and are broken into a few different pools.
9.4.1
Server Attributes
These attributes are read-only to the driver. They are created and initialized when the server is initialized,
and remain unchanged until the server recycles or is restarted.
9.4.2
Printer Attributes
These attributes are writable only by the print driver. An application can only read these values, as they are
a description of the capabilities of the printer and driver combination. These attributes include a
description of the available and supported media types, and the supported page description languages
among others.
9.4.3
Document Attributes
These attributes describe such things as the media to use for the document, the "plex" to use, and the
orientation (i.e. portrait or landscape). These attributes can be read and written by both the application and
the driver. Default values for these attributes are set by the driver (possibly using the provided utility
routines) when a new print context is initialized. The user or application can modify these attributes to
communicate such choices to the driver. It is the driver's responsibility to communicate these attributes to
the specific printer, presumably by embedding the appropriate page description language strings in the
output. Changes in these attributes may cause the driver to perform operations such as resizing a window
referenced by a subsequent
StartPage
to fit the specified media size or orientation.
9.4.4
Page Attributes
These are a subset of the document attributes which can be varied on a page-by-page basis. This allows,
for example, an application to print a particular page in landscape orientation in the middle of a document
which is otherwise in portrait orientation. These attributes can be read and written by both the application
and the driver. It is the driver's responsibility to communicate these attributes to the specific printer,
typically by embedding the appropriate page description language strings in the output. Changes in these
attributes may cause the driver to perform operations such as resizing a window to fit the specified media
size or orientation when
StartPage
is executed.
9.4.5
Job Attributes
These control the functioning of the spooler itself, allowing the specification of items such as the banner
page contents. These attributes can be read and written by both the application and the driver, however the
driver should be able to be blissfully unaware of these attributes if the driver chooses to utilize the
XpSubmitJob
call documented below. These attributes are ignored if the client specifies the
save_data
field to be
XPGetData
in its call to
StartJob
.