From 52204ddd5b38f43fad11237b9be515464db4f2ed Mon Sep 17 00:00:00 2001
From: Nick Fisher <nick.fisher@avinium.com>
Date: Mon, 3 Jun 2024 22:30:17 +0800
Subject: [PATCH] documentation

---
 .../lib/dart_filament/abstract_filament_viewer.dart  | 12 ++++++++----
 1 file changed, 8 insertions(+), 4 deletions(-)

diff --git a/dart_filament/lib/dart_filament/abstract_filament_viewer.dart b/dart_filament/lib/dart_filament/abstract_filament_viewer.dart
index 6684d4a6..3c8cd926 100644
--- a/dart_filament/lib/dart_filament/abstract_filament_viewer.dart
+++ b/dart_filament/lib/dart_filament/abstract_filament_viewer.dart
@@ -307,16 +307,20 @@ abstract class AbstractFilamentViewer {
   Future setTransform(FilamentEntity entity, Matrix4 transform);
 
   ///
-  /// Updates the bone matrices for [entity] (which must be the FilamentEntity returned by [loadGlb/loadGltf]).
-  /// Don't call this manually unless you know what you're doing.
+  /// Updates the bone matrices for [entity] (which must be the FilamentEntity 
+  /// returned by [loadGlb/loadGltf]).
+  /// Under the hood, this just calls [updateBoneMatrices] on the Animator 
+  /// instance of the relevant FilamentInstance (which uses the local 
+  /// bone transform and the inverse bind matrix to set the bone matrix).
   ///
   Future updateBoneMatrices(FilamentEntity entity);
 
   ///
-  ///
+  /// Directly set the bone matrix for the bone at the given index.
+  /// Don't call this manually unless you know what you're doing.
   ///
   Future setBoneTransform(
-      FilamentEntity entity, int boneIndex, Matrix4 transform);
+      FilamentEntity entity, int boneIndex, Matrix4 transform, { int skinIndex=0});
 
   ///
   /// Removes/destroys the specified entity from the scene.