CAOS Language Guide

Macro

Description

These commands return a value into a DDE command window. An application that communicates with Creatures 2 via OLE is needed to view these results.

DDE: GIDS ROOT

Returns a list of all the Family numbers that exist, separated with a space.

Command only

DDE: GIDS FMLY number

Returns a list of all genuses that exist from within a certain family number.

Command only

DDE: GIDS GNUS family number

Returns a list of all species that exist from within a certain family and genus number

Command only

DDE: GIDS SPCS family genus number

Returns a list of all events that exist from within a certain family genus and species number

Command only

DDE: GETB ALLR property

ALL Rooms property value. Returns a particular property for all rooms.

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.

Command only

DDE: GETB RPTY room#

Returns properties of specified room# as a string. Results are in the following order:

Temperature

Pressure

Wind X

Wind Y

Light level

Radiation

Organic Nutrients

Inorganic Nutrients

Command only

DDE: GETB RRCT

Room ReCTangles returns the ID, RECT structure and VISITED flag for every room.

Returns:

ID | top | left | bottom | right | VISITED (0 = NO, 1 = YES ) | Ampersand as room data separator |

Command only

DDE: GETB NEWV

NEWly Visited rooms. Returns a list of room IDs for all rooms visited since the last query.

Command only

DDE: GETB LVOB f g s

Locate Visited Objects. Returns a list of X / Y positions for all the objects matching <f, g, s> that are in rooms that have been visited. After each objects details is an ampersand to allow later expansion if needed.

f-family

g-genus

s-species

Returns:

Xvalue | Yvalue | and |

Command only

DDE: GETB BIOC

Get biochemistry buffer. Returns a string of the target creatures chemical concentrations in the format “123|33|0|…|”. The string contains 256 values – as there is one entry for every chemical slot.

Command only

DDE: GETB ORGN

Get organ buffer. Returns an integer specifying how many organs the target creatures biochemistry contains followed by the data for each organ in the format “1|2|4|55|”. The sequence of organ data is as follows:

Clock Rate (byte)

Clock (byte)

BioTick (unsigned integer)

LifeForce (byte fraction of short term lifeforce)

Initial LifeForce (float)

Short Term LifeForce (float)

Long Term LifeForce (float)

Long Term Rate Of Repair (integer)

Long Term Rate Of Repair Modifier (integer)

Injury To Apply Next Activation (integer)

EnergyCost (integer)

Damage Due To ZeroEnergy (integer)

Receptor Count (integer)

EmitterCount (integer)

ReactionCount (integer).

Command only

DDE: GETB EMTR organ-number

Get Emitter Buffer. Returns an integer specifying how many emitters the Targ creature’s specified organ contains followed by the data for each emitter in the format “1|2|33|”. The sequence of organ data is as follows:

Locus organ identifier (byte)

Locus tissue identifier (byte)

Locus specifier (byte)

Chemical emitted (byte)

Emission threshold (byte)

Emission rate (byte)

Gain (byte)

Effect flags (byte)

Current value of source locus (byte).

Command only

DDE: GETB organ-number

Get Receptor Buffer. Returns an integer specifying how many receptors the Targ creature’s specified organ contains followed by the data for each receptor in the format “1|2|33|”. The sequence of organ data is as follows:

Locus organ identifier (byte)

Locus tissue identifier (byte)

Locus specifier (byte)

Chemical monitored (byte)

Reception threshold (byte)

Gain (byte)

Effect flags (byte)

Current value of destination locus (byte).

Command only

DDE: GETB RCTN organ-number

Get Reaction Buffer. Returns an integer specifying how many reactions the Targ creature’s specified organ contains followed by the data for each reaction in the format “1|2|33|”. The sequence of organ data is as follows:

Proportion of reactant 1 (byte)

Chemical - reactant 1 (byte)

Proportion of reactant 2 (byte)

Chemical – reactant 2 (byte)

Rate of decay (byte)

Proportion of product 1 (byte)

Chemical - product 1 (byte)

Proportion of product 2 (byte)

Chemical – product 2 (byte)

Command only

DDE: PIC2 width height [filename]

PICture. Replaces macro PICT. This takes a snapshot of the currently selected creature of size width and height and saves it in the filename specified. The format of the file is S16. Note that the picture will be clipped by the top and bottom edges of the world and by the viewport. This will result in an image smaller than requested.

Returns a string “1” if successful, “0” if not.

Command only

DDE: SCRP family genus species event

Fetch a script from the scriptorium matching this specifier.

Command only

DDE: PUTV RValue

Display the value of RValue

Command only

DDE: NACT

Neural activity. Returns pipe-delimited numbers. First number is the number of brain lobes, each lobe then has an entry of the format “1|2|3” , where the sequence is in the following order:

Number Of Cells

Cell Flags

Fire Count

Total Output

Total State

Command only

DDE: LNEU flags

Returns info about all firing cells in the brain. All numbers returned by this command are scaled to range from 0 to 63 then added to ascii ‘0’ to keep them in printable range.

Each firing neurone is returned in the following format:

XYS[den0info][den1info]

X and Y is the neurone position, and S is the neurone state.

Den0info and Den1info are only sent depending on the flags field:

flags:

0 = output type 0 dens

1 = output type 1 dens

The dendrite info format begins with a number indicating how many dendrites are feeding the cell, followed by a list of dendrites in the format:

XYS

Where X,Y and S are the position and state of the source neuron.

Command only

DDE: LCUS type organ tissue locusID

Allows interrogation of creature loci values.

type - 0=receptor loci 1=emmiter loci

Details of the other values are listed in the reference section.

Note: organ field does not refer to the organs defined in the genome.

Command only

DDE: PUTS [literal string]

Send a string to the output window.

Command only

DDE: GETB DATA

Gets all creature data in the following format. Each entry is separated with ‘|’

Moniker

Name

Mothers Moniker

Mothers Name

Fathers Moniker

Fathers Name

Birth date

Birth place

Owner Name

Owner Telephone Number

Owner Address

Owner Email

State of Creature – 0=ok, 1=dead, 2=exported

Gender

Age

Command only

DDE: GETB CNAM

Get creature’s name.

Command only

DDE: GETB CTIM

Get the amount of time the creature has been alive.

Command only

DDE: GETB MONK

Get the creatures moniker in the form ‘464f4536’ rather than ‘6EOF’

Command only

DDE: GETB OVVD

Get observation data. This returns the following information, with each field separated with a ‘|’ and each creature seperated with a ‘&’:

Name

Moniker

Sex – 1=male, 2=female

Age – in “hours:mins”

Pregnancy – either “N/A”, “No” or number

Life Force – either number terminated in % or “Dead”

Medical – either “Healthy”, “Sick” or “Dead”

Room – number of room they are in

Xpos

Ypos

Command only

DDE: PUTB [literal string] DATA

Set all the creatures details, see GETB DATA for ordering of details.

Command only

DDE: PUTB [literal string} CNAM

Set the creatures name from the string.

Command only

DDE: NEGG

Update number of natural eggs in the world.

Command only

DDE: PANC

Pan camera to the creature.

Command only

DDE: LOBE

Output locations and information about brain lobes. The first number returned is the number of lobes, and then the information about them is returned in the following format, with the ‘|’ symbol separating fields:

X position start

Y position start

Width

Height

Flags

Number of Dendrites

Dendrite type 0 source

Dendrite type 0 minimum

Dendrite type 0 maximum

Dendrite type 1 source

Dendrite type 1 minimum

Dendrite type 1 maximum

Command only

DDE: GENE

Output the number of genes for the following 14 types:

Brain Lobe

Chemical receptor

Chemical emitter

Chemical reaction

Chemical half life

Chemical starting concentration

Organ

Creature stimulus

Creature genus

Creature appearance

Creature pose

Creature gait

Creature instinct

Creature pigment

Command only

DDE: WORD index

Read a word from the TARG blackboards word list. Sends the response of ‘###|text|’ where ‘###’ is the vocabulary slot for the idea represented by the blackboard picture whose index is index, and ‘text’ is the word it knows for it.

Command only

DDE: CELL lobe cell dentype

Get statistics about this neurone, in the following format:

Output

State

Number of dendrites of that type

Total susceptibility

Total short term weight

Total long term weight

Total strength

The dendrite values are totalled from all dendrites of the given dentype, for a numbered lobe and cell.

Command only

DDE: DIED

Update the number of norns that have died in the world

Command only

DDE: LIVE

Update the number of natural born norns in the world.

Command only

DDE: HATC

Update the number of hatchery norns in the world.

Command only