Module: OSC::Packet

Defined in:

lib/osc.rb

Overview

Unit of transmission. Really needs revamping

Class Method Summary

• .decode(packet) ⇒ Object

  Takes a string containing one packet.

• .encode(o) ⇒ Object
• .pad(s) ⇒ Object
• .tag(o) ⇒ Object

Class Method Details

.decode(packet) ⇒ Object

Takes a string containing one packet

# File 'lib/osc.rb', line 239

def self.decode(packet)
  # XXX I think it would have been better to use a StringScanner. Maybe I
  # will convert it someday...
  io = StringIO.new(packet)
  id = decode_string(io)
  if id == '#bundle'
    b = Bundle.new(decode_timetag(io))
    until io.eof?
      l = io.read(4).unpack('N')[0]
      s = io.read(l)
      b << decode(s)
    end
    b
  elsif id =~ /^\//
	m = Message.new(id)
	if io.getc == ?,
	  tags = decode_string(io)
	  tags.scan(/./) do |t|
 case t
 when 'i'
   m << decode_int32(io)
 when 'f'
   m << decode_float32(io)
 when 's'
   m << decode_string(io)
 when 'b'
   m << decode_blob(io)

 # right now we skip over nonstandard datatypes, but we'll want to
 # add these datatypes too.
 when /[htd]/; io.read(8)
 when 'S'; decode_string(io)
 when /[crm]/; io.read(4)
 when /[TFNI\[\]]/;
 end
	  end
	end
	m
  end
end

.encode(o) ⇒ Object

# File 'lib/osc.rb', line 295

def self.encode(o)
  case o
  when Fixnum;  [o].pack 'N'
  when Float;   [o].pack 'g'
  when Blob;    pad([o.size].pack('N') + o)
  when String;  pad(o.sub(/\000.*\Z/, '') + "\000")
  when TimeTag; o.to_a.pack('NN')

  when Message
	s = encode(o.address)
	s << encode(','+o.types)
	s << o.args.collect{|x| encode(x)}.join

  when Bundle
	s = encode('#bundle')
	s << encode(o.timetag)
	s << o.args.collect { |x| 
	  x2 = encode(x); [x2.size].pack('N') + x2 
	}.join
  end
end

.pad(s) ⇒ Object

# File 'lib/osc.rb', line 280

def self.pad(s)
  s + ("\000" * ((4 - s.size)%4))
end

.tag(o) ⇒ Object

# File 'lib/osc.rb', line 284

def self.tag(o)
  case o
  when Fixnum;  'i'
  when TimeTag; 't'
  when Float;   'f'
  when Blob;    'b'
  when String;  's'
  else;         nil
  end
end