diff options
author | Campbell Barton <ideasman42@gmail.com> | 2021-12-09 12:01:45 +0300 |
---|---|---|
committer | Campbell Barton <ideasman42@gmail.com> | 2021-12-09 12:01:45 +0300 |
commit | 9f546d690899e05b25a6ef764cc8cf2f5db918b0 (patch) | |
tree | 77aa93445966f396a737e630e9a52b84a3b3d7e3 /source/blender/imbuf/intern/colormanagement.c | |
parent | 9e365069afe156f33fadfad9705e1325f894cd54 (diff) |
Cleanup: move public doc-strings into headers for 'imbuf'
Ref T92709
Diffstat (limited to 'source/blender/imbuf/intern/colormanagement.c')
-rw-r--r-- | source/blender/imbuf/intern/colormanagement.c | 59 |
1 files changed, 0 insertions, 59 deletions
diff --git a/source/blender/imbuf/intern/colormanagement.c b/source/blender/imbuf/intern/colormanagement.c index c8c6f39507f..6e9e5dd3ddb 100644 --- a/source/blender/imbuf/intern/colormanagement.c +++ b/source/blender/imbuf/intern/colormanagement.c @@ -1968,7 +1968,6 @@ static void colormanagement_transform_ex(unsigned char *byte_buffer, IMB_colormanagement_processor_free(cm_processor); } -/* convert the whole buffer from specified by name color space to another */ void IMB_colormanagement_transform(float *buffer, int width, int height, @@ -1981,9 +1980,6 @@ void IMB_colormanagement_transform(float *buffer, NULL, buffer, width, height, channels, from_colorspace, to_colorspace, predivide, false); } -/* convert the whole buffer from specified by name color space to another - * will do threaded conversion - */ void IMB_colormanagement_transform_threaded(float *buffer, int width, int height, @@ -1996,7 +1992,6 @@ void IMB_colormanagement_transform_threaded(float *buffer, NULL, buffer, width, height, channels, from_colorspace, to_colorspace, predivide, true); } -/* Similar to functions above, but operates on byte buffer. */ void IMB_colormanagement_transform_byte(unsigned char *buffer, int width, int height, @@ -2018,7 +2013,6 @@ void IMB_colormanagement_transform_byte_threaded(unsigned char *buffer, buffer, NULL, width, height, channels, from_colorspace, to_colorspace, false, true); } -/* Similar to above, but gets float buffer from display one. */ void IMB_colormanagement_transform_from_byte(float *float_buffer, unsigned char *byte_buffer, int width, @@ -2098,9 +2092,6 @@ void IMB_colormanagement_transform_v4(float pixel[4], IMB_colormanagement_processor_free(cm_processor); } -/* convert pixel from specified by descriptor color space to scene linear - * used by performance-critical areas such as renderer and baker - */ void IMB_colormanagement_colorspace_to_scene_linear_v3(float pixel[3], ColorSpace *colorspace) { OCIO_ConstCPUProcessorRcPtr *processor; @@ -2118,7 +2109,6 @@ void IMB_colormanagement_colorspace_to_scene_linear_v3(float pixel[3], ColorSpac } } -/* same as above, but converts colors in opposite direction */ void IMB_colormanagement_scene_linear_to_colorspace_v3(float pixel[3], ColorSpace *colorspace) { OCIO_ConstCPUProcessorRcPtr *processor; @@ -2315,14 +2305,6 @@ void IMB_colormanagement_imbuf_to_float_texture(float *out_buffer, } } -/* Conversion between color picking role. Typically we would expect such a - * requirements: - * - It is approximately perceptually linear, so that the HSV numbers and - * the HSV cube/circle have an intuitive distribution. - * - It has the same gamut as the scene linear color space. - * - Color picking values 0..1 map to scene linear values in the 0..1 range, - * so that picked albedo values are energy conserving. - */ void IMB_colormanagement_scene_linear_to_color_picking_v3(float pixel[3]) { if (!global_color_picking_state.cpu_processor_to && !global_color_picking_state.failed) { @@ -2377,8 +2359,6 @@ void IMB_colormanagement_color_picking_to_scene_linear_v3(float pixel[3]) } } -/* Conversion between sRGB, for rare cases like hex color or copy/pasting - * between UI theme and scene linear colors. */ void IMB_colormanagement_scene_linear_to_srgb_v3(float pixel[3]) { mul_m3_v3(imbuf_rgb_to_xyz, pixel); @@ -2393,10 +2373,6 @@ void IMB_colormanagement_srgb_to_scene_linear_v3(float pixel[3]) mul_m3_v3(imbuf_xyz_to_rgb, pixel); } -/* convert pixel from scene linear to display space using default view - * used by performance-critical areas such as color-related widgets where we want to reduce - * amount of per-widget allocations - */ void IMB_colormanagement_scene_linear_to_display_v3(float pixel[3], ColorManagedDisplay *display) { OCIO_ConstCPUProcessorRcPtr *processor = display_from_scene_linear_processor(display); @@ -2406,7 +2382,6 @@ void IMB_colormanagement_scene_linear_to_display_v3(float pixel[3], ColorManaged } } -/* same as above, but converts color in opposite direction */ void IMB_colormanagement_display_to_scene_linear_v3(float pixel[3], ColorManagedDisplay *display) { OCIO_ConstCPUProcessorRcPtr *processor = display_to_scene_linear_processor(display); @@ -2468,17 +2443,6 @@ void IMB_colormanagement_imbuf_make_display_space( colormanagement_imbuf_make_display_space(ibuf, view_settings, display_settings, false); } -/* prepare image buffer to be saved on disk, applying color management if needed - * color management would be applied if image is saving as render result and if - * file format is not expecting float buffer to be in linear space (currently - * JPEG2000 and TIFF are such formats -- they're storing image as float but - * file itself stores applied color space). - * - * Both byte and float buffers would contain applied color space, and result's - * float_colorspace would be set to display color space. This should be checked - * in image format write callback and if float_colorspace is not NULL, no color - * space transformation should be applied on this buffer. - */ ImBuf *IMB_colormanagement_imbuf_for_write(ImBuf *ibuf, bool save_as_render, bool allocate_result, @@ -2640,7 +2604,6 @@ void IMB_colormanagement_buffer_make_display_space( /** \name Public Display Buffers Interfaces * \{ */ -/* acquire display buffer for given image buffer using specified view and display settings */ unsigned char *IMB_display_buffer_acquire(ImBuf *ibuf, const ColorManagedViewSettings *view_settings, const ColorManagedDisplaySettings *display_settings, @@ -2738,7 +2701,6 @@ unsigned char *IMB_display_buffer_acquire(ImBuf *ibuf, return display_buffer; } -/* same as IMB_display_buffer_acquire but gets view and display settings from context */ unsigned char *IMB_display_buffer_acquire_ctx(const bContext *C, ImBuf *ibuf, void **cache_handle) { ColorManagedViewSettings *view_settings; @@ -2899,7 +2861,6 @@ const char *IMB_colormanagement_display_get_default_name(void) return display->name; } -/* used by performance-critical pixel processing areas, such as color widgets */ ColorManagedDisplay *IMB_colormanagement_display_get_named(const char *name) { return colormanage_display_get_named(name); @@ -4027,19 +3988,6 @@ bool IMB_colormanagement_support_glsl_draw(const ColorManagedViewSettings *UNUSE return OCIO_supportGPUShader(); } -/** - * Configures GLSL shader for conversion from specified to - * display color space - * - * Will create appropriate OCIO processor and setup GLSL shader, - * so further 2D texture usage will use this conversion. - * - * When there's no need to apply transform on 2D textures, use - * IMB_colormanagement_finish_glsl_draw(). - * - * This is low-level function, use ED_draw_imbuf_ctx if you - * only need to display given image buffer - */ bool IMB_colormanagement_setup_glsl_draw_from_space( const ColorManagedViewSettings *view_settings, const ColorManagedDisplaySettings *display_settings, @@ -4097,7 +4045,6 @@ bool IMB_colormanagement_setup_glsl_draw_from_space( return global_gpu_state.gpu_shader_bound; } -/* Configures GLSL shader for conversion from scene linear to display space */ bool IMB_colormanagement_setup_glsl_draw(const ColorManagedViewSettings *view_settings, const ColorManagedDisplaySettings *display_settings, float dither, @@ -4107,10 +4054,6 @@ bool IMB_colormanagement_setup_glsl_draw(const ColorManagedViewSettings *view_se view_settings, display_settings, NULL, dither, predivide, false); } -/** - * Same as setup_glsl_draw_from_space, - * but color management settings are guessing from a given context. - */ bool IMB_colormanagement_setup_glsl_draw_from_space_ctx(const bContext *C, struct ColorSpace *from_colorspace, float dither, @@ -4125,13 +4068,11 @@ bool IMB_colormanagement_setup_glsl_draw_from_space_ctx(const bContext *C, view_settings, display_settings, from_colorspace, dither, predivide, false); } -/* Same as setup_glsl_draw, but color management settings are guessing from a given context */ bool IMB_colormanagement_setup_glsl_draw_ctx(const bContext *C, float dither, bool predivide) { return IMB_colormanagement_setup_glsl_draw_from_space_ctx(C, NULL, dither, predivide); } -/* Finish GLSL-based display space conversion */ void IMB_colormanagement_finish_glsl_draw(void) { if (global_gpu_state.gpu_shader_bound) { |