render_types.h

Go to the documentation of this file.

/*
 * 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) 2001-2002 by NaN Holding BV.
 * All rights reserved.
 */
 
#pragma once
 
/* ------------------------------------------------------------------------- */
/* exposed internal in render module only! */
/* ------------------------------------------------------------------------- */
 
#include "DNA_object_types.h"
#include "DNA_scene_types.h"
 
#include "BLI_threads.h"
 
#include "BKE_main.h"
 
#include "RE_pipeline.h"
 
struct GHash;
struct Main;
struct Object;
struct RenderEngine;
struct ReportList;
 
#ifdef __cplusplus
extern "C" {
#endif
 
/* this is handed over to threaded hiding/passes/shading engine */
typedef struct RenderPart {
  struct RenderPart *next, *prev;
 
  RenderResult *result; /* result of part rendering */
  ListBase fullresult;  /* optional full sample buffers */
 
  rcti disprect;    /* part coordinates within total picture */
  int rectx, recty; /* the size */
  int nr;           /* nr is partnr */
  short status;
} RenderPart;
 
enum {
  /* PART_STATUS_NONE = 0, */ /* UNUSED */
  PART_STATUS_IN_PROGRESS = 1,
  PART_STATUS_RENDERED = 2,
  PART_STATUS_MERGED = 3,
};
 
/* controls state of render, everything that's read-only during render stage */
struct Render {
  struct Render *next, *prev;
  char name[RE_MAXNAME];
  int slot;
 
  /* state settings */
  short flag, ok, result_ok;
 
  /* result of rendering */
  RenderResult *result;
  /* if render with single-layer option, other rendered layers are stored here */
  RenderResult *pushedresult;
  ListBase fullresult;
  /* read/write mutex, all internal code that writes to re->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;
 
  int winx, winy;
  rcti disprect;  /* part within winx winy */
  rctf viewplane; /* mapped on winx winy */
 
  /* final picture width and height (within disprect) */
  int rectx, recty;
 
  /* real maximum size of parts after correction for minimum
   * partx*xparts can be larger than rectx, in that case last part is smaller */
  int partx, party;
 
  /* Camera transform, only used by Freestyle. */
  float winmat[4][4];
 
  /* Clipping. */
  float clip_start;
  float clip_end;
 
  /* main, scene, and its full copy of renderdata and world */
  struct Main *main;
  Scene *scene;
  RenderData r;
  ListBase view_layers;
  int active_view_layer;
  struct Object *camera_override;
 
  ThreadRWMutex partsmutex;
  struct GHash *parts;
 
  /* render engine */
  struct RenderEngine *engine;
 
  /* NOTE: This is a minimal dependency graph and evaluated scene which is enough to access view
   * layer visibility and use for post-precessing (compositor and sequencer). */
  Depsgraph *pipeline_depsgraph;
  Scene *pipeline_scene_eval;
 
  /* callbacks */
  void (*display_init)(void *handle, RenderResult *rr);
  void *dih;
  void (*display_clear)(void *handle, RenderResult *rr);
  void *dch;
  void (*display_update)(void *handle, RenderResult *rr, volatile rcti *rect);
  void *duh;
  void (*current_scene_update)(void *handle, struct Scene *scene);
  void *suh;
 
  void (*stats_draw)(void *handle, RenderStats *ri);
  void *sdh;
  void (*progress)(void *handle, float i);
  void *prh;
 
  void (*draw_lock)(void *handle, bool lock);
  void *dlh;
  int (*test_break)(void *handle);
  void *tbh;
 
  RenderStats i;
 
  struct ReportList *reports;
 
  void **movie_ctx_arr;
  char viewname[MAX_NAME];
 
  /* TODO replace by a whole draw manager. */
  void *gl_context;
  void *gpu_context;
};
 
/* **************** defines ********************* */
 
/* R.flag */
#define R_ANIMATION 1
 
#ifdef __cplusplus
}
#endif