render_types.h

Go to the documentation of this file.

/* SPDX-FileCopyrightText: 2001-2002 NaN Holding BV. All rights reserved.
 *
 * SPDX-License-Identifier: GPL-2.0-or-later */
 
#pragma once
 
/* ------------------------------------------------------------------------- */
/* exposed internal in render module only! */
/* ------------------------------------------------------------------------- */
 
#include <mutex>
 
#include "DNA_scene_types.h"
 
#include "BLI_threads.h"
 
#include "RE_compositor.hh"
#include "RE_pipeline.h"
 
#include "tile_highlight.h"
 
namespace blender::realtime_compositor {
class RenderContext;
class Profiler;
}  // namespace blender::realtime_compositor
 
struct bNodeTree;
struct Depsgraph;
struct Main;
struct Object;
struct RenderEngine;
struct ReportList;
struct Scene;
 
struct BaseRender {
  BaseRender() = default;
  virtual ~BaseRender();
 
  /* Get class which manages highlight of tiles.
   * Note that it might not exist: for example, viewport render does not support the tile
   * highlight. */
  virtual blender::render::TilesHighlight *get_tile_highlight() = 0;
 
  /* GPU/realtime compositor. */
  virtual void compositor_execute(const Scene &scene,
                                  const RenderData &render_data,
                                  const bNodeTree &node_tree,
                                  const char *view_name,
                                  blender::realtime_compositor::RenderContext *render_context,
                                  blender::realtime_compositor::Profiler *profiler) = 0;
  virtual void compositor_free() = 0;
 
  virtual void display_init(RenderResult *render_result) = 0;
  virtual void display_clear(RenderResult *render_result) = 0;
  virtual void display_update(RenderResult *render_result, rcti *rect) = 0;
  virtual void current_scene_update(struct Scene *scene) = 0;
 
  virtual void stats_draw(RenderStats *render_stats) = 0;
  virtual void progress(float progress) = 0;
 
  virtual void draw_lock() = 0;
  virtual void draw_unlock() = 0;
 
  /* Test whether render is to be stopped: if the function returns true rendering will be stopped
   * as soon as the render pipeline allows it. */
  virtual bool test_break() = 0;
 
  virtual bool prepare_viewlayer(struct ViewLayer *view_layer, struct Depsgraph *depsgraph) = 0;
 
  /* Result of rendering */
  RenderResult *result = nullptr;
 
  /* Read/write mutex, all internal code that writes to the `result` must use a
   * write lock, all external code must use a read lock. Internal code is assumed
   * to not conflict with writes, so no lock used for that. */
  ThreadRWMutex resultmutex = BLI_RWLOCK_INITIALIZER;
 
  /* Render engine. */
  struct RenderEngine *engine = nullptr;
 
  /* Guard for drawing render result using engine's `draw()` callback. */
  ThreadMutex engine_draw_mutex = BLI_MUTEX_INITIALIZER;
};
 
struct ViewRender : public BaseRender {
  blender::render::TilesHighlight *get_tile_highlight() override
  {
    return nullptr;
  }
 
  void compositor_execute(const Scene & /*scene*/,
                          const RenderData & /*render_data*/,
                          const bNodeTree & /*node_tree*/,
                          const char * /*view_name*/,
                          blender::realtime_compositor::RenderContext * /*render_context*/,
                          blender::realtime_compositor::Profiler * /*profiler*/) override
  {
  }
  void compositor_free() override {}
 
  void display_init(RenderResult * /*render_result*/) override {}
  void display_clear(RenderResult * /*render_result*/) override {}
  void display_update(RenderResult * /*render_result*/, rcti * /*rect*/) override {}
  void current_scene_update(struct Scene * /*scene*/) override {}
 
  void stats_draw(RenderStats * /*render_stats*/) override {}
  void progress(const float /*progress*/) override {}
 
  void draw_lock() override {}
  void draw_unlock() override {}
 
  bool test_break() override
  {
    return false;
  }
 
  bool prepare_viewlayer(struct ViewLayer * /*view_layer*/,
                         struct Depsgraph * /*depsgraph*/) override
  {
    return true;
  }
};
 
struct Render : public BaseRender {
  /* NOTE: Currently unused, provision for the future.
   * Add these now to allow the guarded memory allocator to catch C-specific function calls. */
  Render() = default;
  virtual ~Render();
 
  blender::render::TilesHighlight *get_tile_highlight() override
  {
    return &tile_highlight;
  }
 
  void compositor_execute(const Scene &scene,
                          const RenderData &render_data,
                          const bNodeTree &node_tree,
                          const char *view_name,
                          blender::realtime_compositor::RenderContext *render_context,
                          blender::realtime_compositor::Profiler *profiler) override;
  void compositor_free() override;
 
  void display_init(RenderResult *render_result) override;
  void display_clear(RenderResult *render_result) override;
  void display_update(RenderResult *render_result, rcti *rect) override;
  void current_scene_update(struct Scene *scene) override;
 
  void stats_draw(RenderStats *render_stats) override;
  void progress(float progress) override;
 
  void draw_lock() override;
  void draw_unlock() override;
 
  bool test_break() override;
 
  bool prepare_viewlayer(struct ViewLayer *view_layer, struct Depsgraph *depsgraph) override;
 
  char name[RE_MAXNAME] = "";
 
  /* state settings */
  short flag = 0;
  bool ok = false;
 
  /* if render with single-layer option, other rendered layers are stored here */
  RenderResult *pushedresult = nullptr;
  ListBase fullresult = {nullptr, nullptr};
  /* True if result has GPU textures, to quickly skip cache clear. */
  bool result_has_gpu_texture_caches = false;
 
  int winx = 0, winy = 0;
  rcti disprect = {0, 0, 0, 0};  /* part within winx winy */
  rctf viewplane = {0, 0, 0, 0}; /* mapped on winx winy */
 
  /* final picture width and height (within disprect) */
  int rectx = 0, recty = 0;
 
  /* Camera transform. Used by Freestyle, Eevee, and other draw manager engines.. */
  float winmat[4][4] = {{0}};
 
  /* Clipping. */
  float clip_start = 0.0f;
  float clip_end = 0.0f;
 
  /* main, scene, and its full copy of renderdata and world */
  struct Main *main = nullptr;
  Scene *scene = nullptr;
  RenderData r = {};
  char single_view_layer[MAX_NAME] = "";
  struct Object *camera_override = nullptr;
 
  blender::render::TilesHighlight tile_highlight;
 
  /* NOTE: This is a minimal dependency graph and evaluated scene which is enough to access view
   * layer visibility and use for postprocessing (compositor and sequencer). */
  struct Depsgraph *pipeline_depsgraph = nullptr;
  Scene *pipeline_scene_eval = nullptr;
 
  /* Realtime Compositor.
   * NOTE: Use bare pointer instead of smart pointer because the RealtimeCompositor is a fully
   * opaque type. */
  blender::render::RealtimeCompositor *compositor = nullptr;
  std::mutex compositor_mutex;
 
  /* Callbacks for the corresponding base class method implementation. */
  void (*display_init_cb)(void *handle, RenderResult *rr) = nullptr;
  void *dih = nullptr;
  void (*display_clear_cb)(void *handle, RenderResult *rr) = nullptr;
  void *dch = nullptr;
  void (*display_update_cb)(void *handle, RenderResult *rr, rcti *rect) = nullptr;
  void *duh = nullptr;
  void (*current_scene_update_cb)(void *handle, struct Scene *scene) = nullptr;
  void *suh = nullptr;
 
  void (*stats_draw_cb)(void *handle, RenderStats *ri) = nullptr;
  void *sdh = nullptr;
  void (*progress_cb)(void *handle, float i) = nullptr;
  void *prh = nullptr;
 
  void (*draw_lock_cb)(void *handle, bool lock) = nullptr;
  void *dlh = nullptr;
  bool (*test_break_cb)(void *handle) = nullptr;
  void *tbh = nullptr;
 
  bool (*prepare_viewlayer_cb)(void *handle, struct ViewLayer *vl, struct Depsgraph *depsgraph);
  void *prepare_vl_handle;
 
  RenderStats i = {};
 
  struct ReportList *reports = nullptr;
 
  void **movie_ctx_arr = nullptr;
  char viewname[MAX_NAME] = "";
 
  /* TODO: replace by a whole draw manager. */
  void *system_gpu_context = nullptr;
  void *blender_gpu_context = nullptr;
};
 
/* **************** defines ********************* */
 
#define R_ANIMATION 1 << 0
/* Indicates that the render pipeline should not write its render result. This happens for instance
 * when the render pipeline uses the compositor, but the compositor node tree does not have an
 * output composite node or a render layer input, and consequently no render result. In that case,
 * the output will be written from the File Output nodes, since the render pipeline will early fail
 * if neither a File Output nor a Composite node exist in the scene. */
#define R_SKIP_WRITE 1 << 1