TweetFollow Us on Twitter

Color Animation, Part II
Volume Number:10
Issue Number:5
Column Tag:Getting Started

Related Info: Color Manager

Color Animation, Part II

GWorlds, Bitmaps, PixMaps, and CopyBits - getting the bits flying

By Dave Mark, MacTech Magazine Regular Contributing Author

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

Last month’s column introduced PixMapper, a colorized version of last September’s BitMapper program. BitMapper caused a black and white BitMap to float over a patterned background with absolutely no flicker (Figure 1). BitMapper based its magic on a series of three offscreen BitMaps, BitMaps created in memory but not visible on the screen. The first offscreen contains the foreground image (the left-pointing hand). The second offscreen contains the background image (the grey, framed rectangle). The third offscreen is used to combine the foreground and background before drawing the combined image into the BitMapper window.

Figure 1. Last September’s BitMapper program.

Why does this work? Rather than erasing the old image and repainting it in a new position in the window (in BitMapper’s case, the hand tracks the position of the mouse, sort of a giant cursor), this algorithm repeatedly repaints the entire window, based on the contents of the combining offscreen BitMap. Just as a movie consisting of a series of still frames appears to be a single animated image, the constant repainting of the BitMapper window gives the appearance of an animated image.

Adding Color to the Algorithm

As you’d expect, PixMapper achieves the same affect in color by using PixMaps instead of BitMaps. Just as a BitMap describes a black and white bit pattern, a PixMap describes a color bit pattern. Unfortunately, animation with PixMaps is not quite as simple as its black and white counterpart. Why? A PixMap is just more complex. While a BitMap’s pixels are all either black or white, a PixMap’s pixels can be any one of a number of colors, depending on the depth of the PixMap.

The BitMap data structure is relatively simple:

struct BitMap
{
 Ptr baseAddr;
 short rowBytes;
 Rect bounds;
};

Now compare the BitMap to the PixMap data structure:

struct PixMap
{
 Ptr baseAddr;   /*pointer to pixels*/
 short rowBytes; /*offset to next line*/
 Rect bounds;    /*encloses bitmap*/
 short pmVersion;/*pixMap version number*/
 short packType; /*defines packing format*/
 long packSize;  /*length of pixel data*/
 Fixed hRes;/*horiz. resolution (ppi)*/
 Fixed vRes;/*vert. resolution (ppi)*/
 short pixelType;/*defines pixel type*/
 short pixelSize;/*# bits in pixel*/
 short cmpCount; /*# components in pixel*/
 short cmpSize;  /*# bits per component*/
 long planeBytes;/*offset to next plane*/
 CTabHandle pmTable; /*color map for this pixMap*/
 long pmReserved;/*for future use. MUST BE 0*/
};

As you can see, the PixMap data structure is far more complicated. In addition, while BitMapper used a GrafPort, PixMapper must use a CGrafPort. As you might suspect, setting up a CGrafPort is more complicated than setting up its black and white counterpart.

The GWorld

Fortunately, rather than forcing you to go through the arduous process of creating and maintaining these far more complex structures, the Toolbox offers a terrific shortcut, namely, the GWorld.

The GWorld is a full-color, offscreen drawing environment. Just as you’d use an offscreen GrafPort and BitMap to prepare a black and white image for blitting to the screen (blitting comes from an old term BLT, which stood for BLock Transfer, meaning to copy a block of memory from one area to another, all at once), you’ll use a GWorld to do the same for a color image. PixMapper demonstrates all this and a little bit more.

Before we get into the code, let’s take a quick look back at PixMapper in action.

Running PixMapper

The PixMapper menu bar features four menus: Apple, File, Edit, and Colors. PixMapper features a single window filling the entire main screen (see GetMainDevice()). PixMapper fills this window with randomly colored squares. Once the window is completely drawn, PixMapper loads a PICT resource, and uses a series of offscreen GWorlds to animate the PICT across the colored background. The speed of your PICT will depend on the speed of your machine and the size of the PICT. The important thing to notice is that the PICT animates smoothly with absolutely no flicker. If there is any hesitation, it is most likely due to the system taking time to do some housekeeping chore. Notice that PixMapper works, even if the PICT is non-rectangular or has a hole in it (see Figure 2).

Figure 2. PixMapper in action.

The PICT starts in the upper-left corner of the window and moves towards the lower right corner. Every time the PICT hits the edge of the window, the PICT will bounce off and continue in the opposite direction.

When you select Redraw from the File menu, PixMapper redraws the window and starts the animation over again.

Go to the Colors menu and play with all the different menu settings. PixMapper lets you play with both the RGB and HSV color models. RGB lets you set a color’s red, green, and blue values. If you uncheck Random Reds, for example, the screen will be redrawn with a red value of 0 (all greens and blues). If Random Reds is checked, the red component of the color is a random value from 0 to 65535.

If you select HSV Colors, you’ll be able to work with hue, saturation, and brightness rather than red, green, and blue. Unlike the RGB menu items, if you uncheck Random Hues, a color’s hues component is set to 65535 instead of 0. Play around with these settings. Do you think you’ll get different results when you choose random RGB versus when you choose random hues?

To learn more about color and the RGB and HSV color models, read “About the Color Manager” in Inside Macintosh, Volume V, THINK Reference or in the upcoming volume Inside Macintosh: Imaging.

The PixMapper Source Code

PixMapper starts off with three critical #includes. <QDOffscreen.h> has all the GWorld defines, <Picker.h> has the definitions needed to work with the RGB and HSV data structures and routines, and <GestaltEqu.h> has the definitions you’ll need to work with Gestalt(). Take a few minutes to look through these three include files.


/* 1 */
#include <QDOffscreen.h>
#include <Picker.h>
#include <GestaltEqu.h>

There are a lot of #defines used in this program. As usual, they’ll all be described as they occur in the code.


/* 2 */
#define kMBARResID 128
#define kSleep   0L
#define kMoveToFront (WindowPtr)-1L
#define kEmptyString "\p"
#define kEmptyTitlekEmptyString
#define kVisible true
#define kNoGoAwayfalse
#define kNilRefCon (long)nil
#define kErrorAlertID128
#define kNilFilterProc  nil

#define kSquareSize16

#define kForegroundPICT 128
#define kIgnored nil
#define kUseMaxDepth 0
#define kNoFlags (GWorldFlags)0

#define mApple   128
#define iAbout   1

#define mFile    129
#define iRedraw  1
#define iQuit    3

#define mColors  131
#define iUseRGB  1
#define iUseHSV  2
#define iRed4
#define iGreen   5
#define iBlue    6
#define iHue4
#define iSaturation5
#define iBrightness6

PixMapper uses a bunch of globals. gDone starts life as false and is set to true when Quit is selected from the File menu. gIsRGB is true when the RGB Colors item is selected from the Colors menu, false when HSV Colors is selected. gRandomReds, gRandomGreens, and gRandomBlues are true when their respective items are selected from the Colors menu. The same holds true for gRandomHue, gRandomSaturation, and gRandomBrightness.


/* 3 */
Boolean gDone;
Boolean gIsRGB = true, gRandomReds = true,
 gRandomGreens = true, gRandomBlues = true;
Boolean gRandomHue = true, gRandomSaturation = true,
 gRandomBrightness = true;

gMainWindow points to the window with all the colors and the animated PICT. gXBump and gYBump specify the number of pixels the PICT moves each new animation cycle. One way to speed up the animation is to raise the bump values, though the code was written do work with single pixel movements. To learn more about the program, try modifying the code to handle any size bump values. You might try using the mouse position to dynamically vary the rate of movement.


/* 4 */
WindowPtr gMainWindow;
short   gXBump = 1, gYBump = 1; // <--Try changing these numbers

We’ll use three GWorlds. gPictWorld holds the PICT image. gSaveWorld holds the background of the window for later restoration. gSaveMixWorld is used to combine the PICT and the background. The three PixMapHandles are handles to the PixMaps tied to their respective GWorld.


/* 5 */
GWorldPtr gPictWorld, gSaveWorld, gSaveMixWorld;
PixMapHandlegPixMapSave, gPixMapSaveMix, gPixMapPict;

gPictWorldRect is the exact size of the PICT and is the bounding rectangle for gPictWorld. gWorldRect is the bounding Rect for the mixing GWorld. The mixing GWorld is one pixel bigger in all directions than the PICT. This was done so that when we save a region the size of gWorldRect from the PixMapper window, we’ll have a one pixel border around the PICT. This way, when the PICT moves one pixel in any direction, we’ll have the right pixels saved for later restoration. You’ll see how this works later in the code. gSavedFloaterRect contains the current position of the PICT in the PixMapper window.


/* 6 */
Rect    gSavedFloaterRect, gPictWorldRect, gWorldRect;

gGlobalHue holds a hue value that we use if HSV Colors is selected from the Colors menu and Random Hues is not selected.


/* 7 */
short   gGlobalHue;

Here are all the function prototypes. Have I mentioned that I always use function prototypes?


/* 8 */
void    ToolboxInit( void );
void    MenuBarInit( void );
Boolean HasGWorlds( void );
void    WindowInit( void );
void    PaintWindow( void );
void    RandomForeColor( void );
void    GWorldInit( void );
GWorldPtr MakeGWorld( Rect *boundsPtr );
void    EventLoop( void );
void    DoEvent( EventRecord *eventPtr );
void    HandleMouseDown( EventRecord *eventPtr );
void    HandleMenuChoice( long menuChoice );
void    HandleAppleChoice( short item );
void    HandleFileChoice( short item );
void    HandleColorsChoice( short item );
void    MainLoop( void );
void    DrawFirstFloater( void );
void    MoveFloater( void );
void    CalcNewFloaterPosition( void );
void    DoError( Str255 errorString );

main() initializes the Toolbox and the menu bar.

/****************** main ***************************/

void  main( void )
{
 ToolboxInit();
 MenuBarInit();

See if GWorlds are available on this machine.


/* 9 */
 if ( ! HasGWorlds() )
 DoError("\pDeep GWorlds not supported by this machine!");

If so, create the main window and the three GWorlds.


/* 10 */
 WindowInit();
 GWorldInit();

Next, plot the initial position of the PICT and enter the main animation loop. The word “floater” refers to the foreground PICT, which appears to float over the background.


/* 11 */
 DrawFirstFloater();
 EventLoop();
}
ToolboxInit() and MenuBarInit() are the same as always.

/****************** ToolboxInit *********************/

void  ToolboxInit( void )
{
 InitGraf( &thePort );
 InitFonts();
 InitWindows();
 InitMenus();
 TEInit();
 InitDialogs( NULL );
 InitCursor();
}

/****************** MenuBarInit ***********************/

void  MenuBarInit( void )
{
 Handle menuBar;
 MenuHandle menu;
 
 menuBar = GetNewMBar( kMBARResID );
 SetMenuBar( menuBar );

 menu = GetMHandle( mApple );
 AddResMenu( menu, 'DRVR' );
 DrawMenuBar();
}

HasGWorlds() calls Gestalt() using the selector gestaltQuickdrawFeatures. If Gestalt() returns an error we’ll display an appropriate error message.


/* 12 */
/****************** HasGWorlds *****************/

Boolean HasGWorlds( void )
{
 long   feature, mask;
 OSErr  err;
 
 err = Gestalt( gestaltQuickdrawFeatures, &feature );
 
 if ( err != noErr )
 DoError( "\pError calling Gestalt!" );

Next, we’ll set up a comparison mask so we can look at the appropriate bit in feature. Since gestaltHasDeepGWorlds has a value of 1, we’ll want to look at bit number 1, which is the second bit from the right. We’ll use the << operator to set bit number 1 in mask, leaving mask with a value of 2.


/* 13 */
 mask = 1 << gestaltHasDeepGWorlds;

Finally, we’ll use mask to see if bit number 1 is set in feature. If so, deep GWorlds are available and we’ll return true. Otherwise, we’ll return false. You could also write the following statement as return (feature&mask);


/* 14 */
 if ( feature & mask )
 return true;
 else
 return false;
}

WindowInit() creates a new color window a little shorter than the main screen. The top of the window starts just below the menu bar. You could also use GetMainDevice() to get the rectangle of the main screen rather than screenBits.bounds.


/* 15 */
/****************** WindowInit ***********************/

void  WindowInit( void )
{
 Rect   r;
 
 r = screenBits.bounds;
 r.top += GetMBarHeight();
 
 gMainWindow = NewCWindow( nil, &r, kEmptyTitle,
 kVisible, plainDBox, kMoveToFront,
 kNoGoAway, kNilRefCon );

 SetPort( gMainWindow );

Now call PaintWindow() to fill the window with colored rectangles.


/* 16 */
 PaintWindow();
}

PaintWindow() starts by calculating the number of columns and rows in the PixMapper window.


/* 17 */
/****************** PaintWindow ***********************/

void  PaintWindow( void )
{
 Rect   r;
 short  row, col, numRows, numCols;
 
 SetPort( gMainWindow );
 
 r = gMainWindow->portRect;

Both numCols and numRows are based on kSquareSize. Each square on the window will be kSquareSize pixels on a side. If either numCols or numRows is not evenly divisible by kSquareSize, we’ll add another row or column just so we don’t leave any white space at the edge of the window.


/* 18 */
 numCols = (r.right - r.left) / kSquareSize;
 if ( numCols != numCols/kSquareSize*kSquareSize )
 numCols++;
 
 numRows = (r.bottom - r.top) / kSquareSize;
 if ( numRows != numRows/kSquareSize*kSquareSize )
 numRows++;

Next, we initialize the random number seed and set gGlobalHue to a random value. We’ll get to gGlobalHue in the next routine.


/* 19 */
 GetDateTime( (unsigned long *)(&randSeed) );
 
 gGlobalHue = Random();

Next, we’ll step through all the squares, drawing each in the color set by RandomForeColor(). When we’re done, we’ll set the foreground and background colors to their normal values.


/* 20 */
 for ( row=0; row<numRows; row++ )
 for ( col=0; col<numCols; col++ )
 {
 r.top = row * kSquareSize;
 r.bottom = r.top + kSquareSize;
 r.left = col * kSquareSize;
 r.right = r.left + kSquareSize;
 RandomForeColor();
 PaintRect( &r );
 }

 ForeColor( blackColor );
 BackColor( whiteColor );
}

RandomForeColor() sees which color model is in use.


/* 21 */
/****************** RandomForeColor ***********************/

void  RandomForeColor( void )
{
 RGBColor color;
 HSVColor hsvColor;

If we’re using RGB colors, we’ll need to specify values for the red, green, and blue fields of the RGBColor. If random reds is turned on, we’ll use a random red, otherwise we’ll set red to 0 (no red at all). The same holds true for green and blue.


/* 22 */
 if ( gIsRGB )
 {
 if ( gRandomReds )
 color.red = Random();
 else
 color.red = 0;
 
 if ( gRandomGreens )
 color.green = Random();
 else
 color.green = 0;
 
 if ( gRandomBlues )
 color.blue = Random();
 else
 color.blue = 0;

Once we set up the color, we’ll make it the new foreground color using RGBForeColor().


/* 23 */
 RGBForeColor( &color );
 }

If we’re using HSV colors, we’ll set values for the hue, saturation, and value fields. Every time you see the value field, think brightness. If gRandomHue is true, we’ll use a random hue, otherwise we’ll use the value stored in gGlobalHue.


/* 24 */
 else
 {
 if ( gRandomHue )
 hsvColor.hue = Random();
 else
 hsvColor.hue = gGlobalHue;

The same holds true for saturation and brightness, except that if random saturation or brightness is turned off, we’ll use a value of 65535 for the saturation or value fields.


/* 25 */
 if ( gRandomSaturation )
 hsvColor.saturation = Random();
 else
 hsvColor.saturation = 65535;
 
 if ( gRandomBrightness )
 hsvColor.value = Random();
 else
 hsvColor.value = 65535;

Next, we’ll convert the HSV color to an RGB color by calling HSV2RGB() and then pass the RGB color to RGBForeColor().


/* 26 */
 HSV2RGB( &hsvColor, &color );
 RGBForeColor( &color );
 }
}

GWorldInit() starts by loading the PICT resource.


/* 27 */
/****************** GWorldInit ***********************/

void  GWorldInit( void )
{
 PicHandlepic;
 
 pic = GetPicture( kForegroundPICT );

 if ( pic == nil )
 DoError( "\pError loading PICT..." );

// Call HNoPurge() if your PICT is purgeable

We’ll normalize the PICT’s frame (offset it to (0,0)).


/* 28 */
 gPictWorldRect = (**pic).picFrame;
 OffsetRect( &gPictWorldRect, - gPictWorldRect.left,
  - gPictWorldRect.top );

gWorldRect is set to be 2 pixels taller and 2 pixels wider than the PICT. That gives us room for a one pixel border all the way around.


/* 29 */
 gWorldRect = gPictWorldRect;
 gWorldRect.bottom += 2;
 gWorldRect.right += 2;

Next, we call our own MakeGWorld() routine to build one GWorld the size of the PICT and two the size of gWorldRect, storing the pointers in our three globals.


/* 30 */
 gPictWorld = MakeGWorld( &gPictWorldRect );
 gSaveWorld = MakeGWorld( &gWorldRect );
 gSaveMixWorld = MakeGWorld( &gWorldRect );

When we create a GWorld, a PixMap is created for us. We’ll call GetGWorldPixMap() to store the handle to each PixMap in its respective global.


/* 31 */
 gPixMapPict = GetGWorldPixMap( gPictWorld );
 gPixMapSave = GetGWorldPixMap( gSaveWorld );
 gPixMapSaveMix = GetGWorldPixMap( gSaveMixWorld );

Next, we’ll lock all three PixMaps in memory. Why? Just as you’d lock a handle before you singly dereferenced it to access its pointer, you lock your PixMap before you draw into it. Normally, you’d lock the pixels just before you draw, then unlock the pixels after the call to the drawing routine returns to prevent heap fragmentation. To keep things simple, we’re just going to lock all three PixMaps for the duration of the program.


/* 32 */
 if ( ! LockPixels( gPixMapPict ) )
 DoError( "\pLockPixels failed..." );

 if ( ! LockPixels( gPixMapSave ) )
 DoError( "\pLockPixels failed..." );

 if ( ! LockPixels( gPixMapSaveMix ) )
 DoError( "\pLockPixels failed..." );

Finally, we’ll make the gPictWorld the current GWorld and draw the PICT in it. SetGWorld() makes the specified GWorld the current port and the current gWorld, just as a call to SetPort() might make a window the current port.


/* 33 */
 SetGWorld( gPictWorld, kIgnored );
 
 DrawPicture( pic, &gPictWorldRect );
}

MakeGWorld() calls NewGWorld() to create a new GWorld, returning a pointer to the new GWorld. Look up NewGWorld() in Inside Macintosh, Volume VI or in THINK Reference for more detail on the parameters. The first parameter is the address of the GWorldPtr that will eventually point to the new GWorld. The second parameter specifies the pixel depth of the new GWorld. By passing in a value of 0, we’re asking NewGWorld() to use the deepest device that intersects boundsPtr, the third parameter. The fourth and fifth parameters specify a color table and a GDevice, in case you want to roll your own. We’ll pass nil in for each, asking NewGWorld() to take care of these parameters for us. The final parameter lets us set special GWorld flags. We’ll pass in 0, ignoring the flags. You can read about these flags in the description of NewGWorld().


/* 34 */
/*********************************** MakeGWorld */

GWorldPtr MakeGWorld( Rect *boundsPtr )
{
 QDErr  err;
 GWorldPtrnewGWorld;

 err = NewGWorld( &newGWorld, kUseMaxDepth,
 boundsPtr, kIgnored, kIgnored, noNewDevice );

// In the real world, call DisposeGWorld() when you are done with the 
GWorld...
 
 if ( err != noErr )
 DoError( "\pMy call to NewGWorld died!  Bye..." );
 
 return( newGWorld );
}

EventLoop() does its normal thing with one exception. Each time through the loop, the position of the floater is updated via a call to MoveFloater().


/* 35 */
/************************************* EventLoop */

void  EventLoop( void )
{
 EventRecordevent;
 
 gDone = false;
 while ( gDone == false )
 {
 if ( WaitNextEvent( everyEvent, &event, kSleep, NULL ) )
 DoEvent( &event );
 MoveFloater();
 }
}

DoEvent() does its normal thing. Notice that we do the absolute minimum when it comes to handling update events. You might want to handle update events in your own code...


codeexamplestart

/* 36 */

/************************************* DoEvent */

void  DoEvent( EventRecord *eventPtr )
{
 char theChar;
 
 switch ( eventPtr->what )
 {
 case mouseDown: 
 HandleMouseDown( eventPtr );
 break;
 case keyDown:
 case autoKey:
 theChar = eventPtr->message & charCodeMask;
 if ( (eventPtr->modifiers & cmdKey) != 0 ) 
 HandleMenuChoice( MenuKey( theChar ) );
 break;
 case updateEvt:
 BeginUpdate( (WindowPtr)(eventPtr->message) );
 EndUpdate( (WindowPtr)(eventPtr->message) );
 break;
 }
}


The next three routines are the same as ever


/* 37 */
/************************************* HandleMouseDown */

void  HandleMouseDown( EventRecord *eventPtr )
{
 WindowPtrwindow;
 short  thePart;
 long   menuChoice;
 
 thePart = FindWindow( eventPtr->where, &window );
 
 switch ( thePart )
 {
 case inMenuBar:
 menuChoice = MenuSelect( eventPtr->where );
 HandleMenuChoice( menuChoice );
 break;
 case inSysWindow : 
 SystemClick( eventPtr, window );
 break;
 }
}

/************************************* HandleMenuChoice */

void  HandleMenuChoice( long menuChoice )
{
 short  menu;
 short  item;
 
 if ( menuChoice != 0 )
 {
 menu = HiWord( menuChoice );
 item = LoWord( menuChoice );
 
 switch ( menu )
 {
 case mApple:
 HandleAppleChoice( item );
 break;
 case mFile:
 HandleFileChoice( item );
 break;
 case mColors:
 HandleColorsChoice( item );
 break;
 }
 HiliteMenu( 0 );
 }
}


/************************************* HandleAppleChoice */

void  HandleAppleChoice( short item )
{
 MenuHandle appleMenu;
 Str255 accName;
 short  accNumber;
 
 switch ( item )
 {
 case iAbout:
 SysBeep( 20 );
 break;
 default:
 appleMenu = GetMHandle( mApple );
 GetItem( appleMenu, item, accName );
 accNumber = OpenDeskAcc( accName );
 break;
 }
}

When Redraw is selected from the File menu, HandleFileChoice() calls PaintWindow() to redraw the PixMapper window, then calls DrawFirstFloater() to redraw the floater in its initial position.


/* 38 */
/************************************* HandleFileChoice */

void  HandleFileChoice( short item )
{
 switch ( item )
 {
 case iRedraw:
 PaintWindow();
 DrawFirstFloater();
 break;
 case iQuit:
 gDone = true;
 break;
 }
}

HandleColorsChoice() handles all the logic of the Colors menu, changing items and modifying globals as needed. CheckItem() places or removes the check mark from a menu’s item. Once the change is made, we call PaintWindow() and DrawFirstFloater() to restart the process with the modified color scheme.


/* 39 */
/************************************* HandleColorsChoice */

void  HandleColorsChoice( short item )
{
 MenuHandle menu;
 
 menu = GetMenu( mColors );
 
 if ( item == iUseRGB )
 {
 gIsRGB = true;
 
 SetItem( menu, iRed, "\pRandom Reds" );
 SetItem( menu, iGreen, "\pRandom Greens" );
 SetItem( menu, iBlue, "\pRandom Blues" );
 
 CheckItem( menu, iUseRGB, true );
 CheckItem( menu, iUseHSV, false );
 CheckItem( menu, iRed, gRandomReds );
 CheckItem( menu, iGreen, gRandomGreens );
 CheckItem( menu, iBlue, gRandomBlues );
 }
 else if ( item == iUseHSV )
 {
 gIsRGB = false;
 
 SetItem( menu, iHue, "\pRandom Hue" );
 SetItem( menu, iSaturation, "\pRandom Saturation" );
 SetItem( menu, iBrightness, "\pRandom Brightness" );
 
 CheckItem( menu, iUseRGB, false );
 CheckItem( menu, iUseHSV, true );
 CheckItem( menu, iHue, gRandomHue );
 CheckItem( menu, iSaturation, gRandomSaturation );
 CheckItem( menu, iBrightness, gRandomBrightness );
 }
 else if ( gIsRGB )
 {
 switch ( item )
 {
 case iRed:
 gRandomReds = !gRandomReds;
 CheckItem( menu, iRed, gRandomReds );
 break;
 case iGreen:
 gRandomGreens = ! gRandomGreens;
 CheckItem( menu, iGreen, gRandomGreens );
 break;
 case iBlue:
 gRandomBlues = ! gRandomBlues;
 CheckItem( menu, iBlue, gRandomBlues );
 break;
 }
 }
 else
 {
 switch ( item )
 {
 case iHue:
 gRandomHue = !gRandomHue;
 CheckItem( menu, iHue, gRandomHue );
 break;
 case iSaturation:
 gRandomSaturation = ! gRandomSaturation;
 CheckItem( menu, iSaturation, gRandomSaturation );
 break;
 case iBrightness:
 gRandomBrightness = ! gRandomBrightness;
 CheckItem( menu, iBrightness, gRandomBrightness );
 break;
 }
 }
 PaintWindow();
 DrawFirstFloater();
}

Here comes the really important stuff. Just as it did in BitMapper, CopyBits() is used to copy a block of pixels from one offscreen to another. Though CopyBits() expects to work with pointers to BitMaps, it can handle either BitMaps or PixMaps. Since the compiler isn’t aware that the called function can handle two different types (BitMap or PixMap), a bit of typecasting is necessary.


/* 40 */
/****************** DrawFirstFloater *********************/

void  DrawFirstFloater( void )
{

Each call to CopyBits() copies from the first parameter (the source BitMap or PixMap) to the second (destination BitMap or PixMap), using the Rects in the third and fourth parameters. If the rectangles are the same size, no scaling happens, and that’s what we do here. If they are different sizes, CopyBits() stretches or squashes the source to fit the destination. The srcCopy mode tells CopyBits() to replace all the destination bits with the appropriate source bits. The transparent mode, on the other hand, tells the compiler not to copy the white pixels. This comes in handy when we copy a non-rectangular or non-solid image from one GWorld to another. The last parameter to CopyBits() specifies an optional mask parameter which we won’t use. Passing nil tells CopyBits() to ignore this parameter.

The first call to CopyBits() copies the background of the PixMapper window into the gPixMapSave PixMap. We’re saving away the pixels we’re about to obliterate with the PICT, with an extra one pixel border we’ll need when the floater moves in one direction or the other.


/* 41 */
 CopyBits( &(gMainWindow->portBits), 
 (BitMap *)(*gPixMapSave),
 &gWorldRect, &gWorldRect, srcCopy, nil );

Next, we’ll set up a Rect the size of the PICT that is 1 pixel down and 1 pixel to the right of the upper left corner of the window. This is where we’ll plot the PICT.


/* 42 */
 gSavedFloaterRect = gPictWorldRect;
 OffsetRect( &gSavedFloaterRect, 1, 1 );

This draws the PICT in the PixMapper window.


/* 43 */
 CopyBits( (BitMap *)(*gPixMapPict), 
 &(gMainWindow->portBits),
 &gPictWorldRect, &gSavedFloaterRect, transparent, nil );
}

MoveFloater() calls CalcNewFloaterPosition() to update the values of gXBump and gYBump in case the floater hits the edge of the window.


/* 44 */
/****************** MoveFloater *********************/

void  MoveFloater( void )
{
 Rect   r;
 RgnHandlenewRgn, savedRgn, oldClip;

 CalcNewFloaterPosition();

This copies the saved pixels to the mixer GWorld.


/* 45 */
 CopyBits( (BitMap *)(*gPixMapSave), 
 (BitMap *)(*gPixMapSaveMix),
 &gWorldRect, &gWorldRect, srcCopy, nil );

Next, we’ll position a Rect the size of the PICT in the mix GWorld using gXBump and gYBump. This Rect is the new position for the floater in the mix GWorld. Then we CopyBits() the floater on top of the saved pixels in the mixing GWorld. Remember, we used transparent mode so we’d only draw the non-background pixels. You would handle this differently if you needed to draw white pixels.


/* 46 */
 r = gPictWorldRect;
 OffsetRect( &r, gXBump + 1, gYBump + 1 );
 
 CopyBits( (BitMap *)(*gPixMapPict), 
 (BitMap *)(*gPixMapSaveMix),
 &gPictWorldRect, &r, transparent, nil );

Next, we construct a Rect at the floater’s last position in the PixMapper window, then make it one pixel bigger in all directions (the size of the mixing GWorld). We’re use this Rect to copy the contents of the mixing GWorld into the window.


/* 47 */
 r = gSavedFloaterRect;
 InsetRect( &r, -1, -1 );

 CopyBits( (BitMap *)(*gPixMapSaveMix), 
 &(gMainWindow->portBits),
 &gWorldRect, &r, srcCopy, nil );

Next, we update the saved floater position stored in gSavedFloaterRect to reflect the new position.


/* 48 */
 OffsetRect( &gSavedFloaterRect, gXBump, gYBump );

Following that, we’ll create our one pixel bigger Rect again, this time at the floater’s new position, and copy the floater, with a one pixel border, into the mixing GWorld.


/* 49 */
 r = gSavedFloaterRect;
 InsetRect( &r, -1, -1 );
 
 CopyBits( &(gMainWindow->portBits), 
 (BitMap *)(*gPixMapSaveMix),
 &r, &gWorldRect, srcCopy, nil );

Next, we’ll copy the saved pixels into the appropriate position in the mixing GWorld. The idea here is that we are reconstructing the pixels that should be behind the floater.


/* 50 */
 r = gWorldRect;
 OffsetRect( &r, -gXBump, -gYBump );
 
 CopyBits( (BitMap *)(*gPixMapSave), 
 (BitMap *)(*gPixMapSaveMix),
 &gWorldRect, &r, srcCopy, nil );

Finally, we’ll copy the reconstructed “behind the floater” pixels from the mix GWorld into the save GWorld. We are now ready to move the floater all over again.


/* 51 */
 CopyBits( (BitMap *)(*gPixMapSaveMix),
 (BitMap *)(*gPixMapSave),
 &gWorldRect, &gWorldRect, srcCopy, nil );
}

This routine figures out if bumping the floater will move it off the edge of the window in any direction. If so, we change the direction of floater movement so the it moves away from that edge, rather than towards it.


/* 52 */
/*********************************** CalcNewFloaterPosition */

void  CalcNewFloaterPosition( void )
{
 Rect r;
 
 r = gSavedFloaterRect;
 
 OffsetRect( &r, gXBump, gYBump );
 
 if ( (r.left < gMainWindow->portRect.left) ||
 ( r.right > gMainWindow->portRect.right ) )
 gXBump *= -1;
 
 if ( (r.top < gMainWindow->portRect.top) ||
 ( r.bottom > gMainWindow->portRect.bottom ) )
 gYBump *= -1;
}

You’ve seen this one before...


/* 53 */
/***************** DoError ********************/

void  DoError( Str255 errorString )
{
 ParamText( errorString, kEmptyString, 
 kEmptyString, kEmptyString );
 
 StopAlert( kErrorAlertID, kNilFilterProc );
 
 ExitToShell();
}

Till Next Month...

Don’t worry too much about the specifics of the PixMapper algorithm. The important things to understand are how to construct a GWorld, how to use CopyBits() to copy PixMaps between GWorlds and windows, and the basics of working with color. Try your hand at adding some new color schemes to the program. Try going back to Color Mondrian and playing with those colors. Try working with the HSV model, varying only the hue, leaving the saturation and brightness constant. Sometimes RGB does just fine, but sometimes the HSV model really comes in handy.

[If you have a need for even more speed, then you need to think about helping QuickDraw go as fast as it can. There are a number of clues that you can give QuickDraw about what you are doing. CopyBits often gets blamed for poor performance, and it’s true that it can take a good bit of time if you ask it to do something extremely complex (it is capable of a wide range of transforms). If you get to know the call well (by reading Inside Macintosh and the wide variety of sample code available), you can get some blazing speed if you use one of the optimized cases. Many game writers have started out with the assumption that they should avoid CopyBits and write their own blitting routine for performance, only to surprise themselves with the speed CopyBits can offer if used well. Not only can you get terrific performance on 68K Macs, you should try this out on Power Macs where QuickDraw has been rewritten to take advantage of all that PowerPC horsepower. - Ed stb]

I am very interested in animation. I’d love to see your own animation based programs. Once you’ve got something you think is cool, please send the application (no source code, please) to me on Compuserve. My CompuServe address is [70007,2530]. Good luck!

If you can hold out till summer, there’s a new book that you might be interested in. It’s called Ultimate Mac Programming, and (among other things) it will cover both animation and sound. If you are interested in game programming, you might want to check it out. I’ll tell you more about the book as it progresses.

- DM

 

Community Search:
MacTech Search:

Software Updates via MacUpdate

Yasu 4.0.0 β - System maintenance app; p...
Yasu was created with System Administrators who service large groups of workstations in mind, Yasu (Yet Another System Utility) was made to do a specific group of maintenance tasks quickly within a... Read more
Skype 7.37.0.178 - Voice-over-internet p...
Skype allows you to talk to friends, family and co-workers across the Internet without the inconvenience of long distance telephone charges. Using peer-to-peer data transmission technology, Skype... Read more
EtreCheck 3.0.5 - For troubleshooting yo...
EtreCheck is an app that displays the important details of your system configuration and allow you to copy that information to the Clipboard. It is meant to be used with Apple Support Communities to... Read more
Amadeus Pro 2.3.1 - Multitrack sound rec...
Amadeus Pro lets you use your Mac computer for any audio-related task, such as live audio recording, digitizing tapes and records, converting between a variety of sound formats, etc. Thanks to its... Read more
NeoFinder 6.9.3 - Catalog your external...
NeoFinder (formerly CDFinder) rapidly organizes your data, either on external or internal disks, or any other volumes. It catalogs all your data, so you stay in control of your data archive or disk... Read more
WhatsApp 0.2.1880 - Desktop client for W...
WhatsApp is the desktop client for WhatsApp Messenger, a cross-platform mobile messaging app which allows you to exchange messages without having to pay for SMS. WhatsApp Messenger is available for... Read more
Hazel 4.0.6 - Create rules for organizin...
Hazel is your personal housekeeper, organizing and cleaning folders based on rules you define. Hazel can also manage your trash and uninstall your applications. Organize your files using a familiar... Read more
Apple iBooks Author 2.5 - Create and pub...
Apple iBooks Author helps you create and publish amazing Multi-Touch books for iPad. Now anyone can create stunning iBooks textbooks, cookbooks, history books, picture books, and more for iPad. All... Read more
MYStuff Pro 2.0.26 - $39.99
MYStuff Pro is the most flexible way to create detail-rich inventories for your home or small business. Add items to MYStuff by dragging and dropping existing information, uploading new images, or... Read more
MarsEdit 3.7.8 - Quick and convenient bl...
MarsEdit is a blog editor for OS X that makes editing your blog like writing email, with spell-checking, drafts, multiple windows, and even AppleScript support. It works with with most blog services... Read more

How to get past Vulture Island's tr...
Vulture Island is a colorful and quirky mish-mash of platforming and puzzles. It’s creative and fresh, but sometimes the game can throw a curveball at you, leaving you stuck as to how you should progress. These tips will help you explore smoothly... | Read more »
The new Clash of Kings is just for Weste...
If you’ve played the original Clash of Kings, you’ll probably recognise the city building, alliance forging and strategic battles in Clash of Kings: The West. What sets this version apart is that it’s tailor made for a Western audience and the... | Read more »
Frost - Survival card game (Games)
Frost - Survival card game 1.12.1 Device: iOS Universal Category: Games Price: $3.99, Version: 1.12.1 (iTunes) Description: *Warning: the game will work on iPhone 5C and above and iPad Pro / 4. Other devices are not supported* | Read more »
How to build and care for your team in D...
Before you hit the trail and become a dog sledding legend, there’s actually a fair bit of prep work to be done. In Dog Sled Saga, you’re not only racing, you’re also building and caring for a team of furry friends. There’s a lot to consider—... | Read more »
How to win every race in Dog Sled Saga
If I had to guess, I’d say Dog Sled Saga is the most adorable racing game on the App Store right now. It’s a dog sled racing sim full of adorable, loyal puppies. Just look at those fluffy little tails wagging. Behind that cute, pixelated facade is... | Read more »
Let the war games commence in Gunship Ba...
Buzz Lightyear famously said, “This isn’t flying, this is falling – with style!” In the case of Gunship Battle: Second War, though, this really is flying - with style! The flight simulator app from Joycity puts you in control of 20 faithfully... | Read more »
How to get a high score in Fired Up
Fired Up is Noodlecake Games’ high score chasing, firefighting adventure. You take control of a wayward firefighter who propels himself up the side of a highrise with blasts of water. Sound silly? It is. It’s also pretty difficult. You can’t... | Read more »
NBA 2K17 (Games)
NBA 2K17 1.0 Device: iOS iPhone Category: Games Price: $7.99, Version: 1.0 (iTunes) Description: Following the record-breaking launch of NBA 2K16, the NBA 2K franchise continues to stake its claim as the most authentic sports video... | Read more »
Dog Sled Saga (Games)
Dog Sled Saga 1.0.1 Device: iOS Universal Category: Games Price: $3.99, Version: 1.0.1 (iTunes) Description: A game by Dan + Lisa As a rookie musher, foster a dogsledding team whose skills will grow if they're treated right. Week by... | Read more »
60 Seconds! Atomic Adventure (Games)
60 Seconds! Atomic Adventure 1.2 Device: iOS Universal Category: Games Price: $2.99, Version: 1.2 (iTunes) Description: 60 Seconds! is a dark comedy atomic adventure of scavenge and survival. Collect supplies and rescue your family... | Read more »

Price Scanner via MacPrices.net

21-inch iMacs on sale for up to $120 off MSRP
B&H Photo has 21″ iMacs on sale for up to $120 off MSRP including free shipping plus NY sales tax only: - 21″ 3.1GHz iMac 4K: $1379 $120 off MSRP - 21″ 2.8GHz iMac: $1199.99 $100 off MSRP - 21″ 1... Read more
13-inch 2.7GHz/256GB Retina MacBook Pro on sa...
Amazon.com has the 13″ 2.7GHz/256GB Retina Apple MacBook Pro on sale for $151 off MSRP including free shipping: - 13″ 2.7GHz/256GB Retina MacBook Pro (sku MF840LL/A): $1348 $151 off MSRP Read more
Apple TVs on sale for up to $50 off MSRP
Best Buy has 32GB and 64GB Apple TVs on sale for $40-$50 off MSRP on their online store. Choose free shipping or free local store pickup (if available). Sale prices for online orders only, in-store... Read more
Apple refurbished 13-inch Retina MacBook Pros...
Apple has Certified Refurbished 13″ Retina MacBook Pros available for up to $270 off the cost of new models. An Apple one-year warranty is included with each model, and shipping is free: - 13″ 2.7GHz... Read more
Duplicate Sweeper Free On Mac App Store For O...
To celebrate the launch of Apple’s latest macOS Sierra, Stafford, United Kingdom based Wide Angle Software has announced that its duplicate file finder software, Duplicate Sweeper, is now available... Read more
13-inch Retina MacBook Pros on sale for up to...
B&H Photo has 13″ Retina Apple MacBook Pros on sale for up to $150 off MSRP. Shipping is free, and B&H charges NY tax only: - 13″ 2.7GHz/128GB Retina MacBook Pro: $1174.99 $125 off MSRP - 13... Read more
Evidence Surfaces Pointing To New A10X Chip F...
Citing a job description for a Project Lead position at Apple’s Austin, Texas engineering labs, Motley Fool’s Ashraf Eassa deduces that development is progressing well on Apple’s next-generation in-... Read more
Check Print’R for macOS Allows Anyone to Easi...
Delaware-based Match Software has announced the release and immediate availability of Check Print’R 3.21, an important update to their easy-to-use check printing application for macOS. Check Print’R... Read more
Apple refurbished 11-inch MacBook Airs availa...
Apple has Certified Refurbished 11″ MacBook Airs (the latest models), available for up to $170 off the cost of new models. An Apple one-year warranty is included with each MacBook, and shipping is... Read more
Apple refurbished 15-inch Retina MacBook Pros...
Apple has Certified Refurbished 2015 15″ Retina MacBook Pros available for up to $380 off the cost of new models. An Apple one-year warranty is included with each model, and shipping is free: - 15″ 2... Read more

Jobs Board

Sr. *Apple* Mac Engineer - Net2Source Inc....
…staffing, training and technology. We have following position open with our client. Sr. Apple Mac Engineer6+ Months CTH Start date : 19th Sept Travelling Job If Read more
*Apple* Retail - Multiple Positions-Norfolk,...
Job Description: Sales Specialist - Retail Customer Service and Sales Transform Apple Store visitors into loyal Apple customers. When customers enter the store, Read more
Restaurant Manager (Neighborhood Captain) - A...
…in every aspect of daily operation. WHY YOU'LL LIKE IT: You'll be the Big Apple . You'll solve problems. You'll get to show your ability to handle the stress and Read more
Lead *Apple* Solutions Consultant - Apple (...
# Lead Apple Solutions Consultant Job Number: 51829230 Detroit, Michigan, United States Posted: Sep. 19, 2016 Weekly Hours: 40.00 **Job Summary** The Lead ASC is an Read more
US- *Apple* Store Leader Program - Apple (Un...
…Summary Learn and grow as you explore the art of leadership at the Apple Store. You'll master our retail business inside and out through training, hands-on Read more
All contents are Copyright 1984-2011 by Xplain Corporation. All rights reserved. Theme designed by Icreon.