Stellarium  24.3
Data Structures | Public Member Functions
SphericalTexturedPolygon Class Reference

An extension of SphericalPolygon with addition of texture coordinates. More...

#include <StelSphereGeometry.hpp>

Data Structures

struct  TextureVertex
 A container for 3D vertex + associated texture coordinates. More...
 

Public Member Functions

 SphericalTexturedPolygon (const QVector< QVector< TextureVertex > > &contours)
 Constructor from a list of contours.
 
 SphericalTexturedPolygon (const QVector< TextureVertex > &contour)
 Constructor from one contour.
 
StelVertexArray getFillVertexArray () const override
 Return an OpenGL compatible array of texture coords to be used using vertex arrays. More...
 
StelVertexArray getFillVertexArray (const Vec3d &observerVelocityForAberration) override
 Return an OpenGL compatible array to be displayed using vertex arrays. More...
 
QVariantList toQVariant () const override
 Serialize the region into a QVariant map matching the JSON format. More...
 
void serialize (QDataStream &out) const override
 Serialize the region. This method must allow as fast as possible serialization and work with deserialize().
 
void setContours (const QVector< QVector< TextureVertex > > &contours)
 Set the contours defining the SphericalPolygon. More...
 
void setContour (const QVector< TextureVertex > &contour)
 Set a single contour defining the SphericalPolygon. More...
 
- Public Member Functions inherited from SphericalPolygon
 SphericalPolygon (const QVector< QVector< Vec3d > > &contours)
 Constructor from a list of contours.
 
 SphericalPolygon (const QVector< Vec3d > &contour)
 Constructor from one contour.
 
 SphericalPolygon (const OctahedronPolygon &octContour)
 
 SphericalPolygon (const QList< OctahedronPolygon > &octContours)
 
SphericalRegionType getType () const override
 
OctahedronPolygon getOctahedronPolygon () const override
 Return the octahedron contour representation of the polygon. More...
 
SphericalCap getBoundingCap () const override
 Return a bounding SphericalCap. More...
 
bool contains (const Vec3d &p) const override
 
bool contains (const SphericalPolygon &r) const override
 
bool contains (const SphericalConvexPolygon &r) const override
 
bool contains (const SphericalCap &r) const override
 
bool contains (const SphericalPoint &r) const override
 
bool contains (const AllSkySphericalRegion &r) const override
 
SphericalRegionP getSubtraction (const SphericalPoint &) const override
 
SphericalRegionP getSubtraction (const EmptySphericalRegion &) const override
 
void setContours (const QVector< QVector< Vec3d > > &contours)
 Set the contours defining the SphericalPolygon. More...
 
void setContour (const QVector< Vec3d > &contour)
 Set a single contour defining the SphericalPolygon. More...
 
QVector< QVector< Vec3d > > getClosedOutlineContours () const
 Return the list of closed contours defining the polygon boundaries.
 
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
 
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
 
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
 
- Public Member Functions inherited from SphericalRegion
virtual double getArea () const
 Return the area of the region in steradians.
 
virtual bool isEmpty () const
 Return true if the region is empty.
 
virtual Vec3d getPointInside () const
 Return a point located inside the region.
 
virtual QVector< SphericalCapgetBoundingSphericalCaps () const
 Return the list of SphericalCap bounding the ConvexPolygon.
 
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 getOutlineVertexArray () const
 Get the outline of the contours defining the SphericalPolygon. More...
 
virtual StelVertexArray getOutlineVertexArray (Vec3d observerVelocityForAberration)
 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...
 
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
 
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 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
 
SphericalRegionP getSubtraction (const AllSkySphericalRegion &r) const
 

Additional Inherited Members

- Public Types inherited from SphericalRegion
enum  SphericalRegionType {
  Point = 0 , Cap = 1 , AllSky = 2 , Polygon = 3 ,
  ConvexPolygon = 4 , Empty = 5 , Invalid = 6
}
 define types for all supported regions.
 
- Static Public Member Functions inherited from SphericalPolygon
static SphericalRegionP deserialize (QDataStream &in)
 Deserialize the region. This method must allow as fast as possible deserialization.
 

Detailed Description

An extension of SphericalPolygon with addition of texture coordinates.


Data Structure Documentation

◆ SphericalTexturedPolygon::TextureVertex

struct SphericalTexturedPolygon::TextureVertex

A container for 3D vertex + associated texture coordinates.

Data Fields
Vec2f texCoord
Vec3d vertex

Member Function Documentation

◆ getFillVertexArray() [1/2]

StelVertexArray SphericalTexturedPolygon::getFillVertexArray ( ) const
inlineoverridevirtual

Return an OpenGL compatible array of texture coords to be used using vertex arrays.

This implementation never should appear in practice.

Reimplemented from SphericalRegion.

◆ getFillVertexArray() [2/2]

StelVertexArray SphericalTexturedPolygon::getFillVertexArray ( const Vec3d observerVelocityForAberration)
inlineoverridevirtual

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

Note
Presumably these general polygons of the base class don't describe geometry that may undergo aberration, so the observerVelocity must be zero. Implementation in derived classes should show aberration correction.

Reimplemented from SphericalRegion.

◆ setContour()

void SphericalTexturedPolygon::setContour ( const QVector< TextureVertex > &  contour)
inline

Set a single contour defining the SphericalPolygon.

Parameters
contoura contour defining the polygon area.

◆ setContours()

void SphericalTexturedPolygon::setContours ( const QVector< QVector< TextureVertex > > &  contours)
inline

Set the contours defining the SphericalPolygon.

Parameters
contoursthe list of contours defining the polygon area using the WindingPositive winding rule.

◆ toQVariant()

QVariantList SphericalTexturedPolygon::toQVariant ( ) const
overridevirtual

Serialize the region into a QVariant map matching the JSON format.

The format is:

["TEXTURED_POLYGON", [[[ra,dec], [ra,dec], [ra,dec], [ra,dec]], [[ra,dec], [ra,dec], [ra,dec]],[...]],
[[[u,v],[u,v],[u,v],[u,v]], [[u,v],[u,v],[u,v]], [...]]]

where the two lists are a list of closed contours, with each points defined by ra dec in degree in the ICRS frame followed by a list of texture coordinates in the u,v texture space (between 0 and 1). There must be one texture coordinate for each vertex.

Reimplemented from SphericalPolygon.