Hidden Regions & NoteType Mult are two sets of functions that allow for manipulating notes.
Hidden Regions specify parts of the chart to not draw. If a hold head is in the segment, the entire hold will not draw.
Can be cleared with clear_hidden_regions or ClearHiddenRegions and also takes an optional parameter for column.
The input is a table of tables. Each inner table follows the same format. At least one inner table is required.
Note that col is optional and 1-indexed, and affects all columns if not provided.
{
{start_beat, end_beat, [col]},
{start_beat, end_beat, [col]},
...
}
local P1 = SCREENMAN:GetTopScreen():GetChild('PlayerP1')
local P2 = SCREENMAN:GetTopScreen():GetChild('PlayerP2')
if P1 then
P1:GetChild('NoteField'):add_hidden_regions{
{12, 24},
{32, 64, 1}, -- Hide the notes in the 1st and 3rd column
{32, 64, 3},
}
end
if P2 then
P2:GetChild('NoteField'):AddHiddenRegions{ -- Also has CamelCase function name
{0, 12},
{24, 32},
{32, 64, 2},
{32, 64, 4},
}
end
NoteType Multipliers allow one to affect the note quantization throughout a chart.
Can be cleared with clear_note_type_mults or ClearNoteTypeMults.
Like Hidden Regions, this also uses a table of tables as its' input. At least one table with an entry for beat 0 is required for the first call to add_note_type_mults/AddNoteTypeMults. This affects all columns in the NoteField. Negative beats are not allowed for input.
{
{start_beat, multiplier},
{start_beat, multiplier},
...
}
local P1 = SCREENMAN:GetTopScreen():GetChild('PlayerP1')
if P1 then
P1:GetChild('NoteField'):add_note_type_mults{
{0, 0.5}, -- beat 0 to 33 will look like a chart at half the BPM
{33, 0}, -- beat 33 to 64.5 will look like they're all at beat 16.5
{64.5, 1}, -- Everything onwards will now flow normally as if they're from beat 16.5 onwards.
}
end