ShowInitIcon.c   [plain text]


// ShowInitIcon - version 1.0.1, May 30th, 1995
// This code is intended to let INIT writers easily display an icon at startup time.
// View in Geneva 9pt, 4-space tabs

// Written by: Peter N Lewis <peter@mail.peter.com.au>, Jim Walker <JWWalker@aol.com>
// and Fran├žois Pottier <pottier@dmi.ens.fr>, with thanks to previous ShowINIT authors.
// Send comments and bug reports to Fran├žois Pottier.

// This version features:
// - Short and readable code.
// - Correctly wraps around when more than one row of icons has been displayed.
// - works with System 6
// - Built with Universal Headers & CodeWarrior. Should work with other headers/compilers.

#include <Memory.h>
#include <Resources.h>
#include <Icons.h>
#include <OSUtils.h>
#include "ShowInitIcon.h"

// You should set SystemSixOrLater in your headers to avoid including glue for SysEnvirons.

// ---------------------------------------------------------------------------------------------------------------------
// Set this flag to 1 if you want to compile this file into a stand-alone resource (see note below).
// Set it to 0 if you want to include this source file into your INIT project.

#if 0
#define ShowInitIcon main
#endif

// ---------------------------------------------------------------------------------------------------------------------
// The ShowINIT mechanism works by having each INIT read/write data from these globals.
// The MPW C compiler doesn't accept variables declared at an absolute address, so I use these macros instead.
// Only one macro is defined per variable; there is no need to define a Set and a Get accessor like in <LowMem.h>.

#define	LMVCheckSum		(* (unsigned short*) 0x928)
#define	LMVCoord		(* (         short*) 0x92A)
#define	LMHCoord		(* (         short*) 0x92C)
#define	LMHCheckSum		(* (unsigned short*) 0x92E)

// ---------------------------------------------------------------------------------------------------------------------
// Prototypes for the subroutines. The main routine comes first; this is necessary to make THINK C's "Custom Header" option work.

static unsigned short CheckSum (short x);
static void ComputeIconRect (Rect* iconRect, Rect* screenBounds);
static void AdvanceIconPosition (Rect* iconRect);
static void DrawBWIcon (short iconID, Rect *iconRect);

// ---------------------------------------------------------------------------------------------------------------------
// Main routine.

typedef struct {
	QDGlobals			qd;									// Storage for the QuickDraw globals
	long				qdGlobalsPtr;							// A5 points to this place; it will contain a pointer to qd
} QDStorage;

pascal void ShowInitIcon (short iconFamilyID, Boolean advance)
{
	long				oldA5;								// Original value of register A5
	QDStorage			qds;									// Fake QD globals
	CGrafPort			colorPort;
	GrafPort			bwPort;
	Rect				destRect;
	SysEnvRec		environment;							// Machine configuration.
	
	oldA5 = SetA5((long) &qds.qdGlobalsPtr);						// Tell A5 to point to the end of the fake QD Globals
	InitGraf(&qds.qd.thePort);								// Initialize the fake QD Globals
	
	SysEnvirons(curSysEnvVers, &environment);					// Find out what kind of machine this is

	ComputeIconRect(&destRect, &qds.qd.screenBits.bounds);			// Compute where the icon should be drawn

	if (environment.systemVersion >= 0x0700 && environment.hasColorQD) {
		OpenCPort(&colorPort);
		PlotIconID(&destRect, atNone, ttNone, iconFamilyID);
		CloseCPort(&colorPort);
	}
	else {
		OpenPort(&bwPort);
		DrawBWIcon(iconFamilyID, &destRect);
		ClosePort(&bwPort);
	}
	
	if (advance)
		AdvanceIconPosition (&destRect);
		
	SetA5(oldA5); 											// Restore A5 to its previous value
}

// ---------------------------------------------------------------------------------------------------------------------
// A checksum is used to make sure that the data in there was left by another ShowINIT-aware INIT.

static unsigned short CheckSum (short x)
{
	return (unsigned short)(((x << 1) | (x >> 15)) ^ 0x1021);
}

// ---------------------------------------------------------------------------------------------------------------------
// ComputeIconRect computes where the icon should be displayed.

static void ComputeIconRect (Rect* iconRect, Rect* screenBounds)
{
	if (CheckSum(LMHCoord) != LMHCheckSum)					// If we are first, we need to initialize the shared data.
		LMHCoord = 8;
	if (CheckSum(LMVCoord) != LMVCheckSum)
		LMVCoord = (short)(screenBounds->bottom - 40);
	
	if (LMHCoord + 34 > screenBounds->right) {					// Check whether we must wrap
		iconRect->left = 8;
		iconRect->top = (short)(LMVCoord - 40);
	}
	else {
		iconRect->left = LMHCoord;
		iconRect->top = LMVCoord;
	}
	iconRect->right  = (short)(iconRect->left + 32);
	iconRect->bottom = (short)(iconRect->top  + 32);
}

// AdvanceIconPosition updates the shared global variables so that the next extension will draw its icon beside ours.

static void AdvanceIconPosition (Rect* iconRect)
{
	LMHCoord = (short)(iconRect->left + 40);					// Update the shared data
	LMVCoord = iconRect->top;
	LMHCheckSum = CheckSum(LMHCoord);
	LMVCheckSum = CheckSum(LMVCoord);
}

// DrawBWIcon draws the 'ICN#' member of the icon family. It works under System 6.

static void DrawBWIcon (short iconID, Rect *iconRect)
{
	Handle		icon;
	BitMap		source, destination;
	GrafPtr		port;
	
	icon = Get1Resource('ICN#', iconID);
	if (icon != NULL) {
		HLock(icon);
														// Prepare the source and destination bitmaps.
		source.baseAddr = *icon + 128;						// Mask address.
		source.rowBytes = 4;
		SetRect(&source.bounds, 0, 0, 32, 32);
		GetPort(&port);
		destination = port->portBits;
														// Transfer the mask.
		CopyBits(&source, &destination, &source.bounds, iconRect, srcBic, nil);
														// Then the icon.
		source.baseAddr = *icon;
		CopyBits(&source, &destination, &source.bounds, iconRect, srcOr, nil);
	}
}

// ---------------------------------------------------------------------------------------------------------------------
// Notes

// Checking for PlotIconID:
// We (PNL) now check for system 7 and colour QD, and use colour graf ports and PlotIconID only if both are true
// Otherwise we use B&W grafport and draw using PlotBWIcon.