TweetFollow Us on Twitter

Jan 97 Getting Started

Volume Number: 13 (1997)
Issue Number: 1
Column Tag: Getting Started

Java's AWT Shapes

By Dave Mark

Two of the first things any Mac programmer learns are the concept of event-loop programming and drawing using QuickDraw. The Java programming learning curve is quite similar in this respect. Last month, we introduced Java's event handling mechanism. This month, we'll explore the java.awt.Graphics class. Specifically, we'll look at the java.awt.Graphics member functions that allow you to draw shapes in your applet window.

The java.awt.Graphics Shapes

This month's applet is called javaDraw. Before you dig into the code, take some time to read the java.awt.Graphics web page (part of the JDK API Documentation from Sun.) Pay special attention to the function names that start with either the words draw or frame. The draw routines are analogous to the QuickDraw paint routines (like PaintRect()) and the frame routines do the same as the QuickDraw frame routines (like FrameRect()).

Creating the javaDraw Project

Create a new project called javaDraw.µ using the Java applet stationery. Create a new source code file named javaDraw.html and add it to the project (replace any existing html file that may have been added to the project.) Here's the html code:

<title>javaDraw</title>
<hr>
<applet codebase="javaDraw Classes" code="javaDraw.class" width=228 height=160>
</applet>
<hr>
<a href="javaDraw.java">The source.</a>

Next, create a second source code file named javaDraw.java and add it to the project as well (replace any default .java file that may have been added to the project.) Here's the Java code:

import java.awt.*;

public class shapeCanvas extends Canvas
{
 final int  rectangle=0,
 rect3D=1,
 roundRect=2,
 arc=3,
 oval=4,
 line=5,
 polygon=6;
 int    whichShape = rectangle;
 booleanisFilled = true;
 
 shapeCanvas( int width, int height )
 {
 setBackground( Color.yellow );
 setForeground( Color.red );
 resize( width, height );
 }
 
 public void SetShape( int newShape )
 {
 whichShape = newShape;
 }
 
 public void SetIsFilled( boolean newIsFilled )
 {
 isFilled = newIsFilled;
 }
 
 public void paint( Graphics g )
 {
 Rectangler, b;
 Polygonpoly;
 
 b = bounds();
 r = new Rectangle( 10, 10, b.width - 20,
 b.height - 20 );
 
 poly = new Polygon();
 poly.addPoint( r.x, r.y );
 poly.addPoint( r.x, r.y + r.height );
 poly.addPoint( r.x + r.width, r.y + r.height );
 poly.addPoint( r.x, r.y + r.height/2 );
 poly.addPoint( r.x + r.width, r.y + r.height/2 );
 poly.addPoint( r.x, r.y );
 
 if ( isFilled )
 {
 switch ( whichShape )
 {
 case rectangle:
 g.fillRect( r.x, r.y, r.width, r.height );
 break;
 case rect3D:
 g.fill3DRect( r.x, r.y, r.width, r.height, true );
 break;
 case roundRect:
 g.fillRoundRect( r.x, r.y, r.width, r.height,
 16, 16 );
 break;
 case arc:
 g.fillArc( r.x, r.y, r.width, r.height, 0, 270 );
 break;
 case oval:
 g.fillOval( r.x, r.y, r.width, r.height );
 break;
 case line:
 g.drawLine( r.x, r.y, r.x + r.width, r.y + r.height           
 );
 break;
 case polygon:
 g.fillPolygon( poly );
 break;
 }
 }
 else
 {
 switch ( whichShape )
 {
 case rectangle:
 g.drawRect( r.x, r.y, r.width, r.height );
 break;
 case rect3D:
 g.draw3DRect( r.x, r.y, r.width, r.height, true );
 break;
 case roundRect:
 g.drawRoundRect( r.x, r.y, r.width, r.height,
 16, 16 );
 break;
 case arc:
 g.drawArc( r.x, r.y, r.width, r.height, 0, 270 );
 break;
 case oval:
 g.drawOval( r.x, r.y, r.width, r.height );
 break;
 case line:
 g.drawLine( r.x, r.y, r.x + r.width,
 r.y + r.height );
 break;
 case polygon:
 g.drawPolygon( poly );
 break;
 }
 }
 }
}

public class javaDraw extends java.applet.Applet
{
 private Choice  shapePopup, fillPopup;
 private shapeCanvas sCanvas;
 
 public void init()
 {
 shapePopup = new Choice();
 shapePopup.addItem( "Rectangle" );
 shapePopup.addItem( "3D Rectangle" );
 shapePopup.addItem( "Rounded Rectangle" );
 shapePopup.addItem( "Arc" );
 shapePopup.addItem( "Oval" );
 shapePopup.addItem( "Line" );
 shapePopup.addItem( "Polygon" );
 
 add( shapePopup );
 
 fillPopup = new Choice();
 fillPopup.addItem( "Fill Shapes" );
 fillPopup.addItem( "Do Not Fill Shapes" );
 
 add( fillPopup );
 
 sCanvas = new shapeCanvas( 208, 110 );
 add( sCanvas );
 }
 public boolean action( Event e, Object obj )
 {
 if ( e.target == shapePopup )
 {
 sCanvas.SetShape( shapePopup.getSelectedIndex() );
 sCanvas.repaint();
 
 return true;
 }
 else if ( e.target == fillPopup )
 {
 sCanvas.SetIsFilled( fillPopup.getSelectedIndex()
 == 0 );
 sCanvas.repaint();
 
 return true;
 }
 else
 return super.action( e, obj );
 }
}

If you would like to specify the application used to run your applet, select Project Settings... from CodeWarrior's Edit menu, then click on the Project/Java Project item in the scrolling list (see Figure 1.) Click on the Set... button and select your preferred applet runner from the standard get file dialog. The screen shots that I used in this column were taken using the Metrowerks Java applet runner that comes with CodeWarrior.

Figure 1. CodeWarrior's Project Setting's dialog, showing the Java Project options.

No matter what applet runner you use, be sure you specify "javaDraw Classes" in the File Name field, to match the "codebase" parameter in your html file.

Once everything is entered and set up just the way you like it, select Run from the Project menu to compile and run your applet. Figure 2 shows the javaDraw applet as it first appears. The applet area consists of two popup menus (known as choices in java-speak) and a canvas area. The top popup lets you select the type of shape you are interested in seeing, and the bottom popup lets you specify whether the shape is drawn or framed (filled or outlined.) The default setting is a filled rectangle.

Figure 2. The javaDraw applet, as it first appears.

Figure 3 shows a framed arc. Take some time to play with all the awt.Graphics shapes, in both framed and filled modes. Note that lines look the same in either mode (both call the same function) and that 3D rectangles look almost exactly the same as rectangles. I'm not sure why this last is true, but hopefully future versions of awt will implement more interesting 3D rectangles.

Figure 3. The javaDraw applet, this time showing a framed arc.

Walking Through the Source

javaDraw consists of two classes. The shapeCanvas class implements the yellow drawing canvas at the bottom of the applet area. The javaDraw class extends the applet class and initiates a shapeCanvas and the two popup menus. We'll start with the shapeCanvas class.

shapeCanvas extends the Canvas class. It starts with a series of constants specified using the final keyword. If a variable is marked as final, it becomes a constant - its initial value may not be changed. The constants represent the items in the shape popup menu. Notice that the first constant was set to zero. That's because popup menu items are zero based.

import java.awt.*;

public class shapeCanvas extends Canvas
{
 final int  rectangle=0,
 rect3D=1,
 roundRect=2,
 arc=3,
 oval=4,
 line=5,
 polygon=6;
 int    whichShape = rectangle;
 booleanisFilled = true;

The shapeCanvas() constructor sets the Canvas background and foreground colors, then sets the Canvas size to the specified width and height. SetShape() is used to set the whichShape class variable to the current shape, as specified by the popup menu. SetIsFilled() does the same thing for the isFilled boolean, setting it depending on the bottom popup menu setting.

 shapeCanvas( int width, int height )
 {
 setBackground( Color.yellow );
 setForeground( Color.red );
 resize( width, height );
 }
 
 public void SetShape( int newShape )
 {
 whichShape = newShape;
 }
 
 public void SetIsFilled( boolean newIsFilled )
 {
 isFilled = newIsFilled;
 }

The paint() method is called when the Canvas needs to be redrawn. It starts by retrieving the bounding rectangle of the Canvas. This rectangle is inset 10 pixels on each side, with the results stored in r (r is inset inside b).

 public void paint( Graphics g )
 {
 Rectangler, b;
 Polygonpoly;
 
 b = bounds();
 r = new Rectangle( 10, 10, b.width - 20,
 b.height - 20 );

Next, we create a new Polygon and add a series of points to the Polygon, creating a zigzag shape and ending at the same point we started. This last step is important since it "closes" the Polygon. The Polygon is only needed if it is actually selected from the popup. So, we should probably embed this code in the polygon case below. Sorry about my laziness!

 poly = new Polygon();
 poly.addPoint( r.x, r.y );
 poly.addPoint( r.x, r.y + r.height );
 poly.addPoint( r.x + r.width, r.y + r.height );
 poly.addPoint( r.x, r.y + r.height/2 );
 poly.addPoint( r.x + r.width, r.y + r.height/2 );
 poly.addPoint( r.x, r.y );


The rest of paint() is made up of a giant if. The first part of the if paints filled shapes. The second part of the if paints framed shapes. Take a look at each of these functions, for they are the heart and soul of the Graphics class. These are the functions that actually draw the Java shapes.

 if ( isFilled )
 {
 switch ( whichShape )
 {
 case rectangle:
 g.fillRect( r.x, r.y, r.width, r.height );
 break;
 case rect3D:
 g.fill3DRect( r.x, r.y, r.width, r.height, true );
 break;
 case roundRect:
 g.fillRoundRect( r.x, r.y, r.width, r.height,
 16, 16 );
 break;
 case arc:
 g.fillArc( r.x, r.y, r.width, r.height, 0, 270 );
 break;
 case oval:
 g.fillOval( r.x, r.y, r.width, r.height );
 break;
 case line:
 g.drawLine( r.x, r.y, r.x + r.width,
 r.y + r.height );
 break;
 case polygon:
 g.fillPolygon( poly );
 break;
 }
 }
 else
 {
 switch ( whichShape )
 {
 case rectangle:
 g.drawRect( r.x, r.y, r.width, r.height );
 break;
 case rect3D:
 g.draw3DRect( r.x, r.y, r.width, r.height, true );
 break;
 case roundRect:
 g.drawRoundRect( r.x, r.y, r.width, r.height,
 16, 16 );
 break;
 case arc:
 g.drawArc( r.x, r.y, r.width, r.height, 0, 270 );
 break;
 case oval:
 g.drawOval( r.x, r.y, r.width, r.height );
 break;
 case line:
 g.drawLine( r.x, r.y, r.x + r.width,
 r.y + r.height );
 break;
 case polygon:
 g.drawPolygon( poly );
 break;
 }
 }
 }
}

The javaDraw class implements the applet itself. The init() method first creates the shape Choice, then the fill Choice, and finally the shapeCanvas.

public class javaDraw extends java.applet.Applet
{
 private Choice  shapePopup, fillPopup;
 private shapeCanvas sCanvas;
 public void init()
 {
 shapePopup = new Choice();
 shapePopup.addItem( "Rectangle" );
 shapePopup.addItem( "3D Rectangle" );
 shapePopup.addItem( "Rounded Rectangle" );
 shapePopup.addItem( "Arc" );
 shapePopup.addItem( "Oval" );
 shapePopup.addItem( "Line" );
 shapePopup.addItem( "Polygon" );
 
 add( shapePopup );
 
 fillPopup = new Choice();
 fillPopup.addItem( "Fill Shapes" );
 fillPopup.addItem( "Do Not Fill Shapes" );
 
 add( fillPopup );
 
 sCanvas = new shapeCanvas( 208, 110 );
 add( sCanvas );
 }

The applet's action() routine checks for events occurring in either popup. If the event was in the shape Choice, the shapeCanvas' SetShape() function is called, and an update event is queued for the canvas (repaint() is similar to invalRect(), though for an entire object. If the event was the fill Choice, the SetIsFilled() method is called and the canvas is again repainted. If neither case is true, the parent class' action() method is called and that result returned.

 public boolean action( Event e, Object obj )
 {
 if ( e.target == shapePopup )
 {
 sCanvas.SetShape( shapePopup.getSelectedIndex() );
 sCanvas.repaint();
 
 return true;
 }
 else if ( e.target == fillPopup )
 {
 sCanvas.SetIsFilled( fillPopup.getSelectedIndex()
 == 0 );
 sCanvas.repaint();
 
 return true;
 }
 else
 return super.action( e, obj );
 }
}

Till Next Month...

At this point, you should have a pretty good handle on Java's graphics mechanism. Spend some time exploring the rest of the Graphics class' methods. There are some pretty funky methods in there, and we'll get to them eventually. Before I sign off, I just wanted to mention that this column marks the start of my fifth year writing for MacTech Magazine. Can you believe it? Well, here's to four more years of Mac programming fun! See you next month...

 

Community Search:
MacTech Search:

Software Updates via MacUpdate

calibre 2.69.0 - Complete e-book library...
Calibre is a complete e-book library manager. Organize your collection, convert your books to multiple formats, and sync with all of your devices. Let Calibre be your multi-tasking digital librarian... Read more
Evernote 6.9.1 - 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
jAlbum Pro 13.5 - Organize your digital...
jAlbum Pro has all the features you love in jAlbum, but comes with a commercial license. You can create gorgeous custom photo galleries for the Web without writing a line of code! Beginner-friendly... Read more
jAlbum 13.5 - Create custom photo galler...
With jAlbum, you can create gorgeous custom photo galleries for the Web without writing a line of code! Beginner-friendly, with pro results - Simply drag and drop photos into groups, choose a design... Read more
Google Chrome 53.0.2785.143 - Modern and...
Google Chrome is a Web browser by Google, created to be a modern platform for Web pages and applications. It utilizes very fast loading of Web pages and has a V8 engine, which is a custom built... Read more
Chromium 53.0.2785.143 - Fast and stable...
Chromium is an open-source browser project that aims to build a safer, faster, and more stable way for all Internet users to experience the web. Version 53.0.2785.143: [Security Fix] High CVE-2016-... Read more
QuickBooks 2015 16.1.7.1524 R8 - Financi...
Save 20% on QuickBooks Pro for Mac today through this special discount link QuickBooks 2015 helps you manage your business easily and efficiently. Organize your finances all in one place, track... Read more
Sierra Cache Cleaner 11.0.1 - Clear cach...
Sierra Cache Cleaner is an award-winning general purpose tool for macOS X. SCC makes system maintenance simple with an easy point-and-click interface to many macOS X functions. Novice and expert... Read more
Default Folder X 5.0.7 - Enhances Open a...
Default Folder X attaches a toolbar to the right side of the Open and Save dialogs in any OS X-native application. The toolbar gives you fast access to various folders and commands. You just click on... Read more
Safari Technology Preview 10.1 - The new...
Safari Technology Preview contains the most recent additions and improvements to WebKit and the latest advances in Safari web technologies. And once installed, you will receive notifications of... Read more

Pumped BMX 3: Beginner tips and tricks
There’s a whole lot more to Pumped BMX 3 than meets the eye. Your goal is to perform a wide array of sweet flips and tricks, but that’s easier said than done. It takes well practiced timing and coordination, and the game doesn’t really explain that... | Read more »
Cybird’s latest release - BFB Champions...
Launched in the UK in early September, BFB Champions’ newest update is loaded with great new features, and looks set to outshine the original version by taking it out of soft launch and giving it a new lease of life. | Read more »
3 apps to boost your focus
As someone who works from home, my workspace is a minefield of distraction. Cats, tasty snacks, the wind blowing past my window, that cleaning that I suddenly can’t put off any longer. If I let distraction takes its course, I find that soon half... | Read more »
Pumped BMX 3 (Games)
Pumped BMX 3 1.0 Device: iOS Universal Category: Games Price: $3.99, Version: 1.0 (iTunes) Description: The final instalment of the smash hit #1 rated BMX game is here! Following on from the insane success of Pumped BMX 2, Pumped 3... | Read more »
4 games like Burly Men at Sea to inspire...
Burly Men at Sea is out today and it looks a treat. It tells the tale of three Scandinavian fishermen who leave the humdrum of their daily lives to go exploring. It’s a beautiful folksy story that unfurls as you interact with the environment... | Read more »
3 reasons you need to play Kingdom: New...
Developed by a tag team of indie developers - Thomas "Noio" van den Berg and Marco "Licorice" Bancale - Kingdom is a vibrant medieval fantasy adventure that casts players as a king or queen who must expand their empire by exploring the vasts lands... | Read more »
JoyCity have launched a brand new King o...
Great news for all of you Game of Dice fans out there - JoyCity have just released a brand new limited edition pack with a really cool twist. The premise of Game of Dice is fairly straightforward, asking you to roll dice to navigate your way around... | Read more »
Burly Men at Sea (Games)
Burly Men at Sea 1.0 Device: iOS Universal Category: Games Price: $4.99, Version: 1.0 (iTunes) Description: Burly Men at Sea is a folktale about a trio of large, bearded fishermen who step away from the ordinary to seek adventure. | Read more »
3 tips for catching the gnarliest waves...
Like a wave breaking on the shore, Tidal Rider swept its way onto the App Store charts this week settling firmly in the top 10. It’s a one-touch high score-chaser in which you pull surfing stunts while dodging seagulls and collecting coins. The... | Read more »
The beginner's guide to destroying...
Age of Heroes: Conquest is 5th Planet Games’ all new turn-based multiplayer RPG, full of fantasy exploration, guild building, and treasure hunting. It’s pretty user-friendly as far as these games go, but when you really get down to it, you’ll find... | Read more »

Price Scanner via MacPrices.net

CAZE Annouces New Zero 5 Case for Jet Black i...
Hong Kong basd CAZE has announced Zero 5 case for iPhone 7/ 7 Plus, one of the world’s thinnest clear hard cases, measuring just 0.5 millimeters. CAZE has been producing and improving the Zero 5... Read more
Nest Egg Inventory App for iOS Offers Conven...
Campbell, California based Winprogger LLC has announced the release and immediate availability of Nest Egg – Inventory 4.1.22, an important update to their easy-to-use, yet comprehensive inventory... Read more
Factor4, LLC Launches Apple iOS and Android G...
Factor4, LLC, which offers gift and loyalty services to the SMB marketplace, has released free mobile applications that enable merchants to process via all Apple and Android devices. The Apple and... Read more
15-inch Retina MacBook Pros on sale for $200...
B&H Photo has 15″ Retina Apple MacBook Pros on sale for $200 off MSRP. Shipping is free, and B&H charges NY tax only: - 15″ 2.2GHz Retina MacBook Pro: $1799 $200 off MSRP - 15″ 2.5GHz Retina... Read more
Apple refurbished iMacs available for up to $...
Apple has Certified Refurbished 2015 21″ & 27″ iMacs available for up to $350 off MSRP. Apple’s one-year warranty is standard, and shipping is free. The following models are available: - 21″ 3.... 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
Apple price trackers, updated continuously
Scan our Apple Price Trackers for the latest information on sales, bundles, and availability on systems from Apple’s authorized internet/catalog resellers. We update the trackers continuously: - 15″... Read more
Apple refurbished 2016 13-inch MacBook Airs a...
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: - 2016 13″ 1.6GHz/8GB/128GB MacBook... Read more
1.4GHz Mac mini on sale for $449, save $50
Adorama has the 1.4GHz Mac mini on sale for $50 off MSRP including free shipping plus NY & NJ sales tax only: - 1.4GHz Mac mini (Apple sku# MGEM2LL/A): $449 $50 off MSRP To purchase a mini at... Read more
Apple refurbished 2015 13-inch MacBook Airs a...
Apple has Certified Refurbished 2015 13″ MacBook Airs available starting at $759. An Apple one-year warranty is included with each MacBook, and shipping is free: - 2015 13″ 1.6GHz/4GB/128GB MacBook... Read more

Jobs Board

*Apple* Retail - Multiple Positions- Akron,...
Job Description:SalesSpecialist - Retail Customer Service and SalesTransform Apple Store visitors into loyal Apple customers. When customers enter the store, Read more
Hardware Design Validation Engineer - *Apple...
Changing the world is all in a day's work at Apple . If you love innovation, here's your chance to make a career of it. You'll work hard. But the job comes with more Read more
Systems Architecture Prototyping - *Apple*...
Changing the world is all in a day's work at Apple . If you love innovation, here's your chance to make a career of it. You'll work hard. But the job comes with more Read more
*Apple* Retail - Multiple Positions- South B...
Job Description: Sales Specialist - Retail Customer Service and Sales Transform Apple Store visitors into loyal Apple customers. When customers enter the store, Read more
Restaurant Manager (Neighborhood Captain) - A...
…in every aspect of daily operation. WHY YOU'LL LIKE IT: You'll be the Big Apple . You'll solve problems. You'll get to show your ability to handle the stress and Read more
All contents are Copyright 1984-2011 by Xplain Corporation. All rights reserved. Theme designed by Icreon.