Circle3D

Element

A circle in 3D can be defined by various combinations of points and numbers. In 3D space, a circle consists of all points on a given plane with a given distance from a given point. The given point is called the center, and the given distance is called the radius. A circle can be constructed by providing a center, a normal vector, and a radius (given as a number or function).

If the radius has a negative value, its absolute value is taken. If the radius evaluates to NaN, the circle is not displayed. This is convenient for constructing an intersection circle, which is empty when its parents do not intersect.

Usage (signatures)
board.create('circle3d', [center, normal, radius]);

The normal vector can be given as an array of four numbers (i.e. homogeneous coordinates [0, x, y, z]) or a function returning an array of length 4 and the radius can be given as a number (which will create a circle with a fixed radius) or a function.

If the radius is supplied as a number or the output of a function, its absolute value is taken. If the radius evaluates to NaN, the circle does not display.

Parameters
Name Type Description
center Point3DLike
normal Array | function
radius NumberLike
Attributes

Own

none

Inherited

Members

Own

none

Inherited

Methods

Own

none

Inherited

Events

Own

none

Inherited

Throws

If the element cannot be constructed with the given parent objects an exception is thrown.

Type
Exception

Details

Type
JXG.Circle3D
Source
3d/circle3d.js, line 276

Extends