Skip to content

oscinitm

Start a multicast listening process to a particular port, which can be used by osclisten.

📝 Note

Up to Csound 6, this opcode was called OSCinitM.

Plugin opcode in osc.

Syntax

ihandle = oscinitm(Sgroup, iport)

ihandle OSCinitM Sgroup, iport

Initialization

Sgroup -- string giving the IP address of the multicast group.

ihandle -- handle returned that can be passed to any number of osclisten opcodes to receive messages on this port.

iport -- the port on which to listen.

Performance

The listener runs in the background. See osclisten for details.

Examples

The example shows a pair of floating point numbers being received on port 7770.

sr = 44100
ksmps = 100
nchnls = 2

handle@global:i = oscinitm("225.0.0.1", 7770)

instr 1
  f1:k = init(0)
  f2:k = init(0)
nxtmsg:
  kk = osclisten(handle, "/foo/bar", "ff", f1, f2)
  if (kk == 0) goto ex
    printk(0, f1)
    printk(0, f2)
    kgoto(nxtmsg)
ex:
  endin

See also

OSC (Open Sound Control)

More information on this opcode: http://www.youtube.com/watch?v=JX1C3TqP_9Y, made by Andrés Cabrera

Credits

Author: John ffitch
2016