ReadMe.txt

Author: Fabian Blauensteiner
Date: 05.03.2023
Subject: Bachelorthesis JDOR – An introduction to Java 2D’s drawing classes with ooRexx and BSF4ooRexx

To execute the programs that can be found in the folder, following languages and frameworks are needed:
(make sure that BSF4ooRexx850 is installed last)

ooREXX 5.0:
 - Link: https://sourceforge.net/projects/oorexx/files/oorexx/5.0.0/ooRexx-5.0.0-12583.windows.x86_64.exe/download
 - Opening the link automatically starts the download after "cookies" are accepted or declined
 - Install the programming language over the downloaded installer
 - Follow the steps of the installer (no additional markers need to be set during the installation)

Java 8.0 (or newer):
 - Link: https://bell-sw.com/pages/downloads/
 - Download the MSI version of the FULL JDK package
 - Install the programming language over the downloaded installer
 - Follow the steps of the installer (no additional markers need to be set during the installation)

BSF4ooRexx850:
 - Link: https://sourceforge.net/projects/bsf4oorexx/files/latest/download
 - Unzip the downloaded folder and execute the file in the subfolder "/install/windows/install.cmd"
 - Opens a command-window where user-input is needed


A complete installation guide for each component can be found in chapter 4 "Installation Guide and Troubleshooting" of my bachelor thesis


Quick overview of the provided programs and which chapter of the bachelor thesis describes it in more detail:

 JDOR_basic_shapes.rxj: (chapter 6.1)
  - Shows how different shapes can be drawn in different colours

 JDOR_strokes.rxj: (chapter 6.2)
  - Shows how to use different types of strokes (strength and pattern)

 JDOR_Strings.rxj: (chapter 6.3)
  - Gives an example of different fonts and their attributes (bold, italic)

 JDOR_images.rxj: (chapter 6.4)
  - Shows how to load, edit and save images
  - needs the "Snowman.png" file to work

 JDOR_transform.rxj: (chapter 6.5)
  - Shows how shapes can be transformed using the "rotate","scale","shear" and "transform" commands

 JDOR_move.rxj: (chapter 6.6)
  - Shows how the illusion of movement can be created in JDOR and gives the basic understanding of collision detection

 JDORFX.rxj: (chapter 6.7)
  - Combines JDORs' capabilities with JavaFXs' features to move objectes and create new drawings

 JDOR_shapes.rxj: (chapter 6.8)
  - Shows how "Shapes" and "Path2D" objects can be used in JDOR


The "jdor.cls" file is needed to properly execute the programs. 
  - The file was created by ao.Univ.Prof.Mag.Dr.rer.soc.oec Rony G. Flatscher


"Snowman.png" : Picture of a Snowman and a Stickman
  Copyright (C) 2023 Fabian Blauensteiner

  This information is free; 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 2 of the License, or (at your option) any later version.

  This work 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.
