Position Struct Reference

#include <Position.h>

Classes
struct	PositionXYStreamer
struct	PositionXYZOStreamer
struct	PositionXYZStreamer

Public Member Functions
	Position (float x=0, float y=0, float z=0, float o=0)
	Position (Position const &loc)
bool	operator== (Position const &a)
bool	operator!= (Position const &a)
void	Relocate (float x, float y)
void	Relocate (float x, float y, float z)
void	Relocate (float x, float y, float z, float orientation)
void	Relocate (Position const &pos)
void	Relocate (Position const *pos)
void	Relocate (G3D::Vector3 const &pos)
void	RelocateOffset (Position const &offset)
void	SetOrientation (float orientation)
float	GetPositionX () const
float	GetPositionY () const
float	GetPositionZ () const
float	GetOrientation () const
void	GetPosition (float &x, float &y) const
void	GetPosition (float &x, float &y, float &z) const
void	GetPosition (float &x, float &y, float &z, float &o) const
Position	GetPosition () const
Position::PositionXYStreamer	PositionXYStream ()
Position::PositionXYZStreamer	PositionXYZStream ()
Position::PositionXYZOStreamer	PositionXYZOStream ()
bool	IsPositionValid () const
float	GetExactDist2dSq (float x, float y) const
float	GetExactDist2d (const float x, const float y) const
float	GetExactDist2dSq (Position const *pos) const
float	GetExactDist2d (Position const *pos) const
float	GetExactDistSq (float x, float y, float z) const
float	GetExactDist (float x, float y, float z) const
float	GetExactDistSq (Position const *pos) const
float	GetExactDist (Position const *pos) const
void	GetPositionOffsetTo (Position const &endPos, Position &retOffset) const
Position	GetPositionWithOffset (Position const &offset) const
float	GetAngle (Position const *pos) const
float	GetAngle (float x, float y) const
float	GetRelativeAngle (Position const *pos) const
float	GetRelativeAngle (float x, float y) const
void	GetSinCos (float x, float y, float &vsin, float &vcos) const
bool	IsInDist2d (float x, float y, float dist) const
bool	IsInDist2d (Position const *pos, float dist) const
bool	IsInDist (float x, float y, float z, float dist) const
bool	IsInDist (Position const *pos, float dist) const
bool	IsWithinBox (const Position &center, float xradius, float yradius, float zradius) const
bool	HasInArc (float arcangle, Position const *pos, float border=2.0f) const
bool	HasInLine (Position const *pos, float width) const
std::string	ToString () const

Static Public Member Functions
static float	NormalizeOrientation (float o)

Public Attributes
float	m_positionX
float	m_positionY
float	m_positionZ

Private Attributes
float	m_orientation

Constructor & Destructor Documentation

Position::Position ( float  x = 0, float  y = 0, float  z = 0, float  o = 0  )

inline

 : m_positionX(x), m_positionY(y), m_positionZ(z), m_orientation(NormalizeOrientation(o)) { }

Here is the caller graph for this function:

Position::Position ( Position const &  loc )

inline

{ Relocate(loc); }

Member Function Documentation

float Position::GetAngle

(

Position const *

pos

)

const

{
 if (!obj)
 return 0;

 return GetAngle(obj->GetPositionX(), obj->GetPositionY());
}

Here is the call graph for this function:

Here is the caller graph for this function:

float Position::GetAngle	(	float	x,
		float	y
	)		const

{
 float dx = x - GetPositionX();
 float dy = y - GetPositionY();

 float ang = std::atan2(dy, dx);
 ang = (ang >= 0) ? ang : 2 * float(M_PI) + ang;
 return ang;
}

Here is the call graph for this function:

float Position::GetExactDist ( float  x, float  y, float  z  ) const

inline

 {
 return std::sqrt(GetExactDistSq(x, y, z));
 }

Here is the caller graph for this function:

float Position::GetExactDist ( Position const *  pos ) const

inline

 {
 return std::sqrt(GetExactDistSq(pos));
 }

float Position::GetExactDist2d ( const float  x, const float  y  ) const

inline

 {
 return std::sqrt(GetExactDist2dSq(x, y));
 }

Here is the caller graph for this function:

float Position::GetExactDist2d ( Position const *  pos ) const

inline

 {
 return std::sqrt(GetExactDist2dSq(pos));
 }

float Position::GetExactDist2dSq ( float  x, float  y  ) const

inline

 {
 float dx = m_positionX - x; float dy = m_positionY - y; return dx*dx + dy*dy;
 }

Here is the caller graph for this function:

float Position::GetExactDist2dSq ( Position const *  pos ) const

inline

 {
 float dx = m_positionX - pos->m_positionX; float dy = m_positionY - pos->m_positionY; return dx*dx + dy*dy;
 }

float Position::GetExactDistSq ( float  x, float  y, float  z  ) const

inline

 {
 float dz = m_positionZ - z; return GetExactDist2dSq(x, y) + dz*dz;
 }

Here is the caller graph for this function:

float Position::GetExactDistSq ( Position const *  pos ) const

inline

 {
 float dx = m_positionX - pos->m_positionX; float dy = m_positionY - pos->m_positionY; float dz = m_positionZ - pos->m_positionZ; return dx*dx + dy*dy + dz*dz;
 }

float Position::GetOrientation ( ) const

inline

{ return m_orientation; }

void Position::GetPosition ( float &  x, float &  y  ) const

inline

 {
 x = m_positionX; y = m_positionY;
 }

void Position::GetPosition ( float &  x, float &  y, float &  z  ) const

inline

 {
 x = m_positionX; y = m_positionY; z = m_positionZ;
 }

void Position::GetPosition ( float &  x, float &  y, float &  z, float &  o  ) const

inline

 {
 x = m_positionX; y = m_positionY; z = m_positionZ; o = m_orientation;
 }

Position Position::GetPosition ( ) const

inline

{ return *this; }

Here is the caller graph for this function:

void Position::GetPositionOffsetTo	(	Position const &	endPos,
		Position &	retOffset
	)		const

{
 float dx = endPos.GetPositionX() - GetPositionX();
 float dy = endPos.GetPositionY() - GetPositionY();

 retOffset.m_positionX = dx * std::cos(GetOrientation()) + dy * std::sin(GetOrientation());
 retOffset.m_positionY = dy * std::cos(GetOrientation()) - dx * std::sin(GetOrientation());
 retOffset.m_positionZ = endPos.GetPositionZ() - GetPositionZ();
 retOffset.SetOrientation(endPos.GetOrientation() - GetOrientation());
}

Here is the call graph for this function:

Here is the caller graph for this function:

Position Position::GetPositionWithOffset

(

Position const &

offset

)

const

{
 Position ret(*this);
 ret.RelocateOffset(offset);
 return ret;
}

Here is the call graph for this function:

Here is the caller graph for this function:

float Position::GetPositionX ( ) const

inline

{ return m_positionX; }

float Position::GetPositionY ( ) const

inline

{ return m_positionY; }

float Position::GetPositionZ ( ) const

inline

{ return m_positionZ; }

float Position::GetRelativeAngle ( Position const *  pos ) const

inline

 {
 return GetAngle(pos) - m_orientation;
 }

Here is the caller graph for this function:

float Position::GetRelativeAngle ( float  x, float  y  ) const

inline

{ return GetAngle(x, y) - m_orientation; }

void Position::GetSinCos	(	float	x,
		float	y,
		float &	vsin,
		float &	vcos
	)		const

{
 float dx = GetPositionX() - x;
 float dy = GetPositionY() - y;

 if (std::fabs(dx) < 0.001f && std::fabs(dy) < 0.001f)
 {
 float angle = (float)rand_norm()*static_cast<float>(2 * M_PI);
 vcos = std::cos(angle);
 vsin = std::sin(angle);
 }
 else
 {
 float dist = std::sqrt((dx*dx) + (dy*dy));
 vcos = dx / dist;
 vsin = dy / dist;
 }
}

Here is the call graph for this function:

Here is the caller graph for this function:

bool Position::HasInArc	(	float	arcangle,
		Position const *	pos,
		float	border = 2.0f
	)		const

{
 // always have self in arc
 if (obj == this)
 return true;

 // move arc to range 0.. 2*pi
 arc = NormalizeOrientation(arc);

 float angle = GetAngle(obj);
 angle -= m_orientation;

 // move angle to range -pi ... +pi
 angle = NormalizeOrientation(angle);
 if (angle > float(M_PI))
 angle -= 2.0f * float(M_PI);

 float lborder = -1 * (arc / border); // in range -pi..0
 float rborder = (arc / border); // in range 0..pi
 return ((angle >= lborder) && (angle <= rborder));
}

Here is the call graph for this function:

Here is the caller graph for this function:

bool Position::HasInLine	(	Position const *	pos,
		float	width
	)		const

{
 if (!HasInArc(float(M_PI), pos))
 return false;

 float angle = GetRelativeAngle(pos);
 return std::fabs(std::sin(angle)) * GetExactDist2d(pos->GetPositionX(), pos->GetPositionY()) < width;
}

Here is the call graph for this function:

Here is the caller graph for this function:

bool Position::IsInDist ( float  x, float  y, float  z, float  dist  ) const

inline

 {
 return GetExactDistSq(x, y, z) < dist * dist;
 }

Here is the caller graph for this function:

bool Position::IsInDist ( Position const *  pos, float  dist  ) const

inline

 {
 return GetExactDistSq(pos) < dist * dist;
 }

bool Position::IsInDist2d ( float  x, float  y, float  dist  ) const

inline

 {
 return GetExactDist2dSq(x, y) < dist * dist;
 }

Here is the caller graph for this function:

bool Position::IsInDist2d ( Position const *  pos, float  dist  ) const

inline

 {
 return GetExactDist2dSq(pos) < dist * dist;
 }

bool Position::IsPositionValid

(

)

const

{
 return Trinity::IsValidMapCoord(m_positionX, m_positionY, m_positionZ, m_orientation);
}

Here is the call graph for this function:

Here is the caller graph for this function:

bool Position::IsWithinBox	(	const Position &	center,
		float	xradius,
		float	yradius,
		float	zradius
	)		const

{
 // rotate the WorldObject position instead of rotating the whole cube, that way we can make a simplified
 // is-in-cube check and we have to calculate only one point instead of 4

 // 2PI = 360*, keep in mind that ingame orientation is counter-clockwise
 double rotation = 2 * M_PI - center.GetOrientation();
 double sinVal = std::sin(rotation);
 double cosVal = std::cos(rotation);

 float BoxDistX = GetPositionX() - center.GetPositionX();
 float BoxDistY = GetPositionY() - center.GetPositionY();

 float rotX = float(center.GetPositionX() + BoxDistX * cosVal - BoxDistY*sinVal);
 float rotY = float(center.GetPositionY() + BoxDistY * cosVal + BoxDistX*sinVal);

 // box edges are parallel to coordiante axis, so we can treat every dimension independently :D
 float dz = GetPositionZ() - center.GetPositionZ();
 float dx = rotX - center.GetPositionX();
 float dy = rotY - center.GetPositionY();
 if ((std::fabs(dx) > xradius) ||
 (std::fabs(dy) > yradius) ||
 (std::fabs(dz) > zradius))
 return false;

 return true;
}

Here is the call graph for this function:

static float Position::NormalizeOrientation ( float  o )

inlinestatic

 {
 // fmod only supports positive numbers. Thus we have
 // to emulate negative numbers
 if (o < 0)
 {
 float mod = o *-1;
 mod = std::fmod(mod, 2.0f * static_cast<float>(M_PI));
 mod = -mod + 2.0f * static_cast<float>(M_PI);
 return mod;
 }
 return std::fmod(o, 2.0f * static_cast<float>(M_PI));
 }

Here is the caller graph for this function:

bool Position::operator!= ( Position const &  a )

inline

 {
 return !(operator==(a));
 }

Here is the call graph for this function:

bool Position::operator==

(

Position const &

a

)

{
 return (G3D::fuzzyEq(a.m_positionX, m_positionX) &&
 G3D::fuzzyEq(a.m_positionY, m_positionY) &&
 G3D::fuzzyEq(a.m_positionZ, m_positionZ) &&
 G3D::fuzzyEq(a.m_orientation, m_orientation));
}

Here is the call graph for this function:

Position::PositionXYStreamer Position::PositionXYStream ( )

inline

{ return PositionXYStreamer(*this); }

Position::PositionXYZOStreamer Position::PositionXYZOStream ( )

inline

{ return PositionXYZOStreamer(*this); }

Here is the caller graph for this function:

Position::PositionXYZStreamer Position::PositionXYZStream ( )

inline

{ return PositionXYZStreamer(*this); }

Here is the caller graph for this function:

void Position::Relocate ( float  x, float  y  )

inline

 {
 m_positionX = x; m_positionY = y;
 }

void Position::Relocate ( float  x, float  y, float  z  )

inline

 {
 m_positionX = x; m_positionY = y; m_positionZ = z;
 }

void Position::Relocate ( float  x, float  y, float  z, float  orientation  )

inline

 {
 m_positionX = x; m_positionY = y; m_positionZ = z; SetOrientation(orientation);
 }

void Position::Relocate ( Position const &  pos )

inline

 {
 m_positionX = pos.m_positionX; m_positionY = pos.m_positionY; m_positionZ = pos.m_positionZ; SetOrientation(pos.m_orientation);
 }

void Position::Relocate ( Position const *  pos )

inline

 {
 m_positionX = pos->m_positionX; m_positionY = pos->m_positionY; m_positionZ = pos->m_positionZ; SetOrientation(pos->m_orientation);
 }

void Position::Relocate ( G3D::Vector3 const &  pos )

inline

 {
 m_positionX = pos.x; m_positionY = pos.y; m_positionZ = pos.z;
 }

void Position::RelocateOffset

(

Position const &

offset

)

{
 m_positionX = GetPositionX() + (offset.GetPositionX() * std::cos(GetOrientation()) + offset.GetPositionY() * std::sin(GetOrientation() + float(M_PI)));
 m_positionY = GetPositionY() + (offset.GetPositionY() * std::cos(GetOrientation()) + offset.GetPositionX() * std::sin(GetOrientation()));
 m_positionZ = GetPositionZ() + offset.GetPositionZ();
 SetOrientation(GetOrientation() + offset.GetOrientation());
}

Here is the call graph for this function:

Here is the caller graph for this function:

void Position::SetOrientation ( float  orientation )

inline

 {
 m_orientation = NormalizeOrientation(orientation);
 }

Here is the caller graph for this function:

std::string Position::ToString

(

)

const

{
 std::stringstream sstr;
 sstr << "X: " << m_positionX << " Y: " << m_positionY << " Z: " << m_positionZ << " O: " << m_orientation;
 return sstr.str();
}

Here is the caller graph for this function:

Member Data Documentation

float Position::m_orientation

private

float Position::m_positionX

float Position::m_positionY

float Position::m_positionZ

---

The documentation for this struct was generated from the following files:

• src/server/game/Entities/Object/Position.h
• src/server/game/Entities/Object/Position.cpp