Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help 
M_CIRCLE(3)		     Library Functions Manual		     M_CIRCLE(3)

NAME
     M_Circle -- Agar-Math circle structure

SYNOPSIS
     #include <agar/core.h>
     #include <agar/gui.h>
     #include <agar/math/m.h>

DESCRIPTION
     The  M_Circle2  structure	describes  a circle in R^2 in terms of an origin
     point p and radius r:

     typedef struct m_circle2 {
	     M_Vector2 p;
	     M_Real r;
     } M_Circle2;

     Similarly, M_Circle3 describes a circle in R^3:

     typedef struct m_circle3 {
	     M_Vector3 p;
	     M_Real r;
     } M_Circle3;

INITIALIZATION
     M_Circle2 M_CircleFromPt(M_Vector2 p, M_Real r)

     M_Circle2 M_CircleRead2(AG_DataSource *ds)

     M_Circle3 M_CircleRead3(AG_DataSource *ds)

     void M_CircleWrite2(AG_DataSource *ds, M_Circle2 *C)

     void M_CircleWrite3(AG_DataSource *ds, M_Circle3 *C)

     M_Circle2 M_CIRCLE2_INITIALIZER(M_Real x, M_Real y, M_Real r)

     M_Circle3 M_CIRCLE3_INITIALIZER(M_Real x, M_Real y, M_Real z, M_Real r)

     The M_CircleFromPt() function returns a M_Circle2 describing  a  circle  of
     radius r centered at point p.

     The  M_CircleRead[23]()  and  M_CircleWrite[23]() functions read or write a
     circle structure from/to an AG_DataSource(3).

     The macros M_CIRCLE2_INITIALIZER() and  M_CIRCLE3_INITIALIZER()  expand  to
     static initializers for M_Circle2 and M_Circle3, respectively.

COMPUTATIONS
     M_Real M_CirclePointDistance2(M_Circle2 C, M_Vector2 p)

     M_GeomSet2 M_IntersectCircleCircle2(M_Circle2 C1, M_Circle2 C2)

     M_GeomSet2 M_IntersectCircleLine2(M_Circle2 C, M_Line2 L)

     The  M_CirclePointDistance2() routine computes the minimal distance between
     a circle C and a point p.

     M_IntersectCircleCircle2() computes the intersection of two circles in  R^2
     and returns an M_GeomSet2(3) describing the intersection.	The returned set
     may be:
     *	 Two points.
     *	 One point (circles are tangent up to machine precision).
     *	 A circle (circles are equivalent).
     *	 The empty set.

     The M_IntersectCircleCircle2() function computes the intersection of a cir-
     cle and a line in R^2.  The returned set may be:
     *	 Two points.
     *	 One point (line is tangent up to machine precision).
     *	 The empty set.

SEE ALSO
     AG_DataSource(3),	AG_Intro(3),  M_Geometry(3),  M_Plane(3),  M_Polygon(3),
     M_Rectangle(3), M_Sphere(3), M_Triangle(3), M_Vector(3)

HISTORY
     The M_Circle structure first appeared in Agar 1.3.4.

Agar 1.7			December 21, 2022		     M_CIRCLE(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=M_Circle&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>

home | help