From 0b010912092daa98a2e83db1848dd05405f69190 Mon Sep 17 00:00:00 2001
From: Claire Kuang <kuang.claire@gmail.com>
Date: Wed, 22 Oct 2025 10:53:38 +0100
Subject: [PATCH] feat(objects): Adds new camera and view proxy classes (#407)

* Adds new camera and view proxy classes

* Update ViewProxy.cs
---
 src/Speckle.Objects/Other/Camera.cs    | 32 ++++++++++++++++++++++++++
 src/Speckle.Objects/Other/ViewProxy.cs | 27 ++++++++++++++++++++++
 2 files changed, 59 insertions(+)
 create mode 100644 src/Speckle.Objects/Other/Camera.cs
 create mode 100644 src/Speckle.Objects/Other/ViewProxy.cs

diff --git a/src/Speckle.Objects/Other/Camera.cs b/src/Speckle.Objects/Other/Camera.cs
new file mode 100644
index 00000000..fd63e823
--- /dev/null
+++ b/src/Speckle.Objects/Other/Camera.cs
@@ -0,0 +1,32 @@
+using Speckle.Objects.Geometry;
+using Speckle.Sdk.Models;
+
+namespace Speckle.Objects.Other;
+
+/// <summary>
+/// Camera class to represent a camera for a 3D view.
+/// </summary>
+/// <remarks>Assumes a Z-up, right-handed convention for orientation vectors</remarks>
+[SpeckleType("Objects.Other.Camera")]
+public class Camera : Base
+{
+  /// <summary>
+  /// The location of the camera
+  /// </summary>
+  public required Point position { get; set; }
+
+  /// <summary>
+  /// The unit up vector of the camera
+  /// </summary>
+  public required Vector up { get; set; }
+
+  /// <summary>
+  /// The unit forward vector of the camera
+  /// </summary>
+  public required Vector forward { get; set; }
+
+  /// <summary>
+  /// Indicates whether or not the camera is using orthographic projection. By default, the projection should be perspective.
+  /// </summary>
+  public bool isOrthographic { get; set; }
+}
diff --git a/src/Speckle.Objects/Other/ViewProxy.cs b/src/Speckle.Objects/Other/ViewProxy.cs
new file mode 100644
index 00000000..aeac1027
--- /dev/null
+++ b/src/Speckle.Objects/Other/ViewProxy.cs
@@ -0,0 +1,27 @@
+using Speckle.Sdk.Models;
+using Speckle.Sdk.Models.Proxies;
+
+namespace Speckle.Objects.Other;
+
+/// <summary>
+/// Proxy for 3D views.
+/// </summary>
+/// <remarks>The <see cref="objects"/> list points to the applicationIds of any atomic objects that are visible in this view. An empty objects list indicates that all objects by default are visible.</remarks>
+[SpeckleType("Objects.Other.ViewProxy")]
+public class ViewProxy : Base, IProxyCollection
+{
+  /// <summary>
+  /// The list of application ids of objects that belong to this view
+  /// </summary>
+  public required List<string> objects { get; set; }
+
+  /// <summary>
+  /// The camera used for this view
+  /// </summary>
+  public required Camera value { get; set; }
+
+  /// <summary>
+  /// The name of this view
+  /// </summary>
+  public required string name { get; set; }
+}