WHAT
oscFileIO
a software that can save data into a file or load data from a file via OSC (Open Sound Control) communication
the file saved is an ASCII textfile; each line contains a specified number of data-elements separated by one empty space
the files that can be loaded must be ASCII textfiles; each line must contain the same number of data-elements separated by one empty space
data-element can be integer values, float values, strings
this allows fileIO for software systems that have OSC UGens (like chuck) but no fileIO UGens
applications: 
save data generated by chuck for further analsysis with some other software (like matlab)
save chuck-data to load it back later (preset management)


HOW
save: a save command must be sent; it has the adress pattern "/oscToFile" followed by the formatstring that corresponds to the data
that shall be saved; the first specifier of the formatstring must always specify a string because it contains the filename, then
follow the specifiers for the data (f.e. "/oscToFile","s i f f s" generates a file where each line holds a integer, two floats and one strings 
see also "testOutput.ck"

load:first a receiveloop must be startet; the receiveloop must contain a receive message with the adress pattern "/getData" followed 
by the formatstring that corresponds to the data that shall be received;
then a file request command is sent with the adress pattern "/oscFromFile" and the formatstring "s s s i i"; the formatstring specifies
the filename
the formatstring of the lines of the file
the hostname to which the file shall be sent (must be the same that was given in the receiveloop)
the port to which the file is sent and (must be the same that was given in the receiveloop)
a buffersize that specifies how many bytes one line of the file has.
see also "testInput.ck"


IMPLEMENTATION
was coded in C++ using the library
oscpack -- Open Sound Control packet manipulation library
http://www.audiomulch.com/~rossb/oscpack


PLATFORMS
WinXP
tested only for localhost communication


INSTALLATION
extract the files into some directory


START
start the programm at the command shell with the command

oscFileIO portnumber
or
oscFileIO  (in this case the portnumber is set to the default value 7000)

f.e: oscFileIO 9000

look at the examples testOutput.ck and testInput.ck
you have to adapt these example files!!! (they are heavily commented)


SHORTCOMINGS
no clever error handling implemented


WHO
hanez


RISK
your own

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR
ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF
CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.