OSDLPolygon.h

Go to the documentation of this file.

#ifndef OSDL_POLYGON_H_
#define OSDL_POLYGON_H_


#include "OSDLPixel.h"              // for Pixels::put, Pixels::Pixel

#include "Ceylan.h"                 // for TextDisplayable, AngleInDegrees

#include <string>
#include <list>




namespace OSDL
{

    
    namespace Video
    {


        // Polygons are drawn to surfaces.
        class Surface ;
                
        
        namespace TwoDimensional
        {
        
        
            // Polygons are made from 2D points .
            class Point2D ;
                
                
            typedef std::list<Point2D *> listPoint2D ;
                
            
            /*
             * Methods could be inlined in a dedicated file for faster
             * processing.
             *
             */
    
    
            OSDL_DLL bool drawPie( Surface & targetSurface, 
                Coordinate xCenter, Coordinate yCenter, Length radius, 
                Ceylan::Maths::AngleInDegrees angleStart,
                Ceylan::Maths::AngleInDegrees angleStop,
                Pixels::ColorElement red, Pixels::ColorElement green, 
                Pixels::ColorElement blue, 
                Pixels::ColorElement alpha = Pixels::AlphaOpaque ) throw() ;
    
    
            OSDL_DLL bool drawPie( Surface & targetSurface, 
                Coordinate xCenter, Coordinate yCenter, Length radius, 
                Ceylan::Maths::AngleInDegrees angleStart,
                Ceylan::Maths::AngleInDegrees angleStop, 
                Pixels::ColorDefinition colorDef ) throw() ;
    
    

            OSDL_DLL bool drawTriangle( Surface & targetSurface, 
                Coordinate x1, Coordinate y1, 
                Coordinate x2, Coordinate y2, 
                Coordinate x3, Coordinate y3, 
                Pixels::ColorElement red, Pixels::ColorElement green, 
                Pixels::ColorElement blue, 
                Pixels::ColorElement alpha = Pixels::AlphaOpaque,
                bool filled = true ) throw() ;


            OSDL_DLL bool drawTriangle( Surface & targetSurface, 
                Coordinate x1, Coordinate y1, 
                Coordinate x2, Coordinate y2, 
                Coordinate x3, Coordinate y3, 
                Pixels::ColorDefinition colorDef, bool filled = true ) 
                    throw() ;
    

            OSDL_DLL bool drawTriangle( Surface & targetSurface, 
                const Point2D & p1, const Point2D & p2, const Point2D & p3,
                Pixels::ColorElement red, Pixels::ColorElement green, 
                Pixels::ColorElement blue, 
                Pixels::ColorElement alpha = Pixels::AlphaOpaque,
                bool filled = true ) throw() ;


            OSDL_DLL bool drawTriangle( Surface & targetSurface, 
                const Point2D & p1, const Point2D & p2, const Point2D & p3,
                Pixels::ColorDefinition colorDef, bool filled = true ) throw() ;
    


            OSDL_DLL bool drawPolygon( Surface & targetSurface, 
                const listPoint2D & summits,
                Coordinate x, Coordinate y,
                Pixels::ColorElement red, Pixels::ColorElement green, 
                Pixels::ColorElement blue, 
                Pixels::ColorElement alpha = Pixels::AlphaOpaque,
                bool filled = true ) throw() ;              



            OSDL_DLL bool drawPolygon( Surface & targetSurface, 
                const listPoint2D & summits,
                Coordinate x, Coordinate y,
                Pixels::ColorDefinition colorDef, bool filled = true ) throw() ;
                
                 
            
            class OSDL_DLL Polygon : public Ceylan::Locatable2D
            {
            
                public:
                
                
                    explicit Polygon( listPoint2D & summits, 
                        bool listOwner = false ) throw() ;
                    
            
                    virtual ~Polygon() throw() ;
                    
                    
                    
                    virtual bool draw( Surface & targetSurface,
                            Pixels::ColorDefinition colorDef = Pixels::White, 
                            bool filled = true )
                        const throw() ;
                        
                    
                    virtual listPoint2D & getPoints() const throw() ;
                        
                        
                    virtual void setPoints( listPoint2D & newList ) throw() ;
                    
                    
                        
                    virtual bool isListOwner() const throw() ;
                                        
                        
                    virtual const std::string toString( 
                            Ceylan::VerbosityLevels level = Ceylan::high ) 
                        const throw() ;
                    
                    
                    
                    
                    // Static section.
                    
                    
                    
                    static Polygon & CreateFlakeBranch( 
                        Length length = 200,
                        Length thickness = 20, 
                        Ceylan::Maths::AngleInDegrees childAngle = 50, 
                        Ceylan::Maths::Ratio branchingHeightRatio = 0.7, 
                        Ceylan::Maths::Ratio scale = 0.3 ) throw() ;
                    
                    
                    static listPoint2D & Duplicate( const listPoint2D & source )
                        throw() ;
    
    
                    static void Delete( listPoint2D & listToBeDeleted ) 
                        throw() ;
                    
                    
                    
                    static listPoint2D & Append( listPoint2D & toBeAugmented, 
                        const listPoint2D & toAppend ) throw() ;
                        
                        
                    static listPoint2D & Apply( 
                        const Ceylan::Maths::Linear::HomogeneousMatrix3 
                            & transformation,
                        listPoint2D & sourceList ) throw() ;
                        
                    
                    
                    
                private:
            
                
/* 
 * Takes care of the awful issue of Windows DLL with templates.
 *
 * @see Ceylan's developer guide and README-build-for-windows.txt 
 * to understand it, and to be aware of the associated risks. 
 * 
 */
#pragma warning( push )
#pragma warning( disable : 4251 )

                    listPoint2D * _summits ;

#pragma warning( pop ) 
            
                    
                    bool _listOwner ;
                    
                
                
                    explicit Polygon( const Polygon & source ) throw() ;
                    
                    
            
                    Polygon & operator = ( const Polygon & source ) throw() ;

                    
            } ;
            




            class OSDL_DLL PolygonSet : public Ceylan::Locatable2D
            {
            
            
                public:
                
                
                                        
                     explicit PolygonSet( bool listOwner = false ) throw() ;
                     
                     
                    explicit PolygonSet( 
                        std::list<listPoint2D *> & polygonList, 
                        bool listOwner = false ) throw() ;
                    
            
                    virtual ~PolygonSet() throw() ;
                    
                    
                    
                    virtual void addPointsOf( Polygon & newPolygon ) throw() ;
                    
                    
                    
                    virtual void addPointList( listPoint2D & listToAdd ) 
                        throw() ;
                    
                    
                    virtual bool draw( Surface & targetSurface,
                        Coordinate x, Coordinate y,
                        Pixels::ColorDefinition colorDef = Pixels::White, 
                        bool filled = true )
                            const throw() ;
    
                        
                    virtual const std::string toString( 
                            Ceylan::VerbosityLevels level = Ceylan::high ) 
                        const throw() ;
                    
                    
                    
                    // Static section.
                    
                    
                    static PolygonSet & CreateFlake( 
                        Ceylan::Uint8 branchCount = 5, 
                        Length length = 200, Length thickness = 20, 
                        Ceylan::Maths::AngleInDegrees childAngle = 50, 
                        Ceylan::Maths::Ratio branchingHeightRatio = 0.7, 
                        Ceylan::Maths::Ratio scale = 0.3 )
                            throw() ;
                    
                
                        
                protected:

                
/* 
 * Takes care of the awful issue of Windows DLL with templates.
 *
 * @see Ceylan's developer guide and README-build-for-windows.txt 
 * to understand it, and to be aware of the associated risks. 
 * 
 */
#pragma warning( push )
#pragma warning( disable : 4251 )
                
                    std::list<listPoint2D *> * _polygonList ;
            
#pragma warning( pop ) 

            
                    bool _listOwner ;
                    
                    
                    
                private:
                
                
                    explicit PolygonSet( const PolygonSet & source ) throw() ;
                    
                    
                    PolygonSet & operator = ( const PolygonSet & source )
                        throw() ;
                        
                    
            } ;         
                 
        }
        
    }
    
}


#endif // OSDL_POLYGON_H_

---