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
391 lines
10 KiB
C
391 lines
10 KiB
C
/*
|
|
* ***** BEGIN GPL LICENSE BLOCK *****
|
|
*
|
|
* 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.
|
|
*
|
|
* The Original Code is Copyright (C) 2007 Blender Foundation.
|
|
* All rights reserved.
|
|
*
|
|
* The Original Code is: all of this file.
|
|
*
|
|
* Contributor(s):
|
|
*
|
|
* ***** END GPL LICENSE BLOCK *****
|
|
*/
|
|
|
|
/** \file blender/nodes/composite/node_composite_tree.c
|
|
* \ingroup nodes
|
|
*/
|
|
|
|
|
|
#include <stdio.h>
|
|
|
|
#include "DNA_color_types.h"
|
|
#include "DNA_scene_types.h"
|
|
#include "DNA_node_types.h"
|
|
|
|
#include "BLF_translation.h"
|
|
|
|
#include "BKE_context.h"
|
|
#include "BKE_global.h"
|
|
#include "BKE_main.h"
|
|
#include "BKE_node.h"
|
|
#include "BKE_tracking.h"
|
|
|
|
#include "node_common.h"
|
|
#include "node_util.h"
|
|
|
|
#include "RNA_access.h"
|
|
|
|
#include "NOD_composite.h"
|
|
#include "node_composite_util.h"
|
|
|
|
#ifdef WITH_COMPOSITOR
|
|
# include "COM_compositor.h"
|
|
#endif
|
|
|
|
static void composite_get_from_context(const bContext *C, bNodeTreeType *UNUSED(treetype), bNodeTree **r_ntree, ID **r_id, ID **r_from)
|
|
{
|
|
Scene *scene = CTX_data_scene(C);
|
|
|
|
*r_from = NULL;
|
|
*r_id = &scene->id;
|
|
*r_ntree = scene->nodetree;
|
|
}
|
|
|
|
static void foreach_nodeclass(Scene *UNUSED(scene), void *calldata, bNodeClassCallback func)
|
|
{
|
|
func(calldata, NODE_CLASS_INPUT, N_("Input"));
|
|
func(calldata, NODE_CLASS_OUTPUT, N_("Output"));
|
|
func(calldata, NODE_CLASS_OP_COLOR, N_("Color"));
|
|
func(calldata, NODE_CLASS_OP_VECTOR, N_("Vector"));
|
|
func(calldata, NODE_CLASS_OP_FILTER, N_("Filter"));
|
|
func(calldata, NODE_CLASS_CONVERTOR, N_("Convertor"));
|
|
func(calldata, NODE_CLASS_MATTE, N_("Matte"));
|
|
func(calldata, NODE_CLASS_DISTORT, N_("Distort"));
|
|
func(calldata, NODE_CLASS_GROUP, N_("Group"));
|
|
func(calldata, NODE_CLASS_INTERFACE, N_("Interface"));
|
|
func(calldata, NODE_CLASS_LAYOUT, N_("Layout"));
|
|
}
|
|
|
|
static void free_node_cache(bNodeTree *UNUSED(ntree), bNode *node)
|
|
{
|
|
bNodeSocket *sock;
|
|
|
|
for (sock = node->outputs.first; sock; sock = sock->next) {
|
|
if (sock->cache) {
|
|
sock->cache = NULL;
|
|
}
|
|
}
|
|
}
|
|
|
|
static void free_cache(bNodeTree *ntree)
|
|
{
|
|
bNode *node;
|
|
for (node = ntree->nodes.first; node; node = node->next)
|
|
free_node_cache(ntree, node);
|
|
}
|
|
|
|
/* local tree then owns all compbufs */
|
|
static void localize(bNodeTree *UNUSED(localtree), bNodeTree *ntree)
|
|
{
|
|
bNode *node;
|
|
bNodeSocket *sock;
|
|
|
|
for (node = ntree->nodes.first; node; node = node->next) {
|
|
/* ensure new user input gets handled ok */
|
|
node->need_exec = 0;
|
|
node->new_node->original = node;
|
|
|
|
/* move over the compbufs */
|
|
/* right after ntreeCopyTree() oldsock pointers are valid */
|
|
|
|
if (ELEM(node->type, CMP_NODE_VIEWER, CMP_NODE_SPLITVIEWER)) {
|
|
if (node->id) {
|
|
if (node->flag & NODE_DO_OUTPUT)
|
|
node->new_node->id = (ID *)node->id;
|
|
else
|
|
node->new_node->id = NULL;
|
|
}
|
|
}
|
|
|
|
for (sock = node->outputs.first; sock; sock = sock->next) {
|
|
sock->new_sock->cache = sock->cache;
|
|
sock->cache = NULL;
|
|
sock->new_sock->new_sock = sock;
|
|
}
|
|
}
|
|
}
|
|
|
|
static void local_sync(bNodeTree *localtree, bNodeTree *ntree)
|
|
{
|
|
BKE_node_preview_sync_tree(ntree, localtree);
|
|
}
|
|
|
|
static void local_merge(bNodeTree *localtree, bNodeTree *ntree)
|
|
{
|
|
bNode *lnode;
|
|
bNodeSocket *lsock;
|
|
|
|
/* move over the compbufs and previews */
|
|
BKE_node_preview_merge_tree(ntree, localtree, true);
|
|
|
|
for (lnode = localtree->nodes.first; lnode; lnode = lnode->next) {
|
|
if (ntreeNodeExists(ntree, lnode->new_node)) {
|
|
if (ELEM(lnode->type, CMP_NODE_VIEWER, CMP_NODE_SPLITVIEWER)) {
|
|
if (lnode->id && (lnode->flag & NODE_DO_OUTPUT)) {
|
|
/* image_merge does sanity check for pointers */
|
|
BKE_image_merge((Image *)lnode->new_node->id, (Image *)lnode->id);
|
|
}
|
|
}
|
|
else if (lnode->type == CMP_NODE_MOVIEDISTORTION) {
|
|
/* special case for distortion node: distortion context is allocating in exec function
|
|
* and to achieve much better performance on further calls this context should be
|
|
* copied back to original node */
|
|
if (lnode->storage) {
|
|
if (lnode->new_node->storage)
|
|
BKE_tracking_distortion_free(lnode->new_node->storage);
|
|
|
|
lnode->new_node->storage = BKE_tracking_distortion_copy(lnode->storage);
|
|
}
|
|
}
|
|
|
|
for (lsock = lnode->outputs.first; lsock; lsock = lsock->next) {
|
|
if (ntreeOutputExists(lnode->new_node, lsock->new_sock)) {
|
|
lsock->new_sock->cache = lsock->cache;
|
|
lsock->cache = NULL;
|
|
lsock->new_sock = NULL;
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
|
|
static void update(bNodeTree *ntree)
|
|
{
|
|
ntreeSetOutput(ntree);
|
|
|
|
ntree_update_reroute_nodes(ntree);
|
|
|
|
if (ntree->update & NTREE_UPDATE_NODES) {
|
|
/* clean up preview cache, in case nodes have been removed */
|
|
BKE_node_preview_remove_unused(ntree);
|
|
}
|
|
}
|
|
|
|
static void composite_node_add_init(bNodeTree *UNUSED(bnodetree), bNode *bnode)
|
|
{
|
|
/* Composite node will only show previews for input classes
|
|
* by default, other will be hidden
|
|
* but can be made visible with the show_preview option */
|
|
if (bnode->typeinfo->nclass != NODE_CLASS_INPUT) {
|
|
bnode->flag &= ~NODE_PREVIEW;
|
|
}
|
|
}
|
|
|
|
bNodeTreeType *ntreeType_Composite;
|
|
|
|
void register_node_tree_type_cmp(void)
|
|
{
|
|
bNodeTreeType *tt = ntreeType_Composite = MEM_callocN(sizeof(bNodeTreeType), "compositor node tree type");
|
|
|
|
tt->type = NTREE_COMPOSIT;
|
|
strcpy(tt->idname, "CompositorNodeTree");
|
|
strcpy(tt->ui_name, "Compositing");
|
|
tt->ui_icon = 0; /* defined in drawnode.c */
|
|
strcpy(tt->ui_description, "Compositing nodes");
|
|
|
|
tt->free_cache = free_cache;
|
|
tt->free_node_cache = free_node_cache;
|
|
tt->foreach_nodeclass = foreach_nodeclass;
|
|
tt->localize = localize;
|
|
tt->local_sync = local_sync;
|
|
tt->local_merge = local_merge;
|
|
tt->update = update;
|
|
tt->get_from_context = composite_get_from_context;
|
|
tt->node_add_init = composite_node_add_init;
|
|
|
|
tt->ext.srna = &RNA_CompositorNodeTree;
|
|
|
|
ntreeTypeAdd(tt);
|
|
}
|
|
|
|
void *COM_linker_hack = NULL;
|
|
|
|
void ntreeCompositExecTree(Scene *scene, bNodeTree *ntree, RenderData *rd, int rendering, int do_preview,
|
|
const ColorManagedViewSettings *view_settings,
|
|
const ColorManagedDisplaySettings *display_settings,
|
|
const char *view_name)
|
|
{
|
|
#ifdef WITH_COMPOSITOR
|
|
COM_execute(rd, scene, ntree, rendering, view_settings, display_settings, view_name);
|
|
#else
|
|
UNUSED_VARS(scene, ntree, rd, rendering, view_settings, display_settings, view_name);
|
|
#endif
|
|
|
|
UNUSED_VARS(do_preview);
|
|
}
|
|
|
|
/* *********************************************** */
|
|
|
|
/* based on rules, force sockets hidden always */
|
|
void ntreeCompositForceHidden(bNodeTree *ntree)
|
|
{
|
|
bNode *node;
|
|
|
|
if (ntree == NULL) return;
|
|
|
|
for (node = ntree->nodes.first; node; node = node->next) {
|
|
if (node->type == CMP_NODE_R_LAYERS)
|
|
node_cmp_rlayers_force_hidden_passes(node);
|
|
|
|
/* XXX this stuff is called all the time, don't want that.
|
|
* Updates should only happen when actually necessary.
|
|
*/
|
|
#if 0
|
|
else if (node->type == CMP_NODE_IMAGE) {
|
|
nodeUpdate(ntree, node);
|
|
}
|
|
#endif
|
|
}
|
|
|
|
}
|
|
|
|
/* called from render pipeline, to tag render input and output */
|
|
/* need to do all scenes, to prevent errors when you re-render 1 scene */
|
|
void ntreeCompositTagRender(Scene *curscene)
|
|
{
|
|
Scene *sce;
|
|
|
|
for (sce = G.main->scene.first; sce; sce = sce->id.next) {
|
|
if (sce->nodetree) {
|
|
bNode *node;
|
|
|
|
for (node = sce->nodetree->nodes.first; node; node = node->next) {
|
|
if (node->id == (ID *)curscene || node->type == CMP_NODE_COMPOSITE)
|
|
nodeUpdate(sce->nodetree, node);
|
|
else if (node->type == CMP_NODE_TEXTURE) /* uses scene sizex/sizey */
|
|
nodeUpdate(sce->nodetree, node);
|
|
}
|
|
}
|
|
}
|
|
}
|
|
|
|
static int node_animation_properties(bNodeTree *ntree, bNode *node)
|
|
{
|
|
bNodeSocket *sock;
|
|
const ListBase *lb;
|
|
Link *link;
|
|
PointerRNA ptr;
|
|
PropertyRNA *prop;
|
|
|
|
/* check to see if any of the node's properties have fcurves */
|
|
RNA_pointer_create((ID *)ntree, &RNA_Node, node, &ptr);
|
|
lb = RNA_struct_type_properties(ptr.type);
|
|
|
|
for (link = lb->first; link; link = link->next) {
|
|
prop = (PropertyRNA *)link;
|
|
|
|
if (RNA_property_animated(&ptr, prop)) {
|
|
nodeUpdate(ntree, node);
|
|
return 1;
|
|
}
|
|
}
|
|
|
|
/* now check node sockets */
|
|
for (sock = node->inputs.first; sock; sock = sock->next) {
|
|
RNA_pointer_create((ID *)ntree, &RNA_NodeSocket, sock, &ptr);
|
|
prop = RNA_struct_find_property(&ptr, "default_value");
|
|
|
|
if (RNA_property_animated(&ptr, prop)) {
|
|
nodeUpdate(ntree, node);
|
|
return 1;
|
|
}
|
|
}
|
|
|
|
return 0;
|
|
}
|
|
|
|
/* tags nodes that have animation capabilities */
|
|
int ntreeCompositTagAnimated(bNodeTree *ntree)
|
|
{
|
|
bNode *node;
|
|
int tagged = 0;
|
|
|
|
if (ntree == NULL) return 0;
|
|
|
|
for (node = ntree->nodes.first; node; node = node->next) {
|
|
|
|
tagged = node_animation_properties(ntree, node);
|
|
|
|
/* otherwise always tag these node types */
|
|
if (node->type == CMP_NODE_IMAGE) {
|
|
Image *ima = (Image *)node->id;
|
|
if (ima && BKE_image_is_animated(ima)) {
|
|
nodeUpdate(ntree, node);
|
|
tagged = 1;
|
|
}
|
|
}
|
|
else if (node->type == CMP_NODE_TIME) {
|
|
nodeUpdate(ntree, node);
|
|
tagged = 1;
|
|
}
|
|
/* here was tag render layer, but this is called after a render, so re-composites fail */
|
|
else if (node->type == NODE_GROUP) {
|
|
if (ntreeCompositTagAnimated((bNodeTree *)node->id)) {
|
|
nodeUpdate(ntree, node);
|
|
}
|
|
}
|
|
else if (ELEM(node->type, CMP_NODE_MOVIECLIP, CMP_NODE_TRANSFORM)) {
|
|
nodeUpdate(ntree, node);
|
|
tagged = 1;
|
|
}
|
|
else if (node->type == CMP_NODE_MASK) {
|
|
nodeUpdate(ntree, node);
|
|
tagged = 1;
|
|
}
|
|
}
|
|
|
|
return tagged;
|
|
}
|
|
|
|
|
|
/* called from image window preview */
|
|
void ntreeCompositTagGenerators(bNodeTree *ntree)
|
|
{
|
|
bNode *node;
|
|
|
|
if (ntree == NULL) return;
|
|
|
|
for (node = ntree->nodes.first; node; node = node->next) {
|
|
if (ELEM(node->type, CMP_NODE_R_LAYERS, CMP_NODE_IMAGE))
|
|
nodeUpdate(ntree, node);
|
|
}
|
|
}
|
|
|
|
/* XXX after render animation system gets a refresh, this call allows composite to end clean */
|
|
void ntreeCompositClearTags(bNodeTree *ntree)
|
|
{
|
|
bNode *node;
|
|
|
|
if (ntree == NULL) return;
|
|
|
|
for (node = ntree->nodes.first; node; node = node->next) {
|
|
node->need_exec = 0;
|
|
if (node->type == NODE_GROUP)
|
|
ntreeCompositClearTags((bNodeTree *)node->id);
|
|
}
|
|
}
|