SV

Number of blicks in a quarter. The value is 705600000.

We denote musical time (e.g. a quarter, a beat) differently from physical time (e.g. one second). A blick is the smallest unit of musical time that the GUI works with internally. It is a large number chosen to be divisible by a lot of similarly purposed numbers used in music software. The name originates from Flicks.

Check whether the key (passed in as a MIDI number) is a black key on a piano.

Conversions between musical and physical time in the context of a project are done by TimeAxis.

Convert b from number of blicks into number of quarters.

Equivalent to b / SV.QUARTER.

Conversions between musical and physical time in the context of a project are done by TimeAxis.

Convert b from blicks into seconds with the specified beats per minute bpm.

Equivalent to b / SV.QUARTER * 60 / bpm.

Conversions between musical and physical time in the context of a project are done by TimeAxis.

Rounded division of dividend (blicks) over divisor (blicks).

Conversions between musical and physical time in the context of a project are done by TimeAxis.

Returns the closest multiple of interval (blicks) from b (blick).

Equivalent to blickRoundDiv(b, interval) * interval.

Conversions between musical and physical time in the context of a project are done by TimeAxis.

Create a new object. type can be one of the following type-specifying strings.

type	Description
"Note"	A note defined by pitch, lyrics, onset, duration, etc.
"Automation"	A set of points controlling a particular parameter type (e.g. Pitch Deviation) inside a NoteGroup.
"NoteGroup"	A set of notes and parameters grouped together for convenient reuse.
"NoteGroupReference"	A reference to a NoteGroup with optional time and pitch offset and voice/database properties.
"TrackMixer"	A set of attributes describing the mixer states of a track (e.g. gain, pan, mute, solo).
"Track"	A collection of NoteGroupReference.
"TimeAxis"	A project-wide object storing tempo and time signature marks; handles the conversion between physical time and musical time.
"Project"	The largest object to be worked with. Contains Track, TimeAxis, NoteGroup, etc.

Mark the finish of a script. All subsequent async callbacks will not be executed. Note that this does not cause the current script to exit immediately.

Convert a frequency in Hz to a MIDI number (semitones, where C4 is 60).

Conversions between musical and physical time in the context of a project are done by TimeAxis.

Get the UI state object for arrangement view.

Get the text on the system clipboard.

Get an object with the following properties.

• osType: string taking one of "Windows", "macOS", "Linux", "Unknown"
• osName: string the full name of the operating system
• hostName: string "Synthesizer V Studio Pro" or "Synthesizer V Studio Basic"
• hostVersion: string the version string of Synthesizer V Studio e.g. "1.0.4"
• hostVersionNumber: number the version number defined as taking major, minor and revision as 2-digit hexadecimals (e.g. 0x010004 for "1.0.4")
• languageCode: string language code for the UI, e.g. "en-us", "ja-jp", "zh-cn"

Get the UI state object for the piano roll.

Get the phonemes for all notes in a group (passed in as a group reference). The group must be part of the currently open project.

Note that getPhonemesForGroup returns the output of Synthesizer V Studio's internal text-to-phoneme converter. That means even for notes with no user-specified phonemes, getPhonemesForGroup will return the default pronunciation, whereas Note#getPhonemes will return an empty string.

Also note that the text-to-phoneme converter runs on a different thread. getPhonemesForGroup does not block the current thread. There's a slight chance of returning an empty array if text-to-phoneme conversion has not yet finished on the group. We recommend script authors to wrap getPhonemesForGroup in a SV#setTimeout call in such cases.

Get the UI state object for controlling the playback.

Get the currently open project.

Convert a MIDI number (semitones, where C4 is 60) to a frequency in Hz.

Conversions between musical and physical time in the context of a project are done by TimeAxis.

Convert q from number of quarters into number of blick.

Equivalent to q * SV.QUARTER.

Conversions between musical and physical time in the context of a project are done by TimeAxis.

Convert s from seconds into blicks with the specified beats per minute bpm.

Equivalent to s / 60 * bpm * SV.QUARTER.

Conversions between musical and physical time in the context of a project are done by TimeAxis.

Set the system clipboard.

Schedule a delayed call to callback after timeOut milliseconds.

After calling setTimeout, the script will continue instead of immediately executing callback. The callback function is pushed onto a queue and delayed. This is not a preemptive callback, i.e. the execution of callback will not interrupt the currently running task.

The synchronous version of SV#showCustomDialogAsync that blocks the script execution until the user closes the dialog. It returns the inputs (the completed form) from the user.

Display a custom dialog defined in form, without blocking the script execution.

callback will be invoked once the dialog is closed. The callback function takes one argument which contains the results.

See Custom Dialogs for more information.

The synchronous version of SV#showInputBoxAsync that blocks the script execution until the user closes the dialog. It returns the text input from the user.

Display a dialog with a text box and an "OK" button, without blocking the script execution.

callback will be invoked once the dialog is closed. The callback function takes one string argument that is the content of the text box.

The synchronous version of SV#showMessageBoxAsync that blocks the script execution until the user closes the message box.

Cause a message box to pop up without blocking the script execution.

If a callback is given, it is invoked once the message box is closed. The callback function takes no argument.

The synchronous version of SV#showOkCancelBoxAsync that blocks the script execution until the user closes the message box. It returns true if "OK" button is pressed.

Display a message box with an "OK" button and a "Cancel" button, without blocking the script execution.

callback will be invoked once the message box is closed. The callback function takes one boolean argument that is true if "OK" button is pressed.

The synchronous version of SV#showYesNoCancelBoxAsync that blocks the script execution until the user closes the message box. It returns "yes", "no" or "cancel".

Display a message box with a "Yes" button, an "No" button and a "Cancel" button, without blocking the script execution.

callback will be invoked once the message box is closed. The callback function takes one string argument that can be "yes", "no" or "cancel".

Get a localized version of text based on the current UI language settings.

See Localization for more information.