Only process notes whose start beat is in [start, end).
Only process notes whose start beat is strictly before beat.
Only process notes whose start beat is strictly after beat.
Only process notes at approximately beat (within epsilon).
Only process notes of the given type(s).
One or more NoteType values (1=Tap, 2=Hold, 3=Flick, 4=Drag).
Shorthand: only Tap notes.
Shorthand: only Hold notes.
Shorthand: only Flick notes.
Shorthand: only Drag notes.
Control whether fake notes are included (default: true).
Exclude fake notes from processing.
Only process notes whose positionX is in [minX, maxX].
Only process notes on lines matching a predicate.
Only process notes on the given line indices.
Only process notes on lines whose name matches nameOrPattern.
Accepts a string (exact match) or a RegExp.
Only process notes whose above value equals side (1 = above, 2 = below).
Only process notes whose speed satisfies the predicate.
Set the speed of all matched notes.
Scale the speed of all matched notes by a factor.
Set the positionX of all matched notes.
Translate notes along X by dx.
Mirror notes horizontally (flip positionX sign).
Set the alpha of all matched notes (0–255).
Set the size of all matched notes.
Scale the size of all matched notes by a factor.
Set the yOffset of all matched notes.
Set the isFake flag on all matched notes.
Set the visible time for all matched notes.
Set a tint color [r, g, b] on all matched notes.
Set a hit effect tint [r, g, b] on all matched notes.
Assign a hitsound to all matched notes.
Set judgeArea on all matched notes.
Set the above side (1 = above, 2 = below) on all matched notes.
Offset the start (and optionally end) beat of all matched notes by
beatOffset.
Apply a user-supplied callback to each note's index within its line. Useful for stagger, sequential effects, etc.
The callback receives (note, line, chart, noteIndex, lineIndex, globalIndex).
Run the iterator over all notes in the provided chart.
The number of notes that were processed.
Run the iterator over a provided array of notes (without chart context).
line and chart context will be null casts — prefer run when
a chart is available.
The number of notes that were processed.
Delete all notes that match the current conditions from the chart. Process functions are NOT called — only conditions are evaluated.
The number of notes deleted.
Fluent iterator that filters and transforms notes in an RPE chart.
Conditions (filters) are AND-ed together. All registered process functions are run on every note that passes all conditions.
Call
.run(chart)to execute. Call.collect(chart)to get an array of matching notes without mutating them.Filter methods
.between(),.before(),.after(),.approximately(),.onlyType(),.onlyTaps(),.onlyHolds(),.onlyFlicks(),.onlyDrags(),.realOnly(),.filterFake(),.betweenX(),.onLines(),.onLineIndices(),.onLineNamed(),.onSide(),.withSpeed()Mutation methods
.setSpeed(),.scaleSpeed(),.setX(),.moveX(),.mirrorX(),.setAlpha(),.setSize(),.scaleSize(),.setYOffset(),.setFake(),.setVisibleTime(),.setTint()Example