TweetFollow Us on Twitter

Customizing Desktop Printer Util

Volume Number: 13 (1997)
Issue Number: 11
Column Tag: develop

Customizing Desktop Printer Utility

by Brendan Galten and Ingrid Kelly, Apple Computer, Inc.

In the current LaserWriter 8 driver, the Chooser lists printers which are available on the AppleTalk network (either LocalTalk or AppleTalk) with an NBP type of "LaserWriter." When the user selects one of these printers, LaserWriter 8 creates a desktop printer by sending an Apple Event to the Finder. In the past, this mechanism of setting up printers has served the needs of most users. However, with LaserWriter 8.5.1, Apple is responding to several requests for more flexible desktop printing functionality. To this end, Apple has introduced a new application called Desktop Printer Utility which enables users to create additional types of desktop printers. Users can now create desktop printers which use the Unix lpr protocol for printing, in addition to the regular AppleTalk PAP printers. There are also "hold" printers which represent local print queues and "virtual" printers which represent printers which are not available on the network.

Along with the expanded capabilities, Desktop Printer Utility is also customizable. LaserWriter 8.5.1 and Desktop Printer Utility (together) support the creation and use of desktop printers known as Custom DTPs. When printed to, Custom DTPs cause the LaserWriter 8.5.1 driver to create a PostScript file and to launch an application that can post-process the PostScript. This post-processing application can do anything it likes with the PostScript file, such as converting the PostScript into another file format, transferring the file to another location using a modem or a network connection, or displaying the PostScript file to the user. This article describes how a developer might customize Desktop Printer Utility for use with an application.

Customizing the DTP Utility

In order to add a new custom DTP to the list of supported DTPs in Desktop Printer Utility, you must add resources to the utility's resource fork. Desktop Printer Utility contains templates to ease the creation of these resources.

'CsDs'(CustomDTPResource) Resource

In order to customize Desktop Printer Utility, a 'CsDs' (CustomDTPResource) resource must be added to Desktop Printer Utility. The LaserWriter uses this information to find the appropriate application to launch and to customize your DTP interface.

The resource's format is defined by the structure 'CustomAppDesc:'

#define kVariableLen 1

struct CustomAppDesc{
    OSType appSignature;    
    Str255 docType;    
    Str255 helpText;    
    Str255 usage;      
    Str255 appFileName;     
    short numOfHintsFollow;  
    HintRsrcSpec hintRsrc[kVariableLen];  
};
typedef struct CustomAppDesc CustomAppDesc;
  • appSignature: The application signature of the application to launch. The LaserWriter driver uses this information to find the application on all mounted volumes which are available to the user.
  • docType: A string that describes the type of custom DTP. This string appears in the list of document types when "New" menu is selected. This string is highlighted in Figure 1.
  • helpText: This string appears when your custom DTP is selected. This string will appear in the "New" dialog field just below the DTP choices. This string appears as 'Custom DTP Example Help Text' in Figure 1.
  • usage: A string that describes the usage of your custom DTP. This string appears as 'Custom DTP Example Usage string' in Figure 2.
  • appFileName: The name of the application to launch. The LaserWriter driver uses this information to find the application on disks which are available to the user as well as to provide error messages to the user (e.g. "SurfWriter could not be launched due to insufficient memory").
  • numOfHintsFollow: The number of hints provided in the hintRsrc array. See the 'Hints Resources' section for more details.
  • hintRsrc: An array of hints that outlines the kind of PostScript that should be generated by the driver. See the 'Hints Resources' section for more details.

Figure 1.

Figure 2.

Hints Resources (optional)

The CustomDTPResource can provide 'hints' about the PostScript the driver should generate. Each 'CustomDTPResource' contains the field 'numOfHintsFollow' which represents the number of 'hints' provided. The 'hints' data is placed in an array that contains 'numOfHintsFollow' number of copies of the structure:

  struct HintRsrcSpec{
    OSType rsrcType;    
    short rsrcID
  };
  typedef struct HintRsrcSpec HintRsrcSpec;

Each entry in the array points to a resource which is converted to a hint in the driver's preferences. The hint resource types, which are currently supported, have the following formats:

/* PostScript Level */

The application that postprocesses the PostScript for a custom DTP may require or prefer a certain PostScript level. The 'pslv' hint specifies the desired PostScript level.

Resource type 'PSlv' 
typedef struct{
    OSType hintType;      //'pslv' hint type
    long hintId;        // set to 1
    long psLevel;
}PSlvResource;

#define kHintLanguageLevelTag  'pslv'
#define kHintLanguageLevelId  1

The possible(current) values for psLevel which can be set are:

  -3,  Level 2 and 3 
  -2,  Level 1 and 2 
  -1,  Unknown Level 
   0,  Other Level     //do not use
   1,  Level 1 
   2,  Level 2 
   3   Level 3

Note: -3 will create PostScript that takes advantage of PostScript level 2 and level 3 printers, but the data may fail on a level 1 printer. -2 will create PostScript that will succeed on level 1, 2, and 3 printers.

/* Binary OK - 'bnok' */

This hint allows or disallows the use of binary data in the PostScript file.

Resource type 'BNok' 
typedef struct{
    OSType hintType;    //'bnok' hint type
    long hintId;        // set to 1
    TriState binaryOK;      
}BNokResource;

#define kHintADOIsBinaryOKTag  'bnok'
#define kHintADOIsBinaryOKId  1

There are three acceptable settings for binaryOK which answer the question, "Is binary data ok?":

   0,    False
   1,    True
   2     Unknown     //do not use

Note: This hint should not be created in the DTP with a value of unknown; however, it is available for future use.

/* Job Type - 'jobt' */

This hint specifies the type of PostScript to generate.

Resource type 'JObt' 
typedef struct{
    OSType hintType;    //'jobt' hint type
    long hintId;        // set to 1
    char jobType;      
}JObtResource;

#define kHintJobTypeTag   'jobt'
#define kHintJobTypeId    1

Currently only two PostScript forms for jobType are available:

    0,  psJobPostScript 
    1   psJobEPSNoPreview

/* Font Handling - 'font' */

This hint specifies the font inclusion. The font handling hint consists of a four-byte flag followed by a list of NULL terminated font names.

Resource type 'FOnt'
typedef struct{
    OSType hintType;      //'font' hint type
    long hintId;          //set to 1
    long tag;    
    unsigned char name[1];  
}FOntResource;

#define kHintIncludeFontsTag    'font'
#define kHintIncludeFontsId      1

The possible values for tag are:

    0,  kIncludeNoFontsOtherThan
    1   kIncludeAllFontsBut

If the flag is 'kIncludeNoFontsOtherThan', the utility will only include the font definitions of fonts that are listed after the flag. If there are no font names after the flag, no font resources are included in the output. If the flag is 'kIncludeAllFontsBut', font resources are included in the output unless the font names are listed. To include all fonts, use the 'kIncludeAllFontsBut' flag with no fonts listed afterwards.

Sample Custom DTP

Following is a sample of a custom DTP that excludes Courier and Helvetica from the PostScript file via a 'CsDs' and 'FOnt' resource. This sample is intended to give developers an idea of how easy it is to customize the DTP Utility. The first step towards adding the Custom DTP is to create a hint resource of the correct type. The example shown is the 'FOnt' resource which provides data about font inclusion.

Figure 3.

The second step is to associate the hint with a particular DTP by adding hint resource information to the 'CsDs' resource for a particular DTP.

Figure 4.

And that's all that is required to get the DTP Utility to create a custom DTP that produces a PostScript file without Courier and Helvetica.

Limitations of the DTP Utility

Due to the parallel development schedules of Mac OS 8.0 and LaserWriter 8.5.1, DTP Utility 1.0 (which ships with LaserWriter 8.5.1) will not install on Mac OS 8.0. It will, however, work with Mac OS 8.1, due out in Fall of 1997.

Licensing the DTP Utility

In order to ship a customized DTP Utility with your application, you must license the DTP Utility from Apple. Please contact Apple's Software Licensing group (sw.license@apple.com or 512-919-2645) for more information.

Summary

This article has described and demonstrated all that is necessary for you to customize Desktop Printer Utility. We encourage all developers to give this a try.

Further References

  • 'Introducing the LaserWriter Driver Version 8.5.1' by Ingrid Kelly in this issue of MacTech.

Acknowledgements

Thanks to Leticia Alarcon, John Blanchard, Richard Blanchard, Paul Danbold and David Gelphman.


Brendan Galten is a software engineer with RBI Software Systems in Berkeley, Ca. He resides in Petaluma, Ca. When not writing software, he enjoys spending time with his beautiful wife, Rosemary, and making sure his 9 month old daughter, Kelly, doesn't eat bugs. Camping, fishing and woodworking occupy what little time is left.

Ingrid Kelly is a technical support engineer at Apple Computer. She and her husband, Lance, are constantly in search of the best new restaurants in the San Francisco Bay Area. One day, they may decide to leave the computer industry altogether and open one of these great restaurants themselves. For now, though, they are content helping Silicon Valley grow.

 
AAPL
$98.38
Apple Inc.
+0.00
MSFT
$43.89
Microsoft Corpora
+0.00
GOOG
$585.61
Google Inc.
+0.00

MacTech Search:
Community Search:

Software Updates via MacUpdate

Drive Genius 3.2.4 - Powerful system uti...
Drive Genius is an OS X utility designed to provide unsurpassed storage management. Featuring an easy-to-use interface, Drive Genius is packed with powerful tools such as a drive optimizer, a... Read more
Vitamin-R 2.15 - Personal productivity t...
Vitamin-R creates the optimal conditions for your brain to work at its best by structuring your work into short bursts of distraction-free, highly focused activity alternating with opportunities for... Read more
Toast Titanium 12.0 - The ultimate media...
Toast Titanium goes way beyond the very basic burning in the Mac OS and iLife software, and sets the standard for burning CDs, DVDs, and now Blu-ray discs on the Mac. Create superior sounding audio... Read more
OS X Yosemite Wallpaper 1.0 - Desktop im...
OS X Yosemite Wallpaper is the gorgeous new background image for Apple's upcoming OS X 10.10 Yosemite. This wallpaper is available for all screen resolutions with a source file that measures 5,418... Read more
Acorn 4.4 - Bitmap image editor. (Demo)
Acorn is a new image editor built with one goal in mind - simplicity. Fast, easy, and fluid, Acorn provides the options you'll need without any overhead. Acorn feels right, and won't drain your bank... Read more
Bartender 1.2.20 - Organize your menu ba...
Bartender lets you organize your menu bar apps. Features: Lets you tidy your menu bar apps how you want. See your menu bar apps when you want. Hide the apps you need to run, but do not need to... Read more
TotalFinder 1.6.2 - Adds tabs, hotkeys,...
TotalFinder is a universally acclaimed navigational companion for your Mac. Enhance your Mac's Finder with features so smart and convenient, you won't believe you ever lived without them. Tab-based... Read more
Vienna 3.0.0 RC 2 :be5265e: - RSS and At...
Vienna is a freeware and Open-Source RSS/Atom newsreader with article storage and management via a SQLite database, written in Objective-C and Cocoa, for the OS X operating system. It provides... Read more
VLC Media Player 2.1.5 - Popular multime...
VLC Media Player is a highly portable multimedia player for various audio and video formats (MPEG-1, MPEG-2, MPEG-4, DivX, MP3, OGG, ...) as well as DVDs, VCDs, and various streaming protocols. It... Read more
Default Folder X 4.6.7 - Enhances Open a...
Default Folder X attaches a toolbar to the right side of the Open and Save dialogs in any OS X-native application. The toolbar gives you fast access to various folders and commands. You just click... Read more

Latest Forum Discussions

See All

Note Review
Note Review By Jennifer Allen on July 29th, 2014 Our Rating: :: TOO SIMPLEiPhone App - Designed for the iPhone, compatible with the iPad Note is a note taking app that’s a little too short on features to be worth its asking price... | Read more »
Chainsaw Warrior Goes on Sale & Ther...
Chainsaw Warrior Goes on Sale & There’s a Chance to Win a Copy of the Original Board Game Posted by Jennifer Allen on July 29th, 2014 [ permalink | Read more »
It Came From Canada: Tiny Tower Vegas
If you go to a casino, you might make a lot of money. If you run a casino, you’re guaranteed to make a lot of money. The choice seems pretty obvious. So while waiting for your shady real estate deals to move forward, get prepared with Tiny Tower... | Read more »
Z Hunter Review
Z Hunter Review By Lee Hamlet on July 29th, 2014 Our Rating: :: RIGHT ON TARGETUniversal App - Designed for iPhone and iPad While it might not necessarily break new ground, Z Hunter has enough tricks up its sleeve to ensure that... | Read more »
Huge Update Comes To Duet, Adding 48 New...
Huge Update Comes To Duet, Adding 48 New Stages Posted by Jennifer Allen on July 29th, 2014 [ permalink ] Universal App - Designed for iPhone and iPad | Read more »
Sharknado: The Video Game Available Now....
Sharknado: The Video Game Available Now. Seriously. Posted by Rob Rich on July 29th, 2014 [ permalink ] Universal App - Designed for iPhone and iPad | Read more »
Frog Orbs 2 Review
Frog Orbs 2 Review By Nadia Oxford on July 29th, 2014 Our Rating: :: THIS MAGIC IS A TAD MONOTONOUS Universal App - Designed for iPhone and iPad Frog Orbs 2 is repetitive, but younger players should enjoy it nonetheless.   | Read more »
Puzzix Review
Puzzix Review By Jennifer Allen on July 29th, 2014 Our Rating: :: NICE IDEAUniversal App - Designed for iPhone and iPad A little like Tetris, Puzzix is all about piecing together blocks and watching them vanish. It could do with... | Read more »
Cannonball eMail is Now Live – Works Wit...
Cannonball eMail is Now Live – Works With Gmail, Yahoo, Outlook, Hotmail, and AOL Posted by Jessica Fisher on July 29th, 2014 [ permalink ] | Read more »
To The End Review
To The End Review By Lee Hamlet on July 29th, 2014 Our Rating: :: A VICIOUS CYCLEUniversal App - Designed for iPhone and iPad To The End will test players’ patience, timing, and dedication as they try to navigate all 13 levels in... | Read more »

Price Scanner via MacPrices.net

WaterField Unveils 15″ Outback Solo & 13″...
Hard on the heels of Apple’s refreshed MacBook Pro Retina laptops announcement, WaterField Designs has unveiled a 15-inch version of the waxed-canvas and leather Outback Solo and a 13-inch version of... Read more
New Roxio Toast 12 Delivers Digital Media Pow...
Roxio Toast 12 is a hub for sharing digital media to virtually any platform or device. has introduced two new additions to its Roxio Toast product family – Roxio Toast 12 Titanium and Roxio Toast 12... Read more
The lowest prices on leftover Retina MacBook...
Best Buy has dropped prices on leftover 13″ and 15″ Retina MacBook Pros by up to $300 off original MSRP on their online store for a limited time. Choose free local store pickup (if available) or free... Read more
Apple Updates MacBook Pro with Retina Display...
Apple today updated its MacBook Pro with Retina display with faster processors and double the amount of memory in both entry-level configurations. MacBook Pro with Retina display features a Retina... Read more
Up to $250 price drop on leftover 15-inch Mac...
B&H Photo has dropped prices on 2013 15″ Retina MacBook Pros by as much as $250 off original MSRP. Shipping is free, and B&H charges NY sales tax only: - 15″ 2.3GHz Retina MacBook Pro: $2349... Read more
Updated MacBook Pro Price Trackers
We’ve updated our MacBook Pro Price Trackers with the latest information on prices, bundles, and availability on the new 2014 models from Apple’s authorized internet/catalog resellers as well as... Read more
Apple updates MacBook Pros with slightly fast...
Apple updated 13″ and 15″ Retina MacBook Pros today with slightly faster Haswell processors. 13″ models now ship with 8GB of RAM standard, while 15″ MacBook Pros ship with 16GB across the board. Most... Read more
Apple drops price on 13″ 2.5GHz MacBook Pro b...
The Apple Store has dropped their price for the 13″ 2.5GHz MacBook Pro by $100 to $1099 including free shipping. Read more
Apple drops prices on refurbished 2013 MacBoo...
The Apple Store has dropped prices on Apple Certified Refurbished 13″ and 15″ 2013 MacBook Pros, with model now available starting at $929. Apple’s one-year warranty is standard, and shipping is free... Read more
iOS 8 and OS X 10.10 To Support DuckDuckGo As...
Writing for Quartz, Dan Frommer reports that Apple’s forthcoming iOS 8 and OS X 10.10 operating systems version updates will allow users to select DuckDuckGo as their default search engine. He notes... Read more

Jobs Board

Sr Software Lead Engineer, *Apple* Online S...
Sr Software Lead Engineer, Apple Online Store Publishing Systems Keywords: Company: Apple Job Code: E3PCAK8MgYYkw Location (City or ZIP): Santa Clara Status: Full Read more
*Apple* Solutions Consultant (ASC) - Apple (...
**Job Summary** The ASC is an Apple employee who serves as an Apple brand ambassador and influencer in a Reseller's store. The ASC's role is to grow Apple Read more
Sr. Product Leader, *Apple* Store Apps - Ap...
**Job Summary** Imagine what you could do here. At Apple , great ideas have a way of becoming great products, services, and customer experiences very quickly. Bring Read more
*Apple* Solutions Consultant (ASC) - Apple (...
**Job Summary** The ASC is an Apple employee who serves as an Apple brand ambassador and influencer in a Reseller's store. The ASC's role is to grow Apple Read more
*Apple* Solutions Consultant (ASC) - Apple (...
**Job Summary** The ASC is an Apple employee who serves as an Apple brand ambassador and influencer in a Reseller's store. The ASC's role is to grow Apple Read more
All contents are Copyright 1984-2011 by Xplain Corporation. All rights reserved. Theme designed by Icreon.