241 lines
9.7 KiB
C
241 lines
9.7 KiB
C
/* SPDX-FileCopyrightText: 2006 Blender Authors
|
|
*
|
|
* SPDX-License-Identifier: GPL-2.0-or-later */
|
|
#pragma once
|
|
|
|
/** \file
|
|
* \ingroup bke
|
|
*/
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
struct BlendDataReader;
|
|
struct BlendWriter;
|
|
struct ColorManagedColorspaceSettings;
|
|
struct ColorManagedDisplaySettings;
|
|
struct ColorManagedViewSettings;
|
|
struct CurveMap;
|
|
struct CurveMapPoint;
|
|
struct CurveMapping;
|
|
struct Histogram;
|
|
struct ImBuf;
|
|
struct Scopes;
|
|
struct rctf;
|
|
|
|
void BKE_curvemapping_set_defaults(struct CurveMapping *cumap,
|
|
int tot,
|
|
float minx,
|
|
float miny,
|
|
float maxx,
|
|
float maxy,
|
|
short default_handle_type);
|
|
struct CurveMapping *BKE_curvemapping_add(int tot, float minx, float miny, float maxx, float maxy);
|
|
void BKE_curvemapping_free_data(struct CurveMapping *cumap);
|
|
void BKE_curvemapping_free(struct CurveMapping *cumap);
|
|
void BKE_curvemapping_copy_data(struct CurveMapping *target, const struct CurveMapping *cumap);
|
|
struct CurveMapping *BKE_curvemapping_copy(const struct CurveMapping *cumap);
|
|
void BKE_curvemapping_set_black_white_ex(const float black[3],
|
|
const float white[3],
|
|
float r_bwmul[3]);
|
|
void BKE_curvemapping_set_black_white(struct CurveMapping *cumap,
|
|
const float black[3],
|
|
const float white[3]);
|
|
|
|
enum {
|
|
CURVEMAP_SLOPE_NEGATIVE = 0,
|
|
CURVEMAP_SLOPE_POSITIVE = 1,
|
|
CURVEMAP_SLOPE_POS_NEG = 2,
|
|
};
|
|
|
|
/**
|
|
* Reset the view for current curve.
|
|
*/
|
|
void BKE_curvemapping_reset_view(struct CurveMapping *cumap);
|
|
void BKE_curvemap_reset(struct CurveMap *cuma, const struct rctf *clipr, int preset, int slope);
|
|
/**
|
|
* Removes with flag set.
|
|
*/
|
|
void BKE_curvemap_remove(struct CurveMap *cuma, short flag);
|
|
/**
|
|
* Remove specified point.
|
|
*/
|
|
bool BKE_curvemap_remove_point(struct CurveMap *cuma, struct CurveMapPoint *cmp);
|
|
struct CurveMapPoint *BKE_curvemap_insert(struct CurveMap *cuma, float x, float y);
|
|
/**
|
|
* \param type: #eBezTriple_Handle
|
|
*/
|
|
void BKE_curvemap_handle_set(struct CurveMap *cuma, int type);
|
|
|
|
/**
|
|
* \note only does current curvemap!.
|
|
*/
|
|
void BKE_curvemapping_changed(struct CurveMapping *cumap, bool rem_doubles);
|
|
void BKE_curvemapping_changed_all(struct CurveMapping *cumap);
|
|
|
|
/**
|
|
* Call before _all_ evaluation functions.
|
|
*/
|
|
void BKE_curvemapping_init(struct CurveMapping *cumap);
|
|
|
|
/**
|
|
* Keep these `const CurveMap` - to help with thread safety.
|
|
* \note Single curve, no table check.
|
|
* \note Table should be verified.
|
|
*/
|
|
float BKE_curvemap_evaluateF(const struct CurveMapping *cumap,
|
|
const struct CurveMap *cuma,
|
|
float value);
|
|
/**
|
|
* Single curve, with table check.
|
|
* Works with curve 'cur'.
|
|
*/
|
|
float BKE_curvemapping_evaluateF(const struct CurveMapping *cumap, int cur, float value);
|
|
/**
|
|
* Vector case.
|
|
*/
|
|
void BKE_curvemapping_evaluate3F(const struct CurveMapping *cumap,
|
|
float vecout[3],
|
|
const float vecin[3]);
|
|
/**
|
|
* RGB case, no black/white points, no pre-multiply.
|
|
*/
|
|
void BKE_curvemapping_evaluateRGBF(const struct CurveMapping *cumap,
|
|
float vecout[3],
|
|
const float vecin[3]);
|
|
/**
|
|
* Byte version of #BKE_curvemapping_evaluateRGBF.
|
|
*/
|
|
void BKE_curvemapping_evaluate_premulRGB(const struct CurveMapping *cumap,
|
|
unsigned char vecout_byte[3],
|
|
const unsigned char vecin_byte[3]);
|
|
/**
|
|
* Same as #BKE_curvemapping_evaluate_premulRGBF
|
|
* but black/bwmul are passed as args for the compositor
|
|
* where they can change per pixel.
|
|
*
|
|
* Use in conjunction with #BKE_curvemapping_set_black_white_ex
|
|
*
|
|
* \param black: Use instead of cumap->black
|
|
* \param bwmul: Use instead of cumap->bwmul
|
|
*/
|
|
void BKE_curvemapping_evaluate_premulRGBF_ex(const struct CurveMapping *cumap,
|
|
float vecout[3],
|
|
const float vecin[3],
|
|
const float black[3],
|
|
const float bwmul[3]);
|
|
/**
|
|
* RGB with black/white points and pre-multiply. tables are checked.
|
|
*/
|
|
void BKE_curvemapping_evaluate_premulRGBF(const struct CurveMapping *cumap,
|
|
float vecout[3],
|
|
const float vecin[3]);
|
|
bool BKE_curvemapping_RGBA_does_something(const struct CurveMapping *cumap);
|
|
void BKE_curvemapping_table_F(const struct CurveMapping *cumap, float **array, int *size);
|
|
void BKE_curvemapping_table_RGBA(const struct CurveMapping *cumap, float **array, int *size);
|
|
|
|
/** Get the minimum x value of each curve map table. */
|
|
void BKE_curvemapping_get_range_minimums(const struct CurveMapping *curve_mapping,
|
|
float minimums[4]);
|
|
|
|
/**
|
|
* Get the reciprocal of the difference between the maximum and the minimum x value of each curve
|
|
* map table. Evaluation parameters can be multiplied by this value to be normalized. If the
|
|
* difference is zero, 1^8 is returned.
|
|
*/
|
|
void BKE_curvemapping_compute_range_dividers(const struct CurveMapping *curve_mapping,
|
|
float dividers[4]);
|
|
|
|
/**
|
|
* Compute the slopes at the start and end points of each curve map. The slopes are multiplied by
|
|
* the range of the curve map to compensate for parameter normalization. If the slope is vertical,
|
|
* 1^8 is returned.
|
|
*/
|
|
void BKE_curvemapping_compute_slopes(const struct CurveMapping *curve_mapping,
|
|
float start_slopes[4],
|
|
float end_slopes[4]);
|
|
|
|
/**
|
|
* Check if the curve map at the index is identity, that is, does nothing.
|
|
* A curve map is said to be identity if:
|
|
* - The curve mapping uses extrapolation.
|
|
* - Its range is 1.
|
|
* - The slope at its start point is 1.
|
|
* - The slope at its end point is 1.
|
|
* - The number of points is 2.
|
|
* - The start point is at (0, 0).
|
|
* - The end point is at (1, 1).
|
|
* Note that this could return false even if the curve map is identity, this happens in the case
|
|
* when more than 2 points exist in the curve map but all points are collinear. */
|
|
bool BKE_curvemapping_is_map_identity(const struct CurveMapping *curve_mapping, int index);
|
|
|
|
/**
|
|
* Call when you do images etc, needs restore too. also verifies tables.
|
|
* non-const (these modify the curve).
|
|
*/
|
|
void BKE_curvemapping_premultiply(struct CurveMapping *cumap, bool restore);
|
|
|
|
void BKE_curvemapping_blend_write(struct BlendWriter *writer, const struct CurveMapping *cumap);
|
|
void BKE_curvemapping_curves_blend_write(struct BlendWriter *writer,
|
|
const struct CurveMapping *cumap);
|
|
/**
|
|
* \note `cumap` itself has been read already.
|
|
*/
|
|
void BKE_curvemapping_blend_read(struct BlendDataReader *reader, struct CurveMapping *cumap);
|
|
|
|
void BKE_histogram_update_sample_line(struct Histogram *hist,
|
|
struct ImBuf *ibuf,
|
|
const struct ColorManagedViewSettings *view_settings,
|
|
const struct ColorManagedDisplaySettings *display_settings);
|
|
void BKE_scopes_update(struct Scopes *scopes,
|
|
struct ImBuf *ibuf,
|
|
const struct ColorManagedViewSettings *view_settings,
|
|
const struct ColorManagedDisplaySettings *display_settings);
|
|
void BKE_scopes_free(struct Scopes *scopes);
|
|
void BKE_scopes_new(struct Scopes *scopes);
|
|
|
|
void BKE_color_managed_display_settings_init(struct ColorManagedDisplaySettings *settings);
|
|
void BKE_color_managed_display_settings_copy(struct ColorManagedDisplaySettings *new_settings,
|
|
const struct ColorManagedDisplaySettings *settings);
|
|
|
|
/**
|
|
* Initialize view settings to be best suitable for render type of viewing.
|
|
* This will use default view transform from the OCIO configuration if none
|
|
* is specified.
|
|
*/
|
|
void BKE_color_managed_view_settings_init_render(
|
|
struct ColorManagedViewSettings *settings,
|
|
const struct ColorManagedDisplaySettings *display_settings,
|
|
const char *view_transform);
|
|
|
|
/**
|
|
* Initialize view settings which are best suitable for viewing non-render images.
|
|
* For example,s movie clips while tracking.
|
|
*/
|
|
void BKE_color_managed_view_settings_init_default(
|
|
struct ColorManagedViewSettings *settings,
|
|
const struct ColorManagedDisplaySettings *display_settings);
|
|
|
|
void BKE_color_managed_view_settings_copy(struct ColorManagedViewSettings *new_settings,
|
|
const struct ColorManagedViewSettings *settings);
|
|
void BKE_color_managed_view_settings_free(struct ColorManagedViewSettings *settings);
|
|
|
|
void BKE_color_managed_view_settings_blend_write(struct BlendWriter *writer,
|
|
struct ColorManagedViewSettings *settings);
|
|
void BKE_color_managed_view_settings_blend_read_data(struct BlendDataReader *reader,
|
|
struct ColorManagedViewSettings *settings);
|
|
|
|
void BKE_color_managed_colorspace_settings_init(
|
|
struct ColorManagedColorspaceSettings *colorspace_settings);
|
|
void BKE_color_managed_colorspace_settings_copy(
|
|
struct ColorManagedColorspaceSettings *colorspace_settings,
|
|
const struct ColorManagedColorspaceSettings *settings);
|
|
bool BKE_color_managed_colorspace_settings_equals(
|
|
const struct ColorManagedColorspaceSettings *settings1,
|
|
const struct ColorManagedColorspaceSettings *settings2);
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|