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

1Password 6.8.5 - 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
BetterTouchTool 2.319 - Customize multi-...
BetterTouchTool adds many new, fully customizable gestures to the Magic Mouse, Multi-Touch MacBook trackpad, and Magic Trackpad. These gestures are customizable: Magic Mouse: Pinch in / out (zoom... Read more
iFFmpeg 6.6.3 - 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
Evernote 6.13.2 - Create searchable note...
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
HoudahSpot 4.3.4 - Advanced file-search...
HoudahSpot is a versatile desktop search tool. Use HoudahSpot to locate hard-to-find files and keep frequently used files within reach. HoudahSpot will immediately feel familiar. It works just the... Read more
calibre 3.14.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.13.2 - Create searchable note...
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
calibre 3.14.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
HoudahSpot 4.3.4 - Advanced file-search...
HoudahSpot is a versatile desktop search tool. Use HoudahSpot to locate hard-to-find files and keep frequently used files within reach. HoudahSpot will immediately feel familiar. It works just the... Read more
Hopper Disassembler 4.3.10- - Binary dis...
Hopper Disassembler is a binary disassembler, decompiler, and debugger for 32- and 64-bit executables. It will let you disassemble any binary you want, and provide you all the information about its... Read more

Latest Forum Discussions

See All

Sweety Kitty is an epic adventure for sw...
Join Sweety the Kitty on his journey around the world in Sweety Kitty, an all new match-three adventure full of colorful lands and tasty treats, developed and self published by Integra Games Global OU. Available now on both the App Store and Google... | Read more »
The best deals on the App Store this wee...
A new week means new deals on the App Store, and it looks as though Christmas has arrived a bit early this Monday with a whole slew of new discount games, many of which have yet to be covered in this roundup series. Puzzle games, point and click... | Read more »
CUPHEAD (Games)
CUPHEAD 1.0 Device: iOS Universal Category: Games Price: $4.99, Version: 1.0 (iTunes) Description: Cuphead is a classic run and gun single player action game heavily focused on boss battles. Inspired by cartoons of the 1930s, the... | Read more »
Run Sausage Run! guide - tips and tricks...
Run Sausage Run! is a mildly sadistic endless runner in which you guide a sausage or any other variety of cured meat through a deadly meat factory full of sawblades and other hazards. Getting a high score in this game is no small feat, and will... | Read more »
WWE Mayhem guide - beginner tips and tri...
WWE Mayhem brings all of the familiar faces from your favorite wrestling league to mobile in this exciting new fighting game. Build up a team of your favorite WWE superstars and fight your way to the championship title, or battle against your... | Read more »
The best new games we played this week -...
We've made it through another week, so let's treat ourselves to some of the best new games to launch in the past few days. It was another exciting week with some long-awaited indie games making their debut, and some big console titles making the... | Read more »
Match blocks to pull off dance moves in...
Ferdinand: Unstoppabull is a brand new match three puzzler based on the animated movie of (almost) the same name. As you can expect, you have to match blocks together to complete a bunch of puzzling levels and earn a high score. [Read more] | Read more »
Lineage 2: Revolution’s end of year upda...
Now available in 54 countries worldwide, Lineage 2: Revolution is continuing its global quest to be the most popular mobile MMORPG by launching a jam-packed end of year update. Complete with many subtle tweaks to help improve users’ online... | Read more »
The 5 best Star Wars games on iOS
The time has almost come.Star Wars: The Last Jedifinally hits theaters in the cinematic event that might be bigger than Christmas. To celebrate, we're taking a look at the best--and only the best--Star Warsmobile games to date. [Read more] | Read more »
Life Is Strange (Games)
Life Is Strange 1.1 Device: iOS Universal Category: Games Price: $2.99, Version: 1.1 (iTunes) Description: Life Is Strange is a five part episodic game that sets out to revolutionize story-based choice and consequence games by... | Read more »

Price Scanner via MacPrices.net

Holiday deals on 9″ Apple iPads: Resellers of...
B&H Photo has 9.7″ 2017 iPads on sale for $10-$50 off MSRP as part of their Holiday sale. Overnight shipping is free, and pay sales tax in NY & NJ only: – 9″ 32GB iPad WiFi: $299, $30 off – 9... Read more
12″ and 10″ Apple iPad Pros on sale for up to...
B&H Photo has 10″ and 12″ iPad Pros on sale for up to $80 off MSRP as part of their Holiday sale. Overnight shipping is free in many cases, and B&H charges sales tax in NY & NJ only. Note... Read more
Sunday flash sale: Beats Solo3 Wireless On-Ea...
Amazon has Beats Solo3 Wireless On-Ear Headphones on sale for $199.99 including free shipping. Their price is $100 off MSRP, and it’s the lowest price available for Beats Solo3. Multiple colors are... Read more
B&H Holiday sale: MacBooks for up to $300...
B&H Photo has Apple MacBook Pros, MacBook Airs, and 12″ MacBooks on sale for up to $300 off MSRP as part of their Holiday sale. B&H charges sales tax in NY & NJ only, and overnight... Read more
The lowest prices on Apple 13″ MacBook Pros t...
Save $300-$300 on the purchase of a 2017 13″ MacBook Pro this weekend with Certified Refurbished models at Apple. In many cases, Apple’s refurbished prices are the lowest available for each model... Read more
Lowest prices of the Holiday season: 15″ Appl...
Save $360-$420 on the purchase of a 2017 15″ MacBook Pro with Certified Refurbished models at Apple. In many cases, Apple’s refurbished prices are the lowest available for each model from any... Read more
Apple discounts Beats products by up to 30% t...
Apple has Beats by Dr. Dre (BeatsX, Powerbeats3 Wireless, and Beats Solo3 Wireless) on sale for up to 30% off their retail price from now until December 26th: – BeatsX: Was $149.95, now $99 –... Read more
Updated Price Trackers: Macs, iPads, iPhones,...
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
How to preorder a new iMac Pro and pay zero s...
B&H Photo and Adorama are accepting preorders on multiple configurations of the new Apple iMac Pro. Both resellers charge sales tax for residents of NY & NJ only, and shipping is free.... Read more
Apple Macs back in stock at Amazon with model...
Amazon has MacBook Pros, MacBook Airs, MacBooks, and iMacs on sale for up to $200 off MSRP as part of their Holiday/Christmas sale. Shipping is free. Note that stock of some Macs may come and go (and... 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* 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* Retail - Multiple Positions - Apple,...
Job Description:SalesSpecialist - Retail Customer Service and SalesTransform Apple Store visitors into loyal Apple customers. When customers enter the store, 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
*Apple* Retail - Multiple Positions - Apple,...
Job Description:SalesSpecialist - Retail Customer Service and SalesTransform Apple Store visitors into loyal Apple customers. When customers enter the store, Read more
All contents are Copyright 1984-2011 by Xplain Corporation. All rights reserved. Theme designed by Icreon.