notes.txt

To-do: (approximate priority order)

* add extra ships from Elite-A (see below)
* fix clipping planes and/or scaling so that ships don't fall
  "through" the sides of the screen
* reinstate front lasers - cobra, others?
* Asp: check original data for aerials
* Moray: check original data for torpedo tubes
* Coriolis/Dodo: tearing of docking port in filled mode
* textures??
* update for 6.01 (not yet shipped by Debian or Ubuntu) v601 branch

Ongoing:

* manually fix in-plane point co-ordinates
* Transporter: reinstate IB/DB initials and lines on base

Done:

* add command-line switch to choose which ship is displayed
* wireframe drawing
* Coriolis: fix docking port
* rename cobra.* -> commander.*
* "random" mode - change displayed ship sometimes
* fix wireframe drawing - do filled polygons first
* fix polygon data to merge triangles - no, use original data
* check Oolite licensing situation - CC-NC-SA-2 - no, use original data
* Viper: add engines - by using original data
* Cobra: add engines - by using original data
* Asp: check data - by using original data
* should Coriolis only rotate about docking port axis? - hard, not
  worth it
* fix flickering - glFlush() doesn't help - check polyhedra - done by
  abandoning glPolygonOffset and double-drawing approach (so filled
  mode doesn't work any more)
  - fixes Krait: windscreen tearing
  - fixes Moray: windscreen tearing
* fix show-through:
  - Krait side aerials
  - Cougar side fins
  - Missile fins
* Thargoid: check original data for lines on base
* fix other sides of missile fins, cougar side fin
* xscreensaver necessities: .man, .xml
* update for 5.36 as shipped with Ubuntu 18.04


Gah, Gnome will only list/start a screensaver if it's in a "trusted"
directory (i.e. /usr/lib/xscreensaver)

binary goes in /usr/lib/xscreensaver
.xml file goes in /usr/share/xscreensaver/config
.desktop file goes in /usr/share/applications/screensavers
or ~/.local/share/applications/screensavers/

see http://ubuntuforums.org/showthread.php?t=1583335

Elite web site: http://www.iancgbell.clara.net/elite/
Elite ships: http://wiki.alioth.net/index.php/Classic_Elite_ships
http://live.gnome.org/GnomeScreensaver/FrequentlyAskedQuestions

Hidden line removal: http://glprogramming.com/red/chapter14.html#name16
http://www.bluevoid.com/opengl/sig00/advanced00/notes/node105.html

to invert winding order:
sed -e 's/{//' -e 's/},//' | awk -F , '{ print "{" $3 ","  $2 "," $1 "}," }'

to scale down vertex data:
awk -F , '{ S=10; print $1/S "," $2/S "," $3/S "," }'

sync to vblank/refresh:
__GL_SYNC_TO_VBLANK=1
LIBL_SYNC_REFRESH=1

http://www.opengl.org/wiki/Synchronization

Adding extra ships from Elite-A:
https://www.bbcelite.com/deep_dives/elite-a_the_original_source_files.html
https://github.com/markmoxon/elite-a-beebasm
ship data is in:
elite-a-beebasm/1-source-files/main-sources/elite-ships-*.asm

xscreensaver 6.01 needs EGL/egl.h
(sudo apt install libegl-dev?)
sudo apt install libegl1-mesa-dev <-- 18.04
(also systemd lib somehow?)