scriptup 2026.0.0 → 2026.0.1

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

@@ -1,4 +1,4 @@
-// Copyright 2013-2020 Trimble Inc Ltd. All Rights Reserved.
+// Copyright 2013-2024 Trimble Inc Ltd. All Rights Reserved.
 
 /**
  * @file
@@ -30,26 +30,30 @@ extern "C" {
 @brief A SketchUp model.
 */
 
+// The SUEntityType enum was originally defined incorrectly in this struct.
+// This is not valid C. To correct this we conditionally include it in here for
+// C compilers, while leaving the original definition inside the struct for C++
+// compilers.
+#ifndef __cplusplus
+  #include <SketchUpAPI/model/model_entity_type_private.h>
+#endif
+
 /**
 @struct SUModelStatistics
 @brief Contains an array of entity counts that can be indexed per entity type.
+
+@note See \ref SUEntityType for examples on how it is defined depending on
+  whether the code is compiled as C or C++. (Related to a bug in the original implementation).
+
+@see SUEntityType
+@see SUModelGetStatistics
 */
 struct SUModelStatistics {
-  /**
-  @enum SUEntityType
-  @brief Types of \ref SUEntityRef objects.
-  */
-  enum SUEntityType {
-    SUEntityType_Edge = 0,             ///< SUEdgeRef entities
-    SUEntityType_Face,                 ///< SUFaceRef entities
-    SUEntityType_ComponentInstance,    ///< SUComponentInstanceRef entities
-    SUEntityType_Group,                ///< SUGroupRef entities
-    SUEntityType_Image,                ///< SUImageRef entities
-    SUEntityType_ComponentDefinition,  ///< SUComponentDefinitionRef entities
-    SUEntityType_Layer,                ///< SULayerRef entities
-    SUEntityType_Material,             ///< SUMaterialRef entities
-    SUNumEntityTypes                   ///< Number of entity types
-  };
+#ifdef __cplusplus
+  // See the note above for why this is included here.
+  #include <SketchUpAPI/model/model_entity_type_private.h>
+#endif
+
   int entity_counts[SUNumEntityTypes];  ///< Count of each entity type.
 };
 
@@ -214,7 +218,7 @@ SU_RESULT SUModelCreateFromBufferWithStatus(
 @brief Releases a model object and its associated resources. The root component
        of the model object and all its child objects must not be released
        explicitly
-@param[in] model The model object.
+@param[in,out] model The model object.
 @related SUModelRef
 @return
 - \ref SU_ERROR_NONE on success
@@ -305,12 +309,25 @@ SU_RESULT SUModelGetNumMaterials(SUModelRef model, size_t* count);
 SU_RESULT SUModelGetMaterials(
     SUModelRef model, size_t len, SUMaterialRef materials[], size_t* count);
 
+/**
+ * @brief Retrieves the environments collection in the model.
+ * @since SketchUp 2025.0, API 13.0
+ * @param[in]  model       The model object.
+ * @param[out] environments The environments collection retrieved.
+ * @related SUModelRef
+ * @return
+ * - \ref SU_ERROR_NONE on success
+ * - \ref SU_ERROR_INVALID_INPUT if model is not a valid object
+ * - \ref SU_ERROR_NULL_POINTER_OUTPUT if environments is NULL
+ */
+SU_RESULT SUModelGetEnvironments(SUModelRef model, SUEnvironmentsRef* environments);
+
 /**
 @brief Adds materials to a model object. Note that the materials cannot be
        already owned.
-@param[in] model     The model object.
-@param[in] len       The number of material objects to add.
-@param[in] materials The array of material objects to add.
+@param[in,out] model     The model object.
+@param[in]     len       The number of material objects to add.
+@param[in]     materials The array of material objects to add.
 @related SUModelRef
 @return
 - \ref SU_ERROR_NONE on success
@@ -326,11 +343,11 @@ SU_RESULT SUModelAddMaterials(SUModelRef model, size_t len, const SUMaterialRef
 If a matching material exists in the model it will be returned instead.
 
 @since SketchUp 2021.1, API 9.1
-@param[in]  model      The model object.
-@param[in]  file_path  The location to load the material from. Assumed to be
-                       UTF-8 encoded.
-@param[out] material   The material object.
-@related SUMaterialRef
+@param[in,out]  model      The model object.
+@param[in]      file_path  The location to load the material from. Assumed to be
+                           UTF-8 encoded.
+@param[out]     material   The material object.
+@related SUModelRef
 @return
 - \ref SU_ERROR_NONE on success
 - \ref SU_ERROR_INVALID_INPUT if \p model is not a valid object
@@ -428,9 +445,9 @@ SU_RESULT SUModelGetImageDefinitions(
 
 /**
 @brief Adds component definitions to a model object.
-@param[in] model      The model object.
-@param[in] len        The number of component definitions to add.
-@param[in] components The array of component definitions to add.
+@param[in,out] model      The model object.
+@param[in]     len        The number of component definitions to add.
+@param[in]     components The array of component definitions to add.
 @related SUModelRef
 @return
 - \ref SU_ERROR_NONE on success
@@ -445,9 +462,9 @@ SU_RESULT SUModelAddComponentDefinitions(
        All component definitions, their geometry, and attached instances will be
        released.
 @since SketchUp 2019.2, API 7.1
-@param[in] model      The model object.
-@param[in] len        The number of component definitions to remove.
-@param[in] components The array of component definitions to remove.
+@param[in,out] model      The model object.
+@param[in]     len        The number of component definitions to remove.
+@param[in]     components The array of component definitions to remove.
 @related SUModelRef
 @return
 - \ref SU_ERROR_NONE on success
@@ -513,9 +530,9 @@ SU_RESULT SUModelGetCamera(SUModelRef model, SUCameraRef* camera);
 /**
 @brief Sets the current camera of a model object.
 @since SketchUp 2016, API 4.0
-@param[in] model  The model object.
-@param[in] camera The camera object. This reference will become invalid when
-                  this function returns.
+@param[in,out] model  The model object.
+@param[in,out] camera The camera object. This reference will become invalid when
+                      this function returns.
 @related SUModelRef
 @return
 - \ref SU_ERROR_NONE on success
@@ -571,9 +588,9 @@ SU_RESULT SUModelGetLayers(SUModelRef model, size_t len, SULayerRef layers[], si
 
 /**
 @brief Adds layer objects to a model object.
-@param[in] model  The model object.
-@param[in] len    The number of layers to add.
-@param[in] layers The layers to add.
+@param[in,out] model  The model object.
+@param[in]     len    The number of layers to add.
+@param[in]     layers The layers to add.
 @related SUModelRef
 @return
 - \ref SU_ERROR_NONE on success
@@ -598,9 +615,9 @@ SU_RESULT SUModelGetDefaultLayer(SUModelRef model, SULayerRef* layer);
 @brief Removes all layers provided in the array. The default layer cannot be
 removed. All entities on the deleted layers will be moved to the default layer.
 @since SketchUp 2019.2 API 7.1
-@param[in]  model    The model object.
-@param[in]  len      The length of the array.
-@param[in]  layers   The layers to be deleted.
+@param[in,out]  model    The model object.
+@param[in]      len      The length of the array.
+@param[in]      layers   The layers to be deleted.
 @related SUModelRef
 @return
 - \ref SU_ERROR_NONE on success
@@ -627,8 +644,8 @@ SU_RESULT SUModelGetActiveLayer(SUModelRef model, SULayerRef* layer);
 /**
  @brief Sets the active layer object of a model object.
  @since SketchUp 2020, API 8.0
- @param[in] model The model object.
- @param[in] layer The layer object to be set as the active layer.
+ @param[in,out] model The model object.
+ @param[in]     layer The layer object to be set as the active layer.
  @related SUModelRef
  @return
  - \ref SU_ERROR_NONE on success
@@ -724,6 +741,10 @@ SU_RESULT SUModelGetLocation(SUModelRef model, SULocationRef* location);
 
 /**
 @brief Calculates the sum of all entities by type in the model.
+
+@note See \ref SUEntityType for examples on how it is defined depending on
+  whether the code is compiled as C or C++. (Related to a bug in the original implementation).
+
 @param[in]  model      The model object.
 @param[out] statistics The SUModelStatistics() struct that will be populated
                        with the number of each entity type in the model.
@@ -732,18 +753,36 @@ SU_RESULT SUModelGetLocation(SUModelRef model, SULocationRef* location);
 - \ref SU_ERROR_NONE on success
 - \ref SU_ERROR_INVALID_INPUT if model is not a valid object
 - \ref SU_ERROR_NULL_POINTER_OUTPUT if statistics is NULL
+
+@see SUEntityType
+@see SUModelStatistics
+@see SUModelGetStatistics
+
+@code
+// Usage from a C compiler:
+SUModelStatistics statistics;
+SUModelGetStatistics(model, &statistics);
+std::cout << "Faces: " << statistics.entity_counts[SUEntityType_Face] << "\n";
+@endcode
+
+@code
+// Usage from a C++ compiler:
+SUModelStatistics statistics;
+SUModelGetStatistics(model, &statistics);
+std::cout << "Faces: " << statistics.entity_counts[SUModelStatistics::SUEntityType_Face] << "\n";
+@endcode
 */
 SU_RESULT SUModelGetStatistics(SUModelRef model, struct SUModelStatistics* statistics);
 
 /**
 @brief Georeferences the model.
-@param[in] model               The model object.
-@param[in] latitude            Latitude of the model.
-@param[in] longitude           Longitude of the model.
-@param[in] altitude            Altitude of the model.
-@param[in] is_z_value_centered Indicates if z value should be centered.
-@param[in] is_on_ocean_floor   Indicates whether the model is on the ocean
-                               floor.
+@param[in,out] model               The model object.
+@param[in]     latitude            Latitude of the model.
+@param[in]     longitude           Longitude of the model.
+@param[in]     altitude            Altitude of the model.
+@param[in]     is_z_value_centered Indicates if z value should be centered.
+@param[in]     is_on_ocean_floor   Indicates whether the model is on the ocean
+                                   floor.
 @related SUModelRef
 @return
 - \ref SU_ERROR_NONE on success
@@ -811,7 +850,7 @@ SU_RESULT SUModelGetNorthCorrection(SUModelRef model, double* north_correction);
 
 /**
 @brief Merges all adjacent, coplanar faces in the model.
-@param[in] model The model object.
+@param[in,out] model The model object.
 @related SUModelRef
 @return
 - \ref SU_ERROR_NONE on success
@@ -859,9 +898,12 @@ SU_RESULT SUModelGetSceneWithName(SUModelRef model, const char* name, SUSceneRef
          least one scene name already exists in the model or if there are
          duplicated names in the scenes array.
 
-@param[in] model  The model object.
-@param[in] len    The number of scene objects to add.
-@param[in] scenes The array of scene objects to add.
+@note When adding a scene the current state of the model is saved to the scene
+  based on the \ref SUSceneFlags set on the scene prior to adding it.
+
+@param[in,out] model  The model object.
+@param[in]     len    The number of scene objects to add.
+@param[in]     scenes The array of scene objects to add.
 @related SUModelRef
 @return
 - \ref SU_ERROR_NONE on success
@@ -879,10 +921,10 @@ SU_RESULT SUModelAddScenes(SUModelRef model, size_t len, const SUSceneRef scenes
          SketchUp SDK 2018 API 6.0 to return SU_ERROR_INVALID_ARGUMENT if the
          given scene name already exists in the model.
 
-@param[in]  model     The model object.
-@param[in]  index     Where in the list to add the scene. -1 to place at the end.
-@param[in]  scene     The scene object to add.
-@param[out] out_index The index that the scene was added at.
+@param[in,out]  model     The model object.
+@param[in]      index     Where in the list to add the scene. -1 to place at the end.
+@param[in]      scene     The scene object to add.
+@param[out]     out_index The index that the scene was added at.
 @related SUModelRef
 @return
 - \ref SU_ERROR_NONE on success
@@ -891,6 +933,21 @@ SU_RESULT SUModelAddScenes(SUModelRef model, size_t len, const SUSceneRef scenes
 */
 SU_RESULT SUModelAddScene(SUModelRef model, int index, SUSceneRef scene, int* out_index);
 
+/**
+@brief Reorder \p scene based on \p new_index to \p model object.
+@since SketchUp 2025.0, API 13.0
+@param[in,out] model     The \p model object.
+@param[in]     scene     The \p scene object to reorder.
+@param[in]     new_index The \p new_index where the scene should be placed.
+@related SUModelRef
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if \p model or \p scene are not a valid object
+- \ref SU_ERROR_INVALID_ARGUMENT if \p scene does not exists within \p model
+- \ref SU_ERROR_OUT_OF_RANGE if the \p new_index is greater than the number of scenes in the model
+*/
+SU_RESULT SUModelReorderScene(SUModelRef model, SUSceneRef scene, size_t new_index);
+
 /**
 @brief Retrieves the active scene associated with a model object.
 @since SketchUp 2016, API 4.0
@@ -909,8 +966,8 @@ SU_RESULT SUModelGetActiveScene(SUModelRef model, SUSceneRef* scene);
 /**
 @brief Sets the provided scene as the active scene.
 @since SketchUp 2016, API 4.0
-@param[in] model The model object.
-@param[in] scene The scene object to be set as the active scene.
+@param[in,out] model The model object.
+@param[in]     scene The scene object to be set as the active scene.
 @related SUModelRef
 @return
 - \ref SU_ERROR_NONE on success
@@ -922,11 +979,11 @@ SU_RESULT SUModelSetActiveScene(SUModelRef model, SUSceneRef scene);
 /**
 @brief Adds a single matched photo scene to a model object.
 @since SketchUp 2015, API 3.0
-@param[in]  model      The model object.
-@param[in]  image_file The full path of the image associated with this scene.
-@param[in]  camera     The camera associated with this scene.
-@param[in]  scene_name The name of the scene to add.
-@param[out] scene      The scene object created.
+@param[in,out]  model      The model object.
+@param[in]      image_file The full path of the image associated with this scene.
+@param[in]      camera     The camera associated with this scene.
+@param[in]      scene_name The name of the scene to add.
+@param[out]     scene      The scene object created.
 @related SUModelRef
 @return
 - \ref SU_ERROR_NONE on success
@@ -955,8 +1012,8 @@ SU_RESULT SUModelGetName(SUModelRef model, SUStringRef* name);
 
 /**
 @brief Sets the name of a model object.
-@param[in] model The model object.
-@param[in] name  The name of the model object. Assumed to be UTF-8 encoded.
+@param[in,out] model The model object.
+@param[in]     name  The name of the model object. Assumed to be UTF-8 encoded.
 @related SUModelRef
 @return
 - \ref SU_ERROR_NONE on success
@@ -1011,9 +1068,9 @@ SU_RESULT SUModelGetDescription(SUModelRef model, SUStringRef* description);
 
 /**
 @brief Sets the description of a model object.
-@param[in] model        The model object.
-@param[in] description  The description of the model object. Assumed to be UTF-8
-                        encoded.
+@param[in,out] model        The model object.
+@param[in]     description  The description of the model object. Assumed to be UTF-8
+                            encoded.
 @related SUModelRef
 @return
 - \ref SU_ERROR_NONE on success
@@ -1107,6 +1164,8 @@ SU_RESULT SUModelGetNumFonts(SUModelRef model, size_t* count);
 
 /**
 @brief Retrieves all the fonts associated with a model object.
+@note The returned font references may become invalid if another font is
+      assigned to objects using them later.
 @since SketchUp 2017, API 5.0
 @param[in]  model The model object.
 @param[in]  len   The number of font objects to retrieve.
@@ -1120,6 +1179,81 @@ SU_RESULT SUModelGetNumFonts(SUModelRef model, size_t* count);
 */
 SU_RESULT SUModelGetFonts(SUModelRef model, size_t len, SUFontRef fonts[], size_t* count);
 
+/**
+@brief Current version of the SUFontInfo struct
+@related SUFontRef
+*/
+#define SU_FONT_INFO_VERSION 1
+
+/**
+@struct SUFontInfo
+@brief Information about the font that is to be created by SUModelAddFont.
+@since SketchUp 2026.0, API 14.0
+@related SUFontRef
+*/
+struct SUFontInfo {
+  /**
+  Version of the SUFontInfo struct. Must be set to SU_FONT_INFO_VERSION.
+  */
+  unsigned int version;
+
+  /**
+  Name of the font. Assumed to be UTF-8 encoded.
+  */
+  const char* font_name;
+
+  /**
+  Boldness of the font (true for bold, false for normal).
+  */
+  bool is_bold;
+
+  /**
+  Italic (true for italic, false for normal).
+  */
+  bool is_italic;
+
+  /**
+  2D font size in screen points (when use_world_size is false).
+  */
+  int point_size;
+
+  /**
+  Which sizing style to use.
+
+  - true: font size scales relative to in-model 3D objects.
+  - false: font size stays constant on user's screen.
+  */
+  bool use_world_size;
+
+  /**
+  3D font size in inches (when use_world_size is true).
+  */
+  double world_size;
+};
+
+/**
+@brief Returns an object reference to a font object based on font_info.
+@note The returned font reference may be for either an existing object in the
+      model or a new in-model object if none existed previously. It may also
+      become invalid if assigned to an object which later has a different font
+      assigned to it.
+@since SketchUp 2026.0, API 14.0
+@param[in]   model_ref The model font is to be associated with.
+@param[in]   font_info Struct that defines all parameters of the new font.
+@param[out]  added_font_ref The font object returned.
+@related SUFontRef
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if \p model_ref is not a valid object
+- \ref SU_ERROR_NULL_POINTER_INPUT if \p font_info is NULL
+- \ref SU_ERROR_INVALID_ARGUMENT if \p font_info contains invalid data
+- \ref SU_ERROR_OUT_OF_RANGE if \p font_info contains values that are out of range
+- \ref SU_ERROR_NULL_POINTER_OUTPUT if \p added_font_ref is NULL
+- \ref SU_ERROR_OVERWRITE_VALID if \p added_font_ref already references a valid object
+*/
+SU_RESULT SUModelAddFont(
+    SUModelRef model_ref, const struct SUFontInfo* font_info, SUFontRef* added_font_ref);
+
 /**
 @brief Retrieves the dimension style associated with a model object.
 @since SketchUp 2017, API 5.0
@@ -1174,7 +1308,7 @@ SU_RESULT SUModelGenerateUniqueMaterialName(
 /**
 @brief Fixes any errors found in the given model.
 @since SketchUp 2018, API 6.0
-@param[in]  model  The model object.
+@param[in,out]  model  The model object.
 @related SUModelRef
 @return
 - \ref SU_ERROR_NONE on success
@@ -1186,8 +1320,8 @@ SU_RESULT SUModelFixErrors(SUModelRef model);
 @brief Updates the faces in the model so that they are oriented
        consistently.
 @since SketchUp 2018, API 6.0
-@param[in]  model              The model object.
-@param[in]  recurse_components Orient components of the model.
+@param[in,out]  model              The model object.
+@param[in]      recurse_components Orient components of the model.
 @related SUModelRef
 @return
 - \ref SU_ERROR_NONE on success
@@ -1215,9 +1349,9 @@ SU_RESULT SUModelGetLineStyles(SUModelRef model, SULineStylesRef* line_styles);
             SUModelLoadDefinitionWithStatus() which can load components
             saved by newer versions of SketchUp.
 @since SketchUp 2019.2, API 7.1
-@param[in]  model       The model object.
-@param[in]  filename    The full path and filename to a SkethchUp model.
-@param[out] definition  The component definition that is created after load.
+@param[in,out]  model       The model object.
+@param[in]      filename    The full path and filename to a SkethchUp model.
+@param[out]     definition  The component definition that is created after load.
 @related SUModelRef
 @return
 - \ref SU_ERROR_NONE on success
@@ -1242,12 +1376,12 @@ SU_RESULT SUModelLoadDefinition(
 @warning When reading a file created with a newer version of SketchUp, you may lose data
          if you write over the same file.
 
-@param[in]  model       The model object.
-@param[in]  filename    The full path and filename to a SkethchUp model.
-@param[out] definition  The component definition that is created after load.
-@param[out] status      Returns additional information on the status of a
-                        successful operation. Valid when the return value is
-                        \ref SU_ERROR_NONE.
+@param[in,out]  model       The model object.
+@param[in]      filename    The full path and filename to a SkethchUp model.
+@param[out]     definition  The component definition that is created after load.
+@param[out]     status      Returns additional information on the status of a
+                            successful operation. Valid when the return value is
+                            \ref SU_ERROR_NONE.
 @related SUModelRef
 @return
 - \ref SU_ERROR_NONE on success
@@ -1267,9 +1401,9 @@ SU_RESULT SUModelLoadDefinitionWithStatus(
 /**
 @brief Removes all materials provided in the array.
 @since SketchUp 2019.2, API 7.1
-@param[in]  model       The model object.
-@param[in]  len         The length of the array.
-@param[in]  materials   The materials to be deleted.
+@param[in,out]  model       The model object.
+@param[in]      len         The length of the array.
+@param[in]      materials   The materials to be deleted.
 @related SUModelRef
 @return
 - \ref SU_ERROR_NONE on success
@@ -1284,9 +1418,9 @@ SU_RESULT SUModelRemoveMaterials(SUModelRef model, size_t len, SUMaterialRef mat
 /**
 @brief Removes selected scenes from a model.
 @since SketchUp 2019.2, API 7.1
-@param[in] model  The model object.
-@param[in] len    The number of scenes in the array for removal.
-@param[in] scenes The scenes to be deleted from the model.
+@param[in,out] model  The model object.
+@param[in]     len    The number of scenes in the array for removal.
+@param[in]     scenes The scenes to be deleted from the model.
 @related SUModelRef
 @return
 - \ref SU_ERROR_NONE on success
@@ -1474,13 +1608,13 @@ SU_RESULT SUModelGetNumLayerFolders(SUModelRef model, size_t* count);
  - \ref SU_ERROR_NULL_POINTER_OUTPUT if \p layer_folders or \p count is NULL
  */
 SU_RESULT SUModelGetLayerFolders(
-    SUModelRef model, size_t len, SULayerFolderRef* layer_folders, size_t* count);
+    SUModelRef model, size_t len, SULayerFolderRef layer_folders[], size_t* count);
 
 /**
  @brief Removes empty \ref SULayerFolderRef objects from the model.
  @since SketchUp 2021.0, API 9.0
- @param[in]  model          The model object.
- @param[out]  count         The number of empty layer folders removed. If NULL,
+ @param[in,out]  model          The model object.
+ @param[out]     count         The number of empty layer folders removed. If NULL,
                             count will not be retrieved.
  @related SUModelRef
  @return
@@ -1492,8 +1626,8 @@ SU_RESULT SUModelPurgeEmptyLayerFolders(SUModelRef model, size_t* count);
 /**
  @brief Adds a \ref SULayerFolderRef object to the model.
  @since SketchUp 2021.0, API 9.0
- @param[in]  model          The model object.
- @param[in]  layer_folder   The layer folder to add.
+ @param[in,out]  model          The model object.
+ @param[in]      layer_folder   The layer folder to add.
  @related SUModelRef
  @return
  - \ref SU_ERROR_NONE on success
@@ -1507,9 +1641,9 @@ SU_RESULT SUModelAddLayerFolder(SUModelRef model, SULayerFolderRef layer_folder)
 /**
  @brief Removes unused \ref SULayerRef objects from the model.
  @since SketchUp 2020.2, API 8.2
- @param[in]  model          The model object.
- @param[out]  count         The number of layers deleted. If NULL, count
-                            will not be retrieved.
+ @param[in,out]  model          The model object.
+ @param[out]     count          The number of layers deleted. If NULL, count
+                                will not be retrieved.
  @related SUModelRef
  @return
  - \ref SU_ERROR_NONE on success
@@ -1554,9 +1688,9 @@ SU_RESULT SUModelGetTopLevelLayers(
  @brief Removes all layer folders provided in the array. All children of the
  deleted layer folders will be moved to the parent of the deleted folder.
  @since SketchUp 2021.0, API 9.0
- @param[in]  model          The model object.
- @param[in]  len            The length of the array.
- @param[in]  layer_folders  The layer folders to be deleted.
+ @param[in,out]  model          The model object.
+ @param[in]      len            The length of the array.
+ @param[in]      layer_folders  The layer folders to be deleted.
  @related SUModelRef
  @return
  - \ref SU_ERROR_NONE on success
@@ -1640,8 +1774,8 @@ SU_RESULT SUModelGetBehavior(SUModelRef model, struct SUComponentBehavior* behav
 /**
 @brief Sets the component behavior of a SketchUp model.
 @since SketchUp 2021.1, API 9.1
-@param[in] model    The model object.
-@param[in] behavior The behavior to set.
+@param[in,out] model    The model object.
+@param[in]     behavior The behavior to set.
 @related SUModelRef
 @return
 - \ref SU_ERROR_NONE on success
@@ -1650,6 +1784,35 @@ SU_RESULT SUModelGetBehavior(SUModelRef model, struct SUComponentBehavior* behav
 */
 SU_RESULT SUModelSetBehavior(SUModelRef model, const struct SUComponentBehavior* behavior);
 
+/**
+ * @brief Retrieves the number of active section planes in the model.
+ * @since SketchUp 2025.1, API 13.1
+ * @param[in] model The model object.
+ * @param[out] count The number of active section planes.
+ * @related SUModelRef
+ * @return
+ * - \ref SU_ERROR_NONE on success
+ * - \ref SU_ERROR_INVALID_INPUT if \p model is not a valid object
+ * - \ref SU_ERROR_NULL_POINTER_OUTPUT if \p count is `NULL`
+ */
+SU_RESULT SUModelGetNumActiveSectionPlanes(SUModelRef model, size_t* count);
+
+/**
+ * @brief Retrieves the active section planes in the model.
+ * @since SketchUp 2025.1, API 13.1
+ * @param[in]  model               The model object.
+ * @param[in]  len                 The number of active section planes to retrieve.
+ * @param[out] active_section_planes The active section planes retrieved.
+ * @param[out] count               The number of active section planes retrieved.
+ * @related SUModelRef
+ * @return
+ * - \ref SU_ERROR_NONE on success
+ * - \ref SU_ERROR_INVALID_INPUT if \p model is not a valid object
+ * - \ref SU_ERROR_NULL_POINTER_OUTPUT if \p active_section_planes or \p count is `NULL`
+ */
+SU_RESULT SUModelGetActiveSectionPlanes(
+    SUModelRef model, size_t len, SUSectionPlaneRef active_section_planes[], size_t* count);
+
 #ifdef __cplusplus
 }
 #endif

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

@@ -0,0 +1,44 @@
+/**
+ * @file
+ * @brief Definition for \ref SUEntityType. Don't include directly.
+ *
+ * @warning Do not include this header directly. This file is part of a
+ *   compatibility shim. Instead include `SketchUpAPI/model.h`.
+ */
+
+/**
+@enum SUEntityType
+@headerfile <SketchUpAPI/model.h>
+@brief Types of \ref SUEntityRef objects.
+
+@see SUModelStatistics
+
+@bug This enum was incorrectly defined inside the \ref SUModelStatistics struct. This is
+  not valid C. As of SketchUp 2025.0 (API 13.0), this enum is conditionally defined outside
+  of the struct when the header is consumed by a C compiler.
+
+@code
+// Usage from a C compiler:
+SUModelStatistics statistics;
+SUModelGetStatistics(model, &statistics);
+std::cout << "Faces: " << statistics.entity_counts[SUEntityType_Face] << "\n";
+@endcode
+
+@code
+// Usage from a C++ compiler:
+SUModelStatistics statistics;
+SUModelGetStatistics(model, &statistics);
+std::cout << "Faces: " << statistics.entity_counts[SUModelStatistics::SUEntityType_Face] << "\n";
+@endcode
+*/
+enum SUEntityType {
+  SUEntityType_Edge = 0,             ///< SUEdgeRef entities
+  SUEntityType_Face,                 ///< SUFaceRef entities
+  SUEntityType_ComponentInstance,    ///< SUComponentInstanceRef entities
+  SUEntityType_Group,                ///< SUGroupRef entities
+  SUEntityType_Image,                ///< SUImageRef entities
+  SUEntityType_ComponentDefinition,  ///< SUComponentDefinitionRef entities
+  SUEntityType_Layer,                ///< SULayerRef entities
+  SUEntityType_Material,             ///< SUMaterialRef entities
+  SUNumEntityTypes                   ///< Number of entity types
+};