aboutsummaryrefslogtreecommitdiff
path: root/README.txt
blob: 55fc0ae8ce2ed9df51e3da7e2e855e1d56a2607b (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
OSC, OpenSoundControl for pd
============================
for more information on OSC see: http://cnmat.cnmat.berkeley.edu/OSC

for more information on pure-data: http://lena.ucsd.edu/~msp/ and http://www.google.com/search?q=pure-data

log:

	20050830: v0.3: (piotr@majdak.com)
						adapted to compile on Windows2000
						dumpOSC routes up to 128 branches (tested with 24)
						sendOSC doesn't crash on longer messages (tested with one argument of 120 characters)
						sendOSC # of arguments limited by the length of the message (tested with 110 messages)
	          tested on Windows 2000 ONLY!

  20040409: changed build setup to suit externals build system
            single object objects, no lib

  20030531: added OSCroute /* (route everything) hard-fix

  20030527: added sending to broadcast address capability to htmsocket

  20020908: 0.16-4:
  	    added non-match / unmatched outlet to OSCroute
  	    updated doc/OSCroute-help.pd including a new chapter
	    about patternmatching.

  20020901: ca., refixed MAXPDARG vs. MAX_ARGS, causing crash when sending
            messages with more than 4 arguments

  20020417: 0.16-2:
            more changes by raf + jdl (send with no argument fix, send / fix,
            ...)

  20020416: added bundle stuff to sendOSC

  200204: 0.15b1:
          windowified version and implied linux enhancements
          by raf@interaccess.com
	  for now get it at http://207.208.254.239/pd/win32_osc_02.zip
	  most importantly: enhanced connect->disconnect-connect behaviour
          (the win modifications to libOSC are still missing in _this_
	   package but coming ..)


  200203: 0-0.1b1: all the rest
	  ost_at_test.at + i22_at_test.at, 2000-2002
      	  modified to compile as pd externel




INSTALL:
 (linux)

tar zxvf OSCx.tgz
cd OSCx
cat README
cd libOSC && make
cd ../OSC && "adjust makefile" && make OSC && make install
cd ../..
pd -lib OSC OSCx/doc/OSC-help.pd

 PITFALLS:
make sure you compile libOSC before OSC objects
maybe adjust include path so pd include files will be found


 (windo$)

unzip and put .dll file in a pd-searched folder.


TYPETAGS:
supported and on by default. can be swtiched off with the "typetags 0"
message and on with 1.


TODO
====
-timetags: output timetag when receiving a bundle for scheduling
-TCP mode
-address space integration with pd patch/subpatch/receive hierarchy ?

-pd object hierarchy extract and automatic address construction
 a la [/hostname]/pd/patchname/subpatch/test ?

-dynamic space allocation for message buffers.


changelog:

20020903: refixed MAXPDARG vs. MAX_ARGS bug causind sendOSC to crash
          with msgs longer than 5 argmuents. ?

20020305: -typetags in send and receive
           sendOSC by default now send typetagged msgs
	   and dumOSC properly reads and outputs them.
	   
prior:

      -added OSCroute with source adapt from max object.
      -fixed shared htmsock bug
      -added sendtyped separately earlier and lost it again
	  
   

--
jdl at xdv.org
http://barely.a.live.fm/pd/OSC
http://cvs.sourceforge.net/cgi-bin/viewcvs.cgi/pure-data/externals/OSCx/
windows version:
raf at interaccess.com, http://207.208.254.239/pd/win32_osc_02.zip
OSC protocol inventory for OSC4PD

sendOSC, dumpOSC, OSCroute
==========================
  INCLUDES
    * typed and untyped packing of OSC messages
    * #bundle packing
    * transmission of OSC messages via UDP socket

    * receive OSC messages on UDP socket
    * unpacking of typed and untyped OSC messages
    * #bundle unpacking

    * static address resolution
    * pattern matching

  OMITS
    * working with timetags
    * all advanced protocol features of documentation, typesigs, etc
    * connection oriented communication