de7a8af793
This is a new option for panorama cameras to render stereo that can be used in virtual reality devices The option is available under the camera panel when Multi-View is enabled (Views option in the Render Layers panel) Known limitations: ------------------ * Parallel convergence is not supported (you need to set a convergence distance really high to simulate this effect). * Pivot was not supposed to affect the render but it does, this has to be looked at, but for now set it to CENTER * Derivatives in perspective camera need to be pre-computed or we shuld get rid of kcam->dx/dy (Sergey words, I don't fully grasp the implication shere) * This works in perspective mode and in panorama mode. However, for fully benefit from this effect in perspective mode you need to render a cube map. (there is an addon for this, developed separately, perhaps we could include it in master). * We have no support for "neck distance" at the moment. This is supposed to help with objects at short distances. * We have no support to rotate the "Up Axis" of the stereo plane. Meaning, we hardcode 0,0,1 as UP, and create the stereo pair related to that. (although we could take the camera local UP when rendering panoramas, this wouldn't work for perspective cameras. * We have no support for interocular distance attenuation based on the proximity of the poles (which helps to reduce the pole rotation effect/artifact). THIS NEEDS DOCS - both in 2.78 release log and the Blender manual. Meanwhile you can read about it here: http://code.blender.org/2015/03/1451 This patch specifically dates from March 2015, as you can see in the code.blender.org post. Many thanks to all the reviewers, testers and minor sponsors who helped me maintain spherical-stereo for 1 year. All that said, have fun with this. This feature was what got me started with Multi-View development (at the time what I was looking for was Fulldome stereo support, but the implementation is the same). In order to make this into Blender I had to make it aiming at a less-specic user-case Thus Multi-View started. (this was December 2012, during Siggraph Asia and a chat I had with Paul Bourke during the conference). I don't have the original patch anymore, but you can find a re-based version of it from March 2013, right before I start with the Multi-View project https://developer.blender.org/P332 Reviewers: sergey, dingto Subscribers: #cycles Differential Revision: https://developer.blender.org/D1223
128 lines
3.5 KiB
Python
128 lines
3.5 KiB
Python
#
|
|
# Copyright 2011-2013 Blender Foundation
|
|
#
|
|
# Licensed under the Apache License, Version 2.0 (the "License");
|
|
# you may not use this file except in compliance with the License.
|
|
# You may obtain a copy of the License at
|
|
#
|
|
# http://www.apache.org/licenses/LICENSE-2.0
|
|
#
|
|
# Unless required by applicable law or agreed to in writing, software
|
|
# distributed under the License is distributed on an "AS IS" BASIS,
|
|
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
# See the License for the specific language governing permissions and
|
|
# limitations under the License.
|
|
#
|
|
|
|
# <pep8 compliant>
|
|
|
|
bl_info = {
|
|
"name": "Cycles Render Engine",
|
|
"author": "",
|
|
"blender": (2, 76, 0),
|
|
"location": "Info header, render engine menu",
|
|
"description": "Cycles Render Engine integration",
|
|
"warning": "",
|
|
"wiki_url": "https://www.blender.org/manual/render/cycles/index.html",
|
|
"tracker_url": "",
|
|
"support": 'OFFICIAL',
|
|
"category": "Render"}
|
|
|
|
import bpy
|
|
|
|
from . import (
|
|
engine,
|
|
version_update,
|
|
)
|
|
|
|
|
|
class CyclesRender(bpy.types.RenderEngine):
|
|
bl_idname = 'CYCLES'
|
|
bl_label = "Cycles Render"
|
|
bl_use_shading_nodes = True
|
|
bl_use_preview = True
|
|
bl_use_exclude_layers = True
|
|
bl_use_save_buffers = True
|
|
bl_use_spherical_stereo = True
|
|
|
|
def __init__(self):
|
|
self.session = None
|
|
|
|
def __del__(self):
|
|
engine.free(self)
|
|
|
|
# final render
|
|
def update(self, data, scene):
|
|
if not self.session:
|
|
if self.is_preview:
|
|
cscene = bpy.context.scene.cycles
|
|
use_osl = cscene.shading_system and cscene.device == 'CPU'
|
|
|
|
engine.create(self, data, scene,
|
|
None, None, None, use_osl)
|
|
else:
|
|
engine.create(self, data, scene)
|
|
else:
|
|
engine.reset(self, data, scene)
|
|
|
|
def render(self, scene):
|
|
engine.render(self)
|
|
|
|
def bake(self, scene, obj, pass_type, pass_filter, object_id, pixel_array, num_pixels, depth, result):
|
|
engine.bake(self, obj, pass_type, pass_filter, object_id, pixel_array, num_pixels, depth, result)
|
|
|
|
# viewport render
|
|
def view_update(self, context):
|
|
if not self.session:
|
|
engine.create(self, context.blend_data, context.scene,
|
|
context.region, context.space_data, context.region_data)
|
|
engine.update(self, context.blend_data, context.scene)
|
|
|
|
def view_draw(self, context):
|
|
engine.draw(self, context.region, context.space_data, context.region_data)
|
|
|
|
def update_script_node(self, node):
|
|
if engine.with_osl():
|
|
from . import osl
|
|
osl.update_script_node(node, self.report)
|
|
else:
|
|
self.report({'ERROR'}, "OSL support disabled in this build.")
|
|
|
|
|
|
def engine_exit():
|
|
engine.exit()
|
|
|
|
|
|
def register():
|
|
from . import ui
|
|
from . import properties
|
|
from . import presets
|
|
import atexit
|
|
|
|
# Make sure we only registered the callback once.
|
|
atexit.unregister(engine_exit)
|
|
atexit.register(engine_exit)
|
|
|
|
engine.init()
|
|
|
|
properties.register()
|
|
ui.register()
|
|
presets.register()
|
|
bpy.utils.register_module(__name__)
|
|
|
|
bpy.app.handlers.version_update.append(version_update.do_versions)
|
|
|
|
|
|
def unregister():
|
|
from . import ui
|
|
from . import properties
|
|
from . import presets
|
|
import atexit
|
|
|
|
bpy.app.handlers.version_update.remove(version_update.do_versions)
|
|
|
|
ui.unregister()
|
|
properties.unregister()
|
|
presets.unregister()
|
|
bpy.utils.unregister_module(__name__)
|