axmol/Box2D/Common/b2Draw.h

/*
* Copyright (c) 2011 Erin Catto http://box2d.org
*
* This software is provided 'as-is', without any express or implied
* warranty.  In no event will the authors be held liable for any damages
* arising from the use of this software.
* Permission is granted to anyone to use this software for any purpose,
* including commercial applications, and to alter it and redistribute it
* freely, subject to the following restrictions:
* 1. The origin of this software must not be misrepresented; you must not
* claim that you wrote the original software. If you use this software
* in a product, an acknowledgment in the product documentation would be
* appreciated but is not required.
* 2. Altered source versions must be plainly marked as such, and must not be
* misrepresented as being the original software.
* 3. This notice may not be removed or altered from any source distribution.
*/

#include <Box2D/Common/b2Math.h>

/// Color for debug drawing. Each value has the range [0,1].
struct b2Color
{
    b2Color() {}
    b2Color(float32 r, float32 g, float32 b) : r(r), g(g), b(b) {}
    void Set(float32 ri, float32 gi, float32 bi) { r = ri; g = gi; b = bi; }
    float32 r, g, b;
};

/// Implement and register this class with a b2World to provide debug drawing of physics
/// entities in your game.
class b2Draw
{
public:
    b2Draw();

    virtual ~b2Draw() {}

    enum
    {
        e_shapeBit                = 0x0001,    ///< draw shapes
        e_jointBit                = 0x0002,    ///< draw joint connections
        e_aabbBit                = 0x0004,    ///< draw axis aligned bounding boxes
        e_pairBit                = 0x0008,    ///< draw broad-phase pairs
        e_centerOfMassBit        = 0x0010    ///< draw center of mass frame
    };

    /// Set the drawing flags.
    void SetFlags(uint32 flags);

    /// Get the drawing flags.
    uint32 GetFlags() const;
    
    /// Append flags to the current flags.
    void AppendFlags(uint32 flags);

    /// Clear flags from the current flags.
    void ClearFlags(uint32 flags);

    /// Draw a closed polygon provided in CCW order.
    virtual void DrawPolygon(const b2Vec2* vertices, int32 vertexCount, const b2Color& color) = 0;

    /// Draw a solid closed polygon provided in CCW order.
    virtual void DrawSolidPolygon(const b2Vec2* vertices, int32 vertexCount, const b2Color& color) = 0;

    /// Draw a circle.
    virtual void DrawCircle(const b2Vec2& center, float32 radius, const b2Color& color) = 0;
    
    /// Draw a solid circle.
    virtual void DrawSolidCircle(const b2Vec2& center, float32 radius, const b2Vec2& axis, const b2Color& color) = 0;
    
    /// Draw a line segment.
    virtual void DrawSegment(const b2Vec2& p1, const b2Vec2& p2, const b2Color& color) = 0;

    /// Draw a transform. Choose your own length scale.
    /// @param xf a transform.
    virtual void DrawTransform(const b2Transform& xf) = 0;

protected:
    uint32 m_drawFlags;
};