init

source_code/Cubism/Framework/CubismParameter.cs

@@ -0,0 +1,50 @@
+namespace Cthangover.Live2D.Cubism.Framework
+{
+    /// <summary>
+    /// Cubism model parameter.
+    /// Each parameter has a string ID, a numeric index into the native
+    /// parameter arrays, current value, and bounds (min, max, default).
+    /// 
+    /// Parameters are created during <see cref="CubismModelNode.SetupParameters"/>
+    /// and exposed via <see cref="CubismModelNode.Parameters"/>. External code
+    /// can read/write <see cref="Value"/> and call <see cref="ApplyToModel"/>
+    /// to push changes back to the CubismCore native arrays.
+    /// </summary>
+    public class CubismParameter
+    {
+        public CubismNativeModel Model { get; }
+
+        public CubismParameter(CubismNativeModel model)
+        {
+            Model = model;
+        }
+        
+        /// <summary>Cubism parameter ID string (e.g. "ParamAngleX", "ParamMouthOpenY").</summary>
+        public string Id { get; set; }
+
+        /// <summary>Zero-based index into the native parameter arrays.</summary>
+        public int Index { get; set; }
+
+        /// <summary>Current parameter value. Writes to native model when <see cref="ApplyToModel"/> is called.</summary>
+        public float Value { get; set; }
+
+        /// <summary>Minimum allowed value for this parameter.</summary>
+        public float MinimumValue { get; set; }
+
+        /// <summary>Maximum allowed value for this parameter.</summary>
+        public float MaximumValue { get; set; }
+
+        /// <summary>Default (rest) value for this parameter from the moc3.</summary>
+        public float DefaultValue { get; set; }
+
+        /// <summary>
+        /// Writes <see cref="Value"/> directly to the native model's parameter array.
+        /// No clamping is performed — the caller should enforce bounds if needed.
+        /// </summary>
+        public unsafe void ApplyToModel()
+        {
+            var values = Model.GetParameterValues();
+            values[Index] = Value;
+        }
+    }
+}