TGLPadUtils.h

Go to the documentation of this file.

// @(#)root/gl:$Id$
// Author:  Timur Pocheptsov  06/05/2009
 
/*************************************************************************
 * Copyright (C) 1995-2009, Rene Brun and Fons Rademakers.               *
 * All rights reserved.                                                  *
 *                                                                       *
 * For the licensing terms see $ROOTSYS/LICENSE.                         *
 * For the list of contributors see $ROOTSYS/README/CREDITS.             *
 *************************************************************************/
 
#ifndef ROOT_TGLPadUtils
#define ROOT_TGLPadUtils
 
#include <vector>
#include <list>
 
#include "RStipples.h"
#include "TPoint.h"
#include "RtypesCore.h"
 
class TGLPadPainter;//For friend declarations.
 
/*
 
All code here and in corresponding *.cxx file is only
for TGLPadPainter. So, it can be limited or wrong
for something else, but it's OK for TGLPadPainter.
 
*/
 
namespace Rgl {
namespace Pad {
/*
Auxiliary class to converts ROOT's polygon stipples from
RStipples.h into GL's stipples and hold them in a fStipples array.
*/
class PolygonStippleSet {
   friend class ::TGLPadPainter;
   friend class FillAttribSet;
private:
   std::vector<unsigned char> fStipples;
 
   static const UInt_t fgBitSwap[];
   static UInt_t SwapBits(UInt_t bits);
 
   enum EGeometry {
      kRowSize = 4,//For gl, stipple is a 32x32 pixel pattern. So, 4 GLubyte objects form a single line of a stipple.
      kNRows = 32,
      kStippleSize = kNRows * kRowSize//4 * 32 == 32 lines.
   };
 
   enum EBitMasks {
      kLow4   = 0xf,
      kUp4    = 0xf0,
      k16Bits = 0xff
   };
public:
   PolygonStippleSet();
};
 
/*
RAII class to enable/disable selected stipple.
*/
class FillAttribSet {
   UInt_t fStipple;
   Float_t fAlpha;
public:
   FillAttribSet(const PolygonStippleSet & set, Bool_t ignoreStipple);
   ~FillAttribSet();
};
 
/*
"ROOT like" line stipples.
*/
 
extern const UShort_t gLineStipples[];
extern const UInt_t gMaxStipple;
 
/*
Set/unset line attributes.
*/
class LineAttribSet {
private:
   Bool_t fSmooth;
   UInt_t fStipple;
   Bool_t fSetWidth;
   Float_t fAlpha;
public:
   LineAttribSet(Bool_t smooth, UInt_t stipple, Double_t maxWidth, Bool_t setWidth);
   ~LineAttribSet();
};
 
/*
Marker painter. Most markers can be painted by standlone functions.
For circles, it can be usefull to precalculate the marker geometry
and use it for poly-markers.
*/
/*
Marker painter. Most markers can be painted by standlone functions.
For circles, it can be usefull to precalculate the marker geometry
and use it for poly-markers.
*/
class MarkerPainter {
private:
   //Different TArrMarker styles.
   mutable TPoint fStar[8];
   mutable TPoint fCross[4];
 
   mutable std::vector<TPoint> fCircle;
 
   enum {
      kSmallCirclePts = 80,
      kLargeCirclePts = 150
   };
 
public:
   //Each function draw n markers.
   void DrawDot(UInt_t n, const TPoint *xy)const;
   void DrawPlus(UInt_t n, const TPoint *xy)const;
   void DrawStar(UInt_t n, const TPoint *xy)const;
   void DrawX(UInt_t n, const TPoint *xy)const;
   void DrawFullDotSmall(UInt_t n, const TPoint *xy)const;
   void DrawFullDotMedium(UInt_t n, const TPoint *xy)const;
 
   void DrawCircle(UInt_t n, const TPoint *xy)const;
   void DrawFullDotLarge(UInt_t n, const TPoint *xy)const;
 
   void DrawFullSquare(UInt_t n, const TPoint *xy)const;
   void DrawFullTrianlgeUp(UInt_t n, const TPoint *xy)const;
   void DrawFullTrianlgeDown(UInt_t n, const TPoint *xy)const;
   void DrawDiamond(UInt_t n, const TPoint *xy)const;
   void DrawFullDiamond(UInt_t n, const TPoint *xy)const;
   void DrawOpenTrianlgeDown(UInt_t n, const TPoint *xy)const;
   void DrawFullCross(UInt_t n, const TPoint *xy)const;
   void DrawOpenCross(UInt_t n, const TPoint *xy)const;
   void DrawFullStar(UInt_t n, const TPoint *xy)const;
   void DrawOpenStar(UInt_t n, const TPoint *xy)const;
   void DrawOpenSquareDiagonal(UInt_t n, const TPoint *xy)const;
   void DrawOpenDiamondCross(UInt_t n, const TPoint *xy)const;
   void DrawOpenThreeTriangles(UInt_t n, const TPoint *xy)const;
   void DrawOctagonCross(UInt_t n, const TPoint *xy)const;
   void DrawFullThreeTriangles(UInt_t n, const TPoint *xy)const;
   void DrawOpenFourTrianglesX(UInt_t n, const TPoint *xy)const;
   void DrawFullFourTrianglesX(UInt_t n, const TPoint *xy)const;
   void DrawOpenDoubleDiamond(UInt_t n, const TPoint *xy)const;
   void DrawFullDoubleDiamond(UInt_t n, const TPoint *xy)const;
   void DrawOpenFourTrianglesPlus(UInt_t n, const TPoint *xy)const;
   void DrawFullFourTrianglesPlus(UInt_t n, const TPoint *xy)const;
   void DrawOpenCrossX(UInt_t n, const TPoint *xy)const;
   void DrawFullCrossX(UInt_t n, const TPoint *xy)const;
   void DrawFourSquaresX(UInt_t n, const TPoint *xy)const;
   void DrawFourSquaresPlus(UInt_t n, const TPoint *xy)const;
};
 
//
// OpenGL's tesselator calls callback functions glBegin(MODE), glVertex3(v), glEnd(),
// where v can be new vertex (or existing) and MODE is a type of mesh patch.
// MeshPatch_t is a class to save such a tesselation
// (instead of using glVertex and glBegin to draw.
//
struct MeshPatch_t {
   MeshPatch_t(Int_t type) : fPatchType(type)
   {}
 
   Int_t                 fPatchType; //GL_QUADS, GL_QUAD_STRIP, etc.
   std::vector<Double_t> fPatch;     //vertices.
};
 
typedef std::list<MeshPatch_t> Tesselation_t;
 
class Tesselator {
 
 
public:
   Tesselator(Bool_t dump = kFALSE);
 
   ~Tesselator();
 
   void *GetTess()const
   {
      return fTess;
   }
 
   static void SetDump(Tesselation_t *t)
   {
      fVs = t;
   }
 
   static Tesselation_t *GetDump()
   {
      return fVs;
   }
 
private:
 
   void *fTess;
 
   static Tesselation_t *fVs;//the current tesselator's dump.
};
 
/*
In future, this should be an interface to per-pad FBO.
Currently, in only save sizes and coordinates (?)
*/
class OffScreenDevice {
   friend class ::TGLPadPainter;
public:
   OffScreenDevice(UInt_t w, UInt_t h, UInt_t x, UInt_t y, Bool_t top);
 
private:
   UInt_t fW;
   UInt_t fH;
   UInt_t fX;
   UInt_t fY;
   Bool_t fTop;
};
 
void ExtractRGBA(Color_t colorIndex, Float_t *rgba);
 
class GLLimits {
public:
   GLLimits();
 
   Double_t GetMaxLineWidth()const;
   Double_t GetMaxPointSize()const;
private:
   mutable Double_t fMaxLineWidth;
   mutable Double_t fMaxPointSize;
};
 
//We have a lot of Rect_t/Point_t/TGLRect/TGLBoundingBox blah-blah-blah.
//What we do not have is a rectangle with floating point types.
 
template<class ValueType>
struct BoundingRect {
   ValueType fXMin = ValueType();
   ValueType fYMin = ValueType();
   ValueType fWidth = ValueType();
   ValueType fHeight = ValueType();
   //Sometimes it's more convenient:
   ValueType fXMax = ValueType();
   ValueType fYMax = ValueType();
};
 
//It's explicitly instantiated for signed integer/fp types (in *.cxx).
template<class ValueType>
BoundingRect<ValueType> FindBoundingRect(Int_t nPoints, const ValueType *xs, const ValueType *ys);
 
 
}//namespace Pad
}//namespace Rgl
 
#endif