ImageUtils.h

#pragma once
 
#include <Foundation/Math/Rect.h>
#include <Foundation/Math/Size.h>
#include <Texture/Image/Image.h>
#include <Texture/Image/ImageEnums.h>
#include <Texture/Image/ImageFilter.h>
 
class PL_TEXTURE_DLL plImageUtils
{
public:
  static void ComputeImageDifferenceABS(const plImageView& imageA, const plImageView& imageB, plImage& out_difference);
 
  static void ComputeImageDifferenceABSRelaxed(const plImageView& imageA, const plImageView& imageB, plImage& out_difference);
 
  static plUInt32 ComputeMeanSquareError(const plImageView& differenceImage, plUInt8 uiBlockSize, plUInt32 uiOffsetx, plUInt32 uiOffsety);
 
  static plUInt32 ComputeMeanSquareError(const plImageView& differenceImage, plUInt8 uiBlockSize);
 
  static void Normalize(plImage& ref_image);
  static void Normalize(plImage& ref_image, plUInt8& ref_uiMinRgb, plUInt8& ref_uiMaxRgb, plUInt8& ref_uiMinAlpha, plUInt8& ref_uiMaxAlpha);
 
  static void ExtractAlphaChannel(const plImageView& inputImage, plImage& ref_outputImage);
 
  static void CropImage(const plImageView& input, const plVec2I32& vOffset, const plSizeU32& newsize, plImage& ref_output);
 
  static void RotateSubImage180(plImage& ref_image, plUInt32 uiMipLevel = 0, plUInt32 uiFace = 0, plUInt32 uiArrayIndex = 0);
 
  static plResult Copy(const plImageView& srcImg, const plRectU32& srcRect, plImage& ref_dstImg, const plVec3U32& vDstOffset, plUInt32 uiDstMipLevel = 0,
    plUInt32 uiDstFace = 0, plUInt32 uiDstArrayIndex = 0);
 
  static plResult ExtractLowerMipChain(const plImageView& src, plImage& ref_dst, plUInt32 uiNumMips);
 
  struct MipMapOptions
  {
    const plImageFilter* m_filter = nullptr;
 
    bool m_renormalizeNormals = false;
 
    bool m_preserveCoverage = false;
 
    float m_alphaThreshold = 0.5f;
 
    plImageAddressMode::Enum m_addressModeU = plImageAddressMode::Clamp;
 
    plImageAddressMode::Enum m_addressModeV = plImageAddressMode::Clamp;
 
    plImageAddressMode::Enum m_addressModeW = plImageAddressMode::Clamp;
 
    plColor m_borderColor = plColor::Black;
 
    plUInt32 m_numMipMaps = 0;
  };
 
  static plResult Scale(const plImageView& source, plImage& ref_target, plUInt32 uiWidth, plUInt32 uiHeight, const plImageFilter* pFilter = nullptr,
    plImageAddressMode::Enum addressModeU = plImageAddressMode::Clamp, plImageAddressMode::Enum addressModeV = plImageAddressMode::Clamp,
    const plColor& borderColor = plColor::Black);
 
  static plResult Scale3D(const plImageView& source, plImage& ref_target, plUInt32 uiWidth, plUInt32 uiHeight, plUInt32 uiDepth,
    const plImageFilter* pFilter = nullptr, plImageAddressMode::Enum addressModeU = plImageAddressMode::Clamp,
    plImageAddressMode::Enum addressModeV = plImageAddressMode::Clamp, plImageAddressMode::Enum addressModeW = plImageAddressMode::Clamp,
    const plColor& borderColor = plColor::Black);
 
  static void GenerateMipMaps(const plImageView& source, plImage& ref_target, const MipMapOptions& options);
 
  static void ReconstructNormalZ(plImage& ref_source);
 
  static void RenormalizeNormalMap(plImage& ref_image);
 
  static void AdjustRoughness(plImage& ref_roughnessMap, const plImageView& normalMap);
 
  static void ChangeExposure(plImage& ref_image, float fBias);
 
  static plResult CreateCubemapFromSingleFile(plImage& ref_dstImg, const plImageView& srcImg);
 
  static plResult CreateCubemapFrom6Files(plImage& ref_dstImg, const plImageView* pSourceImages);
 
  static plResult CreateVolumeTextureFromSingleFile(plImage& ref_dstImg, const plImageView& srcImg);
 
  static plUInt32 GetSampleIndex(plUInt32 uiNumTexels, plInt32 iIndex, plImageAddressMode::Enum addressMode, bool& out_bUseBorderColor);
 
  static plColor NearestSample(const plImageView& image, plImageAddressMode::Enum addressMode, plVec2 vUv);
 
  static plColor NearestSample(const plColor* pPixelPointer, plUInt32 uiWidth, plUInt32 uiHeight, plImageAddressMode::Enum addressMode, plVec2 vUv);
 
  static plColor BilinearSample(const plImageView& image, plImageAddressMode::Enum addressMode, plVec2 vUv);
 
  static plColor BilinearSample(const plColor* pPixelPointer, plUInt32 uiWidth, plUInt32 uiHeight, plImageAddressMode::Enum addressMode, plVec2 vUv);
 
  static plResult CopyChannel(plImage& ref_dstImg, plUInt8 uiDstChannelIdx, const plImage& srcImg, plUInt8 uiSrcChannelIdx);
 
  static void EmbedImageData(plStringBuilder& out_sHtml, const plImage& image);
 
  static void CreateImageDiffHtml(plStringBuilder& out_sHtml, plStringView sTitle, const plImage& referenceImgRgb, const plImage& referenceImgAlpha, const plImage& capturedImgRgb, const plImage& capturedImgAlpha, const plImage& diffImgRgb, const plImage& diffImgAlpha, plUInt32 uiError, plUInt32 uiThreshold, plUInt8 uiMinDiffRgb, plUInt8 uiMaxDiffRgb, plUInt8 uiMinDiffAlpha, plUInt8 uiMaxDiffAlpha);
};