Files
test/source/blender/render/RE_texture.h
Campbell Barton e955c94ed3 License Headers: Set copyright to "Blender Authors", add AUTHORS
Listing the "Blender Foundation" as copyright holder implied the Blender
Foundation holds copyright to files which may include work from many
developers.

While keeping copyright on headers makes sense for isolated libraries,
Blender's own code may be refactored or moved between files in a way
that makes the per file copyright holders less meaningful.

Copyright references to the "Blender Foundation" have been replaced with
"Blender Authors", with the exception of `./extern/` since these this
contains libraries which are more isolated, any changed to license
headers there can be handled on a case-by-case basis.

Some directories in `./intern/` have also been excluded:

- `./intern/cycles/` it's own `AUTHORS` file is planned.
- `./intern/opensubdiv/`.

An "AUTHORS" file has been added, using the chromium projects authors
file as a template.

Design task: #110784

Ref !110783.
2023-08-16 00:20:26 +10:00

146 lines
4.0 KiB
C

/* SPDX-FileCopyrightText: 2006 Blender Authors
*
* SPDX-License-Identifier: GPL-2.0-or-later */
/** \file
* \ingroup render
*
* This include is for non-render pipeline exports (still old cruft here).
*/
#pragma once
#include "BLI_compiler_attrs.h"
/* called by meshtools */
struct Depsgraph;
struct ImagePool;
struct MTex;
struct Tex;
#ifdef __cplusplus
extern "C" {
#endif
/* `texture_procedural.cc` */
/**
* \param pool: Thread pool, may be NULL.
*
* \return True if the texture has color, otherwise false.
*/
bool RE_texture_evaluate(const struct MTex *mtex,
const float vec[3],
int thread,
struct ImagePool *pool,
bool skip_load_image,
bool texnode_preview,
/* Return arguments. */
float *r_intensity,
float r_rgba[4]) ATTR_NONNULL(1, 2, 7, 8);
/**
* \param in: Destination
* \param tex: Texture.
* \param out: Previous color.
* \param fact: Texture strength.
* \param facg: Button strength value.
*/
float texture_value_blend(float tex, float out, float fact, float facg, int blendtype);
void RE_texture_rng_init(void);
void RE_texture_rng_exit(void);
/* `texture_image.cc` */
void ibuf_sample(struct ImBuf *ibuf, float fx, float fy, float dx, float dy, float result[4]);
/* `texture_pointdensity.cc` */
struct PointDensity;
void RE_point_density_cache(struct Depsgraph *depsgraph, struct PointDensity *pd);
void RE_point_density_minmax(struct Depsgraph *depsgraph,
struct PointDensity *pd,
float r_min[3],
float r_max[3]);
/**
* \note Requires #RE_point_density_cache() to be called first.
* \note Frees point density structure after sampling.
*/
void RE_point_density_sample(struct Depsgraph *depsgraph,
struct PointDensity *pd,
int resolution,
float *values);
void RE_point_density_free(struct PointDensity *pd);
void RE_point_density_fix_linking(void);
/* `texture_procedural.cc` */
/**
* Texture evaluation result.
*/
typedef struct TexResult {
float tin;
float trgba[4];
/* Is actually a boolean: When true -> use alpha, false -> set alpha to 1.0. */
int talpha;
} TexResult;
/* This one uses nodes. */
/**
* \warning if the texres's values are not declared zero,
* check the return value to be sure the color values are set before using the r/g/b values,
* otherwise you may use uninitialized values - Campbell
*
* Use it for stuff which is out of render pipeline.
*/
int multitex_ext(struct Tex *tex,
const float texvec[3],
float dxt[3],
float dyt[3],
int osatex,
struct TexResult *texres,
short thread,
struct ImagePool *pool,
bool scene_color_manage,
bool skip_load_image);
/**
* Nodes disabled.
* extern-tex doesn't support nodes (#ntreeBeginExec() can't be called when rendering is going on).
*
* Use it for stuff which is out of render pipeline.
*/
int multitex_ext_safe(struct Tex *tex,
const float texvec[3],
struct TexResult *texres,
struct ImagePool *pool,
bool scene_color_manage,
bool skip_load_image);
/**
* Only for internal node usage.
*
* this is called from the shader and texture nodes
* Use it from render pipeline only!
*/
int multitex_nodes(struct Tex *tex,
const float texvec[3],
float dxt[3],
float dyt[3],
int osatex,
struct TexResult *texres,
short thread,
short which_output,
const struct MTex *mtex,
struct ImagePool *pool);
#ifdef __cplusplus
}
#endif