66 lines
2.2 KiB
TypeScript
66 lines
2.2 KiB
TypeScript
import { type Editor } from "../main";
|
|
import { makeExampleFactory } from "../Documentation";
|
|
|
|
export const functions = (application: Editor): string => {
|
|
const makeExample = makeExampleFactory(application);
|
|
return `
|
|
# Functions
|
|
|
|
## Scripts
|
|
|
|
You can control scripts programatically. This is the core concept of Topos after all!
|
|
|
|
- <ic>script(...number: number[])</ic>: call one or more scripts (_e.g. <ic>script(1,2,3,4)</ic>). Once called, scripts will be evaluated once. There are nine local scripts by default. You cannot call the global script nor the initialisation script.
|
|
- <ic>clear_script(number)</ic>: deletes the given script.
|
|
- <ic>copy_script(from: number, to: number)</ic>: copies a local script denoted by its number to another local script. **This is a destructive operation!**
|
|
|
|
${makeExample(
|
|
"Calling a script! The most important feature!",
|
|
`
|
|
beat(1) :: script(1)
|
|
`,
|
|
true,
|
|
)}
|
|
|
|
${makeExample(
|
|
"Calling mutliple scripts at the same time.",
|
|
`
|
|
beat(1) :: script(1, 3, 5)
|
|
`,
|
|
false,
|
|
)}
|
|
|
|
## Math functions
|
|
|
|
- <ic>max(...values: number[]): number</ic>: returns the maximum value of a list of numbers.
|
|
- <ic>min(...values: number[]): number</ic>: returns the minimum value of a list of numbers.
|
|
- <ic>mean(...values: number[]): number</ic>: returns the arithmetic mean of a list of numbers.
|
|
- <ic>limit(value: number, min: number, max: number): number</ic>: Limits a value between a minimum and a maximum.
|
|
|
|
## Delay functions
|
|
|
|
- <ic>delay(ms: number, func: Function): void</ic>: Delays the execution of a function by a given number of milliseconds.
|
|
|
|
${makeExample(
|
|
"Phased woodblocks",
|
|
`
|
|
// Some very low-budget version of phase music
|
|
beat(.5) :: delay(usine(.125) * 80, () => sound('east').out())
|
|
beat(.5) :: delay(50, () => sound('east').out())
|
|
`,
|
|
true,
|
|
)}
|
|
|
|
- <ic>delayr(ms: number, nb: number, func: Function): void</ic>: Delays the execution of a function by a given number of milliseconds, repeated a given number of times.
|
|
|
|
${makeExample(
|
|
"Another woodblock texture",
|
|
`
|
|
beat(1) :: delayr(50, 4, () => sound('east').speed([0.5,.25].beat()).out())
|
|
flip(2) :: beat(2) :: delayr(150, 4, () => sound('east').speed([0.5,.25].beat() * 4).out())
|
|
`,
|
|
true,
|
|
)};
|
|
`;
|
|
};
|