/Max_Worldmaking_Package

A package for Max/MSP/Jitter to support computational worldmaking
  1. Max 99.7%
  2. HTML 0.3%
Switch branches/tags
Nothing to show
Find file
Clone or download

Clone with HTTPS

Use Git or checkout with SVN using the web URL.

Download ZIP

Launching GitHub Desktop...

If nothing happens, download GitHub Desktop and try again.

Launching GitHub Desktop...

If nothing happens, download GitHub Desktop and try again.

Launching Xcode...

If nothing happens, download Xcode and try again.

Launching Visual Studio...

If nothing happens, download the GitHub extension for Visual Studio and try again.

Pull request Compare This branch is 115 commits ahead, 21 commits behind master.
@grrrwaaa
grrrwaaa freenect update
Latest commit e476e93 Dec 6, 2018
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
extensions dyn updates Jul 15, 2017
externals freenect update Dec 6, 2018
help freenect update Dec 6, 2018
include limits fix Feb 7, 2017
init al.solvePnP helpfile example working nicely Jan 27, 2017
interfaces al.solvePnP helpfile example working nicely Jan 27, 2017
media move images in media folder Feb 14, 2018
patchers Merge branch 'devel' of https://github.com/worldmaking/Max_Worldmakin… Jan 9, 2018
resources freenect osx build Nov 29, 2018
source freenect update Dec 6, 2018
support Updated support dlls to SDK 1.0.7 May 4, 2017
.gitattributes oculus sdk update Jun 16, 2017
.gitignore Update [htcvive] to 1.0.2 openvr SDK Jul 11, 2016
.gitmodules glm inline Jul 8, 2016
LICENSE.txt first commits Dec 11, 2015
README.md Update README.md Jul 12, 2016
git_tips.txt added camera input for vive Nov 8, 2016
icon.png icon Nov 14, 2016
package-info.json icon Nov 14, 2016

README.md

A package for Max/MSP/Jitter to support computational worldmaking

Currently includes:

  • oculusrift -- supports the Oculus Rift head-mounted display (developer kit and consumer models, currently Windows only)
  • htcvive -- supports the HTC Vive head-mounted display (currently Windows only)
  • ws -- a simple websocket server external for max, making it trivial to interact with browser-based clients (Windows/OSX)

Work in progress (may have limited functionality/stability issues)

  • kinect -- supports the kinect v1 including multiple devices, skeleton, point cloud etc. (windows only)
  • kinect2 -- supports the kinect v2 (for windows/for xbox versions, windows only)

Much more to come!

Installing

Download the package and place into your Max Packages folder. (On Windows, My Documents/Max 7/Packages, on Mac, ~/Documents/Max 7/Packages), then restart Max.

Take a look at patchers in the help and examples folders to get to know the package.

Dependencies

  • The [oculusrift] object depends upon having the Oculus Home software installed & calibrated. It is free.
  • The [htcvive] object depends upon having Steam and SteamVR installed & calibrated. It is free.

If you have trouble loading externals on Windows, you might need to install the visual studio 2015 redistributable package. It is free.

Hardware requirements for the VR objects ([oculusrift] and [htcvive])

Obviously, you need the respective Oculus Rift or HTC Vive head-mounted display hardware!

Creating a virtual reality world requires high-performance computer graphics -- with the current generation of consumer head-mounted displays, it requires the equivalent of two HD or better resolution screens rendering at 90 frames per second. At present the recommended PC requirements to cover both the Rift and the Vive are:

  • GPU: NVIDIA GTX 970 / AMD R9 290 equivalent or greater
  • Video Output: HDMI 1.4 or DisplayPort 1.2 or newer
  • CPU: Intel i5-4590 / AMD FX 8350 equivalent or greater
  • Memory: 8GB+ RAM
  • USB: 3x USB 3.0 ports plus 1x USB 2.0 port
  • OS: Windows 7 SP1 64 bit or newer (No OSX support at present)

Development

See the /source folder. You may need to git submodules init && git submodules update to get all dependencies.