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()
 

Community Search:
MacTech Search:

Software Updates via MacUpdate

Bookends 12.7.9 - Reference management a...
Bookends is a full-featured bibliography/reference and information-management system for students and professionals. Bookends uses the cloud to sync reference libraries on all the Macs you use.... Read more
Dash 4.0.0 - Instant search and offline...
Dash is an API documentation browser and code snippet manager. Dash helps you store snippets of code, as well as instantly search and browse documentation for almost any API you might use (for a full... Read more
TrailRunner 3.8.834 - Route planning for...
TrailRunner is the perfect companion for runners, bikers, hikers, and all people wandering under the sky. Plan routes on a geographical map. Import GPS or workout recordings and journalize your... Read more
Dash 4.0.0 - Instant search and offline...
Dash is an API documentation browser and code snippet manager. Dash helps you store snippets of code, as well as instantly search and browse documentation for almost any API you might use (for a full... Read more
Bookends 12.7.9 - Reference management a...
Bookends is a full-featured bibliography/reference and information-management system for students and professionals. Bookends uses the cloud to sync reference libraries on all the Macs you use.... Read more
TrailRunner 3.8.834 - Route planning for...
TrailRunner is the perfect companion for runners, bikers, hikers, and all people wandering under the sky. Plan routes on a geographical map. Import GPS or workout recordings and journalize your... Read more
iFFmpeg 6.2.5 - 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
DaisyDisk 4.4 - $9.99
DaisyDisk allows you to visualize your disk usage and free up disk space by quickly finding and deleting big unused files. The program scans your disk and displays its content as a sector diagram... Read more
iFFmpeg 6.2.5 - 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
DaisyDisk 4.4 - $9.99
DaisyDisk allows you to visualize your disk usage and free up disk space by quickly finding and deleting big unused files. The program scans your disk and displays its content as a sector diagram... Read more

RPG Djinn Caster (Games)
RPG Djinn Caster 1.0.0 Device: iOS Universal Category: Games Price: $4.99, Version: 1.0.0 (iTunes) Description: SPECIAL PRICE 38% OFF(USD 7.99 -> USD 4.99)!!!A Fantasy Action RPG of far foreign lands! Summon the Djinns and rise to... | Read more »
Alto's Odyssey gets its first trail...
There's finally video evidence of Alto's Odyssey, the follow up to the 2015 App Store hit, Alto's Adventure. It looks just as soothing and atmospheric as Alto's last outing, but this time players will be journeying to the desert. Whereas Alto's... | Read more »
Last week on Pocket Gamer
What’s going on in the wider world of portable gaming? Each week we ask that question of our sister website Pocket Gamer. The PG team covers iOS gaming, just like 148Apps, but it also strays into the world of Android games and handheld consoles... | Read more »
Pokémon GO Generation 2 evolution guide
At long last, Niantic Labs finally unleashed the Generation 2 Pokémon into the wild. Pokémon GO trainers are scrambling to grab up this new set of 80 Pokémon. There are some special new tricks required to catch all of these new beasties, though.... | Read more »
The best new games we played this week
It feels as though the New Year got off to a creaking start as far as mobile games go, but that's changed over the past few weeks. The last few days alone have seen the debut of a number of wonderful games, so we thought we'd take the time to... | Read more »
Recruit more scallywags and discover new...
Get ready to show off your sea legs all over again in Oceans & Empires’ new grand update, which aims to make the act of rising to the role of seven seas ruler even more fresh and appealing, thanks to a richness of new content on both iOS and... | Read more »
Mage the Ascension: Refuge (Games)
Mage the Ascension: Refuge 1.0 Device: iOS Universal Category: Games Price: $4.99, Version: 1.0 (iTunes) Description: The groundbreaking roleplaying game Mage: The Ascension manifests in our turbulent present with Refuge, an... | Read more »
Vampire: Prelude (Games)
Vampire: Prelude 1.0 Device: iOS Universal Category: Games Price: $4.99, Version: 1.0 (iTunes) Description: The classic roleplaying game Vampire: The Masquerade returns to digital games with a Prelude of things to come. Experience a... | Read more »
Digby Forever Guide: How to dig to the d...
Digby Forever is a sparkling homage to arcade classics, and while you may be tiring of the number of arcade games being thrown at you, this endless digger finds many ways to stand out from the rest of the pack. The game manages to be challenging... | Read more »
The best sales on the App Store this wee...
It's been quite the week in mobile games, but if the latest releases(there were some pretty darn good ones, in case you missed out) aren't really doing the trick, perhaps some of these discounted games will. Many of these premium games had their... | Read more »

Price Scanner via MacPrices.net

13-inch 2.0GHz Space Gray MacBook Pro on sale...
Adorama has the non-Touch Bar 13″ 2.0GHz Space Gray MacBook Pro in stock today for $100 off MSRP. Shipping is free, and Adorama charges NY & NJ sales tax only: - 13″ 2.0GHz MacBook Pro Space Gray... Read more
13-inch Touch Bar MacBook Pros on sale for $1...
B&H Photo has select 2016 Apple 13″ Touch Bar MacBook Pros in stock today and up to $100 off MSRP. Shipping is free, and B&H charges NY sales tax only: - 13″ 2.9GHz/512GB Touch Bar MacBook... Read more
KSI-1802R SX Disinfect-able Keyboard With Wav...
KSI has unveiled a new, innovative medical keyboard, the KSI-1802R SX, at HIMSS 2017, running February 19-22 in Orlando, Florida. KSI-1802R SX is the only keyboard that combines dual factor... Read more
15-inch Touch Bar MacBook Pros on sale for up...
Amazon has 15″ Touch Bar MacBook Pros in stock today and on sale for up to $150 off MSRP including free shipping: - 15″ 2.7GHz Touch Bar MacBook Pro Space Gray: $2720.38 $79 off MSRP - 15″ 2.7GHz... 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
13-inch 1.6GHz/256GB MacBook Air on sale for...
Newegg has the 13″ 1.6GHz/256GB MacBook Air (MMGG2LL/A) on sale for $1029.99 including free shipping. Their price is $170 off MSRP, and it’s the lowest price available for this model. Choose Newegg... 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
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
InTouch Health Expands iOS And Windows Produc...
Specialty telehealth enterprise provider InTouch Health has announced an expanded range of FDA Class I listed medical devices and software solutions for ambulatory, non-acute and non-emergent... Read more
iMobie Airs World’s 1st iCloud Manager with M...
iMobie Inc., an Apple-related software company, announced their newly-updated iPhone manager AnyTrans with exclusive feature to sync and manage contents across multiple iCloud accounts. With it,... 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
Manager *Apple* Systems Administration - Pu...
Req ID 3315BR Position Title Manager, Apple Systems Administration Job Description The Manager of Apple Systems Administration oversees the administration and Read more
*Apple* Technician - nfrastructure (United S...
Let’s Work Together Apple Technician This position is based in Portland, ME Life at nfrastructure At nfrastructure, we understand that our success results from our Read more
*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
Manager *Apple* Systems Administration - Pu...
Req ID 3315BR Position Title Manager, Apple Systems Administration Job Description The Manager of Apple Systems Administration oversees the administration and Read more
All contents are Copyright 1984-2011 by Xplain Corporation. All rights reserved. Theme designed by Icreon.