Klasse Line

Gerade Linien zwischen zwei Punkten, gehalten als einfache Objekte der Form { start, end }, und die Segmentform [start, end] derselben Sache. Die Methoden hier bauen Linien, messen und transformieren sie, wandeln zwischen den beiden Formen um, platzieren Punkte entlang ihnen und finden, wo sich zwei Linien kreuzen. Längen sind in Modelleinheiten.

Index

Konstruktoren

constructor

new Line(
    vector: Bit.Vector,
    point: Bit.Point,
    geometryHelper: GeometryHelper,
): Bit.Line
Parameter
- vector: Bit.Vector
- point: Bit.Point
- geometryHelper: GeometryHelper
Rückgabewert Bit.Line
- Definiert in bitbybit-docs.d.ts:53935

convert

lineToSegment

lineToSegment(inputs: Bit.Inputs.Line.LineDto): Segment3
Verwandelt ein Linienobjekt in seine Segmentform, das Paar [start, end].

Beispiel: { start: [0,0,0], end: [10,5,0] } -> [[0,0,0], [10,5,0]]
Parameter
- inputs: Bit.Inputs.Line.LineDto
  Die Linie
Rückgabewert Segment3
Das Segment
- Definiert in bitbybit-docs.d.ts:54109

linesToSegments

linesToSegments(inputs: Bit.Inputs.Line.LinesDto): Segment3[]
Verwandelt jedes Linienobjekt in seine Segmentform, das Paar [start, end].

Beispiel: drei Linien -> drei Segmente, in derselben Reihenfolge
Parameter
- inputs: Bit.Inputs.Line.LinesDto
  Die Linien
Rückgabewert Segment3[]
Ein Segment pro Linie
- Definiert in bitbybit-docs.d.ts:54120

segmentToLine

segmentToLine(inputs: SegmentDto): Line3
Verwandelt ein Segment, das Paar [start, end], in ein Linienobjekt.

Beispiel: [[0,0,0], [10,5,0]] -> { start: [0,0,0], end: [10,5,0] }
Parameter
- inputs: SegmentDto
  Das Segment
Rückgabewert Line3
Die Linie
- Definiert in bitbybit-docs.d.ts:54131

segmentsToLines

segmentsToLines(inputs: SegmentsDto): Line3[]
Verwandelt jedes Segment, ein Paar [start, end], in ein Linienobjekt.

Beispiel: drei Segmente -> drei Linien, in derselben Reihenfolge
Parameter
- inputs: SegmentsDto
  Die Segmente
Rückgabewert Line3[]
Eine Linie pro Segment
- Definiert in bitbybit-docs.d.ts:54142

create

create(inputs: LinePointsDto): Line3
Erzeugt ein Linienobjekt aus einem Start- und einem Endpunkt.

Beispiel: Start [0,0,0], Ende [10,5,0] -> { start: [0,0,0], end: [10,5,0] }
Parameter
- inputs: LinePointsDto
  Der Start- und der Endpunkt
Rückgabewert Line3
Das Linienobjekt
Example
```
const line = bitbybit.line.create({ start: [0, 0, 0], end: [10, 5, 0] });
```
- Definiert in bitbybit-docs.d.ts:54032

createSegment

createSegment(inputs: LinePointsDto): Segment3
Erzeugt ein Segment, die Punktepaar-Form einer Linie, aus einem Start- und einem Endpunkt.

Beispiel: Start [0,0,0], Ende [10,5,0] -> [[0,0,0], [10,5,0]]
Parameter
- inputs: LinePointsDto
  Der Start- und der Endpunkt
Rückgabewert Segment3
Das Segment als [start, end]
Example
```
const segment = bitbybit.line.createSegment({ start: [0, 0, 0], end: [10, 5, 0] });
```
- Definiert in bitbybit-docs.d.ts:54047

linesBetweenPoints

linesBetweenPoints(inputs: PointsLinesDto): Line3[]
Verbindet jeden Punkt mit dem nächsten durch eine Linie, sodass eine Liste von Punkten zu einer Kette von Linien wird.

Beispiel: [[0,0,0], [5,0,0], [5,5,0]] -> zwei Linien, [0,0,0] nach [5,0,0] und [5,0,0] nach [5,5,0]
Parameter
- inputs: PointsLinesDto
  Die Punkte, in Reihenfolge
Rückgabewert Line3[]
Eine Linie pro Paar benachbarter Punkte
Example
```
const chain = bitbybit.line.linesBetweenPoints({ points: [[0, 0, 0], [5, 0, 0], [5, 5, 0]] });
```
- Definiert in bitbybit-docs.d.ts:54079

linesBetweenStartAndEndPoints

linesBetweenStartAndEndPoints(inputs: LineStartEndPointsDto): Line3[]
Paart jeden Startpunkt mit dem Endpunkt an derselben Position und verbindet sie durch eine Linie.

Ein Paar, dessen zwei Punkte zusammenfallen, ergibt keine Linie und wird weggelassen. Beispiel: Starts [[0,0,0], [5,0,0]] und Enden [[0,5,0], [5,5,0]] -> zwei Linien
Parameter
- inputs: LineStartEndPointsDto
  Die Startpunkte und die Endpunkte, in passender Reihenfolge
Rückgabewert Line3[]
Eine Linie pro Paar, Paare mit Länge 0 werden übersprungen
Example
```
const rungs = bitbybit.line.linesBetweenStartAndEndPoints({
    startPoints: [[0, 0, 0], [5, 0, 0]],
    endPoints: [[0, 5, 0], [5, 5, 0]],
});
```
- Definiert in bitbybit-docs.d.ts:54098

get

getStartPoint

getStartPoint(inputs: Bit.Inputs.Line.LineDto): Point3
Liest den Startpunkt einer Linie.

Beispiel: { start: [0,0,0], end: [10,5,0] } -> [0,0,0]
Parameter
- inputs: Bit.Inputs.Line.LineDto
  Die Linie
Rückgabewert Point3
Der Startpunkt
- Definiert in bitbybit-docs.d.ts:53946

getEndPoint

getEndPoint(inputs: Bit.Inputs.Line.LineDto): Point3
Liest den Endpunkt einer Linie.

Beispiel: { start: [0,0,0], end: [10,5,0] } -> [10,5,0]
Parameter
- inputs: Bit.Inputs.Line.LineDto
  Die Linie
Rückgabewert Point3
Der Endpunkt
- Definiert in bitbybit-docs.d.ts:53957

length

length(inputs: Bit.Inputs.Line.LineDto): number
Misst den geraden Abstand vom Anfang einer Linie bis zu ihrem Ende.

Beispiel: { start: [0,0,0], end: [3,4,0] } -> 5
Parameter
- inputs: Bit.Inputs.Line.LineDto
  Die Linie
Rückgabewert number
Die Länge in Modelleinheiten
- Definiert in bitbybit-docs.d.ts:53968

getPointOnLine

getPointOnLine(inputs: PointOnLineDto): Point3
Ermittelt den Punkt bei einem Anteil des Wegs entlang einer Linie: 0 ergibt den Anfang, 1 das Ende, 0.5 die Mitte.

Ein Anteil außerhalb von 0 bis 1 setzt über die Enden hinaus fort. Beispiel: { start: [0,0,0], end: [10,0,0] } bei 0.5 -> [5,0,0]
Parameter
- inputs: PointOnLineDto
  Die Linie und der Anteil entlang der Linie
Rückgabewert Point3
Der Punkt auf der Linie
Example
```
const middle = bitbybit.line.getPointOnLine({ line: { start: [0, 0, 0], end: [10, 0, 0] }, param: 0.5 });
```
- Definiert in bitbybit-docs.d.ts:54064

intersection

lineLineIntersection

lineLineIntersection(inputs: LineLineIntersectionDto): Point3
Ermittelt den Punkt, an dem sich zwei Linien kreuzen.

Mit checkSegmentsOnly an muss die Kreuzung innerhalb beider Segmente liegen; aus, verlängern sich die Linien ohne Ende. Parallele Linien, Linien, die aneinander vorbeilaufen, ohne sich zu treffen, und Segmente, die einander nicht erreichen, ergeben undefined. Die Toleranz sagt, wie nah als Treffen gilt. Beispiel: [0,0,0] nach [10,0,0] und [5,-5,0] nach [5,5,0] -> [5,0,0]
Parameter
- inputs: LineLineIntersectionDto
  Die beiden Linien, ob innerhalb der Segmente geblieben wird, und die Toleranz
Rückgabewert Point3
Der Schnittpunkt oder undefined, wenn es keinen gibt
Example
```
const crossing = bitbybit.line.lineLineIntersection({
    line1: { start: [0, 0, 0], end: [10, 0, 0] },
    line2: { start: [5, -5, 0], end: [5, 5, 0] },
    checkSegmentsOnly: true,
    tolerance: 1e-6,
});
```
- Definiert in bitbybit-docs.d.ts:54165

operations

reverse

reverse(inputs: Bit.Inputs.Line.LineDto): Line3
Vertauscht Anfang und Ende einer Linie, sodass sie in die andere Richtung verläuft.

Beispiel: { start: [0,0,0], end: [10,5,0] } -> { start: [10,5,0], end: [0,0,0] }
Parameter
- inputs: Bit.Inputs.Line.LineDto
  Die Linie
Rückgabewert Line3
Eine neue Linie, die in die andere Richtung verläuft
- Definiert in bitbybit-docs.d.ts:53979

transforms

transformLine

transformLine(inputs: TransformLineDto): Line3
Wendet eine Transformationsmatrix, oder eine Liste davon der Reihe nach, auf beide Enden einer Linie an.

Beispiel: { start: [0,0,0], end: [10,0,0] } verschoben um [5,5,0] -> { start: [5,5,0], end: [15,5,0] }
Parameter
- inputs: TransformLineDto
  Die Linie und die Transformation
Rückgabewert Line3
Eine neue Linie mit den transformierten Enden
Example
```
const moved = bitbybit.line.transformLine({
    line: { start: [0, 0, 0], end: [10, 0, 0] },
    transformation: bitbybit.transforms.translationXYZ({ translation: [5, 5, 0] }),
});
```
- Definiert in bitbybit-docs.d.ts:53998

transformsForLines

transformsForLines(inputs: TransformsLinesDto): Line3[]
Wendet auf jede Linie eine andere Transformation an: die erste Transformation auf die erste Linie, und so weiter.

Beispiel: drei Linien mit drei Verschiebungen -> jede Linie um ihre eigene Verschiebung bewegt
Parameter
- inputs: TransformsLinesDto
  Die Linien und eine Transformation pro Linie
Rückgabewert Line3[]
Die transformierten Linien, in derselben Reihenfolge
Example
```
const placed = bitbybit.line.transformsForLines({
    lines: [{ start: [0, 0, 0], end: [1, 0, 0] }, { start: [0, 0, 0], end: [0, 1, 0] }],
    transformation: bitbybit.transforms.translationsXYZ({ translations: [[0, 1, 0], [0, 2, 0]] }),
});
```
- Definiert in bitbybit-docs.d.ts:54017

Klasse Line

Index

Konstruktoren

convert

create

get

intersection

operations

transforms

Konstruktoren

constructor

Parameter

Rückgabewert Bit.Line

convert

lineToSegment

Parameter

Rückgabewert Segment3

linesToSegments

Parameter

Rückgabewert Segment3[]

segmentToLine

Parameter

Rückgabewert Line3

segmentsToLines

Parameter

Rückgabewert Line3[]

create

create

Parameter

Rückgabewert Line3

Example

createSegment

Parameter

Rückgabewert Segment3

Example

linesBetweenPoints

Parameter

Rückgabewert Line3[]

Example

linesBetweenStartAndEndPoints

Parameter

Rückgabewert Line3[]

Example

get

getStartPoint

Parameter

Rückgabewert Point3

getEndPoint

Parameter

Rückgabewert Point3

length

Parameter

Rückgabewert number

getPointOnLine

Parameter

Rückgabewert Point3

Example

intersection

lineLineIntersection

Parameter

Rückgabewert Point3

Example

operations

reverse

Parameter

Rückgabewert Line3

transforms

transformLine

Parameter

Rückgabewert Line3

Example

transformsForLines

Parameter

Rückgabewert Line3[]

Example

Einstellungen

Auf dieser Seite