Rac. Segment

Segment of a Ray up to a given length.

Constructor

new Segment(rac, ray, length)

# | source: drawable/Segment.js, line 13

Creates a new Segment instance.

Parameters:
Name Type Description
rac Rac

Instance to use for drawing and creating other objects
ray Rac.Ray

A Ray the segment will be based of
length number

The length of the segment

Members

length :number

# | source: drawable/Segment.js, line 52

The length of the segment.

rac :Rac

# | source: drawable/Segment.js, line 40

Instance of Rac used for drawing and passed along to any created object.

ray :Rac.Ray

# | source: drawable/Segment.js, line 46

The Ray the segment is based of.

Methods

angle() → {Rac.Angle}

# | source: drawable/Segment.js, line 96

Returns the angle of the segment's ray.

arc(endAngleopt, nullable, clockwiseopt) → {Rac.Arc}

# | source: drawable/Segment.js, line 676

Returns a new Arc based on this segment, with the given endAngle and clockwise orientation.

The returned Arc will use this segment's start as center, its angle as start, and its length as radius.

When endAngle is ommited or null, the segment's angle is used instead resulting in a complete-circle arc.

Parameters:
Name Type Attributes Default Description
endAngle Rac.Angle <optional>
<nullable>
 null

An Angle to use as end for the new Arc, or null to use this.angle()
clockwise boolean <optional>
 true

The orientation of the new Arc

arcWithAngleDistance(angleDistance, clockwiseopt) → {Rac.Arc}

# | source: drawable/Segment.js, line 700

Returns a new Arc based on this segment, with the arc's end at angleDistance from the segment's angle in the clockwise orientation.

The returned Arc will use this segment's start as center, its angle as start, and its length as radius.

Parameters:
Name Type Attributes Default Description
angleDistance Rac.Angle | number

The angle distance from the segment's start to the new Arc end
clockwise boolean <optional>
 true

The orientation of the new Arc

clampToLength(value, startInsetopt, endInsetopt) → {number}

# | source: drawable/Segment.js, line 380

Returns the given value clamped to [startInset, length-endInset].

When startInset is greater that length-endInset the range for the clamp becomes imposible to fulfill. In this case the returned value will be the centered between the range limits and still clampled to [0, length].

Parameters:
Name Type Attributes Default Description
value number

A value to clamp
startInset number <optional>
 0

The inset for the lower limit of the clamping range
endInset endInset <optional>
 0

The inset for the higher limit of the clamping range

endPoint() → {Rac.Point}

# | source: drawable/Segment.js, line 114

Returns a new Point where the segment ends.

equals(otherSegment) → {boolean}

# | source: drawable/Segment.js, line 85

Returns true when ray and length in both segments are equal; otherwise returns false.

When otherSegment is any class other that Rac.Segment, returns false.

Segments' length are compared using Rac#equals.

See:
Parameters:
Name Type Description
otherSegment Rac.Segment

A Segment to compare

inverse() → {Rac.Segment}

# | source: drawable/Segment.js, line 279

Returns a new Segment poiting towards the inverse angle of this.angle().

The resulting Segment will have the same startPoint() and length as this.

See:

moveEndPoint(newEndPoint) → {Rac.Segment}

# | source: drawable/Segment.js, line 467

Returns a new Segment starting at this.startPoint() and ending at newEndPoint.

When this.startPoint() and newEndPoint are considered equal, the new Segment will use this.angle().

See:
Parameters:
Name Type Description
newEndPoint Rac.Point

The end point of the new Segment

moveStartPoint(newStartPoint) → {Rac.Segment}

# | source: drawable/Segment.js, line 449

Returns a new Segment starting at newStartPoint and ending at this.endPoint().

When newStartPoint and this.endPoint() are considered equal, the new Segment will use this.angle().

See:
Parameters:
Name Type Description
newStartPoint Rac.Point

The start point of the new Segment

nextSegmentLegWithHyp(hypotenuse, clockwiseopt) → {Rac.Segment}

# | source: drawable/Segment.js, line 647

Returns a new Segment starting from endPoint() which corresponds to the leg of a right triangle where this is the other cathetus and the hypotenuse is of length hypotenuse.

The new Segment will point towards the perpendicular angle of this.angle().[inverse() in the clockwise orientation.

When hypotenuse is smaller that the segment's length, returns null since no right triangle is possible.

See:
Parameters:
Name Type Attributes Default Description
hypotenuse number

The length of the hypotenuse side of the right triangle formed with this and the new Segment
clockwise boolean <optional>
 true

The orientation of the perpendicular angle from endPoint()

nextSegmentPerpendicular(clockwiseopt, lengthopt, nullable) → {Rac.Segment}

# | source: drawable/Segment.js, line 617

Returns a new Segment starting from endPoint() towards the perpendicular angle of this.angle().inverse() in the clockwise orientation.

The new Segment will have the given length, or when ommited or null will use this.length instead.

Notice that the perpendicular is calculated from the inverse of the segment's angle. E.g. with clockwise as true, the resulting Segment will be pointing towards this.angle().perpendicular(false).

See:
Parameters:
Name Type Attributes Default Description
clockwise boolean <optional>
 true

The orientation of the perpendicular angle from endPoint()
length number <optional>
<nullable>
 null

The length of the new Segment, or null to use this.length

nextSegmentToAngle(angle, lengthopt, nullable) → {Rac.Segment}

# | source: drawable/Segment.js, line 553

Returns a new Segment starting from endPoint() towards angle with the given length.

The new Segment will have the given length, or when ommited or null will use this.length instead.

Parameters:
Name Type Attributes Default Description
angle Rac.Angle | number

The angle of the new Segment
length number <optional>
<nullable>
 null

The length of the new Segment, or null to use this.length

nextSegmentToAngleDistance(angleDistance, clockwiseopt, lengthopt, nullable) → {Rac.Segment}

# | source: drawable/Segment.js, line 587

Returns a new Segment starting from endPoint() towards the given angleDistance from this.angle().inverse() in the clockwise orientation.

The new Segment will have the given length, or when ommited or null will use this.length instead.

Notice that the angleDistance is applied to the inverse of the segment's angle. E.g. with an angleDistance of 0 the resulting Segment will be directly over and pointing in the inverse angle of this. As the angleDistance increases the two segments separate with the pivot at endPoint().

See:
Parameters:
Name Type Attributes Default Description
angleDistance Rac.Angle | number

An angle distance to apply to the segment's angle inverse
clockwise boolean <optional>
 true

The orientation of the angle shift from endPoint()
length number <optional>
<nullable>
 null

The length of the new Segment, or null to use this.length

nextSegmentToPoint(nextEndPoint) → {Rac.Segment}

# | source: drawable/Segment.js, line 535

Returns a new Segment starting from endPoint() and up to the given nextEndPoint.

When endPoint() and nextEndPoint are considered equal, the new Segment will use this.angle().

See:
Parameters:
Name Type Description
nextEndPoint Rac.Point

The end point of the next Segment

nextSegmentWithLength(length) → {Rac.Segment}

# | source: drawable/Segment.js, line 516

Returns a new Segment starting from endPoint() with the given length and the same angle as this.

Parameters:
Name Type Description
length number

The length of the next Segment

perpendicular(clockwiseopt) → {Rac.Segment}

# | source: drawable/Segment.js, line 297

Returns a new Segment pointing towards the perpendicular angle of this.angle() in the clockwise orientation.

The resulting Segment will have the same startPoint() and length as this.

See:
Parameters:
Name Type Attributes Default Description
clockwise boolean <optional>
 true

The orientation of the perpendicular

pointAtBisector() → {Rac.Point}

# | source: drawable/Segment.js, line 432

Returns a new Point at the middle point the segment.

pointAtLength(length) → {Rac.Point}

# | source: drawable/Segment.js, line 408

Returns a new Point in the segment's ray at the given length from this.startPoint(). When length is negative, the new Point is calculated in the inverse direction of this.angle().

See:
Parameters:
Name Type Description
length number

The distance from this.startPoint()

pointAtLengthRatio(ratio) → {Rac.Point}

# | source: drawable/Segment.js, line 423

Returns a new Point in the segment's ray at a distance of this.length * ratio from this.startPoint(). When ratio is negative, the new Point is calculated in the inverse direction of this.angle().

See:
Parameters:
Name Type Description
ratio number

The factor to multiply length by

reverse() → {Rac.Segment}

# | source: drawable/Segment.js, line 312

Returns a new Segment with its start point set at this.endPoint(), angle set to this.angle().inverse(), and same length as this.

See:

segmentBisector(lengthopt, nullable, clockwiseopt) → {Rac.Segment}

# | source: drawable/Segment.js, line 498

Returns a new Segment from the segment's middle point towards the perpendicular angle in the clockwise orientation.

The new Segment will have the given length, or when ommited or null will use this.length instead.

See:
Parameters:
Name Type Attributes Default Description
length number <optional>
<nullable>
 null

The length of the new Segment, or null to use this.length
clockwise boolean <optional>
 true

The orientation of the perpendicular

segmentToBisector() → {Rac.Segment}

# | source: drawable/Segment.js, line 479

Returns a new Segment from the starting point to the segment's middle point.

See:

startPoint() → {Rac.Point}

# | source: drawable/Segment.js, line 105

Returns the start of the segment's ray.

toString(digitsopt) → {string}

# | source: drawable/Segment.js, line 63

Returns a string representation intended for human consumption.

Parameters:
Name Type Attributes Default Description
digits number <optional>
 null

The number of digits to print after the decimal point, when ommited all digits are printed

translatePerpendicular(distance, clockwiseopt) → {Rac.Segment}

# | source: drawable/Segment.js, line 359

Returns a new Segment with the start point moved the given distance towards the perpendicular angle to this.angle() in the clockwise orientaton. All other properties are copied from this.

Parameters:
Name Type Attributes Default Description
distance number

The distance to move the start point by
clockwise boolean <optional>
 true

The orientation of the perpendicular

translateToAngle(angle, distance) → {Rac.Segment}

# | source: drawable/Segment.js, line 328

Returns a new Segment with the start point moved towards angle by the given distance. All other properties are copied from this.

Parameters:
Name Type Description
angle Rac.Angle | number

An Angle to move the start point towards
distance number

The distance to move the start point by

translateToLength(length) → {Rac.Segment}

# | source: drawable/Segment.js, line 344

Returns a new Segment with the start point moved along the segment's ray by the given length. All other properties are copied from this.

When length is negative, start is moved in the inverse direction of angle.

Parameters:
Name Type Description
length number

The length to move the start point by

vertex()

# | source: p5Drawer/Segment.functions.js, line 16

Calls p5.vertex to represent this Segment.

Added to Rac.Segment.prototype when Rac.P5Drawer is setup as rac.drawer.

withAngle(newAngle) → {Rac.Segment}

# | source: drawable/Segment.js, line 127

Returns a new Segment with angle set to newAngle.

All other properties are copied from this.

Parameters:
Name Type Description
newAngle Rac.Angle | number

The angle for the new Segment

withAngleAdd(angle) → {Rac.Segment}

# | source: drawable/Segment.js, line 209

Returns a new Segment with angle added to this.angle().

All other properties are copied from this.

Parameters:
Name Type Description
angle Rac.Angle | number

The angle to add

withAngleShift(angle, clockwiseopt) → {Rac.Segment}

# | source: drawable/Segment.js, line 225

Returns a new Segment with angle set to this.ray.angle.shift(angle, clockwise).

All other properties are copied from this.

Parameters:
Name Type Attributes Default Description
angle Rac.Angle | number

The angle to be shifted by
clockwise boolean <optional>
 true

The orientation of the shift

withEndExtension(distance) → {Rac.Segment}

# | source: drawable/Segment.js, line 264

Returns a new Segment with distance added to this.length, which results in endPoint() for the resulting Segment moving in the direction of the segment's ray by the given distance.

All other properties are copied from this.

Using a positive distance results in a longer segment, using a negative distance results in a shorter one.

This method performs the same operation as withLengthAdd.

Parameters:
Name Type Description
distance number

The distance to add to length

withLength(newLength) → {Rac.Segment}

# | source: drawable/Segment.js, line 170

Returns a new Segment with length set to newLength.

All other properties are copied from this.

Parameters:
Name Type Description
newLength number

The length for the new Segment

withLengthAdd(length) → {Rac.Segment}

# | source: drawable/Segment.js, line 183

Returns a new Segment with length added to this.length.

All other properties are copied from this.

Parameters:
Name Type Description
length number

The length to add

withLengthRatio(ratio) → {Rac.Segment}

# | source: drawable/Segment.js, line 196

Returns a new Segment with length set to this.length * ratio.

All other properties are copied from this.

Parameters:
Name Type Description
ratio number

The factor to multiply length by

withRay(newRay) → {Rac.Segment}

# | source: drawable/Segment.js, line 142

Returns a new Segment with ray set to newRay.

All other properties are copied from this.

Parameters:
Name Type Description
newRay Rac.Ray

The ray for the new Segment

withStartExtension(distance) → {Rac.Segment}

# | source: drawable/Segment.js, line 242

Returns a new Segment with the start point moved in the inverse direction of the segment's ray by the given distance. The resulting Segment will have the same endPoint() and angle() as this.

Using a positive distance results in a longer segment, using a negative distance results in a shorter one.

Parameters:
Name Type Description
distance number

The distance to move the start point by

withStartPoint(newStartPoint) → {Rac.Segment}

# | source: drawable/Segment.js, line 156

Returns a new Segment with start point set to newStart.

All other properties are copied from this.

Parameters:
Name Type Description
newStartPoint Rac.Point

The start point for the new Segment