Code/Tools/Libs/ModelImporter2/Importer/Importer.h - dev - redgpu/ezEngine

Code/Tools/Libs/ModelImporter2/Importer/Importer.h
125 строк3 KB
Yuriy Balyuk
Added "Normal Weight" parameter to "Simplify Mesh" feature; ... (#1910)
21 апр 2026, 14:59
21 апр 2026, 14:59f54587c
#pragma once

#include <ModelImporter2/ModelImporterDLL.h>

#include <Foundation/Types/UniquePtr.h>
#include <RendererCore/Meshes/MeshBufferUtils.h>

class ezLogInterface;
class ezProgress;
class ezEditableSkeleton;
class ezMeshResourceDescriptor;
struct ezAnimationClipResourceDescriptor;

namespace ezModelImporter2
{
  enum AdditiveReference
  {
    FirstKeyFrame,
    LastKeyFrame,
  };

  struct ImportOptions
  {
    ezString m_sSourceFile;

    bool m_bImportSkinningData = false;
    bool m_bRecomputeNormals = false;
    bool m_bRecomputeTangents = false;
    bool m_bNormalizeWeights = false;
    ezEnum<ezMeshVertexColorConversion> m_MeshVertexColorConversion = ezMeshVertexColorConversion::Default;
    bool m_bHighPrecision = false;
    ezMat3 m_RootTransform = ezMat3::MakeIdentity();

    // if non-empty, only import meshes whose names start or end with any of these strings
    ezDynamicArray<ezString> m_MeshIncludeTags;
    // if non-empty, do not import meshes whose names start or end with any of these strings (unless already explicitly included)
    ezDynamicArray<ezString> m_MeshExcludeTags;

    ezMeshResourceDescriptor* m_pMeshOutput = nullptr;

    ezEditableSkeleton* m_pSkeletonOutput = nullptr;

    bool m_bAdditiveAnimation = false;
    AdditiveReference m_AdditiveReference = AdditiveReference::FirstKeyFrame;

    ezString m_sAnimationToImport; // empty = first in file; "name" = only anim with that name
    ezAnimationClipResourceDescriptor* m_pAnimationOutput = nullptr;
    ezUInt32 m_uiFirstAnimKeyframe = 0;
    ezUInt32 m_uiNumAnimKeyframes = 0;

    ezUInt8 m_uiMeshSimplification = 0;
    ezUInt8 m_uiMaxSimplificationError = 5;
    float m_fNormalWeight = 0.5f;
    bool m_bAggressiveSimplification = false;

    // Adjustments to deal with bad data:
    float m_fAnimationPositionScale = 1.0f;
  };

  enum class PropertySemantic : ezInt8
  {
    Unknown = 0,

    DiffuseColor,
    RoughnessValue,
    MetallicValue,
    EmissiveColor,
    TwosidedValue,
  };

  enum class TextureSemantic : ezInt8
  {
    Unknown = 0,

    DiffuseMap,
    DiffuseAlphaMap,
    OcclusionMap,
    RoughnessMap,
    MetallicMap,
    OrmMap,
    DisplacementMap,
    NormalMap,
    EmissiveMap,
  };

  struct EZ_MODELIMPORTER2_DLL OutputTexture
  {
    ezString m_sFilename;
    ezString m_sFileFormatExtension;
    ezConstByteArrayPtr m_RawData;

    void GenerateFileName(ezStringBuilder& out_sName) const;
  };

  struct EZ_MODELIMPORTER2_DLL OutputMaterial
  {
    ezString m_sName;

    ezInt32 m_iReferencedByMesh = -1;                     // if -1, no sub-mesh in the output actually references this
    ezMap<TextureSemantic, ezString> m_TextureReferences; // semantic -> path
    ezMap<PropertySemantic, ezVariant> m_Properties;      // semantic -> value
  };

  class EZ_MODELIMPORTER2_DLL Importer
  {
  public:
    Importer();
    virtual ~Importer();

    ezResult Import(const ImportOptions& options, ezLogInterface* pLogInterface = nullptr, ezProgress* pProgress = nullptr);
    const ImportOptions& GetImportOptions() const { return m_Options; }

    ezMap<ezString, OutputTexture> m_OutputTextures; // path -> additional data
    ezDeque<OutputMaterial> m_OutputMaterials;
    ezDynamicArray<ezString> m_OutputAnimationNames;
    ezDynamicArray<ezString> m_OutputMeshNames;

  protected:
    virtual ezResult DoImport() = 0;

    ImportOptions m_Options;
    ezProgress* m_pProgress = nullptr;
  };

} // namespace ezModelImporter2