Difference between revisions of "Gallery"

From Elite Wiki
(v1.11)
(v1.21)
 
(13 intermediate revisions by the same user not shown)
Line 6: Line 6:
 
[[File:Gallery10.png|350px|thumb|right|Pirate Meetings]]
  
[[File:Gallery10.png|350px|thumb|right|Pirate Meetings]]
 
[[File:Gallery11.png|350px|thumb|right|Order a private exhibition]]
  
[[File:Gallery11.png|350px|thumb|right|Order a private exhibition]]
−
[[File:Gallery7.png|350px|thumb|right|Salon in Oolite v1.79]]
 +
[[File:Gallery7.png|350px|thumb|right|Private Exhibition in Oolite v1.79]]
−
[[File:Gallery6.png|350px|thumb|right|Salon with OXP ships]]
 +
[[File:CarriersMeeting.png|350px|thumb|right|[[Carriers]] meet [[Andromeda]] in Private Exhibition]]
  +
[[File:Gallery6.png|350px|thumb|right|Private Exhibition with OXP ships]]
   
  +
=== Description ===
   
−
Download it from [https://app.box.com/s/t7vnj3kfinbpc7m1twy3 here].
  
  +
Show encountered ships and other space objects in Interfaces (F4).
−  
−
=== Description ===
  
   
−
Show encountered ship and object types in Interfaces (F4).
  
  +
Extend your gallery by flying around and targeting or fighting with ships and other space objects.
−
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.
 +
If you are a new pilot then you will only see purchasable ships from the station shipyards.
   
−
Press F4 when you docked, choose "Gallery of encounters" to see ship statistics and rotating models.
 +
Press F4 when you are docked, then 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.
 +
You will see how many ships and other space objects you have currently gathered 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.
  
Only the first name from each initials listed here to fit into the screen when you will have one in each letter also.
   
   
−
=== Menu ===
 +
=== Gallery Menu ===
−
Looks like this:
  
   
 
"Name"
  
"Name"
Line 37: Line 35:
 
Hide Menu
  
Hide Menu
   
−
First line show name of the current object, press it to see the next one.
 +
The first line shows name of the current object displayed, select it to see the next rotating model.
   
−
You can step back, search, rotate, move, zoom and hide the menu to get better view of objects.
 +
You can step back, search, rotate, move, zoom and hide the menu to get a better view of the rotating model.
−  
−
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.
  
   
  +
The Search menu uses text entry in Oolite 1.79. Oolite 1.77 uses a selection list.
   
   
 
=== Exhibitions ===
  
=== Exhibitions ===
   
−
Check incoming ship meetings in Exhibitions Interface (F4) where you can get rare ships into your Gallery.
 +
Check incoming ship meetings in Exhibitions Interface (F4) where you can add rare ships into your Gallery.
   
 
Type specific exhibitions contain ships which not in largest ones.
  
Type specific exhibitions contain ships which not in largest ones.
   
−
Beware of Pirate Meetings, there are agressive guards out there!
 +
Beware of Pirate Meetings, there are aggressive guards out there!
   
−
Plan your route to arrive to the advertised systems in time. Exhibitions organized near witchpoints.
 +
Plan your route to arrive to the advertised systems in time. Exhibitions are organized near witchpoints.
   
−
You can request permission for rotating ships, after you got it you can rotate with target lock.
 +
You can request permission to rotate exhibition ships for viewing, after you have received permission it you can rotate the ship by locking target on it.
   
 
To help find which ship is missing from your Gallery these start rotating initially.
  
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.
 +
Select each rotating ship with a target lock to add these into your Gallery.
   
−
Some ship can be different in colour only or looks like exactly the same (colouring need shaders).
  
  +
Some ships may only differ in colour (colouring need shaders, if your system does not aupport shaders then these ships will look identical).
   
−
After 5 minutes you must join into the queue again due to others want control also.
 +
After 5 minutes you must join the exhibition queue again so that other exhibition visitors can have their turn.
   
   
 
=== Visitor Levels ===
  
=== Visitor Levels ===
   
−
Your visit will be registered when you target at least one ship in an exhibition.
 +
Your visit to an exhibition 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 can increase your Visitor Level if you check more exhibitions.
   
−
You will get appreciative messages when you reach the following levels:
 +
You will receive messages when you reach the following levels of appreciation:
   
 
Visit Level
  
Visit Level
Line 83: Line 82:
   
   
−
=== Salon Control equipment ===
 +
=== Private Exhibition 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.
 +
You can order a private exhibition of purchasable ships which will arrive 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.
  
A few days will elapse until all ships arrive.
   
−
You will be fined if you destroy them.
 +
You will be fined if you destroy any of them.
   
−
You can start-stop all rotation in Salon by prime (Shift+N) and activate (n) Salon Control equipment.
 +
You can start and stop all rotation in Private Exhibition by priming (Shift+N) and activating (n) the Private Exhibition Control equipment.
  +
To rotate one ship simply target it. Target a rotating ship to stop rotating.
   
−
To rotate one ship simply target it (or stop one if all is rotating).
  
  +
The mode (b) of the primed equipment shows how many ships exists in Private Exhibition.
   
−
Mode (b) button of primed equipment show how many ships in Salon.
  
  +
Some parts of Private Exhibition will be hidden if too many ships causes display problems on your system. If this happens, select the mode (b) key to show the next part.
   
−
Some part of Salon will be hide if too many ships cause low FPS, in this case mode (b) key show next part.
  
  +
Private Exhibition will be closed if you dock into another station (you can order a new Private Exhibition there) or you jump into another system. Private Exhibition will remain active if you take a rest (save then load game).
   
−
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.
  
Cost: 100.0 Cr.
Line 113: Line 111:
   
 
=== Dependencies ===
  
=== Dependencies ===
−
Oolite v1.77 at least, [http://terrastorage.dyndns.info/oolite/status.html 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.
 +
Oolite v1.77 at least, [http://terrastorage.dyndns.info/oolite/status.html v1.79] or later needed to get all functionality.
−  
   
 
=== Limitations ===
  
=== Limitations ===
   
−
Every menu press redraw ship model so shader colours and decals will change by all Rotate, Move, etc. press.
 +
Every menu selection redraws the ship model, so shader colours and decals will change by when you select Rotate, Move, etc.
   
−
Ship details hidden based on the following (maybe need to extend):
 +
Ship details are hidden based on the following (maybe need to extend):
 
* [[Technical_Reference_Library|Technical Reference Library]] OXP (validator copied from v1.0.1 but call the original if TRL OXP installed),
  
* [[Technical_Reference_Library|Technical Reference Library]] OXP (validator copied from v1.0.1 but call the original if TRL OXP installed),
 
* ccl_missionShip in scriptInfo,
  
* ccl_missionShip in scriptInfo,
Line 125: Line 123:
   
 
This OXP use Ship.keys(), Ship.roles() and Ship.keysForRole("role") methods in Oolite v1.79.
  
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.
 +
There is a slow and inaccurate method for Oolite v1.77 which tries to get all ships, but a few ships are randomly left out. This OXP can cause a crash at game start there is if not enough memory (if spinning cobras appear then you have enough memory). You can reduce the $GalleryMaxIt variable in gallery.js to avoid the problem if needed, but more ships will be left out.
   
 
Can show ship.energyRechargeRate and ship.extraCargo in v1.79 only.
  
Can show ship.energyRechargeRate and ship.extraCargo in v1.79 only.
Line 147: Line 145:
 
=== Setings in exhibitions.js ===
  
=== Setings in exhibitions.js ===
 
 
−
this.$ExhibitionsLargeSalon = false; //Salon show NPC ships also (cheat)
 +
this.$ExhibitionsAllShipsInPrivateExhibition = false; //show NPC ships in Private Exhibition (cheat)
 
this.$ExhibitionsLog = false; //verbose log
  
this.$ExhibitionsLog = false; //verbose log
 
this.$ExhibitionsMaxShipsInLargeExhibitions = 144; //should be square number and min. 64
  
this.$ExhibitionsMaxShipsInLargeExhibitions = 144; //should be square number and min. 64
−
this.$ExhibitionsMinFPS = 20; //split Salon to get more than this frames per second
 +
this.$ExhibitionsMinFPS = 20; //split Private Exhibition to get more than this frames per second
 
this.$ExhibitionsSpace = 150; //m space between ships in exhibition matrix
  
this.$ExhibitionsSpace = 150; //m space between ships in exhibition matrix
   
   
 
=== License ===
  
=== License ===
−
This work is licensed under the Creative Commons Attribution-NonCommercial-ShareAlike License version 3.0.
 +
This work is licensed under the Creative Commons Attribution-NonCommercial-ShareAlike License version 4.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.
  
If you are re-using any piece of this OXP, please let me know by sending an e-mail to norbylite at gmail.com.
Line 163: Line 161:
   
 
=== Changelog ===
  
=== Changelog ===
−
2013.12.14. v1.11 Proofreading by Ranthe.
  
  +
2015.04.25. v1.21 Many small fixes, thanks to QCS.
  +
2014.07.04. v1.20 Fix for seedy space bar and ships with ship script.
  +
2014.07.03. v1.19 Exhibitioins are moved forward to 10km from the player's exit point.
  +
Oversized ships in Exhibitions are moved farther from others.
  +
Small fix in gallery search.
  +
2014.05.19. v1.18 Fast startup in Oolite 1.79 by the new [http://wiki.alioth.net/index.php/Oolite_JavaScript_Reference:_Ship#shipDataForKey shipDataForKey].
  +
2014.05.18. v1.17 Back to the previous startup method after a fix in Oolite.
  +
2014.05.18. v1.16 Faster startup in Oolite 1.79 if many OXZs are installed.
  +
2014.01.17. v1.15 Small fix against "Unknown expansion key [Exhibition Guard]" log messages.
  +
2013.12.28. v1.14 Further proofreading by Keeper and Salon renamed to Private Exhibition.
  +
2013.12.15. v1.12 Proofreading by Ranthe.
 
2013.12.13. v1.1 Salon split into more parts if needed to reach $ExhibitionsMinFPS.
  
2013.12.13. v1.1 Salon split into more parts if needed to reach $ExhibitionsMinFPS.
 
2013.12.06. v1.0 Exhibitions and Visitor levels.
  
2013.12.06. v1.0 Exhibitions and Visitor levels.
Line 180: Line 188:
   
   
−
Download Gallery OXP from [https://www.box.com/s/t7vnj3kfinbpc7m1twy3 here].
  
  +
=== Downloads ===
  +
[[Media:Gallery_1.21.oxz|Gallery v1.21]] (downloaded {{#downloads:Gallery_1.21.oxz}} times).
  +
  +
[[Media:Gallery_1.20.oxz|Gallery v1.20]] (downloaded {{#downloads:Gallery_1.20.oxz}} times).
  +
   
 
===Quick Facts===
  
===Quick Facts===
 
{{OXPLevel|0}}{{Infobox OXPb| title = Gallery
  
{{OXPLevel|0}}{{Infobox OXPb| title = Gallery
−
|version = 1.11
 +
|version = 1.21
−
|release = 2013-12-14
 +
|release = 2015-04-25
 
|features = Show installed ships
  
|features = Show installed ships
−
|license = CC BY-NC-SA 3
 +
|license = CC BY-NC-SA 4
 
|category = Activities OXPs
  
|category = Activities OXPs
 
|author = [[User:Norby|Norby]]
  
|author = [[User:Norby|Norby]]
−
|download = [[https://www.box.com/s/t7vnj3kfinbpc7m1twy3|Download]]
  
 
|feedback = [http://bb.aegidian.org/viewtopic.php?f=4&t=15866 BB-Link]
  
|feedback = [http://bb.aegidian.org/viewtopic.php?f=4&t=15866 BB-Link]
 
}}
  
}}

Latest revision as of 15:31, 25 April 2015

Select starting object
Details, rotate and zoom
Hidden menu
Search in Gallery
Exhibitions Menu
Pirate Meetings
Order a private exhibition
Private Exhibition in Oolite v1.79
Carriers meet Andromeda in Private Exhibition
Private Exhibition with OXP ships

Description

Show encountered ships and other space objects in Interfaces (F4).

Extend your gallery by flying around and targeting or fighting with ships and other space objects.

If you are a new pilot then you will only see purchasable ships from the station shipyards.

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

You will see how many ships and other space objects you have currently gathered 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.


Gallery Menu

"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

The first line shows name of the current object displayed, select it to see the next rotating model.

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

The Search menu uses text entry in Oolite 1.79. Oolite 1.77 uses a selection list.


Exhibitions

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

Type specific exhibitions contain ships which not in largest ones.

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

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

You can request permission to rotate exhibition ships for viewing, after you have received permission it you can rotate the ship by locking target on it.

To help find which ship is missing from your Gallery these start rotating initially. Select each rotating ship with a target lock to add these into your Gallery.

Some ships may only differ in colour (colouring need shaders, if your system does not aupport shaders then these ships will look identical).

After 5 minutes you must join the exhibition queue again so that other exhibition visitors can have their turn.


Visitor Levels

Your visit to an exhibition 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 receive messages when you reach the following levels of appreciation: 

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!


Private Exhibition Control equipment

You can order a private exhibition of purchasable ships which will arrive 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 any of them.

You can start and stop all rotation in Private Exhibition by priming (Shift+N) and activating (n) the Private Exhibition Control equipment. To rotate one ship simply target it. Target a rotating ship to stop rotating.

The mode (b) of the primed equipment shows how many ships exists in Private Exhibition.

Some parts of Private Exhibition will be hidden if too many ships causes display problems on your system. If this happens, select the mode (b) key to show the next part.

Private Exhibition will be closed if you dock into another station (you can order a new Private Exhibition there) or you jump into another system. Private Exhibition will remain active 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.

Limitations

Every menu selection redraws the ship model, so shader colours and decals will change by when you select Rotate, Move, etc.

Ship details are 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 is a slow and inaccurate method for Oolite v1.77 which tries to get all ships, but a few ships are randomly left out. This OXP can cause a crash at game start there is if not enough memory (if spinning cobras appear then you have enough memory). You can reduce the $GalleryMaxIt variable in gallery.js to avoid the problem if needed, but more ships 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.$ExhibitionsAllShipsInPrivateExhibition = false; //show NPC ships in Private Exhibition (cheat)
this.$ExhibitionsLog = false; //verbose log
this.$ExhibitionsMaxShipsInLargeExhibitions = 144; //should be square number and min. 64
this.$ExhibitionsMinFPS = 20; //split Private Exhibition 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 4.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

2015.04.25. v1.21 Many small fixes, thanks to QCS.
2014.07.04. v1.20 Fix for seedy space bar and ships with ship script.
2014.07.03. v1.19 Exhibitioins are moved forward to 10km from the player's exit point.
                  Oversized ships in Exhibitions are moved farther from others.
                  Small fix in gallery search.
2014.05.19. v1.18 Fast startup in Oolite 1.79 by the new shipDataForKey.
2014.05.18. v1.17 Back to the previous startup method after a fix in Oolite.
2014.05.18. v1.16 Faster startup in Oolite 1.79 if many OXZs are installed.
2014.01.17. v1.15 Small fix against "Unknown expansion key [Exhibition Guard]" log messages.
2013.12.28. v1.14 Further proofreading by Keeper and Salon renamed to Private Exhibition.
2013.12.15. v1.12 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.


Downloads

Gallery v1.21 (downloaded 9189 times).

Gallery v1.20 (downloaded 2158 times).


Quick Facts

Levelindicator0.png
0-{{{2}}}
Version Released License Features Category Author(s) Feedback
1.21 2015-04-25 CC BY-NC-SA 4 Show installed ships Activities OXPs Norby BB-Link
Retrieved from "http://backup.witchspacewiki.org/index.php?title=Gallery&oldid=47234"