CAOS Language Guide

Macro

Description

These commands are used to set/return details about the room system. This includes both the physical arrangements of rooms and also operations on the attributes of the room that TARG is in.

TEMP

Sets/returns the temperature at targ.

RValue and LValue

LITE

Sets/returns the Light Level at targ.

RValue and LValue

RADN

Sets/returns the Radiation at targ.

RValue and LValue

ONTR

Sets/returns the Organic nutrients at targ.

RValue and LValue

INTR

Sets/returns the Inorganic nutrients at targ.

RValue and LValue

PRES

Sets/returns the Pressure in room at object.

RValue and LValue

WNDX

Sets/returns the wind X component at targ.

RValue only.

WNDY

Sets/returns the wind Y component at targ.

RValue only.

HSRC

Sets/returns the Heat source in room at targ.

RValue and LValue.

PSRC

Sets/returns the Pressure source in room at targ.

RValue and LValue.

LSRC

Sets/returns the Light source in room at targ.

RValue and LValue.

RSRC

Sets/returns the Radiation source in room at targ.

RValue and LValue.

RMNO

Room Number. Return the room number of the current room of Targ.

RValue only

RTYP

Room Type. Sets/returns the type of the room at the centre point of Targ.

Returns:

-1 Invalid.

0 Under the Albian surface.

1 On the Albian surface.

2 In the sea.

3 In the sky.

RValue and LValue

RMN# room edge

Room Neighbour count. Number of neighbours a room has on a given edge.

Room = room number.

edge: 0 = left, 1 = right, 2 = up, 3 = down.

RValue only

RMND room direction door

Room Neighbour door Door-open value.

room = room number.

direction: 0 = left, 1 = right, 2 = up, 3 = down.

door = number of door required. E.g. 1 for 1^st, 2 for 2^nd, etc.

RValue and LValue

RMNR room direction door

Room Neighbour door Destination room ID.

room = room number.

direction: 0 = left, 1 = right, 2 = up, 3 = down.

neighbour = number of door required. E.g. 1 for 1^st, 2 for 2^nd, etc.

RValue and LValue

ROOM room property

ROOM property values.

room: room ID.

property:

0 = left, 1 = top, 2 = right, 3 = bottom, 4 = type, 5 = floor value,

6 = organic nutrient, 7 = inorganic nutrient,

8 = temperature, 9 = pressure, 10 = wind x component, 11 = wind y component, 12 = light level, 13 = radiation, 14 = heat source, 15 = pressure source, 16 = light source, 17 = radiation source, 18 = visited flag, 19 = drop status

RValue only

ROOM room p0 p1 … pn

ROOM property values.

room: room ID.

p0 = left, p1 = top, p2 = right, p3 = down, p4 = type, p5 = floor value, p6 = organic nutrient, p7 = inorganic nutrient,

p8 = temperature, p9 = pressure, p10 = light level, p11 = radiation, p12 = heat source, p13 = pressure source, p14 = light source, p15 = radiation source, p16 – drop status..

Command only

DELR room

Delete Room. Remove the room from the map.

room: room ID.

Command only

DELN room direction

Delete Neighbour doors. Removes all neighbours for a room. Does not actually delete the rooms, just the relationship between room and the neighbours.

room: room ID.

direction: 0 = left, 1 = right, 2 = up, 3 = down.

Command only

DOOR direction RoomID1 RoomID2

DOOR open value. Gets/sets the door open value between the given rooms.

RValue and LValue

WLDW

World Width, in pixels.

RValue only

WLDH

World Height, in pixels.

RValue only

TECO

Toggle Ecosystem on and off. Switches the room system update mechanism on or off. Default: on.

Command only

OBST direction

Obstacle..

Searches the room from the centre point of TARG for a floor or room door that presents an obstacle to the agent assuming it is moving in the given direction. The value returned is the distance to this obstacle. This macro command takes into consideration the SIZE of the agent, the floor value of the room and appropriate door values. If no obstacle is presented to the agent then a very large number is returned.

direction: 0 = left, 1 = right, 2 = up, 3 = down.

RValue only

OBDT direction

Obstacle Distance. Returns the distance to any obstacle in the given direction regardless of SIZE, floor value or door values.

Direction: 0 = left, 1 = right, 2 = up, 3 = down.

RValue only

OBSV direction

Obstacle Value. Returns the value of the door for the first obstacle in the given direction.

Direction: 0 = left, 1 = right, 2 = up, 3 = down.

RValue only

FLOR

Floor. Returns the y co-ordinate of the floor at the centre x position of Targ.

RValue only

RMS#

Returns the number of rooms defined in the world.

RValue only

GRND x

Returns the ground level of the first surface room at x position in the world.

Ground, in this case, is just the bottom of the first surface room and doesn't take into account uneven floors or door values of adjoining rooms.

RValue only

ISAR room#

Returns whether the given room number exists, returns 1 if true 0 if false.

room# - the number of the room to check

RValue only