Location(object, vector, float)

Set the value of a Location data structure

location Location(
    object oArea,
    vector vPosition,
    float fOrientation
);

Parameters

oArea

An Area within the game module

vPosition

An object specifying an xyz coordinate

fOrientation

An angular value between 0.0 and 360.0

Description

A constructor is a special type of function whose purpose is to create a new instance of its type. A constructor is also where any special construction actions or initialization takes place. Its return type is a new object of the specified type, so in this case what we get back is a new object of type location.
In order to construct a new location object the script needs three things:
The area the location is referenced in (This is the Area of the Module)
A new vector containing the x, y and z coordinates of this location
A float representing the facing of the object from 0.0 to 360.0 where 0.0 = East, 90.0 = North, 180.0 = West, and 270.0 = South.

Remarks

Object creation is often one of the most expensive operations, in terms of CPU usage, that can be performed. The rule of thumb is “Create as many objects as you need, but no more”.

Version

1.62

Example

//Locate the area we are in
object oArea = GetArea(OBJECT_SELF);
//Locate where in the are we are
vector vPosition = GetPosition(OBJECT_SELF);
//Identify the direction we are facing
float fOrientation = GetFacing(OBJECT_SELF);
//Create a new location with this information
location myLocation = Location( oArea, vPosition, fOrientation);