LocalTangentSpaceEuclidean.h

Go to the documentation of this file.

// SRM SDK Release 4.1.2 - July 1, 2009

// - SRM spec. 4.1

/*
 *                             NOTICE
 * 
 * This software is provided openly and freely for use in representing and
 * interchanging environmental data & databases.
 * 
 * This software was developed for use by the United States Government with
 * unlimited rights.  The software was developed under contract
 * DASG60-02-D-0006 TO-193 by Science Applications International Corporation.
 * The software is unclassified and is deemed as Distribution A, approved
 * for Public Release.
 * 
 * Use by others is permitted only upon the ACCEPTANCE OF THE TERMS AND
 * CONDITIONS, AS STIPULATED UNDER THE FOLLOWING PROVISIONS:
 * 
 *    1. Recipient may make unlimited copies of this software and give
 *       copies to other persons or entities as long as the copies contain
 *       this NOTICE, and as long as the same copyright notices that
 *       appear on, or in, this software remain.
 * 
 *    2. Trademarks. All trademarks belong to their respective trademark
 *       holders.  Third-Party applications/software/information are
 *       copyrighted by their respective owners.
 * 
 *    3. Recipient agrees to forfeit all intellectual property and
 *       ownership rights for any version created from the modification
 *       or adaptation of this software, including versions created from
 *       the translation and/or reverse engineering of the software design.
 * 
 *    4. Transfer.  Recipient may not sell, rent, lease, or sublicense
 *       this software.  Recipient may, however enable another person
 *       or entity the rights to use this software, provided that this
 *       AGREEMENT and NOTICE is furnished along with the software and
 *       /or software system utilizing this software.
 * 
 *       All revisions, modifications, created by the Recipient, to this
 *       software and/or related technical data shall be forwarded by the 
 *       Recipient to the Government at the following address:
 * 
 *         SMDC
 *         Attention SEDRIS (TO193) TPOC
 *         P.O. Box 1500
 *         Hunstville, AL  35807-3801
 * 
 *         or via electronic mail to:  [email protected]
 * 
 *    5. No Warranty. This software is being delivered to you AS IS
 *       and there is no warranty, EXPRESS or IMPLIED, as to its use
 *       or performance.
 * 
 *       The RECIPIENT ASSUMES ALL RISKS, KNOWN AND UNKNOWN, OF USING
 *       THIS SOFTWARE.  The DEVELOPER EXPRESSLY DISCLAIMS, and the
 *       RECIPIENT WAIVES, ANY and ALL PERFORMANCE OR RESULTS YOU MAY
 *       OBTAIN BY USING THIS SOFTWARE OR DOCUMENTATION.  THERE IS
 *       NO WARRANTY, EXPRESS OR, IMPLIED, AS TO NON-INFRINGEMENT OF
 *       THIRD PARTY RIGHTS, MERCHANTABILITY, OR FITNESS FOR ANY
 *       PARTICULAR PURPOSE.  IN NO EVENT WILL THE DEVELOPER, THE
 *       UNITED STATES GOVERNMENT OR ANYONE ELSE ASSOCIATED WITH THE
 *       DEVELOPMENT OF THIS SOFTWARE BE HELD LIABLE FOR ANY CONSEQUENTIAL,
 *       INCIDENTAL OR SPECIAL DAMAGES, INCLUDING ANY LOST PROFITS
 *       OR LOST SAVINGS WHATSOEVER.
 */

// SRM_OTHERS_GOES_HERE

// $Id: LocalTangentSpaceEuclidean.h,v 1.16 2008/10/22 21:58:27 worleym Exp $

#ifndef _LocalTangentSpaceEuclidean_h
#define _LocalTangentSpaceEuclidean_h

#include "BaseSRF.h"
#include "Coord.h"
#include "Exception.h"

namespace srm
{
class EXPORT_SRM_CPP_DLL SRF_LocalTangentSpaceEuclidean: public BaseSRF_WithTangentPlaneSurface
{
public:
    static SRF_LocalTangentSpaceEuclidean* create(const SRM_ORM_Code orm,
                                                  const SRM_RT_Code  rt,
                                                  const SRM_LTSE_Parameters &params );

    static SRF_LocalTangentSpaceEuclidean* create(
                                                  SRM_ORM_Code orm,
                                                  SRM_RT_Code  rt,
                                                  SRM_Long_Float geodetic_longitude,
                                                  SRM_Long_Float geodetic_latitude,
                                                  SRM_Long_Float azimuth,
                                                  SRM_Long_Float x_false_origin,
                                                  SRM_Long_Float y_false_origin,
                                                  SRM_Long_Float height_offset
                                                  );

    static SRF_LocalTangentSpaceEuclidean* create( SRM_SRF_Parameters_Info srf_params )
    {
        return create(srf_params.value.srf_template.orm_code,
                      srf_params.rt_code,
                      srf_params.value.srf_template.parameters.ltse_srf_parameters );
    }

    Coord3D* createCoordinate3D(SRM_Long_Float coord_comp1,
                                SRM_Long_Float coord_comp2,
                                SRM_Long_Float coord_comp3 );

    CoordSurf* createSurfaceCoordinate(SRM_Long_Float coord_surf_comp1,
                                       SRM_Long_Float coord_surf_comp2 );

    const SRM_LTSE_Parameters &getSRFParameters() const;

    SRM_Long_Float get_geodetic_longitude() const;

    SRM_Long_Float get_geodetic_latitude() const;

    SRM_Long_Float get_azimuth() const;

    SRM_Long_Float get_x_false_origin() const;

    SRM_Long_Float get_y_false_origin() const;

    SRM_Long_Float get_height_offset() const;

    virtual bool isA( SRF_ClassType type ) const;

    virtual SRF_ClassType getClassType() const
    {
        return BaseSRF::SRF_TYP_LTSE;
    }

    bool isEqual( const SRF_LocalTangentSpaceEuclidean &srf ) const;

    bool operator==( const SRF_LocalTangentSpaceEuclidean &rhs ) const;

    SRF_LocalTangentSpaceEuclidean* makeCopy() const;

    virtual SRM_Coordinate_Valid_Region changeCoordinate3DSRF(const Coord3D &src_coord,
                                                                    Coord3D &des_coord );

    const char* toString();

protected:
    friend class BaseSRF;
    friend class BaseSRF_3D;
    friend class BaseSRF_WithEllipsoidalHeight;
    SRF_LocalTangentSpaceEuclidean( void *impl ); 
    SRF_LocalTangentSpaceEuclidean &operator =( const SRF_LocalTangentSpaceEuclidean & ) { return *this; } 
    virtual ~SRF_LocalTangentSpaceEuclidean(); 
};


inline bool SRF_LocalTangentSpaceEuclidean::isA( SRF_ClassType type ) const
{
    if (type == BaseSRF::SRF_TYP_LTSE)
        return true;
    else
        return BaseSRF_WithTangentPlaneSurface::isA(type);
};


typedef SRF_LocalTangentSpaceEuclidean SRF_LTSE;


class EXPORT_SRM_CPP_DLL Coord3D_LocalTangentSpaceEuclidean: public Coord3D
{
public:
    Coord3D_LocalTangentSpaceEuclidean(SRF_LocalTangentSpaceEuclidean *srf,
                                       SRM_Long_Float x = 0.0,
                                       SRM_Long_Float y = 0.0,
                                       SRM_Long_Float height = 0.0 )
    : Coord3D(srf)
    {
        setComponentValues(x, y, height);
    }

    Coord3D_LocalTangentSpaceEuclidean( const Coord3D_LocalTangentSpaceEuclidean &coord )
    : Coord3D(coord._srf)
    {
        setComponentValues( coord._values[0], coord._values[1], coord._values[2] );
    }

    void copyTo( Coord3D_LocalTangentSpaceEuclidean &coord ) const
    {
        if (coord._srf != _srf)
            throw Exception( SRM_STATCOD_INVALID_SOURCE_COORDINATE, "copyTo: Coordinate associated with a difference SRF" );

        coord._values[0] = _values[0];
        coord._values[1] = _values[1];
        coord._values[2] = _values[2];
    }

    bool isEqual( const Coord3D_LocalTangentSpaceEuclidean &coord ) const
    {
        return (_srf == coord._srf &&
                _values[0] == coord._values[0] &&
                _values[1] == coord._values[1] &&
                _values[2] == coord._values[2] );
    }

    void setComponentValues( SRM_Long_Float x, SRM_Long_Float y, SRM_Long_Float height )
    {
        _values[0] = x;
        _values[1] = y;
        _values[2] = height;
    }

    SRM_Long_Float get_x() const
    {
        return _values[0];
    }

    SRM_Long_Float get_y() const
    {
        return _values[1];
    }

    SRM_Long_Float get_height() const
    {
        return _values[2];
    }

    void set_x( SRM_Long_Float value )
    {
        _values[0] = value;
    }

    void set_y( SRM_Long_Float value )
    {
        _values[1] = value;
    }

    void set_height( SRM_Long_Float value )
    {
        _values[2] = value;
    }

    virtual bool isA( Coord_ClassType type ) const;

    virtual Coord_ClassType getClassType() const
    {
        return Coord::COORD_TYP_LTSE;
    }

    bool operator==( const Coord3D_LocalTangentSpaceEuclidean &rhs ) const;

    bool isCompatibleWith( const Coord3D_LocalTangentSpaceEuclidean &rhs ) const
    {
        return ((*(SRF_LocalTangentSpaceEuclidean*)(this->_srf)) == (*(SRF_LocalTangentSpaceEuclidean*)(rhs._srf)));
    }

    Coord3D_LocalTangentSpaceEuclidean &operator= ( const Coord3D_LocalTangentSpaceEuclidean &rhs )
    {
        if((*(SRF_LocalTangentSpaceEuclidean*)(this->_srf)) == (*(SRF_LocalTangentSpaceEuclidean*)(rhs._srf)))
        {
            _values[0] = rhs._values[0];
            _values[1] = rhs._values[1];
            _values[2] = rhs._values[2];
        }
        else
            throw Exception(SRM_STATCOD_INVALID_TARGET_COORDINATE,
                            "Coord3D_LocalTangentSpaceEuclidean op=: incompatible rhs coordinate");

        return *this;
    }
};


inline bool Coord3D_LocalTangentSpaceEuclidean::isA( Coord_ClassType type ) const
{
    if (type == Coord::COORD_TYP_LTSE)
        return true;
    else
        return Coord3D::isA(type);
};


typedef Coord3D_LocalTangentSpaceEuclidean Coord3D_LTSE;


class EXPORT_SRM_CPP_DLL CoordSurf_LocalTangentSpaceEuclidean: public CoordSurf
{
public:
    CoordSurf_LocalTangentSpaceEuclidean(SRF_LocalTangentSpaceEuclidean *srf,
                                         SRM_Long_Float x = 0.0,
                                         SRM_Long_Float y = 0.0 )
    : CoordSurf(srf)
    {
        setComponentValues(x, y);
    }

    CoordSurf_LocalTangentSpaceEuclidean( const CoordSurf_LocalTangentSpaceEuclidean &coord )
    : CoordSurf(coord._srf)
    {
        setComponentValues( coord._values[0], coord._values[1] );
    }

    void copyTo( CoordSurf_LocalTangentSpaceEuclidean &coord ) const
    {
        if (coord._srf != _srf)
            throw Exception( SRM_STATCOD_INVALID_SOURCE_COORDINATE, "copyTo: Coordinate associated with a difference SRF" );

        coord._values[0] = _values[0];
        coord._values[1] = _values[1];
    }

    bool isEqual( const CoordSurf_LocalTangentSpaceEuclidean &coord ) const
    {
        return (_srf == coord._srf &&
                _values[0] == coord._values[0] &&
                _values[1] == coord._values[1] );
    }

    void setComponentValues( SRM_Long_Float x, SRM_Long_Float y )
    {
        _values[0] = x;
        _values[1] = y;
    }

    SRM_Long_Float get_x() const
    {
        return _values[0];
    }

    SRM_Long_Float get_y() const
    {
        return _values[1];
    }

    void set_x( SRM_Long_Float value )
    {
        _values[0] = value;
    }

    void set_y( SRM_Long_Float value )
    {
        _values[1] = value;
    }

    virtual bool isA( Coord_ClassType type ) const;

    virtual Coord_ClassType getClassType() const
    {
        return Coord::COORD_TYP_SURF_LTSE;
    }

    bool operator==( const CoordSurf_LocalTangentSpaceEuclidean &rhs ) const;

    bool isCompatibleWith( const CoordSurf_LocalTangentSpaceEuclidean &rhs ) const
    {
        return ((*(SRF_LocalTangentSpaceEuclidean*)(this->_srf)) == (*(SRF_LocalTangentSpaceEuclidean*)(rhs._srf)));
    }

    CoordSurf_LocalTangentSpaceEuclidean &operator= ( const CoordSurf_LocalTangentSpaceEuclidean &rhs )
    {
        if((*(SRF_LocalTangentSpaceEuclidean*)(this->_srf)) == (*(SRF_LocalTangentSpaceEuclidean*)(rhs._srf)))
        {
            _values[0] = rhs._values[0];
            _values[1] = rhs._values[1];
        }
        else
            throw Exception(SRM_STATCOD_INVALID_TARGET_COORDINATE,
                            "CoordSurf_LocalTangentSpaceEuclidean op=: incompatible rhs coordinate");

        return *this;
    }
};


inline bool CoordSurf_LocalTangentSpaceEuclidean::isA( Coord_ClassType type ) const
{
    if (type == Coord::COORD_TYP_SURF_LTSE)
        return true;
    else
        return CoordSurf::isA(type);
};


typedef CoordSurf_LocalTangentSpaceEuclidean CoordSurf_LTSE;

} // namespace srm

#endif // _LocalTangentSpaceEuclidean_h

---

Spatial Reference Model C++ API	Version 4.1.2 - 1 Jul 2009
Copyright © 2009 SEDRIS™	Docs by Doxygen 1.3.2