Library OXP

This page is about the OXP helper expansion pack, Library, for other uses, see Library (disambiguation).

Animator

PAD: GalCop

PAD: Persons

PAD: Player data

Starmap

Overview

Reinventing the wheel is not everybody's taste, so here comes a collection of useful snippets and helpers. Its main purpose is to simplify or unify some common tasks used by OXPers. Library is the successor to CCL, Hyperradio and OXPConfig. The library does not alter any native JS objects (like Array or String) to avoid clashes and does not clutter the global namespace.

This oxp also adds the following items to the F4 ship-station interface page

Config for AddOns (AddOns category) - for tweaking OXPs (see BGS for an example).
PAD (Captain's Log category) - a personal assistance device with details of naval career, people met, etc.

The P.A.D. (or Personal Assistance Device) ships functionality to display different sorts of data, sorted by categories. Every category may contain several pages (or subcategories) - which can also be implemented by AddOns. Currently there are categories for

GALCOP: A standard entry, but after doing specific jobs it will contain an entry for the Navy as well. Other AddOns may add more.

GUILDS: An empty entry at the moment. Could be used e.g. by RandomHits, Feudal States and other AddOns which do have a membership.

INFOS: A category for special events, news, etc. Could be useful e.g. for BloombergMarkets, etc.

LOGBOOK: A category for standard events like rescued escape pods, bailed out, fined, etc. Could be used for contracts as well.

PERSONS: A category for characters you have met.

SYSTEMS: A category for special systems like Tianve, Tionisla, etc.

SEARCH

PLAYER DATA

The PAD also ships with search functionality and some categories do allow the player to add custom notes. The display of these pages is based on templates, so all pages in a category will have the same layout. AddOns can add data easily to existing pages or add a new page in existing categories. Another feature is to set player specific data, like origin, species, gender, age and a custom picture.

Note: there are currently several oxp's that allow for configuring other oxp's:
*Library (the most recent, done via the F4 page when docked) by Svengali
*OXPConfig (done via the F2 page - press F7 when told to) by Svengali
*Station Options by cag: this one is comprehensible, but alas, only a beta version (2018)

Features

For Documentation just follow the links.

Lib_2DCollision.js - Methods for checking if point is in bounding-box, on line or in poly.
Lib_Animator.js - Tool to create animations on missionscreens (see Demos).
Lib_BinSearch.js - Instantiated search tree.
Lib_Config.js - Configuration interface for AddOns.
Lib_Crypt.js - De-/Encryption for strings.
Lib_GUI.js - Unified GUI image, sound and music handling.
Lib_Main.js - Generic functions for various tasks.
Lib_Music.js - Unified event driven and generic music handling (see Demos).
Lib_PAD.js - Unified logbook, mission-log, diary and interface. Added in v1.7
Lib_Starmap.js - In-System-Maps in 3D (docked and inflight) (see Demos). Added in v1.7

ID

identifier = "oolite.oxp.Svengali.Library";

Requirements

Latest version needs Oolite v1.88.

Download

Install like any other OXP.

Library 1.7.1 (oxz, 4.9 MiB)

Music

Music for playing the game to (these three need Library to function):

Lib Music Orchestral Demo: Svengali's original music .oxp (2016: 22Mb)
Contextual Jukebox OXP by Arquebus of YouTube fame (2021: 115Mb)
Dangerous Background Music OXP: Tsoj's DIY kit! (2021)

Demos

Install like any other OXP.

Animator Demo (zip, 2.8 MiB)
Starmap Demo (oxz, 2.4 KB) - see explanation

Tools

There are two tools tucked away in diverse locations:

Lib_MatFinder 1.1 (oxz, 39.7 KB) - A developer-tool to work out materials entries.

See here for description re shaders etc. (2 pages, 2018).

On your F4 screen (if you have Library running too) under "Developer":

Library_devtools.oxp (look in Test OXP's) - Something peculiar

On starting a game (if you have Library running too):

On your F4 screen (if you have Library running too) under "Lib_MatEditor":

Keeper's alternative images

Alternatives

Keeper produced his own set of tailored images & sounds for Library.

"The screens have a bit of the "legend" icons showing the relative order of government and economy types, as well as a function key menu with English labels (the old menu from the previous BGS set but with text added by myself -- now blended over the new backgrounds nicely). Here's a 16:10 screenshot: http://www.keeper1st.com/Oolite/bgsexample.png

For the sounds, I replaced the "Item Sold" and "Item Bort" (?!) with nice little chimes (can't remember where they came from -- original Oolite?), changed things like "Ortopilot activated" into "Autopilot activated", trimmed some dead air (e.g. so instead of "missile......armed" it's "missile armed"), removed all instances of Majel Barrett from Star Trek (nothing against the late Ms Barrett or Star Trek; I just think the second voice is unnecessary), and greatly changed the extremely long and drawn-out game-over sound into a rather rapid explosion then sudden expulsion of air into silence, which is rather more shocking and realistic."