Brecht Van Lommel
7ad802cf3a
Cycles now uses the color space on the image datablock, and uses OpenColorIO to convert to scene linear as needed. Byte images do not take extra memory, they are compressed in scene linear + sRGB transfer function which in common cases is a no-op. Eevee and workbench were changed to work similar. Float images are stored as scene linear. Byte images are compressed as scene linear + sRGB and stored in a GL_SRGB8_ALPHA8 texture. From the GLSL shader side this means they are read as scene linear, simplifying the code and taking advantage of hardware support. Further, OpenGL image textures are now all stored with premultiplied alpha. Eevee texture sampling looks a little different now because interpolation happens premultiplied and in scene linear space. Overlays and grease pencil work in sRGB space so those now have an extra conversion to sRGB after reading from image textures. This is not particularly elegant but as long as engines use different conventions, one or the other needs to do conversion. This change breaks compatibility for cases where multiple image texture nodes were using the same image with different color space node settings. However it gives more predictable behavior for baking and texture painting if save, load and image editing operations have a single color space to handle. Differential Revision: https://developer.blender.org/D4807
230 lines
9.7 KiB
C
230 lines
9.7 KiB
C
/*
|
|
* 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) 2012 Blender Foundation.
|
|
* All rights reserved.
|
|
*/
|
|
|
|
#ifndef __OCIO_CAPI_H__
|
|
#define __OCIO_CAPI_H__
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
struct OCIO_GLSLDrawState;
|
|
|
|
#define OCIO_DECLARE_HANDLE(name) \
|
|
typedef struct name##__ { \
|
|
int unused; \
|
|
} * name
|
|
|
|
#define OCIO_ROLE_DATA "data"
|
|
#define OCIO_ROLE_SCENE_LINEAR "scene_linear"
|
|
#define OCIO_ROLE_COLOR_PICKING "color_picking"
|
|
#define OCIO_ROLE_TEXTURE_PAINT "texture_paint"
|
|
#define OCIO_ROLE_DEFAULT_BYTE "default_byte"
|
|
#define OCIO_ROLE_DEFAULT_FLOAT "default_float"
|
|
#define OCIO_ROLE_DEFAULT_SEQUENCER "default_sequencer"
|
|
|
|
OCIO_DECLARE_HANDLE(OCIO_ConstConfigRcPtr);
|
|
OCIO_DECLARE_HANDLE(OCIO_ConstColorSpaceRcPtr);
|
|
OCIO_DECLARE_HANDLE(OCIO_ConstProcessorRcPtr);
|
|
OCIO_DECLARE_HANDLE(OCIO_ConstContextRcPtr);
|
|
OCIO_DECLARE_HANDLE(OCIO_PackedImageDesc);
|
|
OCIO_DECLARE_HANDLE(OCIO_DisplayTransformRcPtr);
|
|
OCIO_DECLARE_HANDLE(OCIO_ConstTransformRcPtr);
|
|
OCIO_DECLARE_HANDLE(OCIO_ExponentTransformRcPtr);
|
|
OCIO_DECLARE_HANDLE(OCIO_MatrixTransformRcPtr);
|
|
OCIO_DECLARE_HANDLE(OCIO_ConstLookRcPtr);
|
|
|
|
/* Standard XYZ to linear sRGB transform, for fallback. */
|
|
static const float OCIO_XYZ_TO_LINEAR_SRGB[3][3] = {{3.2404542f, -0.9692660f, 0.0556434f},
|
|
{-1.5371385f, 1.8760108f, -0.2040259f},
|
|
{-0.4985314f, 0.0415560f, 1.0572252f}};
|
|
|
|
/* This structure is used to pass curve mapping settings from
|
|
* blender's DNA structure stored in view transform settings
|
|
* to a generic OpenColorIO C-API.
|
|
*/
|
|
typedef struct OCIO_CurveMappingSettings {
|
|
/* This is a LUT which contain values for all 4 curve mapping tables
|
|
* (combined, R, G and B).
|
|
*
|
|
* Element I for table T is stored at I * 4 + T element of this LUT.
|
|
*
|
|
* This array is usually returned by curvemapping_table_RGBA().
|
|
*/
|
|
float *lut;
|
|
|
|
/* Size of single curve mapping table, 1/4 size of lut array. */
|
|
int lut_size;
|
|
|
|
/* Extend extrapolation flags for all the tables.
|
|
* if use_extend_extrapolate[T] != 0 means extrapolation for
|
|
* table T is needed.
|
|
*/
|
|
int use_extend_extrapolate[4];
|
|
|
|
/* Minimal X value of the curve mapping tables. */
|
|
float mintable[4];
|
|
|
|
/* Per curve mapping table range. */
|
|
float range[4];
|
|
|
|
/* Lower extension value, stored as per-component arrays. */
|
|
float ext_in_x[4], ext_in_y[4];
|
|
|
|
/* Higher extension value, stored as per-component arrays. */
|
|
float ext_out_x[4], ext_out_y[4];
|
|
|
|
/* First points of the tables, both X and Y values.
|
|
* Needed for easier and faster access when extrapolating.
|
|
*/
|
|
float first_x[4], first_y[4];
|
|
|
|
/* Last points of the tables, both X and Y values.
|
|
* Needed for easier and faster access when extrapolating.
|
|
*/
|
|
float last_x[4], last_y[4];
|
|
|
|
/* Premultiplication settings: black level and scale to match
|
|
* with white level.
|
|
*/
|
|
float black[3], bwmul[3];
|
|
|
|
/* Cache id of the original curve mapping, used to detect when
|
|
* upload of new settings to GPU is needed.
|
|
*/
|
|
size_t cache_id;
|
|
} OCIO_CurveMappingSettings;
|
|
|
|
void OCIO_init(void);
|
|
void OCIO_exit(void);
|
|
|
|
OCIO_ConstConfigRcPtr *OCIO_getCurrentConfig(void);
|
|
void OCIO_setCurrentConfig(const OCIO_ConstConfigRcPtr *config);
|
|
|
|
OCIO_ConstConfigRcPtr *OCIO_configCreateFromEnv(void);
|
|
OCIO_ConstConfigRcPtr *OCIO_configCreateFromFile(const char *filename);
|
|
OCIO_ConstConfigRcPtr *OCIO_configCreateFallback(void);
|
|
|
|
void OCIO_configRelease(OCIO_ConstConfigRcPtr *config);
|
|
|
|
int OCIO_configGetNumColorSpaces(OCIO_ConstConfigRcPtr *config);
|
|
const char *OCIO_configGetColorSpaceNameByIndex(OCIO_ConstConfigRcPtr *config, int index);
|
|
OCIO_ConstColorSpaceRcPtr *OCIO_configGetColorSpace(OCIO_ConstConfigRcPtr *config,
|
|
const char *name);
|
|
int OCIO_configGetIndexForColorSpace(OCIO_ConstConfigRcPtr *config, const char *name);
|
|
|
|
int OCIO_colorSpaceIsInvertible(OCIO_ConstColorSpaceRcPtr *cs);
|
|
int OCIO_colorSpaceIsData(OCIO_ConstColorSpaceRcPtr *cs);
|
|
void OCIO_colorSpaceIsBuiltin(OCIO_ConstConfigRcPtr *config,
|
|
OCIO_ConstColorSpaceRcPtr *cs,
|
|
bool *is_scene_linear,
|
|
bool *is_srgb);
|
|
|
|
void OCIO_colorSpaceRelease(OCIO_ConstColorSpaceRcPtr *cs);
|
|
|
|
const char *OCIO_configGetDefaultDisplay(OCIO_ConstConfigRcPtr *config);
|
|
int OCIO_configGetNumDisplays(OCIO_ConstConfigRcPtr *config);
|
|
const char *OCIO_configGetDisplay(OCIO_ConstConfigRcPtr *config, int index);
|
|
const char *OCIO_configGetDefaultView(OCIO_ConstConfigRcPtr *config, const char *display);
|
|
int OCIO_configGetNumViews(OCIO_ConstConfigRcPtr *config, const char *display);
|
|
const char *OCIO_configGetView(OCIO_ConstConfigRcPtr *config, const char *display, int index);
|
|
const char *OCIO_configGetDisplayColorSpaceName(OCIO_ConstConfigRcPtr *config,
|
|
const char *display,
|
|
const char *view);
|
|
|
|
void OCIO_configGetDefaultLumaCoefs(OCIO_ConstConfigRcPtr *config, float *rgb);
|
|
void OCIO_configGetXYZtoRGB(OCIO_ConstConfigRcPtr *config, float xyz_to_rgb[3][3]);
|
|
|
|
int OCIO_configGetNumLooks(OCIO_ConstConfigRcPtr *config);
|
|
const char *OCIO_configGetLookNameByIndex(OCIO_ConstConfigRcPtr *config, int index);
|
|
OCIO_ConstLookRcPtr *OCIO_configGetLook(OCIO_ConstConfigRcPtr *config, const char *name);
|
|
|
|
const char *OCIO_lookGetProcessSpace(OCIO_ConstLookRcPtr *look);
|
|
void OCIO_lookRelease(OCIO_ConstLookRcPtr *look);
|
|
|
|
OCIO_ConstProcessorRcPtr *OCIO_configGetProcessorWithNames(OCIO_ConstConfigRcPtr *config,
|
|
const char *srcName,
|
|
const char *dstName);
|
|
OCIO_ConstProcessorRcPtr *OCIO_configGetProcessor(OCIO_ConstConfigRcPtr *config,
|
|
OCIO_ConstTransformRcPtr *transform);
|
|
|
|
void OCIO_processorApply(OCIO_ConstProcessorRcPtr *processor, OCIO_PackedImageDesc *img);
|
|
void OCIO_processorApply_predivide(OCIO_ConstProcessorRcPtr *processor, OCIO_PackedImageDesc *img);
|
|
void OCIO_processorApplyRGB(OCIO_ConstProcessorRcPtr *processor, float *pixel);
|
|
void OCIO_processorApplyRGBA(OCIO_ConstProcessorRcPtr *processor, float *pixel);
|
|
void OCIO_processorApplyRGBA_predivide(OCIO_ConstProcessorRcPtr *processor, float *pixel);
|
|
|
|
void OCIO_processorRelease(OCIO_ConstProcessorRcPtr *p);
|
|
|
|
const char *OCIO_colorSpaceGetName(OCIO_ConstColorSpaceRcPtr *cs);
|
|
const char *OCIO_colorSpaceGetDescription(OCIO_ConstColorSpaceRcPtr *cs);
|
|
const char *OCIO_colorSpaceGetFamily(OCIO_ConstColorSpaceRcPtr *cs);
|
|
|
|
OCIO_DisplayTransformRcPtr *OCIO_createDisplayTransform(void);
|
|
void OCIO_displayTransformSetInputColorSpaceName(OCIO_DisplayTransformRcPtr *dt, const char *name);
|
|
void OCIO_displayTransformSetDisplay(OCIO_DisplayTransformRcPtr *dt, const char *name);
|
|
void OCIO_displayTransformSetView(OCIO_DisplayTransformRcPtr *dt, const char *name);
|
|
void OCIO_displayTransformSetDisplayCC(OCIO_DisplayTransformRcPtr *dt,
|
|
OCIO_ConstTransformRcPtr *et);
|
|
void OCIO_displayTransformSetLinearCC(OCIO_DisplayTransformRcPtr *dt,
|
|
OCIO_ConstTransformRcPtr *et);
|
|
void OCIO_displayTransformSetLooksOverride(OCIO_DisplayTransformRcPtr *dt, const char *looks);
|
|
void OCIO_displayTransformSetLooksOverrideEnabled(OCIO_DisplayTransformRcPtr *dt, bool enabled);
|
|
void OCIO_displayTransformRelease(OCIO_DisplayTransformRcPtr *dt);
|
|
|
|
OCIO_PackedImageDesc *OCIO_createOCIO_PackedImageDesc(float *data,
|
|
long width,
|
|
long height,
|
|
long numChannels,
|
|
long chanStrideBytes,
|
|
long xStrideBytes,
|
|
long yStrideBytes);
|
|
|
|
void OCIO_PackedImageDescRelease(OCIO_PackedImageDesc *p);
|
|
|
|
OCIO_ExponentTransformRcPtr *OCIO_createExponentTransform(void);
|
|
void OCIO_exponentTransformSetValue(OCIO_ExponentTransformRcPtr *et, const float *exponent);
|
|
void OCIO_exponentTransformRelease(OCIO_ExponentTransformRcPtr *et);
|
|
|
|
OCIO_MatrixTransformRcPtr *OCIO_createMatrixTransform(void);
|
|
void OCIO_matrixTransformSetValue(OCIO_MatrixTransformRcPtr *mt,
|
|
const float *m44,
|
|
const float *offset4);
|
|
void OCIO_matrixTransformRelease(OCIO_MatrixTransformRcPtr *mt);
|
|
|
|
void OCIO_matrixTransformScale(float *m44, float *offset4, const float *scale4);
|
|
|
|
int OCIO_supportGLSLDraw(void);
|
|
int OCIO_setupGLSLDraw(struct OCIO_GLSLDrawState **state_r,
|
|
OCIO_ConstProcessorRcPtr *processor,
|
|
OCIO_CurveMappingSettings *curve_mapping_settings,
|
|
float dither,
|
|
bool predivide);
|
|
void OCIO_finishGLSLDraw(struct OCIO_GLSLDrawState *state);
|
|
void OCIO_freeOGLState(struct OCIO_GLSLDrawState *state);
|
|
|
|
const char *OCIO_getVersionString(void);
|
|
int OCIO_getVersionHex(void);
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
#endif /* OCIO_CAPI_H */
|