Legacy Document

Inside Macintosh: Apple Guide Complete / Part 4 - Scripting Guide Files

Chapter 10 - Guide Script Command Reference / Guide Script Command Descriptions

/ Specifying the Startup Window

<App Logo>

You can use the <App Logo> command to specify a file containing a picture that Apple Guide displays in the upper-left corner of a Full Access window.

<App Logo> colorLogo [, B&WLogo ]

colorLogo

The name of a file containing a color 'PICT' graphic; this graphic should help identify this guide file (for example, the application's logo) to the user.

B&WLogo

The name of a file containing a black-and-white 'PICT' graphic; this graphic should help identify this guide file (for example, the application's logo) to the user. This parameter is optional.

DESCRIPTION

Guide Maker imports the 'PICT' resource from the file referenced by the parameter colorLogo and assigns it the resource ID 501, which is the resource ID reserved for this special graphic. If provided, Guide Maker also imports the 'PICT' resource from the file referenced by the parameter B&WLogo and assigns it the resource ID 502, which is the resource ID reserved for this special graphic. Note that the files containing the graphics should be located in the same folder as your help sources.

As an alternative to using the <App Logo> command, you can assign your application's logos resource IDs of 501 and 502 and then import them using the <Resource> command.

The file Standard Resources is provided with Guide Maker. This file contains templates (two 'PICT' resources with IDs 501 and 502) that you can use to create your application logo picture. You should incorporate the lightbulb icon with your application logo and also use your application's name followed by the word Guide, as shown in Macintosh Guide and SurfWriter Guide.

Apple Guide displays the graphic defined by the <App Logo> command in the upper-left corner of a Full Access window. Note that you can include text in the graphic you provide for the <App Logo> command. The graphic should be at most 59 by 185 pixels. If both a color picture and black-and-white picture are provided, Apple Guide displays the color picture unless the monitor's bit depth is set to 4 bits or less.

SPECIAL CONSIDERATIONS

The <App Logo> command should appear once at most in your source files for a specific guide file. If you omit this command (and the <App Text> command), Apple Guide displays the default access window background in the upper-left corner of the Full Access window.

You should specify either the <App Logo> or <App Text> command for your guide file, but not both.

EXAMPLES

#directly specify your application logo
<App Logo> "SurfWriter ColorLogo", "SurfWriter B&WLogo"
#or, import PICT resources with resource IDs 501 & 502
<Resource> "Standard Resources", ALL

SEE ALSO

For information on the <Resource> command, see page 10-101. The <App Text> command is described next.