Skip to content

Commit

Permalink
updated readme
Browse files Browse the repository at this point in the history
fixed repetition filter
fixed encoding problem when sending strings with oscpy library
  • Loading branch information
maybites committed Jan 6, 2021
1 parent 90070a9 commit 68a0a98
Show file tree
Hide file tree
Showing 5 changed files with 566 additions and 222 deletions.
41 changes: 14 additions & 27 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,8 @@
# NodeOSC
# NodeOSC 2.0
OSC support for nodes and general usage.

Please be aware: Version 2 is breaking NodeOsc settings from version 1. Pleas look at the wiki for more infos

This add-on does not require any other add-on to work.

Currently it has node support for
Expand All @@ -13,32 +15,33 @@ latest release from [here](https://github.com/maybites/blender.NodeOSC/releases/

## Usage

Always restart the server after any changes to the settings.
please visit the [wiki](https://github.com/maybites/blender.NodeOSC/wiki) for more info.

### Video Tutorial

<a href="https://youtu.be/o9bzujeOyc8" target="_blank"><img src="http://img.youtube.com/vi/o9bzujeOyc8/0.jpg"
alt="NodeOSC Part One" width="240" height="180" border="10" /></a>

see the [wiki](https://github.com/maybites/blender.NodeOSC/wiki) for more info.

I think it is fairly self explanatory (with some intricacies). However, if you have questions please make an issue. This helps me to see where I should focus on the docs...

## Credits

written by maybites (2020)
written by maybites (2021)

inspired by and code used from http://www.jpfep.net/pages/addosc/.
heavily inspired by and code used from http://www.jpfep.net/pages/addosc/ and http://www.jpfep.net/pages/addroutes/.

NodeOSC relies on

* the pure [python module](https://pypi.python.org/pypi/python-osc/) [python-osc](https://github.com/attwad/python-osc) (by Attwad).
* the [pyliblo wrapper](http://das.nasophon.de/pyliblo/) for [liblo](http://liblo.sourceforge.net/) OSC library.
* the pure [python module](https://pypi.org/project/oscpy/) [oscPy](https://github.com/kivy/oscpy) (by Kivy).
* the pure [python module](https://pypi.org/project/python-osc/) [python-osc](https://github.com/attwad/python-osc) (by Attwad).

the addon contains the compiled pyliblo wrapper for windows and OSX, but not for linux.

## ChangeLog

### V2.0.0
Added dynamic evaluation format functionality combined with loops. Inspired by functionality introduced in http://www.jpfep.net/pages/addroutes/. Code cleanup and improved user interface.

### V1.0.9
Added the neat operator I found in http://www.jpfep.net/pages/addroutes/ to create new osc handlers from the context menu while hovering over a user element.

### V1.0.8
Allows to execute function calls with datapath. for example: bpy.ops.screen.animation_play(). values passed on with osc message are ignored.

Expand All @@ -53,19 +56,3 @@ Moved the transformation of AnimationNodes datatype DoubleList into the node.

### V1.0.3
Added AnimationNodes datatype DoubleList to be able to send via OscNumber node.

## Building

### pyliblo on osx

* download and install liblo via homebrew.

* then download the [pyliblo](http://das.nasophon.de/pyliblo/) wrapper and build it.

* the pyliblo library (**liblo.cpython-37m-darwin.so**) requires changes of the dynamic link library paths: (described [here](https://stackoverflow.com/questions/33991581/install-name-tool-to-update-a-executable-to-search-for-dylib-in-mac-os-x)).

`install_name_tool -change /usr/local/opt/liblo/lib/liblo.7.dylib @loader_path/liblo.7.dylib liblo.cpython-37m-darwin.so`

`install_name_tool -add_rpath @loader_path/. liblo.cpython-37m-darwin.so`

this way it looks for the **liblo.7.dylib** next to itself and not inside the folder homebrew stored it.
Binary file modified help/TestBed.blend
Binary file not shown.
Loading

0 comments on commit 68a0a98

Please sign in to comment.