Maintenance script: Upload from wiki

2020-07-09T13:46:44Z

Upload from wiki

New page

== helper_areas.hps ==
Helper functions to handle area objects
----

===== Area_MoveLinearTo =====
<syntaxhighlight lang="c++">
void Area_MoveLinearTo(const tString &in asName,
const tString &in asTargetEntity,
float afAcceleration,
float afMaxSpeed,
float afSlowDownDist=0.0f,
bool abResetSpeed=true,
const tString &in asCallback="")
</syntaxhighlight>
Moves the specified area to the current position of the target entity. !Does not work on Liquid Areas, instead use LiquidArea_MoveLinearTo!
* '''asName''': name of the area to move, wildcard(s) * are supported.
* '''asTargetEntity''': name of the entity to move the area to.
* '''afAcceleration''': acceleration .in m/s^2
* '''afMaxSpeed''': the maximum speed of movement.
* '''afSlowDownDist''': the distance at which movement slows down.
* '''abResetSpeed''': if all static movement for the area should be stopped before starting this movement.
* '''asCallback''': callback when movement is done: void asCallback(const tString& in asAreaName)

----

===== Area_PlaceAtEntity =====
<syntaxhighlight lang="c++">
void Area_PlaceAtEntity(const tString &in asAreaName,
const tString &in asTargetEntity,
bool abAlignRotation=false)
</syntaxhighlight>
Places the specified area at another entity, optionally aligning its rotation with the target entity.
* '''asAreaName''': name of the area.
* '''asTargetEntity''': entity to place at
* '''abAlignRotation''': if true the entity will be given the same rotation as the target entity.

----

===== Area_StopMovement =====
<syntaxhighlight lang="c++">
void Area_StopMovement(const tString &in asName)
</syntaxhighlight>
Stops an area that is already moving. !This is not for liquid areas!
* '''asName''': name of the area to stop moving, wildcard(s) * are supported.

----

===== Doorway_PlayerIsInGroup =====
<syntaxhighlight lang="c++">
bool Doorway_PlayerIsInGroup(const tString &in asGroupName)
</syntaxhighlight>
Returns true if the player has passed through one of the doorway areas belonging to this group and hasn't gone back out.
* '''asGroupName''': name of the group.

----

===== Doorway_SetPlayerIsInGroup =====
<syntaxhighlight lang="c++">
void Doorway_SetPlayerIsInGroup(const tString &in asGroupName,
bool abIsInGroup=true)
</syntaxhighlight>
Explicitly set, for if the player starts in a group or is teleported in or out.
* '''asGroupName''': name of the group.
* '''abIsInGroup''': state to set.

----

===== Doorway_EntityIsInGroup =====
<syntaxhighlight lang="c++">
bool Doorway_EntityIsInGroup(const tString &in asEntityName,
const tString &in asGroupName)
</syntaxhighlight>
Returns true if the specified entity has passed through one of the doorway areas belonging to this group and hasn't gone back out. Note that this will only return true if the entity has physically passed though the doorway, not if they start out inside or are teleported into the area.
* '''asEntityName''': name of the entity to check.
* '''asGroupName''': name of the group.

----

===== Doorway_SetEntityIsInGroup =====
<syntaxhighlight lang="c++">
void Doorway_SetEntityIsInGroup(const tString &in asEntityName,
const tString &in asGroupName,
bool abIsInGroup=true)
</syntaxhighlight>
Explicitly set, for if the specified entity starts in a group or is teleported in or out.
* '''asEntityName''': name of the entity to set the state of.
* '''asGroupName''': name of the group.
* '''abIsInGroup''': state to set.

----

===== LiquidArea_MoveLinearTo =====
<syntaxhighlight lang="c++">
void LiquidArea_MoveLinearTo(const tString &in asName,
const tString &in asTargetEntity,
float afAcceleration,
float afMaxSpeed,
float afSlowDownDist=0.0f,
bool abResetSpeed=false,
const tString &in asCallback="")
</syntaxhighlight>
Moves the specified liquid area to the current position of the target entity.
* '''asName''': name of the liquid area to move, wildcard(s) * are supported.
* '''asTargetEntity''': name of the entity to move the liquid area to.
* '''afAcceleration''': acceleration .in m/s^2
* '''afMaxSpeed''': the maximum speed of movement.
* '''afSlowDownDist''': the distance at which movement slows down.
* '''abResetSpeed''': if all static movement for the liquid area should be stopped before starting this movement.
* '''asCallback''': callback when movement is done: void asCallback(const tString& in asAreaName)

----

===== LiquidArea_StopMovement =====
<syntaxhighlight lang="c++">
void LiquidArea_StopMovement(const tString &in asName)
</syntaxhighlight>

----

===== LiquidArea_SetEffectOnExit =====
<syntaxhighlight lang="c++">
void LiquidArea_SetEffectOnExit(const tString &in asName,
bool abState)
</syntaxhighlight>
Sets whether screen effects should be shown when the camera leaves the area.
* '''asName''': name of the liquid area, wildcard(s) * are supported.
* '''abState''': state to set.

----

===== StickyArea_AttachEntity =====
<syntaxhighlight lang="c++">
void StickyArea_AttachEntity(const tString &in asArea,
const tString &in asEntity,
const tString &in asBody)
</syntaxhighlight>
Attaches an entity to a sticky area. The entity must have a physics body.
* '''asArea''': name of sticky area.
* '''asEntity''': name of entity.
* '''asBody''': name of specific body on entity, if left as an emtpy string, the main body will be used.

----

===== StickyArea_AttachBody =====
<syntaxhighlight lang="c++">
void StickyArea_AttachBody(const tString &in asArea,
const tString &in asBody)
</syntaxhighlight>
Attaches a physics body to a sticky area.
* '''asArea''': name of sticky area.
* '''asBody''': name of body to attach.

----

===== StickyArea_Detach =====
<syntaxhighlight lang="c++">
void StickyArea_Detach(const tString &in asArea)
</syntaxhighlight>
Detaches anything attached to a sticky area.
* '''asArea''': name of sticky area.

----

===== StickyArea_GetProp =====
<syntaxhighlight lang="c++">
iLuxEntity StickyArea_GetProp(const tString &in asArea)
</syntaxhighlight>
Returns the entity attached to the area.
* '''asArea''': name of sticky area.

'''Returns''': iLuxEntity @, the attached entity of the area, or null if no entity is attached.

----

===== StickyArea_GetAttachedEntityName =====
<syntaxhighlight lang="c++">
tString StickyArea_GetAttachedEntityName(const tString &in asArea)
</syntaxhighlight>
Returns the name of the attached entity.
* '''asArea''': name of sticky area.

'''Returns''': tString , name of the attached entity. An empty string if no entity is attached.

----

===== StickyArea_GetBody =====
<syntaxhighlight lang="c++">
iPhysicsBody StickyArea_GetBody(const tString &in asArea)
</syntaxhighlight>
Returns the body attached to the area.
* '''asArea''': name of sticky area.

'''Returns''': iPhysicsBody @, the attached body of the area, or null if no body is attached.

----

===== StickyArea_GetPoseTime =====
<syntaxhighlight lang="c++">
float StickyArea_GetPoseTime(const tString &in asArea)
</syntaxhighlight>
Returns the time it takes for the specified sticky area to pose an attached entity.
* '''asArea''': name of sticky area.

'''Returns''': float, pose time in seconds.

----

===== CameraAnimationNode_GetMaxYaw =====
<syntaxhighlight lang="c++">
float CameraAnimationNode_GetMaxYaw(const tString &in asArea)
</syntaxhighlight>
Returns the maximum yaw for the specified node.
* '''asArea''': name of animation node.

'''Returns''': float, max yaw in radians.

----

===== CameraAnimationNode_GetMaxPitch =====
<syntaxhighlight lang="c++">
float CameraAnimationNode_GetMaxPitch(const tString &in asArea)
</syntaxhighlight>
Returns the maximum pitch for the specified node.
* '''asArea''': name of animation node.

'''Returns''': float, max pitch in radians.

----

===== CameraAnimationNode_GetLookSpeedMul =====
<syntaxhighlight lang="c++">
float CameraAnimationNode_GetLookSpeedMul(const tString &in asArea)
</syntaxhighlight>
Returns the look speed multiplier for the specified node.
* '''asArea''': name of animation node.

'''Returns''': float, look speed multiplier.

----

===== CameraAnimationNode_GetForwardTime =====
<syntaxhighlight lang="c++">
float CameraAnimationNode_GetForwardTime(const tString &in asArea)
</syntaxhighlight>
Returns the time it takes to go to the next node in the animation.
* '''asArea''': name of animation node.

'''Returns''': float, forward time in seconds

----

===== CameraAnimationNode_GetForwardSpeed =====
<syntaxhighlight lang="c++">
float CameraAnimationNode_GetForwardSpeed(const tString &in asArea)
</syntaxhighlight>
Returns the forward speed for the specified node.
* '''asArea''': name of animation node.

'''Returns''': float, forward speed measured in "nodes per second"

----

===== CameraAnimationNode_GetBackTime =====
<syntaxhighlight lang="c++">
float CameraAnimationNode_GetBackTime(const tString &in asArea)
</syntaxhighlight>
Returns the time it takes to go back to this node from the next node in the animation.
* '''asArea''': name of animation node.

'''Returns''': float, back time in seconds

----

===== CameraAnimationNode_GetBackSpeed =====
<syntaxhighlight lang="c++">
float CameraAnimationNode_GetBackSpeed(const tString &in asArea)
</syntaxhighlight>
Returns the back speed for the specified node.
* '''asArea''': name of animation node.

'''Returns''': float, back speed measured in "nodes per second"

----

===== CameraAnimationNode_GetAutoMove =====
<syntaxhighlight lang="c++">
float CameraAnimationNode_GetAutoMove(const tString &in asArea)
</syntaxhighlight>
Returns the amount of auto move in the specified node.
* '''asArea''': name of animation node.

'''Returns''': float, auto move amount, 1 being full speed ahead and -1 being full speed back.

----

===== CameraAnimationNode_SetAutoMove =====
<syntaxhighlight lang="c++">
void CameraAnimationNode_SetAutoMove(const tString &in asArea,
const float afAutoMove)
</syntaxhighlight>
Sets the auto move amount for the specified node.
* '''asArea''': name of animation node.
* '''afAutoMove''': amount to set.

----

===== CameraAnimationNode_FadeAutoMove =====
<syntaxhighlight lang="c++">
void CameraAnimationNode_FadeAutoMove(const tString &in asArea,
const float afAutoMove,
const float afTime,
const eEasing aEasing=eEasing_QuartInOut)
</syntaxhighlight>
Fades the auto move amount for the specified node.
* '''asArea''': name of animation node.
* '''afAutoMove''': Target auto move amount.
* '''afTime''': Time that the fading will take (?).
* '''aEasing''': Easing curve to be used for fading.

----

===== CameraAnimationNode_GetLookMoveDist =====
<syntaxhighlight lang="c++">
float CameraAnimationNode_GetLookMoveDist(const tString &in asArea)
</syntaxhighlight>

----

===== CameraAnimationNode_GetLookMoveAngle =====
<syntaxhighlight lang="c++">
float CameraAnimationNode_GetLookMoveAngle(const tString &in asArea)
</syntaxhighlight>

----

===== CameraAnimationNode_GetInteractiveMovement =====
<syntaxhighlight lang="c++">
bool CameraAnimationNode_GetInteractiveMovement(const tString &in asArea)
</syntaxhighlight>
Returns if the node takes movement input from the player.
* '''asArea''': name of animation node.

'''Returns''': bool, true if the node's movement is interactive.

----

===== CameraAnimationNode_SetInteractiveMovement =====
<syntaxhighlight lang="c++">
void CameraAnimationNode_SetInteractiveMovement(const tString &in asArea,
bool abX)
</syntaxhighlight>
Sets if the node should take movement input from the player.
* '''asArea''': name of animation node.
* '''abX''': state to set.

----

===== CameraAnimationNode_GetCrouchOnExit =====
<syntaxhighlight lang="c++">
bool CameraAnimationNode_GetCrouchOnExit(const tString &in asArea)
</syntaxhighlight>
Returns true if the player should crouch if the animation stops at this node.
* '''asArea''': name of animation node.

'''Returns''': bool, true if the player should crouch on exit.

----

===== CameraAnimationNode_GetInitToCamera =====
<syntaxhighlight lang="c++">
bool CameraAnimationNode_GetInitToCamera(const tString &in asArea)
</syntaxhighlight>
Returns true if the node should be placed at the camera's position and orientation when the animation starts.
* '''asArea''': name of animation node.

'''Returns''': bool, true if the node should initialize to the camera.

----

===== CameraAnimationNode_SetInitToCamera =====
<syntaxhighlight lang="c++">
void CameraAnimationNode_SetInitToCamera(const tString &in asArea,
bool abInitToCamera)
</syntaxhighlight>
Sets if the node should be placed at the camera's position and orientation when the animation starts.
* '''asArea''': name of animation node.
* '''abInitToCamera''': state to set.

----

===== CameraAnimationNode_GetUseSpeedFading =====
<syntaxhighlight lang="c++">
bool CameraAnimationNode_GetUseSpeedFading(const tString &in asArea)
</syntaxhighlight>
Returns true if the node fades its speeds (back and forward) between this and the previous node in the animation.
* '''asArea''': name of animation node.

'''Returns''': bool, true if the node fades its speeds.

----

===== CameraAnimationNode_GetCallbackFunc =====
<syntaxhighlight lang="c++">
tString CameraAnimationNode_GetCallbackFunc(const tString &in asArea)
</syntaxhighlight>
Returns the callback function of the specified node.
* '''asArea''': name of animation node.

'''Returns''': tString , the callback function.

----

===== CameraAnimationNode_SetCallbackFunc =====
<syntaxhighlight lang="c++">
void CameraAnimationNode_SetCallbackFunc(const tString &in asArea,
const tString &in asFunction)
</syntaxhighlight>
Sets the callback function of the specified node.
* '''asArea''': name of animation node.
* '''asFunction''': the callback function to set.

----

===== CameraAnimationNode_HasBackMovement =====
<syntaxhighlight lang="c++">
bool CameraAnimationNode_HasBackMovement(const tString &in asArea)
</syntaxhighlight>
Returns true if it's possible to move from the next node in the animation to this one.
* '''asArea''': name of animation node.

'''Returns''': bool, true if it's possible to move back to this node.

----

Hpl3:Game:scripting:function reference:helper areas - Revision history

Maintenance script: Upload from wiki