musicMCT (version 0.3.0)

writeSCL: Create a Scala tuning file from a given scale

Description

You mean you don't want to play around in R forever? This function lets you export any scale you've defined in R as a .scl tuning file for use in Scala or by any synth that can read .scl files. Will write to your working directory.

In addition to saving the necessary tuning data, the function will attempt to add as comments extra information that can be derived from MCT functions, like the color number, degrees of freedom, number of sign-vector zeroes, etc.

Usage

writeSCL(x, path, filename, period = 2, ineqmat = NULL, edo = 12, rounder = 10)

Value

Invisible NULL

Arguments

x

Numeric vector: the scale to export

path

String specifying path where Scala file should be saved. No default and cannot be missing.

filename

String (in quotation marks): what to name your Scala file. Defaults to using the name of x as the file name if you enter nothing.

period

The frequency ratio at which your scale repeats; defaults to 2 which indicates an octave-repeating scale.

ineqmat

Specifies which hyperplane arrangement to consider. By default (or by explicitly entering "mct") it supplies the standard "Modal Color Theory" arrangements of getineqmat(), but can be set to strings "white," "black", "gray", "roth", "infrared", "pastel", "rosy", "infrared", or "anaglyph", giving the ineqmats of make_white_ineqmat(), make_black_ineqmat(), make_gray_ineqmat(), make_roth_ineqmat(), make_infrared_ineqmat(), make_pastel_ineqmat(), make_rosy_ineqmat(), make_infrared_ineqmat(), or make_anaglyph_ineqmat(). For other arrangements, this parameter accepts explicit matrices.

edo

Number of unit steps in an octave. Defaults to 12.

rounder

Numeric (expected integer), defaults to 10: number of decimal places to round to when testing for equality.

Examples

neat_pentachord <- convert(c(0, 1, 4, 9, 11), 15, 12)
# \donttest{
writeSCL(neat_pentachord, path=tempdir(), "neat_pentachord.scl")
# }