jupyter-widgets / pythreejs

A Jupyter - Three.js bridge
https://pythreejs.readthedocs.io
Other
936 stars 187 forks source link

Stereo effect #250

Open scottlittle opened 5 years ago

scottlittle commented 5 years ago

Could someone help me set up a forked dev environment so that I can explore various stereo effects that (hopefully) will lead to a pull request? Maybe that someone could just point me in the direction of what I would need to change to make it work. Thanks in advance!

vidartf commented 5 years ago

Step one, try to follow the developer install steps in the readme. If these are not sufficient, we can work through any issues and use that as a basis of improving the readme. Prerequisites for those steps are a recent installation of node.js and python, and a local clone of the git repository.

Step two, figure out what the pure three.js code that does what you want looks like. Does it need integration with the render loop? Due to the decoupled nature of pythreejs (kernel does not drive render loop), any loop integration would need to be formalized in a different way. This is probably best done as a discussion here for a first contribution. This step should probably result in a change to three-class-config.js, declaring any primitives and/or attributes needed for configuring the effect from the kernel.

Step three, write any custom JS code for translating between the serialized state and the three.js code.

Step two and step three are likely to happen in an iterative loop.

Let me know if anything here is unclear, and I'll try to help as best I can! The code base can be a little disorienting at first, since there is a lot of auto-generated code. This means the JS code has several main components: