Gallery

From Elite Wiki
Revision as of 00:17, 15 December 2013 by Norby (talk | contribs) (v1.11)
Select starting object
Details, rotate and zoom
Hidden menu
Search in Gallery
Exhibitions Menu
Pirate Meetings
Order a private exhibition
Salon in Oolite v1.79
Salon with OXP ships


Download it from here.

Description

Show encountered ship and object types in Interfaces (F4). Extend your gallery by fly around and target or fight with ships and objects.

If you are a new pilot then you encountered ships in shipyards alone, so you can see stock purchasable versions only.

Press F4 when you docked, choose "Gallery of encounters" to see ship statistics and rotating models.

You will see how many objects you gathered at the moment and the list of last encounters.

Only the first name from each initials listed here to fit into the screen when you will have one in each letter also.


Menu

Looks like this:

"Name"
Previous
Search
Rotate X+ / Stop / X- / Stop / Y+ / Stop / Y- / Stop
Move X+ / Stop / X- / Stop / Y+ / Stop / Y- / Stop
Zoom + / Stop / Zoom - / Stop
Exit
Hide Menu

First line show name of the current object, press it to see the next one.

You can step back, search, rotate, move, zoom and hide the menu to get better view of objects.

Search menu can use text entry in Oolite 1.79 and show the details of your ship to easily compare with others, and fallback to starting selection list in 1.77.


Exhibitions

Check incoming ship meetings in Exhibitions Interface (F4) where you can get rare ships into your Gallery.

Type specific exhibitions contain ships which not in largest ones.

Beware of Pirate Meetings, there are agressive guards out there!

Plan your route to arrive to the advertised systems in time. Exhibitions organized near witchpoints.

You can request permission for rotating ships, after you got it you can rotate with target lock.

To help find which ship is missing from your Gallery these start rotating initially. Make a target lock on each rotating ship to gather these into your Gallery.

Some ship can be different in colour only or looks like exactly the same (colouring need shaders).

After 5 minutes you must join into the queue again due to others want control also.


Visitor Levels

Your visit will be registered when you target at least one ship in an exhibition. You can increase your Visitor Level if you check more exhibitions.

You will get appreciative messages when you reach the following levels:

Visit	Level
1	Novice Visitor
2	Unexpected Visitor
4	Poor Visitor
8	Below Average Visitor
16	Average Visitor
32	Above Average Visitor
64	Competent Visitor
100	Trustworthy Visitor!
300	Expected Visitor!
1000	Elite Visitor!


Salon Control equipment

You can order a private exhibition of purchasable ships before the dock where you are by either pay out this equipment or order in Exhibitions Interface.

A few days will elapse until all ships arrive.

You will be fined if you destroy them.

You can start-stop all rotation in Salon by prime (Shift+N) and activate (n) Salon Control equipment.

To rotate one ship simply target it (or stop one if all is rotating).

Mode (b) button of primed equipment show how many ships in Salon.

Some part of Salon will be hide if too many ships cause low FPS, in this case mode (b) key show next part.

Salon will be closed if you dock into another station (to you can order a new one before the new station) or you jump into another system but remain if you take a rest (save then load game).

Cost: 100.0 Cr.
Techlevel: 1


Instructions

In Oolite v1.79 or later do not unzip the .oxz file, just move into the AddOns folder of your Oolite installation.

In Oolite v1.77 make a Gallery.oxp subfolder in your AddOns folder and unzip the .oxz file into the newly created subfolder.


Dependencies

Oolite v1.77 at least, v1.79 or later needed to get all functionality, but development versions of Oolite can cause surprises or suffer changes, use at your own risk.


Limitations

Every menu press redraw ship model so shader colours and decals will change by all Rotate, Move, etc. press.

Ship details hidden based on the following (maybe need to extend):

  • Technical Reference Library OXP (validator copied from v1.0.1 but call the original if TRL OXP installed),
  • ccl_missionShip in scriptInfo,
  • "stealth" word within dataKey or primaryRole.

This OXP use Ship.keys(), Ship.roles() and Ship.keysForRole("role") methods in Oolite v1.79. There are a slow and inaccurate method for Oolite v1.77 which try to get all ships but a few left out randomly. Moreover can cause crash at game start if not enough memory (if spinning cobra appear then you have enough memory). You can reduce the $GalleryMaxIt variable in gallery.js to avoid the problem if needed but more ship will be left out.

Can show ship.energyRechargeRate and ship.extraCargo in v1.79 only.

Ships with "subent" word in dataKey are removed to skip subentities in Griff_Shipset_Replace_v1.34.oxp.

Turrets, docks and other subentities without "subent" rule will appear in v1.79 if all objects mode enabled in gallery.js, there are no exact method to skip all of these. In v1.77 it is not a problem due to the fallback method can include ships with given roles only (see in gallery.js, you can extend if you want) so all OXP ships without standard roles left out completely.


Setings in gallery.js

this.$GalleryAll = false; //Gallery of all objects (cheat)
this.$GalleryDefaultZoom = 1.5; //default size of ships
this.$GalleryMaxIt = 5; //max. iteration in Oolite v1.77, reduce if cause problems
this.$GalleryLog = false; //verbose log
this.$GalleryRoles = ["all", "player", ... ]; //main roles, you can add more
this.$GallerySpeed = 2; //move and zoom speed


Setings in exhibitions.js

this.$ExhibitionsLargeSalon = false; //Salon show NPC ships also (cheat)
this.$ExhibitionsLog = false; //verbose log
this.$ExhibitionsMaxShipsInLargeExhibitions = 144; //should be square number and min. 64
this.$ExhibitionsMinFPS = 20; //split Salon to get more than this frames per second
this.$ExhibitionsSpace = 150; //m space between ships in exhibition matrix


License

This work is licensed under the Creative Commons Attribution-NonCommercial-ShareAlike License version 3.0.

If you are re-using any piece of this OXP, please let me know by sending an e-mail to norbylite at gmail.com.

Background image source: Start Choices OXP by spara.


Changelog

2013.12.14. v1.11 Proofreading by Ranthe.
2013.12.13. v1.1  Salon split into more parts if needed to reach $ExhibitionsMinFPS.
2013.12.06. v1.0  Exhibitions and Visitor levels.
                  List of last encounters.
2013.11.27. v0.9  Salon Control equipment: exhibition of buyable ships at Navigation Buoy.
2013.11.26. v0.8  Show shields from NPC shields OXP and CustomShields OXP.
                  Fixed empty and duplicated names.
2013.11.25. v0.7  Show encountered and playable ships only by default.
                  Show max.energy in banks, recharge in words and name instead of dataKey.
                  Details of some ships are hidden using Technical Reference Library OXP by spara.
                  Must set $GalleryAll to true if wanted all ships and details.
                  Search menu with text entry in Oolite 1.79 and selection list in 1.77.
2013.11.23. v0.6  Works with Oolite v1.77 also (but slow and limited).
2013.11.22. v0.5  First usable version.
2013.11.21. v0.1  First test files.


Download Gallery OXP from here.

Quick Facts

Levelindicator0.png
0-{{{2}}}
Version Released License Features Category Author(s) Feedback
1.11 2013-12-14 CC BY-NC-SA 3 Show installed ships Activities OXPs Norby BB-Link