Difference between revisions of "Oolite JavaScript Reference: ShipGroup"
From Elite Wiki
(Stylistic homogenization.) |
(→leader) |
||
| (3 intermediate revisions by 2 users not shown) | |||
| Line 2: | Line 2: | ||
== Constructor == | == Constructor == | ||
| − | '''new ShipGroup'''() : ShipGroup | + | '''new ShipGroup'''([name : String [, leader : {{oojsclass|Ship}}]]) : ShipGroup |
| − | Creates a new group | + | Creates a new group, optionally specifying the <code>[[#name|name]]</code> and <code>[[#leader|leader]]</code>. |
'''Example:''' | '''Example:''' | ||
| Line 12: | Line 12: | ||
== Properties == | == Properties == | ||
=== <code>count</code> === | === <code>count</code> === | ||
| − | '''count''' : | + | '''count''' : Number (integer, read-only) |
Number of ships in the group, including leader. | Number of ships in the group, including leader. | ||
=== <code>leader</code> === | === <code>leader</code> === | ||
| − | '''leader''' : | + | '''leader''' : Ship (read/write) |
Defines a leader for the group. If the ship is not a member of the group, it is added. | Defines a leader for the group. If the ship is not a member of the group, it is added. | ||
| + | '''Note:''' The player's ship can be set as a group leader, but doing this is not recommended. The lack of JS AIs for the player means that exceptions during script execution and other unpredictable behaviour can be expected and, are in fact, very likely. This is a known issue in versions of the game up to and including 1.84. | ||
=== <code>name</code> === | === <code>name</code> === | ||
| Line 24: | Line 25: | ||
=== <code>ships</code> === | === <code>ships</code> === | ||
| − | '''ships''' : Array | + | '''ships''' : Array ([[Oolite JavaScript Reference: Ship|Ship]]s, read-only) |
Latest revision as of 18:24, 18 July 2016
The ShipGroup class is used to manage groups of ships.
Contents
Constructor
new ShipGroup([name : String [, leader : Ship]]) : ShipGroup
Creates a new group, optionally specifying the name and leader.
Example:
var myGroup = new ShipGroup(); myGroup.name = "My group"; myShip.group = myGroup;
Properties
count
count : Number (integer, read-only)
Number of ships in the group, including leader.
leader
leader : Ship (read/write)
Defines a leader for the group. If the ship is not a member of the group, it is added. Note: The player's ship can be set as a group leader, but doing this is not recommended. The lack of JS AIs for the player means that exceptions during script execution and other unpredictable behaviour can be expected and, are in fact, very likely. This is a known issue in versions of the game up to and including 1.84.
name
name : String (read/write)
Name of the ship group.
ships
ships : Array (Ships, read-only)
Methods
addShip
function addShip(ship : Ship)
Add a ship to the group.
containsShip
function containsShip(ship : Ship) : Boolean
Returns true if ship is a member of the group, false otherwise.
removeShip
function removeShip(ship : Ship)
Remove a ship from the group.
