Class LineBuilder

Fluent wrapper around a single JudgeLine.

Exposes methods for adding notes, events (by channel), and event layers. All mutating methods return this for chaining unless prefixed with get / new, which return more specific builders.

Event methods

.moveX(), .moveY(), .rotate(), .alpha(), .speed(), .incline(), .scaleX(), .scaleY(), .colorEvent(), .textEvent(), .gifEvent()

Note methods

.addNote(), .addNotes(), .removeNote(), .clearNotes()

Misc

.setName(), .setParent(), .setZOrder(), .addLayer(), .notes() (NoteIterator), .events() (EventIterator)

Example

const lb = new LineBuilder(chart, 0);

// Animate the line and add notes
lb.moveX(0, 4, 0, 675, 'cubicOut')
  .rotate(0, 4, 0, 90, 'sineInOut')
  .alpha(0, 1, 0, 255)
  .addNote(2, { type: 1 })
  .addNote(3, { type: 3 });

// Color transition: white → red over beats 4–8
lb.colorEvent(4, 8, [255, 255, 255], [255, 0, 0]);

// Attach a text overlay
lb.textEvent(0, 4, 'Hello', 'World');

Constructors

constructor

new LineBuilder(chart: RpeJson, lineIndex: number): LineBuilder
Parameters
- chart: RpeJson
- lineIndex: number
Returns LineBuilder
- Defined in prototype.ts:436

Properties

`Readonly`chart

chart: RpeJson

Reference to the parent chart.

`Readonly`index

index: number

Index of this line in chart.judgeLineList.

Accessors

data

get data(): JudgeLine
The raw JudgeLine data.

Returns JudgeLine
- Defined in prototype.ts:445

noteCount

get noteCount(): number
Number of notes on this line.

Returns number
- Defined in prototype.ts:909

Methods

setName

setName(name: string): this
Set this line's name.
Parameters
- name: string
Returns this
- Defined in prototype.ts:452

setTexture

setTexture(texture: string): this
Set this line's texture.
Parameters
- texture: string
Returns this
- Defined in prototype.ts:458

setGroup

setGroup(group: number): this
Set this line's group index.
Parameters
- group: number
Returns this
- Defined in prototype.ts:464

setZOrder

setZOrder(z: number): this
Set the Z-order for rendering.
Parameters
- z: number
Returns this
- Defined in prototype.ts:470

setCover

setCover(cover: 0 | 1): this
Set whether this line is a cover.
Parameters
- cover: 0 | 1
Returns this
- Defined in prototype.ts:476

setBpmFactor

setBpmFactor(factor: number): this
Set BPM factor.
Parameters
- factor: number
Returns this
- Defined in prototype.ts:482

setParent

setParent(parentIndex: number): this
Set the parent line index (-1 for no parent).
Parameters
- parentIndex: number
Returns this
- Defined in prototype.ts:488

setRotateWithFather

setRotateWithFather(value: boolean): this
Set rotateWithFather.
Parameters
- value: boolean
Returns this
- Defined in prototype.ts:494

setAnchor

setAnchor(x: number, y: number): this
Set anchor.
Parameters
- x: number
- y: number
Returns this
- Defined in prototype.ts:500

addNote

addNote(beat: number, options?: CreateNoteOptions): this
Add a note at beat.
Parameters
- beat: number
  Start beat.
- options: CreateNoteOptions = {}
  Note creation options.
Returns this
- Defined in prototype.ts:513

addNotes

addNotes(
beats: (number | [number, CreateNoteOptions])[],
sharedOptions?: CreateNoteOptions,
): this
Add multiple notes at once.
Parameters
- beats: (number | [number, CreateNoteOptions])[]
  Array of beats or [beat, options] tuples.
- sharedOptions: CreateNoteOptions = {}
  Options applied to all notes.
Returns this
this for chaining.
- Defined in prototype.ts:525

getNote

getNote(noteIndex: number): NoteBuilder
Get a NoteBuilder wrapping the note at noteIndex.
Parameters
- noteIndex: number
Returns NoteBuilder
- Defined in prototype.ts:533

removeNote

removeNote(noteIndex: number): Note | undefined
Remove a note at noteIndex from this line.
Parameters
- noteIndex: number
Returns Note | undefined
The removed Note, or undefined.
- Defined in prototype.ts:541

removeNotes

removeNotes(predicate: (note: Note, index: number) => boolean): Note[]
Remove all notes matching a predicate.
Parameters
- predicate: (note: Note, index: number) => boolean
Returns Note[]
Array of removed notes.
- Defined in prototype.ts:549

clearNotes

clearNotes(): Note[]
Remove all notes from this line.

Returns Note[]
Array of removed notes.
- Defined in prototype.ts:557

noteIterator

noteIterator(): NoteIterator
Iterate all notes on this line via a NoteIterator.

Returns NoteIterator
- Defined in prototype.ts:562

addLayer

addLayer(): EventLayerBuilder
Add a new empty event layer and return its EventLayerBuilder.

Returns EventLayerBuilder
- Defined in prototype.ts:571

getLayer

getLayer(layerIndex?: number): EventLayerBuilder
Get an EventLayerBuilder for an existing event layer.
Parameters
- layerIndex: number = 0
Returns EventLayerBuilder
- Defined in prototype.ts:579

removeLayer

removeLayer(layerIndex: number): EventLayer | null | undefined
Remove an event layer by index.
Parameters
- layerIndex: number
Returns EventLayer | null | undefined
The removed EventLayer, or undefined.
- Defined in prototype.ts:587

moveX

moveX(
    startBeat: number,
    endBeat: number,
    from: number,
    to: number,
    easing?:
        | number
        | "linear"
        | "sineOut"
        | "sineIn"
        | "quadOut"
        | "quadIn"
        | "sineInOut"
        | "quadInOut"
        | "cubicOut"
        | "cubicIn"
        | "quartOut"
        | "quartIn"
        | "cubicInOut"
        | "quartInOut"
        | "quintOut"
        | "quintIn"
        | "expoOut"
        | "expoIn"
        | "circOut"
        | "circIn"
        | "backOut"
        | "backIn"
        | "circInOut"
        | "backInOut"
        | "elasticOut"
        | "elasticIn"
        | "bounceOut"
        | "bounceIn"
        | "bounceInOut",
    index?: number,
    options?: EventOptions,
): this
Add a moveX event on layer 0.
Parameters
- startBeat: number
  Start beat.
- endBeat: number
  End beat.
- from: number
  Start X value.
- to: number
  End X value.
- easing:
      | number
      | "linear"
      | "sineOut"
      | "sineIn"
      | "quadOut"
      | "quadIn"
      | "sineInOut"
      | "quadInOut"
      | "cubicOut"
      | "cubicIn"
      | "quartOut"
      | "quartIn"
      | "cubicInOut"
      | "quartInOut"
      | "quintOut"
      | "quintIn"
      | "expoOut"
      | "expoIn"
      | "circOut"
      | "circIn"
      | "backOut"
      | "backIn"
      | "circInOut"
      | "backInOut"
      | "elasticOut"
      | "elasticIn"
      | "bounceOut"
      | "bounceIn"
      | "bounceInOut" = 1
  Easing type (default: 1 = linear).
- index: number = 0
  Layer index (default: 0).
- options: EventOptions = {}
Returns this
- Defined in prototype.ts:603

moveY

moveY(
    startBeat: number,
    endBeat: number,
    from: number,
    to: number,
    easing?:
        | number
        | "linear"
        | "sineOut"
        | "sineIn"
        | "quadOut"
        | "quadIn"
        | "sineInOut"
        | "quadInOut"
        | "cubicOut"
        | "cubicIn"
        | "quartOut"
        | "quartIn"
        | "cubicInOut"
        | "quartInOut"
        | "quintOut"
        | "quintIn"
        | "expoOut"
        | "expoIn"
        | "circOut"
        | "circIn"
        | "backOut"
        | "backIn"
        | "circInOut"
        | "backInOut"
        | "elasticOut"
        | "elasticIn"
        | "bounceOut"
        | "bounceIn"
        | "bounceInOut",
    index?: number,
    options?: EventOptions,
): this
Add a moveY event on layer 0.
Parameters
- startBeat: number
- endBeat: number
- from: number
- to: number
- easing:
      | number
      | "linear"
      | "sineOut"
      | "sineIn"
      | "quadOut"
      | "quadIn"
      | "sineInOut"
      | "quadInOut"
      | "cubicOut"
      | "cubicIn"
      | "quartOut"
      | "quartIn"
      | "cubicInOut"
      | "quartInOut"
      | "quintOut"
      | "quintIn"
      | "expoOut"
      | "expoIn"
      | "circOut"
      | "circIn"
      | "backOut"
      | "backIn"
      | "circInOut"
      | "backInOut"
      | "elasticOut"
      | "elasticIn"
      | "bounceOut"
      | "bounceIn"
      | "bounceInOut" = 1
- index: number = 0
- options: EventOptions = {}
Returns this
- Defined in prototype.ts:619

rotate

rotate(
    startBeat: number,
    endBeat: number,
    from: number,
    to: number,
    easing?:
        | number
        | "linear"
        | "sineOut"
        | "sineIn"
        | "quadOut"
        | "quadIn"
        | "sineInOut"
        | "quadInOut"
        | "cubicOut"
        | "cubicIn"
        | "quartOut"
        | "quartIn"
        | "cubicInOut"
        | "quartInOut"
        | "quintOut"
        | "quintIn"
        | "expoOut"
        | "expoIn"
        | "circOut"
        | "circIn"
        | "backOut"
        | "backIn"
        | "circInOut"
        | "backInOut"
        | "elasticOut"
        | "elasticIn"
        | "bounceOut"
        | "bounceIn"
        | "bounceInOut",
    index?: number,
    options?: EventOptions,
): this
Add a rotate event on layer 0.
Parameters
- startBeat: number
- endBeat: number
- from: number
- to: number
- easing:
      | number
      | "linear"
      | "sineOut"
      | "sineIn"
      | "quadOut"
      | "quadIn"
      | "sineInOut"
      | "quadInOut"
      | "cubicOut"
      | "cubicIn"
      | "quartOut"
      | "quartIn"
      | "cubicInOut"
      | "quartInOut"
      | "quintOut"
      | "quintIn"
      | "expoOut"
      | "expoIn"
      | "circOut"
      | "circIn"
      | "backOut"
      | "backIn"
      | "circInOut"
      | "backInOut"
      | "elasticOut"
      | "elasticIn"
      | "bounceOut"
      | "bounceIn"
      | "bounceInOut" = 1
- index: number = 0
- options: EventOptions = {}
Returns this
- Defined in prototype.ts:635

alpha

alpha(
    startBeat: number,
    endBeat: number,
    from: number,
    to: number,
    easing?:
        | number
        | "linear"
        | "sineOut"
        | "sineIn"
        | "quadOut"
        | "quadIn"
        | "sineInOut"
        | "quadInOut"
        | "cubicOut"
        | "cubicIn"
        | "quartOut"
        | "quartIn"
        | "cubicInOut"
        | "quartInOut"
        | "quintOut"
        | "quintIn"
        | "expoOut"
        | "expoIn"
        | "circOut"
        | "circIn"
        | "backOut"
        | "backIn"
        | "circInOut"
        | "backInOut"
        | "elasticOut"
        | "elasticIn"
        | "bounceOut"
        | "bounceIn"
        | "bounceInOut",
    index?: number,
    options?: EventOptions,
): this
Add an alpha event on layer 0.
Parameters
- startBeat: number
- endBeat: number
- from: number
- to: number
- easing:
      | number
      | "linear"
      | "sineOut"
      | "sineIn"
      | "quadOut"
      | "quadIn"
      | "sineInOut"
      | "quadInOut"
      | "cubicOut"
      | "cubicIn"
      | "quartOut"
      | "quartIn"
      | "cubicInOut"
      | "quartInOut"
      | "quintOut"
      | "quintIn"
      | "expoOut"
      | "expoIn"
      | "circOut"
      | "circIn"
      | "backOut"
      | "backIn"
      | "circInOut"
      | "backInOut"
      | "elasticOut"
      | "elasticIn"
      | "bounceOut"
      | "bounceIn"
      | "bounceInOut" = 1
- index: number = 0
- options: EventOptions = {}
Returns this
- Defined in prototype.ts:651

speed

speed(
    startBeat: number,
    endBeat: number,
    from: number,
    to: number,
    easing?:
        | number
        | "linear"
        | "sineOut"
        | "sineIn"
        | "quadOut"
        | "quadIn"
        | "sineInOut"
        | "quadInOut"
        | "cubicOut"
        | "cubicIn"
        | "quartOut"
        | "quartIn"
        | "cubicInOut"
        | "quartInOut"
        | "quintOut"
        | "quintIn"
        | "expoOut"
        | "expoIn"
        | "circOut"
        | "circIn"
        | "backOut"
        | "backIn"
        | "circInOut"
        | "backInOut"
        | "elasticOut"
        | "elasticIn"
        | "bounceOut"
        | "bounceIn"
        | "bounceInOut",
    index?: number,
    options?: SpeedEventOptions,
): this
Add a speed event on layer 0.
Parameters
- startBeat: number
- endBeat: number
- from: number
- to: number
- easing:
      | number
      | "linear"
      | "sineOut"
      | "sineIn"
      | "quadOut"
      | "quadIn"
      | "sineInOut"
      | "quadInOut"
      | "cubicOut"
      | "cubicIn"
      | "quartOut"
      | "quartIn"
      | "cubicInOut"
      | "quartInOut"
      | "quintOut"
      | "quintIn"
      | "expoOut"
      | "expoIn"
      | "circOut"
      | "circIn"
      | "backOut"
      | "backIn"
      | "circInOut"
      | "backInOut"
      | "elasticOut"
      | "elasticIn"
      | "bounceOut"
      | "bounceIn"
      | "bounceInOut" = 1
- index: number = 0
- options: SpeedEventOptions = {}
Returns this
- Defined in prototype.ts:667

incline

incline(
    startBeat: number,
    endBeat: number,
    from: number,
    to: number,
    easing?:
        | number
        | "linear"
        | "sineOut"
        | "sineIn"
        | "quadOut"
        | "quadIn"
        | "sineInOut"
        | "quadInOut"
        | "cubicOut"
        | "cubicIn"
        | "quartOut"
        | "quartIn"
        | "cubicInOut"
        | "quartInOut"
        | "quintOut"
        | "quintIn"
        | "expoOut"
        | "expoIn"
        | "circOut"
        | "circIn"
        | "backOut"
        | "backIn"
        | "circInOut"
        | "backInOut"
        | "elasticOut"
        | "elasticIn"
        | "bounceOut"
        | "bounceIn"
        | "bounceInOut",
    options?: EventOptions,
): this
Add an incline event.
Parameters
- startBeat: number
- endBeat: number
- from: number
- to: number
- easing:
      | number
      | "linear"
      | "sineOut"
      | "sineIn"
      | "quadOut"
      | "quadIn"
      | "sineInOut"
      | "quadInOut"
      | "cubicOut"
      | "cubicIn"
      | "quartOut"
      | "quartIn"
      | "cubicInOut"
      | "quartInOut"
      | "quintOut"
      | "quintIn"
      | "expoOut"
      | "expoIn"
      | "circOut"
      | "circIn"
      | "backOut"
      | "backIn"
      | "circInOut"
      | "backInOut"
      | "elasticOut"
      | "elasticIn"
      | "bounceOut"
      | "bounceIn"
      | "bounceInOut" = 1
- options: EventOptions = {}
Returns this
- Defined in prototype.ts:683

scaleX

scaleX(
    startBeat: number,
    endBeat: number,
    from: number,
    to: number,
    easing?:
        | number
        | "linear"
        | "sineOut"
        | "sineIn"
        | "quadOut"
        | "quadIn"
        | "sineInOut"
        | "quadInOut"
        | "cubicOut"
        | "cubicIn"
        | "quartOut"
        | "quartIn"
        | "cubicInOut"
        | "quartInOut"
        | "quintOut"
        | "quintIn"
        | "expoOut"
        | "expoIn"
        | "circOut"
        | "circIn"
        | "backOut"
        | "backIn"
        | "circInOut"
        | "backInOut"
        | "elasticOut"
        | "elasticIn"
        | "bounceOut"
        | "bounceIn"
        | "bounceInOut",
    options?: EventOptions,
): this
Add a scaleX event.
Parameters
- startBeat: number
- endBeat: number
- from: number
- to: number
- easing:
      | number
      | "linear"
      | "sineOut"
      | "sineIn"
      | "quadOut"
      | "quadIn"
      | "sineInOut"
      | "quadInOut"
      | "cubicOut"
      | "cubicIn"
      | "quartOut"
      | "quartIn"
      | "cubicInOut"
      | "quartInOut"
      | "quintOut"
      | "quintIn"
      | "expoOut"
      | "expoIn"
      | "circOut"
      | "circIn"
      | "backOut"
      | "backIn"
      | "circInOut"
      | "backInOut"
      | "elasticOut"
      | "elasticIn"
      | "bounceOut"
      | "bounceIn"
      | "bounceInOut" = 1
- options: EventOptions = {}
Returns this
- Defined in prototype.ts:696

scaleY

scaleY(
    startBeat: number,
    endBeat: number,
    from: number,
    to: number,
    easing?:
        | number
        | "linear"
        | "sineOut"
        | "sineIn"
        | "quadOut"
        | "quadIn"
        | "sineInOut"
        | "quadInOut"
        | "cubicOut"
        | "cubicIn"
        | "quartOut"
        | "quartIn"
        | "cubicInOut"
        | "quartInOut"
        | "quintOut"
        | "quintIn"
        | "expoOut"
        | "expoIn"
        | "circOut"
        | "circIn"
        | "backOut"
        | "backIn"
        | "circInOut"
        | "backInOut"
        | "elasticOut"
        | "elasticIn"
        | "bounceOut"
        | "bounceIn"
        | "bounceInOut",
    options?: EventOptions,
): this
Add a scaleY event.
Parameters
- startBeat: number
- endBeat: number
- from: number
- to: number
- easing:
      | number
      | "linear"
      | "sineOut"
      | "sineIn"
      | "quadOut"
      | "quadIn"
      | "sineInOut"
      | "quadInOut"
      | "cubicOut"
      | "cubicIn"
      | "quartOut"
      | "quartIn"
      | "cubicInOut"
      | "quartInOut"
      | "quintOut"
      | "quintIn"
      | "expoOut"
      | "expoIn"
      | "circOut"
      | "circIn"
      | "backOut"
      | "backIn"
      | "circInOut"
      | "backInOut"
      | "elasticOut"
      | "elasticIn"
      | "bounceOut"
      | "bounceIn"
      | "bounceInOut" = 1
- options: EventOptions = {}
Returns this
- Defined in prototype.ts:709

color

color(
    startBeat: number,
    endBeat: number,
    startColor: [number, number, number],
    endColor: [number, number, number],
    easing?:
        | number
        | "linear"
        | "sineOut"
        | "sineIn"
        | "quadOut"
        | "quadIn"
        | "sineInOut"
        | "quadInOut"
        | "cubicOut"
        | "cubicIn"
        | "quartOut"
        | "quartIn"
        | "cubicInOut"
        | "quartInOut"
        | "quintOut"
        | "quintIn"
        | "expoOut"
        | "expoIn"
        | "circOut"
        | "circIn"
        | "backOut"
        | "backIn"
        | "circInOut"
        | "backInOut"
        | "elasticOut"
        | "elasticIn"
        | "bounceOut"
        | "bounceIn"
        | "bounceInOut",
    options?: EventOptions,
): this
Add a color event.
Parameters
- startBeat: number
- endBeat: number
- startColor: [number, number, number]
  [r, g, b] at start.
- endColor: [number, number, number]
  [r, g, b] at end.
- easing:
      | number
      | "linear"
      | "sineOut"
      | "sineIn"
      | "quadOut"
      | "quadIn"
      | "sineInOut"
      | "quadInOut"
      | "cubicOut"
      | "cubicIn"
      | "quartOut"
      | "quartIn"
      | "cubicInOut"
      | "quartInOut"
      | "quintOut"
      | "quintIn"
      | "expoOut"
      | "expoIn"
      | "circOut"
      | "circIn"
      | "backOut"
      | "backIn"
      | "circInOut"
      | "backInOut"
      | "elasticOut"
      | "elasticIn"
      | "bounceOut"
      | "bounceIn"
      | "bounceInOut" = 1
- options: EventOptions = {}
Returns this
- Defined in prototype.ts:726

text

text(
    startBeat: number,
    endBeat: number,
    startText: string,
    endText: string,
    easing?:
        | number
        | "linear"
        | "sineOut"
        | "sineIn"
        | "quadOut"
        | "quadIn"
        | "sineInOut"
        | "quadInOut"
        | "cubicOut"
        | "cubicIn"
        | "quartOut"
        | "quartIn"
        | "cubicInOut"
        | "quartInOut"
        | "quintOut"
        | "quintIn"
        | "expoOut"
        | "expoIn"
        | "circOut"
        | "circIn"
        | "backOut"
        | "backIn"
        | "circInOut"
        | "backInOut"
        | "elasticOut"
        | "elasticIn"
        | "bounceOut"
        | "bounceIn"
        | "bounceInOut",
    options?: EventOptions,
): this
Add a text event.
Parameters
- startBeat: number
- endBeat: number
- startText: string
- endText: string
- easing:
      | number
      | "linear"
      | "sineOut"
      | "sineIn"
      | "quadOut"
      | "quadIn"
      | "sineInOut"
      | "quadInOut"
      | "cubicOut"
      | "cubicIn"
      | "quartOut"
      | "quartIn"
      | "cubicInOut"
      | "quartInOut"
      | "quintOut"
      | "quintIn"
      | "expoOut"
      | "expoIn"
      | "circOut"
      | "circIn"
      | "backOut"
      | "backIn"
      | "circInOut"
      | "backInOut"
      | "elasticOut"
      | "elasticIn"
      | "bounceOut"
      | "bounceIn"
      | "bounceInOut" = 1
- options: EventOptions = {}
Returns this
- Defined in prototype.ts:739

gif

gif(
    startBeat: number,
    endBeat: number,
    startFrame: number,
    endFrame: number,
    easing?:
        | number
        | "linear"
        | "sineOut"
        | "sineIn"
        | "quadOut"
        | "quadIn"
        | "sineInOut"
        | "quadInOut"
        | "cubicOut"
        | "cubicIn"
        | "quartOut"
        | "quartIn"
        | "cubicInOut"
        | "quartInOut"
        | "quintOut"
        | "quintIn"
        | "expoOut"
        | "expoIn"
        | "circOut"
        | "circIn"
        | "backOut"
        | "backIn"
        | "circInOut"
        | "backInOut"
        | "elasticOut"
        | "elasticIn"
        | "bounceOut"
        | "bounceIn"
        | "bounceInOut",
    options?: GifEventOptions,
): this
Add a GIF frame event.
Parameters
- startBeat: number
- endBeat: number
- startFrame: number
- endFrame: number
- easing:
      | number
      | "linear"
      | "sineOut"
      | "sineIn"
      | "quadOut"
      | "quadIn"
      | "sineInOut"
      | "quadInOut"
      | "cubicOut"
      | "cubicIn"
      | "quartOut"
      | "quartIn"
      | "cubicInOut"
      | "quartInOut"
      | "quintOut"
      | "quintIn"
      | "expoOut"
      | "expoIn"
      | "circOut"
      | "circIn"
      | "backOut"
      | "backIn"
      | "circInOut"
      | "backInOut"
      | "elasticOut"
      | "elasticIn"
      | "bounceOut"
      | "bounceIn"
      | "bounceInOut" = 1
- options: GifEventOptions = {}
Returns this
- Defined in prototype.ts:752

setScaleOnNotes

setScaleOnNotes(value: 0 | 1 | 2): this
Set scaleOnNotes: 0 = off, 1 = scale x-only, 2 = scale x+y.
Parameters
- value: 0 | 1 | 2
Returns this
- Defined in prototype.ts:767

setAppearanceOnAttach

setAppearanceOnAttach(value: 0 | 1 | 2): this
Set appearanceOnAttach: 0 = always show, 1 = white colored, 2 = FC/AP colored.
Parameters
- value: 0 | 1 | 2
Returns this
- Defined in prototype.ts:773

setIntegrateSpeedEasings

setIntegrateSpeedEasings(value: boolean): this
Set whether speed event easings are integrated.
Parameters
- value: boolean
Returns this
- Defined in prototype.ts:779

setZIndex

setZIndex(z: number | undefined): this
Set the Z-index override (distinct from zOrder). Pass undefined to remove it.
Parameters
- z: number | undefined
Returns this
- Defined in prototype.ts:785

setAttachUI

setAttachUI(
    ui:
        | "pause"
        | "combonumber"
        | "combo"
        | "score"
        | "bar"
        | "name"
        | "level"
        | null
        | undefined,
): this
Set the attachUI element.
Parameters
- ui:
      | "pause"
      | "combonumber"
      | "combo"
      | "score"
      | "bar"
      | "name"
      | "level"
      | null
      | undefined
Returns this
- Defined in prototype.ts:791

setDefaultValue

setDefaultValue(channel: EventChannel, value: number, layerIndex?: number): this
Set the constant default value in the first event of the given channel on the specified event layer (default: layer 0).

If the layer or channel has no events yet, a constant event spanning beats 0→1 is created automatically. This is the preferred way to change the initial state of a line (e.g., starting position, opacity, speed) without adding a full timing event.
Parameters
- channel: EventChannel
  One of 'moveX', 'moveY', 'rotate', 'alpha', 'speed'.
- value: number
  The constant value to apply.
- layerIndex: number = 0
  Event layer index (default: 0).
Returns this
Example
```
line.setDefaultValue('moveX', -200); // line starts at X = -200
line.setDefaultValue('alpha', 0);    // line starts invisible
line.setDefaultValue('speed', 5);    // initial note speed = 5
```
- Defined in prototype.ts:818

setDefaultX

setDefaultX(value: number, layerIndex?: number): this
Set the default X position (first moveX event in layer 0).
Parameters
- value: number
- layerIndex: number = 0
Returns this
See
setDefaultValue
- Defined in prototype.ts:860

setDefaultY

setDefaultY(value: number, layerIndex?: number): this
Set the default Y position (first moveY event in layer 0).
Parameters
- value: number
- layerIndex: number = 0
Returns this
See
setDefaultValue
- Defined in prototype.ts:868

setDefaultRotation

setDefaultRotation(value: number, layerIndex?: number): this
Set the default rotation angle in degrees (first rotate event in layer 0).
Parameters
- value: number
- layerIndex: number = 0
Returns this
See
setDefaultValue
- Defined in prototype.ts:876

setDefaultAlpha

setDefaultAlpha(value: number, layerIndex?: number): this
Set the default alpha opacity 0–255 (first alpha event in layer 0).
Parameters
- value: number
- layerIndex: number = 0
Returns this
See
setDefaultValue
- Defined in prototype.ts:884

setDefaultSpeed

setDefaultSpeed(value: number, layerIndex?: number): this
Set the default note scroll speed (first speed event in layer 0).
Parameters
- value: number
- layerIndex: number = 0
Returns this
See
setDefaultValue
- Defined in prototype.ts:893

toChart

toChart(): ChartBuilder
Return a ChartBuilder wrapping the same chart (for switching back to chart-level operations).

Returns ChartBuilder
- Defined in prototype.ts:904

Class LineBuilder

Event methods

Note methods

Misc

Example

Index

Constructors

Properties

Accessors

Methods

Constructors

constructor

Parameters

Returns LineBuilder

Properties

Readonlychart

Readonlyindex

Accessors

data

Returns JudgeLine

noteCount

Returns number

Methods

setName

Parameters

Returns this

setTexture

Parameters

Returns this

setGroup

Parameters

Returns this

setZOrder

Parameters

Returns this

setCover

Parameters

Returns this

setBpmFactor

Parameters

Returns this

setParent

Parameters

Returns this

setRotateWithFather

Parameters

Returns this

setAnchor

Parameters

Returns this

addNote

Parameters

Returns this

addNotes

Parameters

Returns this

getNote

Parameters

Returns NoteBuilder

removeNote

Parameters

Returns Note | undefined

removeNotes

Parameters

Returns Note[]

clearNotes

Returns Note[]

noteIterator

Returns NoteIterator

addLayer

Returns EventLayerBuilder

getLayer

Parameters

Returns EventLayerBuilder

removeLayer

Parameters

Returns EventLayer | null | undefined

moveX

Parameters

Returns this

`Readonly`chart

`Readonly`index