b8eb7d18e9
First implementation of node previews in the shader node editor. Using the same user interface as compositor node previews, most shader nodes can now be previewed (except group in/output and material output). This is currently still an experimental feature, as polishing of the user experience and performance improvements are planned. These will be easier to do as incremental changes on this implementation. See #110353 for details on the work that remains to be done and known limitations. Implementation notes: We take advantage of the `RenderResult` available as `ImBuf` images to store a `Render` for every viewed nested node tree present in a `SpaceNode`. The computation is initiated at the moment of drawing nodes overlays. One render is started for the current nodetree, having a `ViewLayer` associated with each previewed node. We separate the previewed nodes in two categories: the shader ones and the non-shader ones. - For non-shader nodes, we use AOVs which highly speed up the rendering process by rendering every non-shader nodes at the same time. They are rendered in the first `ViewLayer`. - For shader nodes, we render them each in a different `ViewLayer`, by rerouting the node to the output of the material in the preview scene. The preview scene takes the same aspect as the Material preview scene, and the same preview object is used. At the moment of drawing the node overlay, we take the `Render` of the viewed node tree and extract the `ImBuf` of the wanted viewlayer/pass for each previewed node. Pull Request: https://projects.blender.org/blender/blender/pulls/110065
116 lines
3.6 KiB
C++
116 lines
3.6 KiB
C++
/* SPDX-FileCopyrightText: 2005 Blender Foundation
|
|
*
|
|
* SPDX-License-Identifier: GPL-2.0-or-later */
|
|
|
|
/** \file
|
|
* \ingroup editors
|
|
*/
|
|
|
|
#pragma once
|
|
|
|
#include "DNA_ID_enums.h"
|
|
#include "DNA_material_types.h"
|
|
#include "DNA_vec_types.h"
|
|
|
|
struct DEGEditorUpdateContext;
|
|
struct Depsgraph;
|
|
struct ID;
|
|
struct MTex;
|
|
struct Main;
|
|
struct Render;
|
|
struct Scene;
|
|
struct ScrArea;
|
|
struct bContext;
|
|
struct bScreen;
|
|
struct PreviewImage;
|
|
struct ViewLayer;
|
|
struct World;
|
|
struct wmWindow;
|
|
struct wmWindowManager;
|
|
|
|
/* `render_ops.cc` */
|
|
|
|
void ED_operatortypes_render();
|
|
|
|
/* `render_update.cc` */
|
|
|
|
void ED_render_engine_changed(Main *bmain, bool update_scene_data);
|
|
void ED_render_engine_area_exit(Main *bmain, ScrArea *area);
|
|
void ED_render_view_layer_changed(Main *bmain, bScreen *screen);
|
|
|
|
/* Callbacks handling data update events coming from depsgraph. */
|
|
|
|
void ED_render_id_flush_update(const DEGEditorUpdateContext *update_ctx, ID *id);
|
|
/**
|
|
* Update all 3D viewport render and draw engines on changes to the scene.
|
|
* This is called by the dependency graph when it detects changes.
|
|
*/
|
|
void ED_render_scene_update(const DEGEditorUpdateContext *update_ctx, bool updated);
|
|
/**
|
|
* Update 3D viewport render or draw engine on changes to the scene or view settings.
|
|
*/
|
|
void ED_render_view3d_update(Depsgraph *depsgraph, wmWindow *window, ScrArea *area, bool updated);
|
|
|
|
Scene *ED_render_job_get_scene(const bContext *C);
|
|
Scene *ED_render_job_get_current_scene(const bContext *C);
|
|
|
|
/* Render the preview
|
|
*
|
|
* pr_method:
|
|
* - PR_BUTS_RENDER: preview is rendered for buttons window
|
|
* - PR_ICON_RENDER: preview is rendered for icons. hopefully fast enough for at least 32x32
|
|
* - PR_ICON_DEFERRED: No render, we just ensure deferred icon data gets generated.
|
|
*/
|
|
enum ePreviewRenderMethod {
|
|
PR_BUTS_RENDER = 0,
|
|
PR_ICON_RENDER = 1,
|
|
PR_ICON_DEFERRED = 2,
|
|
};
|
|
|
|
bool ED_check_engine_supports_preview(const Scene *scene);
|
|
const char *ED_preview_collection_name(ePreviewType pr_type);
|
|
|
|
void ED_preview_ensure_dbase(bool with_gpencil);
|
|
void ED_preview_free_dbase();
|
|
|
|
/**
|
|
* Check if \a id is supported by the automatic preview render.
|
|
*/
|
|
bool ED_preview_id_is_supported(const ID *id);
|
|
|
|
void ED_preview_set_visibility(Main *pr_main,
|
|
Scene *scene,
|
|
ViewLayer *view_layer,
|
|
ePreviewType pr_type,
|
|
ePreviewRenderMethod pr_method);
|
|
struct World *ED_preview_prepare_world(Main *pr_main,
|
|
const Scene *scene,
|
|
const World *world,
|
|
ID_Type id_type,
|
|
ePreviewRenderMethod pr_method);
|
|
|
|
void ED_preview_shader_job(const bContext *C,
|
|
void *owner,
|
|
ID *id,
|
|
ID *parent,
|
|
MTex *slot,
|
|
int sizex,
|
|
int sizey,
|
|
ePreviewRenderMethod method);
|
|
void ED_preview_icon_render(
|
|
const bContext *C, Scene *scene, PreviewImage *prv_img, ID *id, enum eIconSizes icon_size);
|
|
void ED_preview_icon_job(
|
|
const bContext *C, PreviewImage *prv_img, ID *id, enum eIconSizes icon_size, bool delay);
|
|
|
|
void ED_preview_restart_queue_free();
|
|
void ED_preview_restart_queue_add(ID *id, enum eIconSizes size);
|
|
void ED_preview_restart_queue_work(const bContext *C);
|
|
|
|
void ED_preview_kill_jobs(wmWindowManager *wm, Main *bmain);
|
|
|
|
void ED_preview_draw(const bContext *C, void *idp, void *parentp, void *slot, rcti *rect);
|
|
|
|
void ED_render_clear_mtex_copybuf();
|
|
|
|
void ED_render_internal_init();
|