SpatialConstraint.h

#ifndef _SpatialConstraint_h
#define _SpatialConstraint_h
//#     Filename:       SpatialConstraint.h
//#
//#     Classes defined here: SpatialConstraint SpatialSign
//#
//#
//#     Author:         Peter Z. Kunszt, based on A. Szalay's code
//#
//#     Date:           October 16, 1998
//#
//#     SPDX-FileCopyrightText: 2000 Peter Z. Kunszt Alex S. Szalay, Aniruddha R. Thakar
//#                     The Johns Hopkins University
//#
//#     Modification History:
//#
//#     Oct 18, 2001 : Dennis C. Dinge -- Replaced ValVec with std::vector
//#
 
#include "SpatialGeneral.h"
#include "SpatialSign.h"
#include "SpatialVector.h"
//
//########################################################################
//#
//# Spatial Constraint class
//#
/**
   The Constraint is really a cone on the sky-sphere. It is characterized
   by its direction a_, the opening angle s_ and its cosine -- the distance
   of the plane intersecting the sphere and the sphere center.
   If d_ = 0, we have a half-sphere. If it is negative, we have a 'hole'
   i.e. the room angle is larger than 90degrees.
 
   Example: positive distance
 
                   ____
                ---    ---
               /        /|\
              /        / |=\
             |        /  |==|     this side is in the convex.
            |        /\s |===|
            |------------|---| -> direction a
            |        \   |===|
             |        \  |==|
              \        \ |=/
               \        \|/
                ---____---
 
 
                     <-d-> is positive (s < 90)
 
 Example: negative distance
 
                      ____
                   ---====---
     this side is /========/|\
     in the      /========/=| \
     convex     |==== s__/==|  |
               |===== / /===|   |
     dir. a <- |------------|---|  'hole' in the sphere
               |========\===|   |
                |========\==|  |
                 \========\=| /
                  \========\|/
                   ---____---
 
 
                        <-d-> is negative (s > 90)
 
 for d=0 we have a half-sphere. Combining such, we get triangles, rectangles
 etc on the sphere surface (pure ZERO convexes)
 
*/
class LINKAGE SpatialConstraint
{
  public:
    /// Constructor
    SpatialConstraint(){};
 
    /// Initialization constructor
    SpatialConstraint(SpatialVector, float64);
 
    /// check whether a vector is inside this
    bool contains(const SpatialVector v);
 
    /// give back vector
    SpatialVector &v() { return a_; }
 
  private:
    Sign sign_;
    SpatialVector a_; // normal vector
    float64 d_;       // distance from origin
    float64 s_;       // cone angle in radians
 
    friend class RangeConvex;
};
 
#endif