TweetFollow Us on Twitter

New PrGeneral

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

The New PrGeneral Version Opcode

by Ingrid Kelly

For the past 12 years, printer driver developers have used the print record's wDev field in the TPrStl data structure to store their device information. Specifically, they've consistently used the high-order byte of this field - commonly known as the wDev ID - to store the device code. Unfortunately, due to the design limitations of the print record and the wDev field, the Printing Manager allowed for a maximum of only 256 IDs. Surprisingly enough (ha ha), with the expansion of the printer market, we're running out of numbers! As a result, with LaserWriter driver version 8.4, we've added a PrGeneral opcode and new structures to the Printing Manager so that developers can work around this limitation.

Both printer driver and application developers need to add code to support this new information, but the changes are minimal. Accompanying this column on the MacTech Web site is a sample application, called PrGeneral Version, that shows you how to properly retrieve the new version information when your application is looking for the features of a particular printer driver.

The New PrGeneral Opcode:

kprversionop

LaserWriter driver version 8.4 introduced several new PrGeneral opcodes, including a new opcode for driver version information: kPrVersionOp. Using kPrVersionOp is now the recommended way for applications to find out the printer driver currently in use. Remember that for printer drivers that haven't updated to use this new PrGeneral opcode, your application needs to keep its wDev-checking code as well.

For more information on the extended print record opcodes introduced with LaserWriter version 8.4, read the Print Hints column "The All-New LaserWriter Driver Version 8.4" in develop Issue 27. There you'll find a table that lists all the other PrGeneral opcodes supported in Apple printer drivers. See the article "Meet PrGeneral, the Trap That Makes the Most of the Printing Manager" in develop Issue 3 for more information on PrGeneral.

What Printer Driver Developers Need to Know

From now on, Apple's Developer Support Center will assign all printer drivers a wDev ID of 255. If you have an old wDev ID number (which is less than 255), you should still use the number you were assigned so that you don't break any applications that vary their behavior based on your driver's wDev. In addition, you should implement the new kPrVersionOp opcode as described here so that new applications can take advantage of it with your driver.

Listing 1 shows the new opcode and structures that you'll need to implement in your PDEF 7 resource. You need to place your creator type in the driver.creator field of the TPrVersion structure. You should also place your version number in driver.release so that application developers know what version of the driver is available.

Listing 1. The new version opcode and structures

enum {
   ...
   kPrVersionOp = 22             // LaserWriter version 8.4 and later only
};

typedef struct {
   OSType     architecture;      // Architecture (for example, 'pwpc', 'm68k')
   OSType     creator;           // Driver's creator type (for example, 'AAPL')
   unsigned longrelease;         // Release number (for example, 0x8480)
   unsigned longinterfaces;      // Interfaces version (for example, 0x8480)
} TVersion;

typedef struct {
   short       iOpCode;          // Must be kPrVersionOp
   short       iError;           // For returning errors
   long        lReserved;        // Reserved, set to 0
   TVersion    driver;           // Driver information
   TVersion    reserved;         // Reserved, set to 0
} TPrVersion;

The release and interfaces fields have the same format as the first long in a 'vers' resource - that is, the following four 1-byte values: a major version number, a minor version number, a revision stage (development = 0x20, alpha = 0x40, beta = 0x60, and release = 0x80), and a prerelease version number.

That's all you'll need to do to support the new PrGeneral opcode in your driver - hard to believe, but true!

What Application Developers Need to Know

Although Apple doesn't recommend that application developers check the wDev field of the print record, many do. They assume that the wDev value means they can count on certain features being present in the printer. For instance, many developers assume that a wDev of 3 means the printer driver supports PostScript. In fact, it indicates only that the current printer uses the Apple LaserWriter driver. This leaves out the possibility that a user has a non-Apple PostScript printer driver with an ID of, say, 243.

Even though Apple doesn't recommend that application developers rely on the wDev field (or the new PrGeneral opcode, for that matter), if you're going to change application behavior based on the number or creator returned, at least do so properly so that your applications don't break with future releases of printer drivers. We recommend that you use the PrGeneral kPrVersionOp opcode, if available, to get the structure and then check the driver.creator and driver.release fields to determine the current printer driver and version (see Listing 1). You should also continue to support the old wDev method for printer drivers that have not yet updated to the new PrGeneral opcode. For your reference, the PrGeneral Version sample that accompanies this column shows how to properly retrieve the version and wDev information.

Go Forth and Print!

As you can see, the changes that printer driver and application developers need to make to support the new PrGeneral opcode are minimal. We've already adopted this new method with the LaserWriter version 8.4.x drivers. We hope you will, too!


WDEV Registration

Although from now on all printer drivers will be assigned a wDev ID of 255, we still request that you register your printer driver with Apple's Developer Support Center, to avoid creator type conflicts. To do so, register at http://www.devworld.apple.com/dev/wdev/. Here is the information you need to provide:

  • Company name and address
  • Contact name, phone number, and e-mail address
  • Make and model of device supported (for example, Apple LaserWriter 16/600)
  • Type of connection (for example, serial)
  • Creator type (for example, 'AAPL')

You'll receive confirmation of your registration within five to ten working days. If you have questions about wDev registration, write to devsupport@apple.com.


Related Reading

  • "Print Hints: The All-New LaserWriter Driver Version 8.4" by Dave Polaschek, develop Issue 27.
  • "Meet PrGeneral, the Trap that Makes the Most of the Printing Manager" by Pete "Luke" Alexander, develop Issue 3.

Ingrid Kelly (inge@apple.com) provides technical support for developers as a member of the Multimedia, Printing, Imaging, and Graphics group in Apple's Developer Technical Support. When she's not answering developer e-mails or trying to hold the record for most Technotes written in DTS, Ingrid can be found refilling her office candy bin, trying to come up with the ultimate chocolate chip cookie recipe, or attending Navy Blue Angels flight team demonstrations with her husband, Lance.

 

Community Search:
MacTech Search:

Software Updates via MacUpdate

OmniOutliner Pro 4.2 - Pro version of th...
OmniOutliner Pro is a flexible program for creating, collecting, and organizing information. Give your creativity a kick start by using an application that's actually designed to help you think. It's... Read more
VLC Media Player 2.2.1 - 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
Nisus Writer Pro 2.1.1 - Multilingual wo...
Nisus Writer Pro is a powerful multilingual word processor, similar to its entry level products, but brings new features such as table of contents, indexing, bookmarks, widow and orphan control,... Read more
Tinderbox 6.2.0 - Store and organize you...
Tinderbox is a personal content management assistant. It stores your notes, ideas, and plans. It can help you organize and understand them. And Tinderbox helps you share ideas through Web journals... Read more
OmniOutliner 4.2 - Organize your ideas,...
OmniOutliner is a flexible program for creating, collecting, and organizing information. Give your creativity a kick start by using an application that's actually designed to help you think. It's... Read more
Things 2.5.4 - Elegant personal task man...
Things is a task management solution that helps to organize your tasks in an elegant and intuitive way. Things combines powerful features with simplicity through the use of tags and its intelligent... Read more
NeoOffice 2014.10 - Mac-tailored, OpenOf...
NeoOffice is a complete office suite for OS X. With NeoOffice, users can view, edit, and save OpenOffice documents, PDF files, and most Microsoft Word, Excel, and PowerPoint documents. NeoOffice 3.x... Read more
iPhoto Library Manager 4.2 - Manage mult...
iPhoto Library Manager allows you to organize your photos among multiple iPhoto libraries, rather than having to store all of your photos in one giant library. You can browse the photos in all your... Read more
Web Snapper 3.3.8 - Capture entire Web p...
Web Snapper lets you capture Web pages exactly as they appear in your browser. You can send them to a file as images or vector-based, multi-page PDFs. It captures the whole Web page - eliminating the... Read more
TeamViewer 10.0.41404 - Establish remote...
TeamViewer gives you remote control of any computer or Mac over the Internet within seconds, or can be used for online meetings. Find out why more than 200 million users trust TeamViewer! Free for... Read more

Chainsaw Warrior: Lords of the Night has...
It's time to put the Darkness back in its place now that Chainsaw Warrior: Lords of the Night has officially made it to iOS. | Read more »
A World of Ice and Fire Lets You Stalk 2...
George R. R. Martin’s A World of Ice and Fire, by Random House, is a mobile guide to the epic series. The new update gives you the Journeys map feture that will let you track the movements of 25 different characters. But don't worry, you can protect... | Read more »
Gameloft Announces Battle Odyssey, a New...
Battle Odyssey, Gameloft's newest puzzle RPG, is coming to the App Store next week. Set in the world of Pondera, you will need to control the power of the elements to defend the world from evil. You'll be able to entlist over 500 allies to aid you... | Read more »
Fusion - HDR Camera (Photography)
Fusion - HDR Camera 1.0.0 Device: iOS Universal Category: Photography Price: $1.99, Version: 1.0.0 (iTunes) Description: Fusion creates HDR (high dynamic range) photos by capturing different exposures and then combining them into one... | Read more »
Sago Mini Toolbox (Education)
Sago Mini Toolbox 1.1 Device: iOS Universal Category: Education Price: $2.99, Version: 1.1 (iTunes) Description: Come build with the Sago Mini friends! Use a wrench, try a saw, or hammer some nails. From sewing hand puppets to... | Read more »
You Should Probably Grab Hitman GO While...
Hitman GO is a surprisingly cool (yet also incredibly drastic) departure from the Hitman series. It's well worth playing for any puzzle game fans out there, and at the moment you can get your hands - or garrotte if you will - on it for a mere $0.99... | Read more »
IFTTT is Bringing Do Button and Do Note...
IFTTT has announced Do Button and Do Note for the Apple Watch. Do Button lets you make your own personalized button that can connect to things like your Google Drive, control the temperature in your home with Nest Thermostat, or turn the lights on... | Read more »
How Many Days, Hours, and Minutes Are Le...
Countdown, by Yves Tscherry, is now available on the App Store. The app keeps track of countdowns to your favorite things such as someones birthday or days till the New Year. You can display the time in seconds, minutes, hours, days, weeks, months,... | Read more »
The All-New Misfit 2.0 App is Available...
Misfit has just given their app a complete overhaul. Misfit 2.0 now has a brand new interface with a sleek design and is easier to navigate. You'll be able to sync your Misfit device and look up health and fitness information faster than ever before... | Read more »
Halo: Spartan Strike (Games)
Halo: Spartan Strike 1.0 Device: iOS Universal Category: Games Price: $5.99, Version: 1.0 (iTunes) Description: Delve into 30 challenging missions through cities and jungles using a devastating arsenal of weapons, abilities and... | Read more »

Price Scanner via MacPrices.net

TigerText Introduces First Secure Enterprise...
TigerText, a provider of secure, real-time messaging for the enterprise, has announced the launch of TigerText for the Apple Watch. TigerText for the Apple Watch enables users to securely send and... Read more
The Conservation Fund Partners with Apple To...
The Conservation Fund has announced that it will partner with Apple to help protect working forests in the United States. The Apple initiative will conserve more than 36,000 acres of working... Read more
Clearance 13-inch 2.6GHz Retina MacBook Pro a...
B&H Photo has clearance 2014 13″ 2.6GHz/128GB Retina MacBook Pros now available for $1099, or $200 off original MSRP. Shipping is free, and B&H charges NY sales tax only. Read more
Apple refurbished 2014 13-inch Retina MacBook...
The Apple Store has Apple Certified Refurbished 2014 13″ Retina MacBook Pros available for up to $400 off original MSRP, starting at $979. An Apple one-year warranty is included with each model, and... Read more
iMacs on sale for up to $205 off MSRP, NY tax...
B&H Photo has 21″ and 27″ iMacs on sale for up to $205 off MSRP including free shipping plus NY sales tax only: - 21″ 1.4GHz iMac: $1019 $80 off - 21″ 2.7GHz iMac: $1189 $110 off - 21″ 2.9GHz... Read more
Sale! 16GB iPhone 5S for $1 with service
Best Buy is offering 16GB iPhone 5Ss for $1.00 with 2-year activation at a participating cellular provider. Choose free home shipping and activation, or buy online and activate during in-store pickup... Read more
Apple refurbished 2014 MacBook Airs available...
The Apple Store has Apple Certified Refurbished 2014 MacBook Airs available starting at $679. An Apple one-year warranty is included with each MacBook, and shipping is free. These are currently the... Read more
27-inch 3.5GHz 5K iMac on sale for $2349, sav...
 Adorama has the 27″ 3.5GHz 5K iMac in stock today and on sale for $2349 including free shipping plus NY & NJ sales tax only. Their price is $150 off MSRP. For a limited time, Adorama will... Read more
Save up to $380 on an iMac with Apple refurbi...
The Apple Store has Apple Certified Refurbished iMacs available for up to $380 off the cost of new models. Apple’s one-year warranty is standard, and shipping is free: - 27″ 3.5GHz 5K iMac – $2119 $... Read more
iFixIt Teardown Awards 12-IInch Retina MacBoo...
iFixIt has posted its illustrated teardown of the new 12-inch MacBook Retina. They note that this new MacBook is less than half the thickness of the last Apple notebook called just “MacBook” back in... 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* Retail - Multiple Positions (US) - A...
Sales Specialist - Retail Customer Service and Sales Transform Apple Store visitors into loyal Apple customers. When customers enter the store, you're also the Read more
Technical Project Manager - *Apple* Pay - A...
**Job Summary** Apple Pay is seeking an experienced technical PM to…manage the on boarding of new merchants for the Apple Pay platform in the US Within this role you Read more
Senior Identity Architect - *Apple* Pay - A...
**Job Summary** Apple , Inc. is looking for a highly motivated, innovative and hands-on senior identity architect to join the Apple Pay Engineering team. You will Read more
Program Manager, *Apple* Retail Global Tale...
…for the worldwide creation and implementation of the key talent development initiatives within Apple Retail. He or she will work closely with our Retail Corporate team, Read more
All contents are Copyright 1984-2011 by Xplain Corporation. All rights reserved. Theme designed by Icreon.