Class Point
JXG.CoordsElement,JXG.GeometryElement
↳ JXG.Point
↳ Point
This element is used to provide a constructor for a general point. A free point is created if the given parent elements are all numbers
and the property fixed is not set or set to false. If one or more parent elements is not a number but a string containing a GEONExT
constraint or a function the point will be considered as constrained). That means that the user won't be able to change the point's
position directly.
Defined in: point.js.
Extends
JXG.Point.
Constructor Attributes | Constructor Name and Description |
---|---|
Point(z_,x,y, Point,Transformation)
|
- Fields borrowed from class JXG.GeometryElement:
- _org_type, _pos, ancestors, baseElement, board, childElements, dash, descendants, draft, dump, elementClass, elType, fillColor, fillOpacity, fixed, frozen, hasLabel, highlight, highlighted, highlightFillColor, highlightFillOpacity, highlightStrokeColor, highlightStrokeOpacity, highlightStrokeWidth, id, isDraggable, isReal, lastDragTime, methodMap, mouseover, name, needsRegularUpdate, needsUpdate, notExistingParents, numTraces, parents, quadraticform, rendNode, scalable, shadow, stdform, strokeColor, strokeOpacity, strokeWidth, subs, symbolic, trace, traceAttributes, traces, transformations, type, visible, visProp, withLabel
- Fields borrowed from class JXG.CoordsElement:
- coords, groups, needsUpdateFromParent, onPolygon, position, slideObjects
Field Attributes | Field Name and Description |
---|---|
If the distance of the point to one of its attractors is less
than this number the point will be a glider on this
attracting element.
|
|
List of attractor elements.
|
|
Unit for attractorDistance and snatchDistance, used for magnetized points and for snapToPoints.
|
|
There are different point styles which differ in appearance.
|
|
List of elements which are ignored by snapToPoints.
|
|
Truncating rule for the digits in the infobox.
|
|
If true, the infobox is shown on mouse over, else not.
|
|
Size of a point.
|
|
Defines together with Point#snapSizeY the grid the point snaps on to.
|
|
Defines together with Point#snapSizeX the grid the point snaps on to.
|
|
If set to true, the point will snap to a grid defined by
Point#snapSizeX and Point#snapSizeY.
|
|
If set to true, the point will snap to the nearest point in distance of
Point#attractorDistance.
|
|
If the distance of the point to one of its attractors is at least
this number the point will be released from being a glider on the
attracting element.
|
|
This attribute was used to determined the point layout.
|
|
If true, the point size changes on zoom events.
|
- Fields borrowed from class JXG.GeometryElement:
- _org_type, _pos, ancestors, baseElement, board, childElements, dash, descendants, draft, dump, elementClass, elType, fillColor, fillOpacity, fixed, frozen, hasLabel, highlight, highlighted, highlightFillColor, highlightFillOpacity, highlightStrokeColor, highlightStrokeOpacity, highlightStrokeWidth, id, isDraggable, isReal, lastDragTime, methodMap, mouseover, name, needsRegularUpdate, needsUpdate, notExistingParents, numTraces, parents, quadraticform, rendNode, scalable, shadow, stdform, strokeColor, strokeOpacity, strokeWidth, subs, symbolic, trace, traceAttributes, traces, transformations, type, visible, visProp, withLabel
- Fields borrowed from class JXG.CoordsElement:
- coords, groups, needsUpdateFromParent, onPolygon, position, slideObjects
- Methods borrowed from class JXG.Point:
- hasPoint, makeIntersection, normalizeFace, setStyle, update, updateRenderer, updateTransform
- Methods borrowed from class JXG.GeometryElement:
- _set, addChild, addDescendants, addParents, addRotation, addTransform, animate, bounds, clearTrace, cloneToBackground, countChildren, createGradient, createLabel, draggable, generatePolynomial, getAttribute, getAttributes, getLabelAnchor, getName, getParents, getProperty, getTextAnchor, getType, handleSnapToGrid, hideElement, labelColor, noHighlight, normalize, prepareUpdate, remove, removeChild, removeDescendants, resolveShortcuts, setArrow, setAttribute, setDash, setLabel, setLabelText, setName, setParents, setPosition, setPositionDirectly, setProperty, showElement
- Methods borrowed from class JXG.CoordsElement:
- _anim, addAnchor, addConstraint, Dist, free, handleAttractors, handleSnapToPoints, makeGlider, moveAlong, moveTo, popSlideObject, setGliderPosition, setPositionByTransform, updateConstraint, updateCoords, updateGlider, updateGliderFromParent, visit, X, XEval, Y, YEval, Z, ZEval
- Events borrowed from class JXG.GeometryElement:
- attribute, attribute:<attribute><attribute>, down, drag, mousedown, mousedrag, mousemove, mouseout, mouseover, mouseup, move, out, over, touchdown, touchdrag, touchup, up
Class Detail
Point(z_,x,y, Point,Transformation)
- Parameters:
- {Number|string|function_Number|string|function_Number|string|function} z_,x,y
- Parent elements can be two or three elements of type number, a string containing a GEONExT constraint, or a function which takes no parameter and returns a number. Every parent element determines one coordinate. If a coordinate is given by a number, the number determines the initial position of a free point. If given by a string or a function that coordinate will be constrained that means the user won't be able to change the point's position directly by mouse because it will be calculated automatically depending on the string or the function's return value. If two parent elements are given the coordinates will be interpreted as 2D affine Euclidean coordinates, if three such parent elements are given they will be interpreted as homogeneous coordinates.
- {JXG.Point_JXG.Transformation_Array} Point,Transformation
- A point can also be created providing a transformation or an array of transformations. The resulting point is a clone of the base point transformed by the given Transformation. {@see JXG.Transformation}.
- Throws:
- {Exception}
- If the element cannot be constructed with the given parent objects an exception is thrown.
- Examples:
// Create a free point using affine euclidean coordinates var p1 = board.create('point', [3.5, 2.0]);
// Create a constrained point using anonymous function var p2 = board.create('point', [3.5, function () { return p1.X(); }]);
// Create a point using transformations var trans = board.create('transform', [2, 0.5], {type:'scale'}); var p3 = board.create('point', [p2, trans]);
Field Detail
{number}
attractorDistance
If the distance of the point to one of its attractors is less
than this number the point will be a glider on this
attracting element.
If set to zero nothing happens.
Defined in: options.js.
Defined in: options.js.
- Default Value:
- 0.0
{array}
attractors
List of attractor elements. If the distance of the point is less than
attractorDistance the point is made to glider of this element.
Defined in: options.js.
Defined in: options.js.
- Default Value:
- empty
{string}
attractorUnit
Unit for attractorDistance and snatchDistance, used for magnetized points and for snapToPoints.
Possible values are 'screen' and 'user.
Defined in: options.js.
Defined in: options.js.
- Default Value:
- 'user'
{string}
face
There are different point styles which differ in appearance.
Posssible values are
Defined in: options.js.
Value |
---|
cross |
circle |
square |
plus |
diamond |
triangleUp |
triangleDown |
triangleLeft |
triangleRight |
Defined in: options.js.
- See:
- Point#setStyle
- Default Value:
- circle
{array}
ignoredSnapToPoints
List of elements which are ignored by snapToPoints.
Defined in: options.js.
Defined in: options.js.
- Default Value:
- empty
{String, Number}
infoboxDigits
Truncating rule for the digits in the infobox.
Defined in: options.js.
- 'auto': done automatically by JXG#autoDigits
- 'none': no truncation
- number: use String.toFixed();
Defined in: options.js.
- Default Value:
- 'auto'
{Boolean}
showInfobox
If true, the infobox is shown on mouse over, else not.
Defined in: options.js.
Defined in: options.js.
- Default Value:
- true
{number}
size
Size of a point.
Means radius resp. half the width of a point (depending on the face).
Defined in: options.js.
Defined in: options.js.
- See:
- Point#face
- Point#setStyle
- Default Value:
- 3
{Number}
snapSizeX
Defines together with Point#snapSizeY the grid the point snaps on to.
The point will only snap on integer multiples to snapSizeX in x and snapSizeY in y direction.
If this value is equal to or less than 0, it will use the grid displayed by the major ticks
of the default ticks of the default x axes of the board.
Defined in: options.js.
Defined in: options.js.
- See:
- Point#snapToGrid
- Point#snapSizeY
- Board#defaultAxes
- Default Value:
- 1
{Number}
snapSizeY
Defines together with Point#snapSizeX the grid the point snaps on to.
The point will only snap on integer multiples to snapSizeX in x and snapSizeY in y direction.
If this value is equal to or less than 0, it will use the grid displayed by the major ticks
of the default ticks of the default y axes of the board.
Defined in: options.js.
Defined in: options.js.
- See:
- Point#snapToGrid
- Point#snapSizeX
- Board#defaultAxes
- Default Value:
- 1
{Boolean}
snapToGrid
If set to true, the point will snap to a grid defined by
Point#snapSizeX and Point#snapSizeY.
Defined in: options.js.
Defined in: options.js.
- See:
- JXG.Point#snapSizeX
- JXG.Point#snapSizeY
- Default Value:
- false
{Boolean}
snapToPoints
If set to true, the point will snap to the nearest point in distance of
Point#attractorDistance.
Defined in: options.js.
Defined in: options.js.
- Default Value:
- false
{number}
snatchDistance
If the distance of the point to one of its attractors is at least
this number the point will be released from being a glider on the
attracting element.
If set to zero nothing happens.
Defined in: options.js.
Defined in: options.js.
- Default Value:
- 0.0
{Number}
style
This attribute was used to determined the point layout. It was derived from GEONExT and was
replaced by Point#face and Point#size.
Defined in: options.js.
Defined in: options.js.
- See:
- Point#face
- Point#size
- Default Value:
- 5
{Boolean}
zoom
If true, the point size changes on zoom events.
Defined in: options.js.
Defined in: options.js.
- Default Value:
- false