alda.lisp.model.attribute — alda 1.0.0-rc50

*attribute-table* clj

apply-attribute clj

(apply-attribute {:keys [beats-tally] :as score} inst attr val)

Given an instrument map, a keyword representing an attribute, and a value, returns the updated instrument with that attribute update applied.

get-attr clj

(get-attr kw)

Given a keyword representing an attribute (which could be an alias, e.g. :quant for :quantization), returns the attribute map, which includes the attribute's keyword name (e.g. :quantization) and its transform function.

The transform function is a higher-order function which takes a new, user-friendly value (e.g. 100 instead of 1.0) and returns the function to apply to an instrument's existing value to update it to the new value. (See alda.lisp.attributes for examples of transform functions.)

Throws an exception if the argument supplied is not a valid keyword name or alias for an existing attribute.

get-kw-name clj

(get-kw-name attr)

Given an attr (e.g. :tempo), which could be an alias (e.g. :quant for :quantization), returns the correct keyword name of the attribute to which it refers.

Throws an exception if the argument supplied is not a valid keyword name or alias for an existing attribute.

get-val-fn clj

(get-val-fn attr val)

Given an attr (e.g. :tempo) and a user-friendly val (e.g. 100), returns the function to apply to an instrument's existing value to update it to the new value.

Throws an exception if the argument supplied is not a valid keyword name or alias for an existing attribute.

log-attribute-change clj

(log-attribute-change {:keys [id] :as inst} attr old-val new-val)

set-attribute clj

(set-attribute attr val)

Public fn for setting attributes in a score. e.g. (set-attribute :tempo 100)

set-attributes clj

(set-attributes & attrs)

Convenience fn for setting multiple attributes at once. e.g. (set-attributes :tempo 100 :volume 50)