Class Line

Lignes droites entre deux points, tenues comme de simples objets de la forme { start, end }, et la forme segment [start, end] de la même chose. Les méthodes ici construisent des lignes, les mesurent et les transforment, convertissent entre les deux formes, placent des points le long d'elles et trouvent où deux lignes se croisent. Les longueurs sont en unités du modèle.

Index

Constructors

constructor

new Line(
    vector: Bit.Vector,
    point: Bit.Point,
    geometryHelper: GeometryHelper,
): Bit.Line
Parameters
- vector: Bit.Vector
- point: Bit.Point
- geometryHelper: GeometryHelper
Returns Bit.Line
- Defined in bitbybit-docs.d.ts:53935

convert

lineToSegment

lineToSegment(inputs: Bit.Inputs.Line.LineDto): Segment3
Transforme un objet ligne en sa forme segment, la paire [start, end].

Exemple : { start: [0,0,0], end: [10,5,0] } -> [[0,0,0], [10,5,0]]
Parameters
- inputs: Bit.Inputs.Line.LineDto
  La ligne
Returns Segment3
Le segment
- Defined in bitbybit-docs.d.ts:54109

linesToSegments

linesToSegments(inputs: Bit.Inputs.Line.LinesDto): Segment3[]
Transforme chaque objet ligne en sa forme segment, la paire [start, end].

Exemple : trois lignes -> trois segments, dans le même ordre
Parameters
- inputs: Bit.Inputs.Line.LinesDto
  Les lignes
Returns Segment3[]
Un segment par ligne
- Defined in bitbybit-docs.d.ts:54120

segmentToLine

segmentToLine(inputs: SegmentDto): Line3
Transforme un segment, la paire [start, end], en objet ligne.

Exemple : [[0,0,0], [10,5,0]] -> { start: [0,0,0], end: [10,5,0] }
Parameters
- inputs: SegmentDto
  Le segment
Returns Line3
La ligne
- Defined in bitbybit-docs.d.ts:54131

segmentsToLines

segmentsToLines(inputs: SegmentsDto): Line3[]
Transforme chaque segment, une paire [start, end], en objet ligne.

Exemple : trois segments -> trois lignes, dans le même ordre
Parameters
- inputs: SegmentsDto
  Les segments
Returns Line3[]
Une ligne par segment
- Defined in bitbybit-docs.d.ts:54142

create

create(inputs: LinePointsDto): Line3
Construit un objet ligne à partir d'un point de départ et d'un point d'arrivée.

Exemple : départ [0,0,0], arrivée [10,5,0] -> { start: [0,0,0], end: [10,5,0] }
Parameters
- inputs: LinePointsDto
  Les points de départ et d'arrivée
Returns Line3
L'objet ligne
Example
```
const line = bitbybit.line.create({ start: [0, 0, 0], end: [10, 5, 0] });
```
- Defined in bitbybit-docs.d.ts:54032

createSegment

createSegment(inputs: LinePointsDto): Segment3
Construit un segment, la forme paire-de-points d'une ligne, à partir d'un point de départ et d'un point d'arrivée.

Exemple : départ [0,0,0], arrivée [10,5,0] -> [[0,0,0], [10,5,0]]
Parameters
- inputs: LinePointsDto
  Les points de départ et d'arrivée
Returns Segment3
Le segment sous forme [start, end]
Example
```
const segment = bitbybit.line.createSegment({ start: [0, 0, 0], end: [10, 5, 0] });
```
- Defined in bitbybit-docs.d.ts:54047

linesBetweenPoints

linesBetweenPoints(inputs: PointsLinesDto): Line3[]
Relie chaque point au suivant par une ligne, de sorte qu'une liste de points devient une chaîne de lignes.

Exemple : [[0,0,0], [5,0,0], [5,5,0]] -> deux lignes, [0,0,0] vers [5,0,0] et [5,0,0] vers [5,5,0]
Parameters
- inputs: PointsLinesDto
  Les points, dans l'ordre
Returns Line3[]
Une ligne par paire de points voisins
Example
```
const chain = bitbybit.line.linesBetweenPoints({ points: [[0, 0, 0], [5, 0, 0], [5, 5, 0]] });
```
- Defined in bitbybit-docs.d.ts:54079

linesBetweenStartAndEndPoints

linesBetweenStartAndEndPoints(inputs: LineStartEndPointsDto): Line3[]
Apparie chaque point de départ avec le point d'arrivée à la même position et les relie par une ligne.

Une paire dont les deux points coïncident ne fait aucune ligne et est laissée de côté. Exemple : départs [[0,0,0], [5,0,0]] et arrivées [[0,5,0], [5,5,0]] -> deux lignes
Parameters
- inputs: LineStartEndPointsDto
  Les points de départ et les points d'arrivée, dans un ordre correspondant
Returns Line3[]
Une ligne par paire, en sautant les paires de longueur 0
Example
```
const rungs = bitbybit.line.linesBetweenStartAndEndPoints({
    startPoints: [[0, 0, 0], [5, 0, 0]],
    endPoints: [[0, 5, 0], [5, 5, 0]],
});
```
- Defined in bitbybit-docs.d.ts:54098

get

getStartPoint

getStartPoint(inputs: Bit.Inputs.Line.LineDto): Point3
Lit le point de départ d'une ligne.

Exemple : { start: [0,0,0], end: [10,5,0] } -> [0,0,0]
Parameters
- inputs: Bit.Inputs.Line.LineDto
  La ligne
Returns Point3
Le point de départ
- Defined in bitbybit-docs.d.ts:53946

getEndPoint

getEndPoint(inputs: Bit.Inputs.Line.LineDto): Point3
Lit le point d'arrivée d'une ligne.

Exemple : { start: [0,0,0], end: [10,5,0] } -> [10,5,0]
Parameters
- inputs: Bit.Inputs.Line.LineDto
  La ligne
Returns Point3
Le point d'arrivée
- Defined in bitbybit-docs.d.ts:53957

length

length(inputs: Bit.Inputs.Line.LineDto): number
Mesure la distance en ligne droite du début d'une ligne à sa fin.

Exemple : { start: [0,0,0], end: [3,4,0] } -> 5
Parameters
- inputs: Bit.Inputs.Line.LineDto
  La ligne
Returns number
La longueur en unités du modèle
- Defined in bitbybit-docs.d.ts:53968

getPointOnLine

getPointOnLine(inputs: PointOnLineDto): Point3
Trouve le point situé à une fraction du chemin le long d'une ligne : 0 donne le début, 1 la fin, 0.5 le milieu.

Une fraction hors de 0 à 1 continue au-delà des extrémités. Exemple : { start: [0,0,0], end: [10,0,0] } à 0.5 -> [5,0,0]
Parameters
- inputs: PointOnLineDto
  La ligne et la fraction le long de celle-ci
Returns Point3
Le point sur la ligne
Example
```
const middle = bitbybit.line.getPointOnLine({ line: { start: [0, 0, 0], end: [10, 0, 0] }, param: 0.5 });
```
- Defined in bitbybit-docs.d.ts:54064

intersection

lineLineIntersection

lineLineIntersection(inputs: LineLineIntersectionDto): Point3
Trouve le point où deux lignes se croisent.

Avec checkSegmentsOnly actif, le croisement doit se trouver dans les deux segments ; inactif, les lignes s'étendent sans fin. Des lignes parallèles, des lignes qui se croisent sans se rencontrer, et des segments qui ne s'atteignent pas donnent undefined. La tolérance dit à quelle distance on considère qu'elles se rencontrent. Exemple : [0,0,0] vers [10,0,0] et [5,-5,0] vers [5,5,0] -> [5,0,0]
Parameters
- inputs: LineLineIntersectionDto
  Les deux lignes, s'il faut rester dans les segments, et la tolérance
Returns Point3
Le point de croisement, ou undefined quand il n'y en a pas
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,
});
```
- Defined in bitbybit-docs.d.ts:54165

operations

reverse

reverse(inputs: Bit.Inputs.Line.LineDto): Line3
Échange le début et la fin d'une ligne, de sorte qu'elle va dans l'autre sens.

Exemple : { start: [0,0,0], end: [10,5,0] } -> { start: [10,5,0], end: [0,0,0] }
Parameters
- inputs: Bit.Inputs.Line.LineDto
  La ligne
Returns Line3
Une nouvelle ligne parcourue dans l'autre sens
- Defined in bitbybit-docs.d.ts:53979

transforms

transformLine

transformLine(inputs: TransformLineDto): Line3
Applique une matrice de transformation, ou une liste de matrices dans l'ordre, aux deux extrémités d'une ligne.

Exemple : { start: [0,0,0], end: [10,0,0] } déplacé de [5,5,0] -> { start: [5,5,0], end: [15,5,0] }
Parameters
- inputs: TransformLineDto
  La ligne et la transformation
Returns Line3
Une nouvelle ligne avec les extrémités transformées
Example
```
const moved = bitbybit.line.transformLine({
    line: { start: [0, 0, 0], end: [10, 0, 0] },
    transformation: bitbybit.transforms.translationXYZ({ translation: [5, 5, 0] }),
});
```
- Defined in bitbybit-docs.d.ts:53998

transformsForLines

transformsForLines(inputs: TransformsLinesDto): Line3[]
Applique une transformation différente à chaque ligne : la première transformation à la première ligne, et ainsi de suite.

Exemple : trois lignes avec trois translations -> chaque ligne déplacée de sa propre translation
Parameters
- inputs: TransformsLinesDto
  Les lignes et une transformation par ligne
Returns Line3[]
Les lignes transformées, dans le même ordre
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]] }),
});
```
- Defined in bitbybit-docs.d.ts:54017

Class Line

Index

Constructors

convert

create

get

intersection

operations

transforms

Constructors

constructor

Parameters

Returns Bit.Line

convert

lineToSegment

Parameters

Returns Segment3

linesToSegments

Parameters

Returns Segment3[]

segmentToLine

Parameters

Returns Line3

segmentsToLines

Parameters

Returns Line3[]

create

create

Parameters

Returns Line3

Example

createSegment

Parameters

Returns Segment3

Example

linesBetweenPoints

Parameters

Returns Line3[]

Example

linesBetweenStartAndEndPoints

Parameters

Returns Line3[]

Example

get

getStartPoint

Parameters

Returns Point3

getEndPoint

Parameters

Returns Point3

length

Parameters

Returns number

getPointOnLine

Parameters

Returns Point3

Example

intersection

lineLineIntersection

Parameters

Returns Point3

Example

operations

reverse

Parameters

Returns Line3

transforms

transformLine

Parameters

Returns Line3

Example

transformsForLines

Parameters

Returns Line3[]

Example

Settings

On This Page