cycles/util/image.h

Go to the documentation of this file.

/* SPDX-FileCopyrightText: 2011-2022 Blender Foundation
 *
 * SPDX-License-Identifier: Apache-2.0 */
 
#ifndef __UTIL_IMAGE_H__
#  define __UTIL_IMAGE_H__
 
/* OpenImageIO is used for all image file reading and writing. */
 
#  include <OpenImageIO/imageio.h>
 
#  include "util/half.h"
#  include "util/vector.h"
 
CCL_NAMESPACE_BEGIN
 
OIIO_NAMESPACE_USING
 
template<typename T>
void util_image_resize_pixels(const vector<T> &input_pixels,
                              const size_t input_width,
                              const size_t input_height,
                              const size_t input_depth,
                              const size_t components,
                              vector<T> *output_pixels,
                              size_t *output_width,
                              size_t *output_height,
                              size_t *output_depth);
 
/* Cast input pixel from unknown storage to float. */
template<typename T> inline float util_image_cast_to_float(T value);
 
template<> inline float util_image_cast_to_float(float value)
{
  return value;
}
template<> inline float util_image_cast_to_float(uchar value)
{
  return (float)value / 255.0f;
}
template<> inline float util_image_cast_to_float(uint16_t value)
{
  return (float)value / 65535.0f;
}
template<> inline float util_image_cast_to_float(half value)
{
  return half_to_float_image(value);
}
 
/* Cast float value to output pixel type. */
template<typename T> inline T util_image_cast_from_float(float value);
 
template<> inline float util_image_cast_from_float(float value)
{
  return value;
}
template<> inline uchar util_image_cast_from_float(float value)
{
  if (value < 0.0f) {
    return 0;
  }
  else if (value > (1.0f - 0.5f / 255.0f)) {
    return 255;
  }
  return (uchar)((255.0f * value) + 0.5f);
}
template<> inline uint16_t util_image_cast_from_float(float value)
{
  if (value < 0.0f) {
    return 0;
  }
  else if (value > (1.0f - 0.5f / 65535.0f)) {
    return 65535;
  }
  return (uint16_t)((65535.0f * value) + 0.5f);
}
template<> inline half util_image_cast_from_float(float value)
{
  return float_to_half_image(value);
}
 
/* Multiply image pixels in native data format. */
template<typename T> inline T util_image_multiply_native(T a, T b);
 
template<> inline float util_image_multiply_native(float a, float b)
{
  return a * b;
}
template<> inline uchar util_image_multiply_native(uchar a, uchar b)
{
  return ((uint32_t)a * (uint32_t)b) / 255;
}
template<> inline uint16_t util_image_multiply_native(uint16_t a, uint16_t b)
{
  return ((uint32_t)a * (uint32_t)b) / 65535;
}
template<> inline half util_image_multiply_native(half a, half b)
{
  return float_to_half_image(half_to_float_image(a) * half_to_float_image(b));
}
 
CCL_NAMESPACE_END
 
#endif /* __UTIL_IMAGE_H__ */
 
#include "util/image_impl.h"