Stellarium 0.15.2
|
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< SphericalCap > | getBoundingSphericalCaps () 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 |
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 133 of file StelSphereGeometry.hpp.
define types for all supported regions.
Definition at line 137 of file StelSphereGeometry.hpp.
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.
|
inlinevirtual |
Return the area of the region in steradians.
Reimplemented in SphericalConvexPolygon, EmptySphericalRegion, AllSkySphericalRegion, SphericalPoint, and SphericalCap.
Definition at line 157 of file StelSphereGeometry.hpp.
|
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 |
Return the list of SphericalCap bounding the ConvexPolygon.
Reimplemented in SphericalConvexPolygon.
|
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.
margin | the minimum enlargement margin in radian. |
|
inlinevirtual |
Return an openGL compatible array to be displayed using vertex arrays.
Reimplemented in SphericalTexturedConvexPolygon, SphericalTexturedPolygon, and SphericalConvexPolygon.
Definition at line 181 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.
|
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.
|
inlinevirtual |
Get the outline of the contours defining the SphericalPolygon.
Reimplemented in SphericalConvexPolygon.
Definition at line 185 of file StelSphereGeometry.hpp.
|
inlinevirtual |
Return a point located inside the region.
Reimplemented in SphericalConvexPolygon, EmptySphericalRegion, AllSkySphericalRegion, SphericalPoint, and SphericalCap.
Definition at line 163 of file StelSphereGeometry.hpp.
|
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.
|
inlinevirtual |
Return true if the region is empty.
Reimplemented in SphericalConvexPolygon, EmptySphericalRegion, AllSkySphericalRegion, SphericalPoint, and SphericalCap.
Definition at line 160 of file StelSphereGeometry.hpp.
|
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.
|
pure virtual |
Serialize the region into a QVariant list matching the JSON format.
Implemented in SphericalTexturedConvexPolygon, SphericalTexturedPolygon, SphericalConvexPolygon, SphericalPolygon, EmptySphericalRegion, AllSkySphericalRegion, SphericalPoint, and SphericalCap.