point.c File Reference

A three dimensional point. More...

#include "libtpcimgp.h"

Go to the source code of this file.

Functions
int	pRound (float number)
float	getDistance (point begin, point end)
float	getAngle (point begin, point center)

Detailed Description

A three dimensional point.

Author

Riku Klén

Definition in file point.c.

Function Documentation

getAngle()

float getAngle	(	point	begin,
		point	center )

Calculates xy-projection of angle FCX in degrees, where F=first point, C=centre point and X=point with higher x coordinate (y and z coordinate remain the same).

This is used to calculate polar angle with two dimensional points (z=constant).

Returns

Angle first - centre - x in degrees (0-360) and -360.0 if first point is equal to centre point.

See also

getDistance

Parameters

begin	First point.
center	Centre point.

Definition at line 55 of file point.c.

  {
  float dx, dy;
  dx = begin.x - center.x;  // Difference in x coordinates.
  dy = begin.y - center.y;  // Difference in y coordinates.
 
  // Check trivial cases.
  if(dx == 0.0){
    if(dy == 0.0) return -360.0;
    if(dy > 0.0) return 90.0;
    else return 270.0;
  }
  if(dy==0.0){
    if(dx > 0.0) return 0.0;
    else return 180.0;
  }
 
  // If it was not a trivial case, then calculate angle in...
  // ...the second and the third quarter.
  if(dx<0.0) return 180.0 + atan(dy/dx)*180.0/M_PI;
 
  // ...the first quarter.
  if(dy>0.0) return atan(dy/dx)*180.0/M_PI;
 
  // ...the fourth quarter.
  return 360.0 + atan(dy/dx)*180.0/M_PI;
}

getDistance()

float getDistance	(	point	begin,
		point	end )

Calculate distance between points

See also

getAngle

Returns

Distance.

Parameters

begin	First point
end	Second point

Definition at line 31 of file point.c.

  {
  float dx, dy, dz;
 
  dx = begin.x - end.x; // Difference in x coordinates.
  dy = begin.y - end.y; // Difference in y coordinates.
  dz = begin.z - end.z; // Difference in z coordinates.
  return sqrt(dx*dx + dy*dy + dz*dz);
}

pRound()

int pRound

(

float

number

)

Round float to int.

Returns

Rounded value.

Parameters

number

Any number

Definition at line 15 of file point.c.

  {
  if(number - floor(number) < 0.5){
    return floor(number);
  }
  return ceil(number);
}