EasyGeometry::D2::LinearEntity

A base class for all linear entities (Line, Ray and Segment) in 2-dimensional Euclidean space.

#direction

The direction vector of the LinearEntity.

#angle_between(other)

Return the non-reflex angle formed by rays emanating from the origin with directions the same as the direction vectors of the linear entities.

From the dot product of vectors v1 and v2 it is known that:

dot(v1, v2) = |v1|*|v2|*cos(A)

where A is the angle formed between the two vectors. We can get the directional vectors of the two lines and readily find the angle between the two using the above formula.

#parallel_to?(other)

Are two LinearEntity parallel?

return true if self and other LinearEntity are parallel, false otherwise.

#perpendicular_to?(other)

Are two LinearEntity perpendicular?

return true if self and other LinearEntity are perpendicular, false otherwise.

#similar_to?(other)

Are two linear entities similar?

Return true if self and other are contained in the same line.

l1 = EasyGeometry::D2::Line.new([0, 0], [1, 1])
s2 = EasyGeometry::D2::Segment.new([0, 0], [-1, 1])

l1.similar_to?(s2)  # false
l1.similar_to?(EasyGeometry::D2::Segment.new([2, 2], [4, 4]))  # true

#intersection(entity)

The intersection with another geometrical entity.

l1 = EasyGeometry::D2::Line.new([0, 0], [1, 1])
s2 = EasyGeometry::D2::Segment.new([0, 0], [-1, 1])

l1.intersection(l1)  # [l1]
l1.intersection(s2)  # [Point(0, 0)]
l1.intersection(EasyGeometry::D2::Segment.new([1, 0], [2, 1])) # []

#parallel_line(point)

Create a new Line parallel to this linear entity which passes through the point p.

#perpendicular_line(point)

Create a new Line perpendicular to this linear entity which passes through the point.

#perpendicular_segment(point)

Create a perpendicular line segment from point to this line. The enpoints of the segment are point and the closest point in the line containing self. (If self is not a line, the point might not be in self.)

Parameters:
    point - EasyGeometry::D2::Point or Array of Numeric(coordinates)
    
Returns:
    Segment or Point (if `point` is on this linear entity.)
    
Errors:
    raise TypeError if point is not Point or valid Array

#slope

The slope of this linear entity, or infinity if vertical.

#span_test(point)

Test whether the point lies in the positive span of self. A point x is 'in front' of a point y if x.dot(y) >= 0.

Returns:

-1 if other is behind self.p1
0 if other is self.p1
1 if other is in front of self.p1.

PreviousEasyGeometry::D2::Vector NextEasyGeometry::D2::Line

Last updated 6 years ago

hashtag#direction

hashtag#angle_between(other)

hashtag#parallel_to?(other)

hashtag#perpendicular_to?(other)

hashtag#similar_to?(other)

hashtag#intersection(entity)

hashtag#parallel_line(point)

hashtag#perpendicular_line(point)

hashtag#perpendicular_segment(point)

hashtag#slope

hashtag#span_test(point)