EZ is a multimedia library designed to make it easier for novice programmers to quickly build Java applications that incorporate graphics and sound.

The EZ graphics file - v1.22 (March 8th, 2017). Changelog.
If clicking on it doesn't provide a download prompt, right click > save as.
Major updates to EZImage, EZInteraction, and EZSound. These changes have not yet been added to the documentation webpage. For a better description see the change log and the comments within the file.

EZ Graphics Documentation

The following programs should be installed:

Java Development Kit(JDK) version 8


First determine if your computer is 32 or 64 bit.
Windows Users: Start > Control Panel > System > Look for "System Type" it will state 32 or 64 bit.
Mac Users: Click on the top left apple > About this Mac > More Info > System Report > Click on Hardware and look for Processor name. Go to this apple support page and find your processor in the lookup table in step 4.
Linux Users: Deal with it.
Download from Oracle: Download Page.
Match up your OS with the architecture. x86 is 32 bit. x64 is 64 bit.
If you are unsure which architecture your system has, use 32 bit.
After it has finished downloading, run the installer and follow the on screen prompts.

Eclipse Integrated Development Environment (IDE)


Go to Eclipse's download page and download the standard standard installer. Choose the corresponding architecture. If you are unsure which architecture your computer has, use 32 bit. The current version at the time of this page's creation is: 4.4 Luna.
When it has finished downloading, run the installer and follow the on screen prompts.
Windows users: the download link for the latest version of Eclipse (Luna 4.4) will provide a zip file. You must extract the contents of the file, which will be a folder called "eclipse". Place that folder in a location that has write access. Easiest place would be Program Files. From there the eclipse.exe will run eclipse.

When Eclipse runs for the first time, it will ask you where you want to setup the workspace. Use a location you know you will be able to access.

Importing EZ into an Eclipse Project


First, download EZ from the first section.

Once you have the EZ file saved, open Eclipse. If you do not already have a project, create a new one. File>New> Java Project>

A window will pop up. Name your project and make sure that the JRE "Use an execution environment JRE:" is selected with JavaSE-1.8. Click finish.
A new project will be shown in the Package Explorer pane. If you cannot see that pane, go to Window> Show View> Package Explorer.
Expand the project view so you can see the src folder.
Open an OS window, making sure you can see the EZ.java file.
Drag and drop the EZ.java file to the src folder.

You are now ready to code.

Hello World


Make a new class file in your project. Right click the src folder> New> Class

Name it HelloWorld. By industry regulations you are required to make HelloWorld your first program. Failure to do so may result in spontaneous combusion of your computer(Unconfirmed).
Check off "public static void main(String[] args)"
If you did not check off the noted box, not to worry. Will just have some extra typing to do.
Press finish
Inside of main() add:
System.out.println("Hello world");
Your code should look like the following:
Run the program. The lower info pane should show the words, Hello World.
By writing this program you have completed the first rite of passage to becoming a programmer.

Hello World with EZ


To use EZ, some changes will be made to the file.
At the top of the file add:
import java.awt.Color;
Erase the contents of main(), then add the following lines:
EZ.initialize(200,200);
EZ.addText(100, 100, "Hello World", Color.BLACK);
Your code should look like the following:

Run the program. A window will show up with the words, Hello World.

The three lines each had a specific purpose in the program.
import java.awt.Color; - Allows you to specify Color for EZ elements.
EZ.initialize(200,200); - Creates a window having a width of 200 pixels and height of 200 pixels.
EZ.addText(100, 100, "Hello World", Color.BLACK); - Creates the text on the window. Without this, the window would have been blank. The 100,100 states where the center of the text will be located in the window's coordinates. The String "Hello World" will be displayed in the specified Color.BLACK.
To learn of more things you can create, see the documentation of EZ's add methods.

Dylan Kobayashi - dylank@hawaii.edu
Office Hours: TBD













2015