This page has been translated automatically.
Video Tutorials
Interface
Essentials
Advanced
How To
Professional (SIM)
UnigineEditor
Interface Overview
Assets Workflow
Version Control
Settings and Preferences
Working With Projects
Adjusting Node Parameters
Setting Up Materials
Setting Up Properties
Lighting
Sandworm
Using Editor Tools for Specific Tasks
Extending Editor Functionality
Built-in Node Types
Nodes
Objects
Effects
Decals
Light Sources
Geodetics
World Nodes
Sound Objects
Pathfinding Objects
Players
Programming
Fundamentals
Setting Up Development Environment
Usage Examples
C++
C#
UnigineScript
UUSL (Unified UNIGINE Shader Language)
Plugins
File Formats
Materials and Shaders
Rebuilding the Engine Tools
GUI
Double Precision Coordinates
API
Containers
Common Functionality
Controls-Related Classes
Engine-Related Classes
Filesystem Functionality
GUI-Related Classes
Math Functionality
Node-Related Classes
Objects-Related Classes
Networking Functionality
Pathfinding-Related Classes
Physics-Related Classes
Plugins-Related Classes
IG Plugin
CIGIConnector Plugin
Rendering-Related Classes
Content Creation
Content Optimization
Materials
Material Nodes Library
Miscellaneous
Input
Math
Matrix
Textures
Art Samples
Tutorials
Warning! This version of documentation is OUTDATED, as it describes an older SDK version! Please switch to the documentation for the latest SDK version.
Warning! This version of documentation describes an old SDK version which is no longer supported! Please upgrade to the latest SDK version.

Unigine::PlayerSpectator Class

Header: #include <UniginePlayers.h>
Inherits from: Player

Interface for player spectator handling.

To use this class, include the UniginePlayerSpectator.h file.

See Also#

  • A UnigineScript API sample <UnigineSDK>/data/samples/players/spectator_00
  • A C# API sample <UnigineSDK>/source/csharp/samples/Api/Nodes/CustomPlayers/CustomPlayerSpectator

PlayerSpectator Class

Members


static PlayerSpectatorPtr create ( ) #

Constructor. Creates a new spectator with default properties.

void setAcceleration ( float acceleration ) #

Sets an acceleration of the spectator.

Arguments

  • float acceleration - New acceleration in units per second squared. If a negative value is provided, 0 will be used instead.

float getAcceleration ( ) const#

Returns the current acceleration of the spectator.

Return value

Acceleration in units per second squared.

void setCollision ( int collision ) #

Updates a value indicating if collisions with spectator's sphere should be taken into account.

Arguments

  • int collision - 1 to enable collisions, 0 to let the spectator fly through objects.

int getCollision ( ) const#

Returns a value indicating if collisions with spectator's sphere should be taken into account.

Return value

1 if collisions are taken into account; otherwise, 0.

void setCollisionMask ( int mask ) #

Sets a collision mask for the spectators's collision sphere. Two objects collide, if they both have matching masks.

Arguments

  • int mask - An integer value, each bit of which is used to set a bit mask.

int getCollisionMask ( ) const#

Returns a collision mask of the spectators's collision sphere. Two objects collide, if they both have matching masks.

Return value

An integer value, each bit of which is used to set a bit mask.

void setCollisionRadius ( float radius ) #

Updates radius of the spectators's collision sphere.

Arguments

  • float radius - New radius of the collision sphere.

float getCollisionRadius ( ) const#

Returns radius of the spectators's collision sphere.

Return value

Radius of the collision sphere in units.

float getContactDepth ( int contact ) const#

Returns penetration depth by the given contact.

Arguments

  • int contact - Contact number.

Return value

Penetration depth.

Math::vec3 getContactNormal ( int contact ) const#

Returns a normal of the contact point, in world coordinates.

Arguments

  • int contact - Contact number.

Return value

Normal of the contact point.

Object getContactObject ( int contact ) const#

Returns an object participating in the contact with the player (used for collisions with physical object).

Arguments

  • int contact - Contact number.

Return value

Object in contact.

Math::Vec3 getContactPoint ( int contact ) const#

Returns world coordinates of the contact point.

Arguments

  • int contact - Contact number.

Return value

Contact point.

Ptr<Shape> getContactShape ( int num ) const#

Returns a shape that collided with the player.

Arguments

  • int num - Contact number.

Return value

Shape in contact.

int getContactSurface ( int contact ) const#

Returns the surface of the current object, which is in contact (used for collisions with non-physical object).

Arguments

  • int contact - Contact number.

Return value

Surface number.

void setDamping ( float damping ) #

Sets a spectator's damping.

Arguments

  • float damping - New damping value.

float getDamping ( ) const#

Returns the spectator's damping.

Return value

Damping value.

void setMaxThetaAngle ( float angle ) #

Sets the maximum theta angle (zenith angle, also known as pitch angle) that determines how far downward the player can look.

Arguments

  • float angle - New angle in degrees in range [0;90]. The higher the value, the further down the player can look.

float getMaxThetaAngle ( ) const#

Returns the maximum theta angle (zenith angle, also known as pitch angle) that determines how far downward the player can look. The higher the value, the further down the player can look.

Return value

Current maximum theta angle in degrees.

void setMaxVelocity ( float velocity ) #

Sets the velocity of the spectator, which is used while the spectator runs (the Controls::STATE_RUN control state is "pressed").

Arguments

  • float velocity - New velocity in units per second. If a negative value is provided, 0 will be used instead.

float getMaxVelocity ( ) const#

Returns the velocity of the spectator, which is used while the spectator runs (the Controls::STATE_RUN control state is "pressed").

Return value

Velocity in units per second.

void setMinThetaAngle ( float angle ) #

Sets the minimum theta angle (zenith angle, also known as pitch angle) that determines how far upward the player can look.

Arguments

  • float angle - New angle in degrees in range [-90;0]. The lower the value, the further up the player can look.

float getMinThetaAngle ( ) const#

Returns the minimum theta angle (zenith angle, also known as pitch angle) that determines how far upward the player can look. The lower the value, the further up the player can look.

Return value

Current minimum theta angle in degrees.

void setMinVelocity ( float velocity ) #

Sets the default velocity of the spectator.

Arguments

  • float velocity - New velocity in units per second. If a negative value is provided, 0 will be used instead.

float getMinVelocity ( ) const#

Returns the default velocity of the spectator.

Return value

Velocity in units per second.

int getNumContacts ( ) const#

Returns the number of contacts, in which the spectator's sphere participates.

Return value

Number of contacts.

void setPhiAngle ( float angle ) #

Sets the phi angle (azimuth angle, also known as yaw angle). This angle determines the horizontal viewing direction, i.e. left or right.

Arguments

  • float angle - New angle in degrees. Positive values rotate the player right; negative values rotate the player left.

float getPhiAngle ( ) const#

Returns the phi angle (azimuth angle, also known as yaw angle). This angle determines the horizontal viewing direction, i.e. left or right. Positive values rotate the player right; negative values rotate it to the left.

Return value

Phi angle value.

void setThetaAngle ( float angle ) #

Sets the theta angle of the player (zenith angle, also known as pitch angle). This angle determines the vertical viewing direction, i.e. upwards or downwards. The value will be clamped between the minimum and the maximum theta angle.

Arguments

  • float angle - New angle in degrees in range [-90;90]. If a positive value is specified, the player will look upwards; if a negative value is specified, the player will look downwards.

float getThetaAngle ( ) const#

Returns the theta angle (zenith angle, also known as pitch angle). This angle determines the vertical viewing direction, i.e. upwards or downwards. If a positive value is returned, the player looks upwards; if a negative value is returned, the player looks downwards. The value is clamped between the minimum and the maximum theta angle.

Return value

Theta angle value.

void setTurning ( float turning ) #

Sets a velocity of player turning.

Arguments

  • float turning - Turning velocity in degrees per second. If a negative value is provided, 0 will be used instead.

float getTurning ( ) const#

Returns a velocity of player turning.

Return value

Turning velocity in degrees per second.

void setViewDirection ( const Math::vec3 & direction ) #

Sets a new Player's view direction vector.

Arguments

  • const Math::vec3 & direction - New view direction vector to be set.

Math::vec3 getViewDirection ( ) const#

Returns the current Player's view direction vector.

Return value

Current Player's view direction vector.

static int type ( ) #

Returns the type of the player.

Return value

PlayerSpectator type identifier.
Last update: 2023-06-23
Build: ()