TweetFollow Us on Twitter

Arrowheads
Volume Number:1
Issue Number:9
Column Tag:C WORKSHOP

How to Draw Arrowheaded Lines

How to Draw Arrowheaded Lines

While writing a new application, I discovered I needed to have lines with arrowheads (like the ones we all love in MacDraw). Not only that, I needed to have the line stop on the surface of an object (usually an oval or rectangle).

The first place to look, of course, is to see how MacDraw did it. After using MacDraw for some time in various applications, I was surprised to see that the arrowheads were not 3-pointed polygons but actually small wedges! This was discovered after placing an arrowhead on a thick line and noticing the curvature of the arrowhead.

Keeping with the Macintosh spirit, I decided to make the call similar to the ones used in QuickDraw (i.e. - Line and LineTo). Instead of using a LineTo call, this routine may be substituted and all of the LineTo's changed to ArrowLineTo's.

The parameter passed to it is the absolute horizontal and vertical coordinates of the end point of the line (as in LineTo). The end point is also where the arrowhead will be drawn.

The basic algorithm is simple -

1). Compute the slope of the line

2). Draw the line

3). Point the wedge in the opposite direction of the line (to create the effect of an arrowhead).

4). Draw the wedge

There is a fantastic Mac routine called PtToAngle that will compute the angle for you! All you need to do is to place a rectangle around the starting point, make the call, and the angle is returned to you (in degrees)!

The following code (written in Mac C) is pretty much self explanatory. You could experiment with the constants arrowWidth and arrowLength (as shown in Fig. 1) to vary the width and length of the arrowhead. Note - this routine could be changed so that these constants are passed as parameters, for applications that need varying sizes of arrowheads.

/************************************************************************

         ArrowLineTo.c

 Copyright 1985, FlottWare

 ************************************************************************/

#include "MacCDefs.h"// Mac ROM data structure definitions
#include "Events.h"
#include "Window.h"

extern struct P_Str *CtoPstr();
int strlen(str) char *str;
  {int i=0; while (str[i++]); return i-1;}
  
/*------------------------------------------------------------------------
    Global Data
   ------------------------------------------------------------------------*/
 
#define False 0
#define True 0xFF

Rect      windowRect = {40,4,336,508}; // Window Rectangle
WindowPtr windowPtr; // Window Pointer

EventRecord event; // Current event record

/*------------------------------------------------------------------------
    main()
   ------------------------------------------------------------------------*/
 
main()
  { 
  
  if (CatchSignal()) // Is the user quitting this application?
    ExitToShell(); // Go to Finder when done
    
  init(); // Init Mac 
 
  while (True)   // Poll events forever 
    { 
    SystemTask();// Perform System duties
    
    if (GetNextEvent(everyEvent, &event))    // Get the next event 
      {
      
      switch ( event.what ) // Which event is it? 
 {

 case autoKey:
 case keyDown:                         // Key was pressed 
 case mouseDown: // Mouse Button pressed 
   {
          Signal("All Done"); // Y - quit application
   break;
   } // case autoKey,keyDown,mouseDown:
   
 } // switch (event.what)      
      } // if (Getevent)
    } // while (true)
  } // main
  
/************************************************************************ 

   Windows
 ***********************************************************************/ 

 
/*---------------------------------------------------------------------- 
 
   init() -   
  ----------------------------------------------------------------------*/

init()
  {
   // Open a window
   
  windowPtr = NewWindow(0,&windowRect,CtoPstr("Hit Key or Mouse to Quit "),True,
                             documentProc,-1,True,0);
  SetPort(windowPtr);
  
  #define centerH 250
  #define centerV 150
  #define offset   50
   // Draw some lines with arrowheads
   
  MoveTo(centerH,centerV);
  ArrowLineTo(centerH-offset,centerV);
  
  MoveTo(centerH,centerV);
  ArrowLineTo(centerH-offset,centerV+offset);
  
  MoveTo(centerH,centerV);
  ArrowLineTo(centerH,centerV+offset);
  
  MoveTo(centerH,centerV);
  ArrowLineTo(centerH+offset,centerV+offset);
  
  MoveTo(centerH,centerV);
  ArrowLineTo(centerH+offset,centerV);
  
  MoveTo(centerH,centerV);
  ArrowLineTo(centerH+offset,centerV-offset);
  
  MoveTo(centerH,centerV);
  ArrowLineTo(centerH,centerV-offset);
  
  MoveTo(centerH,centerV);
  ArrowLineTo(centerH-offset,centerV-offset);
  
  } // end init()

/*----------------------------------------------------------------------
      ArrowLineTo(horiz,vert)
   
     This routine draws a line from the current pen location
 to point (h,v) with an arrowhead (wedge) on the end of it.
 
        Inputs : horiz       - horizontal coord of end point
                 vert        - vertical   coord of end point
  
 Written by: Rick Flott                           Mac C (Consulair) V 
1.0
 ----------------------------------------------------------------------*/

ArrowLineTo(horiz,vert)
  short horiz;
  short vert;
  {
   // Size of starting Rect used in PtToAngle
  #define rectOffset  30
   // Arrowhead (wedge) constants
 //   arrowWidth - width of 1/2 arrowhead (in degrees)
   //   arrowLength - length of arrowhead in pixels
  #define arrowWidth  25
  #define arrowLength 10
  
 // Rects used in angle calculations
  Rect  startRect; //   starting Rect used in PtToAngle
  Rect  arrowheadRect;    //   the Rect that the wedge is drawn in

  short arrowAngle;// Angle of arrowhead (in degrees)          
 
  
  Point startPt,endPt;    // Start,End points of line
  
  GetPen(&startPt);// Get the current pen location
 // Set up a rectangle around the starting point
   //    (this is needed for the PtToAngle routine)
  SetRect (&startRect,startPt.h - rectOffset,
                      startPt.v - rectOffset,
                      startPt.h + rectOffset,
       startPt.v + rectOffset);
       
  SetPt(&endPt,horiz,vert); // Set up the end point
    
   // Calculate the angle (in degrees) of the line segment
  PtToAngle(&startRect,&endPt,&arrowAngle);
   
  LineTo(horiz,vert);// Draw the line
  
  arrowAngle -= (180 + arrowWidth);// Create a arrowhead with a wedge 
facing the opposite direction

   // Set up a Rect for the wedge around the endpoint
  SetRect (&arrowheadRect,endPt.h - arrowLength,
                          endPt.v - arrowLength,
                          endPt.h + arrowLength,
           endPt.v + arrowLength);
     
        // Draw arrow head (a reversed wedge)
  PaintArc(&arrowheadRect,arrowAngle,2*arrowWidth);
  
  } // end ArrowLineTo()
 
AAPL
$97.03
Apple Inc.
-0.16
MSFT
$44.40
Microsoft Corpora
-0.47
GOOG
$593.35
Google Inc.
-2.63

MacTech Search:
Community Search:

Software Updates via MacUpdate

Audio Hijack Pro 2.11.0 - 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
Intermission 1.1.1 - Pause and rewind li...
Intermission allows you to pause and rewind live audio from any application on your Mac. Intermission will buffer up to 3 hours of audio, allowing users to skip through any assortment of audio... Read more
Airfoil 4.8.7 - Send audio from any app...
Airfoil allows you to send any audio to AirPort Express units, Apple TVs, and even other Macs and PCs, all in sync! It's your audio - everywhere. With Airfoil you can take audio from any... Read more
Microsoft Remote Desktop 8.0.8 - Connect...
With Microsoft Remote Desktop, you can connect to a remote PC and your work resources from almost anywhere. Experience the power of Windows with RemoteFX in a Remote Desktop client designed to help... Read more
xACT 2.30 - Audio compression toolkit. (...
xACT stands for X Aaudio Compression Toolkit, an application that encodes and decodes FLAC, SHN, Monkey’s Audio, TTA, Wavpack, and Apple Lossless files. It also can encode these formats to MP3, AAC... Read more
Firefox 31.0 - Fast, safe Web browser. (...
Firefox for Mac offers a fast, safe Web browsing experience. Browse quickly, securely, and effortlessly. With its industry-leading features, Firefox is the choice of Web development professionals... Read more
Little Snitch 3.3.3 - Alerts you to outg...
Little Snitch gives you control over your private outgoing data. Track background activityAs soon as your computer connects to the Internet, applications often have permission to send any... Read more
Thunderbird 31.0 - Email client from Moz...
As of July 2012, Thunderbird has transitioned to a new governance model, with new features being developed by the broader free software and open source community, and security fixes and improvements... Read more
Together 3.2 - Store and organize all of...
Together helps you organize your Mac, giving you the ability to store, edit and preview your files in a single clean, uncluttered interface. Smart storage. With simple drag-and-drop functionality,... Read more
Cyberduck 4.5 - FTP and SFTP browser. (F...
Cyberduck is a robust FTP/FTP-TLS/SFTP browser for the Mac whose lack of visual clutter and cleverly intuitive features make it easy to use. Support for external editors and system technologies such... Read more

Latest Forum Discussions

See All

LEX Goes Free For One Day In Honor of Ne...
LEX Goes Free For One Day In Honor of New Update Posted by Jennifer Allen on July 24th, 2014 [ permalink ] Universal App - Designed for iPhone and iPad | Read more »
Thomas Was Alone Goes Universal, Slashes...
Thomas Was Alone Goes Universal, Slashes Price to $3.99 Posted by Ellis Spice on July 24th, 2014 [ permalink ] Universal App - Designed for iPhone and iPad | Read more »
Meerkatz Challenge Review
Meerkatz Challenge Review By Jennifer Allen on July 24th, 2014 Our Rating: :: FONDLY PUZZLINGUniversal App - Designed for iPhone and iPad Cute and challenging, Meerkatz Challenge is a fun puzzle game, particularly for fans of... | Read more »
Book Your Appointment with F.E.A.R. this...
Book Your Appointment with F.E.A.R. | Read more »
It Came From Canada: Epic Skater
For all the hate that it gets for being a pastime for slackers, skateboarding really does require a lot of skill. All those flips and spins take real athleticism, and there’s all the jargon to memorize. Fortunately for us less extreme individuals,... | Read more »
Cultures Review
Cultures Review By Jennifer Allen on July 24th, 2014 Our Rating: :: SLOW-PACED EMPIRE BUILDINGiPad Only App - Designed for the iPad Cute it might seem, but Cultures is a bit too slow paced when it comes to those pesky timers to... | Read more »
More Paintings Have Been Added to Paint...
More Paintings Have Been Added to Paint it Back! Posted by Jessica Fisher on July 24th, 2014 [ permalink ] Universal App - Designed for iPhone and iPad | Read more »
The Order of Souls Review
The Order of Souls Review By Campbell Bird on July 24th, 2014 Our Rating: :: STORY GRINDUniversal App - Designed for iPhone and iPad The Order of Souls is a free-to-play, turn-based RPG with a genre-mixing art style, interesting... | Read more »
Revolution 60 Review
Revolution 60 Review By Jordan Minor on July 24th, 2014 Our Rating: :: LASS EFFECTUniversal App - Designed for iPhone and iPad Revolution 60 is a bold, cinematic action game with ambition to spare.   | Read more »
Matter (Photography)
Matter 1.0.1 Device: iOS Universal Category: Photography Price: $1.99, Version: 1.0.1 (iTunes) Description: Add stunning 3D effects to your photos with real-time shadows and reflections. Export your creations as photos or video loops... | Read more »

Price Scanner via MacPrices.net

Save on 5th generation refurbished iPod touch...
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. Many, but not all... Read more
What Should Apple’s Next MacBook Priority Be;...
Stabley Times’ Phil Moore says that after expanding its iMac lineup with a new low end model, Apple’s next Mac hardware decision will be how it wants to approach expanding its MacBook lineup as well... Read more
ArtRage For iPhone Painting App Free During C...
ArtRage for iPhone is currently being offered for free (regularly $1.99) during Comic-Con San Diego #SDCC, July 24-27, in celebration of the upcoming ArtRage 4.5 and other 64-bit versions of the... Read more
With The Apple/IBM Alliance, Is The iPad Now...
Almost since the iPad was rolled out in 2010, and especially after Apple made a 128 GB storage configuration available in 2012, there’s been debate over whether the iPad is a serious tool for... Read more
MacBook Airs on sale starting at $799, free s...
B&H Photo has the new 2014 MacBook Airs on sale for up to $100 off MSRP for a limited time. Shipping is free, and B&H charges NY sales tax only. They also include free copies of Parallels... Read more
Apple 27″ Thunderbolt Display (refurbished) a...
The Apple Store has Apple Certified Refurbished 27″ Thunderbolt Displays available for $799 including free shipping. That’s $200 off the cost of new models. Read more
WaterField Designs Unveils Cycling Ride Pouch...
High end computer case and bag maker WaterField Designs of San Francisco now enters the cycling market with the introduction of the Cycling Ride Pouch – an upscale toolkit with a scratch-free iPhone... Read more
Kingston Digital Ships Large Capacity Near 1T...
Kingston Digital, Inc., the Flash memory affiliate of Kingston Technology Company, Inc.,has announced its latest addition to the SSDNow V300 series, the V310. The Kingston SSDNow V310 solid-state... Read more
Apple’s Fiscal Third Quarter Results; Record...
Apple has announced financial results for its fiscal 2014 third quarter ended June 28, 2014, racking up quarterly revenue of $37.4 billion and quarterly net profit of $7.7 billion, or $1.28 per... Read more
15-inch 2.0GHz MacBook Pro Retina on sale for...
B&H Photo has the 15″ 2.0GHz Retina MacBook Pro on sale for $1829 including free shipping plus NY sales tax only. Their price is $170 off MSRP. B&H will also include free copies of Parallels... 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
Sr. Manager, *Apple* Deployment Programs fo...
**Job Summary** Apple is seeking candidates for a new position on the Education Content and Technology team. iPad and Mac is in the hands of millions of teachers and Read more
Sr Software Lead Engineer, *Apple* Online S...
Sr Software Lead Engineer, Apple Online Store Publishing Systems Keywords: Company: Apple Job Code: E3PCAK8MgYYkw Location (City or ZIP): Santa Clara Status: Full Read more
Senior Interaction Designer, *Apple* Online...
**Job Summary** Apple is looking for a hands on Senior…will be a key player in designing for the Apple Online Store. The ideal designer will have a Read more
All contents are Copyright 1984-2011 by Xplain Corporation. All rights reserved. Theme designed by Icreon.