Radient: add morph target component support

Author: TheMostDiligent

Radient/CMakeLists.txt

@@ -56,6 +56,7 @@ set(SOURCE
     src/Render/Tessera/RadientTesseraSkinData.cpp
     src/Scene/Components/RadientMaterialBindingsStorage.cpp
     src/Scene/Components/RadientMeshComponentStorage.cpp
+    src/Scene/Components/RadientMorphComponentStorage.cpp
     src/Scene/Components/RadientSkinComponentStorage.cpp
     src/Scene/RadientSceneImpl.cpp
     src/Scene/RadientSceneState.cpp
@@ -119,6 +120,7 @@ set(INCLUDE
     include/Render/Tessera/RadientTesseraMaterialCache.hpp
     include/Render/Tessera/RadientTesseraRenderTechnique.hpp
     include/Render/Tessera/RadientTesseraSkinData.hpp
+    include/Scene/Components/RadientMorphComponentStorage.hpp
 )
 
 set(INTERFACE

Radient/include/Scene/Components/RadientMorphComponentStorage.hpp

@@ -0,0 +1,55 @@
+/*
+ *  Copyright 2026 Diligent Graphics LLC
+ *
+ *  Licensed under the Apache License, Version 2.0 (the "License");
+ *  you may not use this file except in compliance with the License.
+ *  You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ *  Unless required by applicable law or agreed to in writing, software
+ *  distributed under the License is distributed on an "AS IS" BASIS,
+ *  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ *  See the License for the specific language governing permissions and
+ *  limitations under the License.
+ *
+ *  In no event and under no legal theory, whether in tort (including negligence),
+ *  contract, or otherwise, unless required by applicable law (such as deliberate
+ *  and grossly negligent acts) or agreed to in writing, shall any Contributor be
+ *  liable for any damages, including any direct, indirect, special, incidental,
+ *  or consequential damages of any character arising as a result of this License or
+ *  out of the use or inability to use the software (including but not limited to damages
+ *  for loss of goodwill, work stoppage, computer failure or malfunction, or any and
+ *  all other commercial damages or losses), even if such Contributor has been advised
+ *  of the possibility of such damages.
+ */
+
+#pragma once
+
+#include "RadientMorphTargets.h"
+#include "RadientScene.h"
+#include "RefCntAutoPtr.hpp"
+
+namespace Diligent
+{
+
+struct MorphComponentStorage
+{
+    RadientMorphComponent                     Component;
+    RefCntAutoPtr<IRadientMorphTargetWeights> pWeights;
+
+    MorphComponentStorage();
+
+    MorphComponentStorage(const MorphComponentStorage&)            = delete;
+    MorphComponentStorage& operator=(const MorphComponentStorage&) = delete;
+
+    MorphComponentStorage(MorphComponentStorage&& Rhs) noexcept;
+    MorphComponentStorage& operator=(MorphComponentStorage&& Rhs) noexcept;
+
+    void Assign(const RadientMorphComponent& Morph);
+
+private:
+    void FixupPointers();
+};
+
+} // namespace Diligent

Radient/include/Scene/RadientSceneImpl.hpp

@@ -95,6 +95,9 @@ class RadientSceneImpl final : public ObjectBase<IRadientScene>
     virtual RADIENT_STATUS DILIGENT_CALL_TYPE GetSkin(RadientEntityID       Entity,
                                                       RadientSkinComponent& Skin) const override final;
 
+    virtual RADIENT_STATUS DILIGENT_CALL_TYPE GetMorph(RadientEntityID        Entity,
+                                                       RadientMorphComponent& Morph) const override final;
+
     virtual RADIENT_STATUS DILIGENT_CALL_TYPE HasComponent(RadientEntityID        Entity,
                                                            RadientComponentTypeID ComponentType,
                                                            Bool&                  HasComponent) const override final;

Radient/include/Scene/RadientSceneState.hpp

@@ -30,6 +30,7 @@
 #include "FlagEnum.h"
 #include "Scene/Components/RadientMaterialBindingsStorage.hpp"
 #include "Scene/Components/RadientMeshComponentStorage.hpp"
+#include "Scene/Components/RadientMorphComponentStorage.hpp"
 #include "Scene/Components/RadientSkinComponentStorage.hpp"
 
 #include "entt/entity/registry.hpp"
@@ -70,6 +71,7 @@ class RadientSceneState
         const RadientMeshRendererComponent&     Renderer;
         const RadientMaterialBindingsComponent* pMaterialBindings = nullptr;
         const RadientSkinComponent*             pSkin             = nullptr;
+        const RadientMorphComponent*            pMorph            = nullptr;
         const RadientMatrix4x4&                 WorldMatrix;
         const Bool&                             EffectiveVisible;
     };
@@ -142,6 +144,7 @@ class RadientSceneState
     RADIENT_STATUS GetCachedWorldMatrix(RadientEntityID Entity, RadientMatrix4x4& Matrix) const;
     RADIENT_STATUS GetCamera(RadientEntityID Entity, RadientCameraComponent& Camera) const;
     RADIENT_STATUS GetSkin(RadientEntityID Entity, RadientSkinComponent& Skin) const;
+    RADIENT_STATUS GetMorph(RadientEntityID Entity, RadientMorphComponent& Morph) const;
     RADIENT_STATUS HasComponent(RadientEntityID Entity, RadientComponentTypeID ComponentType, Bool& HasComponent) const;
 
     const RadientSceneRevisions&    GetSceneRevisions() const;
@@ -177,6 +180,7 @@ class RadientSceneState
     RADIENT_STATUS SetCamera(RadientEntityID Entity, const RadientCameraComponent& Camera);
     RADIENT_STATUS SetMesh(RadientEntityID Entity, const RadientMeshComponent& Mesh);
     RADIENT_STATUS SetSkin(RadientEntityID Entity, const RadientSkinComponent& Skin);
+    RADIENT_STATUS SetMorph(RadientEntityID Entity, const RadientMorphComponent& Morph);
     RADIENT_STATUS SetMeshRenderer(RadientEntityID Entity, const RadientMeshRendererComponent& Renderer);
     RADIENT_STATUS SetMaterialBindings(RadientEntityID Entity, const RadientMaterialBindingsComponent& Bindings);
     RADIENT_STATUS SetLight(RadientEntityID Entity, const RadientLightComponent& Light);
@@ -204,7 +208,7 @@ class RadientSceneState
     {
         CHANGE_FLAG_NONE = 0u,
 
-        // Mesh, mesh renderer, material bindings, or skin changed.
+        // Mesh, mesh renderer, material bindings, skin, or morph changed.
         CHANGE_FLAG_DRAWABLES = 1u << 0u,
 
         // Light component data changed.
@@ -455,13 +459,15 @@ inline RadientSceneState::RenderableMesh RadientSceneState::MakeRenderableMesh(e
 
     const MaterialBindingsStorage* pMaterialBindings = m_Registry.try_get<MaterialBindingsStorage>(Entity);
     const SkinComponentStorage*    pSkin             = m_Registry.try_get<SkinComponentStorage>(Entity);
+    const MorphComponentStorage*   pMorph            = m_Registry.try_get<MorphComponentStorage>(Entity);
 
     return RenderableMesh{
         EntityData.ID,
         MeshStorage.Component,
         Renderer,
         pMaterialBindings != nullptr ? &pMaterialBindings->Component : nullptr,
         pSkin != nullptr ? &pSkin->Component : nullptr,
+        pMorph != nullptr ? &pMorph->Component : nullptr,
         WorldTransform.Matrix,
         EffectiveVisible.Visible};
 }

Radient/include/Scene/RadientSceneWriterImpl.hpp

@@ -79,6 +79,9 @@ class RadientSceneWriterImpl final : public ObjectBase<IRadientSceneWriter>
     virtual RADIENT_STATUS DILIGENT_CALL_TYPE SetSkin(RadientEntityID             Entity,
                                                       const RadientSkinComponent& Skin) override final;
 
+    virtual RADIENT_STATUS DILIGENT_CALL_TYPE SetMorph(RadientEntityID              Entity,
+                                                       const RadientMorphComponent& Morph) override final;
+
     virtual RADIENT_STATUS DILIGENT_CALL_TYPE SetMeshRenderer(RadientEntityID                     Entity,
                                                               const RadientMeshRendererComponent& Renderer) override final;
 

Radient/interface/RadientScene.h

@@ -106,7 +106,7 @@ typedef struct RadientSceneCreateInfo RadientSceneCreateInfo;
 /// Scene revisions grouped by renderer-relevant data category.
 struct RadientSceneRevisions
 {
-    /// Mesh, mesh renderer, or material binding data changed.
+    /// Mesh, mesh renderer, material binding, skin, or morph data changed.
     RadientRevision Drawables DEFAULT_INITIALIZER(0);
 
     /// Light component data changed.
@@ -573,6 +573,13 @@ DILIGENT_BEGIN_INTERFACE(IRadientScene, IObject)
                                            RadientEntityID          Entity,
                                            RadientSkinComponent REF Skin) CONST PURE;
 
+    /// Gets morph component. The returned weights pointer is borrowed from the
+    /// scene and remains valid until the component is changed or removed. The
+    /// caller may retain it when a longer lifetime is required.
+    VIRTUAL RADIENT_STATUS METHOD(GetMorph)(THIS_
+                                            RadientEntityID           Entity,
+                                            RadientMorphComponent REF Morph) CONST PURE;
+
     /// Checks if the entity has the requested component.
     VIRTUAL RADIENT_STATUS METHOD(HasComponent)(THIS_
                                                 RadientEntityID        Entity,
@@ -602,6 +609,7 @@ DILIGENT_END_INTERFACE
 #    define IRadientScene_GetCachedWorldMatrix(This, ...)        CALL_IFACE_METHOD(RadientScene, GetCachedWorldMatrix,        This, __VA_ARGS__)
 #    define IRadientScene_GetCamera(This, ...)                   CALL_IFACE_METHOD(RadientScene, GetCamera,                   This, __VA_ARGS__)
 #    define IRadientScene_GetSkin(This, ...)                     CALL_IFACE_METHOD(RadientScene, GetSkin,                     This, __VA_ARGS__)
+#    define IRadientScene_GetMorph(This, ...)                    CALL_IFACE_METHOD(RadientScene, GetMorph,                    This, __VA_ARGS__)
 #    define IRadientScene_HasComponent(This, ...)                CALL_IFACE_METHOD(RadientScene, HasComponent,                This, __VA_ARGS__)
 #    define IRadientScene_GetSceneRevisions(This)                CALL_IFACE_METHOD(RadientScene, GetSceneRevisions,           This)
 

Radient/interface/RadientSceneWriter.h

@@ -90,7 +90,8 @@ DILIGENT_BEGIN_INTERFACE(IRadientSceneWriter, IObject)
                                              RadientEntityID                  Entity,
                                              const RadientCameraComponent REF Camera) PURE;
 
-    /// Adds or updates a mesh component.
+    /// Adds or updates a mesh component. Replacing the mesh removes an existing
+    /// morph component if its weights belong to a different mesh.
     VIRTUAL RADIENT_STATUS METHOD(SetMesh)(THIS_
                                            RadientEntityID                Entity,
                                            const RadientMeshComponent REF Mesh) PURE;
@@ -100,6 +101,12 @@ DILIGENT_BEGIN_INTERFACE(IRadientSceneWriter, IObject)
                                            RadientEntityID                Entity,
                                            const RadientSkinComponent REF Skin) PURE;
 
+    /// Adds or updates a morph component. The weights must belong to the mesh
+    /// currently assigned to the entity.
+    VIRTUAL RADIENT_STATUS METHOD(SetMorph)(THIS_
+                                            RadientEntityID                 Entity,
+                                            const RadientMorphComponent REF Morph) PURE;
+
     /// Adds or updates a mesh renderer component.
     VIRTUAL RADIENT_STATUS METHOD(SetMeshRenderer)(THIS_
                                                    RadientEntityID                        Entity,
@@ -144,6 +151,7 @@ DILIGENT_END_INTERFACE
 #    define IRadientSceneWriter_SetCamera(This, ...)              CALL_IFACE_METHOD(RadientSceneWriter, SetCamera,         This, __VA_ARGS__)
 #    define IRadientSceneWriter_SetMesh(This, ...)                CALL_IFACE_METHOD(RadientSceneWriter, SetMesh,           This, __VA_ARGS__)
 #    define IRadientSceneWriter_SetSkin(This, ...)                CALL_IFACE_METHOD(RadientSceneWriter, SetSkin,           This, __VA_ARGS__)
+#    define IRadientSceneWriter_SetMorph(This, ...)               CALL_IFACE_METHOD(RadientSceneWriter, SetMorph,          This, __VA_ARGS__)
 #    define IRadientSceneWriter_SetMeshRenderer(This, ...)        CALL_IFACE_METHOD(RadientSceneWriter, SetMeshRenderer,   This, __VA_ARGS__)
 #    define IRadientSceneWriter_SetMaterialBindings(This, ...)    CALL_IFACE_METHOD(RadientSceneWriter, SetMaterialBindings, This, __VA_ARGS__)
 #    define IRadientSceneWriter_SetLight(This, ...)               CALL_IFACE_METHOD(RadientSceneWriter, SetLight,          This, __VA_ARGS__)

Radient/interface/RadientTypes.h

@@ -125,6 +125,7 @@ static DILIGENT_CONSTEXPR RadientComponentTypeID RADIENT_COMPONENT_TYPE_MESH_REN
 static DILIGENT_CONSTEXPR RadientComponentTypeID RADIENT_COMPONENT_TYPE_LIGHT             = 5;
 static DILIGENT_CONSTEXPR RadientComponentTypeID RADIENT_COMPONENT_TYPE_MATERIAL_BINDINGS = 6;
 static DILIGENT_CONSTEXPR RadientComponentTypeID RADIENT_COMPONENT_TYPE_SKIN              = 7;
+static DILIGENT_CONSTEXPR RadientComponentTypeID RADIENT_COMPONENT_TYPE_MORPH             = 8;
 
 /// Asset reference used by scenes, components, and render features.
 struct RadientAssetReference

Radient/src/Scene/Components/RadientMorphComponentStorage.cpp

@@ -0,0 +1,69 @@
+/*
+ *  Copyright 2026 Diligent Graphics LLC
+ *
+ *  Licensed under the Apache License, Version 2.0 (the "License");
+ *  you may not use this file except in compliance with the License.
+ *  You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ *  Unless required by applicable law or agreed to in writing, software
+ *  distributed under the License is distributed on an "AS IS" BASIS,
+ *  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ *  See the License for the specific language governing permissions and
+ *  limitations under the License.
+ *
+ *  In no event and under no legal theory, whether in tort (including negligence),
+ *  contract, or otherwise, unless required by applicable law (such as deliberate
+ *  and grossly negligent acts) or agreed to in writing, shall any Contributor be
+ *  liable for any damages, including any direct, indirect, special, incidental,
+ *  or consequential damages of any character arising as a result of this License or
+ *  out of the use or inability to use the software (including but not limited to damages
+ *  for loss of goodwill, work stoppage, computer failure or malfunction, or any and
+ *  all other commercial damages or losses), even if such Contributor has been advised
+ *  of the possibility of such damages.
+ */
+
+#include "Scene/Components/RadientMorphComponentStorage.hpp"
+
+#include <utility>
+
+namespace Diligent
+{
+
+MorphComponentStorage::MorphComponentStorage() = default;
+
+MorphComponentStorage::MorphComponentStorage(MorphComponentStorage&& Rhs) noexcept :
+    Component{Rhs.Component},
+    pWeights{std::move(Rhs.pWeights)}
+{
+    FixupPointers();
+    Rhs.Component = {};
+}
+
+MorphComponentStorage& MorphComponentStorage::operator=(MorphComponentStorage&& Rhs) noexcept
+{
+    if (this != &Rhs)
+    {
+        Component = Rhs.Component;
+        pWeights  = std::move(Rhs.pWeights);
+        FixupPointers();
+        Rhs.Component = {};
+    }
+
+    return *this;
+}
+
+void MorphComponentStorage::Assign(const RadientMorphComponent& Morph)
+{
+    Component = Morph;
+    pWeights  = Morph.pWeights;
+    FixupPointers();
+}
+
+void MorphComponentStorage::FixupPointers()
+{
+    Component.pWeights = pWeights;
+}
+
+} // namespace Diligent

Radient/src/Scene/RadientSceneImpl.cpp

@@ -125,6 +125,11 @@ RADIENT_STATUS RadientSceneImpl::GetSkin(RadientEntityID Entity, RadientSkinComp
     return m_pState->GetSkin(Entity, Skin);
 }
 
+RADIENT_STATUS RadientSceneImpl::GetMorph(RadientEntityID Entity, RadientMorphComponent& Morph) const
+{
+    return m_pState->GetMorph(Entity, Morph);
+}
+
 RADIENT_STATUS RadientSceneImpl::HasComponent(RadientEntityID Entity, RadientComponentTypeID ComponentType, Bool& HasComponent) const
 {
     return m_pState->HasComponent(Entity, ComponentType, HasComponent);