README for:  Wing Geometry
Written by:  Joseph A. Huwaldt <jhuwaldt@mac.com>
Version:  1.7.2b
Date:  February 5, 2025
Web site:  http://thehuwaldtfamily.org/java/Applications/WingGeom/WingGeometry.html


This Java program calculates parameters related to trapezoidal airplane wing geometry.  Simply type in the parameters that you know with the appropriate units, and the other parameters will be calculated automatically.  Parameters can be entered in any order.  As soon as enough information has been entered, the remaining parameters will be updated automatically.

Installation Instructions:

MacOS:
You should have received this application as a compressed disk image file (WingGeometry_#.#.#_MacOS.dmg). This disk image file, when mounted (by double-clicking on it), should contain the application icon (Wing Geometry), this readme file (README.txt), and some license related legalese.

To install this program, simply drag the Wing Geometry icon to a convenient location on your hard drive. In MacOS this is usually the "Applications" directory, but you are free to put it anywhere you want.

The application file should work properly on MacOS 14.5 and later right out of the box. No additional software required (you do not need to have Java installed).

On MacOS the security settings will prevent you from being able to run this program since it was downloaded from the internet and is does not have an Apple Developer ID signature (I am not an "identified developer").  After trying to run it the first time and dismissing the warnings, you will need to do the following:

1) Open System Preferences
2) Open Security & Privacy
3) Scroll down to "Security"
4) Find a message saying that Wing Geometry was prevented from running because it is from an unknown developer and click the "Run Anyway" button.

You should be able to run Wing Geometry from then on.


Windows:
You will first have to make sure that you have a Java 11 or later Java Runtime Environment (JRE) installed on your computer.  If you do not, you can get it from: https://www.java.com or an open source version from http://azul.com.

You should have received this application as a ZIP archive file (WingGeometry_#.#.#_Windows.zip). Uncompress this archive.  It contains an double-clickable JAR file named WinGeometry.jar, this readme file and some license information.

To install this program, simply drag the WingGeometry.jar icon to a convenient location on your hard drive and double-click on it to start it.  It should work from anywhere.


Linux (and many flavors of UNIX):
You will first have to make sure that you have a Java 11 or later JRE installed on your computer and on your search path.  If you do not, you can get it from: https://www.java.com or an open source version from http://azul.com.

You should have received this application as a compressed archive file (WingGeometry_#.#.#_Linux.tgz). After decompressing this file using "tar -xvzf WingGeometry_#.#.#_Linux.tgz", you will get a file named WingGeometry.jar, this readme file and some license information.  This is a "double-clickable" jar file, or you can run it from the command line using:

java -jar WingGeometry.jar

You may want to create a shell script to do this for you.


Revision History:
Version: 1.7.2b 05-FEB-2025
* Fixed a problem with running on MacOS 15.1. No change to any other OS versions.

Version: 1.7.2 16-DEC-2023
* Modified to remove the seriously out of date MRJAdapter and Bare Bones Browser Launcher libraries and replaced them with the now standard java.awt.Desktop class.
* Modified MacOS application bundle to work better on modern versions of MacOS.
* The MacOS version has a Java 11 compatible JRE bundled with the application (you do not need to have Java installed to run this version).

Version: 1.7.1 09-OCT-2020
* Fixed a bug with an underlying library (MRJAdapter) that wasn't compatible with recent versions of Java (Java 15 in particular).

Version 1.7.0     21-SEP-2018
* Added the ability to export the wing top-view image to a PNG or SVG (Scaled Vector Graphic) format file.
* This version requires Java 1.7 or later.
* This is the 20th anniversary version of WingGeometry!!

Version 1.6.1     17-JAN-2015
* Fixed a problem that could cause the program to freeze up at certain times, especially under Windows.
* Fixed a bug that prevented the program from running properly on recent versions of MacOS X.
* Improved message strings and corrected an error message that read incorrectly.
* Changed the degree unit symbol to "deg".
* Cleaned up formatting and improved code documentation.

Version 1.6.0     04-FEB-2014
This update adds support for saving wing geometry parameters to a file and reading them back in.  This allows the user to save off a set of inputs and recall them at a later time.  This version now requires Java 1.6 or later.

Version 1.5.2     30-JUN-2012
Fixes a bug that prevented the user from entering numbers that start with a minus sign or a decimal point.

Version 1.5.0     11-SEP-2011
This update fixes a unit bug, adds a new parameter (the longitudinal location of the 1/4 chord of the mean aerodynamic chord) and adds some additional calculation methods to the other parameters.  This revision also removes the Windows EXE file distributed with the previous version in favor of a double-clickable JAR file (the help methods did not work with the EXE file).

Version 1.4.0     17-JUL-2011
This is a minor update that modernizes much of the code base, changes the package used for units, and fixes a number of user interface bugs.  This is also the first release that does not require an installer on Windows and Linux/UNIX.  Finally, this release features a new application icon.

Version: 1.3.0    17-JAN-2006
Added a planform view of the wing represented by the values in the text boxes.

Version: 1.2.0    22-MAY-2004
Started using a new library that improves MacOS X integration.  As a side-effect, the application on any platform can now have multiple windows open at a time and there is a "Windows" menu that can be used to navigate between all open windows.

Version 1.1.0    06-NOV-2003
Fundamentally changed the algorithm used to locate resources (images, help files, etc) to be more robust, especially on Linux.  Otherwise, there are no significant changes over the previous version.

Version 1.0.1    20-MAY-2002
Began tracking the revision history for this program. This release (1.0.1) was primarily a code cleanup to support the 1st release of the full source code. No functional change over the previous version. Dropped support for MacOS 9.


Legal Notice:
Wing Geometry is a program for calculating trapezoidal wing geometry parameters.
Copyright (C) 1998-2025  Joseph A. Huwaldt

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 2 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, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.  Or visit the Free Software Foundation's web site:
    http://www.gnu.org/copyleft/gpl.html

The source code for this program is available for download here:
http://thehuwaldtfamily.org/java/Applications/WingGeom/WingGeometry.html

Feel free to contact me if you have any problems or questions about this program.

Ad astra,

Joseph A. Huwaldt
jhuwaldt@mac.com
