Add Orient to Face Endpoint

modeling-cmds/src/def_enum.rs

@@ -1134,6 +1134,22 @@
             pub animated: bool,
         }
 
+        /// Looks along the normal of the specified face (if it is planar!), and fits the view to it.
+        #[derive(Debug, Clone, Serialize, Deserialize, JsonSchema, ModelingCmdVariant)]
+        pub struct OrientToFace {
+            /// Which face to orient camera to.
+            pub face_id: Uuid,
+            /// How much to pad the view frame by, as a fraction of the face bounding box size.
+            /// Negative padding will crop the view of the face proportionally.
+            /// e.g. padding = 0.2 means the view will span 120% of the face bounding box,
+            /// and padding = -0.2 means the view will span 80% of the face bounding box.
+            #[serde(default)]
+            pub padding: f32,
+            /// How many seconds the animation should take. If set to a non-positive value, no animation will occur.
+            #[serde(default = "default_animation_seconds")]
+            pub duration_seconds: f32,
+        }
+
         /// Fit the view to the scene with an isometric view.
         #[derive(Debug, Clone, Serialize, Deserialize, JsonSchema, ModelingCmdVariant)]
         pub struct ViewIsometric {

modeling-cmds/src/ok_response.rs

@@ -411,6 +411,13 @@
             pub settings: CameraSettings
         }
 
+        /// The response from the `OrientToFace` command.
+        #[derive(Debug, Serialize, Deserialize, Clone, JsonSchema, ModelingCmdOutput)]
+        pub struct OrientToFace {
+            /// Camera settings
+            pub settings: CameraSettings
+        }
+
         /// The response from the `ViewIsometric` command.
         #[derive(Debug, Serialize, Deserialize, Clone, JsonSchema, ModelingCmdOutput)]
         pub struct ViewIsometric {

modeling-cmds/src/shared.rs

@@ -669,6 +669,11 @@
         Self { settings }
     }
 }
+impl From<CameraSettings> for crate::output::OrientToFace {
+    fn from(settings: CameraSettings) -> Self {
+        Self { settings }
+    }
+}
 impl From<CameraSettings> for crate::output::ViewIsometric {
     fn from(settings: CameraSettings) -> Self {
         Self { settings }