- Added new ShapeVectorToy to showcase the basic ShapeVector object

- Fixed radius calculation when resizing circular ShapeVector objects

engine/source/2d/sceneobject/ShapeVector.cc

@@ -1,785 +1,783 @@
-//-----------------------------------------------------------------------------
-// Copyright (c) 2013 GarageGames, LLC
-//
-// Permission is hereby granted, free of charge, to any person obtaining a copy
-// of this software and associated documentation files (the "Software"), to
-// deal in the Software without restriction, including without limitation the
-// rights to use, copy, modify, merge, publish, distribute, sublicense, and/or
-// sell copies of the Software, and to permit persons to whom the Software is
-// furnished to do so, subject to the following conditions:
-//
-// The above copyright notice and this permission notice shall be included in
-// all copies or substantial portions of the Software.
-//
-// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
-// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
-// IN THE SOFTWARE.
-//-----------------------------------------------------------------------------
-
-#include "graphics/dgl.h"
-#include "console/consoleTypes.h"
-#include "2d/core/Utility.h"
-#include "ShapeVector.h"
-
-// Script bindings.
-#include "ShapeVector_ScriptBinding.h"
-
-//----------------------------------------------------------------------------
-
-IMPLEMENT_CONOBJECT(ShapeVector);
-
-//----------------------------------------------------------------------------
-
-ShapeVector::ShapeVector() :
-    mLineColor(ColorF(1.0f,1.0f,1.0f,1.0f)),
-    mFillColor(ColorF(0.5f,0.5f,0.5f,1.0f)),
-    mFillMode(false),
-    mPolygonScale( 1.0f, 1.0f ),
-    mIsCircle(false),
-    mCircleRadius(1.0f),
-    mFlipX(false),
-    mFlipY(false)
-{
-    // Set Vector Associations.
-    VECTOR_SET_ASSOCIATION( mPolygonBasisList );
-    VECTOR_SET_ASSOCIATION( mPolygonLocalList );
-
-   // Use a static body by default.
-   mBodyDefinition.type = b2_staticBody;
-}
-
-//----------------------------------------------------------------------------
-
-ShapeVector::~ShapeVector()
-{
-}
-
-//----------------------------------------------------------------------------
-
-void ShapeVector::initPersistFields()
-{
-   addProtectedField("PolyList", TypePoint2FVector, Offset(mPolygonBasisList, ShapeVector), &setPolyList, &defaultProtectedGetFn, &writePolyList, "");
-   addProtectedField("LineColor", TypeColorF, Offset(mLineColor, ShapeVector), &setLineColor, &defaultProtectedGetFn, &writeLineColor, "");
-   addProtectedField("FillColor", TypeColorF, Offset(mFillColor, ShapeVector), &setFillColor, &defaultProtectedGetFn, &writeFillColor, "");
-   addProtectedField("FillMode", TypeBool, Offset(mFillMode, ShapeVector), &setFillMode, &defaultProtectedGetFn, &writeFillMode, "");
-   addProtectedField("IsCircle", TypeBool, Offset(mIsCircle, ShapeVector), &setIsCircle, &defaultProtectedGetFn, &writeIsCircle, "");
-   addProtectedField("CircleRadius", TypeF32, Offset(mCircleRadius, ShapeVector), &setCircleRadius, &defaultProtectedGetFn, &writeCircleRadius, "");
-
-   Parent::initPersistFields();
-}
-
-//----------------------------------------------------------------------------
-
-void ShapeVector::copyTo(SimObject* obj)
-{
-   Parent::copyTo(obj);
-
-   AssertFatal(dynamic_cast<ShapeVector*>(obj), "ShapeVector::copyTo() - Object is not the correct type.");
-   ShapeVector* object = static_cast<ShapeVector*>(obj);
-
-   // Copy fields
-   object->mFillMode = mFillMode;
-   object->mFillColor = mFillColor;
-   object->mLineColor = mLineColor;
-   object->mIsCircle = mIsCircle;
-   object->mCircleRadius = mCircleRadius;
-   object->mFlipX = mFlipX;
-   object->mFlipY = mFlipY;
-
-   if (getPolyVertexCount() > 0)
-       object->setPolyCustom(mPolygonBasisList.size(), getPoly());
-}
-
-//----------------------------------------------------------------------------
-
-bool ShapeVector::onAdd()
-{
-   // Call Parent.
-   if(!Parent::onAdd())
-      return false;
-
-   // Return Okay.
-   return true;
-}
-
-//----------------------------------------------------------------------------
-
-void ShapeVector::onRemove()
-{
-   // Call Parent.
-   Parent::onRemove();
-}
-
-//----------------------------------------------------------------------------
-
-void ShapeVector::sceneRender( const SceneRenderState* pSceneRenderState, const SceneRenderRequest* pSceneRenderRequest, BatchRender* pBatchRenderer )
-{
-    // Fetch Vertex Count.
-    const U32 vertexCount = mPolygonLocalList.size();
-
-    // Finish if not vertices.
-    if ( vertexCount == 0  && !mIsCircle)
-        return;
-
-    // Disable Texturing.
-    glDisable       ( GL_TEXTURE_2D );
-
-    // Save Model-view.
-    glMatrixMode(GL_MODELVIEW);
-    glPushMatrix();
-
-    // Fetch Position/Rotation.
-    const Vector2 position = getRenderPosition();
-
-    // Set Blend Options.
-    setBlendOptions();
-    
-    if (mIsCircle)
-    {
-        glRotatef( mRadToDeg(getRenderAngle()), 0.0f, 0.0f, 1.0f );
-        renderCircleShape(position, mCircleRadius);
-    }
-    else
-    {
-        // Move into Vector-Space.
-        glTranslatef( position.x, position.y, 0.0f );
-        glRotatef( mRadToDeg(getRenderAngle()), 0.0f, 0.0f, 1.0f );
-        renderPolygonShape(vertexCount);
-    }
-
-    // Restore Colour.
-    glColor4f( 1,1,1,1 );
-
-    // Restore Matrix.
-    glPopMatrix();
-}
-
-void ShapeVector::renderCircleShape(Vector2 position, F32 radius)
-{
-    if (mFillMode)
-    {
-        const float32 k_segments = 32.0f;
-        const float32 k_increment = 2.0f * b2_pi / k_segments;
-        float32 theta = 0.0f;
-
-        glEnable(GL_BLEND);
-        glBlendFunc (GL_SRC_ALPHA, GL_ONE_MINUS_SRC_ALPHA);
-        glColor4f(mFillColor.red, mFillColor.green, mFillColor.blue, mFillColor.alpha);
-
-        glBegin(GL_TRIANGLE_FAN);
-        for (int32 i = 0; i < k_segments; ++i)
-        {
-            Vector2 v = position + radius * Vector2(cosf(theta), sinf(theta));
-            glVertex2f(v.x, v.y);
-            theta += k_increment;
-        }
-        glEnd();
-
-        glDisable(GL_BLEND);
-
-        theta = 0.0f;
-        glColor4f(mLineColor.red, mLineColor.green, mLineColor.blue, 1.0f);
-        glBegin(GL_LINE_LOOP);
-        for (int32 i = 0; i < k_segments; ++i)
-        {
-            Vector2 v = position + radius * Vector2(cosf(theta), sinf(theta));
-            glVertex2f(v.x, v.y);
-            theta += k_increment;
-        }
-        glEnd();
-    }
-    else
-    {
-        const float32 k_segments = 36.0f;
-        const float32 k_increment = 2.0f * b2_pi / k_segments;
-        float32 theta = 0.0f;
-
-        glColor4f(mLineColor.red, mLineColor.green, mLineColor.blue, mLineColor.alpha);
-        
-        glBegin(GL_LINE_LOOP);
-        for (int32 i = 0; i < k_segments; ++i)
-        {
-            Vector2 v = position + radius * Vector2(cosf(theta), sinf(theta));
-            glVertex2f(v.x, v.y);
-            theta += k_increment;
-        }
-        glEnd();
-    }
-}
-
-void ShapeVector::renderPolygonShape(U32 vertexCount)
-{
-#ifdef TORQUE_OS_IOS
-    // Fill Mode?
-    if ( mFillMode )
-    {
-        // Yes, so set polygon mode to FILL.
-        //glPolygonMode( GL_FRONT_AND_BACK, GL_FILL );
-
-        // Set Fill Colour.
-        glColor4f( (GLfloat)mFillColor.red, (GLfloat)mFillColor.green, (GLfloat)mFillColor.blue, (GLfloat)mFillColor.alpha );
-
-        GLfloat vert1[] = {//get first vert and make triangles based off of this one
-            (GLfloat)(mPolygonLocalList[0].x),
-            (GLfloat)(mPolygonLocalList[0].y),
-        };
-        GLfloat prevVert[] = {
-            (GLfloat)(mPolygonLocalList[1].x),
-            (GLfloat)(mPolygonLocalList[1].y),
-        };
-        
-        
-        // Draw Object.
-            for ( U32 n = 2; n < vertexCount; n++ )
-            {
-                //glVertex2fv ( (GLfloat*)&(mPolygonLocalList[n]) );
-                GLfloat vertex[] = {
-                                    vert1[0], vert1[1],
-                                    (GLfloat)(mPolygonLocalList[n].x), (GLfloat)(mPolygonLocalList[n].y),
-                                    prevVert[0], prevVert[1],
-                };
-                
-                glVertexPointer(2, GL_FLOAT, 0, vertex );
-                glDrawArrays(GL_TRIANGLES, 0, 3 );
-                prevVert[0] = (GLfloat)(mPolygonLocalList[n].x);//save the current one's for nxt time
-                prevVert[1] = (GLfloat)(mPolygonLocalList[n].y);
-            }
-        //glDrawArrays(GL_TRIANGLES, 0, vertexCount);
-        //glEnd();
- 
-    }
-
-    // Set Line Colour.
-    glColor4f(mLineColor.red, mLineColor.green, mLineColor.blue, mLineColor.alpha );
-    
-        for ( U32 n = 1; n <= vertexCount; n++ )
-        {
-            GLfloat verts[] = {
-                (GLfloat)(mPolygonLocalList[n - 1].x),
-                (GLfloat)(mPolygonLocalList[n - 1].y),
-                (GLfloat)(mPolygonLocalList[n == vertexCount ? 0 : n].x),
-                (GLfloat)(mPolygonLocalList[n == vertexCount ? 0 : n].y),
-            };
-
-            glVertexPointer(2, GL_FLOAT, 0, verts );			
-            glDrawArrays(GL_LINE_LOOP, 0, 2);//draw last two
-        }
-
-#else
-    // Fill Mode?
-    if ( mFillMode )
-    {
-        // Yes, so set polygon mode to FILL.
-        glPolygonMode( GL_FRONT_AND_BACK, GL_FILL );
-
-        // Set Fill Colour.
-        glColor4fv( (GLfloat*)&mFillColor );
-
-        // Draw Object.
-        glBegin( GL_POLYGON );
-            for ( U32 n = 0; n < vertexCount; n++ )
-            {
-                glVertex2fv ( (GLfloat*)&(mPolygonLocalList[n]) );
-            }
-        glEnd();
-    }
-
-    // Set Line Colour.
-    glColor4fv( (GLfloat*)&mLineColor );
-
-    // Draw Object.
-    glBegin(GL_LINES);
-        for ( U32 n = 1; n <= vertexCount; n++ )
-        {
-            glVertex2fv ( (GLfloat*)&(mPolygonLocalList[n - 1]) );
-            glVertex2fv ( (GLfloat*)&(mPolygonLocalList[n == vertexCount ? 0 : n]) );
-        }
-    glEnd();
-
-#endif
-}
-
-//----------------------------------------------------------------------------
-
-void ShapeVector::setSize( const Vector2& size )
-{
-    Vector2 difference = size - mSize;
-
-    // Call Parent.
-    Parent::setSize( size );
-
-    if (mIsCircle)
-    {
-        F32 total = difference.x + difference.y;
-
-        mCircleRadius += total;
-    }
-    else
-    {
-        // Generate Local Polygon.
-        generateLocalPoly();
-    }
-}
-
-//----------------------------------------------------------------------------
-
-void ShapeVector::setPolyScale( const Vector2& scale )
-{
-    // Check Scales.
-    if ( scale.x <= 0.0f || scale.y <= 0.0f )
-    {
-        Con::warnf("ShapeVector::setPolyScale() - Polygon Scales must be greater than zero! '%g,%g'.", scale.x, scale.y);
-        return;
-    }
-    // Check Scales.
-    if ( scale.x > 1.0f || scale.y > 1.0f )
-    {
-        Con::warnf("ShapeVector::setPolyScale() - Polygon Scales cannot be greater than one! '%g,%g'.", scale.x, scale.y);
-        return;
-    }
-
-    // Set Polygon Scale.
-    mPolygonScale = scale;
-
-    // Generation Local Poly.
-    generateLocalPoly();
-}
-
-//----------------------------------------------------------------------------
-
-void ShapeVector::setPolyPrimitive( const U32 polyVertexCount )
-{
-    // Check it's not zero!
-    if ( polyVertexCount == 0 )
-    {
-        // Warn.
-        Con::warnf("ShapeVector::setPolyPrimitive() - Vertex count must be greater than zero!");
-        // Finish Here.
-        return;
-    }
-
-    // Clear Polygon List.
-    mPolygonBasisList.clear();
-    mPolygonBasisList.setSize( polyVertexCount );
-
-    // Point?
-    if ( polyVertexCount == 1 )
-    {
-        // Set Polygon Point.
-        mPolygonBasisList[0].Set(0.0f, 0.0f);
-    }
-    // Special-Case Quad?
-    else if ( polyVertexCount == 4 )
-    {
-        // Yes, so set Quad.
-        mPolygonBasisList[0].Set(-1.0f, -1.0f);
-        mPolygonBasisList[1].Set(+1.0f, -1.0f);
-        mPolygonBasisList[2].Set(+1.0f, +1.0f);
-        mPolygonBasisList[3].Set(-1.0f, +1.0f);
-    }
-    else
-    {
-        // No, so calculate Regular (Primitive) Polygon Stepping.
-        //
-        // NOTE:-   The polygon sits on an circle that subscribes the interior
-        //          of the collision box.
-        F32 angle = M_PI_F / polyVertexCount;
-        const F32 angleStep = M_2PI_F / polyVertexCount;
-
-        // Calculate Polygon.
-        for ( U32 n = 0; n < polyVertexCount; n++ )
-        {
-            // Calculate Angle.
-            angle += angleStep;
-            // Store Polygon Vertex.
-            mPolygonBasisList[n].Set(mCos(angle), mSin(angle));
-        }
-    }
-
-    // Generation Local Poly.
-    generateLocalPoly();
-}
-
-//----------------------------------------------------------------------------
-
-void ShapeVector::setPolyCustom( const U32 polyVertexCount, const char* pCustomPolygon )
-{
-    // Validate Polygon.
-    if ( polyVertexCount < 1 )
-    {
-        // Warn.
-        Con::warnf("ShapeVector::setPolyCustom() - Vertex count must be greater than zero!");
-        return;
-    }
-
-    // Fetch Custom Polygon Value Count.
-    const U32 customCount = Utility::mGetStringElementCount(pCustomPolygon);
-
-    // Validate Polygon Custom Length.
-    if ( customCount != polyVertexCount*2 )
-    {
-        // Warn.
-        Con::warnf("ShapeVector::setPolyCustom() - Invalid Custom Polygon Items '%d'; expected '%d'!", customCount, polyVertexCount*2 );
-        return;
-    }
-    
-    //// Validate Polygon Vertices.
-    //for ( U32 n = 0; n < customCount; n+=2 )
-    //{
-    //    // Fetch Coordinate.
-    //    const Vector2 coord = Utility::mGetStringElementVector(pCustomPolygon, n);
-    //    // Check Range.
-    //    if ( coord.x < -1.0f || coord.x > 1.0f || coord.y < -1.0f || coord.y > 1.0f )
-    //    {
-    //        // Warn.
-    //        Con::warnf("ShapeVector::setPolyCustom() - Invalid Polygon Coordinate range; Must be -1 to +1! '(%g,%g)'", coord.x, coord.y );
-    //        return;
-    //    }
-    //}
-
-    // Clear Polygon Basis List.
-    mPolygonBasisList.clear();
-    mPolygonBasisList.setSize( polyVertexCount );
-
-    // Validate Polygon Vertices.
-    for ( U32 n = 0; n < polyVertexCount; n++ )
-    {
-        // Fetch Coordinate.
-        const F32 x = dAtof(Utility::mGetStringElement(pCustomPolygon, n*2));
-        const F32 y = dAtof(Utility::mGetStringElement(pCustomPolygon, n*2+1));
-
-        // Store Polygon Vertex.
-        mPolygonBasisList[n].Set(x, y);
-    }
-
-    // Generation Local Poly.
-    generateLocalPoly();
-}
-
-//----------------------------------------------------------------------------
-
-const char* ShapeVector::getPoly( void )
-{
-    // Get Collision Polygon.
-    const Vector2* pPoly = (getPolyVertexCount() > 0) ? getPolyBasis() : NULL;
-
-    // Set Max Buffer Size.
-    const U32 maxBufferSize = getPolyVertexCount() * 18 + 1;
-
-    // Get Return Buffer.
-    char* pReturnBuffer = Con::getReturnBuffer( maxBufferSize );
-
-    // Check Buffer.
-    if( !pReturnBuffer )
-    {
-        // Warn.
-        Con::printf("ShapeVector::getPoly() - Unable to allocate buffer!");
-        // Exit.
-        return NULL;
-    }
-
-    // Set Buffer Counter.
-    U32 bufferCount = 0;
-
-    // Add Polygon Edges.
-    for ( U32 n = 0; n < getPolyVertexCount(); n++ )
-    {
-        // Output Object ID.
-        bufferCount += dSprintf( pReturnBuffer + bufferCount, maxBufferSize-bufferCount, "%0.5f %0.5f ", pPoly[n].x, pPoly[n].y );
-
-        // Finish early if we run out of buffer space.
-        if ( bufferCount >= maxBufferSize )
-        {
-            // Warn.
-            Con::warnf("ShapeVector::getPoly() - Error writing to buffer!");
-            break;
-        }
-    }
-
-    // Return Buffer.
-    return pReturnBuffer;
-}
-
-//----------------------------------------------------------------------------
-
-const char* ShapeVector::getWorldPoly( void )
-{
-    // Get the object space polygon
-    //const Vector2* pPoly = (getPolyVertexCount() > 0) ? getPolyBasis() : NULL;
-
-    // Set the max buffer size
-    const U32 maxBufferSize = getPolyVertexCount() * 18 + 1;
-
-    // Get the return buffer.
-    char* pReturnBuffer = Con::getReturnBuffer( maxBufferSize );
-
-    // Check the buffer.
-    if( !pReturnBuffer )
-    {
-        // Warn.
-        Con::printf("ShapeVector::getWorldPoly() - Unable to allocate buffer!");
-
-        // Exit.
-        return NULL;
-    }
-
-    // Set Buffer Counter.
-    U32 bufferCount = 0;
-
-    // Add Polygon Edges.
-    for ( U32 n = 0; n < getPolyVertexCount(); n++ )
-    {
-        // Convert the poly point to a world coordinate
-        Vector2 worldPoint = getWorldPoint(mPolygonLocalList[n]);
-
-        // Output the point
-        bufferCount += dSprintf( pReturnBuffer + bufferCount, maxBufferSize-bufferCount, "%0.5f %0.5f ", worldPoint.x, worldPoint.y );
-
-        // Finish early if we run out of buffer space.
-        if ( bufferCount >= maxBufferSize )
-        {
-            // Warn.
-            Con::warnf("ShapeVector::getWorldPoly() - Error writing to buffer!");
-            break;
-        }
-    }
-
-    // Return Buffer.
-    return pReturnBuffer;
-}
-
-//----------------------------------------------------------------------------
-
-void ShapeVector::generateLocalPoly( void )
-{
-    // Fetch Polygon Vertex Count.
-    const U32 polyVertexCount = mPolygonBasisList.size();
-
-    // Process Collision Polygon (if we've got one).
-    if ( polyVertexCount > 0 )
-    {
-        // Clear Polygon List.
-        mPolygonLocalList.clear();
-        mPolygonLocalList.setSize( polyVertexCount );
-
-        // Fetch Half Size.
-        const Vector2 halfSize = getHalfSize();
-
-        // Calculate Polygon Half-Size.
-        const Vector2 polyHalfSize( halfSize.x * mPolygonScale.x, halfSize.y * mPolygonScale.y );
-
-        // Scale/Orientate Polygon.
-        for ( U32 n = 0; n < polyVertexCount; n++ )
-        {
-            // Fetch Polygon Basis.
-            Vector2 polyVertex = mPolygonBasisList[n];
-            // Scale.
-            polyVertex.Set( polyVertex.x * mSize.x * (mFlipX ? -1.0f : 1.0f), 
-                            polyVertex.y * mSize.y * (mFlipY ? -1.0f : 1.0f));
-            // Set Vertex.
-            mPolygonLocalList[n] = polyVertex;
-        }
-    }
-}
-
-//----------------------------------------------------------------------------
-
-void ShapeVector::setLineColorString( const char* lineColour )
-{
-    // Calculate Element Count.
-    const U32 elementCount = Utility::mGetStringElementCount( lineColour );
-
-    // Check we've got enough arguments.
-    if ( elementCount < 3 )
-    {
-        Con::warnf("ShapeVector::setLineColourString() - Invalid Number of Elements! (%s)", lineColour);
-        return;
-    }
-
-    // Calculate Red, Green and Blue.
-    const F32 red   = dAtof(Utility::mGetStringElement( lineColour, 0 ));
-    const F32 green = dAtof(Utility::mGetStringElement( lineColour, 1 ));
-    const F32 blue  = dAtof(Utility::mGetStringElement( lineColour, 2 ));
-
-    // Set Alpha (if specified).
-    F32 alpha;
-    if ( elementCount >= 4 )
-        alpha = dAtof(Utility::mGetStringElement( lineColour, 3 ));
-    else alpha = 1.0f;
-
-    // Set Line Colour.
-    setLineColor( ColorF(red, green, blue, alpha) );
-}
-
-//----------------------------------------------------------------------------
-
-void ShapeVector::setLineColor( const ColorF& lineColour )
-{
-    // Set Line Colour.
-    mLineColor = lineColour;
-}
-
-//----------------------------------------------------------------------------
-
-const char* ShapeVector::getLineColor()
-{
-    // Get Return Buffer.
-    char* pReturnBuffer = Con::getReturnBuffer( 64 );
-    dSprintf( pReturnBuffer, 64, "%0.5f %0.5f %0.5f %0.5f", mLineColor.red, mLineColor.green,
-                                                            mLineColor.blue, mLineColor.alpha);
-    return pReturnBuffer;
-}
-
-//----------------------------------------------------------------------------
-
-void ShapeVector::setLineAlpha( const F32 alpha )
-{
-    // Set Line Alpha.
-    mLineColor.alpha = alpha;
-}
-
-//----------------------------------------------------------------------------
-
-void ShapeVector::setFillColorString( const char* fillColour )
-{
-    // Calculate Element Count.
-    const U32 elementCount = Utility::mGetStringElementCount( fillColour );
-
-    // Check we've got enough arguments.
-    if ( elementCount < 3 )
-    {
-        Con::warnf("ShapeVector::setFillColourString() - Invalid Number of Elements! (%s)", fillColour);
-        return;
-    }
-
-    // Calculate Red, Green and Blue.
-    const F32 red   = dAtof(Utility::mGetStringElement( fillColour, 0 ));
-    const F32 green = dAtof(Utility::mGetStringElement( fillColour, 1 ));
-    const F32 blue  = dAtof(Utility::mGetStringElement( fillColour, 2 ));
-
-    // Set Alpha (if specified).
-    F32 alpha;
-    if ( elementCount >= 4 )
-        alpha = dAtof(Utility::mGetStringElement( fillColour, 3 ));
-    else alpha = 1.0f;
-
-    // Set Fill Colour.
-    setFillColor( ColorF(red, green, blue, alpha) );
-}
-
-//----------------------------------------------------------------------------
-
-void ShapeVector::setFillColor( const ColorF& fillColour )
-{
-    // Set Fill Colour.
-    mFillColor = fillColour;
-}
-
-//----------------------------------------------------------------------------
-
-const char* ShapeVector::getFillColor()
-{
-    // Get Return Buffer.
-    char* pReturnBuffer = Con::getReturnBuffer( 64 );
-    dSprintf( pReturnBuffer, 64, "%0.5f %0.5f %0.5f %0.5f", mFillColor.red, mFillColor.green,
-                                                            mFillColor.blue, mFillColor.alpha);
-    return pReturnBuffer;
-}
-
-//----------------------------------------------------------------------------
-
-void ShapeVector::setFillAlpha( const F32 alpha )
-{
-    // Set Fill Alpha.
-    mFillColor.alpha = alpha;
-}
-
-//----------------------------------------------------------------------------
-
-void ShapeVector::setFillMode( const bool fillMode )
-{
-    // Set Fill Mode.
-    mFillMode = fillMode;
-}
-
-//----------------------------------------------------------------------------
-
-bool ShapeVector::getFillMode()
-{
-    return mFillMode;
-}
-
-//----------------------------------------------------------------------------
-
-void ShapeVector::setIsCircle( const bool isCircle )
-{
-    // Set Fill Mode.
-    mIsCircle = isCircle;
-}
-
-//----------------------------------------------------------------------------
-
-bool ShapeVector::getIsCircle()
-{
-    return mIsCircle;
-}
-
-//----------------------------------------------------------------------------
-
-void ShapeVector::setCircleRadius( const F32 circleRadius )
-{
-    // Set Fill Mode.
-    mCircleRadius = circleRadius;
-}
-
-//----------------------------------------------------------------------------
-
-F32 ShapeVector::getCircleRadius()
-{
-    return mCircleRadius;
-}
-
-//----------------------------------------------------------------------------
-
-Vector2 ShapeVector::getBoxFromPoints()
-{
-    Vector2 box(1.0f, 1.0f);
-
-     // Fetch Polygon Vertex Count.
-    const U32 polyVertexCount = mPolygonBasisList.size();
-
-    F32 minX = 0;
-    F32 minY = 0;
-    F32 maxX = 0;
-    F32 maxY = 0;
-
-    // Process Collision Polygon (if we've got one).
-    if ( polyVertexCount > 0 )
-    {
-        // Scale/Orientate Polygon.
-        for ( U32 n = 0; n < polyVertexCount; n++ )
-        {
-            // Fetch Polygon Basis.
-            Vector2 polyVertex = mPolygonBasisList[n];
-            
-            if (polyVertex.x > maxX)
-                maxX = polyVertex.x;
-            else if (polyVertex.x < minX)
-                minX = polyVertex.x;
-
-            if (polyVertex.y > maxY)
-                maxY = polyVertex.y;
-            else if (polyVertex.y < minY)
-                minY = polyVertex.y;
-        }
-    }
-
-    box.x = maxX - minX;
-    box.y = maxY - minY;
-
-    return box;
-}
+//-----------------------------------------------------------------------------
+// Copyright (c) 2013 GarageGames, LLC
+//
+// Permission is hereby granted, free of charge, to any person obtaining a copy
+// of this software and associated documentation files (the "Software"), to
+// deal in the Software without restriction, including without limitation the
+// rights to use, copy, modify, merge, publish, distribute, sublicense, and/or
+// sell copies of the Software, and to permit persons to whom the Software is
+// furnished to do so, subject to the following conditions:
+//
+// The above copyright notice and this permission notice shall be included in
+// all copies or substantial portions of the Software.
+//
+// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
+// IN THE SOFTWARE.
+//-----------------------------------------------------------------------------
+
+#include "graphics/dgl.h"
+#include "console/consoleTypes.h"
+#include "2d/core/Utility.h"
+#include "ShapeVector.h"
+
+// Script bindings.
+#include "ShapeVector_ScriptBinding.h"
+
+//----------------------------------------------------------------------------
+
+IMPLEMENT_CONOBJECT(ShapeVector);
+
+//----------------------------------------------------------------------------
+
+ShapeVector::ShapeVector() :
+    mLineColor(ColorF(1.0f,1.0f,1.0f,1.0f)),
+    mFillColor(ColorF(0.5f,0.5f,0.5f,1.0f)),
+    mFillMode(false),
+    mPolygonScale( 1.0f, 1.0f ),
+    mIsCircle(false),
+    mCircleRadius(1.0f),
+    mFlipX(false),
+    mFlipY(false)
+{
+    // Set Vector Associations.
+    VECTOR_SET_ASSOCIATION( mPolygonBasisList );
+    VECTOR_SET_ASSOCIATION( mPolygonLocalList );
+
+   // Use a static body by default.
+   mBodyDefinition.type = b2_staticBody;
+}
+
+//----------------------------------------------------------------------------
+
+ShapeVector::~ShapeVector()
+{
+}
+
+//----------------------------------------------------------------------------
+
+void ShapeVector::initPersistFields()
+{
+   addProtectedField("PolyList", TypePoint2FVector, Offset(mPolygonBasisList, ShapeVector), &setPolyList, &defaultProtectedGetFn, &writePolyList, "");
+   addProtectedField("LineColor", TypeColorF, Offset(mLineColor, ShapeVector), &setLineColor, &defaultProtectedGetFn, &writeLineColor, "");
+   addProtectedField("FillColor", TypeColorF, Offset(mFillColor, ShapeVector), &setFillColor, &defaultProtectedGetFn, &writeFillColor, "");
+   addProtectedField("FillMode", TypeBool, Offset(mFillMode, ShapeVector), &setFillMode, &defaultProtectedGetFn, &writeFillMode, "");
+   addProtectedField("IsCircle", TypeBool, Offset(mIsCircle, ShapeVector), &setIsCircle, &defaultProtectedGetFn, &writeIsCircle, "");
+   addProtectedField("CircleRadius", TypeF32, Offset(mCircleRadius, ShapeVector), &setCircleRadius, &defaultProtectedGetFn, &writeCircleRadius, "");
+
+   Parent::initPersistFields();
+}
+
+//----------------------------------------------------------------------------
+
+void ShapeVector::copyTo(SimObject* obj)
+{
+   Parent::copyTo(obj);
+
+   AssertFatal(dynamic_cast<ShapeVector*>(obj), "ShapeVector::copyTo() - Object is not the correct type.");
+   ShapeVector* object = static_cast<ShapeVector*>(obj);
+
+   // Copy fields
+   object->mFillMode = mFillMode;
+   object->mFillColor = mFillColor;
+   object->mLineColor = mLineColor;
+   object->mIsCircle = mIsCircle;
+   object->mCircleRadius = mCircleRadius;
+   object->mFlipX = mFlipX;
+   object->mFlipY = mFlipY;
+
+   if (getPolyVertexCount() > 0)
+       object->setPolyCustom(mPolygonBasisList.size(), getPoly());
+}
+
+//----------------------------------------------------------------------------
+
+bool ShapeVector::onAdd()
+{
+   // Call Parent.
+   if(!Parent::onAdd())
+      return false;
+
+   // Return Okay.
+   return true;
+}
+
+//----------------------------------------------------------------------------
+
+void ShapeVector::onRemove()
+{
+   // Call Parent.
+   Parent::onRemove();
+}
+
+//----------------------------------------------------------------------------
+
+void ShapeVector::sceneRender( const SceneRenderState* pSceneRenderState, const SceneRenderRequest* pSceneRenderRequest, BatchRender* pBatchRenderer )
+{
+    // Fetch Vertex Count.
+    const U32 vertexCount = mPolygonLocalList.size();
+
+    // Finish if not vertices.
+    if ( vertexCount == 0  && !mIsCircle)
+        return;
+
+    // Disable Texturing.
+    glDisable       ( GL_TEXTURE_2D );
+
+    // Save Model-view.
+    glMatrixMode(GL_MODELVIEW);
+    glPushMatrix();
+
+    // Fetch Position/Rotation.
+    const Vector2 position = getRenderPosition();
+
+    // Set Blend Options.
+    setBlendOptions();
+    
+    if (mIsCircle)
+    {
+        glRotatef( mRadToDeg(getRenderAngle()), 0.0f, 0.0f, 1.0f );
+        renderCircleShape(position, mCircleRadius);
+    }
+    else
+    {
+        // Move into Vector-Space.
+        glTranslatef( position.x, position.y, 0.0f );
+        glRotatef( mRadToDeg(getRenderAngle()), 0.0f, 0.0f, 1.0f );
+        renderPolygonShape(vertexCount);
+    }
+
+    // Restore Colour.
+    glColor4f( 1,1,1,1 );
+
+    // Restore Matrix.
+    glPopMatrix();
+}
+
+void ShapeVector::renderCircleShape(Vector2 position, F32 radius)
+{
+    if (mFillMode)
+    {
+        const float32 k_segments = 32.0f;
+        const float32 k_increment = 2.0f * b2_pi / k_segments;
+        float32 theta = 0.0f;
+
+        glEnable(GL_BLEND);
+        glBlendFunc (GL_SRC_ALPHA, GL_ONE_MINUS_SRC_ALPHA);
+        glColor4f(mFillColor.red, mFillColor.green, mFillColor.blue, mFillColor.alpha);
+
+        glBegin(GL_TRIANGLE_FAN);
+        for (int32 i = 0; i < k_segments; ++i)
+        {
+            Vector2 v = position + radius * Vector2(cosf(theta), sinf(theta));
+            glVertex2f(v.x, v.y);
+            theta += k_increment;
+        }
+        glEnd();
+
+        glDisable(GL_BLEND);
+
+        theta = 0.0f;
+        glColor4f(mLineColor.red, mLineColor.green, mLineColor.blue, 1.0f);
+        glBegin(GL_LINE_LOOP);
+        for (int32 i = 0; i < k_segments; ++i)
+        {
+            Vector2 v = position + radius * Vector2(cosf(theta), sinf(theta));
+            glVertex2f(v.x, v.y);
+            theta += k_increment;
+        }
+        glEnd();
+    }
+    else
+    {
+        const float32 k_segments = 36.0f;
+        const float32 k_increment = 2.0f * b2_pi / k_segments;
+        float32 theta = 0.0f;
+
+        glColor4f(mLineColor.red, mLineColor.green, mLineColor.blue, mLineColor.alpha);
+        
+        glBegin(GL_LINE_LOOP);
+        for (int32 i = 0; i < k_segments; ++i)
+        {
+            Vector2 v = position + radius * Vector2(cosf(theta), sinf(theta));
+            glVertex2f(v.x, v.y);
+            theta += k_increment;
+        }
+        glEnd();
+    }
+}
+
+void ShapeVector::renderPolygonShape(U32 vertexCount)
+{
+#ifdef TORQUE_OS_IOS
+    // Fill Mode?
+    if ( mFillMode )
+    {
+        // Yes, so set polygon mode to FILL.
+        //glPolygonMode( GL_FRONT_AND_BACK, GL_FILL );
+
+        // Set Fill Colour.
+        glColor4f( (GLfloat)mFillColor.red, (GLfloat)mFillColor.green, (GLfloat)mFillColor.blue, (GLfloat)mFillColor.alpha );
+
+        GLfloat vert1[] = {//get first vert and make triangles based off of this one
+            (GLfloat)(mPolygonLocalList[0].x),
+            (GLfloat)(mPolygonLocalList[0].y),
+        };
+        GLfloat prevVert[] = {
+            (GLfloat)(mPolygonLocalList[1].x),
+            (GLfloat)(mPolygonLocalList[1].y),
+        };
+        
+        
+        // Draw Object.
+            for ( U32 n = 2; n < vertexCount; n++ )
+            {
+                //glVertex2fv ( (GLfloat*)&(mPolygonLocalList[n]) );
+                GLfloat vertex[] = {
+                                    vert1[0], vert1[1],
+                                    (GLfloat)(mPolygonLocalList[n].x), (GLfloat)(mPolygonLocalList[n].y),
+                                    prevVert[0], prevVert[1],
+                };
+                
+                glVertexPointer(2, GL_FLOAT, 0, vertex );
+                glDrawArrays(GL_TRIANGLES, 0, 3 );
+                prevVert[0] = (GLfloat)(mPolygonLocalList[n].x);//save the current one's for nxt time
+                prevVert[1] = (GLfloat)(mPolygonLocalList[n].y);
+            }
+        //glDrawArrays(GL_TRIANGLES, 0, vertexCount);
+        //glEnd();
+ 
+    }
+
+    // Set Line Colour.
+    glColor4f(mLineColor.red, mLineColor.green, mLineColor.blue, mLineColor.alpha );
+    
+        for ( U32 n = 1; n <= vertexCount; n++ )
+        {
+            GLfloat verts[] = {
+                (GLfloat)(mPolygonLocalList[n - 1].x),
+                (GLfloat)(mPolygonLocalList[n - 1].y),
+                (GLfloat)(mPolygonLocalList[n == vertexCount ? 0 : n].x),
+                (GLfloat)(mPolygonLocalList[n == vertexCount ? 0 : n].y),
+            };
+
+            glVertexPointer(2, GL_FLOAT, 0, verts );			
+            glDrawArrays(GL_LINE_LOOP, 0, 2);//draw last two
+        }
+
+#else
+    // Fill Mode?
+    if ( mFillMode )
+    {
+        // Yes, so set polygon mode to FILL.
+        glPolygonMode( GL_FRONT_AND_BACK, GL_FILL );
+
+        // Set Fill Colour.
+        glColor4fv( (GLfloat*)&mFillColor );
+
+        // Draw Object.
+        glBegin( GL_POLYGON );
+            for ( U32 n = 0; n < vertexCount; n++ )
+            {
+                glVertex2fv ( (GLfloat*)&(mPolygonLocalList[n]) );
+            }
+        glEnd();
+    }
+
+    // Set Line Colour.
+    glColor4fv( (GLfloat*)&mLineColor );
+
+    // Draw Object.
+    glBegin(GL_LINES);
+        for ( U32 n = 1; n <= vertexCount; n++ )
+        {
+            glVertex2fv ( (GLfloat*)&(mPolygonLocalList[n - 1]) );
+            glVertex2fv ( (GLfloat*)&(mPolygonLocalList[n == vertexCount ? 0 : n]) );
+        }
+    glEnd();
+
+#endif
+}
+
+//----------------------------------------------------------------------------
+
+void ShapeVector::setSize( const Vector2& size )
+{
+    F32 xDifference = mSize.x / size.x;
+    
+    // Call Parent.
+    Parent::setSize( size );
+    
+    if (mIsCircle)
+    {
+        mCircleRadius /= xDifference;
+    }
+    else
+    {
+        // Generate Local Polygon.
+        generateLocalPoly();
+    }
+}
+
+//----------------------------------------------------------------------------
+
+void ShapeVector::setPolyScale( const Vector2& scale )
+{
+    // Check Scales.
+    if ( scale.x <= 0.0f || scale.y <= 0.0f )
+    {
+        Con::warnf("ShapeVector::setPolyScale() - Polygon Scales must be greater than zero! '%g,%g'.", scale.x, scale.y);
+        return;
+    }
+    // Check Scales.
+    if ( scale.x > 1.0f || scale.y > 1.0f )
+    {
+        Con::warnf("ShapeVector::setPolyScale() - Polygon Scales cannot be greater than one! '%g,%g'.", scale.x, scale.y);
+        return;
+    }
+
+    // Set Polygon Scale.
+    mPolygonScale = scale;
+
+    // Generation Local Poly.
+    generateLocalPoly();
+}
+
+//----------------------------------------------------------------------------
+
+void ShapeVector::setPolyPrimitive( const U32 polyVertexCount )
+{
+    // Check it's not zero!
+    if ( polyVertexCount == 0 )
+    {
+        // Warn.
+        Con::warnf("ShapeVector::setPolyPrimitive() - Vertex count must be greater than zero!");
+        // Finish Here.
+        return;
+    }
+
+    // Clear Polygon List.
+    mPolygonBasisList.clear();
+    mPolygonBasisList.setSize( polyVertexCount );
+
+    // Point?
+    if ( polyVertexCount == 1 )
+    {
+        // Set Polygon Point.
+        mPolygonBasisList[0].Set(0.0f, 0.0f);
+    }
+    // Special-Case Quad?
+    else if ( polyVertexCount == 4 )
+    {
+        // Yes, so set Quad.
+        mPolygonBasisList[0].Set(-1.0f, -1.0f);
+        mPolygonBasisList[1].Set(+1.0f, -1.0f);
+        mPolygonBasisList[2].Set(+1.0f, +1.0f);
+        mPolygonBasisList[3].Set(-1.0f, +1.0f);
+    }
+    else
+    {
+        // No, so calculate Regular (Primitive) Polygon Stepping.
+        //
+        // NOTE:-   The polygon sits on an circle that subscribes the interior
+        //          of the collision box.
+        F32 angle = M_PI_F / polyVertexCount;
+        const F32 angleStep = M_2PI_F / polyVertexCount;
+
+        // Calculate Polygon.
+        for ( U32 n = 0; n < polyVertexCount; n++ )
+        {
+            // Calculate Angle.
+            angle += angleStep;
+            // Store Polygon Vertex.
+            mPolygonBasisList[n].Set(mCos(angle), mSin(angle));
+        }
+    }
+
+    // Generation Local Poly.
+    generateLocalPoly();
+}
+
+//----------------------------------------------------------------------------
+
+void ShapeVector::setPolyCustom( const U32 polyVertexCount, const char* pCustomPolygon )
+{
+    // Validate Polygon.
+    if ( polyVertexCount < 1 )
+    {
+        // Warn.
+        Con::warnf("ShapeVector::setPolyCustom() - Vertex count must be greater than zero!");
+        return;
+    }
+
+    // Fetch Custom Polygon Value Count.
+    const U32 customCount = Utility::mGetStringElementCount(pCustomPolygon);
+
+    // Validate Polygon Custom Length.
+    if ( customCount != polyVertexCount*2 )
+    {
+        // Warn.
+        Con::warnf("ShapeVector::setPolyCustom() - Invalid Custom Polygon Items '%d'; expected '%d'!", customCount, polyVertexCount*2 );
+        return;
+    }
+    
+    //// Validate Polygon Vertices.
+    //for ( U32 n = 0; n < customCount; n+=2 )
+    //{
+    //    // Fetch Coordinate.
+    //    const Vector2 coord = Utility::mGetStringElementVector(pCustomPolygon, n);
+    //    // Check Range.
+    //    if ( coord.x < -1.0f || coord.x > 1.0f || coord.y < -1.0f || coord.y > 1.0f )
+    //    {
+    //        // Warn.
+    //        Con::warnf("ShapeVector::setPolyCustom() - Invalid Polygon Coordinate range; Must be -1 to +1! '(%g,%g)'", coord.x, coord.y );
+    //        return;
+    //    }
+    //}
+
+    // Clear Polygon Basis List.
+    mPolygonBasisList.clear();
+    mPolygonBasisList.setSize( polyVertexCount );
+
+    // Validate Polygon Vertices.
+    for ( U32 n = 0; n < polyVertexCount; n++ )
+    {
+        // Fetch Coordinate.
+        const F32 x = dAtof(Utility::mGetStringElement(pCustomPolygon, n*2));
+        const F32 y = dAtof(Utility::mGetStringElement(pCustomPolygon, n*2+1));
+
+        // Store Polygon Vertex.
+        mPolygonBasisList[n].Set(x, y);
+    }
+
+    // Generation Local Poly.
+    generateLocalPoly();
+}
+
+//----------------------------------------------------------------------------
+
+const char* ShapeVector::getPoly( void )
+{
+    // Get Collision Polygon.
+    const Vector2* pPoly = (getPolyVertexCount() > 0) ? getPolyBasis() : NULL;
+
+    // Set Max Buffer Size.
+    const U32 maxBufferSize = getPolyVertexCount() * 18 + 1;
+
+    // Get Return Buffer.
+    char* pReturnBuffer = Con::getReturnBuffer( maxBufferSize );
+
+    // Check Buffer.
+    if( !pReturnBuffer )
+    {
+        // Warn.
+        Con::printf("ShapeVector::getPoly() - Unable to allocate buffer!");
+        // Exit.
+        return NULL;
+    }
+
+    // Set Buffer Counter.
+    U32 bufferCount = 0;
+
+    // Add Polygon Edges.
+    for ( U32 n = 0; n < getPolyVertexCount(); n++ )
+    {
+        // Output Object ID.
+        bufferCount += dSprintf( pReturnBuffer + bufferCount, maxBufferSize-bufferCount, "%0.5f %0.5f ", pPoly[n].x, pPoly[n].y );
+
+        // Finish early if we run out of buffer space.
+        if ( bufferCount >= maxBufferSize )
+        {
+            // Warn.
+            Con::warnf("ShapeVector::getPoly() - Error writing to buffer!");
+            break;
+        }
+    }
+
+    // Return Buffer.
+    return pReturnBuffer;
+}
+
+//----------------------------------------------------------------------------
+
+const char* ShapeVector::getWorldPoly( void )
+{
+    // Get the object space polygon
+    //const Vector2* pPoly = (getPolyVertexCount() > 0) ? getPolyBasis() : NULL;
+
+    // Set the max buffer size
+    const U32 maxBufferSize = getPolyVertexCount() * 18 + 1;
+
+    // Get the return buffer.
+    char* pReturnBuffer = Con::getReturnBuffer( maxBufferSize );
+
+    // Check the buffer.
+    if( !pReturnBuffer )
+    {
+        // Warn.
+        Con::printf("ShapeVector::getWorldPoly() - Unable to allocate buffer!");
+
+        // Exit.
+        return NULL;
+    }
+
+    // Set Buffer Counter.
+    U32 bufferCount = 0;
+
+    // Add Polygon Edges.
+    for ( U32 n = 0; n < getPolyVertexCount(); n++ )
+    {
+        // Convert the poly point to a world coordinate
+        Vector2 worldPoint = getWorldPoint(mPolygonLocalList[n]);
+
+        // Output the point
+        bufferCount += dSprintf( pReturnBuffer + bufferCount, maxBufferSize-bufferCount, "%0.5f %0.5f ", worldPoint.x, worldPoint.y );
+
+        // Finish early if we run out of buffer space.
+        if ( bufferCount >= maxBufferSize )
+        {
+            // Warn.
+            Con::warnf("ShapeVector::getWorldPoly() - Error writing to buffer!");
+            break;
+        }
+    }
+
+    // Return Buffer.
+    return pReturnBuffer;
+}
+
+//----------------------------------------------------------------------------
+
+void ShapeVector::generateLocalPoly( void )
+{
+    // Fetch Polygon Vertex Count.
+    const U32 polyVertexCount = mPolygonBasisList.size();
+
+    // Process Collision Polygon (if we've got one).
+    if ( polyVertexCount > 0 )
+    {
+        // Clear Polygon List.
+        mPolygonLocalList.clear();
+        mPolygonLocalList.setSize( polyVertexCount );
+
+        // Fetch Half Size.
+        const Vector2 halfSize = getHalfSize();
+
+        // Calculate Polygon Half-Size.
+        const Vector2 polyHalfSize( halfSize.x * mPolygonScale.x, halfSize.y * mPolygonScale.y );
+
+        // Scale/Orientate Polygon.
+        for ( U32 n = 0; n < polyVertexCount; n++ )
+        {
+            // Fetch Polygon Basis.
+            Vector2 polyVertex = mPolygonBasisList[n];
+            // Scale.
+            polyVertex.Set( polyVertex.x * mSize.x * (mFlipX ? -1.0f : 1.0f), 
+                            polyVertex.y * mSize.y * (mFlipY ? -1.0f : 1.0f));
+            // Set Vertex.
+            mPolygonLocalList[n] = polyVertex;
+        }
+    }
+}
+
+//----------------------------------------------------------------------------
+
+void ShapeVector::setLineColorString( const char* lineColour )
+{
+    // Calculate Element Count.
+    const U32 elementCount = Utility::mGetStringElementCount( lineColour );
+
+    // Check we've got enough arguments.
+    if ( elementCount < 3 )
+    {
+        Con::warnf("ShapeVector::setLineColourString() - Invalid Number of Elements! (%s)", lineColour);
+        return;
+    }
+
+    // Calculate Red, Green and Blue.
+    const F32 red   = dAtof(Utility::mGetStringElement( lineColour, 0 ));
+    const F32 green = dAtof(Utility::mGetStringElement( lineColour, 1 ));
+    const F32 blue  = dAtof(Utility::mGetStringElement( lineColour, 2 ));
+
+    // Set Alpha (if specified).
+    F32 alpha;
+    if ( elementCount >= 4 )
+        alpha = dAtof(Utility::mGetStringElement( lineColour, 3 ));
+    else alpha = 1.0f;
+
+    // Set Line Colour.
+    setLineColor( ColorF(red, green, blue, alpha) );
+}
+
+//----------------------------------------------------------------------------
+
+void ShapeVector::setLineColor( const ColorF& lineColour )
+{
+    // Set Line Colour.
+    mLineColor = lineColour;
+}
+
+//----------------------------------------------------------------------------
+
+const char* ShapeVector::getLineColor()
+{
+    // Get Return Buffer.
+    char* pReturnBuffer = Con::getReturnBuffer( 64 );
+    dSprintf( pReturnBuffer, 64, "%0.5f %0.5f %0.5f %0.5f", mLineColor.red, mLineColor.green,
+                                                            mLineColor.blue, mLineColor.alpha);
+    return pReturnBuffer;
+}
+
+//----------------------------------------------------------------------------
+
+void ShapeVector::setLineAlpha( const F32 alpha )
+{
+    // Set Line Alpha.
+    mLineColor.alpha = alpha;
+}
+
+//----------------------------------------------------------------------------
+
+void ShapeVector::setFillColorString( const char* fillColour )
+{
+    // Calculate Element Count.
+    const U32 elementCount = Utility::mGetStringElementCount( fillColour );
+
+    // Check we've got enough arguments.
+    if ( elementCount < 3 )
+    {
+        Con::warnf("ShapeVector::setFillColourString() - Invalid Number of Elements! (%s)", fillColour);
+        return;
+    }
+
+    // Calculate Red, Green and Blue.
+    const F32 red   = dAtof(Utility::mGetStringElement( fillColour, 0 ));
+    const F32 green = dAtof(Utility::mGetStringElement( fillColour, 1 ));
+    const F32 blue  = dAtof(Utility::mGetStringElement( fillColour, 2 ));
+
+    // Set Alpha (if specified).
+    F32 alpha;
+    if ( elementCount >= 4 )
+        alpha = dAtof(Utility::mGetStringElement( fillColour, 3 ));
+    else alpha = 1.0f;
+
+    // Set Fill Colour.
+    setFillColor( ColorF(red, green, blue, alpha) );
+}
+
+//----------------------------------------------------------------------------
+
+void ShapeVector::setFillColor( const ColorF& fillColour )
+{
+    // Set Fill Colour.
+    mFillColor = fillColour;
+}
+
+//----------------------------------------------------------------------------
+
+const char* ShapeVector::getFillColor()
+{
+    // Get Return Buffer.
+    char* pReturnBuffer = Con::getReturnBuffer( 64 );
+    dSprintf( pReturnBuffer, 64, "%0.5f %0.5f %0.5f %0.5f", mFillColor.red, mFillColor.green,
+                                                            mFillColor.blue, mFillColor.alpha);
+    return pReturnBuffer;
+}
+
+//----------------------------------------------------------------------------
+
+void ShapeVector::setFillAlpha( const F32 alpha )
+{
+    // Set Fill Alpha.
+    mFillColor.alpha = alpha;
+}
+
+//----------------------------------------------------------------------------
+
+void ShapeVector::setFillMode( const bool fillMode )
+{
+    // Set Fill Mode.
+    mFillMode = fillMode;
+}
+
+//----------------------------------------------------------------------------
+
+bool ShapeVector::getFillMode()
+{
+    return mFillMode;
+}
+
+//----------------------------------------------------------------------------
+
+void ShapeVector::setIsCircle( const bool isCircle )
+{
+    // Set Fill Mode.
+    mIsCircle = isCircle;
+}
+
+//----------------------------------------------------------------------------
+
+bool ShapeVector::getIsCircle()
+{
+    return mIsCircle;
+}
+
+//----------------------------------------------------------------------------
+
+void ShapeVector::setCircleRadius( const F32 circleRadius )
+{
+    // Set Fill Mode.
+    mCircleRadius = circleRadius;
+}
+
+//----------------------------------------------------------------------------
+
+F32 ShapeVector::getCircleRadius()
+{
+    return mCircleRadius;
+}
+
+//----------------------------------------------------------------------------
+
+Vector2 ShapeVector::getBoxFromPoints()
+{
+    Vector2 box(1.0f, 1.0f);
+
+     // Fetch Polygon Vertex Count.
+    const U32 polyVertexCount = mPolygonBasisList.size();
+
+    F32 minX = 0;
+    F32 minY = 0;
+    F32 maxX = 0;
+    F32 maxY = 0;
+
+    // Process Collision Polygon (if we've got one).
+    if ( polyVertexCount > 0 )
+    {
+        // Scale/Orientate Polygon.
+        for ( U32 n = 0; n < polyVertexCount; n++ )
+        {
+            // Fetch Polygon Basis.
+            Vector2 polyVertex = mPolygonBasisList[n];
+            
+            if (polyVertex.x > maxX)
+                maxX = polyVertex.x;
+            else if (polyVertex.x < minX)
+                minX = polyVertex.x;
+
+            if (polyVertex.y > maxY)
+                maxY = polyVertex.y;
+            else if (polyVertex.y < minY)
+                minY = polyVertex.y;
+        }
+    }
+
+    box.x = maxX - minX;
+    box.y = maxY - minY;
+
+    return box;
+}

modules/ShapeVectorToy/1/main.cs

@@ -0,0 +1,141 @@
+//-----------------------------------------------------------------------------
+// Copyright (c) 2013 GarageGames, LLC
+//
+// Permission is hereby granted, free of charge, to any person obtaining a copy
+// of this software and associated documentation files (the "Software"), to
+// deal in the Software without restriction, including without limitation the
+// rights to use, copy, modify, merge, publish, distribute, sublicense, and/or
+// sell copies of the Software, and to permit persons to whom the Software is
+// furnished to do so, subject to the following conditions:
+//
+// The above copyright notice and this permission notice shall be included in
+// all copies or substantial portions of the Software.
+//
+// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
+// IN THE SOFTWARE.
+//-----------------------------------------------------------------------------
+
+function ShapeVectorToy::create( %this )
+{
+    // Set the sandbox drag mode availability.
+    Sandbox.allowManipulation(pan);
+    
+    // Set the manipulation mode.
+    Sandbox.useManipulation(pan);
+
+    // Set the toy properties
+
+    // Shape determines the poly points for the ShapeVector
+    // "Square": Simple box
+    // "Triangle": Equilateral triangle
+    // "Circle": Simple circle
+    // "Complexe":
+    ShapeVectorToy.shape = "Square";
+
+    // Toggles filling the shape with color or leaving as an outline
+    ShapeVectorToy.fillMode = true;
+
+    // Color of the filling
+    ShapeVectorToy.fillColor = "0.5 1 1 0.5";
+
+    // Color of the border lines
+    ShapeVectorToy.lineColor = "0.5 1 1 1";
+
+    // Add custom controls for toy
+    addSelectionOption("Square,Triangle,Circle,Complex", "Shape", 4, "setShape", true, "Selects the shape to add to the scene");
+    addFlagOption("Fill mode", "setFillMode", ShapeVectorToy.fillMode, true, "Whether new shapes are filled in or not");
+
+    // Reset the toy.
+    ShapeVectorToy.reset();
+}
+
+//-----------------------------------------------------------------------------
+
+function ShapeVectorToy::destroy( %this )
+{
+}
+
+//-----------------------------------------------------------------------------
+
+function ShapeVectorToy::reset( %this )
+{
+    // Clear the scene.
+    SandboxScene.clear();
+
+    // Add a single shape
+    %this.addShape();
+}
+
+//-----------------------------------------------------------------------------
+
+function ShapeVectorToy::setShape( %this, %value )
+{
+    %this.shape = %value;
+}
+
+//-----------------------------------------------------------------------------
+
+function ShapeVectorToy::setFillMode( %this, %value)
+{
+    %this.fillMode = %value;
+}
+
+//-----------------------------------------------------------------------------
+
+function ShapeVectorToy::generateShape( %this )
+{
+    // Start with default values
+    %points = "0 0 0 0 0 0";
+    %isCircle = false;
+    %radius = 0;
+    %size = "40";
+
+    // Create the poly point list based on the selected shape
+    switch$(%this.shape)
+    {
+        case "Square":
+            %points = "-0.5 -0.5 0.5 -0.5 0.5 0.5 -0.5 0.5";
+
+        case "Triangle":
+            %points = "-0.0025 0.5 0.5 -0.5 -0.5 -0.5";
+
+        case "Circle":
+            %radius = %size / 2;
+            %isCircle = true;
+
+        case "Complex":
+            %points = "-0.997 0.005 -0.737 -0.750 -0.010 -0.993 0.746 -0.750 0.997 0.005 0.742 0.740 0.005 0.998 -0.761 0.740";
+    }
+
+    // Create the shape vector
+    %shape = new ShapeVector()
+    {
+        position = "0 0";
+        size = %size;
+        LineColor = %this.lineColor;
+        FillColor = %this.fillColor;
+        FillMode = %this.fillMode;
+        PolyList = %points;
+        isCircle = %isCircle;
+        circleRadius = %radius;
+    };
+
+    // Return the shape to be added to the scene
+    return %shape;
+}
+
+//-----------------------------------------------------------------------------
+
+function ShapeVectorToy::addShape( %this )
+{
+    // Create the shape.
+    %object = %this.generateShape();
+
+    // Add the sprite to the scene.
+    SandboxScene.add( %object );    
+}

modules/ShapeVectorToy/1/module.taml

@@ -0,0 +1,10 @@
+<ModuleDefinition
+	ModuleId="ShapeVectorToy"
+	VersionId="1"
+	Description="Demonstrates creating a shape vector."
+	Dependencies="ToyAssets=1"
+	Type="toy"
+	ToyCategoryIndex="3"
+	ScriptFile="main.cs"
+	CreateFunction="create"
+	DestroyFunction="destroy"/>