Test Ship Model
by phkb

Overview
========
This OXP is designed as a testing rig for ships. It allows you to quickly view any ship, rotate it, zoom in and out, and basically just check out the ship from any angle you like.

Usage
=====
When docked at a station, an F4 interface will be available, called "Test Ship Model". When you select this, you will be asked to enter the ship's data key to display. Enter that key, and press enter.

At this point, you will be shown the ship. 

For Oolite 1.92
---------------
You can now use the arrow keys, the page up/dn keys, and the yaw keys (, and .) to rotate and zoom the ship. You can increase or decrease how far one keypress will move the ship by using the + and - keys.

R will reset the view back to the initial position. 

N will return to the screen where a new ship data key can be entered. Previous ships you have viewed will be listed as well. Use a number to select one of those ship keys instead of entering another data key. The last 15 ships will be displayed, and the list will be saved with the save game settings.

H will hide the instructions, which will be displayed with the ship model. Pressing H again will bring the instructions back.

If the ship model uses the personality property to change the skin or colour of the ship, you can enter a personality number by pressing the number keys. As you do, the "New personality" item will show in the instructions. Once you have entered the desired number, press P to set the personality to this value.

Pressing ESC will return you to the F4 Interfaces screen.

For Oolite 1.90
---------------
Use the menu on the left side to rotate the ship, zoom in and out, change the step amount, and reset the view.

Shortcut
========
In Oolite 1.92, you can also press Ctrl-T on the F5 Ship Status screen to jump directly to the Test Ship Model screen.

Extra Notes
===========
You can't display the model of anything with "is_template" set to yes/true/1. You would need the in-game version of the ship, ie. where "like_ship" has been set to the template key name.

Also, if there is a condition_script on the shipdata entry, those conditions will need to pass to display the model. For instance, attempting to view ships from the Commies mod will require you to be in a Communist system.

Requirements
============
Oolite version 1.82 or later is required for this OXP.

License
=======
This work is licensed under the Creative Commons Attribution-Noncommercial-Share Alike 4.0 Unported License. To view a copy of this license, visit http://creativecommons.org/licenses/by-nc-sa/4.0/

Version History
===============
1.3
- Added ability to move the model up/down/left/right.

1.2
- Made compatible with Oolite version 1.90.
- Added shortcut key to F5 Manifest screen (Ctrl-T) to open the test screen (available in Oolite 1.92 or later).
- Moved all text to descriptions.plist for easier localisation.

1.1
- Switched "allowInterrupt" to false.
- Added option to clear the data key history.

1.0
- initial release