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

Together 3.7.5 - Store and organize all...
Together helps you organize your Mac, giving you the ability to store, edit and preview your files in a single clean, uncluttered interface. Features Smart storage. With simple drag-and-drop... Read more
Cocktail 10.3 - General maintenance and...
Cocktail is a general purpose utility for macOS that lets you clean, repair and optimize your Mac. It is a powerful digital toolset that helps hundreds of thousands of Mac users around the world get... Read more
Stylizer 6.17.228.1062 - Real-time CSS e...
Stylizer helps you style websites in a fraction of the time. Features Real-time CSS - Immediate feedback saves countless hours. Say goodbye to the reload button! In Stylizer, your changes are... Read more
Simon 4.2.2 - $99.00
Simon monitors websites and alerts you of crashes and changes. Select pages to monitor, choose your alert options, and customize your settings. Simon does the rest. Keep a watchful eye on your... Read more
iFFmpeg 6.2.6 - Convert multimedia files...
iFFmpeg is a comprehensive media tool to convert movie, audio and media files between formats. The FFmpeg command line instructions can be very hard to master/understand, so iFFmpeg does all the hard... Read more
Dropbox 20.4.19 - Cloud backup and synch...
Dropbox is an application that creates a special Finder folder that automatically syncs online and between your computers. It allows you to both backup files and keep them up-to-date between systems... Read more
DiskCatalogMaker 6.6 - Catalog your disk...
DiskCatalogMaker is a simple disk management tool which catalogs disks. Simple, light-weight, and fast Finder-like intuitive look and feel Super-fast search algorithm Can compress catalog data for... Read more
Amazon Chime 4.0.5540 - Amazon-based com...
Amazon Chime is a communications service that transforms online meetings with a secure, easy-to-use application that you can trust. Amazon Chime works seamlessly across your devices so that you can... Read more
RapidWeaver 7.3 - Create template-based...
RapidWeaver is a next-generation Web design application to help you easily create professional-looking Web sites in minutes. No knowledge of complex code is required, RapidWeaver will take care of... Read more
Dropbox 20.4.19 - Cloud backup and synch...
Dropbox is an application that creates a special Finder folder that automatically syncs online and between your computers. It allows you to both backup files and keep them up-to-date between systems... Read more

Tavern Guardians Guide: How to survive e...
Tavern Guardians is a match-three game that brings some much-needed innovation to what is a tired genre in mobile gaming. Players match objects to attack enemies while healing themselves, forcing players to rethink their approach to the typical... | Read more »
Inkle's next big project is Heaven...
Inkle's latest project could be its most exciting yet, following the widespread success of their past two games, Sorcery! and 80 Days. Their latest title, Heaven's Vault, which was announced at GDC this week, steps away from the gamebook genre,... | Read more »
Last week on Pocket Gamer
If you’re wondering what’s going on in the wider world of portable gaming, our sister site PocketGamer has you covered. Each week we like to check in on the PG team and see what they’ve been preoccupied with. From the latest on the Nintendo Switch... | Read more »
Mudd Masher arrives this week
Atooi Games, the minds behind Totes the Goat and Mutant Mudds, have a new game in the works -- Mudd Masher. The game, a hybrid of the independent studio's first two titles, is expected to launch this week on March 2. [Read more] | Read more »
The best sales on the App Store this wee...
The App Store has quite an exciting lineup of discount games this week that range across a variety of genres. It's a great opportunity to catch up on some of the premium games you may have been holding off on -- and some you can even grab for free... | Read more »
The best new games we played this week
Ah, here we are again at the close of another busy week. Don't rest too easy, though. We had a lot of great new releases in mobile games this week, and now you're going to have to spend all weekend playing them. That shouldn't be too much of a... | Read more »
Rollercoaster Tycoon Touch Guide: How to...
| Read more »
Rabbids Crazy Rush Guide: How to unlock...
The Rabbids are back in a new endless running adventure, Rabbids Crazy Rush. It's more ridiculous cartoon craziness as you help the little furballs gather enough fuel (soda) to get to the moon. Sure, it's a silly idea, but everyone has dreams --... | Read more »
Tavern Guardians (Games)
Tavern Guardians 1.0 Device: iOS Universal Category: Games Price: $2.99, Version: 1.0 (iTunes) Description: Tavern Guardians is a Hack-and-Slash action game played in the style of a match-three. You can experience high pace action... | Read more »
Slay your way to glory in idle RPG Endle...
It’s a golden age for idle games on the mobile market, and those addictive little clickers have a new best friend. South Korean developer Ekkorr released Endless Frontier last year, and players have been idling away the hours in the company of its... | Read more »

Price Scanner via MacPrices.net

13-inch 2.5GHz MacBook Pro (Apple refurbished...
Apple has Certified Refurbished 13″ 2.5GHz MacBook Pros (MD101LL/A) available for $829, or $270 off original MSRP. Apple’s one-year warranty is standard, and shipping is free: - 13″ 2.5GHz MacBook... Read more
Save $150-$180 with Apple refurbished 13-inch...
Apple has Certified Refurbished 2016 13″ MacBook Airs available starting at $849. An Apple one-year warranty is included with each MacBook, and shipping is free: - 13″ 1.6GHz/8GB/128GB MacBook Air: $... Read more
Apple’s Education discount saves up to $300 o...
Purchase a new Mac or iPad using Apple’s Education Store and take up to $300 off MSRP. All teachers, students, and staff of any educational institution qualify for the discount. Shipping is free: -... Read more
SanDisk Introduces 256GB Storage Expansion Fo...
Western Digital Corporation at Mobile World Congress in Barcelona, Spain on Tuesday announced that it has increased the capacity of its line of iOS mobile flash drives with the introduction of its... Read more
FINSiX DART World’s Smallest and Lightest Lap...
Up to 4x smaller and lighter than today’s typical 65W laptop chargers, and with a built-in Smallest and Lightest Laptop Charger, DART allows you to charge all your devices from a single outlet.... Read more
New iPads May Not Arrive Until May or June –...
Digitimes’ Siu Han and Steve Shen say their sources in the iPad upstream supply chain are anticipating disappointing calendar first-quarter 2017 sales. The same sources at upstream suppliers had... Read more
Olay Unveils Skin Advisor App To Help Women B...
Olay celebrated its Mobile World Congress debut with the global launch of Olay Skin Advisor, a new app designed to help women better understand their skin and find the products best-suited to their... Read more
12-inch 1.1GHz Retina MacBooks on sale for $1...
B&H has 12″ 1.1GHz Retina MacBooks on sale for $150 off MSRP. Shipping is free, and B&H charges NY sales tax only: - 12″ 1.1GHz Space Gray Retina MacBook: $1149 $150 off MSRP - 12″ 1.1GHz... Read more
Save up to $600 with Apple refurbished Mac Pr...
Apple has Certified Refurbished Mac Pros available for up to $600 off the cost of new models. An Apple one-year warranty is included with each Mac Pro, and shipping is free. The following... Read more
13-inch 2.7GHz Retina MacBook Pro on sale for...
B&H Photo has the 2015 13″ 2.7GHz/128GB Retina Apple MacBook Pro on sale for $150 off MSRP. Shipping is free, and B&H charges NY tax only: - 13″ 2.7GHz/128GB Retina MacBook Pro (MF839LL/A): $... Read more

Jobs Board

*Apple* Retail - Multiple Positions - Apple,...
Job Description: Sales Specialist - Retail Customer Service and Sales Transform Apple Store visitors into loyal Apple customers. When customers enter the store, Read more
*Apple* Solutions Consultant - Apple (United...
# Apple Solutions Consultant Job Number: 55676865 Los Angeles, California, United States Posted: Feb. 22, 2017 Weekly Hours: 40.00 **Job Summary** As an Apple Read more
Programmer/Editor *Apple* Music Dance - App...
# Programmer/Editor Apple Music Dance Job Number: 55565967 Culver City, California, United States Posted: Feb. 23, 2017 Weekly Hours: **Job Summary** Apple Music Read more
Digital Marketing Specialist - *Apple* iClo...
# Digital Marketing Specialist - Apple iCloud Job Number: 54729233 Culver City, California, United States Posted: Feb. 22, 2017 Weekly Hours: 40.00 **Job Summary** Read more
Marketing Specialist, iTunes & *Apple*...
# Marketing Specialist, iTunes & Apple Music Job Number: 55704205 Culver City, California, United States Posted: Feb. 23, 2017 Weekly Hours: 40.00 **Job Summary** Read more
All contents are Copyright 1984-2011 by Xplain Corporation. All rights reserved. Theme designed by Icreon.