VectorGraphics.cpp

Go to the documentation of this file.

/**************************************************************************************/
/*                                                                                    */
/*  Visualization Library                                                             */
/*  http://visualizationlibrary.org                                                   */
/*                                                                                    */
/*  Copyright (c) 2005-2020, Michele Bosi                                             */
/*  All rights reserved.                                                              */
/*                                                                                    */
/*  Redistribution and use in source and binary forms, with or without modification,  */
/*  are permitted provided that the following conditions are met:                     */
/*                                                                                    */
/*  - Redistributions of source code must retain the above copyright notice, this     */
/*  list of conditions and the following disclaimer.                                  */
/*                                                                                    */
/*  - Redistributions in binary form must reproduce the above copyright notice, this  */
/*  list of conditions and the following disclaimer in the documentation and/or       */
/*  other materials provided with the distribution.                                   */
/*                                                                                    */
/*  THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND   */
/*  ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED     */
/*  WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE            */
/*  DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR  */
/*  ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES    */
/*  (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;      */
/*  LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON    */
/*  ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT           */
/*  (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS     */
/*  SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.                      */
/*                                                                                    */
/**************************************************************************************/

#include <vlVG/VectorGraphics.hpp>

using namespace vl;

//-----------------------------------------------------------------------------
VectorGraphics::VectorGraphics()
{
  mDefaultEffect = new Effect;
  mDefaultEffect->shader()->enable(EN_BLEND);
  mActors.setAutomaticDelete(false);
}
//-----------------------------------------------------------------------------
Actor* VectorGraphics::drawLine(double x1, double y1, double x2, double y2)
{
  std::vector<dvec2> ln;
  ln.push_back(dvec2(x1,y1));
  ln.push_back(dvec2(x2,y2));
  return drawLines(ln);
}
//-----------------------------------------------------------------------------
Actor* VectorGraphics::drawLines(const std::vector<dvec2>& ln)
{
  // fill the vertex position array
  ref<Geometry> geom = prepareGeometry(ln);
  // generate texture coords
  if (mState.mImage)
  {
    ref<ArrayFloat2> tex_array = new ArrayFloat2;
    tex_array->resize(geom->vertexArray()->size());
    float u1 = 1.0f / mState.mImage->width() * 0.5f;
    float u2 = 1.0f - 1.0f / mState.mImage->width() * 0.5f;
    for(size_t i=0; i<tex_array->size(); i+=2)
    {
      tex_array->at(i+0) = fvec2(u1, 0);
      tex_array->at(i+1) = fvec2(u2, 0);
    }
    // generate geometry
    geom->setTexCoordArray(0, tex_array.get());
  }
  // issue the primitive
  geom->drawCalls().push_back( new DrawArrays(PT_LINES, 0, (int)ln.size()) );
  // add the actor
  return addActor( new Actor(geom.get(), currentEffect(), NULL) );
}
//-----------------------------------------------------------------------------
Actor* VectorGraphics::drawLineStrip(const std::vector<dvec2>& ln)
{
  // fill the vertex position array
  ref<Geometry> geom = prepareGeometry(ln);
  // generate texture coords
  generateLinearTexCoords(geom.get());
  // issue the primitive
  geom->drawCalls().push_back( new DrawArrays(PT_LINE_STRIP, 0, (int)ln.size()) );
  // add the actor
  return addActor( new Actor(geom.get(), currentEffect(), NULL) );
}
//-----------------------------------------------------------------------------
Actor* VectorGraphics::drawLineLoop(const std::vector<dvec2>& ln)
{
  // fill the vertex position array
  ref<Geometry> geom = prepareGeometry(ln);
  // generate texture coords
  generateLinearTexCoords(geom.get());
  // issue the primitive
  geom->drawCalls().push_back( new DrawArrays(PT_LINE_LOOP, 0, (int)ln.size()) );
  // add the actor
  return addActor( new Actor(geom.get(), currentEffect(), NULL) );
}
//-----------------------------------------------------------------------------
Actor* VectorGraphics::fillPolygon(const std::vector<dvec2>& poly)
{
  // fill the vertex position array
  ref<Geometry> geom = prepareGeometryPolyToTriangles(poly);
  // generate texture coords
  generatePlanarTexCoords(geom.get(), poly);
  // issue the primitive
  geom->drawCalls().push_back( new DrawArrays(PT_TRIANGLES, 0, (int)geom->vertexArray()->size()) );
  // add the actor
  return addActor( new Actor(geom.get(), currentEffect(), NULL) );
}
//-----------------------------------------------------------------------------
Actor* VectorGraphics::fillTriangles(const std::vector<dvec2>& triangles)
{
  // fill the vertex position array
  ref<Geometry> geom = prepareGeometry(triangles);
  // generate texture coords
  generatePlanarTexCoords(geom.get(), triangles);
  // issue the primitive
  geom->drawCalls().push_back( new DrawArrays(PT_TRIANGLES, 0, (int)triangles.size()) );
  // add the actor
  return addActor( new Actor(geom.get(), currentEffect(), NULL) );
}
//-----------------------------------------------------------------------------
Actor* VectorGraphics::fillTriangleFan(const std::vector<dvec2>& fan)
{
  // fill the vertex position array
  ref<Geometry> geom = prepareGeometry(fan);
  // generate texture coords
  generatePlanarTexCoords(geom.get(), fan);
  // issue the primitive
  geom->drawCalls().push_back( new DrawArrays(PT_TRIANGLE_FAN, 0, (int)fan.size()) );
  // add the actor
  return addActor( new Actor(geom.get(), currentEffect(), NULL) );
}
//-----------------------------------------------------------------------------
Actor* VectorGraphics::fillTriangleStrip(const std::vector<dvec2>& strip)
{
  // fill the vertex position array
  ref<Geometry> geom = prepareGeometry(strip);
  // generate texture coords
  generatePlanarTexCoords(geom.get(), strip);
  // issue the primitive
  geom->drawCalls().push_back( new DrawArrays(PT_TRIANGLE_STRIP, 0, (int)strip.size()) );
  // add the actor
  return addActor( new Actor(geom.get(), currentEffect(), NULL) );
}
//-----------------------------------------------------------------------------
Actor* VectorGraphics::fillQuads(const std::vector<dvec2>& quads)
{
  // fill the vertex position array
  ref<Geometry> geom = prepareGeometry(quads);
  // generate texture coords
  generateQuadsTexCoords(geom.get(), quads);
  // issue the primitive
  geom->drawCalls().push_back( new DrawArrays(PT_QUADS, 0, (int)quads.size()) );
  // add the actor
  return addActor( new Actor(geom.get(), currentEffect(), NULL) );
}
//-----------------------------------------------------------------------------
Actor* VectorGraphics::fillQuadStrip(const std::vector<dvec2>& quad_strip)
{
  // fill the vertex position array
  ref<Geometry> geom = prepareGeometry(quad_strip);
  // generate texture coords
  generatePlanarTexCoords(geom.get(), quad_strip);
  // issue the primitive
  geom->drawCalls().push_back( new DrawArrays(PT_QUAD_STRIP, 0, (int)quad_strip.size()) );
  // add the actor
  return addActor( new Actor(geom.get(), currentEffect(), NULL) );
}
//-----------------------------------------------------------------------------
Actor* VectorGraphics::drawPoint(double x, double y)
{
  std::vector<dvec2> pt;
  pt.push_back(dvec2(x,y));
  return drawPoints(pt);
}
//-----------------------------------------------------------------------------
Actor* VectorGraphics::drawPoints(const std::vector<dvec2>& pt)
{
  // transform the points
  ref<ArrayFloat3> pos_array = new ArrayFloat3;
  pos_array->resize(pt.size());
  // transform done using high precision
  for(unsigned i=0; i<pt.size(); ++i)
  {
    pos_array->at(i) = (fvec3)(matrix() * dvec3(pt[i].x(), pt[i].y(), 0));
    // needed for pixel/perfect rendering
    if (mState.mPointSize % 2 == 0)
    {
      pos_array->at(i).s() += 0.5;
      pos_array->at(i).t() += 0.5;
    }
  }
  // generate geometry
  ref< Geometry > geom = new Geometry;
  geom->setVertexArray(pos_array.get());
  geom->drawCalls().push_back( new DrawArrays(PT_POINTS, 0, (int)pos_array->size()) );
  // add the actor
  return addActor( new Actor(geom.get(), currentEffect(), NULL) );
}
//-----------------------------------------------------------------------------
Actor* VectorGraphics::drawEllipse(double origx, double origy, double xaxis, double yaxis, int segments)
{
  std::vector<dvec2> points;
  points.resize(segments);
  for(int i=0; i<segments; ++i)
  {
    double t = (double)i/(segments-1) * dPi * 2.0 + dPi * 0.5;
    points[i] = dvec2(cos(t)*xaxis*0.5+origx, sin(t)*yaxis*0.5+origy);
  }
  return drawLineStrip(points);
}
//-----------------------------------------------------------------------------
Actor* VectorGraphics::fillEllipse(double origx, double origy, double xaxis, double yaxis, int segments)
{
  std::vector<dvec2> points;
  points.resize(segments);
  for(int i=0; i<segments; ++i)
  {
    double t = (double)i/segments * dPi * 2.0 + dPi * 0.5;
    points[i] = dvec2(cos(t)*xaxis*0.5+origx, sin(t)*yaxis*0.5+origy);
  }
  return fillPolygon(points);
}
//-----------------------------------------------------------------------------
Actor* VectorGraphics::drawQuad(double left, double bottom, double right, double top)
{
  std::vector<dvec2> quad;
  quad.push_back(dvec2(left,bottom));
  quad.push_back(dvec2(left,top));
  quad.push_back(dvec2(right,top));
  quad.push_back(dvec2(right,bottom));
  return drawLineLoop(quad);
}
//-----------------------------------------------------------------------------
Actor* VectorGraphics::fillQuad(double left, double bottom, double right, double top)
{
  std::vector<dvec2> quad;
  quad.push_back(dvec2(left,bottom));
  quad.push_back(dvec2(left,top));
  quad.push_back(dvec2(right,top));
  quad.push_back(dvec2(right,bottom));
  // fill the vertex position array
  ref<Geometry> geom = prepareGeometry(quad);
  // generate texture coords
  generateQuadsTexCoords(geom.get(), quad);
  // issue the primitive
  geom->drawCalls().push_back( new DrawArrays(PT_TRIANGLE_FAN, 0, (int)quad.size()) );
  // add the actor
  return addActor( new Actor(geom.get(), currentEffect(), NULL) );
}
//-----------------------------------------------------------------------------
void VectorGraphics::continueDrawing()
{
  /*mActors.clear();*/ // keep the currently drawn actors

  /*mVGToEffectMap.clear();*/      // keeps cached resources
  /*mImageToTextureMap.clear();*/  // keeps cached resources
  /*mRectToScissorMap.clear();*/   // keeps cached resources

  // restore the default states
  mState  = State();
  mMatrix = dmat4();
  mMatrixStack.clear();
  mStateStack.clear();
}
//-----------------------------------------------------------------------------
void VectorGraphics::endDrawing(bool release_cache)
{
  if (release_cache)
  {
    mVGToEffectMap.clear();
    mImageToTextureMap.clear();
    mRectToScissorMap.clear();
  }
  /*mState  = State();
  mMatrix = dmat4();*/
  mMatrixStack.clear();
  mStateStack.clear();
}
//-----------------------------------------------------------------------------
void VectorGraphics::clear()
{
  // remove all the actors
  mActors.clear();

  // reset everything
  mVGToEffectMap.clear();
  mImageToTextureMap.clear();
  mRectToScissorMap.clear();

  // restore the default states
  mState  = State();
  mMatrix = dmat4();
  mMatrixStack.clear();
  mStateStack.clear();
}
//-----------------------------------------------------------------------------
void VectorGraphics::setLineStipple(ELineStipple stipple)
{
  switch(stipple)
  {
    case LineStipple_Solid: mState.mLineStipple = 0xFFFF; break;
    case LineStipple_Dot:   mState.mLineStipple = 0xAAAA; break;
    case LineStipple_Dash:  mState.mLineStipple = 0xCCCC; break;
    case LineStipple_Dash4: mState.mLineStipple = 0xF0F0; break;
    case LineStipple_Dash8: mState.mLineStipple = 0xFF00; break;
    case LineStipple_DashDot: mState.mLineStipple = 0xF840; break;
    case LineStipple_DashDotDot: mState.mLineStipple = 0xF888; break;
  }
}
//-----------------------------------------------------------------------------
void VectorGraphics::setPolygonStipple(EPolygonStipple stipple)
{
  unsigned char solid_stipple[] = {
    0xFF,0xFF,0xFF,0xFF, 0xFF,0xFF,0xFF,0xFF, 0xFF,0xFF,0xFF,0xFF, 0xFF,0xFF,0xFF,0xFF,
    0xFF,0xFF,0xFF,0xFF, 0xFF,0xFF,0xFF,0xFF, 0xFF,0xFF,0xFF,0xFF, 0xFF,0xFF,0xFF,0xFF,
    0xFF,0xFF,0xFF,0xFF, 0xFF,0xFF,0xFF,0xFF, 0xFF,0xFF,0xFF,0xFF, 0xFF,0xFF,0xFF,0xFF,
    0xFF,0xFF,0xFF,0xFF, 0xFF,0xFF,0xFF,0xFF, 0xFF,0xFF,0xFF,0xFF, 0xFF,0xFF,0xFF,0xFF,
    0xFF,0xFF,0xFF,0xFF, 0xFF,0xFF,0xFF,0xFF, 0xFF,0xFF,0xFF,0xFF, 0xFF,0xFF,0xFF,0xFF,
    0xFF,0xFF,0xFF,0xFF, 0xFF,0xFF,0xFF,0xFF, 0xFF,0xFF,0xFF,0xFF, 0xFF,0xFF,0xFF,0xFF,
    0xFF,0xFF,0xFF,0xFF, 0xFF,0xFF,0xFF,0xFF, 0xFF,0xFF,0xFF,0xFF, 0xFF,0xFF,0xFF,0xFF,
    0xFF,0xFF,0xFF,0xFF, 0xFF,0xFF,0xFF,0xFF, 0xFF,0xFF,0xFF,0xFF, 0xFF,0xFF,0xFF,0xFF };
  unsigned char hline_stipple[] = {
    0xFF,0xFF,0xFF,0xFF, 0x00,0x00,0x00,0x00, 0xFF,0xFF,0xFF,0xFF, 0x00,0x00,0x00,0x00,
    0xFF,0xFF,0xFF,0xFF, 0x00,0x00,0x00,0x00, 0xFF,0xFF,0xFF,0xFF, 0x00,0x00,0x00,0x00,
    0xFF,0xFF,0xFF,0xFF, 0x00,0x00,0x00,0x00, 0xFF,0xFF,0xFF,0xFF, 0x00,0x00,0x00,0x00,
    0xFF,0xFF,0xFF,0xFF, 0x00,0x00,0x00,0x00, 0xFF,0xFF,0xFF,0xFF, 0x00,0x00,0x00,0x00,
    0xFF,0xFF,0xFF,0xFF, 0x00,0x00,0x00,0x00, 0xFF,0xFF,0xFF,0xFF, 0x00,0x00,0x00,0x00,
    0xFF,0xFF,0xFF,0xFF, 0x00,0x00,0x00,0x00, 0xFF,0xFF,0xFF,0xFF, 0x00,0x00,0x00,0x00,
    0xFF,0xFF,0xFF,0xFF, 0x00,0x00,0x00,0x00, 0xFF,0xFF,0xFF,0xFF, 0x00,0x00,0x00,0x00,
    0xFF,0xFF,0xFF,0xFF, 0x00,0x00,0x00,0x00, 0xFF,0xFF,0xFF,0xFF, 0x00,0x00,0x00,0x00 };
  unsigned char vline_stipple[] = {
    0xAA,0xAA,0xAA,0xAA, 0xAA,0xAA,0xAA,0xAA, 0xAA,0xAA,0xAA,0xAA, 0xAA,0xAA,0xAA,0xAA,
    0xAA,0xAA,0xAA,0xAA, 0xAA,0xAA,0xAA,0xAA, 0xAA,0xAA,0xAA,0xAA, 0xAA,0xAA,0xAA,0xAA,
    0xAA,0xAA,0xAA,0xAA, 0xAA,0xAA,0xAA,0xAA, 0xAA,0xAA,0xAA,0xAA, 0xAA,0xAA,0xAA,0xAA,
    0xAA,0xAA,0xAA,0xAA, 0xAA,0xAA,0xAA,0xAA, 0xAA,0xAA,0xAA,0xAA, 0xAA,0xAA,0xAA,0xAA,
    0xAA,0xAA,0xAA,0xAA, 0xAA,0xAA,0xAA,0xAA, 0xAA,0xAA,0xAA,0xAA, 0xAA,0xAA,0xAA,0xAA,
    0xAA,0xAA,0xAA,0xAA, 0xAA,0xAA,0xAA,0xAA, 0xAA,0xAA,0xAA,0xAA, 0xAA,0xAA,0xAA,0xAA,
    0xAA,0xAA,0xAA,0xAA, 0xAA,0xAA,0xAA,0xAA, 0xAA,0xAA,0xAA,0xAA, 0xAA,0xAA,0xAA,0xAA,
    0xAA,0xAA,0xAA,0xAA, 0xAA,0xAA,0xAA,0xAA, 0xAA,0xAA,0xAA,0xAA, 0xAA,0xAA,0xAA,0xAA };
  unsigned char chain_stipple[] = {
    0xAA,0xAA,0xAA,0xAA, 0xAA,0xAA,0xAA,0xAA, 0xAA,0xAA,0xAA,0xAA, 0xAA,0xAA,0xAA,0xAA,
    0x55,0x55,0x55,0x55, 0x55,0x55,0x55,0x55, 0x55,0x55,0x55,0x55, 0x55,0x55,0x55,0x55,
    0xAA,0xAA,0xAA,0xAA, 0xAA,0xAA,0xAA,0xAA, 0xAA,0xAA,0xAA,0xAA, 0xAA,0xAA,0xAA,0xAA,
    0x55,0x55,0x55,0x55, 0x55,0x55,0x55,0x55, 0x55,0x55,0x55,0x55, 0x55,0x55,0x55,0x55,
    0xAA,0xAA,0xAA,0xAA, 0xAA,0xAA,0xAA,0xAA, 0xAA,0xAA,0xAA,0xAA, 0xAA,0xAA,0xAA,0xAA,
    0x55,0x55,0x55,0x55, 0x55,0x55,0x55,0x55, 0x55,0x55,0x55,0x55, 0x55,0x55,0x55,0x55,
    0xAA,0xAA,0xAA,0xAA, 0xAA,0xAA,0xAA,0xAA, 0xAA,0xAA,0xAA,0xAA, 0xAA,0xAA,0xAA,0xAA,
    0x55,0x55,0x55,0x55, 0x55,0x55,0x55,0x55, 0x55,0x55,0x55,0x55, 0x55,0x55,0x55,0x55 };
  unsigned char dot_stipple[] = {
    0xAA,0xAA,0xAA,0xAA, 0x55,0x55,0x55,0x55, 0xAA,0xAA,0xAA,0xAA, 0x55,0x55,0x55,0x55,
    0xAA,0xAA,0xAA,0xAA, 0x55,0x55,0x55,0x55, 0xAA,0xAA,0xAA,0xAA, 0x55,0x55,0x55,0x55,
    0xAA,0xAA,0xAA,0xAA, 0x55,0x55,0x55,0x55, 0xAA,0xAA,0xAA,0xAA, 0x55,0x55,0x55,0x55,
    0xAA,0xAA,0xAA,0xAA, 0x55,0x55,0x55,0x55, 0xAA,0xAA,0xAA,0xAA, 0x55,0x55,0x55,0x55,
    0xAA,0xAA,0xAA,0xAA, 0x55,0x55,0x55,0x55, 0xAA,0xAA,0xAA,0xAA, 0x55,0x55,0x55,0x55,
    0xAA,0xAA,0xAA,0xAA, 0x55,0x55,0x55,0x55, 0xAA,0xAA,0xAA,0xAA, 0x55,0x55,0x55,0x55,
    0xAA,0xAA,0xAA,0xAA, 0x55,0x55,0x55,0x55, 0xAA,0xAA,0xAA,0xAA, 0x55,0x55,0x55,0x55,
    0xAA,0xAA,0xAA,0xAA, 0x55,0x55,0x55,0x55, 0xAA,0xAA,0xAA,0xAA, 0x55,0x55,0x55,0x55 };
  switch(stipple)
  {
    case PolygonStipple_Solid: setPolygonStipple(solid_stipple); break;
    case PolygonStipple_Dot: setPolygonStipple(dot_stipple); break;
    case PolygonStipple_Chain: setPolygonStipple(chain_stipple); break;
    case PolygonStipple_HLine: setPolygonStipple(hline_stipple); break;
    case PolygonStipple_VLine: setPolygonStipple(vline_stipple); break;
  }
}
//-----------------------------------------------------------------------------
void VectorGraphics::setBlendFunc(EBlendFactor src_rgb, EBlendFactor dst_rgb, EBlendFactor src_alpha, EBlendFactor dst_alpha)
{
  mState.mBlendFactorSrcRGB   = src_rgb;
  mState.mBlendFactorDstRGB   = dst_rgb;
  mState.mBlendFactorSrcAlpha = src_alpha;
  mState.mBlendFactorDstAlpha = dst_alpha;
}
//-----------------------------------------------------------------------------
void VectorGraphics::getBlendFunc(EBlendFactor& src_rgb, EBlendFactor& dst_rgb, EBlendFactor& src_alpha, EBlendFactor& dst_alpha) const
{
  src_rgb   = mState.mBlendFactorSrcRGB;
  dst_rgb   = mState.mBlendFactorDstRGB;
  src_alpha = mState.mBlendFactorSrcAlpha;
  dst_alpha = mState.mBlendFactorDstAlpha;
}
//-----------------------------------------------------------------------------
void VectorGraphics::setBlendEquation( EBlendEquation rgb_eq, EBlendEquation alpha_eq )
{
  mState.mBlendEquationRGB   = rgb_eq;
  mState.mBlendEquationAlpha = alpha_eq;
}//-----------------------------------------------------------------------------

void VectorGraphics::getBlendEquation( EBlendEquation& rgb_eq, EBlendEquation& alpha_eq ) const
{
  rgb_eq   = mState.mBlendEquationRGB;
  alpha_eq = mState.mBlendEquationAlpha;
}
//-----------------------------------------------------------------------------
void VectorGraphics::setStencilOp(EStencilOp sfail, EStencilOp dpfail, EStencilOp dppass)
{
  mState.mStencil_SFail  = sfail;
  mState.mStencil_DpFail = dpfail;
  mState.mStencil_DpPass = dppass;
}
//-----------------------------------------------------------------------------
void VectorGraphics::getStencilOp(EStencilOp& sfail, EStencilOp& dpfail, EStencilOp& dppass)
{
  sfail  = mState.mStencil_SFail;
  dpfail = mState.mStencil_DpFail;
  dppass = mState.mStencil_DpPass;
}
//-----------------------------------------------------------------------------
void VectorGraphics::setStencilFunc(EFunction func, int refval, unsigned int mask)
{
  mState.mStencil_Function     = func;
  mState.mStencil_RefValue     = refval;
  mState.mStencil_FunctionMask = mask;
}
//-----------------------------------------------------------------------------
void VectorGraphics::getStencilFunc(EFunction& func, int& refval, unsigned int& mask)
{
  func   = mState.mStencil_Function;
  refval = mState.mStencil_RefValue;
  mask   = mState.mStencil_FunctionMask;
}
//-----------------------------------------------------------------------------
Actor* VectorGraphics::clearColor(const fvec4& color, int x, int y, int w, int h)
{
  ref<Clear> clear = new Clear;
  clear->setClearColorBuffer(true);
  clear->setClearColorValue(color);
  clear->setScissorBox(x,y,w,h);
  return addActor( new Actor( clear.get(), /*mDefaultEffect.get()*/currentEffect(), NULL) );
}
//-----------------------------------------------------------------------------
Actor* VectorGraphics::clearStencil(int clear_val, int x, int y, int w, int h)
{
  ref<Clear> clear = new Clear;
  clear->setClearStencilBuffer(true);
  clear->setClearStencilValue(clear_val);
  clear->setScissorBox(x,y,w,h);
  return addActor( new Actor( clear.get(), /*mDefaultEffect.get()*/currentEffect(), NULL) );
}
//-----------------------------------------------------------------------------
Actor* VectorGraphics::drawText(Text* text)
{
  if (text->font() == NULL)
    text->setFont(mState.mFont.get());
  return addActor( new Actor(text, /*mDefaultEffect.get()*/currentEffect(), NULL) );
}
//-----------------------------------------------------------------------------
Actor* VectorGraphics::drawText(int x, int y, const String& text, int alignment)
{
  pushMatrix();
  mMatrix = dmat4::getTranslation(x,y,0) * mMatrix;
  Actor* act = drawText(text, alignment);
  popMatrix();
  return act;
}
//-----------------------------------------------------------------------------
Actor* VectorGraphics::drawText(const String& text, int alignment)
{
  ref<Text> t = new Text;
  t->setText( text );
  t->setAlignment(alignment);
  t->setViewportAlignment(AlignBottom|AlignLeft);
  t->setColor( mState.mColor );
  t->setMatrix( (fmat4)matrix() );
  return drawText(t.get());
}
//-----------------------------------------------------------------------------
Actor* VectorGraphics::drawActor(Actor* actor, Transform* transform, bool keep_effect)
{
  VL_CHECK(actor->effect())
  if (!keep_effect || !actor->effect())
    actor->setEffect(currentEffect());
  if (transform != NULL)
    actor->setTransform(transform);
  return addActor(actor);
}
//-----------------------------------------------------------------------------
Actor* VectorGraphics::drawActorCopy(Actor* actor, Transform* transform)
{
  ref<Actor> copy = new Actor(*actor);
  copy->setTransform(transform);
  drawActor(copy.get());
  return copy.get();
}
//-----------------------------------------------------------------------------
void VectorGraphics::rotate(double deg)
{
  mMatrix = mMatrix * dmat4::getRotation(deg, 0,0,1.0);
}
//-----------------------------------------------------------------------------
void VectorGraphics::translate(double x, double y, double z)
{
  mMatrix = mMatrix * dmat4::getTranslation(x,y,z);
}
//-----------------------------------------------------------------------------
void VectorGraphics::scale(double x, double y, double z)
{
  mMatrix = mMatrix * dmat4::getScaling(x,y,z);
}
//-----------------------------------------------------------------------------
void VectorGraphics::popMatrix()
{
  if (mMatrixStack.empty())
  {
    Log::error("VectorGraphics::popMatrix() matrix stack underflow!\n");
    return;
  }
  setMatrix(mMatrixStack.back());
  mMatrixStack.pop_back();
}
//-----------------------------------------------------------------------------
void VectorGraphics::pushState()
{
  mStateStack.push_back(mState);
  pushMatrix();
}
//-----------------------------------------------------------------------------
void VectorGraphics::popState()
{
  popMatrix();
  if (mStateStack.empty())
  {
    Log::error("VectorGraphics::popState() matrix stack underflow!\n");
    return;
  }
  mState = mStateStack.back();
  mStateStack.pop_back();
}
//-----------------------------------------------------------------------------
void VectorGraphics::pushScissor(int x, int y, int w, int h)
{
  mScissorStack.push_back(mScissor.get());
  RectI newscissor = mScissor ? mScissor->scissorRect().intersected(RectI(x,y,w,h)) : RectI(x,y,w,h);
  setScissor(newscissor.x(), newscissor.y(), newscissor.width(), newscissor.height());
}
//-----------------------------------------------------------------------------
void VectorGraphics::popScissor()
{
  if (mScissorStack.empty())
  {
    Log::error("VectorGraphics::popScissor() scissor stack underflow!\n");
    return;
  }
  mScissor = mScissorStack.back();
  mScissorStack.pop_back();
}
//-----------------------------------------------------------------------------
void VectorGraphics::generateQuadsTexCoords(Geometry* geom, const std::vector<dvec2>& points)
{
  // generate only if there is an image active
  if (mState.mImage)
  {
    ref<ArrayFloat2> tex_array = new ArrayFloat2;
    tex_array->resize(geom->vertexArray()->size());
    geom->setTexCoordArray(0, tex_array.get());
    if (mState.mTextureMode == TextureMode_Clamp)
    {
      float du = 1.0f / mState.mImage->width()  / 2.0f;
      float dv = mState.mImage->height() ? (1.0f / mState.mImage->height() / 2.0f) : 0.5f;
      //  1----2
      //  |    |
      //  |    |
      //  0    3
      fvec2 texc[] = { fvec2(du,dv), fvec2(du,1.0f-dv), fvec2(1.0f-du,1.0f-dv), fvec2(1.0f-du,dv) };
      for(unsigned i=0; i<points.size(); ++i)
      {
        float s = texc[i%4].s();
        float t = texc[i%4].t();
        tex_array->at(i).s() = s;
        tex_array->at(i).t() = t;
      }
    }
    else
    {
      AABB aabb;
      for(unsigned i=0; i<points.size(); ++i)
        aabb.addPoint( geom->vertexArray()->getAsVec3(i) );
      for(unsigned i=0; i<points.size(); ++i)
      {
        vec4 v = geom->vertexArray()->getAsVec4(i);
        double s = (v.s()-aabb.minCorner().s()) / (mState.mImage->width() );
        double t = (v.t()-aabb.minCorner().t()) / (mState.mImage->height());
        tex_array->at(i).s() = (float)s;
        tex_array->at(i).t() = (float)t;
      }
    }
  }
}
//-----------------------------------------------------------------------------
void VectorGraphics::generatePlanarTexCoords(Geometry* geom, const std::vector<dvec2>& points)
{
  // generate only if there is an image active
  if (mState.mImage)
  {
    // generate uv coordinates based on the aabb
    ref<ArrayFloat2> tex_array = new ArrayFloat2;
    tex_array->resize(geom->vertexArray()->size());
    geom->setTexCoordArray(0, tex_array.get());
    if (mState.mTextureMode == TextureMode_Clamp)
    {
      // compute aabb
      AABB aabb;
      for(unsigned i=0; i<points.size(); ++i)
        aabb.addPoint( (vec3)dvec3(points[i],0.0) );
      for(unsigned i=0; i<points.size(); ++i)
      {
        float s = float((points[i].x() - aabb.minCorner().x()) / aabb.width() );
        float t = float((points[i].y() - aabb.minCorner().y()) / aabb.height());
        tex_array->at(i).s() = s;
        tex_array->at(i).t() = t;
      }
    }
    else
    {
      AABB aabb;
      for(unsigned i=0; i<points.size(); ++i)
        aabb.addPoint( geom->vertexArray()->getAsVec3(i)+vec3(0.5f,0.5f,0.0f) );
      for(unsigned i=0; i<points.size(); ++i)
      {
        vec4 v = geom->vertexArray()->getAsVec4(i);
        double s = (v.s()-aabb.minCorner().s()) / mState.mImage->width();
        double t = (v.t()-aabb.minCorner().t()) / mState.mImage->height();
        tex_array->at(i).s() = (float)s;
        tex_array->at(i).t() = (float)t;
      }
    }
  }
}
//-----------------------------------------------------------------------------
void VectorGraphics::generateLinearTexCoords(Geometry* geom)
{
  if (mState.mImage)
  {
    ref<ArrayFloat2> tex_array = new ArrayFloat2;
    tex_array->resize(geom->vertexArray()->size());
    float u1 = 1.0f / mState.mImage->width() * 0.5f;
    float u2 = 1.0f - 1.0f / mState.mImage->width() * 0.5f;
    for(size_t i=0; i<tex_array->size(); ++i)
    {
      float t = (float)i/(tex_array->size()-1);
      tex_array->at(i).s() = u1 * (1.0f-t) + u2 * t;
      tex_array->at(i).t() = 0;
    }
    // generate geometry
    geom->setTexCoordArray(0, tex_array.get());
  }
}
//-----------------------------------------------------------------------------
ref<Geometry> VectorGraphics::prepareGeometryPolyToTriangles(const std::vector<dvec2>& ln)
{
  // transform the lines
  ref<ArrayFloat3> pos_array = new ArrayFloat3;
  pos_array->resize( (ln.size()-2) * 3 );
  // transform done using high precision
  for(unsigned i=0, itri=0; i<ln.size()-2; ++i, itri+=3)
  {
    pos_array->at(itri+0) = (fvec3)(matrix() * dvec3(ln[0].x(), ln[0].y(), 0));
    pos_array->at(itri+1) = (fvec3)(matrix() * dvec3(ln[i+1].x(), ln[i+1].y(), 0));
    pos_array->at(itri+2) = (fvec3)(matrix() * dvec3(ln[i+2].x(), ln[i+2].y(), 0));
  }
  // generate geometry
  ref< Geometry > geom = new Geometry;
  geom->setVertexArray(pos_array.get());
  return geom;
}
//-----------------------------------------------------------------------------
ref<Geometry> VectorGraphics::prepareGeometry(const std::vector<dvec2>& ln)
{
  // transform the lines
  ref<ArrayFloat3> pos_array = new ArrayFloat3;
  pos_array->resize(ln.size());
  // transform done using high precision
  for(unsigned i=0; i<ln.size(); ++i)
    pos_array->at(i) = (fvec3)(matrix() * dvec3(ln[i].x(), ln[i].y(), 0));
  // generate geometry
  ref< Geometry > geom = new Geometry;
  geom->setVertexArray(pos_array.get());
  return geom;
}
//-----------------------------------------------------------------------------
Scissor* VectorGraphics::resolveScissor(int x, int y, int width, int height)
{
  ref<Scissor> scissor = mRectToScissorMap[RectI(x,y,width,height)];
  if (!scissor)
  {
    scissor = new Scissor(x,y,width,height);
    mRectToScissorMap[RectI(x,y,width,height)] = scissor;
  }
  return scissor.get();
}
//-----------------------------------------------------------------------------
Texture* VectorGraphics::resolveTexture(const Image* image)
{
  Texture* texture = mImageToTextureMap[ImageState(image,mState.mTextureMode)].get();
  if (!texture)
  {
    texture = new Texture( image, TF_RGBA, true, false);
    texture->getTexParameter()->setMinFilter(TPF_LINEAR_MIPMAP_LINEAR);
    texture->getTexParameter()->setMagFilter(TPF_LINEAR);
    #if 0
      texture->getTexParameter()->setBorderColor(fvec4(1,0,1,1)); // for debuggin purposes
    #else
      texture->getTexParameter()->setBorderColor(fvec4(1,1,1,0)); // transparent white
    #endif
    if (mState.mTextureMode == vl::TextureMode_Repeat)
    {
      texture->getTexParameter()->setWrapS(TPW_REPEAT);
      texture->getTexParameter()->setWrapT(TPW_REPEAT);
    }
    else
    {
      texture->getTexParameter()->setWrapS(TPW_CLAMP);
      texture->getTexParameter()->setWrapT(TPW_CLAMP);
    }
    mImageToTextureMap[ImageState(image,mState.mTextureMode)] = texture;
  }
  return texture;
}
//-----------------------------------------------------------------------------
Effect* VectorGraphics::currentEffect(const State& vgs)
{
  Effect* effect = mVGToEffectMap[vgs].get();
  // create a Shader reflecting the current VectorGraphics state machine state
  if (!effect)
  {
    effect = new Effect;
    mVGToEffectMap[vgs] = effect;
    Shader* shader = effect->shader();
    /*shader->disable(EN_DEPTH_TEST);*/
    shader->enable(EN_BLEND);
    // color
    shader->enable(EN_LIGHTING);
    shader->gocMaterial()->setFlatColor(vgs.mColor);
    // point size
    shader->gocPointSize()->set((float)vgs.mPointSize);
    // logicop
    if (vgs.mLogicOp != LO_COPY)
    {
      shader->gocLogicOp()->set(vgs.mLogicOp);
      shader->enable(EN_COLOR_LOGIC_OP);
    }
    // line stipple
    if ( vgs.mLineStipple != 0xFFFF )
    {
#if defined(VL_OPENGL)
      shader->gocLineStipple()->set(1, vgs.mLineStipple);
      shader->enable(EN_LINE_STIPPLE);
#else
      Log::error("vl::VectorGraphics: line stipple not supported under OpenGL ES. Try using a stipple texture instead.\n");
#endif
    }
    // line width
    if (vgs.mLineWidth != 1.0f)
      shader->gocLineWidth()->set(vgs.mLineWidth);
    // point smooth
    if (vgs.mPointSmoothing)
    {
      shader->gocHint()->setPointSmoothHint(HM_NICEST);
      shader->enable(EN_POINT_SMOOTH);
    }
    // line smooth
    if (vgs.mLineSmoothing)
    {
      shader->gocHint()->setLineSmoothHint(HM_NICEST);
      shader->enable(EN_LINE_SMOOTH);
    }
    // polygon smooth
    if (vgs.mPolygonSmoothing)
    {
      shader->gocHint()->setPolygonSmoohtHint(HM_NICEST);
      shader->enable(EN_POLYGON_SMOOTH);
    }
    // poly stipple
    unsigned char solid_stipple[] = {
      0xFF,0xFF,0xFF,0xFF, 0xFF,0xFF,0xFF,0xFF, 0xFF,0xFF,0xFF,0xFF, 0xFF,0xFF,0xFF,0xFF,
      0xFF,0xFF,0xFF,0xFF, 0xFF,0xFF,0xFF,0xFF, 0xFF,0xFF,0xFF,0xFF, 0xFF,0xFF,0xFF,0xFF,
      0xFF,0xFF,0xFF,0xFF, 0xFF,0xFF,0xFF,0xFF, 0xFF,0xFF,0xFF,0xFF, 0xFF,0xFF,0xFF,0xFF,
      0xFF,0xFF,0xFF,0xFF, 0xFF,0xFF,0xFF,0xFF, 0xFF,0xFF,0xFF,0xFF, 0xFF,0xFF,0xFF,0xFF,
      0xFF,0xFF,0xFF,0xFF, 0xFF,0xFF,0xFF,0xFF, 0xFF,0xFF,0xFF,0xFF, 0xFF,0xFF,0xFF,0xFF,
      0xFF,0xFF,0xFF,0xFF, 0xFF,0xFF,0xFF,0xFF, 0xFF,0xFF,0xFF,0xFF, 0xFF,0xFF,0xFF,0xFF,
      0xFF,0xFF,0xFF,0xFF, 0xFF,0xFF,0xFF,0xFF, 0xFF,0xFF,0xFF,0xFF, 0xFF,0xFF,0xFF,0xFF,
      0xFF,0xFF,0xFF,0xFF, 0xFF,0xFF,0xFF,0xFF, 0xFF,0xFF,0xFF,0xFF, 0xFF,0xFF,0xFF,0xFF
    };
    if ( memcmp(vgs.mPolyStipple, solid_stipple, 32*32/8) != 0 )
    {
#if defined(VL_OPENGL)
      shader->gocPolygonStipple()->set(vgs.mPolyStipple);
      shader->enable(EN_POLYGON_STIPPLE);
#else
      Log::error("vl::VectorGraphics: polygon stipple not supported under OpenGL ES. Try using a stipple texture instead.\n");
#endif
    }
    // blending equation and function
    shader->gocBlendEquation()->set(vgs.mBlendEquationRGB, vgs.mBlendEquationAlpha);
    shader->gocBlendFunc()->set(vgs.mBlendFactorSrcRGB, vgs.mBlendFactorDstRGB, vgs.mBlendFactorSrcAlpha, vgs.mBlendFactorDstAlpha);
    if (vgs.mAlphaFunc != FU_ALWAYS)
    {
      shader->enable(EN_ALPHA_TEST);
      shader->gocAlphaFunc()->set(vgs.mAlphaFunc, vgs.mAlphaFuncRefValue);
    }
    // masks (by default they are all 'true')
    if (vgs.mColorMask != ivec4(1,1,1,1) )
      shader->gocColorMask()->set(vgs.mColorMask.r()?true:false,vgs.mColorMask.g()?true:false,vgs.mColorMask.b()?true:false,vgs.mColorMask.a()?true:false);
    // stencil
    if (vgs.mStencilTestEnabled)
    {
      shader->enable(EN_STENCIL_TEST);
      shader->gocStencilMask()->set(PF_FRONT_AND_BACK, vgs.mStencilMask);
      shader->gocStencilOp()->set(PF_FRONT_AND_BACK, vgs.mStencil_SFail, vgs.mStencil_DpFail, vgs.mStencil_DpPass);
      shader->gocStencilFunc()->set(PF_FRONT_AND_BACK, vgs.mStencil_Function, vgs.mStencil_RefValue, vgs.mStencil_FunctionMask);
    }
    /*if (!vgs.mDepthMask)
      shader->gocDepthMask()->set(false);*/
    // texture
    if (vgs.mImage)
    {
      shader->gocTextureSampler(0)->setTexture( resolveTexture(vgs.mImage.get()) );
      if (Has_Point_Sprite)
      {
        shader->gocTexEnv(0)->setPointSpriteCoordReplace(true);
        shader->enable(EN_POINT_SPRITE);
      }
      else
        Log::error("GL_ARB_point_sprite not supported.\n");
    }
  }
  return effect;
}
//-----------------------------------------------------------------------------
Actor* VectorGraphics::addActor(Actor* actor)
{
  actor->setScissor(mScissor.get());
  mActors.push_back(actor);
  return actor;
}
//-----------------------------------------------------------------------------