3.5 Primitives drawing

These functions draw some simple objects like line, point, sphere, drop, cone and so on.

Method on mglGraph: void Clf (mglColor Back=WC)

Clear the picture and will it by color Back.

Method on mglGraph: void Ball (float x, float y, float z, mglColor col=RC, float alpha=1)

Draws a point (ball) at position {x, y, z} with color col.

Method on mglGraph: void Ball (mglPoint p, char col='r')

Draws a point (ball) at position p with color col.

Method on mglGraph: void Error (mglPoint p, mglPoint e, char *pen=NULL)

Draws a 3d error box at position p with sizes e and style pen.

Method on mglGraph: void Line (mglPoint p1, mglPoint p2, char *stl="B", intnum=2)

Draws a geodesic line (straight line in Cartesian coordinates) from point p1 to p2 using line style stl. Parameter num define the “quality” of the line. If num=2 then the stright line will be drawn in all coordinate system (independently on transformation formulas (see section Transformation (curved coordinates)). Contrary, for large values (for example, =100) the geodesic line will be drawn in corresponding coordinate system (straight line in Cartesian coordinates, circle in polar coordinates and so on). Line will be drawn even if it lies out of bounding box.

Method on mglGraph: void Curve (mglPoint p1, mglPoint d1, mglPoint p2, mglPoint d2, const char *stl="B", int num=100)

Draws Bezier-like curve from point p1 to p2 using line style stl. At this tangent is codirected with d1, d2 and proportional to its amplitude. Parameter num define the “quality” of the curve. If num=2 then the straight line will be drawn in all coordinate system (independently on transformation formulas (see section Transformation (curved coordinates)). Contrary, for large values (for example, =100) the spline like Bezier curve will be drawn in corresponding coordinate system. Curve will be drawn even if it lies out of bounding box.

Method on mglGraph: void Face (mglPoint p1, mglPoint p2, mglPoint p3, mglPoint p4, const char *stl="w", int num=2)

Draws the solid quadrangle (face) with vertexes p1, p2, p3, p4 and with color(s) stl. At this colors can be the same for all vertexes or different if all 4 colors are specified for each vertex. Face will be drawn even if it lies out of bounding box.

Method on mglGraph: void FaceX (float x0, float y0, float z0, float wy, float wz, const char *stl="w", float dx=0, float dy=0)

Draws the solid rectangle (face) perpendicular to x-axis at position {x0, y0, z0} with widths wy, wz and with color stl. At this colors can be the same for all vertexes or different if all 4 colors are specified for each vertex. Parameters d1, d2 set additional shift of the last vertex (i.e. to draw quadrangle). Face will be drawn even if it lies out of bounding box.

Method on mglGraph: void FaceY (float x0, float y0, float z0, float wx, float wz, const char *stl="w", float dx=0, float dy=0)

Draws the solid rectangle (face) perpendicular to y-axis at position {x0, y0, z0} with widths wx, wz and with color stl. At this colors can be the same for all vertexes or different if all 4 colors are specified for each vertex. Parameters d1, d2 set additional shift of the last vertex (i.e. to draw quadrangle). Face will be drawn even if it lies out of bounding box.

Method on mglGraph: void FaceZ (float x0, float y0, float z0, float wx, float wy, const char *stl="w", float dx=0, float dy=0)

Draws the solid rectangle (face) perpendicular to z-axis at position {x0, y0, z0} with widths wx, wy and with color stl. At this colors can be the same for all vertexes or different if all 4 colors are specified for each vertex. Parameters d1, d2 set additional shift of the last vertex (i.e. to draw quadrangle). Face will be drawn even if it lies out of bounding box.

Method on mglGraph: void Sphere (mglPoint p, float r, const char *stl="r")

Draw the sphere with radius r and center at point p and color stl.

Method on mglGraph: void Drop (mglPoint p, mglPoint q, float r, mglColor col, float shift=1, float ap=1)

Method on mglGraph: void Drop (mglPoint p, mglPoint q, float r, const char *col="r", float shift=1, float ap=1)

Draw the drop with radius r at point p elongated in direction q and with color col. Parameter shift set the degree of drop oblongness: ‘0’ is sphere, ‘1’ is maximally oblongness drop. Parameter ap set relative width of the drop (this is analogue of “ellipticity” for the sphere). See section Drops sample, for sample code and picture.

Method on mglGraph: void Cone (mglPoint p1, mglPoint p2, float r1, float r2=-1, const char *stl="B", bool edge=false)

Draw tube (or truncated cone if edge=false) between points p1, p2 with radius at the edges r1, r2. If r2<0 then it is supposed that r2=r1. The cone color is defined by string stl.

Method on mglGraph: void Mark (mglPoint p, char mark='.')

Draws a marks of different type at position p.

Method on mglGraph: void Glyph (float x, float y, float f, int nt, const short *trig, int nl, const short *line)

Draw a set of triangles (or lines if trig=NULL) for glyph which is placed at point {x, y}. Values in the arrays are normalized by factor f. Normally this function is used internally.