Stellarium 0.13.0
List of all members | Public Types | Public Member Functions
SphericalRegion Class Referenceabstract

Abstract class defining a region of the sphere. More...

#include <StelSphereGeometry.hpp>

Public Types

enum  SphericalRegionType {
  Point = 0, Cap = 1, AllSky = 2, Polygon = 3,
  ConvexPolygon = 4, Empty = 5, Invalid = 6
}
 define types for all supported regions. More...
 

Public Member Functions

virtual SphericalRegionType getType () const =0
 
virtual OctahedronPolygon getOctahedronPolygon () const =0
 Return the octahedron contour representation of the polygon. More...
 
virtual double getArea () const
 Return the area of the region in steradians. More...
 
virtual bool isEmpty () const
 Return true if the region is empty. More...
 
virtual Vec3d getPointInside () const
 Return a point located inside the region. More...
 
virtual QVector< SphericalCapgetBoundingSphericalCaps () const
 Return the list of SphericalCap bounding the ConvexPolygon. More...
 
virtual SphericalCap getBoundingCap () const
 Return a bounding SphericalCap. More...
 
virtual SphericalRegionP getEnlarged (double margin) const
 Return an enlarged version of this SphericalRegion so that any point distant of more than the given margin now lays within the region. More...
 
virtual StelVertexArray getFillVertexArray () const
 Return an openGL compatible array to be displayed using vertex arrays. More...
 
virtual StelVertexArray getOutlineVertexArray () const
 Get the outline of the contours defining the SphericalPolygon. More...
 
virtual QVector< QVector< Vec3d > > getSimplifiedContours () const
 Get the contours defining the SphericalPolygon when combined using a positive winding rule. More...
 
virtual QVariantList toQVariant () const =0
 Serialize the region into a QVariant list matching the JSON format. More...
 
virtual void serialize (QDataStream &out) const =0
 Serialize the region. This method must allow as fast as possible serialization and work with deserialize(). More...
 
QByteArray toJSON () const
 Output a JSON string representing the polygon. More...
 
bool contains (const SphericalRegion *r) const
 Returns whether a SphericalRegion is contained into this region. More...
 
bool contains (const SphericalRegionP r) const
 
virtual bool contains (const Vec3d &p) const
 
virtual bool contains (const SphericalPolygon &r) const
 
virtual bool contains (const SphericalConvexPolygon &r) const
 
virtual bool contains (const SphericalCap &r) const
 
virtual bool contains (const SphericalPoint &r) const
 
virtual bool contains (const AllSkySphericalRegion &r) const
 
bool contains (const EmptySphericalRegion &) const
 
bool intersects (const SphericalRegion *r) const
 Returns whether a SphericalRegion intersects with this region. More...
 
bool intersects (const SphericalRegionP r) const
 
bool intersects (const Vec3d &p) const
 
virtual bool intersects (const SphericalPolygon &r) const
 
virtual bool intersects (const SphericalConvexPolygon &r) const
 
virtual bool intersects (const SphericalCap &r) const
 
virtual bool intersects (const SphericalPoint &r) const
 
virtual bool intersects (const AllSkySphericalRegion &r) const
 
bool intersects (const EmptySphericalRegion &) const
 
SphericalRegionP getIntersection (const SphericalRegion *r) const
 Return a new SphericalRegion consisting of the intersection of this and the given region. More...
 
SphericalRegionP getIntersection (const SphericalRegionP r) const
 
virtual SphericalRegionP getIntersection (const SphericalPolygon &r) const
 
virtual SphericalRegionP getIntersection (const SphericalConvexPolygon &r) const
 
virtual SphericalRegionP getIntersection (const SphericalCap &r) const
 
virtual SphericalRegionP getIntersection (const SphericalPoint &r) const
 
virtual SphericalRegionP getIntersection (const AllSkySphericalRegion &r) const
 
SphericalRegionP getIntersection (const EmptySphericalRegion &r) const
 
SphericalRegionP getUnion (const SphericalRegion *r) const
 Return a new SphericalRegion consisting of the union of this and the given region. More...
 
SphericalRegionP getUnion (const SphericalRegionP r) const
 
virtual SphericalRegionP getUnion (const SphericalPolygon &r) const
 
virtual SphericalRegionP getUnion (const SphericalConvexPolygon &r) const
 
virtual SphericalRegionP getUnion (const SphericalCap &r) const
 
virtual SphericalRegionP getUnion (const SphericalPoint &r) const
 
SphericalRegionP getUnion (const AllSkySphericalRegion &r) const
 
virtual SphericalRegionP getUnion (const EmptySphericalRegion &r) const
 
SphericalRegionP getSubtraction (const SphericalRegion *r) const
 Return a new SphericalRegion consisting of the subtraction of the given region from this. More...
 
SphericalRegionP getSubtraction (const SphericalRegionP r) const
 
virtual SphericalRegionP getSubtraction (const SphericalPolygon &r) const
 
virtual SphericalRegionP getSubtraction (const SphericalConvexPolygon &r) const
 
virtual SphericalRegionP getSubtraction (const SphericalCap &r) const
 
virtual SphericalRegionP getSubtraction (const SphericalPoint &r) const
 
SphericalRegionP getSubtraction (const AllSkySphericalRegion &r) const
 
virtual SphericalRegionP getSubtraction (const EmptySphericalRegion &r) const
 

Detailed Description

Abstract class defining a region of the sphere.

It provides default implementation for the general non-convex polygon which can extend on more than 180 deg based on the OctahedronPolygon class. Subclasses provides special faster implementations of many methods.

Definition at line 135 of file StelSphereGeometry.hpp.

Member Enumeration Documentation

define types for all supported regions.

Definition at line 139 of file StelSphereGeometry.hpp.

Member Function Documentation

bool SphericalRegion::contains ( const SphericalRegion r) const

Returns whether a SphericalRegion is contained into this region.

A default potentially very slow implementation is provided for each cases.

virtual double SphericalRegion::getArea ( ) const
inlinevirtual

Return the area of the region in steradians.

Reimplemented in SphericalConvexPolygon, EmptySphericalRegion, AllSkySphericalRegion, SphericalPoint, and SphericalCap.

Definition at line 159 of file StelSphereGeometry.hpp.

virtual SphericalCap SphericalRegion::getBoundingCap ( ) const
virtual

Return a bounding SphericalCap.

This method is heavily used and therefore needs to be very fast. The returned SphericalCap doesn't have to be the smallest one, but smaller is better.

Reimplemented in SphericalConvexPolygon, SphericalPolygon, EmptySphericalRegion, AllSkySphericalRegion, SphericalPoint, and SphericalCap.

virtual QVector<SphericalCap> SphericalRegion::getBoundingSphericalCaps ( ) const
virtual

Return the list of SphericalCap bounding the ConvexPolygon.

Reimplemented in SphericalConvexPolygon.

virtual SphericalRegionP SphericalRegion::getEnlarged ( double  margin) const
virtual

Return an enlarged version of this SphericalRegion so that any point distant of more than the given margin now lays within the region.

The returned region can be larger than the smallest enlarging region, therefore returning false positive on subsequent intersection tests. The default implementation always return an enlarged bounding SphericalCap.

Parameters
marginthe minimum enlargement margin in radian.
virtual StelVertexArray SphericalRegion::getFillVertexArray ( ) const
inlinevirtual

Return an openGL compatible array to be displayed using vertex arrays.

Reimplemented in SphericalTexturedConvexPolygon, SphericalTexturedPolygon, and SphericalConvexPolygon.

Definition at line 183 of file StelSphereGeometry.hpp.

SphericalRegionP SphericalRegion::getIntersection ( const SphericalRegion r) const

Return a new SphericalRegion consisting of the intersection of this and the given region.

A default potentially very slow implementation is provided for each cases.

virtual OctahedronPolygon SphericalRegion::getOctahedronPolygon ( ) const
pure virtual

Return the octahedron contour representation of the polygon.

It can be used for safe computation of intersection/union in the general case.

Implemented in SphericalConvexPolygon, SphericalPolygon, EmptySphericalRegion, AllSkySphericalRegion, SphericalPoint, and SphericalCap.

virtual StelVertexArray SphericalRegion::getOutlineVertexArray ( ) const
inlinevirtual

Get the outline of the contours defining the SphericalPolygon.

Returns
a list of vertex which taken 2 by 2 define the contours of the polygon.

Reimplemented in SphericalConvexPolygon.

Definition at line 187 of file StelSphereGeometry.hpp.

virtual Vec3d SphericalRegion::getPointInside ( ) const
inlinevirtual

Return a point located inside the region.

Reimplemented in SphericalConvexPolygon, EmptySphericalRegion, AllSkySphericalRegion, SphericalPoint, and SphericalCap.

Definition at line 165 of file StelSphereGeometry.hpp.

virtual QVector<QVector<Vec3d > > SphericalRegion::getSimplifiedContours ( ) const
virtual

Get the contours defining the SphericalPolygon when combined using a positive winding rule.

The default implementation return a list of tesselated triangles derived from the OctahedronPolygon.

SphericalRegionP SphericalRegion::getSubtraction ( const SphericalRegion r) const

Return a new SphericalRegion consisting of the subtraction of the given region from this.

A default potentially very slow implementation is provided for each cases.

SphericalRegionP SphericalRegion::getUnion ( const SphericalRegion r) const

Return a new SphericalRegion consisting of the union of this and the given region.

A default potentially very slow implementation is provided for each cases.

bool SphericalRegion::intersects ( const SphericalRegion r) const

Returns whether a SphericalRegion intersects with this region.

A default potentially very slow implementation is provided for each cases.

virtual bool SphericalRegion::isEmpty ( ) const
inlinevirtual

Return true if the region is empty.

Reimplemented in SphericalConvexPolygon, EmptySphericalRegion, AllSkySphericalRegion, SphericalPoint, and SphericalCap.

Definition at line 162 of file StelSphereGeometry.hpp.

virtual void SphericalRegion::serialize ( QDataStream &  out) const
pure virtual

Serialize the region. This method must allow as fast as possible serialization and work with deserialize().

Implemented in SphericalTexturedConvexPolygon, SphericalTexturedPolygon, SphericalConvexPolygon, SphericalPolygon, EmptySphericalRegion, AllSkySphericalRegion, SphericalPoint, and SphericalCap.

QByteArray SphericalRegion::toJSON ( ) const

Output a JSON string representing the polygon.

This method is convenient for debugging.

virtual QVariantList SphericalRegion::toQVariant ( ) const
pure virtual

The documentation for this class was generated from the following file: