cartesian.h

Go to the documentation of this file.

/*
 * Copyright (C) 2010-2015 Paul Davis <paul@linuxaudiosystems.com>
 *
 * This program is free software; you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation; either version 2 of the License, or
 * (at your option) any later version.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License along
 * with this program; if not, write to the Free Software Foundation, Inc.,
 * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
 */
 
#pragma once
 
#include <cfloat>
#include <cmath>
 
#include "pbd/libpbd_visibility.h"
 
namespace PBD {
 
LIBPBD_API void spherical_to_cartesian (double azi, double ele, double len, double& x, double& y, double& z);
LIBPBD_API void cartesian_to_spherical (double x, double y, double z, double& azi, double& ele, double& len);
 
struct AngularVector;
 
struct LIBPBD_API CartesianVector {
        double x;
        double y;
        double z;
 
        CartesianVector () : x(0.0), y(0.0), z(0.0) {}
        CartesianVector (double xp, double yp, double zp = 0.0) : x(xp), y(yp), z(zp) {}
 
        CartesianVector& translate (CartesianVector& other, double xtranslate, double ytranslate, double ztranslate = 0.0) {
                other.x += xtranslate;
                other.y += ytranslate;
                other.z += ztranslate;
                return other;
        }
 
        CartesianVector& scale (CartesianVector& other, double xscale, double yscale, double zscale = 1.0) {
                other.x *= xscale;
                other.y *= yscale;
                other.z *= zscale;
                return other;
        }
 
        inline void angular (AngularVector& a) const;
};
 
struct LIBPBD_API AngularVector {
        double azi;
        double ele;
        double length;
 
        AngularVector () : azi(0.0), ele(0.0), length (0.0) {}
        AngularVector (double a, double e, double l = 1.0) : azi(a), ele(e), length (l) {}
 
        AngularVector operator- (const AngularVector& other) const {
                AngularVector r;
                r.azi = azi - other.azi;
                r.ele = ele - other.ele;
                r.length = length - other.length;
                return r;
        }
 
        AngularVector operator+ (const AngularVector& other) const {
                AngularVector r;
                r.azi = azi + other.azi;
                r.ele = ele + other.ele;
                r.length = length + other.length;
                return r;
        }
 
        bool operator== (const AngularVector& other) const {
                return fabs (azi - other.azi) <= FLT_EPSILON &&
                fabs (ele - other.ele) <= FLT_EPSILON &&
                fabs (length - other.length) <= FLT_EPSILON;
        }
 
        bool operator!= (const AngularVector& other) const {
                return fabs (azi - other.azi) > FLT_EPSILON ||
                        fabs (ele - other.ele) > FLT_EPSILON ||
                        fabs (length - other.length) > FLT_EPSILON;
        }
 
        void cartesian (CartesianVector& c) const {
                spherical_to_cartesian (azi, ele, length, c.x, c.y, c.z);
        }
};
 
inline void CartesianVector::angular (AngularVector& a) const {
        cartesian_to_spherical (x, y, z, a.azi, a.ele, a.length);
}
 
}