-

Detailed Description

-

This class provides a quick way to draw shapes for use in debugging or simple scenes.

-

You can specify the color for each shape as part of the Draw...() call. Other lighting parameters (the intensity of the light, advanced material properties) are pre-set to reasonable defaults that apply to all of the shapes drawn. You can edit these if you wish, but note that the intent of this class is just to provide a quick way to draw shapes – this is not the right tool to use if you wish to do quality renderings and use multiple types of materials.

-

Example usage: ~~~ define a new QuickShapes object during initialization, or as a class member variable QuickShapes quick_shapes;

-

void DrawUsingOpenGL() { later, in your draw routine, use it to draw shapes Matrix4 view = Matrix4::LookAt(Point3(0,0,3), Point3(0,0,0), Vector3(0,1,0)); Matrix4 proj = Matrix4::Perspective(60.0, aspect_ratio(), 0.1, 10.0);

-

Matrix4 m_cube = Matrix4::Translation(Vector3(-2.5,0,0)) * Matrix4::Scale(Vector3(0.5, 0.5, 0.5)); quick_shapes.DrawCube(m_cube, view, proj, Color(1,1,1));

-

Matrix4 m_sphere = Matrix4::Scale(Vector3(2.5, 2.5, 2.5)); quick_shapes.DrawSphere(m_sphere, view, proj, Color(1,1,1));

-

Matrix4 m_loop; std::vector<Point3> loop; loop.push_back(Point3( 4.0, 4.0, -4.0)); loop.push_back(Point3(-4.0, 4.0, -4.0)); loop.push_back(Point3(-4.0, 4.0, 4.0)); loop.push_back(Point3( 4.0, 4.0, 4.0)); quick_shapes.DrawLines(m_loop, view, proj, Color(1,1,1), loop, QuickShapes::LinesType::LINE_LOOP, 0.1); } ~~~

- -

Definition at line 69 of file quick_shapes.h.

-

#include <quick_shapes.h>

- - - - -

-Public Types
enum class	LinesType { LINES -, LINE_STRIP -, LINE_LOOP - }

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

-Public Member Functions
	QuickShapes ()

virtual	~QuickShapes ()

void	DrawCube (const Matrix4 &modelMatrix, const Matrix4 &viewMatrix, const Matrix4 &projectionMatrix, const Color &color)
	Draws a cube with extents -1 to 1 given the model, view, and projection matrices provided and using the supplied color as a material property. More...

void	DrawCylinder (const Matrix4 &modelMatrix, const Matrix4 &viewMatrix, const Matrix4 &projectionMatrix, const Color &color)
	Draws a cylinder with radius 1 and height y=-1 to 1 given the model, view, and projection matrices provided and using the supplied color as a material property. More...

void	DrawCone (const Matrix4 &modelMatrix, const Matrix4 &viewMatrix, const Matrix4 &projectionMatrix, const Color &color)
	Draws a cone with radius 1 and height y=-1 to 1 given the model, view, and projection matrices provided and using the supplied color as a material property. More...

void	DrawSphere (const Matrix4 &modelMatrix, const Matrix4 &viewMatrix, const Matrix4 &projectionMatrix, const Color &color)
	Draws a sphere with radius 1 given the model, view, and projection matrices provided and using the supplied color as a material property. More...

void	DrawBrush (const Matrix4 &modelMatrix, const Matrix4 &viewMatrix, const Matrix4 &projectionMatrix, const Color &color)
	Draws the classic 3D paintbrush cursor from the 2001 Keefe et al. More...

void	DrawLineSegment (const Matrix4 &modelMatrix, const Matrix4 &viewMatrix, const Matrix4 &projectionMatrix, const Color &color, const Point3 &p1, const Point3 &p2, float radius)
	Draws a cylinder between the two points. More...

void	DrawLines (const Matrix4 &modelMatrix, const Matrix4 &viewMatrix, const Matrix4 &projectionMatrix, const Color &color, const std::vector< Point3 > &points, LinesType linesType, float radius)
	Draws a series of line segments. More...

void	DrawArrow (const Matrix4 &modelMatrix, const Matrix4 &viewMatrix, const Matrix4 &projectionMatrix, const Color &color, Point3 p, Vector3 dir, float radius)
	Draws an arrow originating at point p and extending in the direction and length specified by dir. More...

void	DrawAxes (const Matrix4 &modelMatrix, const Matrix4 &viewMatrix, const Matrix4 &projectionMatrix)
	Draws a right handed set of axes at the coordinate frame specified by the modelMatrix. More...

void	DrawSquare (const Matrix4 &modelMatrix, const Matrix4 &viewMatrix, const Matrix4 &projectionMatrix, const Color &color)
	Draws a square in the X-Y plane with extents -1 to 1 and normal in the +Y direction. More...

void	DrawSquare (const Matrix4 &modelMatrix, const Matrix4 &viewMatrix, const Matrix4 &projectionMatrix, const Color &color, const Texture2D &texture)
	Draws a square, which you can deform into some other shape by adjusting the model matrix, and applies a texture to it. More...

void	DrawFullscreenTexture (const Color &color, const Texture2D &texture)
	Draws a background texture across the whole screen. More...

DefaultShader *	default_shader ()
	Returns a pointer to the default shader used internally by the Draw class so that you may change the default lighting properties if you wish. More...

DefaultShader::MaterialProperties *	material ()
	Returns a pointer to the default material properties for the shapes so that you may adjust the reflectance properties used by all the shapes if needed. More...

-

Member Enumeration Documentation

- -

◆ LinesType

- -

-

- - - - - -

- - - - -

enum mingfx::QuickShapes::LinesType

-

-strong

-

- - - - -

Enumerator
LINES
LINE_STRIP
LINE_LOOP

- -

Definition at line 134 of file quick_shapes.h.

- -

-

Constructor & Destructor Documentation

- -

◆ QuickShapes()

- -

-

- - - - - - - -

mingfx::QuickShapes::QuickShapes ( )

-

- -

-

- -

◆ ~QuickShapes()

- -

-

- - - - - -

- - - - - - - -

virtual mingfx::QuickShapes::~QuickShapes ( )

-

-virtual

-

- -

-

Member Function Documentation

- -

◆ default_shader()

- -

-

- - - - - - - -

DefaultShader* mingfx::QuickShapes::default_shader ( )

-

- -

Returns a pointer to the default shader used internally by the Draw class so that you may change the default lighting properties if you wish.

- -

-

- -

◆ DrawArrow()

- -

-

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

void mingfx::QuickShapes::DrawArrow	(	const Matrix4 &	modelMatrix,
		const Matrix4 &	viewMatrix,
		const Matrix4 &	projectionMatrix,
		const Color &	color,
		Point3	p,
		Vector3	dir,
		float	radius
	)

-

- -

Draws an arrow originating at point p and extending in the direction and length specified by dir.

-

radius is the radius of the cylinder used to draw the shaft of the arrow.

- -

-

- -

◆ DrawAxes()

- -

-

- - - - - - - - - - - - - - - - - - - - - - - - -

void mingfx::QuickShapes::DrawAxes	(	const Matrix4 &	modelMatrix,
		const Matrix4 &	viewMatrix,
		const Matrix4 &	projectionMatrix
	)

-

- -

Draws a right handed set of axes at the coordinate frame specified by the modelMatrix.

-

The arrows are 1 unit in length and colored based on the axis: X=red, Y=green, Z=blue.

- -

-

- -

◆ DrawBrush()

- -

-

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

void mingfx::QuickShapes::DrawBrush	(	const Matrix4 &	modelMatrix,
		const Matrix4 &	viewMatrix,
		const Matrix4 &	projectionMatrix,
		const Color &	color
	)

-

- -

Draws the classic 3D paintbrush cursor from the 2001 Keefe et al.

-

CavePainting paper. The tip of the brush is at (0,0,0), the front flat edge runs along the X axis, and the handle runs in the +Z direction.

- -

-

- -

◆ DrawCone()

- -

-

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

void mingfx::QuickShapes::DrawCone	(	const Matrix4 &	modelMatrix,
		const Matrix4 &	viewMatrix,
		const Matrix4 &	projectionMatrix,
		const Color &	color
	)

-

- -

Draws a cone with radius 1 and height y=-1 to 1 given the model, view, and projection matrices provided and using the supplied color as a material property.

- -

-

- -

◆ DrawCube()

- -

-

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

void mingfx::QuickShapes::DrawCube	(	const Matrix4 &	modelMatrix,
		const Matrix4 &	viewMatrix,
		const Matrix4 &	projectionMatrix,
		const Color &	color
	)

-

- -

Draws a cube with extents -1 to 1 given the model, view, and projection matrices provided and using the supplied color as a material property.

- -

-

- -

◆ DrawCylinder()

- -

-

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

void mingfx::QuickShapes::DrawCylinder	(	const Matrix4 &	modelMatrix,
		const Matrix4 &	viewMatrix,
		const Matrix4 &	projectionMatrix,
		const Color &	color
	)

-

- -

Draws a cylinder with radius 1 and height y=-1 to 1 given the model, view, and projection matrices provided and using the supplied color as a material property.

- -

-

- -

◆ DrawFullscreenTexture()

- -

-

- - - - - - - - - - - - - - - - - - -

void mingfx::QuickShapes::DrawFullscreenTexture	(	const Color &	color,
		const Texture2D &	texture
	)

-

- -

Draws a background texture across the whole screen.

-

Typically, you will want to do this before any other draw calls.

- -

-

- -

◆ DrawLines()

- -

-

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

void mingfx::QuickShapes::DrawLines	(	const Matrix4 &	modelMatrix,
		const Matrix4 &	viewMatrix,
		const Matrix4 &	projectionMatrix,
		const Color &	color,
		const std::vector< Point3 > &	points,
		LinesType	linesType,
		float	radius
	)

-

- -

Draws a series of line segments.

-

Using linesType=LINES connects each consecutive pair of points in the points array with a line. A linesType=LINE_STRIP will connect each point to the next. And, a linesType=LINE_LOOP will connect each point to the next and in addition connect the last to the first. Example:

Matrix4 model;

-Matrix4 view = Matrix4::LookAt(Point3(0,0,3), Point3(0,0,0), Vector3(0,1,0));

-Matrix4 proj = Matrix4::Perspective(60.0, aspect_ratio(), 0.1, 10.0);

-std::vector<Point3> loop;

-loop.push_back(Point3( 4.0, 4.0, -4.0));

-loop.push_back(Point3(-4.0, 4.0, -4.0));

-loop.push_back(Point3(-4.0, 4.0,  4.0));

-loop.push_back(Point3( 4.0, 4.0,  4.0));

-quick_shapes.DrawLines(model, view, proj, Color(1,1,1), loop, QuickShapes::LinesType::LINE_LOOP, 0.1);

-
-
-
-

-

- -

◆ DrawLineSegment()

- -

-

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

void mingfx::QuickShapes::DrawLineSegment	(	const Matrix4 &	modelMatrix,
		const Matrix4 &	viewMatrix,
		const Matrix4 &	projectionMatrix,
		const Color &	color,
		const Point3 &	p1,
		const Point3 &	p2,
		float	radius
	)

-

- -

Draws a cylinder between the two points.

- -

-

- -

◆ DrawSphere()

- -

-

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

void mingfx::QuickShapes::DrawSphere	(	const Matrix4 &	modelMatrix,
		const Matrix4 &	viewMatrix,
		const Matrix4 &	projectionMatrix,
		const Color &	color
	)

-

- -

Draws a sphere with radius 1 given the model, view, and projection matrices provided and using the supplied color as a material property.

- -

-

- -

◆ DrawSquare() [1/2]

- -

-

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

void mingfx::QuickShapes::DrawSquare	(	const Matrix4 &	modelMatrix,
		const Matrix4 &	viewMatrix,
		const Matrix4 &	projectionMatrix,
		const Color &	color
	)

-

- -

Draws a square in the X-Y plane with extents -1 to 1 and normal in the +Y direction.

-

Uses the model, view, and projection matrices provided and the supplied color as a material property.

- -

-

- -

◆ DrawSquare() [2/2]

- -

-

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

void mingfx::QuickShapes::DrawSquare	(	const Matrix4 &	modelMatrix,
		const Matrix4 &	viewMatrix,
		const Matrix4 &	projectionMatrix,
		const Color &	color,
		const Texture2D &	texture
	)

-

- -

Draws a square, which you can deform into some other shape by adjusting the model matrix, and applies a texture to it.

-

The texture must already be bound to the OpenGL textureID provided. The square lies in the X-Y plane with extents -1 to 1 and normal in the +Y direction. No lighting is applied.

- -

-

- -

◆ material()

- -

-

- - - - - - - -

DefaultShader::MaterialProperties* mingfx::QuickShapes::material ( )

-

- -

Returns a pointer to the default material properties for the shapes so that you may adjust the reflectance properties used by all the shapes if needed.

- -

-

The documentation for this class was generated from the following file:

src/quick_shapes.h

-

+Public Types
enum class	LinesType { LINES +, LINE_STRIP +, LINE_LOOP + }

+Public Member Functions
	QuickShapes ()

virtual	~QuickShapes ()

void	DrawCube (const Matrix4 &modelMatrix, const Matrix4 &viewMatrix, const Matrix4 &projectionMatrix, const Color &color)
	Draws a cube with extents -1 to 1 given the model, view, and projection matrices provided and using the supplied color as a material property. More...

void	DrawCylinder (const Matrix4 &modelMatrix, const Matrix4 &viewMatrix, const Matrix4 &projectionMatrix, const Color &color)
	Draws a cylinder with radius 1 and height y=-1 to 1 given the model, view, and projection matrices provided and using the supplied color as a material property. More...

void	DrawCone (const Matrix4 &modelMatrix, const Matrix4 &viewMatrix, const Matrix4 &projectionMatrix, const Color &color)
	Draws a cone with radius 1 and height y=-1 to 1 given the model, view, and projection matrices provided and using the supplied color as a material property. More...

void	DrawSphere (const Matrix4 &modelMatrix, const Matrix4 &viewMatrix, const Matrix4 &projectionMatrix, const Color &color)
	Draws a sphere with radius 1 given the model, view, and projection matrices provided and using the supplied color as a material property. More...

void	DrawBrush (const Matrix4 &modelMatrix, const Matrix4 &viewMatrix, const Matrix4 &projectionMatrix, const Color &color)
	Draws the classic 3D paintbrush cursor from the 2001 Keefe et al. More...

void	DrawLineSegment (const Matrix4 &modelMatrix, const Matrix4 &viewMatrix, const Matrix4 &projectionMatrix, const Color &color, const Point3 &p1, const Point3 &p2, float radius)
	Draws a cylinder between the two points. More...

void	DrawLines (const Matrix4 &modelMatrix, const Matrix4 &viewMatrix, const Matrix4 &projectionMatrix, const Color &color, const std::vector< Point3 > &points, LinesType linesType, float radius)
	Draws a series of line segments. More...

void	DrawArrow (const Matrix4 &modelMatrix, const Matrix4 &viewMatrix, const Matrix4 &projectionMatrix, const Color &color, Point3 p, Vector3 dir, float radius)
	Draws an arrow originating at point p and extending in the direction and length specified by dir. More...

void	DrawAxes (const Matrix4 &modelMatrix, const Matrix4 &viewMatrix, const Matrix4 &projectionMatrix)
	Draws a right handed set of axes at the coordinate frame specified by the modelMatrix. More...

void	DrawSquare (const Matrix4 &modelMatrix, const Matrix4 &viewMatrix, const Matrix4 &projectionMatrix, const Color &color)
	Draws a square in the X-Y plane with extents -1 to 1 and normal in the +Y direction. More...

void	DrawSquare (const Matrix4 &modelMatrix, const Matrix4 &viewMatrix, const Matrix4 &projectionMatrix, const Color &color, const Texture2D &texture)
	Draws a square, which you can deform into some other shape by adjusting the model matrix, and applies a texture to it. More...

void	DrawFullscreenTexture (const Color &color, const Texture2D &texture)
	Draws a background texture across the whole screen. More...

DefaultShader *	default_shader ()
	Returns a pointer to the default shader used internally by the Draw class so that you may change the default lighting properties if you wish. More...

DefaultShader::MaterialProperties *	material ()
	Returns a pointer to the default material properties for the shapes so that you may adjust the reflectance properties used by all the shapes if needed. More...

Detailed Description

-Public Types

-Public Member Functions

Member Enumeration Documentation

◆ LinesType

Constructor & Destructor Documentation

◆ QuickShapes()

◆ ~QuickShapes()

Member Function Documentation

◆ default_shader()

◆ DrawArrow()

◆ DrawAxes()

◆ DrawBrush()

◆ DrawCone()

◆ DrawCube()

◆ DrawCylinder()

◆ DrawFullscreenTexture()

◆ DrawLines()

◆ DrawLineSegment()

◆ DrawSphere()

◆ DrawSquare() [1/2]

◆ DrawSquare() [2/2]

◆ material()

Detailed Description

+Public Types

+Public Member Functions

Member Enumeration Documentation

◆ LinesType

Constructor & Destructor Documentation

◆ QuickShapes()

◆ ~QuickShapes()

Member Function Documentation

◆ default_shader()

◆ DrawArrow()

◆ DrawAxes()

◆ DrawBrush()

◆ DrawCone()

◆ DrawCube()

◆ DrawCylinder()

◆ DrawFullscreenTexture()

◆ DrawLines()

◆ DrawLineSegment()

◆ DrawSphere()

◆ DrawSquare() [1/2]

◆ DrawSquare() [2/2]

◆ material()