TweetFollow Us on Twitter

TCL Quicktime
Volume Number:9
Issue Number:6
Column Tag:TCL workshop

The Compiler Knows

The TCL undo mechanism - How do you undo?

By John A. Love, III, MacTech Magazine Regular Contributing Author

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

About the author

John is a member of the Washington Apple Pi Users’ Group from the greater Washington D.C. metropolitan area and can be reached on America Online {John Love} and on GEnie {J.LOVE7}. Take note that John appears to be more rested for this article, although he apparently succumbs at the very end.

This series

The purpose of this continuing series is to laboriously trace through the source code of Symantec’s THINK Class Library (TCL) that serves as the Object Oriented Programming (OOP) arm of their Pascal and C compilers to provide the answers to the age-old question, “Who does what to whom?”.

Forrest Tanaka and Sandy Mossberg wake up, this one’s for you also!!!

This article ...

In the first of my “TCL Knick-Knacks” series (August 1992) I addressed what I considered the basics inherent to programming using the TCL:

• creation and initialization of an application object.

• creation and initialization of the all-purpose Event Loop.

• starting up your application.

• running and running and running and ... that Event Loop until you quit the application.

• creation of the document object(s) that the application object supervises.

• creation of the MENUs.

• implementation of MENU commands such as “Save” and “Copy”.

• handling of Desk Accessories.

Several months later (November 1992) I described how Tear-Off Menus are created primarily because I just out-and-out think they’re neat and also because I opened my big mouth and promised I would in the August article.

This month I think I should return to basics this time exploring how the TCL implements the notorious “Undo” Menu command. I might add that Neil is very thankful TCL’s implementation of “Undo” is relatively straightforward (translate “requires relatively few words to describe”). [Concise explanations - the dream of every editor. - Ed.]

A commercial break

You will notice that both the source code fragments as well as the surrounding explanation address QuickTime™ movies. The reason is very simple ... they’re directly extracted from my new CQuickTime, CMovie and CMovieEditTask classes which are included within my “CQuickTime.sea” package uploaded to both GEnie and America Online. So what are you waiting for?

And now we return to our regularly scheduled program(ming)

I will talk about the specifics of QuickTime™ only as they affect the task at hand, namely “Undoing”. But first some generalities

With only slight modification by yours truly, here’s what Symantec’s “Object-Oriented Programming Manual” states:

“The TCL uses the abstract class CTask (sub to CObject) to implement undoable actions. For every undoable action you want in your application, you need to create a subclass of CTask.

“After you perform an action, you create a new CTask and initialize it. Within your ITask method, you store enough information to undo it in your added CTask’s instance variables. Then you pass the newly created CTask to your supervisor (e.g., a CDocument) in a Notify message. CDocument:::Notify stores the passed CTask into CDocument::lastTask after it disposes of the previously stored lastTask. When you choose Undo from the Edit Menu, CDocument::DoCommand does the following:

/* 1 */

 void CDocument::DoCommand (long theCommand)
 {
 switch (theCommand)
 {
 // etc.
 
 case cmdUndo:
 if (lastTask != NULL)
 {
 if (undone)
 lastTask-> Redo();
 else
 lastTask-> Undo();

 undone = !undone;
 UpdateUndo();
 }
 break;
 
 default:
 inherited::DoCommand(theCommand);
 break;
 } /* end: switch */
 }

Well I guess my modifications are more than just slight let’s live with them anyway and explore the words in detail.

When TCL’s CDocument::IDocument is called, CDocument’s instance variable = lastTask is initialized to NULL. How does CDocument’s IDocument get called? Answer when any of the following occurs:

1) When the user double-clicks on one of your app’s documents to start up the application. CApplication::Run calls CApplication’s Preload which will then call CApplication::OpenDocument wherein IDocument should be called.

2) When the user double-clicks on the app itself for start up. Preload will not call OpenDocument in this case because numPreloads returned from _CountAppFiles = 0; however, Preload will continue with a call to CApplication’s StartUpAction which will then:

/* 2 */

 if (!gSystem.hasAppleEvents &&
  (numPreloads == 0))
 gGopher->DoCommand(cmdNew);

Since gGopher at this point is still our app (look at IApplication’s source), CApplication::CreateDocument is called. The latter is empty, so in your overridden version you should call IDocument.

What happens if System 7 is percolating and gSystem.hasAppleEvents is TRUE? Well after CApplication::Run calls Preload, the former calls CApplication’s Process1Event which then calls:

 itsSwitchboard->ProcessEvent();

to setup the all-knowing Event Loop. CSwitchboard’s ProcessEvent calls _WaitNextEvent which detects an AppleEvent with an event ID = kAEOpenApplication. As a result, CSwitchboard::DispatchEvent is called and the latter calls CSwitchboard’s DoHighLevelEvent. (The TCL assumes all high level Events are AppleEvents so you must override DoHighLevelEvent if you use high level Events that do not follow the AppleEvent Interprocess Messaging Protocol.) DoHighLevelEvent calls _AEProcessAppleEvent which calls any AppleEvent Handler you’ve installed.

Whoa, Nellie!!! I think I musta missed somin!!! Oh, yeah here’s the missing link way back when IApplication is called, CApplication’s MakeSwitchboard is called and the latter calls CSwitchboard::ISwitchboard. This dude calls _AEInstallEventHandler to install CSwitchboard’s “AppleEventHandler”. The latter calls:

 gApplication->itsSwitchboard-> DoAppleEvent( );

This little fella eventually calls:

 gGopher->DoAppleEvent(aAppleEvent);

Once again, gGopher = your app, so CApplication::DoAppleEvent is called to:

 gGopher->DoCommand(cmdNew);

if we double-clicked on just the app.

Double-clicking on a document would instigate an AppleEvent with an event ID = kAEOpenDocument with the result that DoAppleEvent eventually calls CApplication::OpenDocument( ). NOT!! Look at CApplication’s Preload after OpenDocument is called. The former continues with a call to _ClrAppFiles to instruct the Finder™ that this document has been processed. As a result, the call to _WaitNextEvent within CSwitchboard::ProcessEvent will not detect an AppleEvent - it’s “done gone” !!!

Hey, is this TCL great or what

but plenty of time for a nap later!

In my TCL implementation of QuickTime™, a QuickTime™ movie document is a CQuickTime object, a sub-class to CDocument. Furthermore, my CMovie class is sub to CPane. When I either create a new movie document or open an existing disk-stored movie document, the first thing I call is INewQuickTime or IQuickTime, respectively. In either case, inherited::IDocument is called to initialize lastTask to NULL as I’ve already stipulated. In both cases also, I then create a new CMovie object and initialize it. This CMovie or CPane object is the sole pane or sub-view of the movie window and has two component parts, translate “instance variables”. The latter are a movie and a movie controller.

This CPane is then stuffed into CQuickTime’s itsMainPane, an instance variable inherited from CDocument and into a specially added CQuickTime instance variable that I name itsMovie. When I call IMovie to initialize my new CMovie object, I call inherited::IPane( ) which eventually calls IPaneX( ) to add my CMovie pane as a sub-view of my movie window. I also call BecomeGopher(TRUE) which method my CPane = CMovie inherits from CBureaucrat. BecomeGopher makes gGopher = my CMovie. After I return from IMovie to either INewQuickTime or IQuickTime, I then set CQuickTime::itsGopher, inherited from CDirector, = my just-initialized CMovie.

One of the key points of all this is that the gopher is a CPane rather than a CDocument as it is under more conventional circumstances. My rationale for this exception is based strictly on the answer to “What exactly am I undoing?”. I wish to undo all the usual editing commands such as Cut and Copy. I am cutting or copying movie frame(s) that constitute one of the two components of a CMovie pane, not a movie document which is a CQuickTime object = CDocument. As a matter of fact, I can have a CQuickTime document consisting of the solitary CMovie window pane whose movie component is empty (guess what my INewQuickTime does? - there’ll be a quiz tomorrow morning).

So when CSwitchboard detects a mouseDown Event and calls CDesktop’s DispatchClick, the latter may find that said mouseDown occurred in the Menubar. As a result:

 gGopher->DoCommand( );

is called which is really my CMovie::DoCommand. So what does the latter look like? Before I get into any more QuickTime™ details, the real question is “What must it look like in order to implement undoing?”, QuickTime™ or not..

Another Commercial break

Just to complete the description of my OOP implementation of QuickTime™, a QuickTime™ movie file is a CResFile object, said file dutifully stored in CQuickTime::itsFile as inherited from CDocument. Although itsFile is a CFile, CResFile is sub to CFile, so everything’s right with the world. CFile objects come into play with saving-to-disk, which subject I am not going to cover this month. Reverting changes to the CQuickTime document by temporary, un-saved editing commands is another subject not to be covered here. However, curiosity will hopefully get the better of you kind readers and you will download my “CQuickTime.sea” file from either GEnie or America Online.

On with the Main Feature

What must my CMovie::DoCommand look like in order to implement undoing?

/* 3 */

void  CMovie::DoCommand (long theCommand)
{
 CMovieEditTask  *newEditTask = NULL;

 // whatever  

 switch (theCommand)
 {
 case cmdCut:
 
 TRY
 {
 newEditTask = new (CMovieEditTask);
 newEditTask-> IMovieEditTask(this, theCommand, 
 cFirstMovieEditTaskIndex);

The purpose of your overridden version of CTask::ITask is to simply store whatever variables in your added CTask’s instance variables are required in order to support undoing, for example, what your movie looks like before the Cut operation.

/* 4 */

 }
 CATCH
 {
 ForgetObject(newEditTask);
 }
 ENDTRY;
 
 lastMovieEditTask = newEditTask;

“lastMovieEditTask” is an added instance variable of type = CMovieEditTask (sub to CTask) in my CMovie class. Remember that I’m cutting, copying etc. movie frame(s) from my CMovie pane so said CMovieEditTask rightfully belongs to the CMovie object, not to the CQuickTime object which is a document. In short, I’m editing a pane, not the pane’s supervisor. Granted I save the latter, but that’s about all.

/* 5 */

 // cut something.
 
 Notify(lastMovieEditTask);

Notify is not a method of a CPane, so it propagates up to CBureaucrat::Notify which calls:

 itsSupervisor->Notify(...);

The supervisor of my CMovie pane is my CQuickTime document. So CDocument::Notify gets called and the latter sets CDocument::lastTask = the passed CMovieEditTask after it disposes of the previous lastTask if there’s one. Although CDocument’s Notify method expects a passed CTask, CMovieEditTask is sub to CTask so everything’s cool. Remember, IDocument sets lastTask = NULL. Notify also sets CDocument’s undone to FALSE and dirty to TRUE.

 lastMovieEditTask->Do();

The purpose of your overridden version of CTask::Do is to store whatever variables in your added CTask’s instance variables are required in order to support undoing; for example, what your movie looks like after the Cut operation.

/* 6 */

 /* Whatever floats your boat
 ** to finish it off!!!     */
 
 break; /* cmdCut */

 case cmdCopy:

 // somethin or another

 break;

 // etc.

 default:
 inherited::DoCommand(theCommand);

 } /* end: switch */

)/* end: DoCommand */

Before we progress any further, let’s pickup some loose ends.

Some QuickTime™ Classes

Now, let’s look at some of my QuickTime™ classes that implement “Undo”:

First, the CDocument

/* 7 */
class CQuickTime : public CDocument  {

public:

   /*
   ** = CDocument::itsFile:
   ** CMovieFile *itsMovieFile;   
   */
 CMovie *itsMovie;
 Movie  savedMovie;


      voidIQuickTime (CApplication *itsSupervisor);
 void   INewQuickTime (CApplication *itsSupervisor);
 virtualvoidDisplayQuickTime (void);
 virtualvoidDispose (void);

 // etc.

}; /* CQuickTime */

The itsMovie instance variable contains the CMovie window pane that is newly created and initialized within both IQuickTime and INewQuickTime. This data is required when I close a movie window, which disposes of my CQuickTime document. Remember when I previously stated that my CMovie pane class contains two instance variables = a movie and a movie controller? Well, when I dispose of the CQuickTime document, I need access to the stored CMovie because I must first call _DisposeMovie and _DisposeMovieController before I call the inherited CDocument::Dispose().

The savedMovie instance variable is used for reverting the CQuickTime document to the last saved version. OhOh I remember saying I wasn’t going to talk about reverting this month so forget I said anything!!!

Then, the CPane

/* 8 */
class CMovie : public CPane {

public:

 Movie    moov;
 MovieController   mc;
  // = CDocument::lastTask:
 CMovieEditTask  *lastMovieEditTask;
 static short  
         cFirstMovieEditTaskIndex;
 
 
 void   IMovie (CView *anEnclosure, 
 CBureaucrat *aSupervisor);
 
 virtualvoidNewMovie (void);
 virtualvoidOpenMovie (SFReply *macSFReply);

 // etc.

}; /* CMovie */

I’ve already addressed the first three instance variables. The fourth one comes into focus when I discuss IMovieEditTask later on.

The IMovie method initializes my CPane as I’ve already said. NewMovie creates an empty movie by calling _NewMovie and a movie controller by calling _NewMovieController. My OpenMovie method is called after you select a disk-stored movie file with the special movie version of the _SFGetFile dialog, namely, _SFGetFilePreview. OpenMovie extracts the QuickTime™ movie from the movie file via a call to _NewMovieFromFile and extracts the associated movie controller via calls to _FindNextComponent and _OpenComponent. To enable editing, OpenMovie continues by passing the functional result from _OpenComponent, = a QuickTime™ movie controller, to _MCEnableEditing.

Finally, the CTask

/* 9 */

class CMovieEditTask : public CTask  {

protected:

 Movie  originalMoov, newMoov,
 originalScrap, newScrap;

It turns out that _MCUndo interchanges the old and the new movie selections, so we don’t need to retain this info. Cool it for now because I’ll expand on this later:

/* 10 */

  /*
 TimeValueoriginalTime,
 originalDuration;
  */
 CMovie *editedMoviePane;
 long   editCmd;

public:
 
 void   IMovieEditTask (CMovie *thisMoviePane, 
 long theCommand, short firstTaskIndex);
 virtualvoidDo (void);
 virtualvoidUndo (void);
/*
 Just calls Undo:
 virtualvoidRedo (void);
*/
 virtualvoidDispose (void);
 
}; /* CMovieEditTask */

As a matter of general review, when IDocument is called by my IQuickTime or INewQuickTime, CDocument’s lastTask is set to NULL. You have also learned that my CMovieEditTask object is passed to Notify for subsequent storage into CDocument::lastTask. You are about to learn one of the reasons why. Look at the source for CDocument::Notify to see that prior to saving this current task in lastTask:

 lastTask->Dispose();

is called to dispose of the previous lastTask after ensuring that this previous lastTask is not NULL.

The closing of a window is much more convoluted, but the same result ensues. You click in the window’s goAway box and you enter CDesktop’s DispatchClick which accesses CWindow’s Close method. Subsequently, you eventually enter CDirector::CloseWind which takes you to CDirector’s Close. You journey returns you to CDocument’s Dispose wherein the TCL calls ForgetObject(lastTask). Look up this routine in Symantec’s file = “TCLUtilities.c”. You will immediately see that ForgetObject calls lastTask ->Dispose. Wallah!!!

Way, way back I talked about saving some info in your overridden CTask so you can implement undoing. The saved info is represented above by the instance variables.

The first two represent the QuickTime™ movie before and after you paste previously cut or copied movie frames, for example. You’ll see in a little bit that these first two movies are needed only when reverting or pasting. For the remaining editing operations a simple call to _MCUndo handles it all, so for these latter operations I simply set these buzzards to NULL.

I’ve got to quantify these “Moov” movies as NULL because for reverting and pasting these Moovs are new movies and, therefore, must be disposed of by CMovieEditTask’s Dispose() method before the latter calls the Dispose() method inherited from the superclass = CTask. I call _DisposeMovie only when “originalMoov” and “newMoov” are not NULL.

The next two movies represent the contents of the public Scrap, once again, before and after your editing operation. These Scrap movies are needed only when cutting or copying simply because reverting, pasting and clearing obviously do not affect the Scrap. For these latter operations, I set the Scrap VARs to NULL with the result that the contents of the Scrap are left intact. The other result is as before, namely, _DisposeMovie is not called for “originalScrap” and “newScrap” within my task’s Dispose() method. When cutting or copying, however, these Scrap movies are new movies and must be disposed of.

The variables labeled “original” are recorded by IMovieEditTask and the variables labeled “new” are recorded by the task’s Do method.

As stated above, I’ll address later the two TimeValue VARs. IMovieEditTask stores the passed thisMoviePane into our instance variable = editedMoviePane. This saving operation is mandatory because both Do and Undo need access to the QuickTime™ movie and movie controller neatly tucked away inside my CMovie object.

Undo what, man !!!

The editCmd instance variable is also needed by Do and Undo since each editing operation requires potentially unique reactions. In effect, we implement:

/* 11 */

 switch (editCmd)
 {
 case cmd1:
 // ...
 break;
 
 // etc.
 }

“Undo Copy Movie” and “Undo Clear Movie” are just some examples of what should appear as text in the Edit Menu’s first menu item. How does the TCL make this happen? “The Compiler just knows, that’s all!!!” Stay tuned for a more precise answer:

The TCL “Starter.Π.rsrc” file inclued with Symantec’s Pascal and C compilers has a ‘STR#’ resource with a name = “Task Names” and an ID = 130. This resource looks like:

/* 12 */

#define STRtaskNames 130

resource‘STR#’ (STRtaskNames, “Task Names”, purgeable)   {

 {
 /* [ 1] */
 “Typing”,
 /* [ 2] */
 “Cut”,
 /* [ 3] */
 “Copy”,
 /* [ 4] */
 “Paste”,
 /* [ 5] */
 “Clear”
 /* [ 6] */
 “Formatting”
 };

};

Before I get into what this sucker does for a living, let’s change said STR# resource 
as follows:

/* 13 */

resource‘STR#’ (STRtaskNames, “Task Names”, purgeable)   {

 {
 /* [ 1] */
 “Revert to Saved Movie”,
 /* [ 2] */
 “Cut Movie”,
 /* [ 3] */
 “Copy Movie”,
 /* [ 4] */
 “Paste Movie”,
 /* [ 5] */
 “Clear Movie”
 };

};

You shoulda gotten the hint by now the what of Undo what is described in the STR components of this STR# resource. Go back to my August 1992 article and review how CDocument::UpdateMenus() is called when you click on the Menubar. Then go to the source code of the latter and see:

/* 14 */

 if (lastTask != NULL)
 {
 gBartender->EnableCmd(cmdUndo);
 UpdateUndo();
 }

The focus for this discussion is CDocument’s UpdateUndo:

/* 15 */

void  CDocument::UpdateUndo()
{
 Str255 status;
 Str255 task;
 
 if (active){
 GetIndString(status, STRcommon, 
 (undone) ? strREDO : strUNDO);
 GetIndString(task, STRtaskNames, 
 lastTask->GetNameIndex());
 ConcatPStrings(status, task);
 
 } else {
 GetIndString(status, STRcommon, strUNDO);
 }
 
 gBartender->SetCmdText(cmdUndo, status);
}

STRcommon, as defined in TCL’s “Constants.h” file, equals 128. This ‘STR#’ resource, as it exist’s in Symantec’s “Starter.Π.rsrc” contains seven(7) component ‘STR ‘s. We perform a cut operation and CDocument’s Notify method is called to set CDocument::undone = FALSE. As a direct result, the local status Str255 contains “Undo”. The second call to _GetIndString accesses our own ‘STR#’ resource whose ID = 130. I have not explained CTask’s GetNameIndex method yet; however, for the moment just pretend that it returns a value = 2. Pressing on, the two local Str255s are concatenated with the result that the first item in the Edit Menu reads “Undo Cut Movie”. Once again is this TCL great or what!!!

Go back a few(?) pages and look at the code snippet extracted from CDocument::DoCommand. You pull down the Edit Menu and you select “Undo Cut Movie”. CDocument::undone is still FALSE so you go to:

 lastTask->Undo();

Since lastTask is really a CMovieEditTask, you’ll end up at my CMovieEditTask::Undo(). You (un)do your thing and then switch CDocument::undo back to TRUE; after all, the cut is now undone, right? Finally, you end by returning to the method UpdateUndo which dutifully changes the Menu item’s text to “Redo Cut Movie”. See I told you the TCL is great stuff.

One last straggler

What about CTask’s GetNameIndex? Way, way back I said that before any editing operation I call my IMovieEditTask. Well the tail end of this contraption looks like:

/* 16 */

void  CMovieEditTask::IMovieEditTask (CMovie *thisMoviePane,
 long theCommand, short firstTaskIndex)
{

 // record “originalMoov”,
 // “originalScrap” and
 // other sordid matters.

 if (firstTaskIndex > 0)
 {
 if (theCommand == cmdRevert)
 taskIndex = firstTaskIndex;
 else
 taskIndex = firstTaskIndex + theCommand - cmdCut + 1;
 }
 else taskIndex = 0;

 inherited::ITask(taskIndex);
}

In my CMovie::DoCommand code snippet presented above for the Command = cmdCut, the very first thing I accomplished was to create a new newEditTask of type = CMovieEditTask. Then:

/* 17 */

 newEditTask->IMovieEditTask(this, cmdCut, 
 cFirstMovieEditTask);

Since this message is being sent within a CMovie method, the passed this is my CMovie pane. Next, it looks like theCommand = cmdCut. Now the really interesting part. The last passed parm is the class variable = cFirstMovieEditTask (review Symantec’s naming conventions in their “Object-Oriented Programming Manual”).

What the

After you folks download my “CQuickTime.sea” package, take a gander at my file = “CmyApp.c” wherein:

 short CMovie:: cFirstMovieEditTaskIndex = 1;

which initializes CMovie’s class variable, the fourth instance variable of CMovie I avoided discussing earlier.

Just for a moment, however, let’s pretend that I initialized it to 0. As a result, IMovieEditTask above passes 0 to CTask::ITask which stores the passed 0 to CTask::nameIndex.

The elusive GetNameIndex method of CTask simply:

 return (nameIndex);

which in this case is 0. Look up _GetIndString within the now-old “Inside Macintosh, Volume I” to discover that since the index is not >= 1, _GetIndString returns an empty string. Since “Undo” + “” = “Undo”, the Menu item text remains the same.

Back to reality I initialize cFirstMovieEditTaskIndex to 1 and pass this sucker to my IMovieEditTask. Before I go any further, carefully observe the order of the STR components that constitute my STR# resource, ID = 130. That same order must be repeated in your MENU resource. This is very critical because

within my IMovieEditTask the passed index directly correlates with the passed Command number. If we were reverting, the index passed to CTask::ITask is 1 so CDocument’s UpdateUndo retrieves the first string in my STR# resource and the Edit Menu’s first item will read “Undo Revert to Saved Movie”.

If we were cutting QuickTime™ movie frame(s), then:

 taskIndex = 1 + cmdCut - cmdCut +1;

which obviously equals 2. The fundamental reason for this lopsided arithmetic centers on the disabled dotted line in your Edit Menu between “Undo” and “Cut”.

A real humdinger

Here are some modified extracts from my “Read Me 1st” Microsoft WORD™ (Version 5) document that constitutes just one of the many components of my “CQuickTime.sea” file I’ve uploaded to both America Online and GEnie. By the way, this file is contained within America Online’s file = “QuickTime Movie Editor” and is placed within their “New files and free uploads” section. The uploaded file retains my name on GEnie and can be found by searching for my name directly:

Try out the Movie item(s) under the “File” Menu of “Feature Flick” if you do not have the “QuickTime” INIT in your System Folder <translate “in your Extensions Folder” for those with System 7>, you will get a spiffy Dialog telling you what a silly you are !!!

If you do have “QuickTime”, make certain that you have the special version of the “Scrapbook” DA that can be used to store “QuickTime” Movies. The usual items under my Edit Menu help you do just that. Speaking of editing ... you can cut, copy and clear single frames, that is, the one you’re viewingat any given time. If you wish to cut, copy or clear the entire daggum Movie, simply press the <Shift> key while you’re pulling down the Edit Menu or using the CMD-key equivalents, e.g., <CMD-Shift> X. Notice the wording change of the Edit Menu items as you press and release the <Shift> key. For pasting, with the <Shift> key released, you will always paste or insert after the frame you’re staring at; if the <Shift> key is pressed, you will paste over or replace the whole Movie. QuickTime allows you to select several contiguous frames by pressing the <Shift> key as you use the Controller Bar to progress from one frame to its neighbor. Note that these frames must be contiguous for this “Shift-Click” method to work. Also, try my added feature wherein you can use the Arrow keys on your keyboard to go from one frame to another.

In addition, the “Edit” Menu has an item called “Show Clipboard”, which name toggles between “Show Clipboard” and “Hide Clipboard” depending on whether the Clipboard window is currently hidden or visible, respectively. In QuickTime parlance, that which shows after copying or cutting a Movie frame(s) is called a Movie “Poster”, a PICTure representation of that which was copied or cut. If just one frame was copied or cut, then just that frame shows. If multiple frames were copied or cut, then the first frame in that multiple frame sequence is presented.

Check out the “Movie” Menu that incorporates several of the capabilities available through use of the Controller Bar. For example, if you find the above-mentioned <Shift-Click> method cumbersome in order to select contiguous frames, try the “Select Frames ...” item under the “Movie” Menu. I’ve also incorporated a VCR Remote-like floating window to further assist you. My OOP code for the latter is implemented using TCL’s class = CIconPane and is based on the pioneering procedural source code of Edgar Lee from Macintosh Developer Tech Support at Apple, Inc.

Additionally, I’ve taken the liberty of including several files in my “Bonus” folder. One is a Microsoft WORD™ document that shows an alphabetized table of absolutely every instance variable, Class-wide, for TCL Version 1.1.2. I really feel that such a listing is invaluable to the beginning or advanced TCL programmer who cannot remember to which Class a particular instance variable belongs. Granted ... the index in back of Symantec’s TCL Manual addresses all the instance methods, but not the instance variables. I deliberately chose to present this listing in table-form so that you could re-arrange in any order you wish; for example, you may wish to alphabetize first by Class and then alphabetize the instance variables within each Class ... your choice. If you do implement an ordering scheme different from mine, be sure to adjust accordingly the pseudo-headings I’ve placed at the top of each page. These pseudo-headings are actually table entries; to keep it simple, just remove them before you re-order.

The remaining two files in my “Bonus” folder pertain to Bill Steinberg’s “System Error Table” DA. One is a resource file that you copy over to Bill’s DA using your favorite Resource Editor. The second is another WORD™ doc, this one a rendition of Bill’s error list. All I’ve done is supplement Bill’s info with QuickTime data.

OhOh !!!

Before finishing this article I noticed that there are a few(?) points I have not covered I know I promised but there’s always the next article!!!

 
AAPL
$102.22
Apple Inc.
+1.16
MSFT
$46.89
Microsoft Corpora
-0.18
GOOG
$582.60
Google Inc.
-4.78

MacTech Search:
Community Search:

Software Updates via MacUpdate

GarageSale 6.8 - Create outstanding eBay...
GarageSale is a slick, full-featured client application for the eBay online auction system. Create and manage your auctions with ease. With GarageSale, you can create, edit, track, and manage... Read more
ScreenFlow 4.5.3 - Create screen recordi...
Save 5% with the MacUpdate coupon code: 68031AE15F -- Buy now! ScreenFlow is powerful, easy-to-use screencasting software for the Mac. With ScreenFlow you can record the contents of your entire... Read more
NeoOffice 2014.3 - Mac-tailored, OpenOff...
NeoOffice is a complete office suite for OS X. With NeoOffice, users can view, edit, and save OpenOffice documents, PDF files, and most Microsoft Word, Excel, and PowerPoint documents. NeoOffice 3.x... Read more
Typinator 6.2 - Speedy and reliable text...
Typinator turbo-charges your typing productivity. Type a little. Typinator does the rest. We've all faced projects that require repetitive typing tasks. With Typinator, you can store commonly used... Read more
PopChar X 6.7 - Floating window shows av...
PopChar X helps you get the most out of your font collection. With its crystal-clear interface, PopChar X provides a frustration-free way to access any font's special characters. Expanded... Read more
Evernote 5.6.0 - Create searchable notes...
Evernote allows you to easily capture information in any environment using whatever device or platform you find most convenient, and makes this information accessible and searchable at anytime, from... Read more
Monosnap 2.2.2 - Versatile screenshot ut...
Monosnap allows you to save screenshots easily, conveniently, and quickly, sharing them with friends and colleagues at once. It's the ideal choice for anyone who is looking for a smart and fast... Read more
Tunnelblick 3.4beta36 - GUI for OpenVPN...
Tunnelblick is a free, open source graphic user interface for OpenVPN on OS X. It provides easy control of OpenVPN client and/or server connections. It comes as a ready-to-use application with all... Read more
SoftRAID 5.0.4 - High-quality RAID manag...
SoftRAID allows you to create and manage disk arrays to increase performance and reliability. SoftRAID's intuitive interface and powerful feature set makes this utility a must have for any Mac OS X... Read more
Audio Hijack Pro 2.11.3 - Record and enh...
Audio Hijack Pro drastically changes the way you use audio on your computer, giving you the freedom to listen to audio when you want and how you want. Record and enhance any audio with Audio Hijack... Read more

Latest Forum Discussions

See All

PlayHaus Review
PlayHaus Review By Amy Solomon on September 23rd, 2014 Our Rating: iPad Only App - Designed for the iPad PlayHaus is a interesting, stylish app for young children, full of cause-and-effect interactions.   | Read more »
Astropolo Review
Astropolo Review By Amy Solomon on September 23rd, 2014 Our Rating: Universal App - Designed for iPhone and iPad Astropolo is a space-themed children’s app with a great sense of style.   | Read more »
New E*TRADE Update Includes Touch ID and...
New E*TRADE Update Includes Touch ID and Home Screen Widget for iOS 8 Posted by Jessica Fisher on September 23rd, 2014 [ permalink ] | Read more »
Cupcake Carnival Review
Cupcake Carnival Review By Jennifer Allen on September 23rd, 2014 Our Rating: :: SAME OLDUniversal App - Designed for iPhone and iPad Cupcake Carnival does all the right match-3 things but it’s a format we’ve seen a little too... | Read more »
This Week at 148Apps: September 15-19, 2...
Expert App Reviewers   So little time and so very many apps. What’s a poor iPhone/iPad lover to do? Fortunately, 148Apps is here to give you the rundown on the latest and greatest releases. And we even have a tremendous back catalog of reviews; just... | Read more »
Kitty Powers’ Matchmaker – Tips, Tricks,...
Hey There, Kittens: | Read more »
Goblin Sword Review
Goblin Sword Review By Andrew Fisher on September 22nd, 2014 Our Rating: :: RETRO GOODNESSUniversal App - Designed for iPhone and iPad Fun visuals, good music, engaging level design, and lots of content make Goblin Sword an... | Read more »
Major New Update for CSR Racing Adds Fer...
Major New Update for CSR Racing Adds Ferrari and Multiplaye​r Posted by Jessica Fisher on September 22nd, 2014 [ permalink ] | Read more »
Veditor Review
Veditor Review By Jennifer Allen on September 22nd, 2014 Our Rating: :: PIMP YOUR VIDEOUniversal App - Designed for iPhone and iPad Want to add stickers and music to your videos? Veditor can do that easily.   | Read more »
1849′s Nevada Silver DLC is Still Search...
A few months ago, I took a look at 1849 from SomaSim. This Gold Rush-themed city builder for iPad had a fair bit going for it, but lacked in a few crucial areas to make it a true stand-out on the App Store. SomaSim has since added in a sandbox mode... | Read more »

Price Scanner via MacPrices.net

Check Apple prices on your device with iTracx
MacPrices is proud to offer readers a free iOS app (iPhones, iPads, & iPod touch) and Android app (Google Play and Amazon App Store) called iTracx, which allows you to glance at today’s lowest... Read more
Refurbished 2013 MacBook Pros available for u...
The Apple Store has Apple Certified Refurbished 13″ and 15″ MacBook Pros available starting at $929. Apple’s one-year warranty is standard, and shipping is free: - 13″ 2.5GHz MacBook Pros (4GB RAM/... Read more
New iPhones Score Big in SquareTrade Breakabi...
SquareTrade has announced the iPhone 6 and its larger sibling, iPhone 6 Plus, performed impressively in Breakability testing, and each carries the top Breakability Score in their respective category... Read more
10 Million + First Weekend Sales Set New iPho...
Apple has announced it sold over 10 million new iPhone 6 and iPhone 6 Plus models, a new record, just three days after the launch on September 19. iPhone 6 and iPhone 6 Plus are now available in the... Read more
Betty Crocker Launches New Cookbook for iOS
Betty Crocker, a General Mills brand, an established food industry leader, has announced its free digital cookbook app has been refreshed to make cooking with iPhone, iPad and iPod touch even easier... Read more
Apple restocks some refurbished 2014 MacBook...
The Apple Store has restocked some Apple Certified Refurbished 2014 MacBook Airs, with prices starting at $769. An Apple one-year warranty is included with each MacBook, and shipping is free. These... Read more
13-inch 128GB MacBook Air on sale for $949, s...
B&H Photo has the new 2014 13″ 1.4GHz/128GB MacBook Air on sale for $949.99 including free shipping plus NY tax only. Their price is $50 off MSRP. B&H will also include free copies of... Read more
Apple offering free $25 iTunes Gift Card with...
The Apple Store is offering a free $25 iTunes Gift Card with the purchase of a $99 Apple TV for a limited time. Shipping is free. Read more
Apple refurbished iPod touch available for up...
The Apple Store has Apple Certified Refurbished 5th generation iPod touches available starting at $149. Apple’s one-year warranty is included with each model, and shipping is free. Most colors are... Read more
iFixIt Tears Down iPhone 6; Awards Respectabl...
iFixit notes that even the smaller 4.7″ iPhone 6 is a giant among iPhones; so big that Apple couldn’t fit it into the familiar iPhone form factor. In a welcome reversal of a recent trend to more or... Read more

Jobs Board

*Apple* Solutions Consultant (ASC) - Apple (...
**Job Summary** The ASC is an Apple employee who serves as an Apple brand ambassador and influencer in a Reseller's store. The ASC's role is to grow Apple Read more
Project Manager / Business Analyst, WW *Appl...
…a senior project manager / business analyst to work within our Worldwide Apple Fulfillment Operations and the Business Process Re-engineering team. This role will work Read more
*Apple* Retail - Multiple Positions (US) - A...
Job Description: Sales Specialist - Retail Customer Service and Sales Transform Apple Store visitors into loyal Apple customers. When customers enter the store, Read more
Position Opening at *Apple* - Apple (United...
…customers purchase our products, you're the one who helps them get more out of their new Apple technology. Your day in the Apple Store is filled with a range of Read more
*Apple* Retail - Multiple Positions (US) - A...
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
All contents are Copyright 1984-2011 by Xplain Corporation. All rights reserved. Theme designed by Icreon.