TweetFollow Us on Twitter

Animation Algorithm
Volume9
Number11
Column TagC Workshop

Related Info: Color Quickdraw Gestalt Manager

From Algorithm to Animation

The making of a movie

By Jay Martin Anderson, Lancaster, Pennsylvania

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

About the author

Jay Anderson is Professor of Computer Science in the Department of Mathematics at Franklin and Marshall College in Lancaster, Pennsylvania. Trained as a physical chemist, he combines here his interest in quantum mechanics, mathematics, and Macintosh software development.

He can be reached at j_anderson@acad.fandm.edu on Internet.

Description of the problem

In presenting an algorithm for the solution of a particular kind of differential equation to a class in Computational Mathematics in the spring of 1992, I was led first to illustrate the algorithm with a graph, then with a series of graphs, and finally with an animated series of graphs. The product uses simply, but significantly, Color QuickDraw and QuickTime. The result is an engaging, yet helpful look at the workings of a numerical algorithm as applied to a textbook problem in quantum mechanics.

The algorithm.

The particular problem we solved arises in physics or chemistry courses in quantum mechanics, for it helps to illustrate the concept of “tunneling.” From a mathematics point of view, the problem is one of a subclass of differential equations.

Ordinary differential equations are equations which involve derivatives of a function with respect to one independent variable; first-degree ordinary differential equations involve only the first derivative. A system of first-degree ordinary differential equations involves two or more dependent variables and their first derivatives with respect to one independent variable. It is possible to write a single second-degree differential equation as a system of two first-degree differential equations.

The quantum-mechanical problem is this: particle, moving in only one dimension, is influenced by no potential energy over a part of its range, and by a constant potential energy (a “barrier”) over another part of its range. The quantum mechanics student is challenged to find what allowed energies the particle may assume, called eigenvalues or characteristic values of energy. If an energy eigenvalue is less than the potential energy barrier, the particle is said to “tunnel through the barrier,” and that state is referred to as “classically forbidden.” If an energy eigenvalue is greater than the potential energy barrier, that state is called “classically allowed.” In either case, the state is allowed by quantum mechanics and is observed in the world of electrons, atoms, and molecules.

Trimming the problem to its bare essentials, we endeavor to find solutions to the equation

where E is the (unknown) energy eigenvalue, and A is the constant potential energy. This is a very simple example of the famous Schrödinger equation of quantum mechanics, also called the “wave equation.” The function y(x), which satisfies this equation, is called an eigenfunction or a wave function. We can make this one second-degree differential equation into two first-degree differential equations by substituting a new variable for the first derivative of y:

Bear in mind that, in our specific problem, A = 0 for some range of x, and A 0 for some other range of x. In particular, we choose

A = 0 for -1 ¾ x < 0 A > 0 for 0 ¾ x ¾ 1

Figure 1. A region with a potential energy barrier

Finally, we are compelled to impose some constraints on the or eigenfunction y as well:

The last condition means that the slope of the eigenfunction must be continuous even where the potential energy changes value.

Well, enough for quantum mechanics and mathematics; on to some computer science, or at least some computational mathematics. There are good algorithms for solving systems of ordinary differential equations if both the value and the slope of the eigenfunction are known at one value of the independent variable; these algorithms are “initial value methods,” and a simple, but adequate method is the Runge-Kutta method. The Runge-Kutta method begins with a value of y and dy/dx at x = -1 and works forward towards x = +1 in small steps, to find the values of y along the way.

But that is not what is needed here; in fact, we don’t know the value of dy/dx at x = -1, but we do know the values of y at both x = -1 and x = +1. What we need is not an initial value method but a “boundary value method,” for we know values at both boundaries.

The “shooting method” is an example of a boundary value method. In the shooting method, we guess an eigenvalue of E, the energy, and we presume an initial value of dy/dx. Then we “shoot”: that is, we use an initial value method such as the Runge-Kutta method to shoot towards the other boundary. If our “shot” hits the other boundary condition, then we have a solution; if it doesn’t, we try again. We continue trying until our shot hits the other boundary accurately enough to satisfy us.

This method is computationally intensive, for it requires repeating the Runge-Kutta method over and over again until arbitrary accuracy has been achieved in shooting at the right boundary. The method carries with it, and compounds, all the errors of the Runge-Kutta method, but it works fast enough and is accurate enough for this problem to give students some insight into both methods for solving boundary value problems, and the quantum-mechanical tunneling problem in particular.

The desired effect

It is useful, in any method for solving ordinary differential equations, to be able to graph the solution; it is particularly useful in the shooting method for solving boundary value problems, to be able to graph approaches to the solution; that is, to graph different “shots.” But it is most useful to be able to graph a series of shots as they approach the shot which is the solution to the boundary value problem. This can be done in an effective and engaging way with animation.

In addition, since this particular boundary value problem has many solutions (in fact, there are an infinite number of eigenvalues E and eigenfunctions y which satisfy the system of equations and its constraints), it is possible to show how the shooting method finds the first eigenvalue, and then the second, and then the third, and so forth. This leads us to a sequence of graphs which approach and find the first solution, then approach and find the second solution, etc.

Finally, it would be nice to call a student’s attention to the solutions with sound, or color, or both.

Our desired effect, then, is an animated graph, accompanied by visual or audible cues that solutions have been found. This series should begin with values of E less than the first eigenvalue, and extend to include the first few (I chose five) eigenvalues. The result will be a sound movie of many shots, showing five solutions to the problem.

The Shooting Method

As mentioned above, the shooting method is based on a method for solving an initial value problem in ordinary differential equations, such as the Runge-Kutta method. The Runge-Kutta method, and code in C or Pascal to implement it, can be found in any of a number of standard textbooks, so there is no need to belabor that point here. A library of numerical mathematics may also have source or object code for the Runge-Kutta method.

To graph an individual “shot,” we must first design a Macintosh window to receive the graph, and then develop a transformation to map the real-world variables of y and x onto the window variables of horizontal and vertical pixels. This transformation is the so-called “windowing transformation” of classical two-dimensional computer graphics. Then, for each step in each Runge-Kutta shot, we use QuickDraw LineTo in order to draw a step of the graph of the trial solution.

This would be sufficient for a single graph of a single shot, but it is insufficient for a sequence of graphs of shots, leading up to a movie of the search for a solution. In figures 2, 3, and 4, only the graphics are shown for clarity; the actual window also contains text labels.

Figure 2. A trial solution, or “shot”

Figure 3. A solution, or successful shot

Searching for Several Solutions

It has become almost paradigmatic in Macintosh developer’s circles now to “never draw directly to the screen.” There are a number of reasons for this, usually having to do with maintaining independence of the programmer’s graphics world from the user’s choice of monitor, color depth, etc. In our case, we need to preserve a common background for a graph while constantly displaying a different shot. Furthermore, the successful shots or solutions, must also be preserved even as additional shots are drawn.

The offscreen graphics world. An offscreen graphics world, or GWorld, consists of a grafport and a graphics device and their associated data structures. For our purposes, we may think of it as the content area of a window, set up as we want it to be, and into which we can draw just as if we were drawing into a real window on the screen.

How many GWorlds? For our purposes, we will need two offscreen GWorlds. One will contain background; the background will include axes, labels, a colored field onto which the graph of a trial solution will be placed, etc. The background will also contain each solution as it is found. The second GWorld will contain only one shot superimposed upon the background.

Figure 4. The background (at the beginning)

Copying bits.

Our paradigm for constructing a sequence of images of shots, in which the successful shots are saved, is this:

1. Create a background GWorld; fill it with background material.

2. Create a foreground GWorld; make it blank.

3. For each shot, draw the shot on the foreground. Then, copy the background onto the foreground using mode srcOr. Finally, copy the combination to the screen using mode srcCopy. The result is a flicker-free sequence of shots drawn on a constant background.

4. For each successful shot, draw that successful shot into the background; for emphasis, use a contrasting color. Each successful shot (that is, each solution to the Schrödinger equation) is then saved in the background and becomes a backdrop for the search for additional solutions. For additional emphasis, I used a reddish color for the “classically forbidden” solutions, and a greenish color for the “classically allowed” solutions. Finally, I fetched a sound resource from the system resource file, and played it at each successful solution.

Making a QuickTime Movie

The final step in this process is constructing a QuickTime movie from the sequence of snapshots. To do this, I borrowed heavily from the QuickTime Developer’s Kit (1.0) for sample code.

Since I use IT Maker’s Prototyper and THINK C as my development environment, I needed to embed the QuickTime code into the appropriate modules of code emitted by Prototyper. The source code listings which accompany the printed article show only fragments of only those files constructed by Prototyper in which I made significant modifications.

I copied the QuickTime #defines and global variables into the Prototyper PComUtil_xxx.c and PComUtil_xxx.h files, and replaced Prototyper’s code for opening, saving, and closing files with the QuickTime code for opening, saving, and closing movies. Portions of the final header file and source code file are shown in listings one and two.

I embedded the QuickTime code for adding a frame to a video track in my code for drawing offscreen and copying onscreen, mentioned above. Listing three shows the code which does the Runge-Kutta method, the Shooting method, builds the offscreen GWorlds, does the off- and on-screen drawing, and copies the frames to the QuickTime movie.

In order to leave final frame in the movie for a few seconds, I simply copied sufficient frames of the final shot into the video track. I provided for the final frame to remain on screen for about two and one-half seconds.

Of course, it is necessary for a proper application to confirm that color QuickDraw and QuickTime are both installed before proceeding. The programmer uses the Gestalt Manager to do this; fortunately, Prototyper emits this code for me.

Some extras

At this point I had a silent, color, QuickTime movie; one movie for each value of the potential energy A I wished to study. But real movies include titles and credits, and so I quickly developed an application to make a scrolling title for my movies using techniques similar to those above. Text is read from a file and drawn in an offscreen world. The offscreen world is transferred into another offscreen world, offsetting by one additional pixel for each frame. The frames are then saved to the video track of the movie, and also displayed on the screen. One could equally well select a commercial QuickTime application for this purpose.

For fun, I sampled the CD of one of my favorite operas for music to play over the titles and credits, and I sampled five symphonic chords from this opera for music to play whenever a solution is found. Instead of developing my own application to add the sound track, I used Adobe Premiere to position my “sound bites” correctly relative to the video frames.

The result is a color, sound movie of shots attempting to find the first five eigenvalues and eigenfunctions of the particle with the potential barrier.

Results

I have made several video clips using different values of A, the potential energy barrier. Four of these, for A = 5, 10, 20, and 40, are included in my final movie. My video clips are 318 x 219 pixels, with eight-bit color depth; each sequence runs about 25-30 seconds. These clips occupy about 750k each.

I have five digitized samples of rich, symphonic chords from the last act of Billy Budd by Benjamin Britten used to mark the five eigenvalues found by the shooting method. Each of these sound bites occupies a few tens of kbytes and lasts about 2.5 seconds. In addition, I digitally recorded about 45 seconds of the prologue to Billy Budd to use as sound over the titles and credits.

It is relatively straightforward to use Premiere to add a sound track with my sampled chords to the video clips of the sequence of shots for a given value of A. It is quite simple to use Premiere to add the prologue music to my QuickTime movies of titles and of credits.

The title movie is about 1.2 Mb, and the credits movie is about 3.0 Mb. Any simple movie player, such as that supplied by Apple with the QuickTime Starter Kit suffices to combine the titles, the animated sequence of shots, and the credits into a feature film replete with color and symphonic sound. After assembling the entire movie and applying some compression, the finished product is about 9 Mb for title, four animations, and credits. The finished movie runs for a little more than three minutes.

Listing One
/* 
 * A FRAGMENT ONLY from the file 
 * PComUtil_Shooter.h, emitted by 
 * Prototyper for this THINK C
 * project.
 *
 * J. M. Anderson, 1993
 */

#include <AppleEvents.h>
#include <Packages.h>
#include <GestaltEqu.h>
#include <Printing.h>
/* 
 * The following is necessary for
 * offscreen graphics worlds
 */
#include <QDOffscreen.h>

/* 
 * The following copied from "Movie  
 * Construction" in the QuickTime
 * Developer's Kit
 */
#include "Movies.h"
#include "QuickTimeComponents.h"

/* #defines appropriate for QT movies */
#define x1Rate (Fixed)1<<16
 /* fixed point 1.0 */
#define myTimeScale 10
 /* time scale, frames per sec */
#define trailerTime 2.6
 /* time in secs to hold last frame */

/* 
 * Global variables for the Particle in a
 * Particle in a Box Problem
 */
extern double    energyA; /* potential barrier */
extern double    energyE; /* trial eigenvalue */
extern double  eigenvalues[5];/* eigenvalues found */
extern Boolean justOne; /* looking for just one eigenvalue? */
extern Boolean readyToRun; /* finished setup, ready to run */
extern double    energyENear; /* guess for energy eigenvalue */

/*
 * Global variables for offscreen 
 * graphics 
 */
extern GWorldPtr offPort1, offPort2;
extern Rect offRect;
extern RGBColor  bkgdColor, forbidColor, allowColor;
extern OSErrErrorCode; 

/* 
 * Global variables for making movies;
 * copied from QuickTime Developer's
 * Kit
 */
extern Boolean   canMakeMovie,   
 makingMovie;
extern MoviegMovie;
extern Track     gTrack;
extern MediagMedia;
extern GWorldPtr myGWorld, oldGWorld;
extern GDHandle  oldGDevice;
extern Rect      offGRect;
extern PixMap    *pm, **pmH;
extern char **compressedFrameBitsH;
extern long maxCompressedFrameSize;
extern long compressedFrameSize;
extern CodecType codecType;
extern CompressorComponent
 codecID;
extern shorttheDepth;
extern CodecQ    theQuality, mQuality;
extern ImageDescription   
 **imageDescriptionH;
extern ImageSequence seqID;
extern unsigned char similarity;
extern long keyFrameRate;
extern TimeValue sampTime;
/*
 * NOTE:  The actual header file also
 * includes many more #defines, extern
 * declarations, typedef declarations,
 * and function prototypes.  Only those
 * definitions and declarations relative
 * to this article have been shown here.
 */
Listing Two
/* 
 * A FRAGMENT ONLY from the file 
 * PComUtil_Shooter.c, emitted by 
 * Prototyper for this THINK C
 * project.
 *
 * J. M. Anderson, 1993
 */

/* 
 * Global variables for the Particle in a
 * Box Problem
 */
double  energyA; 
 /* potential barrier */
double  energyE;
 /* trial eigenvalue */
double  eigenvalues[5];
 /* eigenvalues found */
Boolean justOne;
 /* looking for just one eigenvalue? */
Boolean readyToRun;
 /* finished set up, want to run */
double  energyENear;
 /* guess for energy eigenvalue */
GWorldPtr offPort1, offPort2;
Rect    offRect;
RGBColorbkgdColor, forbidColor, allowColor;
OSErr   ErrorCode;
short   outputRefNum;
Str255  outputFileName;

/* 
 * Global variables for making movies;
 * most are copied from Movie Construction
 * in the QuickTime Developer's Kit  
 */
Boolean canMakeMovie, 
 makingMovie;
Movie   gMovie;
Track   gTrack;
Media   gMedia;
GWorldPtr myGWorld, oldGWorld;
GDHandleoldGDevice;
Rect    offGRect;
PixMap  *pm, **pmH;
char    **compressedFrameBitsH;
long    maxCompressedFrameSize;
long    compressedFrameSize;
CodecType codecType;
CompressorComponent
 codecID;
short   theDepth;
CodecQ  theQuality, mQuality;
ImageDescription **imageDescriptionH;
ImageSequence    seqID;
unsigned char    similarity;
long    keyFrameRate;
TimeValue sampTime;

/* 
 * CLOSE_THE_OUTPUT_FILE:  this function
 * closes the QuickTime movie file after
 * all frames have been writen to the 
 * video media; copied largely from 
 * QuickTime Developer's Kit.
 */
void Close_The_Output_File()
{
 short resID = 1;
 
 ErrorCode = CDSequenceEnd(seqID);
 if (ErrorCode) DebugStr((StringPtr) 
 "\pCDSequenceEnd Failed");
 ErrorCode = EndMediaEdits(gMedia);
 if (ErrorCode) DebugStr((StringPtr) 
 "\pEndMediaEdits Failed");
 ErrorCode = 
 InsertMediaIntoTrack(gTrack, 0L, 0L, 
 GetMediaDuration(gMedia), x1Rate);
 if (ErrorCode) DebugStr((StringPtr) 
 "\pInsertMediaIntoTrack Failed");
 ErrorCode = AddMovieResource(gMovie, 
 outputRefNum, &resID, 
 outputFileName);
 if (ErrorCode) DebugStr((StringPtr) 
 "\pAddMovieResource Failed");
 ErrorCode = 
 MakeFilePreview(outputRefNum, 
 (ProgressProcRecordPtr)-1);
 ErrorCode = 
 CloseMovieFile(outputRefNum);
 if (ErrorCode) DebugStr((StringPtr) 
 "\pCloseMovieFile Failed");

 outputRefNum = 0;
 
 /* throw out everything else */
 DisposeMovie(gMovie);
 DisposHandle(compressedFrameBitsH);
 DisposHandle((Handle)imageDescriptionH);
 DisposeGWorld(myGWorld);
}

/* 
 * SAVE_THE_FILE:  this function
 * obtains an open movie file and
 * initializes it; copied largely from 
 * QuickTime Developer's Kit.
 */
void Save_The_File()
{
 short  theVolRefNum;
 short  theRefNum;
 
 if (Do_The_Save_File(
 (Str255 *)"\pSave Movie as:",
 (Str255 *)"\pUntitled.qt",
 &theVolRefNum,&theRefNum))
 {
 ClearMoviesStickyError();
 gTrack = NewMovieTrack
 (gMovie, 
  (long)(318)<<16, 
 /* width & height copied from
  * window resource */ 
  (long)(219)<<16,
  0);
 ErrorCode = GetMoviesError();
 if (ErrorCode) DebugStr((StringPtr) 
 "\pNewMovieTrack Failed");
 gMedia = NewTrackMedia(gTrack, 
 VideoMediaType, myTimeScale, 
 nil, (OSType)nil);
 ErrorCode = GetMoviesError();
 if (ErrorCode) 
 DebugStr(
 (StringPtr)"\pNewTrackMedia
 Failed");
 ErrorCode = BeginMediaEdits(gMedia);
 if (ErrorCode) 
 DebugStr(
 (StringPtr)"\pBeginMediaEdits 
 Failed");
 
 /* 
  * Make a new GWorld into which to
  * draw frames to be compressed 
  */
 SetRect(&offGRect, 0, 0, 318, 219);
 /* size copied from resource */
 GetGWorld(&oldGWorld, &oldGDevice);
 ErrorCode = NewGWorld(&myGWorld, 8, 
 &offGRect, nil, nil, 0);
 if (ErrorCode) 
 DebugStr((StringPtr)"\pNewGWorld Failed");
 pmH = myGWorld->portPixMap;
 LockPixels(pmH);
 HLock((Handle)pmH);
 pm = *pmH;
 
 /* 
  * Make Buffers & stuff for the 
  * compressor 
  */
 codecID = anyCodec;
 codecType = (CodecType)'rpza';
 theDepth = 1;
 theQuality = 0x300;
 mQuality = 0x300;
 keyFrameRate = 10;
 imageDescriptionH = (ImageDescription **)NewHandle(4);
 ErrorCode = 
 GetMaxCompressionSize(&pm, 
 &offGRect, theDepth, theQuality,
 codecType, codecID, 
 &maxCompressedFrameSize);
 if (ErrorCode) 
 DebugStr((StringPtr)
 "\pGetMaxCompressionSize 
 Failed");
 compressedFrameBitsH = 
 NewHandle(maxCompressedFrameSize);
 if (!compressedFrameBitsH) 
 DebugStr((StringPtr)
 "\pUnable to allocate compression buffer");
 HLock(compressedFrameBitsH);
 
 /* 
  * Tell codec manager we are about 
  * to start a sequence 
  */
 ErrorCode = CompressSequenceBegin
 (&seqID, &pm, nil, &offGRect, 
 nil, theDepth, codecType,
 codecID, theQuality, mQuality, 
 keyFrameRate, nil, 
 codecFlagUpdatePrevious, 
 imageDescriptionH);
 if (ErrorCode) 
 DebugStr((StringPtr)
 "\pCompressSequenceBegin 
 Failed");
 
 /*
  * We have now finished setting
  * up the movie & compression.
     * Now, back in the mainstream,
     * we can put the movie together one 
  * frame at a time.   
  */
 SetGWorld(oldGWorld, oldGDevice);
 makingMovie = TRUE;
 }
}

/* 
 * DO_THE_SAVE_FILE:  this function puts
 * up the StandardPutFile dialog box,
 * obtains a file name for the movie,
 * and creates or opens it.  It is a
 * modification of the code emitted by
 * Prototyper.
 */
Boolean Do_The_Save_File (Str255 *Prompt, 
 Str255 *DefaultName,
 short *theVolRefNum, short *theRefNum)
{
 StandardFileReply Reply;
 BooleanOpenedOK;

 InitCursor();
 StandardPutFile(Prompt, DefaultName,  &Reply);
 if (Reply.sfGood)
 {
 /* copy the file name */
 BlockMove((Ptr)
 &theStandardFileReply.sfFile.name, 
 &outputFileName,
 theStandardFileReply.sfFile.name[0]
 +1);

 /* create a movie file */
 ErrorCode = 
 CreateMovieFile(&Reply.sfFile, 
 'TVOD', 0, 
 createMovieFileDeleteCurFile, 
 &outputRefNum, &gMovie);

 if (ErrorCode == 0)
 {
 ErrorCode = SetFPos(outputRefNum, 
 fsFromStart, 0);
 ErrorCode = SetVol(nil, 
 theStandardFileReply.sfFile.vRefNum);
 *theRefNum = outputRefNum;
 *theVolRefNum = 
 theStandardFileReply.sfFile.vRefNum;
 OpenedOK = true;
 }
 else
 {
 DebugStr((StringPtr) 
 "\pCreateMovieFile Failed");
 ErrorCode = FSClose(outputRefNum);
 SysBeep(20);
 outputRefNum = 0;
 *theRefNum = 0;
 OpenedOK = false;
 }
 }
 return(OpenedOK);
}
Listing Three  
/* 
 * ONLY A PORTION OF the file 
 * PW_Particle_in_a_B.c, 
 * emitted by 
 * Prototyper for this THINK C
 * project.
 *
 * The full file contains all window 
 * management functions.
 * I show here the functions
 * for the Runge-Kutta method, the
 * Shooting method, offscreen graphics,
 * and adding frames to the video track
 * of a movie.
 * 
 * For this purposes of this article,
 * I have not shown in the header file
 * all the defines and declarations which
 * are referenced by code in this file.
 * I think their meaning should be clear
 * from the context.
 *
 * J. M. Anderson, 1993
 */


/* NOTE:  For the purposes of this 
 * article, I have omitted most of the
 * code for window management, including
 * the code to open the window.  However,
 * it is important to understand that,
 * when the window has been opened, the
 * offscreen bitmaps can be constructed,
 * and not before.
 *
 * In the function to open the window,
 * the function "buildBitMap" is called.
 *
 * In the function to update the window,
 * the function "shoot5Waves" is called.
 */

/* 
 * DEMONSTRATION PROGRAM FOR SHOOTING 
 * METHOD SOLUTION OF A SECOND-DEGREE 
 * DIFFERENTIAL EQUATION WITH TWO BOUNDARY
 * VALUES, USING RUNGE-KUTTA TRIAL  
 * SOLUTIONS.
 */
 
/* 
 * How close we want to hit the 
 * boundary value with a shot
 */
#define TOLERANCE 1.0E-6
typedef double vector[2];

/* 
 * FOLLOWING ARE THE FUNCTIONS TO 
 * CALCULATE THE FIRST VECTOR DERIVATIVE 
 * REQUIRED FOR A FOURTH-ORDER
 * RUNGE-KUTTA SOLUTION.
 *
 * In the following function, "x" replaces
 * "psi" and "x1" replaces "phi" in the
 * article text; "t" replaces "x" in the
 * article text.  "energyE" replaces "E"
 * and "energyA" replaces "A" in the 
 * article text.  
 */
void sysf1(double t, 
 double *x, double *x1)
{
 x1[0] = x[1];
 x1[1] = (t <= 0.0) ? -energyE*x[0] : 
 (energyA - energyE)*x[0];
}

/* 
 * FOLLOWING IS THE FOURTH-ORDER 
 * RUNGE-KUTTA METHOD FOR A SYSTEM
 * OF FIRST-ORDER ORDINARY DIFFERENTIAL
 * EQUATIONS
 */
  
void sysRK4(double t, double h, double *x, 
 int size)
/* 
 * This function returns the state of
 * the system x at t+h, given the state
 * of the system x at t.  As above,
 * "x" replaces "psi" and "t" replaces
 * "x" in the article text.  The 
 * parameter "size" tells how many
 * equations in the system of 
 * equations.
 */
{
 vector y, x0, x1, x2, x3, x4;
 int i;
 
 /* get the RK functions first */
 for (i = 0; i < size; i++) 
 x0[i] = x[i];
 sysf1(t, x0, x1);
 for (i = 0; i < size; i++) 
 x0[i] += h * x1[i]/2;
 sysf1(t+h/2, x0, x2);
 for (i = 0; i < size; i++) 
 x0[i] += h * (x2[i] - x1[i])/2;
 sysf1(t+h/2, x0, x3);
 for (i = 0; i < size; i++) 
 x0[i] += h * (x3[i] - x2[i]/2);
 sysf1(t+h, x0, x4);
 
 /* now step forward by h */
 for (i = 0; i < size; i++)
 y[i] = x[i] + 
 h * (x1[i] + 2*x2[i] + 
   2*x3[i] + x4[i])/6;
 for (i = 0; i < size; i++) x[i] = y[i];
}

/* THE FOLLOWING FUNCTION PERFORMS ALL
 * OFFSCREEN DRAWING AND MOVIE-MAKING
 * FOR THE SEARCH FOR AND VISUALIZATION
 * OF THE FIRST FIVE EIGENVALUES AND
 * EIGENFUNCTIONS OF THE PARTICLE IN A
 * BOX PROBLEM.
 */
void shoot5Waves(void)
{
 int nint = 128, i, k, ntrial, nroots;
 double a = -1.0, b = 1.0, h, t, 
 step = 0.25, v, s = 0.0;
 double beta = 0.0, beta1, beta2, 
 z1 = 1.0;
 vector x;
 long   dontCare;
 GWorldPtr  oldGWorld;
 GDHandle   oldGDev;
 Handle mySound;
 short  neededFrames, nFrames;
 /* GLOSSARY
  * nint: number of intervals in Runge-
  *   Kutta shot
  * i, k: loop indices
  * ntrial: number of trials to find
  *   five energy eigenvalues 
  * nroots: number of solutions found
  * a, b: left and right boundary
  * h: size of Runge-Kutta interval
  * t: replaces "x" in article text;
  *   the independent variable
  * step: step between trials of 
  *   energy in search for energy
  *   eigenvalue
  * v: trial value of energy
  * s: initial value for "psi" at x=a
  * beta: goal for boundary value
  * beta1, beta2: results of two 
  *   successive shots in attempt to
  *   hit boundary value
  * z1: presumed slope of function at
  *   left boundary
  * x: result of one Runge-Kutta step
  * mySound: Handle to a sound resource
  * neededFrames: how many extra frames
  *   we need at end
  * nFrames: loop index
  */
 
 /* 
  * Set up 2D graphics in our offscreen 
  * rectangle 
  */
 view_window(-1.0, -0.8, 1.0, 0.8);
 /* 
  * -1.0 <= x <= 1.0; 
  * -0.8 <= psi <= 0.8
  */ 
 view_port(offRect.left, offRect.bottom, 
 offRect.right, offRect.top);
 
 /* 
  * Set up two off-screen bitmaps; 
  * one will contain the permanent 
  * contents of the onscreen window; 
  * the other will contain an individual 
  * "shot" at the function.
  */

 ntrial = 1;
 nroots = 0;
 
 /* erase the "results" box */
 tempRect = HotRect_EVals;
 InsetRect(&tempRect, 1, 1);
 EraseRect(&tempRect);
 
 /* 
  * Draw the initial background; 
  * see Figure 4 in article. 
  */ 
 GetGWorld(&oldGWorld, &oldGDev);
 SetGWorld(offPort1, NULL);
 LockPixels(offPort1->portPixMap);
 EraseRect(&offRect);
 RGBForeColor(&bkgdColor);
 FillRect(&offRect, black); 
 RGBForeColor(&Black_ForeColor);   
 /* draw axes */
 MoveTo(100, 0);
 LineTo (100, 199);
 MoveTo(0, 100);
 LineTo (199, 100);
 FrameRect(&offRect);
 UnlockPixels(offPort1->portPixMap);
 SetGWorld(oldGWorld, oldGDev);
 
 do /* until we get five solutions */ 
 {
 h = (b - a)/nint;
 t = a;
 x[0] = s;
 x[1] = z1;
 
 v = ntrial * step;
 energyE = v;
 /* post this value in window */
 TextSize(9);
 sprintf((char *)sTemp, "%.3f", 
 energyE);
 tempRect = HotRect_RectE;
 InsetRect(&tempRect, 1, 1);
 TextBox((Ptr)&sTemp, strlen(sTemp), 
 &tempRect, teJustLeft);
 
 /* 
  * Take  Runge-Kutta steps; 
  * at each step, draw function in 
  * offscreen world #2 
  */
 GetGWorld(&oldGWorld, &oldGDev);
 SetGWorld(offPort2, NULL);
 LockPixels(offPort2->portPixMap);
 EraseRect(&offRect);
 /* NOTE: the functions wMoveTo and
  * wLineTo move and draw in the 
  * "real world"; by means of the
    * windowing transformation, they
    * are transformed to appropriate
  * QuickDraw MoveTo and LineTo calls
  * in pixels in offscreen world #2
  */
 wMoveTo(-1.0, 0.0);
 for (k = 1; k < nint; k++)
 {
 sysRK4(t, h, x, 2);
 t += h;
 wLineTo(t, x[0]);
 }
 UnlockPixels(offPort2->portPixMap);
 SetGWorld(oldGWorld, oldGDev);
 
 /*
  * Copy background from offscreen 
  * port #1 to offscreen port #2
  */
 CopyBits(&offPort1->portPixMap, 
 &offPort2->portPixMap,  
 &offRect, &offRect, srcOr, NULL);
 /* 
  * Copy picture from off screen port 
  * #2 to onscreen port
  */
 CopyBits(&offPort2->portPixMap, 
 &(WPtr_Particle_in_a_B->portBits),  
 &offRect, &HotRect_RectPsi, 
 srcCopy, NULL);

 /* 
  * Look for solution:  beta1
  * (last hit of shot on right
  * boundary) and beta2 (this
  * hit of shot on right
  * boundary) are opposite in
  * sign; this indicates that
  * in between a shot must have
  * hit the boundary value 0.
  */
 switch (ntrial)
 {
 case 1 :  beta1 = x[0];
   break;
 case 2 :  beta2 = x[0];
       break;
 default : beta1 = beta2;
   beta2 = x[0];
   break; 
 }
 
 if (beta1*beta2 < 0.0)
 {
 nroots++;
 /* 
  * Quick interpolation for energy
  * eigenvalue 
  */
 energyE = 
 v + step*beta2/(beta1-beta2);
 /* put result in window */
 sprintf((char *)sTemp, 
 "#%d at %7.3lf", nroots, 
 energyE);
 CtoPstr((char *)sTemp);
 MoveTo(HotRect_EVals.left+2, 
 HotRect_EVals.top+(nroots*12));
 TextSize(9);
 DrawString(sTemp);
 /* 
  * Draw this function into the 
  * offscreen bitmap #1 
  * permanently, so that it
  * becomes part of the 
  * background.
  */
 GetGWorld(&oldGWorld, &oldGDev);
 SetGWorld(offPort1, NULL);
 LockPixels(offPort2->portPixMap);
 /*
  * As a visual cue, if the
  * energy eigenvalue is allowed, 
  * draw the eigenfunction in 
  * green; if forbidden, in red.
  */
 if (energyE < energyA)
 RGBForeColor(&forbidColor);
 else
 RGBForeColor(&allowColor);
 /* Same as drawing a "shot" */  
 wMoveTo(-1.0, 0.0);
 h = (b - a)/nint;
 t = a;
 x[0] = s;
 x[1] = z1;
 for (k = 1; k < nint; k++)
 {
 sysRK4(t, h, x, 2);
 t += h;
 wLineTo(t, x[0]);
 }
 RGBForeColor(&Black_ForeColor);
 UnlockPixels(
 offPort2->portPixMap);
 SetGWorld(oldGWorld, oldGDev);
 /* 
  * As an audible cue, 
  * play the sound; I picked
  * a system sound resource
  */
 mySound = GetResource('snd ', 6);
 SndPlay(NIL, mySound, FALSE);
 }
 ntrial++;
 
 /* 
  * HERE, IF WE ARE MAKING A MOVIE, 
  * WE MAKE A FRAME.
  * THIS IS COPIED FROM 
  * QUICKTIME DEVELOPER'S KIT.
  *
  * The idea is to copy what's
  * on screen right now to a
  * movie frame.
  */
 if (makingMovie)
 {
 GetGWorld(&oldGWorld, 
 &oldGDevice);
 SetGWorld(myGWorld, nil);
 EraseRect(&offGRect);
 CopyBits(
 &(WPtr_Particle_in_a_B->portBits),
 (BitMap *)pm,
 &(WPtr_Particle_in_a_B->portRect),
 &offGRect,
 srcCopy, NULL);
 
 /* compress the frame */
 ErrorCode = 
 CompressSequenceFrame(seqID, 
 &pm, &offGRect,
 codecFlagUpdatePrevious,
 StripAddress(
 *compressedFrameBitsH),
 &compressedFrameSize, 
 &similarity, nil);
 if (ErrorCode) 
 DebugStr((StringPtr)
 "\pCompressSequenceFrame Failed");
 
 /* add it to the media */
 ErrorCode = 
 AddMediaSample(gMedia, 
 compressedFrameBitsH,
 0L, compressedFrameSize, 
 (TimeValue)1,
 (SampleDescriptionHandle) 
 imageDescriptionH, 1L,
 similarity ? 
 mediaSampleNotSync : 0, 
 &sampTime);
 if (ErrorCode)
 DebugStr((StringPtr)
 "\pAddMediaSample Failed");
 SetGWorld(oldGWorld, oldGDevice);
 }

 } while (nroots < 5);
 
 /* 
  * Remove the last black curve at the 
  * end 
  */
 GetGWorld(&oldGWorld, &oldGDev);
 SetGWorld(offPort2, NULL);
 LockPixels(offPort2->portPixMap);
 EraseRect(&offRect);
 SetGWorld(oldGWorld, oldGDev);
 CopyBits(&offPort1->portPixMap, 
 &offPort2->portPixMap,  
 &offRect, &offRect, srcOr, NULL);
 CopyBits(&offPort2->portPixMap, 
 &(WPtr_Particle_in_a_B->portBits),  
 &offRect, &HotRect_RectPsi, srcCopy, 
 NULL);
 if (makingMovie)
 {
 GetGWorld(&oldGWorld, &oldGDevice);
 SetGWorld(myGWorld, nil);
 EraseRect(&offGRect);
 CopyBits(
 &(WPtr_Particle_in_a_B->portBits),
 (BitMap *)pm,
 &(WPtr_Particle_in_a_B->portRect),
 &offGRect,
 srcCopy, NULL);
 
 /* compress the frame */
 ErrorCode = 
 CompressSequenceFrame(seqID, &pm, 
 &offGRect,
 codecFlagUpdatePrevious, 
 StripAddress(
 *compressedFrameBitsH),
 &compressedFrameSize, 
 &similarity, nil);
 if (ErrorCode) 
 DebugStr((StringPtr)
 "\pCompressSequenceFrame 
 Failed");
 
 /* 
  * Add it to the media enough for 
  * "trailerTime" secs 
       */
 neededFrames = 
 trailerTime*myTimeScale;
 nFrames = 0;
 do
 {
 ErrorCode = 
 AddMediaSample(gMedia, 
 compressedFrameBitsH,
 0L, compressedFrameSize, 
 (TimeValue)1,
 (SampleDescriptionHandle) 
 imageDescriptionH, 1L,
 similarity ? 
 mediaSampleNotSync : 0,
 &sampTime);
 if (ErrorCode)
 DebugStr((StringPtr)
 "\pAddMediaSample Failed");
 } while (nFrames++ < neededFrames);
 SetGWorld(oldGWorld, oldGDevice);
 }
 
 readyToRun = FALSE;
 if (makingMovie)
 {
 Close_The_Output_File();
 makingMovie = FALSE;
 }
 TextSize(12);
}

/* THIS FUNCTION CONSTRUCTS THE TWO
 * OFFSCREEN GWORLDS REQUIRED BY THE
 * SHOOT5WAVES FUNCTION.  IT IS CALLED
 * ONLY ONCE, AFTER THE WINDOW IS OPEN
 */
void buildBitMap()
{
 GDHandle currDev;
 CGrafPtr currPort;
 QDErr  myGoof;
 
 /* 
  * Builds two BitMaps which match the 
  * "wave function" rectangle pixels; 
    * establishes offscreen GWorlds.
  * Borrowed from "Braving Offscreen 
  * Worlds," G. Ortiz, develop, 
  * Jan 90, pg 28. 
  */
 GetGWorld(&currPort, &currDev);
 
 SetRect(&offRect, 0, 0, 
 HotRect_RectPsi.right - 
 HotRect_RectPsi.left,
 HotRect_RectPsi.bottom - 
 HotRect_RectPsi.top);
 myGoof = NewGWorld(&offPort1, 8, 
 &offRect, NULL, NULL, 
 (GWorldFlags)0); 
 /* 
  * If we didn't goof, we've got an 
  * offscreen world */
 if (!myGoof) 
 {
 SetGWorld(offPort1, NULL);
 LockPixels(offPort1->portPixMap);
 EraseRect(&offRect);
 /* 
  * Fill rectangle with background 
  * color
  */
 RGBForeColor(&bkgdColor);
 FillRect(&offRect, black); 
 RGBForeColor(&Black_ForeColor);   
 /* Draw axes on background */
 MoveTo(100, 0);
 LineTo (100, 199);
 MoveTo(0, 100);
 LineTo (199, 100);
 FrameRect(&offRect);
 UnlockPixels(offPort1->portPixMap);
 }
 else 
 {
 /* not much of a warning! */
 SysBeep(10);
 }
 
 /* do it again for GWorld #2 */
 myGoof = NewGWorld(&offPort2, 8, 
 &offRect, NULL, NULL,    
 (GWorldFlags)0); 
 if (!myGoof) 
 {
 SetGWorld(offPort2, NULL);
 LockPixels(offPort2->portPixMap);
 EraseRect(&offRect);
 UnlockPixels(offPort2->portPixMap);
 }
 else 
 {
 SysBeep(10);
 }
 SetGWorld(currPort, currDev);
}

Bibliography

Anderson, Jay Martin. Introduction to Quantum Chemistry. (New York: W.A. Benjamin, 1969). In the author’s own quantum mechanics textbook, he introduces the particle in a box with a barrier on pg. 57.

Apple Computer. QuickTime Developer’s Guide. (Cupertino: Apple Computer, 1991). In version 1.0 of the Guide, the examples relevant to this article begin on page 2-40. The Guide also comes with a CD-ROM with many code examples.

Cheney, Ward, and Kincaid, David. Numerical Mathematics and Computing. (Pacific Grove, California: Brooks/Cole Publishing Co., 1985). These authors discuss the Runge-Kutta method on pages 311 and 390, and the shooting method beginning on page 411.

Mark, Dave. Macintosh C Programming Primer. Volume II. (Reading, Mass.: Addison-Wesley Publishing Co., 1990). See offscreen drawing and GWorlds beginning on page 202.

Ortiz, Guillermo, “Braving Offscreen Worlds,” develop, #1, January 1990, page 28.

Ortiz, Guillermo, “QuickTime 1.0: ‘You Oughta be in Pictures’,” develop, #7, Summer 1991, page 7.

Othmer, Konstantin, “QuickDraw’s CopyBits Procedure: Better than Ever in System 7.0,” develop, #6, Spring 1991, page 23.

Press, William H., et al. Numerical Recipes in C: The Art of Scientific Programming. (New York: Cambridge University Press, 1988). In this compendium of numerical algorithms, you’ll find the Runge-Kutta method on page 569 and the shooting method on page 602; the book comes with a diskette with useful code examples as well.

 

Community Search:
MacTech Search:

Software Updates via MacUpdate

coconutBattery 3.9.14 - Displays info ab...
With coconutBattery you're always aware of your current battery health. It shows you live information about your battery such as how often it was charged and how is the current maximum capacity in... Read more
Keynote 13.2 - Apple's presentation...
Easily create gorgeous presentations with the all-new Keynote, featuring powerful yet easy-to-use tools and dazzling effects that will make you a very hard act to follow. The Theme Chooser lets you... Read more
Apple Pages 13.2 - Apple's word pro...
Apple Pages is a powerful word processor that gives you everything you need to create documents that look beautiful. And read beautifully. It lets you work seamlessly between Mac and iOS devices, and... Read more
Numbers 13.2 - Apple's spreadsheet...
With Apple Numbers, sophisticated spreadsheets are just the start. The whole sheet is your canvas. Just add dramatic interactive charts, tables, and images that paint a revealing picture of your data... Read more
Ableton Live 11.3.11 - Record music usin...
Ableton Live lets you create and record music on your Mac. Use digital instruments, pre-recorded sounds, and sampled loops to arrange, produce, and perform your music like never before. Ableton Live... Read more
Affinity Photo 2.2.0 - Digital editing f...
Affinity Photo - redefines the boundaries for professional photo editing software for the Mac. With a meticulous focus on workflow it offers sophisticated tools for enhancing, editing and retouching... Read more
SpamSieve 3.0 - Robust spam filter for m...
SpamSieve is a robust spam filter for major email clients that uses powerful Bayesian spam filtering. SpamSieve understands what your spam looks like in order to block it all, but also learns what... Read more
WhatsApp 2.2338.12 - Desktop client for...
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
Fantastical 3.8.2 - Create calendar even...
Fantastical is the Mac calendar you'll actually enjoy using. Creating an event with Fantastical is quick, easy, and fun: Open Fantastical with a single click or keystroke Type in your event details... Read more
iShowU Instant 1.4.14 - Full-featured sc...
iShowU Instant gives you real-time screen recording like you've never seen before! It is the fastest, most feature-filled real-time screen capture tool from shinywhitebox yet. All of the features you... Read more

Latest Forum Discussions

See All

The iPhone 15 Episode – The TouchArcade...
After a 3 week hiatus The TouchArcade Show returns with another action-packed episode! Well, maybe not so much “action-packed" as it is “packed with talk about the iPhone 15 Pro". Eli, being in a time zone 3 hours ahead of me, as well as being smart... | Read more »
TouchArcade Game of the Week: ‘DERE Veng...
Developer Appsir Games have been putting out genre-defying titles on mobile (and other platforms) for a number of years now, and this week marks the release of their magnum opus DERE Vengeance which has been many years in the making. In fact, if the... | Read more »
SwitchArcade Round-Up: Reviews Featuring...
Hello gentle readers, and welcome to the SwitchArcade Round-Up for September 22nd, 2023. I’ve had a good night’s sleep, and though my body aches down to the last bit of sinew and meat, I’m at least thinking straight again. We’ve got a lot to look at... | Read more »
TGS 2023: Level-5 Celebrates 25 Years Wi...
Back when I first started covering the Tokyo Game Show for TouchArcade, prolific RPG producer Level-5 could always be counted on for a fairly big booth with a blend of mobile and console games on offer. At recent shows, the company’s presence has... | Read more »
TGS 2023: ‘Final Fantasy’ & ‘Dragon...
Square Enix usually has one of the bigger, more attention-grabbing booths at the Tokyo Game Show, and this year was no different in that sense. The line-ups to play pretty much anything there were among the lengthiest of the show, and there were... | Read more »
Valve Says To Not Expect a Faster Steam...
With the big 20% off discount for the Steam Deck available to celebrate Steam’s 20th anniversary, Valve had a good presence at TGS 2023 with interviews and more. | Read more »
‘Honkai Impact 3rd Part 2’ Revealed at T...
At TGS 2023, HoYoverse had a big presence with new trailers for the usual suspects, but I didn’t expect a big announcement for Honkai Impact 3rd (Free). | Read more »
‘Junkworld’ Is Out Now As This Week’s Ne...
Epic post-apocalyptic tower-defense experience Junkworld () from Ironhide Games is out now on Apple Arcade worldwide. We’ve been covering it for a while now, and even through its soft launches before, but it has returned as an Apple Arcade... | Read more »
Motorsport legends NASCAR announce an up...
NASCAR often gets a bad reputation outside of America, but there is a certain charm to it with its close side-by-side action and its focus on pure speed, but it never managed to really massively break out internationally. Now, there's a chance... | Read more »
Skullgirls Mobile Version 6.0 Update Rel...
I’ve been covering Marie’s upcoming release from Hidden Variable in Skullgirls Mobile (Free) for a while now across the announcement, gameplay | Read more »

Price Scanner via MacPrices.net

New low price: 13″ M2 MacBook Pro for $1049,...
Amazon has the Space Gray 13″ MacBook Pro with an Apple M2 CPU and 256GB of storage in stock and on sale today for $250 off MSRP. Their price is the lowest we’ve seen for this configuration from any... Read more
Apple AirPods 2 with USB-C now in stock and o...
Amazon has Apple’s 2023 AirPods Pro with USB-C now in stock and on sale for $199.99 including free shipping. Their price is $50 off MSRP, and it’s currently the lowest price available for new AirPods... Read more
New low prices: Apple’s 15″ M2 MacBook Airs w...
Amazon has 15″ MacBook Airs with M2 CPUs and 512GB of storage in stock and on sale for $1249 shipped. That’s $250 off Apple’s MSRP, and it’s the lowest price available for these M2-powered MacBook... Read more
New low price: Clearance 16″ Apple MacBook Pr...
B&H Photo has clearance 16″ M1 Max MacBook Pros, 10-core CPU/32-core GPU/1TB SSD/Space Gray or Silver, in stock today for $2399 including free 1-2 day delivery to most US addresses. Their price... Read more
Switch to Red Pocket Mobile and get a new iPh...
Red Pocket Mobile has new Apple iPhone 15 and 15 Pro models on sale for $300 off MSRP when you switch and open up a new line of service. Red Pocket Mobile is a nationwide service using all the major... Read more
Apple continues to offer a $350 discount on 2...
Apple has Studio Display models available in their Certified Refurbished store for up to $350 off MSRP. Each display comes with Apple’s one-year warranty, with new glass and a case, and ships free.... Read more
Apple’s 16-inch MacBook Pros with M2 Pro CPUs...
Amazon is offering a $250 discount on new Apple 16-inch M2 Pro MacBook Pros for a limited time. Their prices are currently the lowest available for these models from any Apple retailer: – 16″ MacBook... Read more
Closeout Sale: Apple Watch Ultra with Green A...
Adorama haș the Apple Watch Ultra with a Green Alpine Loop on clearance sale for $699 including free shipping. Their price is $100 off original MSRP, and it’s the lowest price we’ve seen for an Apple... Read more
Use this promo code at Verizon to take $150 o...
Verizon is offering a $150 discount on cellular-capable Apple Watch Series 9 and Ultra 2 models for a limited time. Use code WATCH150 at checkout to take advantage of this offer. The fine print: “Up... Read more
New low price: Apple’s 10th generation iPads...
B&H Photo has the 10th generation 64GB WiFi iPad (Blue and Silver colors) in stock and on sale for $379 for a limited time. B&H’s price is $70 off Apple’s MSRP, and it’s the lowest price... Read more

Jobs Board

Optometrist- *Apple* Valley, CA- Target Opt...
Optometrist- Apple Valley, CA- Target Optical Date: Sep 23, 2023 Brand: Target Optical Location: Apple Valley, CA, US, 92308 **Requisition ID:** 796045 At Target Read more
Senior *Apple* iOS CNO Developer (Onsite) -...
…Offense and Defense Experts (CODEX) is in need of smart, motivated and self-driven Apple iOS CNO Developers to join our team to solve real-time cyber challenges. Read more
*Apple* Systems Administrator - JAMF - Activ...
…**Public Trust/Other Required:** None **Job Family:** Systems Administration **Skills:** Apple Platforms,Computer Servers,Jamf Pro **Experience:** 3 + years of Read more
Child Care Teacher - Glenda Drive/ *Apple* V...
Child Care Teacher - Glenda Drive/ Apple ValleyTeacher Share by Email Share on LinkedIn Share on Twitter Share on Facebook Apply Read more
Machine Operator 4 - *Apple* 2nd Shift - Bon...
Machine Operator 4 - Apple 2nd ShiftApply now " Apply now + Start apply with LinkedIn + Apply Now Start + Please wait Date:Sep 22, 2023 Location: Swedesboro, NJ, US, Read more
All contents are Copyright 1984-2011 by Xplain Corporation. All rights reserved. Theme designed by Icreon.