---

Printing Presets File Format

The printing presets file uses XML format and can be viewed by using the PropertyListEditor application provided in the /Developer/Applications directory. Printing presets files are named using printer module’s ID with the .xml extension. For example:

com.abccompany.printer.ZQ3700.xml

where com.abccompany.printer.ZQ3700 is the printer module ID.

A printing presets file describes an array of dictionaries. Each dictionary is a collection of key-value pairs that describes a single preset value—a combination of general metadata and printer specific settings.

The preset dictionary can have the following keys:

• com.apple.print.preset.id The id of the preset. The value of this key is used to look up a localized name for the setting. The id must match an Apple-defined id. If the key does not match an Apple-defined key then the preset specified by the key will not be made available in the application’s Print dialog. The set of Apple defined keys is located in:

  /System/Library/Frameworks/ApplicationServices.framework/Frameworks/PrintCore.framework/Resources/KnownPresets.xml

  The following lists the current Apple-defined preset ids. Apple is in the process of defining additional preset ids.

  • Photo with Paper Auto-Detect

    • graphicsType - Photo

    • quality - mid

    • media-front-coating - autodetect

  • Photo with Paper Auto-Detect - Fine

    • graphicsType - Photo

    • quality - high

    • media-front-coating - autodetect

  • Photo on Plain Paper

    • graphicsType - Photo

    • quality - mid

    • media-front-coating - none

  • Photo on Plain Paper - Fine

    • graphicsType - Photo

    • quality - high

    • media-front-coating - none

  • Photo on Photo Paper

    • graphicsType - Photo

    • quality - mid

    • media-front-coating - glossy

  • Photo on Photo Paper - Fine

    • graphicsType - Photo

    • quality - high

    • media-front-coating - glossy

  • Photo on Matte Paper

    • graphicsType - Photo

    • quality - mid

    • media-front-coating - matte

  • Photo on Matte Paper - Fine

    • graphicsType - Photo

    • quality - high

    • media-front-coating - matte

• com.apple.print.preset.graphicsType The type of graphics for which this preset is tuned. The only currently defined value for this key is "Photo". The list of values for this key could expand in the near future.

• com.apple.print.preset.quality If this key is present it specifies the relative output quality of his preset. The values are "low", "mid", and "high". This is a new key and it is not used in the Apple supplied preset files in 10.1.2. In 10.1.2 this quality setting is implied by the preset id. Apple recommends that printer manufacturers include this key in their presets where appropriate.

• com.apple.print.preset.media-front-coating If present the value of this key value specifies the media coating to be used with the associated settings. Defined values include "none" (plain), "glossy", "high-gloss", "semi-gloss", "satin", "matte", and "autodetect". This is a new key and it is not used in the Apple supplied preset files in Mac OS X version 10.1.2. In version 10.1.2 the quality setting is implied by the preset id. Apple recommends that printer manufacturers include this key in their presets where appropriate.

• com.apple.print.preset.model This key is only needed by printer modules that support multiple printers where the printers have different settings; that is where a single preset can not satisfy all of the printer modules. In this case each preset can include this key to differentiate the presets for each supported printer model. If this key exists, then the preset will only be used if the value of this key matches the current printer's model.

• com.apple.print.preset.settings A dictionary containing a set of printer specific settings. When this preset is activated the key-value pairs from this dictionary are added to the current job’s print settings (PMPrintSettings). The print settings are added to a default print settings ticket. Because a printer module should treat a missing key as having a default value, the presets do not need to contain key-value pairs for default settings. You can reduce the size of the presets file by not including entries for values that are the same as printer module default values.

---