AFX

More...

Classes:

class

A datablock that specifies an Animation Clip effect.

class

A datablock that specifies an Animation Lock effect.

class

A datablock that specifies an Area Damage effect.

class

A datablock that specifies an Audio Bank effect.

class

A Billboard effect as defined by an afxBillboardData datablock.

class

A datablock that specifies a Billboard effect.

class

A 3rd person camera object.

class

A datablock that describes an afxCamera.

class

A datablock that specifies a Camera Puppet effect.

class

A datablock that specifies a Camera Shake effect.

class

Base class used by choreographers.

class

Datablock base class used by choreographers.

class

A datablock that specifies a Collision Event effect.

class

A datablock that specifies a Console Message effect.

class

A datablock that specifies a Damage effect.

class
class

A datablock that describes an Effect Group.

class

A basic effects choreographer.

class

Defines the properties of an afxEffectron.

class

An Effect Wrapper as defined by an afxEffectWrapperData datablock.

class

A datablock that describes an Effect Wrapper.

class

A simple but useful GUI control that propagates all events to its parent control.

class

A datablock for specifiying AFX drag forces.

class

A datablock for specifiying AFX gravity forces.

class

A datablock that specifies a Foot Switch effect.

class

A datablock that specifies a Gui Controller effect.

class

A customized variation of GuiInspectorField.

class

A datablock that specifies a Gui Text effect.

class

afxLightData is a legacy datablock which is not supported for T3D.

class

A datablock that specifies a Machine Gun effect.

class

Magic-missile class used internally by afxMagicSpell. Properties of individual missile types are defined using afxMagicMissileData.

class

Defines a particular magic-missile type. (Use with afxMagicSpellData.)

class

A magic spell effects choreographer.

class

Defines the properties of an afxMagicSpell.

class

A Model effect as defined by an afxModelData datablock.

class

A datablock that specifies a Model effect.

class

A Mooring effect as defined by an afxMooringData datablock.

class

A datablock that specifies a Mooring effect.

class

afxMultiLightData is a legacy datablock which is not supported for T3D.

class

An AFX customized particle emitter that emits particles within a cone shape.

class

A base datablock inherited by AFX Particle Emitter effects.

class

An AFX customized particle emitter that emits particles within a disc shape.

class

An AFX customized particle emitter that emits particles along a path.

class

An AFX customized particle emitter that emits particles along a 3D vector.

class

A ParticlePool object as defined by an afxParticlePoolData datablock.

class

A ParticlePool datablock.

class

A datablock for specifiying a 3D path for use with AFX.

class

A datablock that specifies a Phrase Effect, a grouping of other effects.

class

A datablock that specifies a PhysicalZone effect.

class

A datablock that specifies a Player Movement effect.

class

A datablock that specifies a Player Puppet effect.

class

A Projectile effect as defined by an afxProjectileData datablock.

class

A datablock that specifies a Projectile effect.

class

A class that manages certain AFX effects that can persist for long durations.

class

A datablock for defining RPG aspects of a spell.

class

A datablock that specifies a Script Event effect.

class

A choreographer for selection effects.

class

Defines the properties of an afxSelectronData.

class

A spellbook object.

class

A spellbook datablock.

class

A GUI button with some special features that are useful for casting AFX spells.

class

A GUI progress bar useful as a spell casting bar.

class

A StaticShape effect as defined by an afxStaticShapeData datablock.

class

A datablock that specifies a StaticShape effect.

class

A GUI status bar for tracking and displaying health and energy of ShapeBase objects.

class

A simple GUI control used to contain player status bars and a label.

class

A simple GUI control used for a player status label.

class

A datablock that specifies a dynamic Point Light effect.

class

A datablock that specifies a dynamic Spot Light effect.

class

A customized variation of GameTSCtrl.

class

afxVolumeLightData is a legacy datablock which is not supported for T3D.

class

An xmod datablock.

class

An xmod datablock.

class

An xmod datablock.

class

An xmod datablock.

class

An xmod datablock.

class

An xmod datablock.

class

An xmod datablock.

class

An xmod datablock.

class

An xmod datablock.

class

An xmod datablock.

class

An xmod datablock.

class

An xmod datablock.

class
class

An xmod datablock.

class

An xmod datablock.

class

An xmod datablock.

class

An xmod datablock.

class

An xmod datablock.

class

An xmod datablock.

class

An xmod datablock.

class

An xmod datablock.

class

An xmod datablock.

class

An xmod datablock.

class

An xmod datablock.

class

An xmod datablock.

class

An xmod datablock.

class

An xmod datablock.

class

A datablock that specifies a decal-like Zodiac effect.

class

A render bin for zodiac rendering on GroundPlane objects.

class

A render bin for zodiac rendering on MeshRoad objects.

class

A ZodiacPlane effect as defined by an afxZodiacPlaneData datablock.

class

A datablock that specifies a Zodiac Plane effect.

class

A render bin for zodiac rendering on polysoup TSStatic objects.

class

A render bin for zodiac rendering on Terrain objects.

class

Allows legacy AudioDescription datablocks to be treated as SFXDescription datablocks.

class

Allows legacy AudioProfile datablocks to be treated as SFXProfile datablocks.

class

Allows legacy sgLightObjectData datablocks to appear in scripts.

Functions

void

Activates an effectron that was started with postponeActivation=true.

void

Activates a magic spell that was started with postponeActivation=true.

string
string
int
castSpell(afxMagicSpellData datablock, ShapeBase caster, SceneObject target, SimObject extra)

Instantiates the magic spell defined by datablock and cast by caster.

void

Clear out any ShapeBase-derived object associated with the status-bar.

string
ColorScale(LinearColorF color, float scalar)

Returns color scaled by scalar (color*scalar).

string
echoThru(string passthru, string text...)

Like echo(), but first argument is returned.

string
errorThru(string passthru, string text...)

Like error(), but first argument is returned.

int

Get the capacity (total number of spell slots) in a spellbook.

int

Returns ID of the spell's caster object.

string
getColorFromHSV(float hue, float sat, float val, float alpha)

Coverts an HSV formatted color into an RBG color.

Point3F

Returns the current location of the free target.

int

Returns the ghost-index for an object.

int

Returns ID of impacted-object for the spell.

float
getMaxF(float a, float b)

Returns the greater of the two arguments.

float
getMinF(float a, float b)

Returns the lesser of the two arguments.

int

Returns ID of the spell's magic-missile object.

Point3F

Get the 3D position of the mouse cursor.

Point3F

Get the 3D direction vector for the mouse cursor.

int
getPageSlotIndex(Point2I bookSlot)

...

int
getPageSlotIndex(Point2I bookSlot)

...

Point3F
getRandomDir(Point3F axis, float thetaMin, float thetaMax, float phiMin, float phiMax)

Get a random direction vector.

float
getRandomF(float a, float b)

Get a random float number between a and b.

float

Returns the velocity of a scene-object.

int
getSpellData(Point2I bookSlot)

Get spell datablock for spell stored at spellbook index, (page, slot).

int
getSpellRPGData(Point2I bookSlot)

Get spell RPG datablock for spell stored at spellbook index, (page, slot).

int

Returns ID of the spell's target object.

int

Get the current targeting-mode.

void

Interrupts and deletes a running effectron.

void

Interrupts and deletes a running magic spell.

void

Interrupts and deletes a running selectron.

void

Interrupts the current stage of a magic spell causing it to move onto the next one.

void

Called before a series of datablocks are reloaded to help distinguish reloaded datablocks from already loaded ones.

Point3F
MatrixInverseMulVector(MatrixF xfrm, Point3F vector)

Multiply the vector by the affine inverse of the transform.

MatrixF
moveTransformAbs(MatrixF xfrm, Point3F pos)

Move the transform to the new absolute position.

MatrixF
moveTransformRel(MatrixF xfrm, Point3F pos)

Move the transform to the new relative position.

void

Pop the targeting-mode off a statck of modes.

void

Adds an effect (wrapper or group) to a spell's casting phase.

void

Adds an effect (wrapper or group) to a spell's delivery phase.

void

Adds an effect (wrapper or group) to an effect-group.

void

Adds an effect (wrapper or group) to an effectron's phase.

void

Adds an effect (wrapper or group) to a spell's impact phase.

void

Adds an effect (wrapper or group) to a spell's launch phase.

void

Adds an effect (wrapper or group) to a spell's linger phase.

void
pushTargetingMode(uint mode, uint checkMethod)

Push a new targeting-mode onto a statck of modes.

void

Resets an effect-group datablock during reload.

void

Resets an effectron datablock during reload.

void

Resets a spell datablock during reload.

void

Resets a selectron datablock during reload.

int
ResolveGhost(int ghostIndex)

Resolves a ghost-index into an object ID.

int
rolloverRayCast(Point3F start, Point3F end, uint mask)

Performs a raycast from points start to end and returns the ID of nearest intersecting object with a type found in the specified mask. Returns -1 if no object is found.

void
setProgress(float percentDone)

Set the progress percentage on the progress-bar.

void
setProgress(float percentDone)

Set the progress percentage on the status-bar.

void

Associate a ShapeBase-derived object with the status-bar.

void

Associate a spellbook with an afxTSCtrl.

void
setStartingVelocity(float velocity)

Set the starting velocity for a magic-missile.

void
setStartingVelocityVector(Point3F velocityVec)

Set the starting velocity-vector for a magic-missile.

void
setTimeFactor(F32 factor)

or (string phase, F32 factor)Sets the time-factor for the spell, either overall or for a specific phrase.

void
setTimeFactor(float factor)

Sets the time-factor for the effectron.

void
setTimeFactor(float factor)

Sets the time factor of the selectron.

int
startEffectron(afxEffectronData datablock, string constraintSource, string constraintName, SimObject extra)

Instantiates the effectron defined by datablock.

int
startSelectron(SceneObject selectedObj, unsigned int subcode, SimObject extra)

Instantiates a selectron.

void

Stops and deletes a running selectron.

void

Called after a series of datablocks are reloaded to trigger some important actions on the reloaded datablocks.

string
warnThru(string passthru, string text...)

Like warn(), but first argument is returned.

bool

Returns true if script compiler had a syntax error. Useful for detecting syntax errors after reloading a script.

Detailed Description

Functions

activate()

Activates an effectron that was started with postponeActivation=true.

activate()

Activates a magic spell that was started with postponeActivation=true.

afxEndMissionNotify()

...

afxGetEngine()

...

afxGetVersion()

...

castSpell(afxMagicSpellData datablock, ShapeBase caster, SceneObject target, SimObject extra)

Instantiates the magic spell defined by datablock and cast by caster.

clearShape()

Clear out any ShapeBase-derived object associated with the status-bar.

ColorScale(LinearColorF color, float scalar)

Returns color scaled by scalar (color*scalar).

Parameters:

color

The color to be scaled.

scalar

The amount to scale the color.

echoThru(string passthru, string text...)

Like echo(), but first argument is returned.

errorThru(string passthru, string text...)

Like error(), but first argument is returned.

getCapacity()

Get the capacity (total number of spell slots) in a spellbook.

getCaster()

Returns ID of the spell's caster object.

getColorFromHSV(float hue, float sat, float val, float alpha)

Coverts an HSV formatted color into an RBG color.

Parameters:

hue

The hue of the color (0-360).

sat

The saturation of the color (0-1).

val

The value of the color (0-1).

alpha

The alpha of the color (0-1).

getFreeTargetPosition()

Returns the current location of the free target.

GetGhostIndex(NetObject obj)

Returns the ghost-index for an object.

getImpactedObject()

Returns ID of impacted-object for the spell.

getMaxF(float a, float b)

Returns the greater of the two arguments.

getMinF(float a, float b)

Returns the lesser of the two arguments.

getMissile()

Returns ID of the spell's magic-missile object.

getMouse3DPos()

Get the 3D position of the mouse cursor.

getMouse3DVec()

Get the 3D direction vector for the mouse cursor.

getPageSlotIndex(Point2I bookSlot)

...

getPageSlotIndex(Point2I bookSlot)

...

getRandomDir(Point3F axis, float thetaMin, float thetaMax, float phiMin, float phiMax)

Get a random direction vector.

getRandomF(float a, float b)

Get a random float number between a and b.

getSpeed()

Returns the velocity of a scene-object.

getSpellData(Point2I bookSlot)

Get spell datablock for spell stored at spellbook index, (page, slot).

getSpellRPGData(Point2I bookSlot)

Get spell RPG datablock for spell stored at spellbook index, (page, slot).

getTarget()

Returns ID of the spell's target object.

getTargetingMode()

Get the current targeting-mode.

interrupt()

Interrupts and deletes a running effectron.

interrupt()

Interrupts and deletes a running magic spell.

interrupt()

Interrupts and deletes a running selectron.

interruptStage()

Interrupts the current stage of a magic spell causing it to move onto the next one.

markDataBlocks()

Called before a series of datablocks are reloaded to help distinguish reloaded datablocks from already loaded ones.

MatrixInverseMulVector(MatrixF xfrm, Point3F vector)

Multiply the vector by the affine inverse of the transform.

moveTransformAbs(MatrixF xfrm, Point3F pos)

Move the transform to the new absolute position.

moveTransformRel(MatrixF xfrm, Point3F pos)

Move the transform to the new relative position.

popTargetingMode()

Pop the targeting-mode off a statck of modes.

pushCastingEffect(afxEffectBaseData effect)

Adds an effect (wrapper or group) to a spell's casting phase.

pushDeliveryEffect(afxEffectBaseData effect)

Adds an effect (wrapper or group) to a spell's delivery phase.

pushEffect(afxEffectBaseData effect)

Adds an effect (wrapper or group) to an effect-group.

pushEffect(afxEffectBaseData effect)

Adds an effect (wrapper or group) to an effectron's phase.

pushImpactEffect(afxEffectBaseData effect)

Adds an effect (wrapper or group) to a spell's impact phase.

pushLaunchEffect(afxEffectBaseData effect)

Adds an effect (wrapper or group) to a spell's launch phase.

pushLingerEffect(afxEffectBaseData effect)

Adds an effect (wrapper or group) to a spell's linger phase.

pushTargetingMode(uint mode, uint checkMethod)

Push a new targeting-mode onto a statck of modes.

reset()

Resets an effect-group datablock during reload.

reset()

Resets an effectron datablock during reload.

reset()

Resets a spell datablock during reload.

reset()

Resets a selectron datablock during reload.

ResolveGhost(int ghostIndex)

Resolves a ghost-index into an object ID.

rolloverRayCast(Point3F start, Point3F end, uint mask)

Performs a raycast from points start to end and returns the ID of nearest intersecting object with a type found in the specified mask. Returns -1 if no object is found.

setProgress(float percentDone)

Set the progress percentage on the progress-bar.

setProgress(float percentDone)

Set the progress percentage on the status-bar.

setShape(ShapeBase shape)

Associate a ShapeBase-derived object with the status-bar.

setSpellBook(afxSpellBook spellbook)

Associate a spellbook with an afxTSCtrl.

setStartingVelocity(float velocity)

Set the starting velocity for a magic-missile.

setStartingVelocityVector(Point3F velocityVec)

Set the starting velocity-vector for a magic-missile.

setTimeFactor(F32 factor)

or (string phase, F32 factor)Sets the time-factor for the spell, either overall or for a specific phrase.

setTimeFactor(float factor)

Sets the time-factor for the effectron.

setTimeFactor(float factor)

Sets the time factor of the selectron.

startAllSpellCooldown()

...

startEffectron(afxEffectronData datablock, string constraintSource, string constraintName, SimObject extra)

Instantiates the effectron defined by datablock.

startSelectron(SceneObject selectedObj, unsigned int subcode, SimObject extra)

Instantiates a selectron.

stopSelectron()

Stops and deletes a running selectron.

touchDataBlocks()

Called after a series of datablocks are reloaded to trigger some important actions on the reloaded datablocks.

warnThru(string passthru, string text...)

Like warn(), but first argument is returned.

wasSyntaxError()

Returns true if script compiler had a syntax error. Useful for detecting syntax errors after reloading a script.