ImageConversion.h

#pragma once
 
#include <Foundation/Containers/StaticArray.h>
#include <Foundation/Types/Bitflags.h>
#include <Foundation/Utilities/EnumerableClass.h>
 
#include <Texture/Image/Image.h>
 
PL_DECLARE_FLAGS(plUInt8, plImageConversionFlags, InPlace);
 
struct plImageConversionEntry
{
  plImageConversionEntry(plImageFormat::Enum source, plImageFormat::Enum target, plImageConversionFlags::Enum flags, float additionalPenalty = 0)
    : m_sourceFormat(source)
    , m_targetFormat(target)
    , m_flags(flags)
    , m_additionalPenalty(additionalPenalty)
  {
  }
 
  const plImageFormat::Enum m_sourceFormat;
  const plImageFormat::Enum m_targetFormat;
  const plBitflags<plImageConversionFlags> m_flags;
 
  float m_additionalPenalty = 0.0f;
};
 
class PL_TEXTURE_DLL plImageConversionStep : public plEnumerable<plImageConversionStep>
{
  PL_DECLARE_ENUMERABLE_CLASS(plImageConversionStep);
 
protected:
  plImageConversionStep();
  virtual ~plImageConversionStep();
 
public:
  virtual plArrayPtr<const plImageConversionEntry> GetSupportedConversions() const = 0;
};
 
class PL_TEXTURE_DLL plImageConversionStepLinear : public plImageConversionStep
{
public:
  virtual plResult ConvertPixels(plConstByteBlobPtr source, plByteBlobPtr target, plUInt64 uiNumElements, plImageFormat::Enum sourceFormat,
    plImageFormat::Enum targetFormat) const = 0;
};
 
class PL_TEXTURE_DLL plImageConversionStepDecompressBlocks : public plImageConversionStep
{
public:
  virtual plResult DecompressBlocks(plConstByteBlobPtr source, plByteBlobPtr target, plUInt32 uiNumBlocks, plImageFormat::Enum sourceFormat,
    plImageFormat::Enum targetFormat) const = 0;
};
 
class PL_TEXTURE_DLL plImageConversionStepCompressBlocks : public plImageConversionStep
{
public:
  virtual plResult CompressBlocks(plConstByteBlobPtr source, plByteBlobPtr target, plUInt32 uiNumBlocksX, plUInt32 uiNumBlocksY,
    plImageFormat::Enum sourceFormat, plImageFormat::Enum targetFormat) const = 0;
};
 
class PL_TEXTURE_DLL plImageConversionStepPlanarize : public plImageConversionStep
{
public:
  virtual plResult ConvertPixels(const plImageView& source, plArrayPtr<plImage> target, plUInt32 uiNumPixelsX, plUInt32 uiNumPixelsY, plImageFormat::Enum sourceFormat,
    plImageFormat::Enum targetFormat) const = 0;
};
 
class PL_TEXTURE_DLL plImageConversionStepDeplanarize : public plImageConversionStep
{
public:
  virtual plResult ConvertPixels(plArrayPtr<plImageView> source, plImage target, plUInt32 uiNumPixelsX, plUInt32 uiNumPixelsY, plImageFormat::Enum sourceFormat,
    plImageFormat::Enum targetFormat) const = 0;
};
 
 
class PL_TEXTURE_DLL plImageConversion
{
public:
  static bool IsConvertible(plImageFormat::Enum sourceFormat, plImageFormat::Enum targetFormat);
 
  static plImageFormat::Enum FindClosestCompatibleFormat(plImageFormat::Enum format, plArrayPtr<const plImageFormat::Enum> compatibleFormats);
 
  struct ConversionPathNode
  {
    PL_DECLARE_POD_TYPE();
 
    const plImageConversionStep* m_step;
    plImageFormat::Enum m_sourceFormat;
    plImageFormat::Enum m_targetFormat;
    plUInt32 m_sourceBufferIndex;
    plUInt32 m_targetBufferIndex;
    bool m_inPlace;
  };
 
  static plResult BuildPath(plImageFormat::Enum sourceFormat, plImageFormat::Enum targetFormat, bool bSourceEqualsTarget,
    plHybridArray<ConversionPathNode, 16>& ref_path_out, plUInt32& ref_uiNumScratchBuffers_out);
 
  static plResult Convert(const plImageView& source, plImage& ref_target, plImageFormat::Enum targetFormat);
 
  static plResult Convert(const plImageView& source, plImage& ref_target, plArrayPtr<ConversionPathNode> path, plUInt32 uiNumScratchBuffers);
 
  static plResult ConvertRaw(
    plConstByteBlobPtr source, plByteBlobPtr target, plUInt32 uiNumElements, plImageFormat::Enum sourceFormat, plImageFormat::Enum targetFormat);
 
  static plResult ConvertRaw(
    plConstByteBlobPtr source, plByteBlobPtr target, plUInt32 uiNumElements, plArrayPtr<ConversionPathNode> path, plUInt32 uiNumScratchBuffers);
 
private:
  plImageConversion();
  plImageConversion(const plImageConversion&);
 
  static plResult ConvertSingleStep(const plImageConversionStep* pStep, const plImageView& source, plImage& target, plImageFormat::Enum targetFormat);
 
  static plResult ConvertSingleStepDecompress(const plImageView& source, plImage& target, plImageFormat::Enum sourceFormat,
    plImageFormat::Enum targetFormat, const plImageConversionStep* pStep);
 
  static plResult ConvertSingleStepCompress(const plImageView& source, plImage& target, plImageFormat::Enum sourceFormat,
    plImageFormat::Enum targetFormat, const plImageConversionStep* pStep);
 
    static plResult ConvertSingleStepDeplanarize(const plImageView& source, plImage& target, plImageFormat::Enum sourceFormat,
    plImageFormat::Enum targetFormat, const plImageConversionStep* pStep);
 
  static plResult ConvertSingleStepPlanarize(const plImageView& source, plImage& target, plImageFormat::Enum sourceFormat,
    plImageFormat::Enum targetFormat, const plImageConversionStep* pStep);
 
  static void RebuildConversionTable();
};