TweetFollow Us on Twitter

Jul 97 - Macintosh Q and A

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

Jul 97 - Macintosh Q & A

by Apple Developer Support Center

Q: FindSymbol returns a paramErr if I pass it a symbol name with a length greater than 64 characters, yet the documentation and interfaces specify that I pass the address of a Str255. What gives?

A: This is a known bug, and has been fixed as of System 7.5.5. You should either make sure the System version is 7.5.5 or later, or keep your symbol name lengths to 64 or fewer characters.


Q: Any time I try to load a shared library that has a nonzero implementation version number with GetSharedLibrary, CFM returns a fragTooNew error. Why?

A: This is a bug in CFM that was fixed in System 7.5.5. If you need a nonzero implementation version number, you'll have to be sure to run only on System 7.5.5 or later. Otherwise, make your library's implementation version number 0.


Q: I've been reading the documentation on the Resource Manager and I can't seem to find an unequivocal statement about whether resource IDs should be unique within a single resource type in a given resource file. Some documentation seems to suggest it's OK to have duplicate resource IDs as long as my program doesn't expect to be able to find resources by ID later. What's the real story?

A: You're right; during a recent extensive survey of our documentation (Inside Macintosh old and new editions, Technotes, and so on), we found that some of the discussions of resource IDs were less than perfectly clear on this topic.

The real story is that resource IDs should be unique within a single resource type within a given resource file. When you're adding resources to a resource file, you might want to use UniqueID or Unique1ID to help you find unique resource IDs.

However, some resource files do contain multiple resources with the same type and ID. This can be due to bugs in the program that created the file or to the aforementioned ambiguity in the documentation. When reading resource files your program didn't create, make sure you can gracefully handle such files.

Regardless of what you may read in other documentation, the Resource Manager in some versions of the Mac OS may behave unpredictably when reading files that have multiple resources with the same type and ID.

One easy way to detect whether a given file contains multiple resources with the same type and ID is to open the file with Resorcerer or ResEdit. These programs will warn you if they detect this condition.


Q: What's the logic behind the Create/Update preview behavior in the SFPGetFilePreview dialog? If I create previews for QuickTime movies I sometimes get preview movies and sometimes get preview pictures. With QuickTime movies that already have previews I sometimes get an Update button and sometimes get a dimmed Create button. What determines the behavior?

A: PICT files (or files that QuickTime can import as PICT via the new graphic import components) don't have durations, so they can only have a preview PICT in the Standard File Preview dialog. Movies can have both a poster PICT and a movie preview.

When a movie or PICT file is selected in the dialog, the preview component will first see if a preview already exists in the file, stored in a 'pnot' resource. The 'pnot' resource also identifies whether the preview is a PICT, a movie, or whatever. The preview component then compares a timestamp in the 'pnot' resource to the modification date of the selected file to see if the preview is current. If the 'pnot' date is older than the last modified date of the file, the dialog will show the Update button (and will create the new preview with the 'pmak' components if the user selects this option).

If no 'pnot' resource is found in the selected file, and a 'pmak' component exists that can create a preview for the selected file type (QuickTime 2.5 supplies PICT, MOOV, and QTIF 'pmak' components), the Create button will be active in the dialog.

Note that sound files preview in a slightly different way. The 'pnot' components create an automatic 10-second preview (if there's that much sound) for supported sound file types without needing a 'pnot' resource in the file.

You can read more about preview components in Inside Macintosh:QuickTime Components.


Q: I've saved files to disk in both foreground and background printing modes with LaserWriter 8.4.1, and the file size is always the same. I'd expect the size of the background image to be smaller as a result of compression and two-pass optimizations. Why don't I get different-size PostScript files?

A: LaserWriter 8.4 (and all other 8.x versions) always saves to disk in two passes, hence the foreground and background files you see are the same size. If we didn't do this, we would generate non-DSC compliant PostScript jobs when saving to disk in the foreground. If you really want to check the PostScript code being sent to the printer, you should turn on the papToDisk bit in the driver's 'PRFS' resource. This creates papToDisk files that capture the data going to and coming from the printer.


Q: I'm trying to find a way for my application to determine whether it's using a PostScript printer. For performance reasons, I'd like to send custom PostScript code instead of a PICT to the printer if I can. Is there an API to find out whether the currently selected printer is a PostScript printer?

A: There's no good way of doing this. For Apple's LaserWriter drivers, you can, if you must, look at the wDev field in the print record of the currently selected printer. Here's a quote that's hidden in Technote QD 10, "Picture Comments - The Real Deal":

The high byte of the prStl.wDev field of the print record identifies a printer driver species; a value of $03 tells you that the printer driver belongs to the PostScript LaserWriter driver ancestry...

However, although the Apple LaserWriter driver has a wDev of 3, other printer drivers for PostScript devices may not, so this is not a complete solution for detecting PostScript printers. Further, it's not recommended that you use the wDev field to distinguish between printer drivers at all; see the Print Hints column in this issue of develop for more on this.


Q: I'm using the code from page 4-16 of Inside Macintosh: Processes to animate the cursor at VBL time, but it crashed (with the stack crawl indicating SetCursor as the culprit). What's up?

A: When hardware cursor support was added to the Mac OS (System 7.5.2 for PCI Power Macs), SetCursor started requiring A5 to refer to a valid QuickDraw globals world. Despite the fact that the code you refer to accesses no global variables, your application still needs to make sure A5 is set up for SetCursor's benefit.

An explanation of setting up A5 in a VBL task can be found on page 4-13 of Inside Macintosh: Processes.


Q: We're writing an application that requires us to connect to a remote machine via TCP/IP and talk to a background application running on that machine. However, we cannot connect to that machine when it's in sleep mode. Is there a way to keep the network services alive when a machine is in sleep mode? I've seen how you can keep the serial port alive, but not the network services.

A: When a Macintosh (usually a PowerBook) goes into the "sleep" state, it's incapable of responding to network requests; the connections actually shut down. There are some Macintosh computers, however, that will attempt to go into an energy-efficient mode know as "doze."

The sleep state is easy to prevent and is pretty well documented in the Power Manager chapter of Inside Macintosh: Devices under "The Sleep Queue" and "Sleep Procedures," and there's more information in Technote 1046, "Inside Macintosh: Devices - Power Manager Addenda," and Technote 1086, "Power Management & The Energy Saver API."

If you want to prevent the system from sleeping or dozing, you should do the following:

  1. Allocate a SleepQRec (preferably in the system heap).
  2. Set it up to call into your sleep handler.
  3. Return a nonzero value from your sleep handler when it's called. (When the Macintosh attempts to sleep or doze, your sleep handler is called with a sleepRequest or dozeRequest selector.)

In the doze state, Open Transport networking is still enabled and TCP connections that are set up should still function. But it might take several packets received within a short period (try 10 per second) to wake the machine from its doze state. You might also consider pinging the machine first to get it out of the doze state. Either way, if the machine is dozing it will take some time for the networking to reactivate, especially if virtual memory is enabled and the disk drive must spin up.


Q: I'm writing a fax client-server system and I've encountered a problem after I put the server to sleep: on waking, the server software doesn't seem to reregister on the network (using RegisterMyName). On the client side, when receiving a sleep demand I wait until network activity has ceased, then return control to the system; the client wakes and reconnects to the server with no problems. What action should I take to correct the reregistering problem?

A: In general, you might want to disable sleep on your server by informing the Power Manager with AutoSleepControl(false). Otherwise, the clients might never know that your server is sleeping, and they'll be unable to connect. But if you do want to support sleep, a server should install a sleep procedure through the Power Manager using SleepQInstall.

The exact details of how your server should handle sleep requests and sleep demands are provided in Table 6-1 on page 6-10 of Inside Macintosh: Devices. Ultimately, you close and deregister your server from the network. Later, when you get the sleepWakeUp call, you should reopen and reregister.


Q: I installed a sleep procedure, but the Power Manager will issue a sleep demand if the user selects Sleep from the Special menu. The AutoSleepControl(false) call will stop sleep requests but will it also stop sleep demands?

A: Your application cannot refuse a sleep demand, as documented in Inside Macintosh: Devices on page 6-11:

When your sleep procedure receives a sleep demand, however, your procedure has no way to determine whether it originated as a conditional sleep demand or an unconditional sleep demand. Your device driver or application must prepare for the sleep state and return control promptly to the Power Manager when it receives a sleep demand.

For AutoSleepControl, see Inside Macintosh: Devices, page 6-44:

When enableSleep is set to false, the computer will not go into the sleep mode unless it is forced to either by some user action - for example, by the user's selecting Sleep from the Special menu of the Finder - or in a low battery situation.


Q: How do I specify and control Open Transport serial port I/O handshaking? The options are a bit confusing.

A: By using the SRL_OPT_HANDSHAKE option provided by the Open Transport native interfaces, you can customize serial port handshaking in a variety of ways. For instance, you can request that input handshaking be controlled by the CTS line or by the XON/OFF sequence. The default value of this option is no handshaking.

The handshaking behavior is specified by a 4-byte unsigned integer value that's passed in with the SRL_OPT_HANDSHAKE option. The high word (16 bits) of the integer is a bitmap with one or more of the following bits set:

kOTSerialXOnOffInputHandshake       = 1
kOTSerialXOnOffOutputHandshake      = 2
kOTSerialCTSInputHandshake          = 4
kOTSerialDTROutputHandshake         = 8

The second lowest byte is the XON character value, and the lowest byte is the XOFF character value. If these values are 0, and XON/XOFF handshaking was requested, the default values of Control-S for XOFF and Control-Q for XON will be used.

An inline function (or a macro, for C users) is defined in OpenTptSerial.h for creating this 4-byte value:

OTSerialHandshakeData(UInt16 type, UInt8 onChar, UInt8 offChar)

Suppose, for instance, that you wanted to enable XON/XOFF input handshaking, but you wanted to specify that the XON character be Control-T instead of Control-Q. You would create an option structure as follows:

TOption 		opt;
opt.len = kOTFourByteOptionSize;
opt.level = XTI_GENERIC;
opt.name = SERIAL_OPT_HANDSHAKE;
opt.value =
OTSerialHandshakeData(kOTSerialXOnOffInputHandshake, 
	('T' & ~0x40),		// normally kOTSerialDefaultOnChar
	kOTSerialDefaultOffChar);

You can also control the XOFF state of the serial input port, by using the I_SetSerialXOFFState Ioctl command. A value of 0 will unconditionally clear the XOFF state, while a value of 1 will unconditionally set it:

// Set XOFF state.
OTIoctl(theSerialEndpoint, I_SetSerialXOffState, 1);

The I_SetSerialXOn Ioctl command causes the serial port to send an XON character. A value of 0 will cause it to be sent only if we're in the XOFF state, while a value of 1 will unconditionally send the character:

// Unconditionally send an XON character.
OTIoctl(theSerialEndpoint, I_SetSerialXOn, 1);

Conversely, the I_SetSerialXOFF Ioctl command causes the serial port to send an XOFF character. A value of 0 will cause it to be sent only if we're in the XON state, while a value of 1 will unconditionally send the character:

// Unconditionally send an XOFF character.
OTIoctl(theSerialEndpoint, I_SetSerialXOff, 1);

Q: A friend told me you can make really great water rockets from plastic pop bottles. Is this true?

A: Boy , howdy, is it ever! To give you an idea of how great they are, read the article "Soda Bottle Water Rockets" in Physics Teacher magazine, March 1995. Some interesting results from the article: If you launch a plain 2-liter bottle, filled with 0.7 liters of water (about 1/3 full turns out to be optimal) and pumped to 85 pounds per square inch, all the water is expelled in 0.07 seconds. At that point ("burnout") the bottle is only about 2 meters off the ground but is traveling at an incredible 76 meters per second (171 miles per hour)! That's an average acceleration of over 100 g's!

Of course, a naked bottle is aerodynamically hopeless, and tumbles fluffily after burnout. But if you add fins and some nose weight to make a stable rocket out of it, truly impressive altitudes are possible. A velocity-sensitive parachute deployment device has recently been concocted, bottle connection technology is advancing rapidly, and reliable multistage rockets are an active topic of investigation. Launching techniques range from the ultra-simple "cram a cork in it and pump 'til it blows" method to sophisticated, expensive launchers with all the bells and whistles.

For more information, see these Web sites: http://members.aol.com/aquarocket/, http://www.H2ORocket.com/, and http://www.flash.net/~berggren/rocket/.


Q: If my Web server is running along happily under Open Transport (1.1 or 1.1.1), and the listener is bound to address 0.0.0.0, what happens when someone uses the control panel and changes the IP number? Right now it appears to just make the listener go deaf. I don't appear to receive connections on the new IP number, and if I use the control panel a second time to switch back to the original IP number, I don't get connections for that IP number either. Is there some event that gets sent to the listener that I'm not looking for that tells me when this happens?

A: When a port changes its IP number, it's actually closing and reopening. When Open Transport closes a port, any endpoint that's plumbed to it is also closed, hence you'll get no further events on that endpoint.

The first thing you need to do is check for the provider events such as kOTProviderWillClose and kOTProviderIsClosed.

You should also use the OTRegisterAsClient call and register a notifier for client events, such as kOTPortDisabled, kOTPortEnabled, kOTPortOffline, kOTPortOnline, kOTClosePortRequest, kOTYieldPortRequest, and kOTNewPortRegistered.

When the interface changes, you need to close up your endpoints and rebind them.


These answers are supplied by the technical gurus in Apple's Developer Support Center. For more answers, see the Macintosh Technical Q&As on the World Wide Web at http://dev.info.apple.com/techqa/Main.html.

 

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* Watch SW Application Project Manager...
**Job Summary** The Apple Watch software team is looking for an Application Engineering Project Manager to work on new projects for Apple . The successful candidate Read more
*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
All contents are Copyright 1984-2011 by Xplain Corporation. All rights reserved. Theme designed by Icreon.