Difference between revisions of "Gallery"

From Elite Wiki
(v0.8)
(v1.21)
 
(19 intermediate revisions by the same user not shown)
Line 1: Line 1:
−
[[File:Gallery1.png|360px|thumb|right|Gallery in Interfaces]]
 +
[[File:Gallery2.png|350px|thumb|right|Select starting object]]
−
[[File:Gallery2.png|360px|thumb|right|Select starting object]]
 +
[[File:Gallery4.png|350px|thumb|right|Details, rotate and zoom]]
−
[[File:Gallery4.png|360px|thumb|right|Details, rotate and zoom]]
 +
[[File:Gallery3.png|350px|thumb|right|Hidden menu]]
−
[[File:Gallery3.png|360px|thumb|right|Hidden Menu]]
 +
[[File:Gallery5.png|350px|thumb|right|Search in Gallery]]
−
[[File:Gallery5.png|360px|thumb|right|Search in Gallery]]
 +
[[File:Gallery8.png|350px|thumb|right|Exhibitions Menu]]
  +
[[File:Gallery10.png|350px|thumb|right|Pirate Meetings]]
  +
[[File:Gallery11.png|350px|thumb|right|Order a private exhibition]]
  +
[[File:Gallery7.png|350px|thumb|right|Private Exhibition in Oolite v1.79]]
  +
[[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/0i5sf8n4m1e3pqoekcz0 here] or [https://www.box.com/s/t7vnj3kfinbpc7m1twy3 here].
  
  +
Show encountered ships and other space objects in Interfaces (F4).
   
−
=== Description ===
  
  +
Extend your gallery by flying around and targeting or fighting with ships and other space objects.
   
−
Show encountered ship and object types in Interfaces.
  
  +
If you are a new pilot then you will only see purchasable ships from the station shipyards.
−
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 buyable versions only.
  
  +
Press F4 when you are docked, then choose "Gallery of encounters" to see ship statistics and rotating models.
   
−
Press F4 when you docked, 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.
   
−
You will see your ship and how many objects you gathered at the moment. You can select from a list which one will be shown firstly (the first one of each initials listed here only to always fit into the screen).
  
  +
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 31: Line 31:
 
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.
  +
  +
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
   
−
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.
  
   
   
Line 45: Line 44:
   
 
=== 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 57: Line 56:
   
 
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 75: Line 74:
 
this.$GalleryRoles = ["all", "player", ... ]; //main roles, you can add more
  
this.$GalleryRoles = ["all", "player", ... ]; //main roles, you can add more
 
this.$GallerySpeed = 2; //move and zoom speed
  
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 ===
  
=== 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 86: Line 94:
   
 
=== Changelog ===
  
=== 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 [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.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|NPC shields]] OXP and [http://aegidian.org/bb/viewtopic.php?f=4&t=12507 CustomShields] OXP.
  
2013.11.26. v0.8 Show shields from [[NPC-shields_OXP|NPC shields]] OXP and [http://aegidian.org/bb/viewtopic.php?f=4&t=12507 CustomShields] OXP.
 
Fixed empty and duplicated names.
  
Fixed empty and duplicated names.
Line 98: Line 121:
   
   
−
Download Gallery OXP from [https://app.box.com/s/0i5sf8n4m1e3pqoekcz0 here] or [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 = 0.8
 +
|version = 1.21
−
|release = 2013-11-26
 +
|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 = Misc 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"