Introduction

Installation

Configuring Objects

Spacecalls

Events

Coordinates

Tips & Tricks

Portable Space EngineBuilder's Guide

Please send comments to Mark Cooke <mpc@star.sr.bham.ac.uk> or vspace@geocities.com

>Spacecalls: General Console Calls

SpacecallReturn ValueObjectShip
add_timer(Integer first, Integer interval, Integer repeat, String id) X 
This command creates a new timer for the object. The first EV_TIMER event will occur after 'first' seconds, the remainder at 'interval' seconds thereafter. The 'repeat' count can be zero, which specifies that the event will repeat until it is deleted. 'id' is supplied back to the event as the first parameter. The second parameter is the number of times the timer has expired.
contact_list(Boolean show_ships, Boolean show_other) X 
This command causes the contacts meeting the criteria to be emitted to the enactor.
del_timer(String id) X 
This command deletes any timers on the object that have a matching id string. If the 'id' provided is empty, all the timers for the object are deleted.
enable_console(dbref console, Boolean active)  X
This command enables and disables the specified console by setting or clearing the ACTIVE flag on the console. Consoles without the active flag set are not sent any PSE generated messages. However, softcoded commands can still be issued from the console, and the space designer will need to bear this in mind.
godspecs() X 
This command causes the space object specifications, including object and ship flags as appropriate to be emitted to the enactor.
max_warp(Integer cost)Float warp  X
This function returns the maximum warp speed that can be achieved by the ship for the given amount of energy. Account is taken of the POKEY and SPEEDY flags, and the returned value is never more than the maximum speed permitted for the ship.
report_contact(Integer contact) X 
This command causes the specified contact information to be emitted to the enactor. It is a selective form of the contact_list command.
short_contact_list(Boolean show_ships, Boolean show_other) X 
This command causes the contacts meeting the criteria to be emitted to the enactor in a shorter format than the contact_list spacecall.
specs() X 
This command causes the space object specifications, excluding object and ship flags to be emitted to the enactor.
warp_cost(Float warp)Integer cost  X
This function returns the amount of energy required by the ship to achieve the specified speed. It accounts for the SPEEDY and POKEY flags being set, but does allow speeds greater than the maximum to be speficied.
warp_table()  X
This command causes a table of warp speeds between warp 1 and warp 10 to be emitted to the enactor, along with the energy requirements for each speed.


Last modified: 15th March 1998