d5f1b9c222
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
113 lines
3.7 KiB
C++
113 lines
3.7 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): none yet.
|
|
*
|
|
* ***** END GPL LICENSE BLOCK *****
|
|
*/
|
|
|
|
/** \file blender/render/intern/include/render_result.h
|
|
* \ingroup render
|
|
*/
|
|
|
|
#ifndef __RENDER_RESULT_H__
|
|
#define __RENDER_RESULT_H__
|
|
|
|
#define PASS_VECTOR_MAX 10000.0f
|
|
|
|
#define RR_USE_MEM 0
|
|
#define RR_USE_EXR 1
|
|
|
|
#define RR_ALL_LAYERS NULL
|
|
#define RR_ALL_VIEWS NULL
|
|
|
|
struct ImBuf;
|
|
struct ListBase;
|
|
struct Render;
|
|
struct RenderData;
|
|
struct RenderLayer;
|
|
struct RenderResult;
|
|
struct Scene;
|
|
struct rcti;
|
|
struct ColorManagedDisplaySettings;
|
|
struct ColorManagedViewSettings;
|
|
|
|
/* New */
|
|
|
|
struct RenderResult *render_result_new(struct Render *re,
|
|
struct rcti *partrct, int crop, int savebuffers, const char *layername, const char *viewname);
|
|
struct RenderResult *render_result_new_full_sample(struct Render *re,
|
|
struct ListBase *lb, struct rcti *partrct, int crop, int savebuffers, const char *viewname);
|
|
|
|
struct RenderResult *render_result_new_from_exr(void *exrhandle, const char *colorspace, bool predivide, int rectx, int recty);
|
|
|
|
void render_result_views_new(struct RenderResult *rr, struct RenderData *rd);
|
|
|
|
/* Merge */
|
|
|
|
void render_result_merge(struct RenderResult *rr, struct RenderResult *rrpart);
|
|
|
|
/* Free */
|
|
|
|
void render_result_free(struct RenderResult *rr);
|
|
void render_result_free_list(struct ListBase *lb, struct RenderResult *rr);
|
|
|
|
/* Single Layer Render */
|
|
|
|
void render_result_single_layer_begin(struct Render *re);
|
|
void render_result_single_layer_end(struct Render *re);
|
|
|
|
/* EXR Tile File Render */
|
|
|
|
void render_result_exr_file_begin(struct Render *re);
|
|
void render_result_exr_file_end(struct Render *re);
|
|
|
|
void render_result_exr_file_merge(struct RenderResult *rr, struct RenderResult *rrpart, const char *viewname);
|
|
|
|
void render_result_exr_file_path(struct Scene *scene, const char *layname, int sample, char *filepath);
|
|
int render_result_exr_file_read_sample(struct Render *re, int sample);
|
|
int render_result_exr_file_read_path(struct RenderResult *rr, struct RenderLayer *rl_single, const char *filepath);
|
|
|
|
/* EXR cache */
|
|
|
|
void render_result_exr_file_cache_write(struct Render *re);
|
|
bool render_result_exr_file_cache_read(struct Render *re);
|
|
|
|
/* Combined Pixel Rect */
|
|
|
|
struct ImBuf *render_result_rect_to_ibuf(struct RenderResult *rr, struct RenderData *rd, const int view_id);
|
|
void render_result_rect_from_ibuf(struct RenderResult *rr, struct RenderData *rd,
|
|
struct ImBuf *ibuf, const int view_id);
|
|
|
|
void render_result_rect_fill_zero(struct RenderResult *rr, const int view_id);
|
|
void render_result_rect_get_pixels(struct RenderResult *rr,
|
|
unsigned int *rect, int rectx, int recty,
|
|
const struct ColorManagedViewSettings *view_settings,
|
|
const struct ColorManagedDisplaySettings *display_settings,
|
|
const int view_id);
|
|
|
|
void render_result_views_shallowcopy(struct RenderResult *dst, struct RenderResult *src);
|
|
void render_result_views_shallowdelete(struct RenderResult *rr);
|
|
|
|
#endif /* __RENDER_RESULT_H__ */
|
|
|