Sound.Osc.Datum

Type enumerating Datum categories.

Type for Ascii strings (strict Char8 ByteString)

Type-specialised pack.

Type-specialised unpack.

Type for Word8 arrays, these are stored with an Int32 length prefix.

Type-specialised pack.

Type-specialised unpack.

Type-specialised unpack.

Four-byte midi message: port-id, status-byte, data, data.

Type-specialised unpack.

A real-valued time stamp. For Osc proper this is an Ntp64 time in real-valued (fractional) form. For SuperCollider Nrt programs this is elapsed time since the start of the score. This is the primary form of timestamp used by hosc.

The basic elements of Osc messages.

List of required data types (tag, name).

List of optional data types (tag,name).

List of all data types (tag,name).

Lookup name of type.

Erroring variant.

Single character identifier of an Osc datum.

Type and name of Datum.

Datum as Integral if Int32 or Int64.

let d = [Int32 5,Int64 5,Float 5.5,Double 5.5]
map datum_integral d == [Just (5::Int),Just 5,Nothing,Nothing]

Datum as Floating if Int32, Int64, Float, Double or TimeStamp.

let d = [Int32 5,Int64 5,Float 5,Double 5,TimeStamp 5]
mapMaybe datum_floating d == replicate 5 (5::Double)

Type generalised Int32.

int32 (1::Int32) == int32 (1::Integer)
d_int32 (int32 (maxBound::Int32)) == maxBound
int32 (((2::Int) ^ (64::Int))::Int) == Int32 0

Type generalised Int64.

int64 (1::Int32) == int64 (1::Integer)
d_int64 (int64 (maxBound::Int64)) == maxBound

Type generalised Float.

float (1::Int) == float (1::Double)
floatRange (undefined::Float) == (-125,128)
isInfinite (d_float (float (encodeFloat 1 256 :: Double))) == True

Type generalised Double.

double (1::Int) == double (1::Double)
double (encodeFloat 1 256 :: Double) == Double 1.157920892373162e77

AsciiString of pack.

string "string" == AsciiString (ByteString.Char8.pack "string")

Four-tuple variant of Midi . MidiData.

midi (0,0,0,0) == Midi (MidiData 0 0 0 0)

Blob of blob_pack.

Message argument types are given by a signature.

signatureFor [Int32 1,Float 1,string "1"] == ",ifs"

The descriptor is an Ascii encoded signature.

descriptor [Int32 1,Float 1,string "1"] == ascii ",ifs"

Descriptor tags are comma prefixed.