Skip to content

@liminal-hq/undertone / Fraction

Class: Fraction ​

Defined in: fraction.ts:18

An immutable rational number (numerator/denominator, always in lowest terms, denominator always positive). Pattern time is measured in cycles as Fractions so that subdivisions like triplets stay exact across arbitrarily many cycles.

Constructors ​

Constructor ​

new Fraction(numerator, denominator?): Fraction

Defined in: fraction.ts:22

Parameters ​

numerator ​

number

denominator? ​

number = 1

Returns ​

Fraction

Properties ​

d ​

readonly d: number

Defined in: fraction.ts:20


n ​

readonly n: number

Defined in: fraction.ts:19

Methods ​

add() ​

add(other): Fraction

Defined in: fraction.ts:63

Parameters ​

other ​

Fraction

Returns ​

Fraction


cmp() ​

cmp(other): number

Defined in: fraction.ts:83

Negative, zero, or positive as this is less than, equal to, or greater than other.

Parameters ​

other ​

Fraction

Returns ​

number


cyclePos() ​

cyclePos(): Fraction

Defined in: fraction.ts:131

Position within the current cycle, in [0, 1).

Returns ​

Fraction


div() ​

div(other): Fraction

Defined in: fraction.ts:75

Parameters ​

other ​

Fraction

Returns ​

Fraction


eq() ​

eq(other): boolean

Defined in: fraction.ts:87

Parameters ​

other ​

Fraction

Returns ​

boolean


floor() ​

floor(): number

Defined in: fraction.ts:116

The largest integer <= this value (rounds towards negative infinity).

Returns ​

number


gt() ​

gt(other): boolean

Defined in: fraction.ts:99

Parameters ​

other ​

Fraction

Returns ​

boolean


gte() ​

gte(other): boolean

Defined in: fraction.ts:103

Parameters ​

other ​

Fraction

Returns ​

boolean


lt() ​

lt(other): boolean

Defined in: fraction.ts:91

Parameters ​

other ​

Fraction

Returns ​

boolean


lte() ​

lte(other): boolean

Defined in: fraction.ts:95

Parameters ​

other ​

Fraction

Returns ​

boolean


max() ​

max(other): Fraction

Defined in: fraction.ts:111

Parameters ​

other ​

Fraction

Returns ​

Fraction


min() ​

min(other): Fraction

Defined in: fraction.ts:107

Parameters ​

other ​

Fraction

Returns ​

Fraction


mul() ​

mul(other): Fraction

Defined in: fraction.ts:71

Parameters ​

other ​

Fraction

Returns ​

Fraction


nextSam() ​

nextSam(): Fraction

Defined in: fraction.ts:126

The start of the next cycle.

Returns ​

Fraction


sam() ​

sam(): Fraction

Defined in: fraction.ts:121

The start of the cycle this time falls in ("sam" in Tidal terminology).

Returns ​

Fraction


sub() ​

sub(other): Fraction

Defined in: fraction.ts:67

Parameters ​

other ​

Fraction

Returns ​

Fraction


toNumber() ​

toNumber(): number

Defined in: fraction.ts:135

Returns ​

number


toString() ​

toString(): string

Defined in: fraction.ts:139

Returns ​

string


from() ​

static from(value): Fraction

Defined in: fraction.ts:39

Converts a number (integer or decimal like 1.5) or existing Fraction to a Fraction.

Parameters ​

value ​

number | Fraction

Returns ​

Fraction