cinder::gl Namespace Reference

Classes
class	DisplayList
class	Renderbuffer
	Represents an OpenGL Renderbuffer, used primarily in conjunction with FBOs. Supported on OpenGL ES but multisampling is currently ignored. Implicitly shared object. More...
class	Fbo
	Represents an OpenGL Framebuffer Object. //! Represents an instance of a font at a point size. Implicitly shared object. More...
class	FboException
class	FboExceptionInvalidSpecification
struct	SaveTextureBindState
	Convenience class designed to push and pop the currently bound texture for a given texture unit. More...
struct	BoolState
	Convenience class designed to push and pop a boolean OpenGL state. More...
struct	ClientBoolState
	Convenience class designed to push and pop a boolean OpenGL state. More...
struct	SaveColorState
	Convenience class designed to push and pop the current color. More...
struct	SaveFramebufferBinding
	Convenience class which pushes and pops the currently bound framebuffer. More...
class	Exception
class	ExceptionUnknownTarget
class	GlslProg
	Represents an OpenGL GLSL program. Implicitly shared object. More...
class	GlslProgCompileExc
class	GlslNullProgramExc
class	Light
class	Material
class	StereoAutoFocuser
class	Texture
	Represents an OpenGL Texture. Implicitly shared object. More...
class	TextureCache
class	SurfaceConstraintsGLTexture
class	TextureDataExc
class	TextureFont
class	TileRender
class	Vbo
class	VboMesh
class	VboExc
class	VboInvalidTargetExc
class	VboFailedMapExc
class	VboFailedUnmapExc
Typedefs
typedef std::shared_ptr< Texture >	TextureRef
typedef std::shared_ptr< VboMesh >	VboMeshRef
typedef std::shared_ptr< GlslProg >	GlslProgRef
typedef std::shared_ptr< class TextureFont >	TextureFontRef
Functions
void	initializeGlee ()
	Initializes the GLee library. This is generally called automatically by the application and is only necessary if you need to use GLee before your app's setup() method is called.
bool	isExtensionAvailable (const std::string &extName)
	Returns whether a particular OpenGL extension is available. Caches results.
void	clear (const ColorA &color=ColorA::black(), bool clearDepthBuffer=true)
	Clears the OpenGL color buffer using color and optionally clears the depth buffer when clearDepthBuffer.
void	enableVerticalSync (bool enable=true)
	Enables or disables wait for vertical sync.
bool	isVerticalSyncEnabled ()
	Returns whether vertical sync is enabled for the current context.
void	setModelView (const Camera &cam)
	Sets the MODELVIEW matrix to reflect the values of cam. Leaves the MatrixMode as MODELVIEW.
void	setProjection (const Camera &cam)
	Sets the PROJECTION matrix to reflect the values of cam. Leaves the MatrixMode as PROJECTION.
void	setMatrices (const Camera &cam)
	Sets the MODELVIEW and PROJECTION matrices to reflect the values of cam. Leaves the MatrixMode as MODELVIEW.
void	pushModelView ()
	Pushes the MODELVIEW matrix onto its stack, preserving the current values. Leaves the MatrixMode as MODELVIEW.
void	popModelView ()
	Pops the MODELVIEW matrix off of its stack, restoring the values saved with the previous push. Leaves the MatrixMode as MODELVIEW.
void	pushModelView (const Camera &cam)
	Pushes the MODELVIEW matrix onto its stack, preserving the current values, and then sets the matrix to reflect cam. Leaves the MatrixMode as MODELVIEW.
void	pushProjection (const Camera &cam)
	Pushes the PROJECTION matrix onto its stack, preserving the current values, and then sets the matrix to reflect cam. Leaves the MatrixMode as PROJECTION.
void	pushMatrices ()
	Pushes the MODELVIEW and PROJECTION matrices onto their stacks, preserving the current values. Leaves the MatrixMode as MODELVIEW.
void	popMatrices ()
	Pops the MODELVIEW and PROJECTION matrices off their stacks, restoring the values saved with the previous push. Leaves the MatrixMode as MODELVIEW.
void	multModelView (const Matrix44f &mtx)
	Multiplies the current MODELVIEW matrix with mtx. Leaves the MatrixMode as MODELVIEW.
void	multProjection (const Matrix44f &mtx)
	Multiplies the current PROJECTION matrix with mtx. Leaves the MatrixMode as MODELVIEW.
Matrix44f	getModelView ()
	Returns the value of the current MODELVIEW matrix as a Matrix44f.
Matrix44f	getProjection ()
	Returns the value of the current PROJECTION matrix as a Matrix44f.
void	setMatricesWindowPersp (int screenWidth, int screenHeight, float fovDegrees=60.0f, float nearPlane=1.0f, float farPlane=1000.0f, bool originUpperLeft=true)
	Sets the viepwort and MODELVIEW and PROJECTION matrices to be a perspective projection with the upper-left corner at [0,0] and the lower-right at [screenWidth,screenHeight], but flipped vertically if not originUpperLeft.
void	setMatricesWindow (int screenWidth, int screenHeight, bool originUpperLeft=true)
	Sets the viewport and MODELVIEW and PROJECTION matrices to orthographic with the upper-left corner at [0,0] and the lower-right at [screenWidth,screenHeight] if originUpperLeft is true. Otherwise the origin is in the lower right.
Area	getViewport ()
	Returns the current OpenGL Viewport as an Area.
void	setViewport (const Area &area)
	Sets the current OpenGL Viewport to area.
void	translate (const Vec2f &pos)
	Produces a translation by pos in the current matrix.
void	translate (const Vec3f &pos)
	Produces a translation by pos in the current matrix.
void	scale (const Vec3f &scl)
	Produces a scale by scale in the current matrix.
void	rotate (const Vec3f &xyz)
	Produces a rotation around the X-axis by xyz.x degrees, the Y-axis by xyz.y degrees and the Z-axis by xyz.z degrees in the current matrix. Processed in X-Y-Z order.
void	rotate (const Quatf &quat)
	Produces a rotation by the quaternion quat in the current matrix.
void	enableAlphaBlending (bool premultiplied=false)
	Enables alpha blending. Selects a BlendFunc that is appropriate for premultiplied-alpha when premultiplied.
void	disableAlphaBlending ()
	Disables alpha blending.
void	enableAdditiveBlending ()
	Enables alpha blending and selects a BlendFunc for additive blending.
void	enableAlphaTest (float value=0.5f, int func=GL_GREATER)
	Enables alpha testing and sets the AlphaFunc to test for values which are func than value, which should be in the range [0, 1.0]. Possible values for func include GL_NEVER, GL_LESS, GL_EQUAL, GL_LEQUAL, GL_GREATER, GL_NOTEQUAL, GL_GEQUAL and GL_ALWAYS.
void	disableAlphaTest ()
	Disables alpha testing.
void	enableWireframe ()
	Enables wireframe drawing by setting the PolygonMode to GL_LINE.
void	disableWireframe ()
	Disables wireframe drawing.
void	disableDepthRead ()
	Disables reading from the depth buffer, disabling z-testing.
void	enableDepthRead (bool enable=true)
	Enables reading from the depth buffer when enable, enabling z-testing.
void	enableDepthWrite (bool enable=true)
	Enables writing to the depth buffer when enable.
void	disableDepthWrite ()
	Disables writing to the depth buffer.
void	drawLine (const Vec2f &start, const Vec2f &end)
	Draws a line from start to end.
void	drawLine (const Vec3f &start, const Vec3f &end)
	Draws a line from start to end.
void	drawCube (const Vec3f &center, const Vec3f &size)
	Renders a solid cube centered at center of size size. Normals and created texture coordinates are generated for GL_TEXTURE_2D, with each face in the range [0,0] - [1.0,1.0].
void	drawColorCube (const Vec3f &center, const Vec3f &size)
	Renders a solid cube centered at center of size size. Each face is assigned a unique color, and no normals or texture coordinates are generated.
void	drawStrokedCube (const Vec3f &center, const Vec3f &size)
	Renders a stroked cube centered at center of size size.
void	drawSphere (const Vec3f &center, float radius, int segments=12)
	Renders a solid sphere centered at center of radius radius. segments defines how many segments the sphere is subdivided into. Normals and texture coordinates in the range [0,1] are generated.
void	draw (const class Sphere &sphere, int segments=12)
	Renders a solid sphere. segments defines how many segments the sphere is subdivided into. Normals and texture coordinates in the range [0,1] are generated.
void	drawSolidCircle (const Vec2f &center, float radius, int numSegments=0)
	Renders a solid circle using triangle fans. The default value of zero for numSegments automatically determines a number of segments based on the circle's circumference.
void	drawStrokedCircle (const Vec2f &center, float radius, int numSegments=0)
	Renders a stroked circle using a line loop. The default value of zero for numSegments automatically determines a number of segments based on the circle's circumference.
void	drawSolidEllipse (const Vec2f &center, float radiusX, float radiusY, int numSegments=0)
	Renders a solid ellipse using triangle fans. The default value of zero for numSegments automatically determines a number of segments based on the ellipse's circumference.
void	drawStrokedEllipse (const Vec2f &center, float radiusX, float radiusY, int numSegments=0)
	Renders a stroked circle using a line loop. The default value of zero for numSegments automatically determines a number of segments based on the circle's circumference.
void	drawSolidRect (const Rectf &rect, bool textureRectangle=false)
	Renders a solid rectangle. Texture coordinates in the range [0,1] are generated unless textureRectangle.
void	drawStrokedRect (const Rectf &rect)
	Renders a stroked rectangle.
void	drawSolidRoundedRect (const Rectf &r, float cornerRadius, int numSegmentsPerCorner)
void	drawStrokedRoundedRect (const Rectf &r, float cornerRadius, int numSegmentsPerCorner)
void	drawSolidTriangle (const Vec2f &pt1, const Vec2f &pt2, const Vec2f &pt3)
void	drawSolidTriangle (const Vec2f pts[3])
void	drawSolidTriangle (const Vec2f &pt1, const Vec2f &pt2, const Vec2f &pt3, const Vec2f &texPt1, const Vec2f &texPt2, const Vec2f &texPt3)
	Renders a textured triangle.
void	drawSolidTriangle (const Vec2f pts[3], const Vec2f texCoord[3])
void	drawStrokedTriangle (const Vec2f &pt1, const Vec2f &pt2, const Vec2f &pt3)
	Renders a stroked triangle.
void	drawStrokedTriangle (const Vec2f pts[3])
void	drawCoordinateFrame (float axisLength, float headLength, float headRadius)
void	drawVector (const Vec3f &start, const Vec3f &end, float headLength=0.2f, float headRadius=0.05f)
	Draws a vector starting at start and ending at end. An arrowhead is drawn at the end of radius headRadius and length headLength.
void	drawFrustum (const Camera &cam)
	Draws a wireframe representation of the frustum defined by cam.
void	drawTorus (float outterRadius, float innerRadius, int longitudeSegments=12, int latitudeSegments=12)
	Draws a torus at the origin, with an outter radius outterRadius and an inner radius innerRadius, subdivided into longitudeSegments and latitudeSegments. Normals and texture coordinates in the range [0,1] are generated.
void	drawCylinder (float baseRadius, float topRadius, float height, int slices=12, int stacks=1)
	Draws a open-ended cylinder, with base radius baseRadius and top radius topRadius, with height height, subdivided into slices and stacks. Normals and texture coordinates in the range [0,1] are generated.
void	draw (const PolyLine< Vec2f > &polyLine)
void	draw (const PolyLine< Vec3f > &polyLine)
void	draw (const Path2d &path2d, float approximationScale)
void	draw (const Shape2d &shape2d, float approximationScale)
void	drawSolid (const Path2d &path2d, float approximationScale)
void	drawSolid (const Shape2d &shape2d, float approximationScale)
void	drawSolid (const PolyLine2f &polyLine)
	Draws a solid (filled) PolyLine2f polyLine. Performance warning: This routine tesselates the polygon into triangles. Consider using Triangulator directly.
void	draw (const TriMesh2d &mesh)
	Draws a cinder::TriMesh mesh at the origin.
void	drawRange (const TriMesh2d &mesh, size_t startTriangle, size_t triangleCount)
	Draws a range of triangles starting with triangle # startTriangle and a count of triangleCount from cinder::TriMesh mesh at the origin.
void	draw (const TriMesh &mesh)
	Draws a cinder::TriMesh mesh at the origin.
void	drawRange (const TriMesh &mesh, size_t startTriangle, size_t triangleCount)
	Draws a range of triangles starting with triangle # startTriangle and a count of triangleCount from cinder::TriMesh mesh at the origin.
void	draw (const VboMesh &vbo)
	Draws a cinder::gl::VboMesh mesh at the origin.
void	drawRange (const VboMesh &vbo, size_t startIndex, size_t indexCount, int vertexStart=-1, int vertexEnd=-1)
	Draws a range of vertices and elements of cinder::gl::VboMesh mesh at the origin. Default parameters for vertexStart and vertexEnd imply the VboMesh's full range of vertices.
void	drawArrays (const VboMesh &vbo, GLint first, GLsizei count)
	Draws a range of elements from a cinder::gl::VboMesh vbo.
void	drawBillboard (const Vec3f &pos, const Vec2f &scale, float rotationDegrees, const Vec3f &bbRight, const Vec3f &bbUp)
	Draws a textured quad of size scale that is aligned with the vectors bbRight and bbUp at pos, rotated by rotationDegrees around the vector orthogonal to bbRight and bbUp.
void	draw (const Texture &texture)
	Draws texture on the XY-plane.
void	draw (const Texture &texture, const Vec2f &pos)
	Draws texture on the XY-plane at pos.
void	draw (const Texture &texture, const Rectf &rect)
	Draws texture on the XY-plane in the rectangle defined by rect.
void	draw (const Texture &texture, const Area &srcArea, const Rectf &destRect)
	Draws the pixels inside srcArea of texture on the XY-plane in the rectangle defined by destRect.
void	drawString (const std::string &str, const Vec2f &pos, const ColorA &color=ColorA(1, 1, 1, 1), Font font=Font())
	Draws a string str with its lower left corner located at pos. Optional font and color affect the style.
void	drawStringCentered (const std::string &str, const Vec2f &pos, const ColorA &color=ColorA(1, 1, 1, 1), Font font=Font())
	Draws a string str with the horizontal center of its baseline located at pos. Optional font and color affect the style.
void	drawStringRight (const std::string &str, const Vec2f &pos, const ColorA &color=ColorA(1, 1, 1, 1), Font font=Font())
	Draws a right-justified string str with the center of its located at pos. Optional font and color affect the style.
set< Font::Glyph >	getNecessaryGlyphs (const Font &font, const string &supportedChars)
void	disableVerticalSync ()
	Disables wait for vertical sync.
void	setMatricesWindowPersp (const Vec2i &screenSize, float fovDegrees=60.0f, float nearPlane=1.0f, float farPlane=1000.0f, bool originUpperLeft=true)
	Sets the viewport and MODELVIEW and PROJECTION matrices to be a perspective projection with the upper-left corner at [0,0] and the lower-right at [screenWidth,screenHeight], but flipped vertically if not originUpperLeft.
void	setMatricesWindow (const Vec2i &screenSize, bool originUpperLeft=true)
	Sets the viewport and the MODELVIEW and PROJECTION matrices to orthographic with the upper-left corner at [0,0] and the lower-right at [size.x,size.y] if originUpperLeft is true. Otherwise the origin is in the lower right.
void	translate (float x, float y)
	Produces a translation by x and y in the current matrix.
void	translate (float x, float y, float z)
	Produces a translation by x, y and z in the current matrix.
void	scale (const Vec2f &scl)
	Produces a scale by scl in the current matrix.
void	scale (float x, float y)
	Produces a scale by x and y in the current matrix.
void	scale (float x, float y, float z)
	Produces a scale by x, y and z in the current matrix.
void	rotate (float degrees)
	Produces a 2D rotation, the equivalent of a rotation around the Z axis by degrees.
void	begin (GLenum mode)
	Equivalent to glBegin() in immediate mode.
void	end ()
	Equivalent to glEnd() in immediate mode.
void	vertex (const Vec2f &v)
	Used between calls to gl::begin() and gl::end(), appends a vertex to the current primitive.
void	vertex (float x, float y)
	Used between calls to gl::begin() and gl::end(), appends a vertex to the current primitive.
void	vertex (const Vec3f &v)
	Used between calls to gl::begin() and gl::end(), appends a vertex to the current primitive.
void	vertex (float x, float y, float z)
	Used between calls to gl::begin() and gl::end(), appends a vertex to the current primitive.
void	texCoord (float x, float y)
	Used between calls to gl::begin() and gl::end(), sets the 2D texture coordinate for the next vertex.
void	texCoord (const Vec2f &v)
	Used between calls to gl::begin() and gl::end(), sets the 2D texture coordinate for the next vertex.
void	texCoord (float x, float y, float z)
	Used between calls to gl::begin() and gl::end(), sets the 3D texture coordinate for the next vertex.
void	texCoord (const Vec3f &v)
	Used between calls to gl::begin() and gl::end(), sets the 3D texture coordinate for the next vertex.
void	color (float r, float g, float b)
	Sets the current color and the alpha value to 1.0.
void	color (float r, float g, float b, float a)
	Sets the current color and alpha value.
void	color (const Color8u &c)
	Sets the current color, and the alpha value to 1.0.
void	color (const ColorA8u &c)
	Sets the current color and alpha value.
void	enable (GLenum state)
	Enables the OpenGL State state. Equivalent to calling to glEnable( state );.
void	disable (GLenum state)
	Disables the OpenGL State state. Equivalent to calling to glDisable( state );.
void	lineWidth (float width)
	Specifies the rasterized width of both aliased and antialiased lines.
void	drawStrokedCube (const AxisAlignedBox3f &aab)
	Renders a stroked cube aab.
void	draw (const class PolyLine< Vec2f > &polyLine)
	Draws a 2d PolyLine polyLine.
void	draw (const class PolyLine< Vec3f > &polyLine)
	Draws a 3d PolyLine polyLine.
void	draw (const class Path2d &path2d, float approximationScale=1.0f)
	Draws a Path2d path2d using approximation scale approximationScale. 1.0 corresponds to screenspace, 2.0 is double screen resolution, etc.
void	draw (const class Shape2d &shape2d, float approximationScale=1.0f)
	Draws a Shape2d shape2d using approximation scale approximationScale. 1.0 corresponds to screenspace, 2.0 is double screen resolution, etc.
void	drawSolid (const class Path2d &path2d, float approximationScale=1.0f)
	Draws a solid (filled) Path2d path2d using approximation scale approximationScale. 1.0 corresponds to screenspace, 2.0 is double screen resolution, etc. Performance warning: This routine tesselates the polygon into triangles. Consider using Triangulator directly.
void	drawSolid (const class Shape2d &shape2d, float approximationScale=1.0f)
	Draws a solid (filled) Shape2d shape2d using approximation scale approximationScale. 1.0 corresponds to screenspace, 2.0 is double screen resolution, etc. Performance warning: This routine tesselates the polygon into triangles. Consider using Triangulator directly.
void	draw (const VboMeshRef &vbo)
void	drawRange (const VboMeshRef &vbo, size_t startIndex, size_t indexCount, int vertexStart=-1, int vertexEnd=-1)
void	drawArrays (const VboMeshRef &vbo, GLint first, GLsizei count)
void	draw (const TextureRef &texture)
void	draw (const TextureRef &texture, const Vec2f &pos)
void	draw (const TextureRef &texture, const Rectf &rect)
void	draw (const TextureRef &texture, const Area &srcArea, const Rectf &destRect)
void	draw (const svg::Doc &svg)

---

Typedef Documentation

typedef std::shared_ptr< Texture > cinder::gl::TextureRef

typedef std::shared_ptr< VboMesh > cinder::gl::VboMeshRef

typedef std::shared_ptr<GlslProg> cinder::gl::GlslProgRef

typedef std::shared_ptr<class TextureFont> cinder::gl::TextureFontRef

---

Function Documentation

void cinder::gl::initializeGlee

(

)

Initializes the GLee library. This is generally called automatically by the application and is only necessary if you need to use GLee before your app's setup() method is called.

bool cinder::gl::isExtensionAvailable

(

const std::string &

extName

)

Returns whether a particular OpenGL extension is available. Caches results.

void cinder::gl::clear	(	const ColorA &	color,
		bool	clearDepthBuffer
	)

Clears the OpenGL color buffer using color and optionally clears the depth buffer when clearDepthBuffer.

void cinder::gl::enableVerticalSync

(

bool

enable

)

Enables or disables wait for vertical sync.

bool cinder::gl::isVerticalSyncEnabled

(

)

Returns whether vertical sync is enabled for the current context.

void cinder::gl::setModelView

(

const Camera &

cam

)

Sets the MODELVIEW matrix to reflect the values of cam. Leaves the MatrixMode as MODELVIEW.

void cinder::gl::setProjection

(

const Camera &

cam

)

Sets the PROJECTION matrix to reflect the values of cam. Leaves the MatrixMode as PROJECTION.

void cinder::gl::setMatrices

(

const Camera &

cam

)

Sets the MODELVIEW and PROJECTION matrices to reflect the values of cam. Leaves the MatrixMode as MODELVIEW.

void cinder::gl::pushModelView

(

)

Pushes the MODELVIEW matrix onto its stack, preserving the current values. Leaves the MatrixMode as MODELVIEW.

void cinder::gl::popModelView

(

)

Pops the MODELVIEW matrix off of its stack, restoring the values saved with the previous push. Leaves the MatrixMode as MODELVIEW.

void cinder::gl::pushModelView

(

const Camera &

cam

)

Pushes the MODELVIEW matrix onto its stack, preserving the current values, and then sets the matrix to reflect cam. Leaves the MatrixMode as MODELVIEW.

void cinder::gl::pushProjection

(

const Camera &

cam

)

Pushes the PROJECTION matrix onto its stack, preserving the current values, and then sets the matrix to reflect cam. Leaves the MatrixMode as PROJECTION.

void cinder::gl::pushMatrices

(

)

Pushes the MODELVIEW and PROJECTION matrices onto their stacks, preserving the current values. Leaves the MatrixMode as MODELVIEW.

void cinder::gl::popMatrices

(

)

Pops the MODELVIEW and PROJECTION matrices off their stacks, restoring the values saved with the previous push. Leaves the MatrixMode as MODELVIEW.

void cinder::gl::multModelView

(

const Matrix44f &

mtx

)

Multiplies the current MODELVIEW matrix with mtx. Leaves the MatrixMode as MODELVIEW.

void cinder::gl::multProjection

(

const Matrix44f &

mtx

)

Multiplies the current PROJECTION matrix with mtx. Leaves the MatrixMode as MODELVIEW.

Matrix44f cinder::gl::getModelView

(

)

Returns the value of the current MODELVIEW matrix as a Matrix44f.

Matrix44f cinder::gl::getProjection

(

)

Returns the value of the current PROJECTION matrix as a Matrix44f.

void cinder::gl::setMatricesWindowPersp	(	int	screenWidth,
		int	screenHeight,
		float	fovDegrees,
		float	nearPlane,
		float	farPlane,
		bool	originUpperLeft
	)

Sets the viepwort and MODELVIEW and PROJECTION matrices to be a perspective projection with the upper-left corner at [0,0] and the lower-right at [screenWidth,screenHeight], but flipped vertically if not originUpperLeft.

void cinder::gl::setMatricesWindow	(	int	screenWidth,
		int	screenHeight,
		bool	originUpperLeft
	)

Sets the viewport and MODELVIEW and PROJECTION matrices to orthographic with the upper-left corner at [0,0] and the lower-right at [screenWidth,screenHeight] if originUpperLeft is true. Otherwise the origin is in the lower right.

Area cinder::gl::getViewport

(

)

Returns the current OpenGL Viewport as an Area.

void cinder::gl::setViewport

(

const Area &

area

)

Sets the current OpenGL Viewport to area.

void cinder::gl::translate

(

const Vec2f &

pos

)

Produces a translation by pos in the current matrix.

void cinder::gl::translate

(

const Vec3f &

pos

)

Produces a translation by pos in the current matrix.

void cinder::gl::scale

(

const Vec3f &

scale

)

Produces a scale by scale in the current matrix.

void cinder::gl::rotate

(

const Vec3f &

xyz

)

Produces a rotation around the X-axis by xyz.x degrees, the Y-axis by xyz.y degrees and the Z-axis by xyz.z degrees in the current matrix. Processed in X-Y-Z order.

void cinder::gl::rotate

(

const Quatf &

quat

)

Produces a rotation by the quaternion quat in the current matrix.

void cinder::gl::enableAlphaBlending

(

bool

premultiplied

)

Enables alpha blending. Selects a BlendFunc that is appropriate for premultiplied-alpha when premultiplied.

void cinder::gl::disableAlphaBlending

(

)

Disables alpha blending.

void cinder::gl::enableAdditiveBlending

(

)

Enables alpha blending and selects a BlendFunc for additive blending.

void cinder::gl::enableAlphaTest	(	float	value,
		int	func
	)

Enables alpha testing and sets the AlphaFunc to test for values which are func than value, which should be in the range [0, 1.0]. Possible values for func include GL_NEVER, GL_LESS, GL_EQUAL, GL_LEQUAL, GL_GREATER, GL_NOTEQUAL, GL_GEQUAL and GL_ALWAYS.

void cinder::gl::disableAlphaTest

(

)

Disables alpha testing.

void cinder::gl::enableWireframe

(

)

Enables wireframe drawing by setting the PolygonMode to GL_LINE.

void cinder::gl::disableWireframe

(

)

Disables wireframe drawing.

void cinder::gl::disableDepthRead

(

)

Disables reading from the depth buffer, disabling z-testing.

void cinder::gl::enableDepthRead

(

bool

enable

)

Enables reading from the depth buffer when enable, enabling z-testing.

void cinder::gl::enableDepthWrite

(

bool

enable

)

Enables writing to the depth buffer when enable.

void cinder::gl::disableDepthWrite

(

)

Disables writing to the depth buffer.

void cinder::gl::drawLine	(	const Vec2f &	start,
		const Vec2f &	end
	)

Draws a line from start to end.

void cinder::gl::drawLine	(	const Vec3f &	start,
		const Vec3f &	end
	)

Draws a line from start to end.

void cinder::gl::drawCube	(	const Vec3f &	center,
		const Vec3f &	size
	)

Renders a solid cube centered at center of size size. Normals and created texture coordinates are generated for GL_TEXTURE_2D, with each face in the range [0,0] - [1.0,1.0].

void cinder::gl::drawColorCube	(	const Vec3f &	center,
		const Vec3f &	size
	)

Renders a solid cube centered at center of size size. Each face is assigned a unique color, and no normals or texture coordinates are generated.

void cinder::gl::drawStrokedCube	(	const Vec3f &	center,
		const Vec3f &	size
	)

Renders a stroked cube centered at center of size size.

void cinder::gl::drawSphere	(	const Vec3f &	center,
		float	radius,
		int	segments
	)

Renders a solid sphere centered at center of radius radius. segments defines how many segments the sphere is subdivided into. Normals and texture coordinates in the range [0,1] are generated.

void cinder::gl::draw	(	const class Sphere &	sphere,
		int	segments
	)

Renders a solid sphere. segments defines how many segments the sphere is subdivided into. Normals and texture coordinates in the range [0,1] are generated.

void cinder::gl::drawSolidCircle	(	const Vec2f &	center,
		float	radius,
		int	numSegments
	)

Renders a solid circle using triangle fans. The default value of zero for numSegments automatically determines a number of segments based on the circle's circumference.

void cinder::gl::drawStrokedCircle	(	const Vec2f &	center,
		float	radius,
		int	numSegments
	)

Renders a stroked circle using a line loop. The default value of zero for numSegments automatically determines a number of segments based on the circle's circumference.

void cinder::gl::drawSolidEllipse	(	const Vec2f &	center,
		float	radiusX,
		float	radiusY,
		int	numSegments
	)

Renders a solid ellipse using triangle fans. The default value of zero for numSegments automatically determines a number of segments based on the ellipse's circumference.

void cinder::gl::drawStrokedEllipse	(	const Vec2f &	center,
		float	radiusX,
		float	radiusY,
		int	numSegments
	)

Renders a stroked circle using a line loop. The default value of zero for numSegments automatically determines a number of segments based on the circle's circumference.

void cinder::gl::drawSolidRect	(	const Rectf &	rect,
		bool	textureRectangle
	)

Renders a solid rectangle. Texture coordinates in the range [0,1] are generated unless textureRectangle.

void cinder::gl::drawStrokedRect

(

const Rectf &

rect

)

Renders a stroked rectangle.

void cinder::gl::drawSolidRoundedRect	(	const Rectf &	r,
		float	cornerRadius,
		int	numSegmentsPerCorner
	)

void cinder::gl::drawStrokedRoundedRect	(	const Rectf &	r,
		float	cornerRadius,
		int	numSegmentsPerCorner
	)

void cinder::gl::drawSolidTriangle	(	const Vec2f &	pt1,
		const Vec2f &	pt2,
		const Vec2f &	pt3
	)

Renders a coordinate frame representation centered at the origin. Arrowheads are drawn at the end of each axis with radius headRadius and length headLength. Renders a solid triangle.

void cinder::gl::drawSolidTriangle

(

const Vec2f

pts[3]

)

void cinder::gl::drawSolidTriangle	(	const Vec2f &	pt1,
		const Vec2f &	pt2,
		const Vec2f &	pt3,
		const Vec2f &	texPt1,
		const Vec2f &	texPt2,
		const Vec2f &	texPt3
	)

Renders a textured triangle.

void cinder::gl::drawSolidTriangle	(	const Vec2f	pts[3],
		const Vec2f	texCoord[3]
	)

void cinder::gl::drawStrokedTriangle	(	const Vec2f &	pt1,
		const Vec2f &	pt2,
		const Vec2f &	pt3
	)

Renders a stroked triangle.

void cinder::gl::drawStrokedTriangle

(

const Vec2f

pts[3]

)

void cinder::gl::drawCoordinateFrame	(	float	axisLength,
		float	headLength,
		float	headRadius
	)

void cinder::gl::drawVector	(	const Vec3f &	start,
		const Vec3f &	end,
		float	headLength,
		float	headRadius
	)

Draws a vector starting at start and ending at end. An arrowhead is drawn at the end of radius headRadius and length headLength.

void cinder::gl::drawFrustum

(

const Camera &

cam

)

Draws a wireframe representation of the frustum defined by cam.

void cinder::gl::drawTorus	(	float	outterRadius,
		float	innerRadius,
		int	longitudeSegments,
		int	latitudeSegments
	)

Draws a torus at the origin, with an outter radius outterRadius and an inner radius innerRadius, subdivided into longitudeSegments and latitudeSegments. Normals and texture coordinates in the range [0,1] are generated.

void cinder::gl::drawCylinder	(	float	base,
		float	top,
		float	height,
		int	slices,
		int	stacks
	)

Draws a open-ended cylinder, with base radius baseRadius and top radius topRadius, with height height, subdivided into slices and stacks. Normals and texture coordinates in the range [0,1] are generated.

void cinder::gl::draw

(

const PolyLine< Vec2f > &

polyLine

)

void cinder::gl::draw

(

const PolyLine< Vec3f > &

polyLine

)

void cinder::gl::draw	(	const Path2d &	path2d,
		float	approximationScale
	)

void cinder::gl::draw	(	const Shape2d &	shape2d,
		float	approximationScale
	)

void cinder::gl::drawSolid	(	const Path2d &	path2d,
		float	approximationScale
	)

void cinder::gl::drawSolid	(	const Shape2d &	shape2d,
		float	approximationScale
	)

void cinder::gl::drawSolid

(

const PolyLine2f &

polyLine

)

Draws a solid (filled) PolyLine2f polyLine. Performance warning: This routine tesselates the polygon into triangles. Consider using Triangulator directly.

void cinder::gl::draw

(

const TriMesh2d &

mesh

)

Draws a cinder::TriMesh mesh at the origin.

void cinder::gl::drawRange	(	const TriMesh2d &	mesh,
		size_t	startTriangle,
		size_t	triangleCount
	)

Draws a range of triangles starting with triangle # startTriangle and a count of triangleCount from cinder::TriMesh mesh at the origin.

void cinder::gl::draw

(

const TriMesh &

mesh

)

Draws a cinder::TriMesh mesh at the origin.

void cinder::gl::drawRange	(	const TriMesh &	mesh,
		size_t	startTriangle,
		size_t	triangleCount
	)

Draws a range of triangles starting with triangle # startTriangle and a count of triangleCount from cinder::TriMesh mesh at the origin.

void cinder::gl::draw

(

const VboMesh &

vbo

)

Draws a cinder::gl::VboMesh mesh at the origin.

void cinder::gl::drawRange	(	const VboMesh &	vbo,
		size_t	startIndex,
		size_t	indexCount,
		int	vertexStart,
		int	vertexEnd
	)

Draws a range of vertices and elements of cinder::gl::VboMesh mesh at the origin. Default parameters for vertexStart and vertexEnd imply the VboMesh's full range of vertices.

void cinder::gl::drawArrays	(	const VboMesh &	vbo,
		GLint	first,
		GLsizei	count
	)

Draws a range of elements from a cinder::gl::VboMesh vbo.

void cinder::gl::drawBillboard	(	const Vec3f &	pos,
		const Vec2f &	scale,
		float	rotationDegrees,
		const Vec3f &	bbRight,
		const Vec3f &	bbUp
	)

Draws a textured quad of size scale that is aligned with the vectors bbRight and bbUp at pos, rotated by rotationDegrees around the vector orthogonal to bbRight and bbUp.

void cinder::gl::draw

(

const Texture &

texture

)

Draws texture on the XY-plane.

void cinder::gl::draw	(	const Texture &	texture,
		const Vec2f &	pos
	)

Draws texture on the XY-plane at pos.

void cinder::gl::draw	(	const Texture &	texture,
		const Rectf &	rect
	)

Draws texture on the XY-plane in the rectangle defined by rect.

void cinder::gl::draw	(	const Texture &	texture,
		const Area &	srcArea,
		const Rectf &	destRect
	)

Draws the pixels inside srcArea of texture on the XY-plane in the rectangle defined by destRect.

void cinder::gl::drawString	(	const std::string &	str,
		const Vec2f &	pos,
		const ColorA &	color,
		Font	font
	)

Draws a string str with its lower left corner located at pos. Optional font and color affect the style.

void cinder::gl::drawStringCentered	(	const std::string &	str,
		const Vec2f &	pos,
		const ColorA &	color,
		Font	font
	)

Draws a string str with the horizontal center of its baseline located at pos. Optional font and color affect the style.

void cinder::gl::drawStringRight	(	const std::string &	str,
		const Vec2f &	pos,
		const ColorA &	color,
		Font	font
	)

Draws a right-justified string str with the center of its located at pos. Optional font and color affect the style.

set<Font::Glyph> cinder::gl::getNecessaryGlyphs	(	const Font &	font,
		const string &	supportedChars
	)

void cinder::gl::disableVerticalSync

(

)

Disables wait for vertical sync.

void cinder::gl::setMatricesWindowPersp	(	const Vec2i &	screenSize,
		float	fovDegrees = 60.0f,
		float	nearPlane = 1.0f,
		float	farPlane = 1000.0f,
		bool	originUpperLeft = true
	)

Sets the viewport and MODELVIEW and PROJECTION matrices to be a perspective projection with the upper-left corner at [0,0] and the lower-right at [screenWidth,screenHeight], but flipped vertically if not originUpperLeft.

void cinder::gl::setMatricesWindow	(	const Vec2i &	screenSize,
		bool	originUpperLeft = true
	)

Sets the viewport and the MODELVIEW and PROJECTION matrices to orthographic with the upper-left corner at [0,0] and the lower-right at [size.x,size.y] if originUpperLeft is true. Otherwise the origin is in the lower right.

void cinder::gl::translate	(	float	x,
		float	y
	)

Produces a translation by x and y in the current matrix.

void cinder::gl::translate	(	float	x,
		float	y,
		float	z
	)

Produces a translation by x, y and z in the current matrix.

void cinder::gl::scale

(

const Vec2f &

scl

)

Produces a scale by scl in the current matrix.

void cinder::gl::scale	(	float	x,
		float	y
	)

Produces a scale by x and y in the current matrix.

void cinder::gl::scale	(	float	x,
		float	y,
		float	z
	)

Produces a scale by x, y and z in the current matrix.

void cinder::gl::rotate

(

float

degrees

)

Produces a 2D rotation, the equivalent of a rotation around the Z axis by degrees.

void cinder::gl::begin

(

GLenum

mode

)

Equivalent to glBegin() in immediate mode.

void cinder::gl::end

(

)

Equivalent to glEnd() in immediate mode.

void cinder::gl::vertex

(

const Vec2f &

v

)

Used between calls to gl::begin() and gl::end(), appends a vertex to the current primitive.

void cinder::gl::vertex	(	float	x,
		float	y
	)

Used between calls to gl::begin() and gl::end(), appends a vertex to the current primitive.

void cinder::gl::vertex

(

const Vec3f &

v

)

Used between calls to gl::begin() and gl::end(), appends a vertex to the current primitive.

void cinder::gl::vertex	(	float	x,
		float	y,
		float	z
	)

Used between calls to gl::begin() and gl::end(), appends a vertex to the current primitive.

void cinder::gl::texCoord	(	float	x,
		float	y
	)

Used between calls to gl::begin() and gl::end(), sets the 2D texture coordinate for the next vertex.

void cinder::gl::texCoord

(

const Vec2f &

v

)

Used between calls to gl::begin() and gl::end(), sets the 2D texture coordinate for the next vertex.

void cinder::gl::texCoord	(	float	x,
		float	y,
		float	z
	)

Used between calls to gl::begin() and gl::end(), sets the 3D texture coordinate for the next vertex.

void cinder::gl::texCoord

(

const Vec3f &

v

)

Used between calls to gl::begin() and gl::end(), sets the 3D texture coordinate for the next vertex.

void cinder::gl::color	(	float	r,
		float	g,
		float	b
	)

Sets the current color and the alpha value to 1.0.

void cinder::gl::color	(	float	r,
		float	g,
		float	b,
		float	a
	)

Sets the current color and alpha value.

void cinder::gl::color

(

const Color8u &

c

)

Sets the current color, and the alpha value to 1.0.

void cinder::gl::color

(

const ColorA8u &

c

)

Sets the current color and alpha value.

void cinder::gl::enable

(

GLenum

state

)

Enables the OpenGL State state. Equivalent to calling to glEnable( state );.

void cinder::gl::disable

(

GLenum

state

)

Disables the OpenGL State state. Equivalent to calling to glDisable( state );.

void cinder::gl::lineWidth

(

float

width

)

Specifies the rasterized width of both aliased and antialiased lines.

void cinder::gl::drawStrokedCube

(

const AxisAlignedBox3f &

aab

)

Renders a stroked cube aab.

void cinder::gl::draw

(

const class PolyLine< Vec2f > &

polyLine

)

Draws a 2d PolyLine polyLine.

void cinder::gl::draw

(

const class PolyLine< Vec3f > &

polyLine

)

Draws a 3d PolyLine polyLine.

void cinder::gl::draw	(	const class Path2d &	path2d,
		float	approximationScale = 1.0f
	)

Draws a Path2d path2d using approximation scale approximationScale. 1.0 corresponds to screenspace, 2.0 is double screen resolution, etc.

void cinder::gl::draw	(	const class Shape2d &	shape2d,
		float	approximationScale = 1.0f
	)

Draws a Shape2d shape2d using approximation scale approximationScale. 1.0 corresponds to screenspace, 2.0 is double screen resolution, etc.

void cinder::gl::drawSolid	(	const class Path2d &	path2d,
		float	approximationScale = 1.0f
	)

Draws a solid (filled) Path2d path2d using approximation scale approximationScale. 1.0 corresponds to screenspace, 2.0 is double screen resolution, etc. Performance warning: This routine tesselates the polygon into triangles. Consider using Triangulator directly.

void cinder::gl::drawSolid	(	const class Shape2d &	shape2d,
		float	approximationScale = 1.0f
	)

Draws a solid (filled) Shape2d shape2d using approximation scale approximationScale. 1.0 corresponds to screenspace, 2.0 is double screen resolution, etc. Performance warning: This routine tesselates the polygon into triangles. Consider using Triangulator directly.

void cinder::gl::draw

(

const VboMeshRef &

vbo

)

void cinder::gl::drawRange	(	const VboMeshRef &	vbo,
		size_t	startIndex,
		size_t	indexCount,
		int	vertexStart = -1,
		int	vertexEnd = -1
	)

void cinder::gl::drawArrays	(	const VboMeshRef &	vbo,
		GLint	first,
		GLsizei	count
	)

void cinder::gl::draw

(

const TextureRef &

texture

)

void cinder::gl::draw	(	const TextureRef &	texture,
		const Vec2f &	pos
	)

void cinder::gl::draw	(	const TextureRef &	texture,
		const Rectf &	rect
	)

void cinder::gl::draw	(	const TextureRef &	texture,
		const Area &	srcArea,
		const Rectf &	destRect
	)

void cinder::gl::draw

(

const svg::Doc &

svg

)