Sound.Osc.Transport.Fd

An abstract transport layer with implementations for Udp and Tcp transport.

Documentation

class Transport t where

Abstract over the underlying transport protocol.

Methods

sendPacket :: t -> Packet -> IO ()

Encode and send an Osc packet.

recvPacket :: t -> IO Packet

Receive and decode an Osc packet.

close :: t -> IO ()

Close an existing connection.

Instances

Transport Tcp

Tcp is an instance of Transport.

Defined in Sound.Osc.Transport.Fd.Tcp

Methods

sendPacket :: Tcp -> Packet -> IO ()

recvPacket :: Tcp -> IO Packet

close :: Tcp -> IO ()

Transport Udp

Udp is an instance of Transport.

Defined in Sound.Osc.Transport.Fd.Udp

Methods

sendPacket :: Udp -> Packet -> IO ()

recvPacket :: Udp -> IO Packet

close :: Udp -> IO ()

withTransport :: Transport t => IO t -> (t -> IO a) -> IO a

Bracket Osc communication.

Send

sendMessage :: Transport t => t -> Message -> IO ()

sendPacket of Packet_Message.

sendBundle :: Transport t => t -> Bundle -> IO ()

sendPacket of Packet_Bundle.

Receive

recvBundle :: Transport t => t -> IO Bundle

Variant of recvPacket that runs packet_to_bundle.

recvMessage :: Transport t => t -> IO (Maybe Message)

Variant of recvPacket that runs packet_to_message.

recvMessages :: Transport t => t -> IO [Message]

Variant of recvPacket that runs packetMessages.

Wait

waitUntil :: Transport t => t -> (Packet -> Bool) -> IO Packet

Wait for a Packet where the supplied predicate is True, discarding intervening packets.

waitFor :: Transport t => t -> (Packet -> Maybe a) -> IO a

Wait for a Packet where the supplied function does not give Nothing, discarding intervening packets.

waitImmediate :: Transport t => t -> IO Packet

waitUntil packet_is_immediate.

waitMessage :: Transport t => t -> IO Message

waitFor packet_to_message, ie. an incoming Message or immediate mode Bundle with one element.

waitAddress :: Transport t => t -> Address_Pattern -> IO Packet

A waitFor for variant using packet_has_address to match on the Address_Pattern of incoming Packets.

waitReply :: Transport t => t -> Address_Pattern -> IO Message

Variant on waitAddress that returns matching Message.

waitDatum :: Transport t => t -> Address_Pattern -> IO [Datum]

Variant of waitReply that runs messageDatum.