ImageLab

ImageLab is a framework that allows students to develop image modification processors (filters) and to experience the results visually and aurally.

Contents

The imagelab and sound packages may be provided in an imagelab.jar file. The imagelab.jar file also includes the class Run with a public static void main method in the unnamed package, used to facilitate running the ImageLab application. (This version may also be used directly as a BlueJ project.)

The filter package is generally provided as a folder with source (.java) and compiled (.class) files, with the source versions serving as examples for students.

A sample set of images are provided in an "images" directory.

Creating an executable jar file

The project is already set up using the gradle wrapper so we can just use that to create the jar file.

1. Using the command line interface, change to the project's root directory.
2. Execute the command ./gradlew build
3. This will build/rebuild the jar file using all the required dependencies.
4. The new jar file will be named "imagelab.jar" and it will be located in the project's root directory.

More information on gradle can be found here and more information on the gradle wrapper can be found here.

If there is no automated build environment set up, the jar file can be created using jar.

1. Using the command line interface, change to the project's root directory.
2. Execute the command javac Run.java to compile the Run.java file.
3. Execute the command javac *.java in the package directories to compile/recompile those package java files. The package directories for this project will be the sound and imagelab directories.
4. In the root directory execute the command echo Main-Class: Run > MANIFEST.MF to create the manifest file you will use for making the jar.
5. Create the jar using the command jar cfm imagelab.jar MANIFEST.MF *.class sound/*.class imagelab/*.class
6. The new jar file will be named "imagelab.jar" and it will be located in the project's root directory.

More information on creating the jar can be found here and more information about java commands can be found here.

The executable jar file can also be created within an IDE. Some specific examples from popular IDE's can be found here:

• Eclipse
• JDeveloper
• IntelliJ
• BlueJ
• NetBeans
• VS Code
• DRJava

To use from command line:

• Make sure the filters directory is in the same directory as the imagelab.jar file.
• Then issue the command
  java -jar imagelab.jar

An alternative command is: java -cp ".:imagelab.jar" Run
Note that on Windows platforms, the ":" character in the classpath must be changed to the ";" character.

License

ImageLab is a framework for student exploration of image processing.
Copyright (C) 2016,2019 by Aaron Gordon & Jody Paul
The software comes with ABSOLUTELY NO WARRANTY.

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see https://www.gnu.org/licenses/

---

Project Website: https://metrocs.github.io/imagelab/