plot3d.h File Reference

Definition of the Tplot3d type and the associated functions. More...

#include "defines.h"
#include "boolean.h"
#include "htransform.h"
#include <stdio.h>

Go to the source code of this file.

Data Structures
struct	Tplot3d
	A 3D plot. More...
Defines
#define	DCP3D_R   0
	Red component of the default color of 3d objects.
#define	DCP3D_G   0
	Green component of the default color of 3d objects.
#define	DCP3D_B   1
	Blue component of the default color of 3d objects.
Functions
void	InitPlot3d (char *name, boolean axes, int argc, char **arg, Tplot3d *p)
	Constructor.
unsigned int	StartNew3dObject (Tcolor *c, Tplot3d *p)
	Start a composed object.
void	Close3dObject (Tplot3d *p)
	Closes a composed object.
void	Delete3dObject (unsigned int nobj, Tplot3d *p)
	Deletes a previously created geometric object.
void	Start3dBlock (Tplot3d *p)
	Starts a block of commands.
void	Close3dBlock (Tplot3d *p)
	Ends a block of commands.
void	SetColor3dObject (unsigned int nobj, Tcolor *c, Tplot3d *p)
	Changes the color of an object.
void	Delay3dObject (double t, Tplot3d *p)
	Introduces a delay in the generation of the geometry.
void	Move3dObject (unsigned int nobj, THTransform *t, Tplot3d *p)
	Moves a 3d object.
void	PlotBox3d (double min_x, double max_x, double min_y, double max_y, double min_z, double max_z, Tplot3d *p)
	Adds an axis aligned box to the current object.
void	PlotTriangle3d (double x1, double y1, double z1, double x2, double y2, double z2, double x3, double y3, double z3, Tplot3d *p)
	Adds a triangle to the current object.
void	Plot3dObject (unsigned int nv, unsigned int nf, unsigned int ne, double **v, unsigned int *nvf, unsigned int **fv, Tplot3d *p)
	Adds a polytope to the current object.
void	PlotSphere (double r, double x, double y, double z, Tplot3d *p)
	Adds a sphere to the current object.
void	PlotCylinder (double r, double *p1, double *p2, Tplot3d *p)
	Adds a cylinder to the current object.
void	PlotVect3d (unsigned int n, double *x, double *y, double *z, Tplot3d *p)
	Adds a polyline to the current object.
void	Take3dSnapshot (char *file, Tplot3d *p)
	Takes a screenshot of the geometry.
void	ClosePlot3d (boolean quit, double average_x, double average_y, double average_z, Tplot3d *p)
	Destructor.

---

Detailed Description

Module to generate 3d plots. Right now the output is in geomview format.

See also:

Tplot3d, plot3d.c, Tplot, plot.h.

Definition in file plot3d.h.

---

Define Documentation

#define DCP3D_R   0

Red component of the default color of 3d objects.

See also:

Tplot3d

Definition at line 30 of file plot3d.h.

Referenced by InitPlot3d(), and main().

#define DCP3D_G   0

Green component of the default color of 3d objects.

See also:

Tplot3d

Definition at line 38 of file plot3d.h.

Referenced by InitPlot3d(), and main().

#define DCP3D_B   1

Blue component of the default color of 3d objects.

See also:

Tplot3d

Definition at line 46 of file plot3d.h.

Referenced by main().

---

Function Documentation

void InitPlot3d	(	char *	name,
		boolean	axes,
		int	argc,
		char **	arg,
		Tplot3d *	p
	)

Initializes a 3d plot.

Parameters:

	name	Name of the file where to store the geometry.
	axes	TRUE if we have to add the axes.
	argc	Number of strings to be added to the geometry file header as comments.
	arg	Strings to be added to the geometry file header as comments. Right now, this is used to store in the geometry file the command line used to create it.
	p	The plot to initialize.

Definition at line 34 of file plot3d.c.

References Tplot3d::color, DCP3D_G, DCP3D_R, Error(), Tplot3d::f, FALSE, Tplot3d::fileName, Tplot3d::inObject, NEW, NewColor(), and Tplot3d::nobj.

Referenced by AnimateWorld(), and main().

Here is the call graph for this function:

Here is the caller graph for this function:

unsigned int StartNew3dObject	(	Tcolor *	c,
		Tplot3d *	p
	)

Start the definition of a geometric object composed by one or more basic geometric elements.

Parameters:

	c	Color for the object.
	p	The plot to update.

Returns:

The identifier of the started object.

Definition at line 133 of file plot3d.c.

References Close3dObject(), Tplot3d::color, CopyColor(), Tplot3d::f, Tplot3d::fileName, Tplot3d::inObject, Tplot3d::nobj, and TRUE.

Referenced by main(), PlotCPolyhedron(), PlotJoint(), and PlotLink().

Here is the call graph for this function:

Here is the caller graph for this function:

void Close3dObject

(

Tplot3d *

p

)

Ends the definition of a geometric object composed by many basic geometric elements.

Parameters:

p

The plot to update.

Definition at line 147 of file plot3d.c.

References Tplot3d::color, Tplot3d::f, FALSE, Tplot3d::fileName, Tplot3d::inObject, Tplot3d::nobj, and SetColor3dObject().

Referenced by ClosePlot3d(), PlotCPolyhedron(), PlotJoint(), PlotLink(), and StartNew3dObject().

Here is the call graph for this function:

Here is the caller graph for this function:

void Delete3dObject	(	unsigned int	nobj,
		Tplot3d *	p
	)

Deletes a previously created geometric object. This is used when creating animations.

Parameters:

	nobj	The identifier of the object to be deleted (i.e., the return of StartNew3dObject when the object was created).
	p	The plot to update.

Definition at line 128 of file plot3d.c.

References Tplot3d::f, and Tplot3d::fileName.

void Start3dBlock

(

Tplot3d *

p

)

Starts a block of commands that have to be executed simultaneously. Commands are, for instance, the generation of new geometry of the transformation/deletion of existing objects.

Parameters:

p

The plot to update.

Definition at line 117 of file plot3d.c.

References Tplot3d::f.

Referenced by AnimateWorld(), MoveMechanism(), and PlotMechanism().

Here is the caller graph for this function:

void Close3dBlock

(

Tplot3d *

p

)

Ends a block of commands that have to be executed simultaneously.

Parameters:

p

The plot to update.

Definition at line 122 of file plot3d.c.

References Tplot3d::f.

Referenced by AnimateWorld(), MoveMechanism(), and PlotMechanism().

Here is the caller graph for this function:

void SetColor3dObject	(	unsigned int	nobj,
		Tcolor *	c,
		Tplot3d *	p
	)

Changes the color of an object.

Parameters:

	nobj	The object identifier as returned by StartNew3dObject.
	c	Color for the object.
	p	The plot to update.

Definition at line 160 of file plot3d.c.

References Tplot3d::f, Tplot3d::fileName, Tplot3d::inObject, and PrintColor().

Referenced by Close3dObject().

Here is the call graph for this function:

Here is the caller graph for this function:

void Delay3dObject	(	double	t,
		Tplot3d *	p
	)

Introduces a delay in the generation of the geometry. Used for animations.

Parameters:

	t	Length in seconds of the delay.
	p	The plot to update.

Definition at line 172 of file plot3d.c.

References Tplot3d::f.

Referenced by AnimateWorld().

Here is the caller graph for this function:

void Move3dObject	(	unsigned int	nobj,
		THTransform *	t,
		Tplot3d *	p
	)

Moves a 3d object.

Parameters:

	nobj	The identifier of the object to move, as returned by StartNew3dObject.
	t	The homogenous transoform to apply to the object.
	p	The plot to update.

Definition at line 178 of file plot3d.c.

References Tplot3d::f, Tplot3d::fileName, and HTransformPrintT().

Referenced by MoveCPolyhedron(), MoveJoint(), and MoveLink().

Here is the call graph for this function:

Here is the caller graph for this function:

void PlotBox3d	(	double	min_x,
		double	max_x,
		double	min_y,
		double	max_y,
		double	min_z,
		double	max_z,
		Tplot3d *	p
	)

Adds an axis aligned box to the current object. This command can only be used in between a call to StartNew3dObject and the corresponding call to Close3dObject.

Parameters:

	min_x	Lower limit for the box along the X axis.
	max_x	Upper limit for the box along the X axis.
	min_y	Lower limit for the box along the Y axis.
	max_y	Upper limit for the box along the Y axis.
	min_z	Lower limit for the box along the Z axis.
	max_z	Upper limit for the box along the Z axis.
	p	The plot to update.

Definition at line 185 of file plot3d.c.

References Error(), Tplot3d::f, and Tplot3d::inObject.

Referenced by main().

Here is the call graph for this function:

Here is the caller graph for this function:

void PlotTriangle3d	(	double	x1,
		double	y1,
		double	z1,
		double	x2,
		double	y2,
		double	z2,
		double	x3,
		double	y3,
		double	z3,
		Tplot3d *	p
	)

Adds triangle to the current object. This command can only be used in between a call to StartNew3dObject and the corresponding call to Close3dObject.

Parameters:

	x1	X coordinate for the first point of the triangle.
	y1	Y coordinate for the first point of the triangle.
	z1	Z coordinate for the first point of the triangle.
	x2	X coordinate for the second point of the triangle.
	y2	Y coordinate for the second point of the triangle.
	z2	Z coordinate for the second point of the triangle.
	x3	X coordinate for the third point of the triangle.
	y3	Y coordinate for the third point of the triangle.
	z3	Z coordinate for the third point of the triangle.
	p	The plot to update.

Definition at line 217 of file plot3d.c.

References Error(), Tplot3d::f, and Tplot3d::inObject.

Here is the call graph for this function:

void Plot3dObject	(	unsigned int	nv,
		unsigned int	nf,
		unsigned int	ne,
		double **	v,
		unsigned int *	nvf,
		unsigned int **	fv,
		Tplot3d *	p
	)

Adds polytope to the current object. This command can only be used in between a call to StartNew3dObject and the corresponding call to Close3dObject.

What we denote as polytope are geomview OFFs.

Parameters:

	nv	Number of vertexes of the polytope.
	nf	Number of faces of the polytope.
	ne	Number of edges of the polytope (not used).
	v	Pointer to 3d array with the (x,y,z) coordinates of the vertexes.
	nvf	Pointer to an array with the number of vertexes for each face.
	fv	Pointer to an array with the vertexes for each face.
	p	The plot to update.

Definition at line 237 of file plot3d.c.

References Error(), Tplot3d::f, and Tplot3d::inObject.

Referenced by PlotCPolyhedron().

Here is the call graph for this function:

Here is the caller graph for this function:

void PlotSphere	(	double	r,
		double	x,
		double	y,
		double	z,
		Tplot3d *	p
	)

Adds sphere to the current object. This command can only be used in between a call to StartNew3dObject and the corresponding call to Close3dObject.

Parameters:

	r	The radius of the sphere.
	x	The X component of the center of the sphere.
	y	The Y component of the center of the sphere.
	z	The Z component of the center of the sphere.
	p	The plot to update.

Definition at line 265 of file plot3d.c.

References Error(), Tplot3d::f, and Tplot3d::inObject.

Referenced by PlotCPolyhedron(), and PlotJoint().

Here is the call graph for this function:

Here is the caller graph for this function:

void PlotCylinder	(	double	r,
		double *	p1,
		double *	p2,
		Tplot3d *	p
	)

Adds cylinder to the current object. This command can only be used in between a call to StartNew3dObject and the corresponding call to Close3dObject.

Parameters:

	r	The radius of the cylinder.
	p1	Array with the (x,y,z) point where the cylinder has to start.
	p2	Array with the (x,y,z) point where the cylinder has to end.
	p	The plot to update.

Definition at line 273 of file plot3d.c.

References Error(), Tplot3d::f, HTransformDelete(), HTransformPrintT(), HTransformX2Vect(), and Tplot3d::inObject.

Referenced by PlotCPolyhedron(), and PlotJoint().

Here is the call graph for this function:

Here is the caller graph for this function:

void PlotVect3d	(	unsigned int	n,
		double *	x,
		double *	y,
		double *	z,
		Tplot3d *	p
	)

Adds polyline (i.e., a collection of concatenated lines) to the current object. This command can only be used in between a call to StartNew3dObject and the corresponding call to Close3dObject.

Parameters:

	n	Number of points defining the polyline.
	x	Array with the x component for the points in the polyline.
	y	Array with the y component for the points in the polyline.
	z	Array with the z component for the points in the polyline.
	p	The plot to update.

Definition at line 291 of file plot3d.c.

References Tplot3d::color, Error(), Tplot3d::f, Tplot3d::inObject, and PrintColor().

Referenced by PlotLink().

Here is the call graph for this function:

Here is the caller graph for this function:

void Take3dSnapshot	(	char *	file,
		Tplot3d *	p
	)

Takes a screenshot of the geometry. Used to create videos from animations.

The screenshot format are .ppm files that can be browsed/manipulated easily.

Parameters:

	file	Name of the file where to store the snapshot.
	p	The plot to update.

Definition at line 312 of file plot3d.c.

References Tplot3d::f.

void ClosePlot3d	(	boolean	quit,
		double	average_x,
		double	average_y,
		double	average_z,
		Tplot3d *	p
	)

Closes a 3d plot. Before closing the file, all geometric objects are offset by (average_x,average_y,average_z). This is used to center the scene in the (0,0,0) and facilitates the on-line manipulation (rotations, translations,...) using geomview.

Parameters:

	quit	TRUE if we want to quit geomview right after displaying the geometry. Used to quit after an animation.
	average_x	X translation to apply to all objects in the scene before closing the plot.
	average_y	Y translation to apply to all objects in the scene before closing the plot.
	average_z	Z translation to apply to all objects in the scene before closing the plot.
	p	The plot to update.

Definition at line 318 of file plot3d.c.

References Close3dObject(), Tplot3d::f, Tplot3d::fileName, and Tplot3d::nobj.

Referenced by AnimateWorld(), and main().

Here is the call graph for this function:

Here is the caller graph for this function: