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.

 

Community Search:
MacTech Search:

Software Updates via MacUpdate

xScope 4.1.2 - Onscreen graphic measurem...
xScope is powerful set of tools that are ideal for measuring, inspecting, and testing on-screen graphics and layouts. Its tools float above your desktop windows and can be accessed via a toolbar,... Read more
MacFamilyTree 7.3.3 - Create and explore...
MacFamilyTree gives genealogy a facelift: it's modern, interactive, incredibly fast, and easy to use. We're convinced that generations of chroniclers would have loved to trade in their genealogy... Read more
Skype 7.5.0.738 - Voice-over-internet ph...
Skype allows you to talk to friends, family and co-workers across the Internet without the inconvenience of long distance telephone charges. Using peer-to-peer data transmission technology, Skype... Read more
PushPal 3.0 - Mirror Android notificatio...
PushPal is a client for Pushbullet, which automatically shows you all of your phone's notifications right on your computer. This means you can see who's calling or read text messages even if your... Read more
Logic Pro X 10.1.1 - Music creation and...
Apple Logic Pro X is the most advanced version of Logic ever. Sophisticated new tools for professional songwriting, editing, and mixing are built around a modern interface that's designed to get... Read more
VLC Media Player 2.2.0 - 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
Sound Studio 4.7.8 - Robust audio record...
Sound Studio lets you easily record and professionally edit audio on your Mac. Easily rip vinyls and digitize cassette tapes, or record lectures and voice memos. Prepare for live shows with live... Read more
LibreOffice 4.4.1.2 - Free, open-source...
LibreOffice is an office suite (word processor, spreadsheet, presentations, drawing tool) compatible with other major office suites. The Document Foundation is coordinating development and... Read more
VueScan 9.5.03 - Scanner software with a...
VueScan is a scanning program that works with most high-quality flatbed and film scanners to produce scans that have excellent color fidelity and color balance. VueScan is easy to use, and has... Read more
Freeway Pro 7.0.3 - Drag-and-drop Web de...
Freeway Pro lets you build websites with speed and precision... without writing a line of code! With its user-oriented drag-and-drop interface, Freeway Pro helps you piece together the website of... Read more

It Came From Canada: Jurojin: Immortal N...
At this point it’s pretty safe to say that no MOBA is going to dethrone Dota 2 and League of Legends anytime soon. After all, if Batman can’t do it, nobody can. However, with a genre as popular and profitable as this one, there’s still room for... | Read more »
Tiny Farm – Animals, Tractors and Advent...
Tiny Farm – Animals, Tractors and Adventures! Review By Amy Solomon on March 3rd, 2015 Our Rating: :: LIVELY LANDSCAPESUniversal App - Designed for iPhone and iPad Tiny Farm – Animals, Tractors and Adventures! includes farm-related... | Read more »
This Week at 148Apps: February 23-27, 20...
Final February Fun at 148Apps   How do you know what apps are worth your time and money? Just look to the review team at 148Apps. We sort through the chaos and find the apps you’re looking for. The ones we love become Editor’s Choice, standing out... | Read more »
GDC 2015 – Does Not Commute is Definitel...
GDC 2015 – Does Not Commute is Definitely a Game You Should Keep an Eye on Posted by Rob Rich on March 2nd, 2015 [ permalink ] We were teased about Mediocre Games’ (Smash Hit, | Read more »
F84 Games & POW! Announce Stan Lee V...
F84 Games has announced that it is working with legendary comic creator Stan Lee and POW! Entertainment to produce Stan Lee’s Hero Command. The game will be a action adventure of heroic proportions. | Read more »
Setlyst Keeps Your Set Straight So You C...
Setlyst Keeps Your Set Straight So You Can Focus On Rocking Out. Posted by Jessica Fisher on March 2nd, 2015 [ permalink ] Universal App - Designed for iPhone and iPad | Read more »
Space is Vast, So Space Agency Has a Vas...
Space is Vast, So Space Agency Has a Vast New Update! Posted by Jessica Fisher on March 2nd, 2015 [ permalink ] Universal App - Designed for iPhone and iPad | Read more »
Size DOES Matter Review
Size DOES Matter Review By Campbell Bird on March 2nd, 2015 Our Rating: :: HARD TO BEATUniversal App - Designed for iPhone and iPad This rhythm game has a unique control scheme and performance system that make it feel like a true... | Read more »
The first ever action 3D card battler Al...
On the other hand, you probably haven’t played an action 3D card battler – until now. Step forward, All Star Legion. All Star Legion is a 3D QTE-based action RPG card battler, but fear not – the game itself isn’t as convoluted as its description.... | Read more »
Travel Back to the 1980s With the Making...
Headup Games has released a hilarious making of video for its upcoming title, Pixel Heroes: Byte & Magic. The game is a RPG/Roguelike where you control three heroes set to save the township of Pixton from an evil cult called The Sons of Dawn.... | Read more »

Price Scanner via MacPrices.net

Sale! 15-inch 2.2GHz Retina MacBook Pro for $...
 Best Buy has the 15″ 2.2GHz Retina MacBook Pro on sale for $1774.99 $1799.99, or $225 off MSRP. Choose free home shipping or free local store pickup (if available). Price valid for online orders... Read more
27-inch 3.5GHz 5K iMac in stock today and on...
 B&H Photo has the 27″ 3.5GHz 5K iMac in stock today and on sale for $2299 including free shipping plus NY sales tax only. Their price is $200 off MSRP, and it’s the lowest price available for... Read more
Apple Launches Free Web-Based Pages and Other...
Apple’s new Web-only access to iWork productivity apps is a free level of iCloud service available to anyone, including people who don’t own or use Apple devices. The service includes access to Apple... Read more
Survey Reveals Solid State Disk (SSD) Technol...
In a recent SSD technology use survey, Kroll Ontrack, a firm specializing in data recovery, found that while nearly 90 percent of respondents leverage the performance and reliability benefits of SSD... Read more
Save up to $600 with Apple refurbished Mac Pr...
The Apple Store is offering Apple Certified Refurbished Mac Pros for up to $600 off the cost of new models. An Apple one-year warranty is included with each Mac Pro, and shipping is free. The... Read more
Updated Mac Price Trackers
We’ve updated our Mac Price Trackers with the latest information on prices, bundles, and availability on systems from Apple’s authorized internet/catalog resellers: - 15″ MacBook Pros - 13″ MacBook... Read more
Apple CEO Tim Cook to Deliver 2015 George Was...
Apple CEO Tim Cook will deliver the George Washington University’s Commencement address to GWU grads on May 17, at which time he will also be awarded an honorary doctorate of public service from the... Read more
Apple restocks refurbished Mac minis for up t...
The Apple Store has restocked Apple Certified Refurbished 2014 Mac minis, with models available starting at $419. Apple’s one-year warranty is included with each mini, and shipping is free: - 1.4GHz... Read more
Save up to $50 on iPad Air 2s, NY tax only, f...
 B&H Photo has iPad Air 2s on sale for $50 off MSRP including free shipping plus NY sales tax only: - 16GB iPad Air 2 WiFi: $469.99 $30 off - 64GB iPad Air 2 WiFi: $549 $50 off - 128GB iPad Air 2... Read more
16GB iPad Air 2 on sale for $447, save $52
Walmart has the 16GB iPad Air 2 WiFi on sale for $446.99 on their online store for a limited time. Choose free shipping or free local store pickup (if available). Sale price for online orders only,... Read more

Jobs Board

*Apple* Solutions Consultant - Retail Sales...
**Job Summary** As an Apple Solutions Consultant (ASC) you are the link between our customers and our products. Your role is to drive the Apple business in a retail Read more
*Apple* Pay Automation Engineer - iOS System...
**Job Summary** At Apple , great ideas have a way of becoming great products, services, and customer experiences very quickly. Bring passion and dedication to your job Read more
Sr. Technical Services Consultant, *Apple*...
**Job Summary** Apple Professional Services (APS) has an opening for a senior technical position that contributes to Apple 's efforts for strategic and transactional Read more
Event Director, *Apple* Retail Marketing -...
…This senior level position is responsible for leading and imagining the Apple Retail Team's global engagement strategy and team. Delivering an overarching brand Read more
*Apple* Pay - Site Reliability Engineer - 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
All contents are Copyright 1984-2011 by Xplain Corporation. All rights reserved. Theme designed by Icreon.