Class AcApPolylineJig

Preview jig that dynamically updates a polyline while the user is acquiring the next point.

Responsibilities:

Keep the already-confirmed vertices visible.
Add a transient "current" vertex that follows the cursor.
Update the bulge of the last confirmed vertex to preview arc/line changes.

Why this jig exists:

Point acquisition needs live geometry updates as the cursor moves.
We update the polyline incrementally (add/remove a single temp vertex) instead of reset() to avoid flicker and preserve transient state.

Hierarchy (View Summary)

AcEdPreviewJig<AcGePoint2dLike>
- AcApPolylineJig

Index

Constructors

Accessors

Methods

end render update

Constructors

constructor

new AcApPolylineJig(
    view: AcEdBaseView,
    points: AcGePoint2d[],
    bulges: (number | undefined)[],
    currentBulge?: number,
    bulgeProvider?: (endPoint: AcGeVector2dLike) => number | undefined,
): AcApPolylineJig
Create a polyline preview jig for point acquisition.
Parameters
- view: AcEdBaseView
  The associated view for transient rendering.
- points: AcGePoint2d[]
  Confirmed polyline vertices.
- bulges: (number | undefined)[]
  Bulge values aligned with points.
- OptionalcurrentBulge: number
  Optional fixed bulge used for the preview segment.
- OptionalbulgeProvider: (endPoint: AcGeVector2dLike) => number | undefined
  Optional function to compute bulge based on the current cursor point.
Returns AcApPolylineJig
Overrides AcEdPreviewJig.constructor
- Defined in packages/cad-simple-viewer/src/command/draw/AcApPolylineCmd.ts:63

Accessors

entity

get entity(): AcDbPolyline
The transient polyline entity being previewed.

Returns AcDbPolyline
Overrides AcEdPreviewJig.entity
- Defined in packages/cad-simple-viewer/src/command/draw/AcApPolylineCmd.ts:84

Methods

end

end(): void
End the jig and clear any transient preview state.

Should be called when the user finalizes input (mouse click or Enter) to prevent further updates and allow garbage collection.

Returns void
Inherited from AcEdPreviewJig.end
- Defined in packages/cad-simple-viewer/src/editor/input/AcEdPreviewJig.ts:114

render

render(): void
Render the preview entity through the associated view.

Equivalent to AutoCAD’s worldDraw() — called after each update(value).

Returns void
Inherited from AcEdPreviewJig.render
- Defined in packages/cad-simple-viewer/src/editor/input/AcEdPreviewJig.ts:102

update

update(point: AcGeVector2dLike): void
Update the preview polyline as the cursor moves.

This updates:
- The bulge of the last confirmed vertex (if needed).
- A single temporary vertex representing the current cursor position.
Parameters
- point: AcGeVector2dLike
Returns void
Overrides AcEdPreviewJig.update
- Defined in packages/cad-simple-viewer/src/command/draw/AcApPolylineCmd.ts:95