patterncommands

Documentation

Index

• Variables
• func Euclid(params []string, helper Helper) (res []*items.Event, err error)
• func From(params []string, helper Helper) (res []*items.Event, err error)
• func Merge(params []string, helper Helper) (res []*items.Event, err error)
• func Mirror(params []string, helper Helper) (res []*items.Event, err error)
• func Negative(params []string, helper Helper) (res []*items.Event, err error)
• func Rabbit(params []string, helper Helper) (res []*items.Event, err error)
• func Reverse(params []string, helper Helper) (res []*items.Event, err error)
• func Slice(params []string, helper Helper) (res []*items.Event, err error)
• func Until(params []string, helper Helper) (res []*items.Event, err error)
• type Command
• type Helper

Variables

var Commands = map[string]Command{
	"reverse":  Reverse,
	"euclid":   Euclid,
	"merge":    Merge,
	"rabbit":   Rabbit,
	"mirror":   Mirror,
	"negative": Negative,
	"slice":    Slice,
	"from":     From,
	"until":    Until,
}

Functions

func Euclid

func Euclid(params []string, helper Helper) (res []*items.Event, err error)

$euclid(numTotal,numExposed,duration) generates a pattern of numTotal placeholders, where numExposed placeholders are #2 and the others #1. The distance between each placeholder is duration (in fraction of 4 beats, e.g. 0.25 would be a beat

func From

func From(params []string, helper Helper) (res []*items.Event, err error)

$from(=patt1,from) returns the tail of a pattern, starting at from

func Merge

func Merge(params []string, helper Helper) (res []*items.Event, err error)

$merge(=patt1,=patt2,...) merges the given patterns

func Mirror

func Mirror(params []string, helper Helper) (res []*items.Event, err error)

$mirror(=patt,zeroNote) mirrors the given pattern at zeroNote axis

func Negative

func Negative(params []string, helper Helper) (res []*items.Event, err error)

negative harmony This concept is derived, from the Theory of Harmony by Swiss composer Ernst Levy (1895 – 1981). $negative(=patt,mirrorNote)

func Rabbit

func Rabbit(params []string, helper Helper) (res []*items.Event, err error)

$rabbit(=patt,startNote,factor,percentage,num) by the formula x(n+1) = x(0)*factor * (1-p) where p is the percentage as decimal e.g. $rabbit(=patt,c#',2.5,80%,10) rabbit generates num notes starting by startNote growing by factor, limited by percentage simulating a rabbit population growth. The generated notes are passed to patt as parameters maybe it should be changed to generate a chord of number items that would than be passed as parameter to a pattern, e.g. =patt($rabbit(c#',2.5,80%,10)...)

func Reverse

func Reverse(params []string, helper Helper) (res []*items.Event, err error)

$revers(=patt) reverses the events in the given pattern

func Slice

func Slice(params []string, helper Helper) (res []*items.Event, err error)

$slice(=patt1,from,to) slices the given pattern

func Until

func Until(params []string, helper Helper) (res []*items.Event, err error)

$until(=patt1,to) returns the head of a pattern until to position

Types

type Command

type Command func(params []string, helper Helper) ([]*items.Event, error)

Command is a command that receives different arguments (there might be pattern names within) and returns events we provide different functions to the PatternCMD

type Helper

type Helper interface {
	GetCallEvents(endPos uint, callDef string, params ...string) ([]*items.Event, error)
	GetPipeEvents() ([]*items.Event, error)
	GetSketchDefEvents(sketchDef [][2]string) ([]*items.Event, error)
}