This is a description how it works on my Ubuntu Gnu Linux system using openjdk 14, gradle/maven/ant, bash and clang/gcc (Comments have been added for building on OS X and Windows but are outdated).

1. Clone the project or download and extract it.
2. Change to the project directory.

LD_LIBRARY_PATH should return a valid path e.g.:

echo $LD_LIBRARY_PATH
/usr/local/lib/

If not you might want to add:

export LD_LIBRARY_PATH=/usr/local/lib/

to your .bashrc or .profile

There is a function in build.sh bash script called create_native_library that does everything. Just call:

./build.sh

and you can skip the java build steps.

If you get the following message: Gtk-Message: HH:mm:ss.zzz: Failed to load module "canberra-gtk-module"

apt install libcanberra-gtk-module libcanberra-gtk3-module

gradle compileJava jar
java -jar build/libs/yuvViewer-1.0-SNAPSHOT.jar

mvn verify
java -jar target/yuvViewer-1.0-SNAPSHOT.jar

ant run

Assuming you are in PROJECT_DIRCTORY

cd src/main/java/
javac (-source 14) org/yuvViewer/Main.java
cd org/yuvViewer/gui/
javah -jni YUVViewer (will not work with java version > 8 use javac -h instead see build file)
clang (or gcc) -shared (other compiler options) -I/usr/local/java/include/linux -I/usr/local/java/include/ -o libcalc.so YUVViewerImplementation.c
mv libcalc.so $LD_LIBRARY_PATH
cd PROJECT_DIRCTORY
java -cp src/main/java/:. org.yuvViewer.Main

Good read about YUV-format https://en.wikipedia.org/wiki/YUV

Obtaining YUV files:

• http://trace.eas.asu.edu/yuv/
• https://stackoverflow.com/questions/3644501/where-can-i-obtain-a-raw-yuv-file
• I added the file test_176x144.yuv (YUV4:2:0) to check that yuvViewer is ready to run. If you open the file with yuvViewer, you should see 4 colours: green (top-left), cyan (top-right), orange (bottom-left) and pink (bottom-right).

The followning sections have not been updated for more than 5 years

by Chris Schaab cschaab@vt.edu for Mac OS X Aug 16 2004

I had some troubles with your viewer program on Mac OS X, It seems that Apple has taken out -shared as something that will work from gcc. Instead it requires a 2 step process specific to java. I modified the build file to work on my machine(G5 powerPC, various specific java version info in paths) at least and have attached it. The script to look at is named buildMac in this folder.

by Eric Work work.eric@gmail.com for Mac OS X Dec 19 2004

The buildMac script now handles different architetures as arguments, eg. ./buildMac G4. The package script has been added, allowing a .app to be built with Jar Bundler from the Developer Tools

1. make sure cygwin and gcc is installed on your system
2. make sure a jsdk version 1.4 is installed on your system
3. make sure system environment variable JAVA_HOME is set to you base directory where you installed jsdk (i.e. c:\j2sdk1.4_08.
4. open cygwin bash console
5. mkdir ~/java; cd ~/java
6. extract tar in home dir, will create ~/yuvViewer_nativ directory
7. cd ~/java/yuvViewer_nativ
8. javac -source 1.4 org/yuvViewer/Main.java
9. cd ~/java/yuvViewer_nativ/org/yuvViewer/gui/
10. javah -jni YUVViewer
11. gcc -mno-cygwin -I$JAVA_HOME/include -I$JAVA_HOME/include/win32 -Wl,--add-stdcall-alias -shared -o calc.dll YUVViewerImplementation.c
12. mv calc.dll $JAVA_HOME/jni/lib/
13. java -Djava.library.path=$JAVA_HOME/jni/lib -cp ~/yuvViewer_nativ org.yuvViewer.Main

I compiled calc.dll using Borland C++ Compiler 5.5 It is freeware, but you have to make an account. site: http://www.codegear.com/downloads/free/cppbuilder To build the calc.dll library using Borland compiler, just execute buildWinBcc.bat

I compiled calc.dll using MinGW(Minimalist GNU for Windows) I used gcc version 3.4.2. It is freeware. site: http://www.mingw.org/download.shtml To build the calc.dll library using MinGW compiler, just execute buildWinGcc.bat