scriptup 2026.0.0 → 2026.0.1

data/sketchup-sdk-mac/SketchUpAPI.framework/Versions/A/Headers/model/rendering_options.h

@@ -82,90 +82,91 @@ SU_RESULT SURenderingOptionsSetValue(
 
 The breakdown of rendering options and value types is shown in the table below.
 
-Rendering Option         | Value Type
------------------------- | ----------------------
-BackgroundColor          | SUTypedValueType_Color
-BandColor                | SUTypedValueType_Color
-ConstructionColor        | SUTypedValueType_Color
-DepthQueWidth            | SUTypedValueType_Int32
-DisplayColorByLayer      | SUTypedValueType_Bool
-DisplayDims              | SUTypedValueType_Bool
-DisplayFog               | SUTypedValueType_Bool
-DisplayInstanceAxes      | SUTypedValueType_Bool
-DisplaySectionPlanes (since SketchUp 2014, API 2.0) | SUTypedValueType_Bool
-DisplaySectionCuts (since SketchUp 2015, API 3.0)   | SUTypedValueType_Bool
-DisplaySketchAxes        | SUTypedValueType_Bool
-DisplayText              | SUTypedValueType_Bool
-DisplayWatermarks        | SUTypedValueType_Bool
-DrawBackEdges (since SketchUp 2015, API 3.0)        | SUTypedValueType_Bool
-DrawDepthQue             | SUTypedValueType_Bool
-DrawGround               | SUTypedValueType_Bool
-DrawHidden               | SUTypedValueType_Bool
-DrawHiddenGeometry (since SketchUp 2020, API 8.0)   | SUTypedValueType_Bool
-DrawHiddenObjects (since SketchUp 2020, API 8.0)    | SUTypedValueType_Bool
-DrawHorizon              | SUTypedValueType_Bool
-DrawLineEnds             | SUTypedValueType_Bool
-DrawProfilesOnly         | SUTypedValueType_Bool
-DrawSilhouettes          | SUTypedValueType_Bool
-DrawUnderground          | SUTypedValueType_Bool
-EdgeColorMode            | SUTypedValueType_Int32
-EdgeDisplayMode          | SUTypedValueType_Int32
-EdgeType                 | SUTypedValueType_Int32
-ExtendLines              | SUTypedValueType_Bool
-FaceBackColor            | SUTypedValueType_Color
-FaceFrontColor           | SUTypedValueType_Color
-FogColor                 | SUTypedValueType_Color
-FogEndDist               | SUTypedValueType_Double
-FogStartDist             | SUTypedValueType_Double
-FogUseBkColor            | SUTypedValueType_Bool
-ForegroundColor          | SUTypedValueType_Color
-GroundColor              | SUTypedValueType_Color
-GroundTransparency       | SUTypedValueType_Int32
-HideConstructionGeometry | SUTypedValueType_Bool
-HighlightColor           | SUTypedValueType_Color
-HorizonColor             | SUTypedValueType_Color
-InactiveFade             | SUTypedValueType_Double
-InactiveHidden           | SUTypedValueType_Bool
-InstanceFade             | SUTypedValueType_Double
-InstanceHidden           | SUTypedValueType_Bool
-JitterEdges              | SUTypedValueType_Bool
-LineEndWidth             | SUTypedValueType_Int32
-LineExtension            | SUTypedValueType_Int32
-LockedColor              | SUTypedValueType_Color
-MaterialTransparency     | SUTypedValueType_Bool
-ModelTransparency        | SUTypedValueType_Bool
-RenderMode               | SUTypedValueType_Int32
-SectionActiveColor       | SUTypedValueType_Color
-SectionCutDrawEdges (since SketchUp 2015, API 3.0)  | SUTypedValueType_Bool
-SectionCutFilled (since SketchUp 2018, API 6.0) | SUTypedValueType_Bool
-SectionCutWidth          | SUTypedValueType_Int32
-SectionDefaultCutColor   | SUTypedValueType_Color
-SectionDefaultFillColor (since SketchUp 2018, API 6.0) | SUTypedValueType_Color
-SectionInactiveColor     | SUTypedValueType_Color
-ShowViewName             | SUTypedValueType_Bool
-SilhouetteWidth          | SUTypedValueType_Int32
-SkyColor                 | SUTypedValueType_Color
-Texture                  | SUTypedValueType_Bool
-TransparencySort         | SUTypedValueType_Int32
+Rendering Option             | Value Type                   | Since
+---------------------------- | ---------------------------- | -------------------------
+`"BackgroundColor"`          | \ref SUTypedValueType_Color  |  
+`"BandColor"`                | \ref SUTypedValueType_Color  |  
+`"ConstructionColor"`        | \ref SUTypedValueType_Color  |  
+`"DepthQueWidth"`            | \ref SUTypedValueType_Int32  |  
+`"DisplayColorByLayer"`      | \ref SUTypedValueType_Bool   |  
+`"DisplayDims"`              | \ref SUTypedValueType_Bool   |  
+`"DisplayFog"`               | \ref SUTypedValueType_Bool   |  
+`"DisplayInstanceAxes"`      | \ref SUTypedValueType_Bool   |  
+`"DisplaySectionPlanes"`     | \ref SUTypedValueType_Bool   | SketchUp 2014, API 2.0
+`"DisplaySectionCuts"`       | \ref SUTypedValueType_Bool   | SketchUp 2015, API 3.0
+`"DisplaySketchAxes"`        | \ref SUTypedValueType_Bool   |  
+`"DisplayText"`              | \ref SUTypedValueType_Bool   |  
+`"DisplayWatermarks"`        | \ref SUTypedValueType_Bool   |  
+`"DrawBackEdges"`            | \ref SUTypedValueType_Bool   | SketchUp 2015, API 3.0
+`"DrawDepthQue"`             | \ref SUTypedValueType_Bool   |  
+`"DrawGround"`               | \ref SUTypedValueType_Bool   |  
+`"DrawHidden"`               | \ref SUTypedValueType_Bool   |  
+`"DrawHiddenGeometry"`       | \ref SUTypedValueType_Bool   | SketchUp 2020, API 8.0
+`"DrawHiddenObjects"`        | \ref SUTypedValueType_Bool   | SketchUp 2020, API 8.0
+`"DrawHorizon"`              | \ref SUTypedValueType_Bool   |  
+`"DrawLineEnds"`             | \ref SUTypedValueType_Bool   |  
+`"DrawProfilesOnly"`         | \ref SUTypedValueType_Bool   |  
+`"DrawSilhouettes"`          | \ref SUTypedValueType_Bool   |  
+`"DrawUnderground"`          | \ref SUTypedValueType_Bool   |  
+`"EdgeColorMode"`            | \ref SUTypedValueType_Int32  |  
+`"EdgeDisplayMode"`          | \ref SUTypedValueType_Int32  |  
+`"EdgeType"`                 | \ref SUTypedValueType_Int32  |  
+`"ExtendLines"`              | \ref SUTypedValueType_Bool   |  
+`"FaceBackColor"`            | \ref SUTypedValueType_Color  |  
+`"FaceFrontColor"`           | \ref SUTypedValueType_Color  |  
+`"FogColor"`                 | \ref SUTypedValueType_Color  |  
+`"FogEndDist"`               | \ref SUTypedValueType_Double |  
+`"FogStartDist"`             | \ref SUTypedValueType_Double |  
+`"FogUseBkColor"`            | \ref SUTypedValueType_Bool   |  
+`"ForegroundColor"`          | \ref SUTypedValueType_Color  |  
+`"GroundColor"`              | \ref SUTypedValueType_Color  |  
+`"GroundTransparency"`       | \ref SUTypedValueType_Int32  |  
+`"HideConstructionGeometry"` | \ref SUTypedValueType_Bool   |  
+`"HighlightColor"`           | \ref SUTypedValueType_Color  |  
+`"HorizonColor"`             | \ref SUTypedValueType_Color  |  
+`"InactiveFade"`             | \ref SUTypedValueType_Double |  
+`"InactiveHidden"`           | \ref SUTypedValueType_Bool   |  
+`"InstanceFade"`             | \ref SUTypedValueType_Double |  
+`"InstanceHidden"`           | \ref SUTypedValueType_Bool   |  
+`"JitterEdges"`              | \ref SUTypedValueType_Bool   |  
+`"LineEndWidth"`             | \ref SUTypedValueType_Int32  |  
+`"LineExtension"`            | \ref SUTypedValueType_Int32  |  
+`"LockedColor"`              | \ref SUTypedValueType_Color  |  
+`"MaterialTransparency"`     | \ref SUTypedValueType_Bool   |  
+`"ModelTransparency"`        | \ref SUTypedValueType_Bool   |  
+`"RenderMode"`               | \ref SUTypedValueType_Int32  |  
+`"SectionActiveColor"`       | \ref SUTypedValueType_Color  |  
+`"SectionCutDrawEdges"`      | \ref SUTypedValueType_Bool   | SketchUp 2015, API 3.0
+`"SectionCutFilled"`         | \ref SUTypedValueType_Bool   | SketchUp 2018, API 6.0
+`"SectionCutWidth"`          | \ref SUTypedValueType_Int32  |  
+`"SectionDefaultCutColor"`   | \ref SUTypedValueType_Color  |  
+`"SectionDefaultFillColor"`  | \ref SUTypedValueType_Color  | SketchUp 2018, API 6.0
+`"SectionInactiveColor"`     | \ref SUTypedValueType_Color  |  
+`"ShowViewName"`             | \ref SUTypedValueType_Bool   |  
+`"SilhouetteWidth"`          | \ref SUTypedValueType_Int32  |  
+`"SkyColor"`                 | \ref SUTypedValueType_Color  |  
+`"Texture"`                  | \ref SUTypedValueType_Bool   |  
+`"TransparencySort"`         | \ref SUTypedValueType_Int32  |  
 
 Some of the options map to enumerated values, as shown in the table below.
 
-Option          | Value | Meaning
---------------- | ----- | -------
-EdgeColorMode   | 0:    | ObjectColor
-           | 1:    | ForegroundColor
-           | 2:    | DirectionColor
-EdgeDisplayMode | 0:    | EdgeDisplayNone
-           | 1:    | EdgeDisplayAll
-           | 2:    | EdgeDisplayStandalone
-RenderMode      | 0:    | RenderWireframe
-           | 1:    | RenderHidden
-           | 2:    | RenderFlat
-           | 3:    | RenderSmooth
-           | 4:    | RenderTextureObsolete
-           | 5:    | RenderNoMaterials
-EdgeType        | 0:    | EdgeStandard
-           | 1:    | EdgeNPR
+Option             | Value | Meaning               | Since
+------------------ | ----- | --------------------- | --------------------------
+\b EdgeColorMode   | `0`   | ObjectColor           |  
+              | `1`   | ForegroundColor       |  
+              | `2`   | DirectionColor        |  
+\b EdgeDisplayMode | `0`   | EdgeDisplayNone       |  
+              | `1`   | EdgeDisplayAll        |  
+              | `2`   | EdgeDisplayStandalone |  
+\b RenderMode      | `0`   | RenderWireframe       |  
+              | `1`   | RenderHidden          |  
+              | `2`   | RenderFlat            |  
+              | `3`   | RenderSmooth          |  
+              | `4`   | RenderTextureObsolete |  
+              | `5`   | RenderNoMaterials     |  
+              | `6`   | RenderPhysicallyBased | SketchUp 2025.0, API 13.0
+\b EdgeType        | `0`   | EdgeStandard          |  
+              | `1`   | EdgeNPR               |  
 
 @note The rendering option FaceColorMode was removed in SketchUp 2019.1.
 */

data/sketchup-sdk-mac/SketchUpAPI.framework/Versions/A/Headers/model/scene.h

@@ -1,4 +1,4 @@
-// Copyright 2013 Trimble Inc. All Rights Reserved.
+// Copyright 2013-2025 Trimble Inc. All Rights Reserved.
 
 /**
  * @file
@@ -20,6 +20,9 @@ extern "C" {
 @extends SUEntityRef
 @brief Used to get and set a scene's camera views, using the \ref SUCameraRef
        object.
+
+@note Add the scene to the model before setting its properties, except for the name which should
+  be set before adding it.
 */
 
 /**
@@ -30,18 +33,23 @@ extern "C" {
  * @see SUSceneRef
  * @{
  */
-#define FLAG_USE_CAMERA 0x0001
-#define FLAG_USE_RENDERING_OPTIONS 0x0002
-#define FLAG_USE_SHADOWINFO 0x0004
-#define FLAG_USE_AXES 0x0008
+#define FLAG_USE_CAMERA 0x0001             ///< @since SketchUp 2017, API 5.0
+#define FLAG_USE_RENDERING_OPTIONS 0x0002  ///< @since SketchUp 2017, API 5.0
+#define FLAG_USE_SHADOWINFO 0x0004         ///< @since SketchUp 2017, API 5.0
+#define FLAG_USE_AXES 0x0008               ///< @since SketchUp 2017, API 5.0
+/// @deprecated Obsolete since SketchUp 2020.1, API 8.1. Instead, use
+///   \ref FLAG_USE_HIDDEN_GEOMETRY and \ref FLAG_USE_HIDDEN_OBJECTS.
+///
+/// @since SketchUp 2017, API 5.0
 #define FLAG_USE_HIDDEN 0x0010
-#define FLAG_USE_LAYER_VISIBILITY 0x0020
-#define FLAG_USE_SECTION_PLANES 0x0040
-#define FLAG_USE_HIDDEN_GEOMETRY 0x0080
-#define FLAG_USE_HIDDEN_OBJECTS 0x0100
-
-#define FLAG_USE_ALL 0x0fff
-#define FLAG_NO_CAMERA 0x0ffe
+#define FLAG_USE_LAYER_VISIBILITY 0x0020  ///< @since SketchUp 2017, API 5.0
+#define FLAG_USE_SECTION_PLANES 0x0040    ///< @since SketchUp 2017, API 5.0
+#define FLAG_USE_HIDDEN_GEOMETRY 0x0080   ///< @since SketchUp 2020.1, API 8.1
+#define FLAG_USE_HIDDEN_OBJECTS 0x0100    ///< @since SketchUp 2020.1, API 8.1
+#define FLAG_USE_ENVIRONMENT 0x0200       ///< @since SketchUp 2025.0, API 13.0
+
+#define FLAG_USE_ALL 0x0fff    ///< @since SketchUp 2017, API 5.0
+#define FLAG_NO_CAMERA 0x0ffe  ///< @since SketchUp 2017, API 5.0
 /**@}*/
 
 /**
@@ -69,12 +77,31 @@ SU_EXPORT SUSceneRef SUSceneFromEntity(SUEntityRef entity);
 
 /**
 @brief Creates an empty scene object.
+
+@note The created scene will not save any scene properties until
+  the \ref SUSceneFlags bits are set.
+
 @param[out] scene The scene object created.
 @related SUSceneRef
 @return
 - \ref SU_ERROR_NONE on success
 - \ref SU_ERROR_NULL_POINTER_INPUT if scene is NULL
 - \ref SU_ERROR_OVERWRITE_VALID if face already refers to a valid object
+
+@see SUSceneSetFlags
+@see SUModelAddScenes
+
+@code
+SUScene scene = SU_INVALID;
+SUSceneCreate(&scene);
+SUSceneSetName(scene, "Example"); // Must be unique.
+SUSceneSetFlags(scene, FLAG_USE_ALL); // Set the properties to remember.
+SUModelAddScenes(model, 1, &scene); // This will also update the scene based on the flags set.
+
+// Set scene properties after adding it to the model.
+// ...
+SUSceneSetCamera(scene, eye, target, up);
+@endcode
 */
 SU_RESULT SUSceneCreate(SUSceneRef* scene);
 
@@ -115,9 +142,11 @@ SU_RESULT SUSceneGetUseCamera(SUSceneRef scene, bool* use_camera);
 SU_RESULT SUSceneSetUseCamera(SUSceneRef scene, bool use_camera);
 
 /**
-@brief Retrieves the camera of a scene object. The returned camera object
-       points to scene's internal camera. So the camera must not be released
-       via SUCameraRelease().
+@brief Retrieves the camera of a scene object.
+
+@note The returned camera object points to scene's internal camera. So the
+  camera must not be released via SUCameraRelease().
+
 @param[in]  scene  The scene object.
 @param[out] camera The camera object retrieved.
 @related SUSceneRef
@@ -129,10 +158,12 @@ SU_RESULT SUSceneSetUseCamera(SUSceneRef scene, bool use_camera);
 SU_RESULT SUSceneGetCamera(SUSceneRef scene, SUCameraRef* camera);
 
 /**
-@brief Sets a given scene's camera object.  The scene does not take ownership
-       of the provided camera, it just copies the properties to the scene's
-       owned camera.  If the input camera was created using SUCameraCreate()
-       it must be released using SUCameraRelease().
+@brief Sets a given scene's camera object.
+
+@note The scene does not take ownership of the provided camera, it just copies
+  the properties to the scene's owned camera. If the input camera was created
+  using SUCameraCreate() it must be released using SUCameraRelease().
+
 @since SketchUp 2016, API 4.0
 @param[in] scene  The scene object.
 @param[in] camera The camera object to be set.
@@ -188,7 +219,7 @@ SU_RESULT SUSceneGetName(SUSceneRef scene, SUStringRef* name);
 @brief Sets the name of a scene object.
 
 @warning Breaking Change: The behavior of SUSceneSetName changed in
-         SketchUp SDK 2018 API 6.0 to return SU_ERROR_INVALID_ARGUMENT if the
+         SketchUp 2018, API 6.0 to return \ref SU_ERROR_INVALID_ARGUMENT if the
          given name already exists in the scene's model.
 
 @param[in] scene      The scene object.
@@ -293,6 +324,8 @@ SU_RESULT SUSceneSetUseRenderingOptions(SUSceneRef scene, bool use_rendering_opt
 @param[out] use_hidden The current setting for whether or not the hidden
                        property of entities is used.
 @related SUSceneRef
+@see SUSceneGetUseHiddenGeometry
+@see SUSceneGetUseHiddenObjects
 @return
 - \ref SU_ERROR_NONE on success
 - \ref SU_ERROR_INVALID_INPUT if scene is not a valid object
@@ -309,6 +342,8 @@ SU_RESULT SUSceneGetUseHidden(SUSceneRef scene, bool* use_hidden);
 @param[in] use_hidden The new setting for whether or not the hidden
                      property of entities is used.
 @related SUSceneRef
+ @see SUSceneSetUseHiddenGeometry
+ @see SUSceneSetUseHiddenObjects
 @return
 - \ref SU_ERROR_NONE on success
 - \ref SU_ERROR_INVALID_INPUT if scene is not a valid object
@@ -322,6 +357,9 @@ SU_RESULT SUSceneSetUseHidden(SUSceneRef scene, bool use_hidden);
 @param[out] use_hidden The current setting for whether or not the hidden
                        property of root-level entities is used.
 @related SUSceneRef
+@see SUSceneSetUseHiddenGeometry
+@see SUSceneGetUseHiddenObjects
+@see SUSceneSetUseHiddenObjects
 @return
 - \ref SU_ERROR_NONE on success
 - \ref SU_ERROR_INVALID_INPUT if scene is not a valid object
@@ -336,6 +374,9 @@ SU_RESULT SUSceneGetUseHiddenGeometry(SUSceneRef scene, bool* use_hidden);
 @param[in] use_hidden The new setting for whether or not the hidden
                       property of root-level entities is used.
 @related SUSceneRef
+@see SUSceneGetUseHiddenGeometry
+@see SUSceneGetUseHiddenObjects
+@see SUSceneSetUseHiddenObjects
 @return
 - \ref SU_ERROR_NONE on success
 - \ref SU_ERROR_INVALID_INPUT if scene is not a valid object
@@ -349,6 +390,9 @@ SU_RESULT SUSceneSetUseHiddenGeometry(SUSceneRef scene, bool use_hidden);
 @param[out] use_hidden The current setting for whether or not the hidden
                        property of objects is used.
 @related SUSceneRef
+@see SUSceneGetUseHiddenGeometry
+@see SUSceneSetUseHiddenGeometry
+@see SUSceneSetUseHiddenObjects
 @return
 - \ref SU_ERROR_NONE on success
 - \ref SU_ERROR_INVALID_INPUT if scene is not a valid object
@@ -363,6 +407,9 @@ SU_RESULT SUSceneGetUseHiddenObjects(SUSceneRef scene, bool* use_hidden);
 @param[in] use_hidden The new setting for whether or not the hidden
                       property of objects is used.
 @related SUSceneRef
+@see SUSceneGetUseHiddenGeometry
+@see SUSceneSetUseHiddenGeometry
+@see SUSceneGetUseHiddenObjects
 @return
 - \ref SU_ERROR_NONE on success
 - \ref SU_ERROR_INVALID_INPUT if scene is not a valid object
@@ -454,11 +501,13 @@ SU_RESULT SUSceneGetLayers(SUSceneRef scene, size_t len, SULayerRef layers[], si
 /**
 @brief Adds the specified layer to the provided scene.
 
-       Adding a layer to a scene will flag the layer to be the opposite of its
-       default scene visibility. See \ref SULayerVisibilityDefaultType. This
-       function does not take ownership of the specified layer.
+@note Adding a layer to a scene will flag the layer to be the opposite of its
+      default scene visibility. See \ref SULayerVisibilityDefaultType. This
+      function does not take ownership of the specified layer.
+
 @note Prior to SketchUp 2020.0, API 8.0 this function did not return
-      SU_ERROR_INVALID_ARGUMENT.
+      \ref SU_ERROR_INVALID_ARGUMENT.
+
 @since SketchUp 2016, API 4.0
 @param[in] scene The scene object.
 @param[in] layer The new layer to be added to the scene.
@@ -475,11 +524,13 @@ SU_RESULT SUSceneAddLayer(SUSceneRef scene, SULayerRef layer);
 /**
 @brief Removes the specified layer from the provided scene.
 
-       Removing a layer from a scene will flag the layer to use its default
-       scene visibility. See \ref SULayerVisibilityDefaultType. Scenes do not
-       own their layers so removing them doesn't release them.
+@note Removing a layer from a scene will flag the layer to use its default
+      scene visibility. See \ref SULayerVisibilityDefaultType. Scenes do not
+      own their layers so removing them doesn't release them.
+
 @note Prior to SketchUp 2020.0, API 8.0 this function did not return
-      SU_ERROR_INVALID_ARGUMENT.
+      \ref SU_ERROR_INVALID_ARGUMENT.
+
 @since SketchUp 2016, API 4.0
 @param[in] scene The scene object.
 @param[in] layer The layer to be removed from the scene.
@@ -535,11 +586,12 @@ SU_RESULT SUSceneGetLayerFolders(
 /**
 @brief Adds the specified layer folder to the provided scene.
 
-       Adding a layer folder to a scene will cause that layer folder to be
-       flagged as HIDDEN for the specified scene. Any layers or layer folders
-       within that layer folder will also be hidden, and therefore don't need to
-       be added to the scene. This function does not take ownership of the
-       specified layer folder.
+@note Adding a layer folder to a scene will cause that layer folder to be
+      flagged as HIDDEN for the specified scene. Any layers or layer folders
+      within that layer folder will also be hidden, and therefore don't need to
+      be added to the scene. This function does not take ownership of the
+      specified layer folder.
+
 @since SketchUp 2021.0, API 9.0
 @param[in] scene        The scene object.
 @param[in] layer_folder The new layer folder to be added to \p scene.
@@ -556,9 +608,10 @@ SU_RESULT SUSceneAddLayerFolder(SUSceneRef scene, SULayerFolderRef layer_folder)
 /**
 @brief Removes the specified layer folder from the provided scene.
 
-       Removing a layer folder from a scene will cause that layer folder to be
-       flagged as VISIBLE for the specified scene. Scenes do not own their layer
-       folders so removing them doesn't release them.
+@note Removing a layer folder from a scene will cause that layer folder to be
+      flagged as VISIBLE for the specified scene. Scenes do not own their layer
+      folders so removing them doesn't release them.
+
 @since SketchUp 2021.0, API 9.0
 @param[in] scene        The scene object.
 @param[in] layer_folder The layer folder to be removed from \p scene.
@@ -652,31 +705,43 @@ SU_RESULT SUSceneGetHiddenEntities(
 /**
 @brief Sets the flags for a scene object.
 
-See \ref SUSceneFlags "Scene Flags" for available flags that can be combined bitwise.
+@note If this function is called after the scene has been added to the model the API user *must*
+  call SUSceneUpdate(). Otherwise it can lead to a crash while interacting with the model.
+  In general it is recommended to use the separate `SUSceneSetUse*` setters after the scene has
+  been added to the model.
+
+@note \ref FLAG_USE_HIDDEN is deprecated and the bits for \ref FLAG_USE_HIDDEN_GEOMETRY and
+  \ref FLAG_USE_HIDDEN_OBJECTS will take precedence.
 
 @since SketchUp 2017, API 5.0
 @param[in] scene The scene object.
-@param[in] flags The flags to be set.
+@param[in] flags A bitwise combination of \ref SUSceneFlags.
 @related SUSceneRef
 @return
 - \ref SU_ERROR_NONE on success
 - \ref SU_ERROR_INVALID_INPUT if scene is not a valid object
+
+@see SUSceneFlags
+@see SUSceneGetFlags
+@see SUSceneUpdate
 */
 SU_RESULT SUSceneSetFlags(SUSceneRef scene, uint32_t flags);
 
 /**
 @brief Retrieves the flags in the scene object.
 
-See \ref SUSceneFlags "Scene Flags" for available flags that can be combined bitwise.
-
 @since SketchUp 2017, API 5.0
 @param[in]  scene The scene object.
-@param[out] flags The flags.
+@param[out] flags A bitwise combination of \ref SUSceneFlags.
 @related SUSceneRef
 @return
 - \ref SU_ERROR_NONE on success
 - \ref SU_ERROR_INVALID_INPUT if scene is not a valid object
 - \ref SU_ERROR_NULL_POINTER_OUTPUT if flags is NULL
+
+@see SUSceneFlags
+@see SUSceneSetFlags
+
 */
 SU_RESULT SUSceneGetFlags(SUSceneRef scene, uint32_t* flags);
 
@@ -771,7 +836,7 @@ SU_RESULT SUSceneActivate(SUSceneRef scene);
 @brief Set the visibility of a drawing element in a scene.
 @since SketchUp 2020, API 8.0
 @note Only drawing elements at the root of the model, or nested instances of
-      components, groups, and images are controlled by scene visibility.
+       components, groups, and images are controlled by scene visibility.
 @param[in] scene           The scene object.
 @param[in] drawing_element The drawing element object.
 @param[in] is_hidden       The new setting for whether or not the
@@ -829,6 +894,121 @@ SU_RESULT SUSceneGetDescription(SUSceneRef scene, SUStringRef* desc);
 */
 SU_RESULT SUSceneSetDescription(SUSceneRef scene, const char* desc);
 
+/**
+ * @brief Enables the use of an environment for a scene.
+ * @since SketchUp 2025.0, API 13.0
+ * @param[in] scene The scene object.
+ * @param[in] use_environment The setting whether a scene should use an environment.
+ * @related SUSceneRef
+ * @return
+ * - \ref SU_ERROR_NONE on success
+ * - \ref SU_ERROR_INVALID_INPUT if \p scene is not a valid object
+ */
+SU_RESULT SUSceneSetUseEnvironment(SUSceneRef scene, bool use_environment);
+
+/**
+ * @brief Retrieves the setting whether a scene uses an environment.
+ * @since SketchUp 2025.0, API 13.0
+ * @param[in] scene The scene object.
+ * @param[out] use_environment The setting whether a scene should use an environment.
+ * @related SUSceneRef
+ * @return
+ * - \ref SU_ERROR_NONE on success
+ * - \ref SU_ERROR_INVALID_INPUT if \p scene is not a valid object
+ * - \ref SU_ERROR_NULL_POINTER_OUTPUT if \p use_environment is `NULL`
+ */
+SU_RESULT SUSceneGetUseEnvironment(SUSceneRef scene, bool* use_environment);
+
+/**
+ * @brief Sets the environment for a scene.
+ * @since SketchUp 2025.0, API 13.0
+ * @param[in] scene The scene object.
+ * @param[in] environment The environment object to be set.
+ * @related SUSceneRef
+ * @return
+ * - \ref SU_ERROR_NONE on success
+ * - \ref SU_ERROR_INVALID_INPUT if \p scene is not a valid object
+ */
+SU_RESULT SUSceneSetEnvironment(SUSceneRef scene, SUEnvironmentRef environment);
+
+/**
+ * @brief Retrieves the environment of a scene.
+ * @since SketchUp 2025.0, API 13.0
+ * @param[in] scene The scene object.
+ * @param[out] environment The environment object to be retrieved.
+ * @related SUSceneRef
+ * @return
+ * - \ref SU_ERROR_NONE on success
+ * - \ref SU_ERROR_INVALID_INPUT if \p scene is not a valid object
+ * - \ref SU_ERROR_NULL_POINTER_OUTPUT if \p environment is `NULL`
+ * - \ref SU_ERROR_NO_DATA if the scene does not have an environment
+ */
+SU_RESULT SUSceneGetEnvironment(SUSceneRef scene, SUEnvironmentRef* environment);
+
+/**
+ * @brief Retrieves the number of section planes that will be activated when the scene is activated.
+ * @since SketchUp 2025.1, API 13.1
+ * @param[in]  scene The scene object.
+ * @param[out] count The number of section planes.
+ * @related SUSceneRef
+ * @return
+ * - \ref SU_ERROR_NONE on success
+ * - \ref SU_ERROR_INVALID_INPUT if \p scene is not a valid object
+ * - \ref SU_ERROR_NULL_POINTER_OUTPUT if \p count is `NULL`
+ */
+SU_RESULT SUSceneGetNumActiveSectionPlanes(SUSceneRef scene, size_t* count);
+
+/**
+ * @brief Retrieves the section planes that will be activated when the scene is activated.
+ * @since SketchUp 2025.1, API 13.1
+ * @param[in]  scene               The scene object.
+ * @param[in]  len                 The number of section planes to retrieve.
+ * @param[out] active_section_planes The section planes retrieved.
+ * @param[out] count               The number of section planes retrieved.
+ * @related SUSceneRef
+ * @return
+ * - \ref SU_ERROR_NONE on success
+ * - \ref SU_ERROR_INVALID_INPUT if \p scene is not a valid object
+ * - \ref SU_ERROR_NULL_POINTER_OUTPUT if \p active_section_planes or \p count is `NULL`
+ */
+SU_RESULT SUSceneGetActiveSectionPlanes(
+    SUSceneRef scene, size_t len, SUSectionPlaneRef active_section_planes[], size_t* count);
+
+/**
+ * @brief Performs an update on the scene properties based on the current view that the use has.
+ *
+ * What properties of the Scene get updated are controlled via an integer whose bits corresponds to
+ * different properties. These flags can be used individually or combined using bitwise OR.
+ *
+ * @note The properties updated is determined by the AND operation of the passed in \p flags and
+ *   the flags on the scene set by SUSceneSetFlags() or the separate `SUSceneSetUse*` setters.
+ *
+ * @since SketchUp 2025.0, API 13.0
+ *
+ * @param[in] scene The \p scene object.
+ * @param[in] flags The bitwise OR of \ref SUSceneFlags.
+ * @return
+ * - \ref SU_ERROR_NONE on success
+ * - \ref SU_ERROR_INVALID_INPUT if \p scene is not a valid object
+ * - \ref SU_ERROR_INVALID_ARGUMENT if \p scene is not added to a model
+ *
+ * @related SUSceneRef
+ *
+ * @see \ref SUSceneFlags
+ * @see SUSceneSetFlags
+ *
+ * @code
+ *   SUScene scene = SU_INVALID;
+ *   SUSceneCreate(&scene);
+ *   SUSceneSetName(scene, "Example");
+ *   SUSceneSetFlags(scene, FLAG_USE_ALL); // Set the properties to remember.
+ *   SUModelAddScenes(model, 1, &scene);
+ *   // ...
+ *   SUSceneUpdate(scene, FLAG_USE_CAMERA | FLAG_USE_SECTION_PLANES);
+ * @endcode
+ */
+SU_RESULT SUSceneUpdate(SUSceneRef scene, unsigned int flags);
+
 #ifdef __cplusplus
 }
 #endif