PHIGURE C REFERENCE MANUAL - DEFINITION OF A 3D DOMAIN

DEFINITION OF A 3D DOMAIN

tdomain3

CALL SEQUENCE

void tdomain3 (domain)

INPUT PARAMETERS

Plimit3	*domain;

TYPES

typedef struct {
	Pfloat	x_min;
	Pfloat	x_max;
	Pfloat	y_min;
	Pfloat	y_max;
	Pfloat	z_min;
	Pfloat	z_max;
} Plimit3;

EFFECT

This function defines the limits of the 3D space for the user data and should be called before creating any objects with this data. This domain is very easy to calculate because it is defined simply by the minimum and maximum X-axis, Y-axis and Z-axis (height) values of the user data.

The domain, [xmin-xmax] × [ymin-ymax] × [zmin-zmax] is associated with a homogeneous coordinate system, [0-1] × [0-1] × [0-1], used as a reference for certain PHIGURE function attributes (such as axis character height), but also as a reference to define the observer's viewpoint for scene visualization.

By default, primitives which exceed the limits of the domain are not clipped, that is, are not cut off at the edge of the domain during visualization. To turn on clipping, simply call the function tset_model_clip_ind after creating the scene associated with this domain (see functions tset_model_clip_ind and tscene).