class DVpolygons

class DVpolygons: public DVpoints_2D_with_normals

A class which describes a list of polygons.

Inheritance:

Public Methods
DVpolygons(): Constructors. This one makes a default list of polygons (empty)
DVpolygons( LCVMarray<float> &v0, LCVMarray<float> &v1, LCVMarray<float> &v2 ): Three nodes given--creates one triangle.
DVpolygons( LCVMarray<float> &v0, LCVMarray<float> &v1, LCVMarray<float> &v2, LCVMarray<float> &n0, LCVMarray<float> &n1, LCVMarray<float> &n2 ): Three nodes given and 3 normals given--creates one triangle.
DVpolygons( LCVMarray<float> &v0, LCVMarray<float> &v1, LCVMarray<float> &v2, LCVMarray_2D<float> &n ): Three nodes given and an array of 3 normals given--creates one triangle.
DVpolygons( LCVMarray<float> &v0, LCVMarray<float> &v1, LCVMarray<float> &v2, LCVMarray<float> &v3 ): Four nodes given--creates one quadrilateral.
DVpolygons( LCVMarray<float> &v0, LCVMarray<float> &v1, LCVMarray<float> &v2, LCVMarray<float> &v3, LCVMarray<float> &n0, LCVMarray<float> &n1, LCVMarray<float> &n2, LCVMarray<float> &n3 ): Four nodes given and 4 normals given--creates one quadrilateral.
DVpolygons( LCVMarray<float> &v0, LCVMarray<float> &v1, LCVMarray<float> &v2, LCVMarray<float> &v3, LCVMarray_2D<float> &n ): Four nodes given and an array of 4 normals given--creates one quadrilateral.
DVpolygons(LCVMarray_2D<float> &v): Array of nodes given--v[i] is a vertex.
DVpolygons(LCVMarray_2D<float> &v, LCVMarray_2D<float> &n): Array of nodes given and array of normals given--v[i] is a vertex.
DVpolygons(LCVMarray_3D<float> &v): 2_D array of nodes given--v[i] is a polygon.
DVpolygons(LCVMarray_3D<float> &v, LCVMarray_3D<float> &n): 2_D array of nodes given and 2_D array of normals as well.
virtual ~DVpolygons(): Destructor
DVpolygons& set_data()
DVpolygons& set_data( LCVMarray<float> &v0, LCVMarray<float> &v1, LCVMarray<float> &v2 ): Three nodes given--creates one triangle.
DVpolygons& set_data( LCVMarray<float> &v0, LCVMarray<float> &v1, LCVMarray<float> &v2, LCVMarray<float> &n0, LCVMarray<float> &n1, LCVMarray<float> &n2 ): Three nodes given and 3 normals given--creates one triangle.
DVpolygons& set_data( LCVMarray<float> &v0, LCVMarray<float> &v1, LCVMarray<float> &v2, LCVMarray_2D<float> &n ): Three nodes given and an array of 3 normals given--creates one triangle.
DVpolygons& set_data( LCVMarray<float> &v0, LCVMarray<float> &v1, LCVMarray<float> &v2, LCVMarray<float> &v3 ): Four nodes given--creates one quadrilateral.
DVpolygons& set_data( LCVMarray<float> &v0, LCVMarray<float> &v1, LCVMarray<float> &v2, LCVMarray<float> &v3, LCVMarray<float> &n0, LCVMarray<float> &n1, LCVMarray<float> &n2, LCVMarray<float> &n3 ): Four nodes given and 4 normals given--creates one quadrilateral.
DVpolygons& set_data( LCVMarray<float> &v0, LCVMarray<float> &v1, LCVMarray<float> &v2, LCVMarray<float> &v3, LCVMarray_2D<float> &n ): Four nodes given and an array of 4 normals given--creates one quadrilateral.
DVpolygons& set_data(LCVMarray_2D<float> &v): Array of nodes given--v[i] is a vertex.
DVpolygons& set_data( LCVMarray_2D<float> &v, LCVMarray_2D<float> &n ): Array of nodes given and array of normals given--v[i] is a vertex.
DVpolygons& set_data(LCVMarray_3D<float> &v): 2_D array of nodes given--v[i] is a polygon.
DVpolygons& set_data( LCVMarray_3D<float> &v, LCVMarray_3D<float> &n ): 2_D array of nodes given and 2_D array of normals as well.
virtual void draw(LCVMstack<DVproperty*>&): Virtual draw routine
DVpolygons(const DVpolygons &data): Copy constructor
const DVpolygons& operator=(const DVpolygons &data): Assignment operator
virtual void print(ostream&): A virtual print function
DVpolygons(FileOption a_file_op): Methods concerning the scene file format
virtual int ReadMyProp(): Methods concerning the scene file format

Protected Methods
virtual DVobject* copy(): A routine that returns a pointer to a copy of the object created with new.

Inherited from DVpoints_2D_with_normals:

Public Methods
int operator==(const DVpoints_2D_with_normals &data)
int operator!=(const DVpoints_2D_with_normals &data)
int user_supplied_normals()

Protected Fields
LCVMarray_3D<float> normals
int user_supplied_normals_flag

Protected Methods
void set_nodes()
void set_nodes(LCVMarray_3D<float> &v)
void set_normals()
void set_normals(LCVMarray_3D<float> &n)
void set_user_supplied_normals()
void set_compute_normals()

Inherited from DVpoints_2D:

Public Methods
void get_used_coordinates(LCVMarray_3D<float>&, const int select=0)
void get_used_coordinates(LCVMarray_3D<float>&, DVscale &, const int select=0)
void get_used_colors(LCVMarray_2D<float>&, const int select=0)
void ReadDVProps()

Protected Fields
LCVMarray_3D<float> points

Inherited from DVobject:

Public Methods
DVobject& set_translate(LCVMarray<float> &data)
DVobject& set_translate(const float x, const float y, const float z)
DVobject& add_translate(LCVMarray<float> &data)
DVobject& add_translate(const float x, const float y, const float z)
DVobject& set_rotate(LCVMarray<float> &data, const float angle, const char type='d')
DVobject& set_rotate( const float x, const float y, const float z, const float angle, const char type='d' )
DVobject& add_rotate(LCVMarray<float> &data, const float angle, const char type='d')
DVobject& add_rotate( const float x, const float y, const float z, const float angle, const char type='d' )
void get_translation(LCVMarray<float>&)
void get_rotation(LCVMarray<float>&, float&)
void set_OpenGL_lighting_properties(DVlight_properties_property_item_array &lights)
void set_OpenGL_material_properties(DVmaterial_properties_property_item &material, DVcolor &color)
void set_OpenGL_color(DVcolor &color)
virtual DVobject& copy_child(DVobject &child)
virtual DVobject& delete_current_child()
friend ostream& operator<<(ostream &, DVobject &)
int ReadProp()
void ReadDVrotate()
void ReadDVtranslation()
void ReadSimpleProps()

Public

Protected Fields
class DVcontainerbase LCVMarray<float> translation
LCVMarray<float> rotation_axis
float rotation_angle
LCVMarray<float> rotation_quaterions

Protected Methods
void axis_to_quat(LCVMarray<float> axis, float angle, LCVMarray<float> &quat)
void quat_to_axis(LCVMarray<float> quat, LCVMarray<float> &axis, float &angle)
void add_quat(LCVMarray<float> a, LCVMarray<float> b, LCVMarray<float> &c)

Inherited from DVselect_property:

Public Fields
DVcolor_select_property_item_array color
DVpositive_float_select_property_item_array width
DVcomplexity_int_select_property_item geometry_complexity
DVcomplexity_int_select_property_item light_complexity
DVscale_select_property_item scale
DVcolor_by_data_select_property_item_array color_by_data
DVrich_light_properties_select_property_item_array lights
DVrich_material_properties_select_property_item_array material

Public Methods
void extract_properties(DVproperty&)
void default_lighting()
void ReadDVColor()
void ReadDVlightComp()
void ReadDVgeomComp()
void ReadDVscale()
void ReadDVwidth()
void ReadColorMap()

Inherited from DVpick_components:

Public Methods
void set_x_plot_coordinate(const int i, const int select=0)
void set_y_plot_coordinate(const int j, const int select=0)
void set_z_plot_coordinate(const int k, const int select=0)
void set_plot_coordinate(const int i, const int coord, const int select=0)
void set_xyz_plot_coordinates(const int i, const int j, const int k, const int select=0)
void set_xyz_plot_coordinates(LCVMarray<int> &i, const int select=0)
void set_xyz_plot_coordinates(LCVMarray_2D<int> &i)
void set_color_coordinate(const int i, const int select=0)
void set_color_coordinates(LCVMarray<int> &i)
int check_color_coordinates(int select = 0)
int ReadPickCompProp()
void ReadCoords()
void ReadColorCoord()

Protected Fields
int num_elts
LCVMarray_2D<int> use_xyz
LCVMarray<int> use_color

Protected Methods
void default_use_coords()
void default_use_colors()
void check_use_coords()
void check_use_colors()

Documentation

A class which describes a list of polygons. Polygons can have 3 or more vertices. They must (it is up to the user to make sure) be convex. They must (it is up to the user to make sure) be planar. If any one of the above two properties are not satisfied, then "things could go wrong".

DVpolygons()

Constructors. This one makes a default list of polygons (empty)

DVpolygons( LCVMarray<float> &v0, LCVMarray<float> &v1, LCVMarray<float> &v2 )

Three nodes given--creates one triangle. Each LCVMarray v_i must have the same size.

DVpolygons( LCVMarray<float> &v0, LCVMarray<float> &v1, LCVMarray<float> &v2, LCVMarray<float> &n0, LCVMarray<float> &n1, LCVMarray<float> &n2 )

Three nodes given and 3 normals given--creates one triangle. Each LCVMarray v_i must have the same size and each LCVMarray n_i must have size 3. (Usually n_i is a unit vector.).

DVpolygons( LCVMarray<float> &v0, LCVMarray<float> &v1, LCVMarray<float> &v2, LCVMarray_2D<float> &n )

Three nodes given and an array of 3 normals given--creates one triangle. Each LCVMarray v_i must have the same size and n must be 3x3. n[i] is the normal for vertex i. (Usually n[i] is a unit vector.)

DVpolygons( LCVMarray<float> &v0, LCVMarray<float> &v1, LCVMarray<float> &v2, LCVMarray<float> &v3 )

Four nodes given--creates one quadrilateral. Each LCVMarray must have the same size.

DVpolygons( LCVMarray<float> &v0, LCVMarray<float> &v1, LCVMarray<float> &v2, LCVMarray<float> &v3, LCVMarray<float> &n0, LCVMarray<float> &n1, LCVMarray<float> &n2, LCVMarray<float> &n3 )

Four nodes given and 4 normals given--creates one quadrilateral. each LCVMarray v_i must have the same size and each LCVMarray n_i must have size 3. (Usually n_i is a unit vector.)

DVpolygons( LCVMarray<float> &v0, LCVMarray<float> &v1, LCVMarray<float> &v2, LCVMarray<float> &v3, LCVMarray_2D<float> &n )

Four nodes given and an array of 4 normals given--creates one quadrilateral. each LCVMarray v_i must have the same size and n must be 4x3. n[i] is the normal for vertex i. (Usually n[i] is a unit vector.)

DVpolygons(LCVMarray_2D<float> &v)

Array of nodes given--v[i] is a vertex. v must be rectangular. v[i] must have size at least 3.

DVpolygons(LCVMarray_2D<float> &v, LCVMarray_2D<float> &n)

Array of nodes given and array of normals given--v[i] is a vertex. v must be rectangular. The (leading) size of v must be the same as the (leading) size of n. n[i] must have size 3. v[i] must have size at least 3.

DVpolygons(LCVMarray_3D<float> &v)

2_D array of nodes given--v[i] is a polygon. v[i][j] is a vertex. Each vertex must have the same length. Each polygon must have at least three vertices.

DVpolygons(LCVMarray_3D<float> &v, LCVMarray_3D<float> &n)

2_D array of nodes given and 2_D array of normals as well. v[i] is a polygon. v[i][j] is a vertex. Each vertex must have the same length. Each polygon must have at least three vertices. There must be a normal for each vertex. Each normal must have 3 components. (Usually the normals are unit vectors.)

virtual ~DVpolygons()

Destructor

DVpolygons& set_data()

DVpolygons& set_data( LCVMarray<float> &v0, LCVMarray<float> &v1, LCVMarray<float> &v2 )

Three nodes given--creates one triangle. Each LCVMarray v_i must have the same size.

DVpolygons& set_data( LCVMarray<float> &v0, LCVMarray<float> &v1, LCVMarray<float> &v2, LCVMarray<float> &n0, LCVMarray<float> &n1, LCVMarray<float> &n2 )

Three nodes given and 3 normals given--creates one triangle. Each LCVMarray v_i must have the same size and each LCVMarray n_i must have size 3. (Usually n_i is a unit vector.).

DVpolygons& set_data( LCVMarray<float> &v0, LCVMarray<float> &v1, LCVMarray<float> &v2, LCVMarray_2D<float> &n )

DVpolygons& set_data( LCVMarray<float> &v0, LCVMarray<float> &v1, LCVMarray<float> &v2, LCVMarray<float> &v3 )

Four nodes given--creates one quadrilateral. Each LCVMarray must have the same size.

DVpolygons& set_data( LCVMarray<float> &v0, LCVMarray<float> &v1, LCVMarray<float> &v2, LCVMarray<float> &v3, LCVMarray<float> &n0, LCVMarray<float> &n1, LCVMarray<float> &n2, LCVMarray<float> &n3 )

Four nodes given and 4 normals given--creates one quadrilateral. each LCVMarray v_i must have the same size and each LCVMarray n_i must have size 3. (Usually n_i is a unit vector.)

DVpolygons& set_data( LCVMarray<float> &v0, LCVMarray<float> &v1, LCVMarray<float> &v2, LCVMarray<float> &v3, LCVMarray_2D<float> &n )

DVpolygons& set_data(LCVMarray_2D<float> &v)

Array of nodes given--v[i] is a vertex. v must be rectangular. v[i] must have size at least 3.

DVpolygons& set_data( LCVMarray_2D<float> &v, LCVMarray_2D<float> &n )

DVpolygons& set_data(LCVMarray_3D<float> &v)

2_D array of nodes given--v[i] is a polygon. v[i][j] is a vertex. Each vertex must have the same length. Each polygon must have at least three vertices.