TweetFollow Us on Twitter

SuperPaint PlugIns
Volume Number:6
Issue Number:2
Column Tag:C Workshop

Related Info: Quickdraw

SuperPaint Plug-ins

By Linda McLennan, Cardiff, CA

Note: Source code files accompanying article are located on MacTech CD-ROM or source code disks.

SuperPaint Plug-in Tools in Think C

[Linda McLennan has a degree in Information Science from University of California at Santa Cruz. She was a Software Engineer for Silicon Beach Software for 2 years. As a member of the SuperPaint 2.0 team she was involved in developing the plug-in interface and creating many of the tools that shipped with SuperPaint. At present, she is an independent consultant.]

One of the exciting features of SuperPaint 2.0 is the introduction of Plug-in modules to provide flexibility and extensibility. These modules are executable files that reside separately from SuperPaint and are automatically incorporated into the application. The Plug-in module concept provides a mechanism for adding features to SuperPaint without modifying the application itself. This opens up the opportunity for developers to create sets of custom tools and commands which can be marketed independently with no requirement for permission or licensing from Silicon Beach Software. SuperPaint provides the framework and handles much of the overhead so that you can concentrate on the more creative task of developing the special effects.

SuperPaint 2.0 supports two types of Plug-in modules: interactive paint tools and transformation menu commands. Plug-ins are placed in SuperPaint’s special folder known as the Pouch. At startup time, SuperPaint scans the pouch for Plug-ins and after verifying that they are compatible with the version of SuperPaint that is running, incorporates them into the application as appropriate for each type. Interactive paint tools will appear automatically in the expandable paint tool palette as shown in Figure 1. Menu Commands will be added to the bottom of the Paint menu. The main distinction between palette tools and menu commands is in how they are used. An interactive tool generally creates an image continuously as the mouse moves while a menu command will act on a currently selected area rather than using mouse position. This article will focus on interactive paint tools. (See Mike Ogawa’s article on SuperPaint Menu Commands in this same issue.)

Anatomy of a Plug-in Module

The Plug-in module contains a stand-alone code resource. Since execution of a code resource begins with the first byte, the main routine must be linked at the beginning, or the code module must begin with a jump to the main entry point. With Think C, the ordering of the routines is controlled by the development system and a standard header with a jump to the routine named ‘main’ is included automatically when linking as a code resource. When using other development environments, special care must be taken to ensure that the object file containing the main entry point is linked first.

Think C 4.0 supports Multi-Segment code resources which allows you to create a Plug-in of virtually any size. When using other development environments that do not provide this support, the code resource must be a single segment.

In general, a Plug-in should not use global data. Think C does provide a mechanism for accessing globals through A4 which is sufficient for some situations. However, this is not recommended for saving variable data between calls to the Plug-in. There is the possibility that the code resource may be purged and reloaded by SuperPaint between calls causing the global data area to be reinitialized. If the Plug-in needs to maintain variable data between calls, it should allocate space in the heap for storing the data and return the handle to SuperPaint in the refCon as described in a following section. The global data issue is a frequent source of problems in writing Plug-ins, particularly since it isn’t always obvious that you are actually using globals. (Mike Ogawa’s article discusses this in greater detail.) It is recommended that you read about using global data in code resources in the User’s Manual for your development environment. MPW users may also want to read Macintosh Technical Note #256 titled “Globals in Stand-Alone Code”.

The code resource for an interactive tool is type ‘BWit’ in a file of the same type. The file creator should be the same as SuperPaint ‘SPNT’ in order to pick up the plug icon from the application. However, if you have a plug-in that is a commercial product you can give it its own creator and icon. The resource name of the ‘BWit’ is the name that will show up in SuperPaint’s About Box in the About Plug-ins list.

The Plug-in must also contain a ‘PiMI’’ resource indicating the interface version for the plug-in module. The PiMI resource contains the version number in a 16-bit integer. This article describes version 1 of the interface.

The Plug-in provides its icon for the tool palette as a SICN resource and can have any number of resources such as cursors, menus, dialogs, etc. keeping certain guidelines in mind for the numbering of the resources. The ‘BWit’ resource should be numbered 16000 or greater. This is the base number for the tool and all other resources associated with the tool should be numbered from this base number. Multiple resources of the same type should start with the base number and be numbered contiguously upward. The Plug-in can have hierarchical submenus with resource IDs following the general guidelines but the menu IDs must be in the range from 200-235.

The Plug-in should not assume constant resource IDs, but use the base number passed by SuperPaint instead. The reason for these guidelines is to allow for renumbering of the resources to prevent conflicts with other Plug-ins that may be placed in the same file. All resources should be marked as purgeable.

Figure 1. Expandable Paint Tool Palette

The Plug-in Interface

The Plug-in code module is created with the main procedure using a Pascal interface. The calling sequence for the main procedure is as follows:

/* 1 */

 pascal void main( selector, tDataPtr, refCon, returnCode )

 short  selector;
 long   *refCon;
 short  *returnCode;

The selector parameter is a number which identifies the type of action the tool is to perform on a particular call. The selectors are:

toolAbout Provide “About Box” information

toolSelected Tool selected

toolDblClick Tool double-clicked in palette

toolKeyDown Key event while tool is selected

toolMouseDown Mouse down with tool selected

toolStillDown Mouse button still down

toolMouseUp End of mouse down event

toolMenuEvent Menu event in tool’s menu

toolMenuInsert Tool can put up its menus

toolMenuDelete Tool must remove its menus

toolIdle Mouse button up with tool active

toolDeselected Tool deselected

toolRequestComp Special request completed

The paramPtr parameter is a pointer to the ToolDataRec structure of information passed between SuperPaint and the tool.

The refCon is a long word that SuperPaint saves for the plug-in module between calls. This allows a module to preserve data such as current tool settings by allocating heap space and passing the handle back to the application at the end of each call.

The returnCode field is a result code passed back to the application after a call to report its success or failure. A returnCode of zero indicates no error. Negative return codes correspond to standard Macintosh errors and positive numbers are available for plug-in specific errors.

The ToolDataRec Structure

The ToolDataRec structure contains fields which pass data to the tool and also back to SuperPaint. It begins with a 16-byte header for general plug-in information with the remaining part of the structure containing information specific to interactive paint tools. The following is a brief description of the fields in this structure.

toolID contains the resource ID of the BWit resource passed to the tool from SuperPaint. The tool should use toolID when loading its resources rather than assuming a specific resource ID. ifVersion contains the version number of the plug-in interface that the calling application is supporting. newPoint contains the current mouse position and oldPoint contains the previous mouse position in local coordinates of the paint window. updateRect passes back to SuperPaint the size of the area of the paint window which has changed. mouseIsDown will be set to true if the mouse button is down. shiftIsDown, cmdIsDown, and optIsDown will be set to true if the corresponding modifier key is down. dblClick will be set to true if a double-click was detected in the paint window.

SuperPaint passes the current setting for the Paint Multiple option in paintMultiple. paintCenter contains true if Paint From Center option is selected, false if Paint From Corner is selected. The fillPatNone and linePatNone fields indicate when the fill pattern and line patterns are set to none. The current fill pattern is passed in curFillPattern. The tool can pass a new fill pattern back to SuperPaint in this field to be used with autoPaint mode. changeFillPat must be set to true at the same time the new pattern is returned.

The possible values for cursorType are:

0 = use crosshair
1 = use cursor resource with base resource ID      
2 = use crosshair which shows current line width
3 = use current brush shape 
4 = use cursor from newCursor field

SuperPaint automatically sets the tool’s cursor when the tool is selected. If the tool wants to change the cursor after that, it sets changeCursor to true and at the same time, sets the cursorType field to specify the new cursor. If the tool sets cursorType to 4 and changeCursor to true, the contents of newCursor will be used for the new cursor. The toolActive flag may be set to true when the tool first becomes active after a toolMouseDown call. Calls of type toolStillDown, toolMouseUp, and toolIdle only occur when the toolActive flag is set.

The usesConstrain option should be set to true if the tool wants the automatic shift key constraint to vertical or horizontal mouse positions. The current brush shape is passed to the tool in curBrush. The curPatList field is a handle to a PAT# which is the currently selected pattern list. A pointer to the current event record is passed in evntRecPtr when the tool is being called for a key event with selector code toolKeyDown.

The autoPaint options are:

 0 = tool doesn’t use autoPaint
 1 = paint at newPoint only
 2 = paint continuously between oldPoint and newPoint

If option 1 or 2 is selected, SuperPaint will paint automatically with the current cursor as the brush shape.

The symmetry field defines the type of symmetry information the tool needs for radial or mirror symmetry:

 0 = tool doesn’t use symmetry 
 1 = pass symmetry information  and call tool for each reflection
 2 = pass symmetry information and call tool for current mouse position 

If symmetry is set to 1 or 2, numPts will contain the number of points of symmetry and mirrorPts will contain a pointer to a two-dimensional array of a maximum of nine pairs of symmetry points.

The menuID and menuItem fields pass the menu ID and the menu item number to the tool when an item has been selected in the tool’s menu.

The undoBits field is a BitMap structure which contains the image of the screen before the current active phase. The BitMap structure is set up for the size of the current port. Tools which need to erase a previous step before drawing a new one can use undoBits to restore the screen image between drawing steps.

SuperPaint can make a scratch buffer available to the tool if the usesScratch option is selected. It will pass a BitMap in scratchBits which will be set up for the size of the port. If the scratch area is not available to the tool, the scratchBits.baseAddr will be set to zero.

Special services can be requested from SuperPaint after calls of type toolDblClick and toolMenuEvent by returning the appropriate code in the field requestCode. The possible settings are:

 0 = no request
 1 = invoke edit brush shapes dialog
 2 = invoke the edit SICN dialog

If the requestCode field is set to 1, SuperPaint will respond by bringing up its built-in brush edit dialog and handling the events in it. When the user exits the dialog by clicking OK, SuperPaint will call the tool with the toolRequestComp call and pass the selected brush in the curBrush field. Another kind of tool that uses SICNs could also take advantage of SuperPaint’s built-in SICN editor by setting the requestCode to 2. The tool passes a handle to a SICN list in sicnListHdl and sicnIndex must contain the index of the SICN which is to be selected in the dialog. The sicnIndex field will also return the index of the selected SICN back to the tool with the toolRequestComp call.

Overview of an Interactive Paint Tool

When a tool is selected from the palette, SuperPaint will load the tool’s code resource into the application heap and lock it. It also sets curResFile to the tool’s file. The tool will receive a call of type toolSelected. The refCon parameter will be zero the first time the tool is called, so that a tool can determine if any initialization is required by checking the refCon. If it needs its own global data area, it can allocate space in the heap and return the handle to SuperPaint as the refCon. At this time the tool sets fields in the toolDataRec to specify various options. If a tool has menu resources, they should be loaded and detached the first time the tool is selected. The menu handles can be saved in the tool’s global data area.

The toolSelected call will be followed by a call of type toolMenuInsert. This call is also received when SuperPaint has an activate event. If the tool has menus, it should put them up at this time.

When a tool is selected from the list of plug-ins in the About SuperPaint dialog, it will receive a call of type toolAbout. The tool can put up its own modal dialog or can return a request for SuperPaint to display its TEXT resource.

A mouse down event in the document window will result in a call of type toolMouseDown. If the tool sets the toolActive field to true, it will continue to receive calls of type toolStillDown, toolMouseUp, and toolIdle until the tool sets the toolActive field to false.

Double-clicking a tool’s icon in the palette will result in a call of type toolDblClick. If the tool returns a non-zero requestCode, it will receive another call of type toolRequestComp after the tool’s special request has been completed.

When an item in a tool’s menu is selected, it will receive a call of type toolMenuEvent. If the tool returns a non-zero requestCode, it will receive another call of type toolRequestComp after the tool’s special request has been completed.

A call of type toolKeyDown is sent when a key other than option, shift or command is pressed. This call can occur intermixed with toolStillDown or toolIdle calls if the toolActive flag is set.

When a tool is deselected, it will receive a call of type toolMenuDelete followed by a call of type toolDeselected.

Fuzzy Brush Example

The Fuzzy Brush is a simple example of a brush with options for creating different effects. See Figure 2 for sample output from this tool. The main routine consists of a switch statement on the selector parameter. This tool doesn’t use all possible selectors so the default case handles those cases by returning an empty update area and sets returnCode to zero. The refCon parameter has been defined in this example as a pointer to a handle rather than a pointer to a long to eliminate the necessity of casting every time it is referenced.

Figure 2. Fuzzy Brush Output

When our tool is selected from the palette, we will receive a toolSelected call. We call the FuzzyInit routine to initialize fields in the toolDataRec to set various options. We then check the refCon to see if this is the first time called and if so, allocate space in the heap to store the tool’s global data. The handle to this area is returned to SuperPaint in the refCon.

/* 2 */

 if ( *refCon == nil )
   *refCon =

Handling Menus

The tool also gets its menu at the time it is first selected, makes it non-purgeable and detaches it. The toolID passed from SuperPaint is used for the resource ID of the menu rather than assuming a specific resource ID. The tool could have hierarchical sub-menus as well and would load them and detach them all in the same way as its main menu.

We must wait for the appropriate call to actually insert the menu in the menu bar so the menu handle is saved in the FuzzyData structure along with other initial settings for the brush size and effect.

Immediately following the toolSelected call, we will receive a toolMenuInsert call. This call is also received when SuperPaint has an activate event. At this time, we insert our menu and redraw the menu bar. If we had hierarchical sub-menus we would also insert them now. A tool which does not have menus can ignore this call and just return a result code of zero.

When there is an event in the tool’s menu, we receive a toolMenuEvent call with the menu ID and item number passed in the toolDataRec. In our example, we have only one menu so we only need to check which item was selected. If we had sub-menus, it would be necessary to check the menu ID as well to determine which sub-menu had been selected. Our example uses the menu to allow selection of different texture effects. All that we need to do at this time is to save the item number of the new selection in our FuzzyData structure and update the menu by unchecking the previous selection and checking the new one.


Now that we are initialized and know how to handle menus, we are ready to do some drawing. There are four calls to the tool when the tool can draw. Before calling the tool, SuperPaint sets up the offscreen drawing port for the tool with all of the current settings such as pen pattern, pen size, paint mode, etc. Fuzzy Brush will draw with the pattern selected in the pattern palette, the line thickness set in the tool palette, selected paint mode, etc. This is the power of writing a plug-in tool - the support is already there for selecting options, auto-scroll while drawing, constraining lines, printing, etc. It also works with symmetry without any additional programming effort. The tool draws into the current port and returns the dimensions of the changed area for SuperPaint to transfer the new image to the screen. If the tool doesn’t do any painting for any of these calls, it should return an empty update rectangle.

The first call we would receive for drawing is the toolMouseDown call. Some tools do actual drawing at this time and others just do some initialization such as moving to or saving the initial mouse down position. In our example, we won’t do any actual drawing yet so we return the empty update rectangle. Since we want to receive followup calls of type toolStillDown, we must set the toolActive flag, but only after verifying that we don’t have a line pattern of ‘none’.

When we receive a toolStillDown call, our tool does its drawing. The simplest example of output at this point can be shown by just drawing a line to the current mouse position and setting the update rectangle to be the area from the previous mouse position to the current one. This would be similar to the pencil tool, or more precisely a freehand line tool since this would draw a line using the currently selected line pattern and pen width. Notice that the update rectangle must be adjusted for the current pen width.

/* 3 */

 case toolStillDown: 
 LineTo( tDataPtr->newPoint.h,
 tDataPtr->newPoint.v );
 &tDataPtr->updateRect );
 GetPort( &drawingPort );
 tDataPtr->updateRect.right +=     drawingPort->pnSize.h;
 tDataPtr->updateRect.bottom +=    drawingPort->pnSize.v;

By modifying this short segment of code, you can create a tool with unusual and interesting results. The Fuzzy Brush creates its special effects in the DrawEffect routine by generating a number of random offsets from the current mouse position and just moving to each point and drawing short lines.

A toolMouseUp call signals the end of drawing for the Fuzzy Brush so we clear the toolActive flag and return an empty update rectangle.

Some tools need to continue to draw after the mouse is up. The 3D Box tool is an example of this as it draws the rubber-band lines while placing the 3D part of the box. That kind of tool would not clear the toolActive flag on the first mouse up because it needs to receive toolIdle calls from SuperPaint while the mouse is up. It clears its toolActive flag after another mouse click following the toolIdle calls. The Fuzzy Brush doesn’t use this call and should never receive it since it always clears the toolActive flag when it receives the toolMouseUp call.

Using Key Events

Now we can add enhancements to our example to demonstrate the use of the toolKeyDown call. We receive this call if there is a key pressed which is not a modifier key (option, shift or command key). We determine which key was pressed from the message field of the event record that is passed in the toolDataRec from SuperPaint. The Fuzzy Brush uses keys ‘1’, ‘2’, and ‘3’ to select three different sizes of brushes. The advantage of using keys to change brush size is that we can receive toolKeyDown calls when the mouse is either up or down. This means that we can change brush size on the fly while we are drawing. In our example, we only need to save a new brush size computed from the key pressed. The DrawEffect routine will use the new size the next time it is called.

The About Box

Finally, we come to displaying our About Box. This is our chance to give ourselves credit for the exciting new tools we are creating. This is especially important if you are developing tools commercially. Clicking the “Plug-ins” button in SuperPaint’s About Box leads to a scrolling list of all Plug-ins currently in the pouch as shown in Figure 3. When our tool is selected and the About button clicked, we receive a call to provide information about our tool. There are basically two ways to do this. The easiest way would be to use the TEXT resource option. We simply make a TEXT resource and give it the same resource ID as the tool base ID. Setting the returnCode to textAbout will cause SuperPaint to display our text in a scrolling window.

Figure 3. Plug-ins

/* 4 */
 case toolAbout: *returnCode = textAbout;

However, in our example we want to do something more interesting so we put up our own modal dialog. The returnCode is set to zero to tell SuperPaint that we have handled the About Box ourselves.

There are several methods to center a DLOG on the screen. The CenterWindow routine creates a temporary port to get the size of the screen since we don’t have direct access to the Quickdraw global screenBits. (Mike Ogawa’s article uses another technique by accessing Quickdraw globals through low memory global CurrentA5.)

In our example, the same About Box code has also been placed under the toolDblClick call to demonstrate responding to this call as well. In a more complex tool, we might want to bring up another dialog for tool settings.

The Goodbye Kiss

We will receive a toolMenuDelete call when the tool is deselected or when SuperPaint has a deactivate event. At this time, we delete our menu and redraw the menu bar. This call is followed by a toolDeselected call. This is an opportunity to do any cleanup that might be required. Our example doesn’t have anything to do here so this call is just handled by the default case.

Building the Code Resource

The process of building the code resource in Think C is quite simple. “Set Project Type” under the Project menu brings up a dialog which allows you to specify that this is a code resource and to set the file type and creator, resource type, number, name and attributes. (See Figure 4.) The “Build Code Resource” command in the Project menu handles compiling all source files and loading libraries as necessary, linking, copying additional resources into the designated output file and setting the file type and creator. Place the file in the SuperPaint Pouch and you are ready to go.

Figure 4. Project Type


Creating your own custom paint tool can give instant satisfaction by allowing you to develop new kinds of graphic tools quickly without having to write an entire application to support them. Since the plug-in tool described in this article uses only some of the many features of the plug-in interface, it is recommended that anyone interested in writing their own plug-in tools obtain the Plug-in Developer Toolkit from Silicon Beach. The Developer Toolkit contains full documentation of the interface along with several different source code examples in five different development environments. It is currently available for $15 from Silicon Beach Software, Inc., P.O. Box 262460, Dept. 20, San Diego, CA 92126.

Listing:  BWit.h
 *  BWit.h
 * Linda McLennan
 COPYRIGHT © 1989 Silicon Beach Software, Inc.
 Permission is hereby granted to the purchaser
 to use this source code for the limited
 purpose of producing and distributing compiled
 object files and applications.  The source
 code is and shall remain the sole property of
 Silicon Beach Software, Inc., and except as
 expressly provided, purchaser obtains no
 right, title or interest in the source code.
 Distribution of the un-compiled or text
 versions of this source code is prohibited.

/* interface version number */
#define verNum   1

/* paint mode constants */
#define paintOpaquepatCopy
#define paintTransparent  patOr
#define paintOnBlack notPatBic
#define paintInvertpatXor

/* toolAbout return codes */
#define noAbout  1
#define textAbout2

/* values for CursorType */
#define defaultCursor0
#define resourceCursor    1
#define lineWidthCursor 2
#define brushCursor3
#define passedCursor 4
/* values for type of symmetry support */
#define noSymmetry 0
#define autoSymmetry 1
#define passSymmetryPts 2 

/* values for autoPaint */
#define noAutoPaint0
#define autoPaintPt1
#define autoPaintLine2  

/* values for requestCode field */
#define editBrushes1
#define editSICNs2

/* call selector codes */
#define toolAbout0

#define toolSelected 11
#define toolDblClick 12
#define toolKeyDown13
#define toolMouseDown14
#define toolStillDown15
#define toolMouseUp16
#define toolMenuEvent17
#define toolMenuInsert    18
#define toolMenuDelete    19
#define toolIdle 20
#define toolDeselected    21
#define toolRequestComp 22

typedef struct
 short  toolID;  
 short  spare1;
 short  spare2;
 short  spare3;
 short  spare4;
 short  spare5;
 short  spare6;
 short  spare7;

 Point  newPoint;
 Point  oldPoint;
 Rect   updateRect;
 Cursor newCursor;
 Bits16 curBrush;
 Handle curPatList;

 short  autoPaint;
 short  cursorType;
 short  symmetry;
 short  spare8;
 short  menuID;
 short  menuItem;

 short  numPts;
 Point  (*mirrorPts)[9][2];

 BitMap scratchBits;
 BitMap undoBits;
 Handle sicnListHdl;
 short  sicnIndex;
 short  requestCode; 
} ToolDataRec, *ToolDataPtr;
Listing:  Fuzzy.h

/* Fuzzy.h */

#define nil 0
#define behind   -1
#define fuzzy    1
#define furry    2
#define crosshatch 3

typedef struct
 MenuHandle theMenu;
 short  whichEffect;
 short  brushSize;
}  FuzzyData, *FuzzyDataPtr, **FuzzyDataHandle;
Listing:  Fuzzy.c

 *  Fuzzy Brush
 * Linda McLennan
 *  COPYRIGHT © 1989 Ventana Software


pascal void main( selector, tDataPtr, refCon, returnCode )
short   selector;
ToolDataPtr tDataPtr;
Handle  *refCon;
short   *returnCode;
 short  itemHit;
 MenuHandle fuzzyMenu;
 FuzzyDataPtr  fzDataPtr;
 char   keyHit;
 *returnCode = noErr;

 switch( selector )
 case toolAbout: 
 /* show about box */
 dLogPtr = GetNewDialog( tDataPtr->toolID,
 nil, (WindowPtr)behind );
 ModalDialog( nil, &itemHit );
 DisposDialog( dLogPtr );
 case toolSelected:/* tool selected from palette */
 FuzzyInit( tDataPtr, refCon );
 if ( *refCon == nil )  *returnCode = memFullErr;
 case toolMenuInsert:/* put up menu */
 HLock( *refCon );
 fzDataPtr = (FuzzyDataPtr)**refCon;
 fuzzyMenu = fzDataPtr->theMenu;
 if ( fuzzyMenu != nil )
 InsertMenu( fuzzyMenu, 0 );
 CheckItem( fuzzyMenu,
 fzDataPtr->whichEffect, true );
 HUnlock( *refCon );

 case toolDblClick:/* show about box */
 dLogPtr = GetNewDialog( tDataPtr->toolID,
 nil, (WindowPtr)behind );
 ModalDialog( nil, &itemHit );
 DisposDialog( dLogPtr );
 case toolKeyDown:
 /* non-modifier key pressed */
 eventDataPtr = tDataPtr->evntRecPtr;
 keyHit = (char)(charCodeMask &
 (eventDataPtr->message) );
 if ( (keyHit >= ‘1’) && (keyHit <= ‘3’) )
 HLock( *refCon );
 fzDataPtr = (FuzzyDataPtr)**refCon;
 fzDataPtr->brushSize =
 (keyHit - 0x0030) * 16;
 HUnlock( *refCon );
 case toolMouseDown:/* mouse down, set update area empty */
 if (! tDataPtr->linePatNone)
 tDataPtr->toolActive = true;
 case toolStillDown:/* mouse still down, draw something */
 DrawEffect( tDataPtr, *refCon );
 case toolMouseUp: 
 /* mouse up */
 tDataPtr->toolActive = false;
 case toolMenuEvent: /* select new effect */
 HLock( *refCon );
 fzDataPtr = (FuzzyDataPtr)**refCon;
 if ( tDataPtr->menuItem  !=
 fzDataPtr->whichEffect )
 CheckItem( fzDataPtr->theMenu,
 fzDataPtr->whichEffect, false );
 CheckItem( fzDataPtr->theMenu,
 tDataPtr->menuItem, true );
 fzDataPtr->whichEffect =
 HUnlock( *refCon );

 case toolMenuDelete:/*tool deselected, delete menu */
 DeleteMenu( tDataPtr->toolID );

 default: /* just clear the update area */
 } /* end switch */
Listing:  FuzzyInit.c

 *  FuzzyInit.c
 * Linda McLennan
 *  COPYRIGHT © 1989 Ventana Software


FuzzyInit( tDataPtr, refCon )
 Handle *refCon;
 MenuHandle fuzzyMenu;
 FuzzyDataPtr  fzDataPtr;

 /* set options */
 tDataPtr->cursorType = resourceCursor;
 tDataPtr->symmetry = autoSymmetry;
 tDataPtr->autoPaint = noAutoPaint;
 tDataPtr->usesScratch = false;
 tDataPtr->usesConstrain = true;
 tDataPtr->changeFillPat = false;

 /* check if first time called */
 if ( *refCon == nil )
 /* allocate space for globals */
      *refCon = NewHandle( sizeof ( FuzzyData ) );

 /* get the menu, detach it */
 /* and save the handle */
 if ( *refCon != nil )
 fuzzyMenu = GetMenu(tDataPtr->toolID);
 if ( fuzzyMenu != nil )
 HLock( *refCon );
 fzDataPtr = (FuzzyDataPtr)**refCon;
 fzDataPtr->theMenu = fuzzyMenu;
 fzDataPtr->whichEffect = fuzzy;
 fzDataPtr->brushSize = 16;
 HUnlock( *refCon ); 
Listing:  DrawEffect.c

 *  DrawEffect.c
 * Linda McLennan
 *  COPYRIGHT © 1989 Ventana Software

DrawEffect( tDataPtr, fzDataHandle )
 FuzzyDataHandle fzDataHandle;
 short  n, theEffect;
 short  halfSize, numPts;
 Point  offset;
 FuzzyDataPtr  fzDataPtr;

 HLock( fzDataHandle );
 fzDataPtr = *fzDataHandle;
 theEffect = fzDataPtr->whichEffect;
 if ( theEffect == crosshatch )
 numPts = 1;
 numPts = 8;
 halfSize = (fzDataPtr->brushSize)/2;

 for ( n = 1; n <= numPts; n++ )
 /* get random offset from current */
 /* mouse within size of brush */
 offset.h = Random() % halfSize;
 offset.v = Random() % halfSize;
 switch( theEffect )
 case fuzzy:
 MoveTo( tDataPtr->newPoint.h,
 tDataPtr->newPoint.v );
 Line( offset.h, offset.v);
 case furry:
 MoveTo( tDataPtr->newPoint.h +    offset.h, tDataPtr->newPoint.v + offset.v 
 Line( offset.h, offset.v);
 case crosshatch:
 MoveTo( tDataPtr->newPoint.h +
 offset.h, tDataPtr->newPoint.v + offset.v );
 Line( 7, 0);
 MoveTo( tDataPtr->newPoint.h +
 offset.h + 1, tDataPtr->newPoint.v +
 offset.v - 2);
 Line( 6, 6 );

 HLock( fzDataHandle );

 /* compute update area and add pen size */
 Pt2Rect(tDataPtr->oldPoint, tDataPtr->newPoint,
 &tDataPtr->updateRect );
 InsetRect( &tDataPtr->updateRect,
 -halfSize, -halfSize );

 if ( theEffect == furry )
 InsetRect( &tDataPtr->updateRect,
 -halfSize, -halfSize );
 GetPort( &dPort );
 tDataPtr->updateRect.right += dPort->pnSize.h;
 tDataPtr->updateRect.bottom += dPort->pnSize.v;
Listing:  CenterWindow.c

 COPYRIGHT © 1989 Silicon Beach Software, Inc.
 Permission is hereby granted to the purchaser
 to use this source code for the limited
 purpose of producing and distributing compiled
 object files and applications.  The source
 code is and shall remain the sole property of
 Silicon Beach Software, Inc., and except as
 expressly provided, purchaser obtains no
 right, title or interest in the source code.
 Distribution of the un-compiled or text
 versions of this source code is prohibited.
#define MBarHeight ( *(short  *)0xBAA )
#define nil 0

CenterWindow( Type, ID )
ResType Type;
short   ID;

 Rect   boundsRect;
 short  screenHeight;
 short  screenWidth;
 short  boxHeight;
 short  boxWidth;
 short  topMargin;
 short  leftMargin;
 GrafPtrtempPort, savePort;
 windowHdl  = (DialogTHndl)GetResource(Type,ID);
 if( windowHdl != nil ) {
 /* open a temporary port to */
 /* get the size of the screen */
 GetPort( &savePort );
 tempPort = (GrafPtr)NewPtr( sizeof( GrafPort ) );
 OpenPort( tempPort );
 screenWidth = tempPort->portRect.right - 
 screenHeight = tempPort->portRect.bottom -
 tempPort-> - MBarHeight;
 ClosePort( tempPort );
 DisposPtr( (Ptr)tempPort );
 SetPort( savePort );

 /* get size of dialog window */
 boundsRect = (*windowHdl)->boundsRect;
 boxHeight = boundsRect.bottom -;
 boxWidth = boundsRect.right  - boundsRect.left;

 /* compute position for the dialog */
 topMargin = (screenHeight-boxHeight)/4;
 leftMargin = (screenWidth-boxWidth)/2; = MBarHeight + topMargin;
 boundsRect.left = leftMargin;
 boundsRect.bottom =  + boxHeight;
 boundsRect.right = boundsRect.left + boxWidth;
 (*windowHdl)->boundsRect = boundsRect;
 }/* if( got the resource ) */


Community Search:
MacTech Search:

Software Updates via MacUpdate

Civilization VI 1.1.0 - Next iteration o...
Sid Meier’s Civilization VI is the next entry in the popular Civilization franchise. Originally created by legendary game designer Sid Meier, Civilization is a strategy game in which you attempt to... Read more
Network Radar 2.3.3 - $17.99
Network Radar is an advanced network scanning and managing tool. Featuring an easy-to-use and streamlined design, the all-new Network Radar 2 has been engineered from the ground up as a modern Mac... Read more
Printopia 3.0.8 - Share Mac printers wit...
Run Printopia on your Mac to share its printers to any capable iPhone, iPad, or iPod Touch. Printopia will also add virtual printers, allowing you to save print-outs to your Mac and send to apps.... Read more
ForkLift 3.2.1 - Powerful file manager:...
ForkLift is a powerful file manager and ferociously fast FTP client clothed in a clean and versatile UI that offers the combination of absolute simplicity and raw power expected from a well-executed... Read more
BetterTouchTool 2.417 - Customize multi-...
BetterTouchTool adds many new, fully customizable gestures to the Magic Mouse, Multi-Touch MacBook trackpad, and Magic Trackpad. These gestures are customizable: Magic Mouse: Pinch in / out (zoom... Read more
Little Snitch 4.0.6 - Alerts you about o...
Little Snitch gives you control over your private outgoing data. Track background activity As soon as your computer connects to the Internet, applications often have permission to send any... Read more
Google Chrome 65.0.3325.181 - Modern and...
Google Chrome is a Web browser by Google, created to be a modern platform for Web pages and applications. It utilizes very fast loading of Web pages and has a V8 engine, which is a custom built... Read more
TeamViewer 13.1.2991 - 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 non... Read more
Printopia 3.0.8 - Share Mac printers wit...
Run Printopia on your Mac to share its printers to any capable iPhone, iPad, or iPod Touch. Printopia will also add virtual printers, allowing you to save print-outs to your Mac and send to apps.... Read more
BetterTouchTool 2.417 - Customize multi-...
BetterTouchTool adds many new, fully customizable gestures to the Magic Mouse, Multi-Touch MacBook trackpad, and Magic Trackpad. These gestures are customizable: Magic Mouse: Pinch in / out (zoom... Read more

Latest Forum Discussions

See All

The best games that came out for iPhone...
It's not a huge surprise that there's not a massive influx of new, must-buy games on the App Store this week. After all, GDC is happening, so everyone's busy at parties and networking and dying from a sinister form of jetlag. That said, there are... | Read more »
Destiny meets its mobile match - Everyth...
Shadowgun Legends is the latest game in the Shadowgun series, and it's taking the franchise in some interesting new directions. Which is good news. The even better news is that it's coming out tomorrow, so if you didn't make it into the beta you... | Read more »
How PUBG, Fortnite, and the battle royal...
The history of the battle royale genre isn't a long one. While the nascent parts of the experience have existed ever since players first started killing one another online, it's really only in the past six years that the genre has coalesced into... | Read more »
Around the Empire: What have you missed...
Oh hi nice reader, and thanks for popping in to check out our weekly round-up of all the stuff that you might have missed across the Steel Media network. Yeah, that's right, it's a big ol' network. Obviously 148Apps is the best, but there are some... | Read more »
All the best games on sale for iPhone an...
It might not have been the greatest week for new releases on the App Store, but don't let that get you down, because there are some truly incredible games on sale for iPhone and iPad right now. Seriously, you could buy anything on this list and I... | Read more »
Everything You Need to Know About The Fo...
In just over a week, Epic Games has made a flurry of announcements. First, they revealed that Fortnite—their ultra-popular PUBG competitor—is coming to mobile. This was followed by brief sign-up period for interested beta testers before sending out... | Read more »
The best games that came out for iPhone...
It's not been the best week for games on the App Store. There are a few decent ones here and there, but nothing that's really going to make you throw down what you're doing and run to the nearest WiFi hotspot in order to download it. That's not to... | Read more »
Death Coming (Games)
Death Coming Device: iOS Universal Category: Games Price: $1.99, Version: (iTunes) Description: --- Background Story ---You Died. Pure and simple, but death was not the end. You have become an agent of Death: a... | Read more »
Hints, tips, and tricks for Empires and...
Empires and Puzzles is a slick match-stuff RPG that mixes in a bunch of city-building aspects to keep things fresh. And it's currently the Game of the Day over on the App Store. So, if you're picking it up for the first time today, we thought it'd... | Read more »
What You Need to Know About Sam Barlow’s...
Sam Barlow’s follow up to Her Story is #WarGames, an interactive video series that reimagines the 1983 film WarGames in a more present day context. It’s not exactly a game, but it’s definitely still interesting. Here are the top things you should... | Read more »

Price Scanner via

Thursday roundup of the best 13″ MacBook Pro...
B&H Photo has new 2017 13″ MacBook Pros on sale for up to $200 off MSRP. Shipping is free, and B&H charges sales tax for NY & NJ residents only. Their prices are the lowest available for... Read more
Sale: 9.7-inch 2017 WiFi iPads starting at $2...
B&H Photo has 9.7″ 2017 WiFi Apple iPads on sale for $40 off MSRP for a limited time. Shipping is free, and pay sales tax in NY & NJ only: – 32GB iPad WiFi: $289, $40 off – 128GB iPad WiFi: $... Read more
Roundup of Certified Refurbished iPads, iPad...
Apple has Certified Refurbished 9.7″ WiFi iPads available for $50-$80 off the cost of new models. An Apple one-year warranty is included with each iPad, and shipping is free: – 9″ 32GB WiFi iPad: $... Read more
Back in stock! Apple’s full line of Certified...
Save $300-$300 on the purchase of a 2017 13″ MacBook Pro today with Certified Refurbished models at Apple. Apple’s refurbished prices are the lowest available for each model from any reseller. A... Read more
Wednesday deals: Huge sale on Apple 15″ MacBo...
Adorama has new 2017 15″ MacBook Pros on sale for $250-$300 off MSRP. Shipping is free, and Adorama charges sales tax in NJ and NY only: – 15″ 2.8GHz Touch Bar MacBook Pro Space Gray (MPTR2LL/A): $... Read more
Apple offers Certified Refurbished Series 3 A...
Apple has Certified Refurbished Series 3 Apple Watch GPS models available for $50, or 13%, off the cost of new models. Apple’s standard 1-year warranty is included, and shipping is free. Numerous... Read more
12″ 1.2GHz Space Gray MacBook on sale for $11...
B&H Photo has the Space Gray 12″ 1.2GHz MacBook on sale for $100 off MSRP. Shipping is free, and B&H charges sales tax for NY & NJ residents only: – 12″ 1.2GHz Space Gray MacBook: $1199 $... Read more
Mac minis available for up to $150 off MSRP w...
Apple has restocked Certified Refurbished Mac minis starting at $419. Apple’s one-year warranty is included with each mini, and shipping is free: – 1.4GHz Mac mini: $419 $80 off MSRP – 2.6GHz Mac... Read more
Back in stock: 13-inch 2.5GHz MacBook Pro (Ce...
Apple has Certified Refurbished 13″ 2.5GHz MacBook Pros (MD101LL/A) available for $829, or $270 off original MSRP. Apple’s one-year warranty is standard, and shipping is free: – 13″ 2.5GHz MacBook... Read more
Apple restocks Certified Refurbished 2017 13″...
Apple has Certified Refurbished 2017 13″ MacBook Airs available starting at $849. An Apple one-year warranty is included with each MacBook, and shipping is free: – 13″ 1.8GHz/8GB/128GB MacBook Air (... Read more

Jobs Board

*Apple* Genius - Technical Customer Service...
Job Description:Job SummaryAs a Genius at the Apple Store, you maintain customers' trust in Apple as the skilled technical customer service expert, Read more
Metadata Operations Specialist, *Apple* Med...
# Metadata Operations Specialist, Apple Media Products Job Number: 113387726 Santa Clara Valley, California, United States Posted: 08-Feb-2018 Weekly Hours: 40.00 Read more
*Apple* Retail - Multiple Positions - Apple,...
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
Data Scientist, *Apple* Ecosystem (AMP Anal...
# Data Scientist, Apple Ecosystem (AMP Analytics) Job Number: 113428728 Santa Clara Valley, California, United States Posted: 24-Jan-2018 Weekly Hours: 40.00 **Job Read more
*Apple* Professional Learning Specialist - A...
# Apple Professional Learning Specialist Job Number: 113456892 Englewood, NJ, New Jersey, United States Posted: 02-Feb-2018 Weekly Hours: 40.00 **Job Summary** The Read more
All contents are Copyright 1984-2011 by Xplain Corporation. All rights reserved. Theme designed by Icreon.