Class Polyline

Polylignes : chaînes de segments droits passant par une liste de points, tenues comme de simples objets de la forme { points, isClosed }. Une polyligne fermée relie son dernier point à son premier. Les méthodes ici mesurent une polyligne, la convertissent en segments ou en lignes, trouvent où des polylignes se croisent, trient des segments isolés en chaînes et dimensionnent des congés pour ses coins. Les longueurs sont en unités du modèle.

Index

Constructors

constructor

convert

reverse polylineToLines polylineToSegments

create

Constructors

constructor

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

convert

reverse

reverse(
inputs: Bit.Inputs.Polyline.PolylineDto,
): Bit.Inputs.Polyline.PolylinePropertiesDto
Inverse l'ordre des points, de sorte que la polyligne va dans l'autre sens.

La liste de points propre de la polyligne donnée est inversée sur place et renvoyée dans un nouvel objet polyligne. Exemple : [[0,0,0], [1,0,0], [2,0,0]] -> [[2,0,0], [1,0,0], [0,0,0]]
Parameters
- inputs: Bit.Inputs.Polyline.PolylineDto
  La polyligne
Returns Bit.Inputs.Polyline.PolylinePropertiesDto
Une polyligne avec les points dans l'ordre inverse
Example
```
const back = bitbybit.polyline.reverse({ polyline: { points: [[0, 0, 0], [1, 0, 0], [2, 0, 0]] } });
```
- Defined in bitbybit-docs.d.ts:56360

polylineToLines

polylineToLines(inputs: Bit.Inputs.Polyline.PolylineDto): Line3[]
Découpe la polyligne en objets ligne, un par segment, chacun avec un point de départ et un point d'arrivée.

Une polyligne fermée reçoit aussi le segment de son dernier point à son premier, sauf si les deux coïncident. Exemple : trois points -> deux lignes, ou trois quand elle est fermée
Parameters
- inputs: Bit.Inputs.Polyline.PolylineDto
  La polyligne
Returns Line3[]
Une ligne par segment, dans l'ordre
Example
```
const lines = bitbybit.polyline.polylineToLines({ polyline: { points: [[0, 0, 0], [1, 0, 0], [1, 1, 0]], isClosed: true } });
```
- Defined in bitbybit-docs.d.ts:56410

polylineToSegments

polylineToSegments(inputs: Bit.Inputs.Polyline.PolylineDto): Segment3[]
Découpe la polyligne en segments, chacun une paire de points.

Une polyligne fermée reçoit aussi le segment de son dernier point à son premier, sauf si les deux coïncident. Moins de deux points ne donnent aucun segment. Exemple : quatre points, fermée -> quatre segments autour de la boucle
Parameters
- inputs: Bit.Inputs.Polyline.PolylineDto
  La polyligne
Returns Segment3[]
Une paire de points par segment, dans l'ordre
Example
```
const segments = bitbybit.polyline.polylineToSegments({ polyline: { points: [[0, 0, 0], [1, 0, 0], [1, 1, 0]], isClosed: false } });
```
- Defined in bitbybit-docs.d.ts:56427

create

create(inputs: PolylineCreateDto): Bit.Inputs.Polyline.PolylinePropertiesDto
Construit un objet polyligne à partir de points, ouverte ou fermée.

Exemple : trois points avec isClosed vrai -> un triangle
Parameters
- inputs: PolylineCreateDto
  Les points et si le dernier rejoint le premier
Returns Bit.Inputs.Polyline.PolylinePropertiesDto
L'objet polyligne
Example
```
const triangle = bitbybit.polyline.create({ points: [[0, 0, 0], [1, 0, 0], [1, 1, 0]], isClosed: true });
```
- Defined in bitbybit-docs.d.ts:56393

fillet

maxFilletsHalfLine

maxFilletsHalfLine(inputs: PolylineToleranceDto): number[]
Trouve le plus grand congé pour chaque coin de la polyligne, chacun limité à la moitié la plus proche de ses segments pour que les congés ne se chevauchent jamais.

Une polyligne fermée inclut les deux coins à ses extrémités. Moins de trois points donnent une liste vide.
Parameters
- inputs: PolylineToleranceDto
  La polyligne et la tolérance
Returns number[]
Un rayon par coin, dans l'ordre des coins
Example
```
const radii = bitbybit.polyline.maxFilletsHalfLine({
    polyline: { points: [[0, 0, 0], [10, 0, 0], [10, 10, 0], [0, 10, 0]], isClosed: true },
    tolerance: 1e-7,
});
```
- Defined in bitbybit-docs.d.ts:56508

safestFilletRadius

safestFilletRadius(inputs: PolylineToleranceDto): number
Trouve un seul rayon de congé qui convient à chaque coin de la polyligne : le plus petit des maximums par coin selon la règle du demi-segment.

Moins de trois points, ou tout coin qui n'admet aucun congé, donnent 0.
Parameters
- inputs: PolylineToleranceDto
  La polyligne et la tolérance
Returns number
Le rayon qui convient à chaque coin, en unités du modèle
Example
```
const radius = bitbybit.polyline.safestFilletRadius({
    polyline: { points: [[0, 0, 0], [10, 0, 0], [10, 10, 0], [0, 10, 0]], isClosed: true },
    tolerance: 1e-7,
});
```
- Defined in bitbybit-docs.d.ts:56527

get

length

length(inputs: Bit.Inputs.Polyline.PolylineDto): number
Mesure la polyligne en additionnant les distances en ligne droite entre points voisins.

Le segment de fermeture d'une polyligne fermée n'est pas compté. Exemple : [[0,0,0], [3,0,0], [3,4,0]] -> 7
Parameters
- inputs: Bit.Inputs.Polyline.PolylineDto
  La polyligne
Returns number
La longueur en unités du modèle
Example
```
const len = bitbybit.polyline.length({ polyline: { points: [[0, 0, 0], [3, 0, 0], [3, 4, 0]] } });
```
- Defined in bitbybit-docs.d.ts:56321

countPoints

countPoints(inputs: Bit.Inputs.Polyline.PolylineDto): number
Compte les points de la polyligne.

Exemple : trois points -> 3
Parameters
- inputs: Bit.Inputs.Polyline.PolylineDto
  La polyligne
Returns number
Le nombre de points
- Defined in bitbybit-docs.d.ts:56332

getPoints

getPoints(inputs: Bit.Inputs.Polyline.PolylineDto): Point3[]
Lit la liste des points de la polyligne.

Exemple : { points: [[0,0,0], [1,0,0]] } -> [[0,0,0], [1,0,0]]
Parameters
- inputs: Bit.Inputs.Polyline.PolylineDto
  La polyligne
Returns Point3[]
Ses points, dans l'ordre
- Defined in bitbybit-docs.d.ts:56343

intersection

twoPolylineIntersection

twoPolylineIntersection(inputs: TwoPolylinesToleranceDto): Point3[]
Trouve les points où deux polylignes se croisent, en testant chaque segment de l'une contre chaque segment de l'autre.

Les croisements plus proches l'un de l'autre que la tolérance sont rapportés une seule fois. Exemple : deux polylignes formant un X -> le point au milieu
Parameters
- inputs: TwoPolylinesToleranceDto
  Les deux polylignes et la tolérance
Returns Point3[]
Les points de croisement ; vide quand il n'y en a pas
Example
```
const crossings = bitbybit.polyline.twoPolylineIntersection({
    polyline1: { points: [[0, 0, 0], [2, 2, 0]] },
    polyline2: { points: [[0, 2, 0], [2, 0, 0]] },
    tolerance: 1e-6,
});
```
- Defined in bitbybit-docs.d.ts:56468

intersections

polylineSelfIntersection

polylineSelfIntersection(inputs: PolylineToleranceDto): Point3[]
Trouve les points où la polyligne se croise elle-même.

Les segments voisins ne sont pas testés l'un contre l'autre, et les croisements plus proches l'un de l'autre que la tolérance sont rapportés une seule fois. Exemple : un huit -> son unique point de croisement
Parameters
- inputs: PolylineToleranceDto
  La polyligne et la tolérance
Returns Point3[]
Les points de croisement ; vide quand il n'y en a pas
Example
```
const crossings = bitbybit.polyline.polylineSelfIntersection({
    polyline: { points: [[0, 0, 0], [2, 2, 0], [2, 0, 0], [0, 2, 0]] },
    tolerance: 1e-6,
});
```
- Defined in bitbybit-docs.d.ts:56447

sort

sortSegmentsIntoPolylines

sortSegmentsIntoPolylines(inputs: SegmentsToleranceDto): Polyline3[]
Réunit des segments épars en polylignes en faisant correspondre les extrémités qui se rejoignent à la tolérance près.

Les segments qui se connectent bout à bout deviennent une polyligne par chaîne ; les segments qui ne touchent rien deviennent des polylignes à un seul segment. Exemple : dix segments dispersés formant deux chaînes -> deux polylignes
Parameters
- inputs: SegmentsToleranceDto
  Les segments et la tolérance pour que deux extrémités soient considérées comme se touchant
Returns Polyline3[]
Les polylignes que forment les segments
Example
```
const chains = bitbybit.polyline.sortSegmentsIntoPolylines({
    segments: [[[0, 0, 0], [1, 0, 0]], [[1, 0, 0], [1, 1, 0]], [[5, 5, 0], [6, 5, 0]]],
    tolerance: 1e-5,
});
```
- Defined in bitbybit-docs.d.ts:56488

transforms

transformPolyline

transformPolyline(
inputs: TransformPolylineDto,
): Bit.Inputs.Polyline.PolylinePropertiesDto
Applique une matrice de transformation, ou une liste de matrices dans l'ordre, à chaque point de la polyligne.

Exemple : une translation de [5,0,0] -> chaque point déplacé de 5 le long de X
Parameters
- inputs: TransformPolylineDto
  La polyligne et la transformation
Returns Bit.Inputs.Polyline.PolylinePropertiesDto
Une nouvelle polyligne avec les points transformés
Example
```
const moved = bitbybit.polyline.transformPolyline({
    polyline: { points: [[0, 0, 0], [1, 0, 0]] },
    transformation: bitbybit.transforms.translationXYZ({ translation: [5, 0, 0] }),
});
```
- Defined in bitbybit-docs.d.ts:56378

Class Polyline

Index

Constructors

convert

create

fillet

get

intersection

intersections

sort

transforms

Constructors

constructor

Parameters

Returns Bit.Polyline

convert

reverse

Parameters

Returns Bit.Inputs.Polyline.PolylinePropertiesDto

Example

polylineToLines

Parameters

Returns Line3[]

Example

polylineToSegments

Parameters

Returns Segment3[]

Example

create

create

Parameters

Returns Bit.Inputs.Polyline.PolylinePropertiesDto

Example

fillet

maxFilletsHalfLine

Parameters

Returns number[]

Example

safestFilletRadius

Parameters

Returns number

Example

get

length

Parameters

Returns number

Example

countPoints

Parameters

Returns number

getPoints

Parameters

Returns Point3[]

intersection

twoPolylineIntersection

Parameters

Returns Point3[]

Example

intersections

polylineSelfIntersection

Parameters

Returns Point3[]

Example

sort

sortSegmentsIntoPolylines

Parameters

Returns Polyline3[]

Example

transforms

transformPolyline

Parameters

Returns Bit.Inputs.Polyline.PolylinePropertiesDto

Example

Settings

On This Page