Element Arc
JXG.GeometryElement
↳ JXG.Curve
↳ Curve
↳ Arc
An arc is a segment of the circumference of a circle. It is defined by a center, one point that
defines the radius, and a third point that defines the angle of the arc.
Defined in: arc.js.
Extends
Curve.
Constructor Attributes | Constructor Name and Description |
---|---|
Field Attributes | Field Name and Description |
---|---|
Attributes for angle point.
|
|
Attributes for center point.
|
|
If true, moving the mouse over inner points triggers hasPoint.
|
|
Attributes for radius point.
|
|
Type of arc.
|
|
<private> |
If true, there is a fourth parent point, i.e.
|
Field Attributes | Field Name and Description |
---|---|
The point defining the arc's angle.
|
|
Arc length.
|
|
Point defining the arc's radius.
|
Method Attributes | Method Name and Description |
---|---|
<deprecated> | |
hasPointSector(x, y)
Checks whether (x,y) is within the sector defined by the arc.
|
|
Radius()
Determines the arc's current radius.
|
|
Value(unit, rad)
Returns the length of the arc or the value of the angle spanned by the arc.
|
- Methods borrowed from class JXG.Curve:
- addTransform, allocatePoints, generateTerm, getTransformationSource, hasPoint, interpolationFunctionFromArray, maxX, minX, moveTo, notifyParents, update, updateCurve, updateDataArray, updateRenderer, updateTransform, X, Y, Z
- Methods borrowed from class JXG.GeometryElement:
- _set, addChild, addDescendants, addParents, addParentsFromJCFunctions, addRotation, addTicks, animate, bounds, clearTrace, cloneToBackground, countChildren, createGradient, createLabel, draggable, eval, evalVisProp, formatNumberLocale, fullUpdate, generatePolynomial, getAttribute, getAttributes, getLabelAnchor, getName, getParents, getProperty, getSnapSizes, getTextAnchor, getType, handleSnapToGrid, hide, hideElement, noHighlight, normalize, prepareUpdate, remove, removeAllTicks, removeChild, removeDescendants, removeTicks, resolveShortcuts, setArrow, setAttribute, setDash, setDisplayRendNode, setLabel, setLabelText, setName, setParents, setPosition, setPositionDirectly, setProperty, show, showElement, snapToPoints, updateVisibility, useLocale
- Events borrowed from class JXG.GeometryElement:
- attribute, attribute:key, down, drag, keydrag, mousedown, mousedrag, mousemove, mouseout, mouseover, mouseup, move, out, over, pendown, pendrag, penup, touchdown, touchdrag, touchup, up
Element Detail
Arc
-
This element has no direct constructor. To create an instance of this element you have to call JXG.Board#create
with type "arc".
- Possible parent array combinations are:
-
{JXG.Point} p1
{JXG.Point} p2
{JXG.Point} p3
- The result will be an arc of a circle around p1 through p2. The arc is drawn counter-clockwise from p2 to p3.
- Throws:
- {Error}
- If the element cannot be constructed with the given parent objects an exception is thrown.
- Examples:
// Create an arc out of three free points var p1 = board.create('point', [2.0, 2.0]); var p2 = board.create('point', [1.0, 0.5]); var p3 = board.create('point', [3.5, 1.0]); var a = board.create('arc', [p1, p2, p3]); board.create('text',[1,6,function(){return 'arclength: '+Math.round(a.Value()*100)/100}])
var t = board.create('transform', [2, 1.5], {type: 'scale'}); var a1 = board.create('arc', [[1, 1], [0, 1], [1, 0]], {strokeColor: 'red'}); var a2 = board.create('curve', [a1, t], {strokeColor: 'red'});
Attribute Detail
{Point}
anglePoint
Attributes for angle point.
Defined in: options.js.
Defined in: options.js.
{Point}
center
Attributes for center point.
Defined in: options.js.
Defined in: options.js.
{Boolean}
hasInnerPoints
If true, moving the mouse over inner points triggers hasPoint.
Defined in: options.js.
Defined in: options.js.
- Default Value:
- false
{Point}
radiusPoint
Attributes for radius point.
Defined in: options.js.
Defined in: options.js.
{String}
selection
Type of arc. Possible values are 'minor', 'major', and 'auto'.
Defined in: options.js.
Defined in: options.js.
- Default Value:
- 'auto'
<private>
{Boolean}
useDirection
If true, there is a fourth parent point, i.e. the parents are [center, p1, p2, p3].
p1 is still the radius point, p2 the angle point. The arc will be that part of the
the circle with center 'center' which starts at p1, ends at the ray between center
and p2, and passes p3.
This attribute is immutable (by purpose).
This attribute is necessary for circumCircleArcs
Defined in: options.js.
- Default Value:
- false
Field Detail
{JXG.Point}
anglepoint
The point defining the arc's angle.
{Number}
L
Arc length.
- See:
- Arc#Value
{JXG.Point}
radiuspoint
Point defining the arc's radius.
Method Detail
{Number}
getRadius()
- Deprecated:
- Use Arc#Radius
- Returns:
- {Number}
{Boolean}
hasPointSector(x, y)
Checks whether (x,y) is within the sector defined by the arc.
- Parameters:
- {Number} x
- Coordinate in x direction, screen coordinates.
- {Number} y
- Coordinate in y direction, screen coordinates.
- Returns:
- {Boolean} True if (x,y) is within the sector defined by the arc, False otherwise.
{Number}
Radius()
Determines the arc's current radius. I.e. the distance between Arc#center and Arc#radiuspoint.
- Returns:
- {Number} The arc's radius
{Number}
Value(unit, rad)
Returns the length of the arc or the value of the angle spanned by the arc.
- Parameters:
- {String} unit Optional, Default: 'length'
- Unit of the returned values. Possible units are
- 'length' (default): length of the arc line
- 'radians': angle spanned by the arc in radians
- 'degrees': angle spanned by the arc in degrees
- 'semicircle': angle spanned by the arc in radians as a multiple of π, e.g. if the angle is 1.5π, 1.5 will be returned.
- 'circle': angle spanned by the arc in radians as a multiple of 2π
- {Number} rad Optional, Default: undefined
- Value of angle which can be used instead of the generic one.
- Returns:
- {Number} The arc length or the angle value in various units.
Attributes borrowed from other Elements
- Attributes borrowed from class Curve:
- curveType, doAdvancedPlot, doAdvancedPlotOld, firstArrow, handDrawing, label, lastArrow, numberPointsHigh, numberPointsLow, plotVersion, recursionDepthHigh, recursionDepthLow
- Attributes borrowed from class JXG.Curve:
- lineCap
- Attributes borrowed from class JXG.GeometryElement:
- aria, cssClass, dash, dashScale, draft, dragToTopOfLayer, element3D, fillColor, fillOpacity, fixed, frozen, gradient, gradientAngle, gradientCX, gradientCY, gradientEndOffset, gradientFR, gradientFX, gradientFY, gradientR, gradientSecondColor, gradientSecondOpacity, gradientStartOffset, highlight, highlightCssClass, highlightFillColor, highlightFillOpacity, highlightStrokeColor, highlightStrokeOpacity, highlightStrokeWidth, isLabel, layer, needsRegularUpdate, nonnegativeOnly, precision, priv, rotatable, scalable, shadow, snapToGrid, strokeColor, strokeOpacity, strokeWidth, tabindex, trace, traceAttributes, transitionDuration, transitionProperties, visible, withLabel
Fields borrowed from other Elements
- Fields borrowed from class JXG.Curve:
- dataX, dataY, numberPoints, qdt, ticks
- Fields borrowed from class JXG.GeometryElement:
- _org_type, _pos, ancestors, baseElement, board, childElements, descendants, dump, elementClass, elType, hasLabel, highlighted, id, inherits, isDraggable, isReal, lastDragTime, methodMap, mouseover, name, needsUpdate, notExistingParents, numTraces, parents, quadraticform, rendNode, stdform, subs, symbolic, traces, transformations, type, visProp, visPropCalc
Methods borrowed from other Elements
- Methods borrowed from class JXG.Curve:
- addTransform, allocatePoints, generateTerm, getTransformationSource, hasPoint, interpolationFunctionFromArray, maxX, minX, moveTo, notifyParents, update, updateCurve, updateDataArray, updateRenderer, updateTransform, X, Y, Z
- Methods borrowed from class JXG.GeometryElement:
- _set, addChild, addDescendants, addParents, addParentsFromJCFunctions, addRotation, addTicks, animate, bounds, clearTrace, cloneToBackground, countChildren, createGradient, createLabel, draggable, eval, evalVisProp, formatNumberLocale, fullUpdate, generatePolynomial, getAttribute, getAttributes, getLabelAnchor, getName, getParents, getProperty, getSnapSizes, getTextAnchor, getType, handleSnapToGrid, hide, hideElement, noHighlight, normalize, prepareUpdate, remove, removeAllTicks, removeChild, removeDescendants, removeTicks, resolveShortcuts, setArrow, setAttribute, setDash, setDisplayRendNode, setLabel, setLabelText, setName, setParents, setPosition, setPositionDirectly, setProperty, show, showElement, snapToPoints, updateVisibility, useLocale
Events borrowed from other Elements