Official Documentation: http://www.blender.org/manual/render/workflows/multiview.html Implemented Features ==================== Builtin Stereo Camera * Convergence Mode * Interocular Distance * Convergence Distance * Pivot Mode Viewport * Cameras * Plane * Volume Compositor * View Switch Node * Image Node Multi-View OpenEXR support Sequencer * Image/Movie Strips 'Use Multiview' UV/Image Editor * Option to see Multi-View images in Stereo-3D or its individual images * Save/Open Multi-View (OpenEXR, Stereo3D, individual views) images I/O * Save/Open Multi-View (OpenEXR, Stereo3D, individual views) images Scene Render Views * Ability to have an arbitrary number of views in the scene Missing Bits ============ First rule of Multi-View bug report: If something is not working as it should *when Views is off* this is a severe bug, do mention this in the report. Second rule is, if something works *when Views is off* but doesn't (or crashes) when *Views is on*, this is a important bug. Do mention this in the report. Everything else is likely small todos, and may wait until we are sure none of the above is happening. Apart from that there are those known issues: * Compositor Image Node poorly working for Multi-View OpenEXR (this was working prefectly before the 'Use Multi-View' functionality) * Selecting camera from Multi-View when looking from camera is problematic * Animation Playback (ctrl+F11) doesn't support stereo formats * Wrong filepath when trying to play back animated scene * Viewport Rendering doesn't support Multi-View * Overscan Rendering * Fullscreen display modes need to warn the user * Object copy should be aware of views suffix Acknowledgments =============== * Francesco Siddi for the help with the original feature specs and design * Brecht Van Lommel for the original review of the code and design early on * Blender Foundation for the Development Fund to support the project wrap up Final patch reviewers: * Antony Riakiotakis (psy-fi) * Campbell Barton (ideasman42) * Julian Eisel (Severin) * Sergey Sharybin (nazgul) * Thomas Dinged (dingto) Code contributors of the original branch in github: * Alexey Akishin * Gabriel Caraballo
208 lines
5.6 KiB
C++
208 lines
5.6 KiB
C++
/*
|
|
* Copyright 2011, Blender Foundation.
|
|
*
|
|
* This program is free software; you can redistribute it and/or
|
|
* modify it under the terms of the GNU General Public License
|
|
* as published by the Free Software Foundation; either version 2
|
|
* of the License, or (at your option) any later version.
|
|
*
|
|
* This program is distributed in the hope that it will be useful,
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
* GNU General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU General Public License
|
|
* along with this program; if not, write to the Free Software Foundation,
|
|
* Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
|
|
*
|
|
* Contributor:
|
|
* Jeroen Bakker
|
|
* Monique Dewanchand
|
|
*/
|
|
|
|
#ifndef _COM_CompositorContext_h
|
|
#define _COM_CompositorContext_h
|
|
|
|
#include <vector>
|
|
#include "BKE_text.h"
|
|
#include <string>
|
|
#include "DNA_node_types.h"
|
|
#include "DNA_color_types.h"
|
|
#include "BLI_rect.h"
|
|
#include "DNA_scene_types.h"
|
|
#include "COM_defines.h"
|
|
|
|
/**
|
|
* @brief Overall context of the compositor
|
|
*/
|
|
class CompositorContext {
|
|
private:
|
|
/**
|
|
* @brief The rendering field describes if we are rendering (F12) or if we are editing (Node editor)
|
|
* This field is initialized in ExecutionSystem and must only be read from that point on.
|
|
* @see ExecutionSystem
|
|
*/
|
|
bool m_rendering;
|
|
|
|
/**
|
|
* @brief The quality of the composite.
|
|
* This field is initialized in ExecutionSystem and must only be read from that point on.
|
|
* @see ExecutionSystem
|
|
*/
|
|
CompositorQuality m_quality;
|
|
|
|
Scene *m_scene;
|
|
|
|
/**
|
|
* @brief Reference to the render data that is being composited.
|
|
* This field is initialized in ExecutionSystem and must only be read from that point on.
|
|
* @see ExecutionSystem
|
|
*/
|
|
RenderData *m_rd;
|
|
|
|
/**
|
|
* @brief reference to the bNodeTree
|
|
* This field is initialized in ExecutionSystem and must only be read from that point on.
|
|
* @see ExecutionSystem
|
|
*/
|
|
bNodeTree *m_bnodetree;
|
|
|
|
/**
|
|
* @brief Preview image hash table
|
|
* This field is initialized in ExecutionSystem and must only be read from that point on.
|
|
*/
|
|
bNodeInstanceHash *m_previews;
|
|
|
|
/**
|
|
* @brief does this system have active opencl devices?
|
|
*/
|
|
bool m_hasActiveOpenCLDevices;
|
|
|
|
/**
|
|
* @brief Skip slow nodes
|
|
*/
|
|
bool m_fastCalculation;
|
|
|
|
/* @brief color management settings */
|
|
const ColorManagedViewSettings *m_viewSettings;
|
|
const ColorManagedDisplaySettings *m_displaySettings;
|
|
|
|
/**
|
|
* @brief active rendering view name
|
|
*/
|
|
const char *m_viewName;
|
|
|
|
public:
|
|
/**
|
|
* @brief constructor initializes the context with default values.
|
|
*/
|
|
CompositorContext();
|
|
|
|
/**
|
|
* @brief set the rendering field of the context
|
|
*/
|
|
void setRendering(bool rendering) { this->m_rendering = rendering; }
|
|
|
|
/**
|
|
* @brief get the rendering field of the context
|
|
*/
|
|
bool isRendering() const { return this->m_rendering; }
|
|
|
|
/**
|
|
* @brief set the scene of the context
|
|
*/
|
|
void setRenderData(RenderData *rd) { this->m_rd = rd; }
|
|
|
|
/**
|
|
* @brief set the bnodetree of the context
|
|
*/
|
|
void setbNodeTree(bNodeTree *bnodetree) { this->m_bnodetree = bnodetree; }
|
|
|
|
/**
|
|
* @brief get the bnodetree of the context
|
|
*/
|
|
const bNodeTree *getbNodeTree() const { return this->m_bnodetree; }
|
|
|
|
/**
|
|
* @brief get the scene of the context
|
|
*/
|
|
const RenderData *getRenderData() const { return this->m_rd; }
|
|
|
|
void setScene(Scene *scene) { m_scene = scene; }
|
|
Scene *getScene() const { return m_scene; }
|
|
|
|
/**
|
|
* @brief set the preview image hash table
|
|
*/
|
|
void setPreviewHash(bNodeInstanceHash *previews) { this->m_previews = previews; }
|
|
|
|
/**
|
|
* @brief get the preview image hash table
|
|
*/
|
|
bNodeInstanceHash *getPreviewHash() const { return this->m_previews; }
|
|
|
|
/**
|
|
* @brief set view settings of color color management
|
|
*/
|
|
void setViewSettings(const ColorManagedViewSettings *viewSettings) { this->m_viewSettings = viewSettings; }
|
|
|
|
/**
|
|
* @brief get view settings of color color management
|
|
*/
|
|
const ColorManagedViewSettings *getViewSettings() const { return this->m_viewSettings; }
|
|
|
|
/**
|
|
* @brief set display settings of color color management
|
|
*/
|
|
void setDisplaySettings(const ColorManagedDisplaySettings *displaySettings) { this->m_displaySettings = displaySettings; }
|
|
|
|
/**
|
|
* @brief get display settings of color color management
|
|
*/
|
|
const ColorManagedDisplaySettings *getDisplaySettings() const { return this->m_displaySettings; }
|
|
|
|
/**
|
|
* @brief set the quality
|
|
*/
|
|
void setQuality(CompositorQuality quality) { this->m_quality = quality; }
|
|
|
|
/**
|
|
* @brief get the quality
|
|
*/
|
|
const CompositorQuality getQuality() const { return this->m_quality; }
|
|
|
|
/**
|
|
* @brief get the current framenumber of the scene in this context
|
|
*/
|
|
const int getFramenumber() const;
|
|
|
|
/**
|
|
* @brief has this system active openclDevices?
|
|
*/
|
|
const bool getHasActiveOpenCLDevices() const { return this->m_hasActiveOpenCLDevices; }
|
|
|
|
/**
|
|
* @brief set has this system active openclDevices?
|
|
*/
|
|
void setHasActiveOpenCLDevices(bool hasAvtiveOpenCLDevices) { this->m_hasActiveOpenCLDevices = hasAvtiveOpenCLDevices; }
|
|
|
|
/**
|
|
* @brief get the active rendering view
|
|
*/
|
|
const char *getViewName() const { return this->m_viewName; }
|
|
|
|
/**
|
|
* @brief set the active rendering view
|
|
*/
|
|
void setViewName(const char *viewName) { this->m_viewName = viewName; }
|
|
|
|
int getChunksize() const { return this->getbNodeTree()->chunksize; }
|
|
|
|
void setFastCalculation(bool fastCalculation) {this->m_fastCalculation = fastCalculation;}
|
|
bool isFastCalculation() const { return this->m_fastCalculation; }
|
|
bool isGroupnodeBufferEnabled() const { return (this->getbNodeTree()->flag & NTREE_COM_GROUPNODE_BUFFER) != 0; }
|
|
};
|
|
|
|
|
|
#endif
|