KevLinDev - GUI

Introduction

Line is a JavaScript object that allows you to adjust a line by manipulating Handles: one for each end of the line. This code is used in the 2D Geometry section of this site

Line is a sub-class of the Shape object.

Reference

Methods

constructor - new Line(svgNode);

This method creates a new Line object. All initialization is handled by the init() method. All parameters for this method are described below

init(svgNode);

init() initialized all properties for this object.

svgNode is an SVG line element node that will be managed by this object.

realize();

realize() constructs the SVG DOM nodes needed to visualize the handles of this widget. Event listeners are registered as needed to implement this object's functionality.

translate(delta);

translate() translates the SVG element and the associated handles by the specified amount.

delta is a Point2D.

refresh();

refresh() applies the handle positions to the SVG element associated with this object.

registerHandles();

registerHandles() adds all handles used by this object to the mouser's handle list.

unregisterHandles();

unregisterHandles() removes all handles used by this object from the mouser's handle list.

selectHandles();

selectHandles() set the current select value for all handles used by this object.

showHandles();

showHandles() sets the current visibility value for all handles used by this object.

getIntersectionParams() : IntersectionParams;

This method returns an IntersectionParams object to specify this shape's name and the necessary parameters to find the intersection of this shape with another. The name is used by the Intersection object to determine which intersection routine to call.

Properties

p1 is a Point2D that references the first handle on the line.

p2 is a Point2D that references the second handle on the line.

Example

This example allows you to adjust the end-points of the lines within the SVG document. Here is a brief summary of the editing procedures:

Click an unselected line once to select it.
Click a selected line to select both of the line's handles.
Shift-click an unselected line to add its handles to the current selection.
Shift-click a selected line to remove it from the current selection.
Click an unselected handle to select it
Shift-click an unselected handle to add it to the current selection
Shift-click a selected handle to remove it from the current selection
Drag a handle to manipulate the SVG element
Click the background to deselect all objects

Download

Line.js - the line object only...cannot be used in isolation

2D.js.gz - all objects needed to use this object and other 2D geometry objects