TweetFollow Us on Twitter

Micro-draw
Volume Number:6
Issue Number:7
Column Tag:Jörg's Folder

C++ micro-Draw

By Jörg Langowski, MacTutor Editorial Board

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

C++ micro-Draw

We’re going to expand on the Object Lists demo from V6#2 this month. You’ll probably have noted quite a few deficiencies to that example - it would be nice to be able to draw not only three objects at fixed places within the window, but create some kind of ‘micro-Draw’ utility where you could place as many ovals and rectangles where you like in the window, and also change their aspect.

This example, over the months, will (hopefully) evolve into a useful Draw utility. The first step towards that is to add some code which will allow us to move objects around in the window, change their drawing pattern, delete them etc. At the end of this example you will see that there are still many things left to do - we will add them in the course of the following columns. You should have copies of the preceding example code ready at hand, because we don’t want to reprint everything from scratch each time. The listing at the end gives only the changes that were made compared to the code in V6#2.

Cleaning up the lists

The first thing that we have to take care of is the removal of objects and lists when a document is closed. This was not done in the original example. When a window is closed, the document destructor is called:

//1

TListDoc::~TListDoc(void)
{delete fObjList;
 HideWindow(fDocWindow);  }

and thus, the associated object list will be deleted. However, the objects in it still float around in the heap, since they have been created with new and have not been deleted explicitly! Therefore, we have to define a destructor for the object list as well, in which each object in the list is deleted:

//2

TObjList::~TObjList(void)
{
 TObjLink* temp;
 while (fHeader != nil) 
 {
 temp = fHeader->GetNext();
 delete fHeader->GetmyObj();
 delete fHeader;
 fHeader = temp;
 }
 fNumObjs = 0;
}

This code will clean up properly after us when we close a window.

Creating and Deleting Objects

The next feature that we’d like to add is to be able to position objects by clicking in the window. We can select from the menu what type of object we want; the cursor will then change to a cross, and the object will be placed in the window at the point where we clicked.

To do this, we first define a new routine, ClickInWindow() (see listing); this function waits for a mouse down event and returns the location of the mouse click in the current port’s local coordinates. This routine is called by the menu selection handlers (DoMenuCommand) at the appropriate selections. The center of the object’s bounds rectangle is then set to the position of the mouse click, and the window redrawn. We have not added any means to change the size of an object yet; take this as an exercise, or wait until we give an example in this column.

To erase an object from the window, we simply click on it after the menu selection “Erase”. For implementing this behavior, we define the method FindObj(Point theLoc) which finds the object corresponding to a mouse click at a certain point in the window. This routine returns a pointer to a TDisplObj; to remove the object which we clicked at, we simply write

// 3

fCurListDoc->fObjList->
 RemoveObj(fCurListDoc->fObjList->FindObj(theLoc));

A good example how compact some operations can be expressed in C++.

Changing draw patterns of objects is easy, too; I have added three menu selections that allow to draw objects in either black, gray or white. Again, we find the object that was clicked at, and then set the draw pattern to a new value. For this, we need to define a new instance variable fObjPat in TDisplObj which holds the drawing pattern, and the new method SetObjPat(Pattern pat) which sets this pattern. Caution: a pattern can’t be simply assigned to another pattern variable as in

//4

Pattern myPat = yourPat;

because Pattern is an array, it is defined as unsigned char[8]. We have to write a little loop to do the job (see listing).

Moving objects around

The last method that we add to our example this time is one that allows us to drag an object around in the window. We define a method DragObj(Point *theLoc, Rect theRect) which is called right after the mouse has been clicked at theLoc and an object has been found there. We also need to define a method that allows us to set the bounds rectangle of the object, so it can actually be moved.

DragObj will first create a new region that corresponds to the outline of the object to be dragged. It will then call the Window Manager routine DragGrayRgn to move this outline around the window. The limit and slop rectangles for the dragging routine are set to the port rectangle of the document window, passed through the parameter theRect to DragObj. This means that we cannot exceed the window’s boundaries when we drag the object.

DragGrayRgn waits until the mouse button is released and then returns a longint that contains the distances moved in the vertical and horizontal directions in its high and low words. This information is used to change the value of theLoc. When DragObj returns, theLoc will contain the new mouse coordinates. The main routine then resets the center of the object’s bounds rectangle to this position. The window is redrawn, and the object will have moved.

There is still a small bug in the dragging code; when you drag outside the limit rectangle, the object will disappear. I encourage you to find the reason for this; the bug will be resolved in the next column.

Wish list

We’re on our way to create a ‘MacTutorDraw’ application; but we still have a long way to go, of course. Things that should be added in the future are:

• scrap handling, so that copy, cut and paste are implemented;

• replacement of the selection menu by a palette window;

• changing the size and order of objects;

• implementing more objects, such as lines, arcs, polygons and text boxes;

• code for saving/restoring/printing documents.

Don’t expect all this to happen in the next column, though...

More on Forth

At the end, I would like to tell the remaining Forth enthusiasts that there is very good news regarding object-oriented extensions to Forth. I have now seen three different ways to implement NEON-compatible systems, two of which use fast subroutine-threaded code. I’ll give you news very soon. Until then, happy hacking.

Listing: Changes to the V6#2 example code

void TDocListApp::AdjustMenus(void)
{
 WindowPtrfrontmost;
 MenuHandle menu;
 Boolean undo,cutCopyClear,paste;

 TListDoc* fCurListDoc = (TListDoc*) fCurDoc;

 frontmost = FrontWindow();

 menu = GetMHandle(mFile);
 if ( fDocList->NumDocs() < kMaxOpenDocuments )
   EnableItem(menu, iNew);// New is enabled when we can open more documents 

 else DisableItem(menu, iNew);
 if ( frontmost != (WindowPtr) nil )
   EnableItem(menu, iClose);
 // Close is enabled when there is a window to close 
 else DisableItem(menu, iClose);

 undo = false; cutCopyClear = false; paste = false;
 
 if ( fCurListDoc == nil )
   {  // all editing is enabled for DA windows 
 undo = true;  cutCopyClear = true;
 paste = true;  }
   
 menu = GetMHandle(mEdit);
 if ( undo )EnableItem(menu, iUndo);
 else   DisableItem(menu, iUndo);
 
 if ( cutCopyClear )
   {  EnableItem(menu, iCut);
 EnableItem(menu, iCopy);
 EnableItem(menu, iClear);} 
 else
   {  DisableItem(menu, iCut);
 DisableItem(menu, iCopy);
 DisableItem(menu, iClear); }
   
 if ( paste )  EnableItem(menu, iPaste);
 else   DisableItem(menu, iPaste);
 
 menu = GetMHandle(myMenu);
 EnableItem(menu, item1);
 EnableItem(menu, item2);
 EnableItem(menu, item3);
 EnableItem(menu, item5);
 EnableItem(menu, item7);
 EnableItem(menu, item8);
 EnableItem(menu, item9);
 EnableItem(menu, item11);
} // AdjustMenus

Point ClickInWindow()
{
 EventRecordtheEvent;
 Point  theLoc;
 Booleanev;
 
 CursHandle hCurs;
 hCurs = GetCursor(crossCursor);
 SetCursor(*hCurs);
 while (!(Button())) {} ;
 ev = WaitNextEvent(mDownMask,&theEvent,0,0);
 theLoc = theEvent.where;
 GlobalToLocal(&theLoc);
 return theLoc;
}

void TDocListApp::DoMenuCommand(short menuID, short menuItem)
{
 short  itemHit;
 Str255 daName;
 short  daRefNum;
 WindowPtrwindow;
 Rect   brect;
 Point  theLoc;
 TDisplObj*theObj;
 
 TListDoc* fCurListDoc = (TListDoc*) fCurDoc;

 window = FrontWindow();
 switch ( menuID )
   {  case mApple:
 switch ( menuItem )
   {  case iAbout: // About box
 itemHit = Alert(rAboutAlert, nil);
 break;
 default: // DAs etc.
 GetItem(GetMHandle(mApple), menuItem, daName);
 daRefNum = OpenDeskAcc(daName);
 break; }
 break;
 case mFile:
 switch ( menuItem )
   {  case iNew: DoNew(); break;
 case iClose:
 if (fCurListDoc != nil)
   {  fDocList->RemoveDoc
 (fCurListDoc);
 delete fCurListDoc; }
 else CloseDeskAcc(((WindowPeek)
 fWhichWindow)->windowKind);
 break;
 case iQuit:Terminate();  break; }
 break;
 case mEdit:
 // call SystemEdit for DA editing & MultiFinder 
 if ( !SystemEdit(menuItem-1) )
   {  switch ( menuItem )
   {  case iCut: break;
 case iCopy: break;
 case iPaste: break;
 case iClear: break; }
   }
 break;
 case myMenu:
 if (fCurListDoc != nil) 
 { switch ( menuItem )
   { case item1: // TRoundRect
 theLoc=ClickInWindow();
 SetRect(&brect,theLoc.h-40,
 theLoc.v-20, theLoc.h+40, theLoc.v+20);
 fCurListDoc->fObjList->AddObj(
 new TRoundRect(brect));
 break;
 case item2: // TOval
 theLoc=ClickInWindow();
 SetRect(&brect,theLoc.h-40,
 theLoc.v-20, theLoc.h+40, theLoc.v+20);
 fCurListDoc->fObjList->AddObj(
 new TOval(brect));
 break;
 case item3:  // TRect
 theLoc=ClickInWindow();
 SetRect(&brect,theLoc.h-40,
 theLoc.v-20, theLoc.h+40,
 theLoc.v+20);
 fCurListDoc->fObjList->AddObj(
 new TRect(brect));
 break;
 case item5: // Erase
 theLoc=ClickInWindow();
 fCurListDoc->fObjList->RemoveObj(
 fCurListDoc->fObjList->FindObj(theLoc));
 break;
 case item7: // White
 theLoc=ClickInWindow();
 theObj = fCurListDoc->fObjList->
 FindObj(theLoc);
 if (theObj != nil) 
 theObj->SetObjPat(qd.white);
 break;
 case item8: // Gray
 theLoc=ClickInWindow();
 theObj = fCurListDoc->fObjList->
 FindObj(theLoc);
 if (theObj != nil) 
 theObj->SetObjPat(qd.gray);
 break;
 case item9: // Black
 theLoc=ClickInWindow();
 theObj = fCurListDoc->fObjList->
 FindObj(theLoc);
 if (theObj != nil) 
 theObj->SetObjPat(qd.black);
 break;
 case item11: // Move
 theLoc=ClickInWindow();
 theObj = fCurListDoc->fObjList->
 FindObj(theLoc);
 if (theObj != nil)
 { theObj->DragObj(
 &theLoc,window->portRect);
 SetRect(&brect,theLoc.h-40, 
 theLoc.v-20, theLoc.h+40, 
 theLoc.v+20);
 theObj->SetBoundRect(brect);
 }
 break;
 }
 InvalRect(&(window->portRect));
 fCurListDoc->DoUpdate();
 InitCursor();
 }
 break;
   }
 HiliteMenu(0);
} // DoMenuCommand

// List document class
class TListDoc : public TDocument {
 
  protected:
 void DrawWindow(void);

  public:
 TObjList*fObjList;// list of objects to be drawn
 TListDoc(short resID);
 ~TListDoc(void);
 
 // methods from TDocument we override
 void DoUpdate(void);
};

const int kMinDocDim = 40;

// create and delete the document window

TListDoc::TListDoc(short resID) : (resID)
{
 fObjList = new TObjList();
 ShowWindow(fDocWindow);  
}

void TListDoc::DrawWindow(void)
{TObjLink* temp;
 
 SetPort(fDocWindow);
 EraseRect(&fDocWindow->portRect);
 if (fObjList->NumObjs() != 0)
 for (temp = fObjList->Header(); 
 temp != nil; temp = temp->GetNext())
   temp->GetmyObj()->Draw(
 temp->GetmyObj()->GetObjPat());
} // DrawWindow

class TDisplObj {
  private:
 Boolean HiLiteState;// true : highlighted
  protected:
 TDisplObj(Rect r);
 Rect fBoundRect;
 Pattern fObjPat;
  public:
 virtual void Draw(Pattern) 
 {DebugStr(“\pCall to TDisplObj::Draw”);}
 virtual void Erase()     
 {DebugStr(“\pCall to TDisplObj::Erase”);}
 virtual void DoContent()   
 {DebugStr(“\pCall to TDisplObj::DoContent”);}
 virtual void DoIdle() { /* do nothing by default*/ }
 Rect GetBoundRect() {return fBoundRect;}
 void SetBoundRect(Rect theRect) 
 {fBoundRect = theRect;}
 Pattern GetObjPat() {return fObjPat;}
 void SetObjPat(Pattern pat); 
 void DragObj(Point*, Rect); 
};

class TObjList {
 TObjLink*fHeader;
 int    fNumObjs;
public:
 TObjList(void);  ~TObjList(void);
 
 inline TObjLink* Header() { return fHeader; }
 inline int NumObjs() { return fNumObjs; }

 void   AddObj(TDisplObj* obj);
 void   RemoveObj(TDisplObj* obj);
 TDisplObj* FindObj(Point theLoc);
};

TObjList::~TObjList(void)
{
 TObjLink* temp;
 while (fHeader != nil) 
 {
 temp = fHeader->GetNext();
 delete fHeader->GetmyObj();
 delete fHeader;
 fHeader = temp;
 }
 fNumObjs = 0;
}

TDisplObj* TObjList::FindObj(Point theLoc)
{
 TObjLink* temp;
 Rect theRect;

 for (temp = fHeader; temp != nil; 
 temp = temp->GetNext())
 { theRect = temp->GetmyObj()->GetBoundRect();
 if (PtInRect(theLoc,&theRect))
   return (temp->GetmyObj());
 }
 return nil;
}

TDisplObj::TDisplObj(Rect r)  
 { fBoundRect = r; SetObjPat(qd.gray); }

void TDisplObj::SetObjPat(Pattern pat)  
 { for (int i=0; i<8; i++) fObjPat[i] = pat[i]; }

void TDisplObj::DragObj(Point *theLoc, Rect theRect)  
{
 RgnHandle theRgn = NewRgn();
 OpenRgn();
 this->Draw(fObjPat);
 CloseRgn(theRgn);
 
 long res=DragGrayRgn(theRgn,*theLoc, &theRect,&theRect,0,0);
 if (res != 0x8000)
 { theLoc->v += HiWord(res);
 theLoc->h += LoWord(res);
 }
 DisposeRgn(theRgn);
}

 

Community Search:
MacTech Search:

Software Updates via MacUpdate

Opera 44.0.2510.1449 - High-performance...
Opera is a fast and secure browser trusted by millions of users. With the intuitive interface, Speed Dial and visual bookmarks for organizing favorite sites, news feature with fresh, relevant content... Read more
Opera 44.0.2510.1449 - High-performance...
Opera is a fast and secure browser trusted by millions of users. With the intuitive interface, Speed Dial and visual bookmarks for organizing favorite sites, news feature with fresh, relevant content... Read more
Skim 1.4.29 - PDF reader and note-taker...
Skim is a PDF reader and note-taker for OS X. It is designed to help you read and annotate scientific papers in PDF, but is also great for viewing any PDF file. Skim includes many features and has a... Read more
FontExplorer X Pro 6.0.2 - Font manageme...
FontExplorer X Pro is optimized for professional use; it's the solution that gives you the power you need to manage all your fonts. Now you can more easily manage, activate and organize your... Read more
1Password 6.7.1 - Powerful password mana...
1Password is a password manager that uniquely brings you both security and convenience. It is the only program that provides anti-phishing protection and goes beyond password management by adding Web... Read more
Vivaldi 1.9.818.44 - An advanced browser...
Vivaldi is a browser for our friends. In 1994, two programmers started working on a web browser. Our idea was to make a really fast browser, capable of running on limited hardware, keeping in mind... Read more
Vivaldi 1.9.818.44 - An advanced browser...
Vivaldi is a browser for our friends. In 1994, two programmers started working on a web browser. Our idea was to make a really fast browser, capable of running on limited hardware, keeping in mind... Read more
Skim 1.4.29 - PDF reader and note-taker...
Skim is a PDF reader and note-taker for OS X. It is designed to help you read and annotate scientific papers in PDF, but is also great for viewing any PDF file. Skim includes many features and has a... Read more
1Password 6.7.1 - Powerful password mana...
1Password is a password manager that uniquely brings you both security and convenience. It is the only program that provides anti-phishing protection and goes beyond password management by adding Web... Read more
FontExplorer X Pro 6.0.2 - Font manageme...
FontExplorer X Pro is optimized for professional use; it's the solution that gives you the power you need to manage all your fonts. Now you can more easily manage, activate and organize your... Read more

Latest Forum Discussions

See All

Fire Emblem Heroes event announces new m...
As reported yesterday, Nintendo was gearing up a live press event for their popular mobile game,Fire Emblem Heroes. While the stream revealed a lot of new things, the event was entirely in Japanese. Luckily we have a rundown of what was announced... | Read more »
Best games we played this week
Another week, another slate of new mobile games. Although there weren't as many big name releases as last week, there were plenty of unique video game titles that came out that's sure to keep you interested over the weekend. Everything from classic... | Read more »
Olli by Tinrocket (Photography)
Olli by Tinrocket 1.0 Device: iOS iPhone Category: Photography Price: $2.99, Version: 1.0 (iTunes) Description: Get drawn in with Olli by TinrocketOlli instantly turns your everyday moments into hand-drawn art and animations. • Watch... | Read more »
Penarium (Games)
Penarium 1.0 Device: iOS Universal Category: Games Price: $1.99, Version: 1.0 (iTunes) Description: | Read more »
Fire Emblem Heroes is way more profitabl...
Profits for Nintendo's mobile game Fire Emblem Heroes are apparently impressive enough to beat out other Nintendo titles likeSuper Mario Run, despite having 10 times fewer downloads. [Read more] | Read more »
Classic series Robot Unicorn Attack 3 no...
The classic Adult Swim browser game, Robot Unicorn Attack, branched off into a series of popular mobile games. Now, the latest entry into the series, Robot Unicorn Attack 3, is available for iOS and Android mobile devices. [Read more] | Read more »
Sudoku Sweeper (Games)
Sudoku Sweeper 1.0 Device: iOS Universal Category: Games Price: $2.99, Version: 1.0 (iTunes) Description: A minimalist mashup of Minesweeper and Sudoku. Logic puzzle perfection. Every row, column and zone contains a bomb and one of... | Read more »
Under Leaves (Games)
Under Leaves 1.0.0 Device: iOS Universal Category: Games Price: $1.99, Version: 1.0.0 (iTunes) Description: Journey into the forest, the jungle or the depths of the deep blue sea. Find chestnuts for the pigs, a caterpillar for the... | Read more »
Ninja Pizza Girl (Games)
Ninja Pizza Girl 1.0 Device: iOS Universal Category: Games Price: $2.99, Version: 1.0 (iTunes) Description: In the not-so-distant future, rampart traffic congestion has resulted in only one way to deliver pizzas across town in thirty... | Read more »
SCRAP (Games)
SCRAP 1.0 Device: iOS Universal Category: Games Price: $2.99, Version: 1.0 (iTunes) Description: That day, for no apparent reason, SCRAP decided to wake up and run. He had to, because his activation was a mistake the "Factory" could... | Read more »

Price Scanner via MacPrices.net

13-inch Gray 2.9GHz/512GB Touch Bar MacBook P...
Amazon has the 13″ Space Gray 2.9GHz/512GB Touch Bar MacBook Pro (model MNQF2LL/A) in stock today and on sale for $150 off MSRP. Shipping is free: - 13″ 2.9GHz/512GB Touch Bar MacBook Pro Space Gray... Read more
15-inch 2.7GHz Space Gray Touch Bar MacBook P...
B&H Photo has the 15″ 2.7GHz Space Gray Touch Bar MacBook Pro in stock today and on sale for $2599…$200 off MSRP. Shipping is free, and B&H charges NY & NJ sales tax only: - 15″ 2.7GHz... Read more
13-inch 2.9GHz/256GB Space Gray Touch Bar Mac...
B&H Photo has the 13″ 2.9GHz/256GB Space Gray Touch Bar MacBook Pro in stock today and on sale for $150 off MSRP including free shipping plus NY & NJ sales tax only: - 13″ 2.9GHz/256GB Touch... Read more
21-inch iMacs on sale for up to $151 off MSRP
B&H Photo has 21″ iMacs on sale for up to $151 off MSRP, each including free shipping plus NY sales tax only: - 21″ 3.1GHz iMac 4K: $1348 $151 off MSRP - 21″ 2.8GHz iMac: $1199.99 $100 off MSRP... Read more
Weekend deal: Up to $420 off new MacBook Pros...
Apple has Certified Refurbished 2016 15″ and 13″ MacBook Pros available for $230 to $420 off original MSRP. An Apple one-year warranty is included with each model, and shipping is free: - 15″ 2.6GHz... Read more
Price drop: 15-inch 2.2GHz Retina MacBook Pro...
Amazon has dropped their price on 15″ 2.2GHz Retina MacBook Pros (MJLQ2LL/A) to $1709.99 including free shipping. Their price is $290 off MSRP for this model. Note that stock may sell out quickly at... Read more
2.8GHz Mac mini on sale for $899, save $100
B&H Photo has the 2.8GHz Mac mini (model number MGEQ2LL/A) on sale for $899 including free shipping plus NY & NJ sales tax only. Their price is $100 off MSRP. Read more
Check Apple prices on any device with the iTr...
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
New System Clock for macOS by B-Eng Now Avail...
Fehraltorf, Switzerland based B-Eng has announced the release and immediate availability of System Clock, the company’s new system monitor and information app developed exclusively for macOS. System... Read more
DEVONtechnologies Celebrates 15th Anniversary...
DEVONtechnologies celebrates its 15th company anniversary with a 30% discount on all its software products from May 1st through 5th, 2017. In spring 2002, DEVONtechnologies opened its website and... Read more

Jobs Board

*Apple* Mobile Master - Best Buy (United Sta...
**493714BR** **Job Title:** Apple Mobile Master **Location Number:** 001024-Weatherford-Store **Job Description:** **What does a Best Buy Apple Mobile Master Read more
*Apple* OS X Server Administrator (Active Se...
** Apple OS X Server Administrator \(Active Secret Clearance\)** **Description** Come be a part of a top notch team, apply today\!\! Tuva TUVA provides turnkey Read more
*Apple* Mac Computer Technician - GeekHampto...
…complex computer issues over the phone and in person? GeekHampton, Long Island's Apple Premium Service Provider, is looking for you! Come work with our crew Read more
Best Buy *Apple* Computing Master - Best Bu...
**501846BR** **Job Title:** Best Buy Apple Computing Master **Location Number:** 001126-South Bay Center-Store **Job Description:** **What does a Best Buy Apple Read more
Consultant or Sr. Consultant, *Apple* Allia...
…improve our business and your clients will be heard.Project Manager, Apple AllianceLocation:San Francisco preferred, open to other locationsLevel:Consultant or Sr. Read more
All contents are Copyright 1984-2011 by Xplain Corporation. All rights reserved. Theme designed by Icreon.