|
|
Line 73: |
Line 73: |
| A description of each field is available. | | A description of each field is available. |
| </p> | | </p> |
− |
| |
− |
| |
− | <hr>
| |
− | <h2>The field types</h2>
| |
− |
| |
− | <h4>What's a field?</h4>
| |
− |
| |
− | <p>Countrary to the other types, the entity type
| |
− | is a reference to an instance of a structured object, that contains
| |
− | many informations of totally different kinds.</p>
| |
− |
| |
− | <p>To access all these informations conveniently, they are stored as
| |
− | fields of the entity object, and each field is given a name and a type,
| |
− | that makes it distinct of the others.</p>
| |
− |
| |
− | <p>Some of the fields do not store value, but instead they store the
| |
− | function to be executed in certain conditions. They are called the
| |
− | <b>methods</b> that can be aplied to the object.</p>
| |
− |
| |
− | <p>If [[Quake-C]] was an object oriented programming language, those method
| |
− | functions and would be distinguished from the other fields. And, above
| |
− | all, you would be able to create new object types, with their own fields.</p>
| |
− |
| |
− | <p>As Quake-C stands currently, <b>all the field definitions</b> are
| |
− | definitions of entity fields. So anywhere in your code you could add
| |
− | definition of new fields, and the compiler would interpret them
| |
− | as an extension of the entity definition.</p>
| |
− |
| |
− | <h4>Creating new fields</h4>
| |
− |
| |
− | <p>The only way to extend the entity type
| |
− | is to add some fields at the end of the structures.</p>
| |
− |
| |
− | <p>This is done via a field definitions, whose general structure is:
| |
− | <pre>
| |
− | .type field_name;
| |
− | </pre>
| |
− | </p>
| |
− |
| |
− | <p> For instance, if you wanted to add a sling to the game, and needed
| |
− | to store the count of pellets for every player, you would add
| |
− | the following line in the source code:
| |
− | <pre>
| |
− | .float ammo_sling;
| |
− | </pre>
| |
− | That will add a fields <b>ammo_sling</b> to every entity in the game,
| |
− | and in particular to the player entities.
| |
− | </p>
| |
− |
| |
− | <p>Here are all the possible definitions of entity fields, with their types:
| |
− | <pre>
| |
− | .float field_name;
| |
− | .string field_name;
| |
− | .vector field_name;
| |
− | .entity field_name;
| |
− | </pre>
| |
− | </p>
| |
− |
| |
− | <p>The strange bit is that you can add those type definitions almost
| |
− | anywhere in the source code. They are not supposed to be grouped in
| |
− | a single place, where the entity type would be defined.
| |
− | </p>
| |
− |
| |
− | <h4>Allowed modifications of types</h4>
| |
− |
| |
− | <p>In the first file read by the Quake-C compiler, <b>[[defs.qc]]</b>,
| |
− | there must be a definition for the entity fields, and world fields.
| |
− | This definition is hard coded. You had better not touch it,
| |
− | or you will have to recompile Quake itself.</p>
| |
− |
| |
− | <p>The globals are defined before the special definition
| |
− | <b>[[void end_sys_globals;]]</b><br>
| |
− |
| |
− | The entity fields are defined before the special
| |
− | definition <b>[[void end_sys_fields;]]</b></p>
| |
− |
| |
− | <p>It's not important if you don't understand the nonsense
| |
− | above. It's an ugly hack. Just <b>don't modify defs.qc</b>
| |
− | before those two tags, and you won't be in trouble.</p>
| |
− | <hr>
| |
Revision as of 16:11, 8 May 2008
The Quake-C Basic Types
The simple Types
An empty result, mostly used for definition of procedures (i.e. functions
that return no result at all).
A floating point value.
Floats are also used to store booleans (TRUE, FALSE) or integer values
link counters, or bit flags.
Valid syntax: 12 1.6 0.5 -100
Invalid syntax: .5 -.50 .690
A parsing ambiguity is present with negative constants. "a-5" will be parsed
as "a", then "-5", causing an error. Separate the - from the digits with a
space "a - 5" to get the proper behavior.
A vector, made of 3 float coordinates.
Used to represent positions or directions in 3D space.
Valid syntax: '0 0 0' or '20.5 -10 0.00001'
Note the simple quotes around the vector. Do not use
double quotes, they are reserved for strings.
If you declare a vector foobar, then you can
access it's x, y and z fields with: foobar_x,
foobar_y,foobar_z.
This is used to store character string.
Used to indicate file names, or messages to be broadcast to players.
Valid syntax: "maps/jrwiz1.bsp" or "ouch!\
"
Use \
for newline.
Note: that character strings cannot be modified, or concatenated.
Because they are stored at fixed locations in memory, and if
would be postentially troublesome to allow modification.
entity type
The reference of an entity in the game, like things, players, monsters.
For instance, this is the type of the entities self
and other.
The entity type is a structured type, made of fields.
A description of each field is available.