|
9
|
1 |
/** |
|
0
|
2 |
* @author cramakrishnan |
|
|
3 |
* |
|
|
4 |
* Copyright (C) 2003, C. Ramakrishnan / Illposed Software |
|
|
5 |
* All rights reserved. |
|
|
6 |
* |
|
|
7 |
* See license.txt (or license.rtf) for license information. |
|
|
8 |
* |
|
|
9 |
* |
|
|
10 |
* An simple (non-bundle) OSC message. An OSC message is made up of |
|
|
11 |
* an address (who is this message sent to) |
|
|
12 |
* and arguments (what is the contents of this message). |
|
|
13 |
*/ |
|
|
14 |
|
|
|
15 |
package com.illposed.osc; |
|
|
16 |
|
|
|
17 |
import java.util.Enumeration; |
|
|
18 |
import java.util.Vector; |
|
|
19 |
|
|
|
20 |
import com.illposed.osc.utility.*; |
|
|
21 |
|
|
|
22 |
public class OSCMessage extends OSCPacket { |
|
|
23 |
|
|
9
|
24 |
protected String address; |
|
|
25 |
protected Vector<Object> arguments; |
|
0
|
26 |
|
|
9
|
27 |
/** |
|
|
28 |
* Create an empty OSC Message |
|
|
29 |
* In order to send this osc message, you need to set the address |
|
|
30 |
* and, perhaps, some arguments. |
|
|
31 |
*/ |
|
|
32 |
public OSCMessage() { |
|
|
33 |
super(); |
|
|
34 |
arguments = new Vector<Object>(); |
|
|
35 |
} |
|
0
|
36 |
|
|
9
|
37 |
/** |
|
|
38 |
* Create an OSCMessage with an address already initialized |
|
|
39 |
* @param newAddress The recepient of this OSC message |
|
|
40 |
*/ |
|
|
41 |
public OSCMessage(String newAddress) { |
|
|
42 |
this(newAddress, null); |
|
|
43 |
} |
|
0
|
44 |
|
|
9
|
45 |
/** |
|
|
46 |
* Create an OSCMessage with an address and arguments already initialized |
|
|
47 |
* @param newAddress The recepient of this OSC message |
|
|
48 |
* @param newArguments The data sent to the receiver |
|
|
49 |
*/ |
|
|
50 |
public OSCMessage(String newAddress, Object[] newArguments) { |
|
|
51 |
super(); |
|
|
52 |
address = newAddress; |
|
|
53 |
if (null != newArguments) { |
|
|
54 |
arguments = new Vector<Object>(newArguments.length); |
|
|
55 |
for (int i = 0; i < newArguments.length; i++) { |
|
|
56 |
arguments.add(newArguments[i]); |
|
|
57 |
} |
|
|
58 |
} else |
|
|
59 |
arguments = new Vector<Object>(); |
|
|
60 |
init(); |
|
|
61 |
} |
|
|
62 |
|
|
|
63 |
/** |
|
|
64 |
* @return the address of this OSC Message |
|
|
65 |
*/ |
|
|
66 |
public String getAddress() { |
|
|
67 |
return address; |
|
|
68 |
} |
|
|
69 |
|
|
|
70 |
/** |
|
|
71 |
* Set the address of this messsage |
|
|
72 |
* @param anAddress |
|
|
73 |
*/ |
|
|
74 |
public void setAddress(String anAddress) { |
|
|
75 |
address = anAddress; |
|
|
76 |
} |
|
|
77 |
|
|
|
78 |
public void addArgument(Object argument) { |
|
|
79 |
arguments.add(argument); |
|
|
80 |
} |
|
|
81 |
|
|
|
82 |
public Object[] getArguments() { |
|
|
83 |
return arguments.toArray(); |
|
|
84 |
} |
|
0
|
85 |
|
|
9
|
86 |
/** |
|
|
87 |
* @param stream OscPacketByteArrayConverter |
|
|
88 |
*/ |
|
|
89 |
protected void computeAddressByteArray(OSCJavaToByteArrayConverter stream) { |
|
|
90 |
stream.write(address); |
|
|
91 |
} |
|
0
|
92 |
|
|
9
|
93 |
/** |
|
|
94 |
* @param stream OscPacketByteArrayConverter |
|
|
95 |
*/ |
|
|
96 |
protected void computeArgumentsByteArray(OSCJavaToByteArrayConverter stream) { |
|
|
97 |
// SC starting at version 2.2.10 wants a comma at the beginning |
|
|
98 |
// of the arguments array. |
|
|
99 |
stream.write(','); |
|
|
100 |
if (null == arguments) |
|
|
101 |
return; |
|
|
102 |
stream.writeTypes(arguments); |
|
|
103 |
Enumeration enm = arguments.elements(); |
|
|
104 |
while (enm.hasMoreElements()) { |
|
|
105 |
stream.write(enm.nextElement()); |
|
|
106 |
} |
|
|
107 |
} |
|
0
|
108 |
|
|
9
|
109 |
/** |
|
|
110 |
* @param stream OscPacketByteArrayConverter |
|
|
111 |
*/ |
|
|
112 |
protected void computeByteArray(OSCJavaToByteArrayConverter stream) { |
|
|
113 |
computeAddressByteArray(stream); |
|
|
114 |
computeArgumentsByteArray(stream); |
|
|
115 |
byteArray = stream.toByteArray(); |
|
|
116 |
} |
|
0
|
117 |
|
|
|
118 |
} |