scriptup 2026.0.0 → 2026.0.1

data/sketchup-sdk-win/headers/SketchUpAPI/model/defs.h

@@ -1,4 +1,4 @@
-// Copyright 2013-2020 Trimble Inc. All Rights Reserved.
+// Copyright 2012-2024 Trimble Inc. All Rights Reserved.
 
 /**
  * @file
@@ -34,6 +34,8 @@ DEFINE_SU_TYPE(SUEntitiesRef)
 DEFINE_SU_TYPE(SUEntityListRef)
 DEFINE_SU_TYPE(SUEntityListIteratorRef)
 DEFINE_SU_TYPE(SUEntityRef)
+DEFINE_SU_TYPE(SUEnvironmentRef)
+DEFINE_SU_TYPE(SUEnvironmentsRef)
 DEFINE_SU_TYPE(SUFaceRef)
 DEFINE_SU_TYPE(SUFontRef)
 DEFINE_SU_TYPE(SUGeometryInputRef)
@@ -65,6 +67,7 @@ DEFINE_SU_TYPE(SUSchemaTypeRef)
 DEFINE_SU_TYPE(SUSectionPlaneRef)
 DEFINE_SU_TYPE(SUSelectionRef)
 DEFINE_SU_TYPE(SUShadowInfoRef)
+DEFINE_SU_TYPE(SUSnapRef)
 DEFINE_SU_TYPE(SUStyleRef)
 DEFINE_SU_TYPE(SUStylesRef)
 DEFINE_SU_TYPE(SUTextRef)
@@ -87,6 +90,8 @@ enum SURefType {
   SURefType_Curve,                      ///< SUCurveRef type
   SURefType_Edge,                       ///< SUEdgeRef type
   SURefType_EdgeUse,                    ///< SUEdgeUseRef type
+  SURefType_Environment,                ///< SUEnvironment type
+  SURefType_Environments,               ///< SUEnvironments type
   SURefType_Entities,                   ///< SUEntitiesRef type
   SURefType_Face,                       ///< SUFaceRef type
   SURefType_Group,                      ///< SUGroupRef type
@@ -134,7 +139,7 @@ enum SURefType {
   SURefType_LineStyleManager,           ///< SULineStyleManagerRef type
   SURefType_Selection,                  ///< SUSelectionRef type
   SURefType_LayerFolder,                ///< SULayerFolderRef type
-
+  SURefType_Snap,                       ///< SUSnapRef type
 };
 
 #pragma pack(pop)

data/sketchup-sdk-win/headers/SketchUpAPI/model/dimension.h

@@ -191,6 +191,8 @@ SU_RESULT SUDimensionSetArrowType(SUDimensionRef dimension, enum SUArrowType typ
 
 /**
 @brief Get the dimension's font reference.
+@note The returned font reference may become invalid if another font is
+      assigned to this dimension object later.
 @since SketchUp 2019, API 7.0
 @param[in]  dimension The dimension object.
 @param[out] font      The font retrieved.

data/sketchup-sdk-win/headers/SketchUpAPI/model/drawing_element.h

@@ -88,9 +88,9 @@ SU_RESULT SUDrawingElementGetMaterial(SUDrawingElementRef elem, SUMaterialRef* m
 
 The material object must not be subsequently deallocated while associated with
 the drawing element.
-@param[in] elem     The drawing element.
-@param[in] material The material object to set. If an invalid reference is
-                    given, then the material of the element will be removed.
+@param[in,out] elem     The drawing element.
+@param[in]     material The material object to set. If an invalid reference is
+                        given, then the material of the element will be removed.
 @related SUDrawingElementRef
 @return
 - \ref SU_ERROR_NONE on success
@@ -113,8 +113,8 @@ SU_RESULT SUDrawingElementGetLayer(SUDrawingElementRef elem, SULayerRef* layer);
 
 /**
 @brief Sets the layer object to be associated with a drawing element.
-@param[in] elem  The drawing element.
-@param[in] layer The layer object to set.
+@param[in,out] elem  The drawing element.
+@param[in]     layer The layer object to set.
 @related SUDrawingElementRef
 @return
 - \ref SU_ERROR_NONE on success
@@ -124,8 +124,8 @@ SU_RESULT SUDrawingElementSetLayer(SUDrawingElementRef elem, SULayerRef layer);
 
 /**
 @brief Sets the hide flag of a drawing element.
-@param[in] elem      The drawing element.
-@param[in] hide_flag The hide flag to set.
+@param[in,out] elem      The drawing element.
+@param[in]     hide_flag The hide flag to set.
 @related SUDrawingElementRef
 @return
 - \ref SU_ERROR_NONE on success
@@ -147,8 +147,8 @@ SU_RESULT SUDrawingElementGetHidden(SUDrawingElementRef elem, bool* hide_flag);
 
 /**
 @brief Sets the casts shadows flag of a drawing element.
-@param[in] elem               The drawing element.
-@param[in] casts_shadows_flag The casts shadows flag to set.
+@param[in,out] elem               The drawing element.
+@param[in]     casts_shadows_flag The casts shadows flag to set.
 @related SUDrawingElementRef
 @return
 - \ref SU_ERROR_NONE on success
@@ -170,8 +170,8 @@ SU_RESULT SUDrawingElementGetCastsShadows(SUDrawingElementRef elem, bool* casts_
 
 /**
 @brief Sets the receives shadows flag of a drawing element.
-@param[in] elem                  The drawing element.
-@param[in] receives_shadows_flag The casts shadows flag to set.
+@param[in,out] elem                  The drawing element.
+@param[in]     receives_shadows_flag The casts shadows flag to set.
 @related SUDrawingElementRef
 @return
 - \ref SU_ERROR_NONE on success

data/sketchup-sdk-win/headers/SketchUpAPI/model/edge.h

@@ -92,7 +92,7 @@ SU_RESULT SUEdgeCreate(SUEdgeRef* edge, const struct SUPoint3D* start, const str
 
 The edge object must have been created with SUEdgeCreate() and not
 subsequently associated with a parent object (e.g. SUEntitiesAddEdges()).
-@param[in] edge The edge object.
+@param[in,out] edge The edge object.
 @related SUEdgeRef
 @return
 - \ref SU_ERROR_NONE on success
@@ -140,8 +140,8 @@ SU_RESULT SUEdgeGetEndVertex(SUEdgeRef edge, SUVertexRef* vertex);
 
 /**
 @brief Sets the soft flag of an edge object.
-@param[in] edge      The edge object.
-@param[in] soft_flag The soft flag to set.
+@param[in,out] edge      The edge object.
+@param[in]     soft_flag The soft flag to set.
 @related SUEdgeRef
 @return
 - \ref SU_ERROR_NONE on success
@@ -163,8 +163,8 @@ SU_RESULT SUEdgeGetSoft(SUEdgeRef edge, bool* soft_flag);
 
 /**
 @brief Sets the smooth flag of an edge object.
-@param[in] edge        The edge object.
-@param[in] smooth_flag The smooth flag to set.
+@param[in,out] edge        The edge object.
+@param[in]     smooth_flag The smooth flag to set.
 @related SUEdgeRef
 @return
 - \ref SU_ERROR_NONE on success
@@ -238,8 +238,8 @@ SU_RESULT SUEdgeGetLengthWithTransform(
 
 /**
 @brief Sets the color of an edge object.
-@param[in] edge  The edge object.
-@param[in] color The color object to set.
+@param[in,out] edge  The edge object.
+@param[in]     color The color object to set.
 @related SUEdgeRef
 @return
 - \ref SU_ERROR_NONE on success

data/sketchup-sdk-win/headers/SketchUpAPI/model/entities.h

@@ -1,4 +1,4 @@
-// Copyright 2013-2020 Trimble Inc. All Rights Reserved.
+// Copyright 2013-2025 Trimble Inc. All Rights Reserved.
 
 /**
  * @file
@@ -27,7 +27,7 @@ extern "C" {
 /**
 @brief Removes all entities in the container.
 @since SketchUp 2019, API 7.0
-@param[in] entities The entities to clear.
+@param[in,out] entities The entities to clear.
 @related SUEntitiesRef
 @return
 - \ref SU_ERROR_NONE on success
@@ -52,7 +52,7 @@ NOTE: Faces included in the geometry input object will be merged together when
   invisible edges are welded together. Hardness is retained when hard and soft
   edges are welded together.
 
-@param[in] entities      The entities to populate. Must be an empty entities
+@param[in,out] entities  The entities to populate. Must be an empty entities
                          object.
 @param[in] geom_input    The geometry input that the entities object is to be
                          populated with.
@@ -79,13 +79,12 @@ SU_RESULT SUEntitiesGetBoundingBox(SUEntitiesRef entities, struct SUBoundingBox3
 /**
 @brief Retrieves the LLA coordinates (Latidue, Longitude and Altitude) bounding
        box of the given entities object.
-       Note that the altitude is calculated based on the model origin, Example:
-       If an entities object has a bounding box with the following values
-       {{100,100,100}, {200,200,200}} the result will be something like the
-       following: {{Latitude, Longitude, 100/METERS_TO_INCHES},
-       {Latitude, Longitude, 200/METERS_TO_INCHES}} where Latitude and Longitude
-       are the geographical coordinates and altitude is just a conversion from
-       inches to meters.
+
+@note Note that the altitude is calculated based on the model origin. Example: If an entities object
+  has a bounding box with the following values `{100,100,100}`, `{200,200,200}` the result will be
+  something like the following: `{Latitude, Longitude, 100/METERS_TO_INCHES}`, `{Latitude,
+  Longitude, 200/METERS_TO_INCHES}` where Latitude and Longitude are the geographical coordinates
+  and altitude is just a conversion from inches to meters.
 @since SketchUp 2018 M0, API 6.0
 @param[in]  entities The entities object.
 @param[out] bbox     The latidue longitude and altitude bounding box retrieved.
@@ -95,6 +94,29 @@ SU_RESULT SUEntitiesGetBoundingBox(SUEntitiesRef entities, struct SUBoundingBox3
 - \ref SU_ERROR_INVALID_INPUT if entities is not a valid object
 - \ref SU_ERROR_NO_DATA if entities doesn't belong to a valid model.
 - \ref SU_ERROR_NULL_POINTER_OUTPUT if bbox is NULL
+
+@code
+SUModelRef model = SU_INVALID;
+SUModelLoadStatus status;
+SUResult res = SUModelCreateFromFileWithStatus(&model, "path/to/face.skp", &status);
+if (res != SU_ERROR_NONE) {
+    // Handle error
+    return 1;
+}
+
+// Get the entity container of the model
+SUEntitiesRef entities = SU_INVALID;
+SUModelGetEntities(model, &entities);
+
+// Retrieve the bounding box in LLA coordinates
+SUBoundingBox3D box_lla;
+res = SUEntitiesGetBoundingBoxLLA(entities, &box_lla);
+if (res == SU_ERROR_NONE) {
+    // Process box_lla
+}
+
+SUModelRelease(&model);
+@endcode
 */
 SU_RESULT SUEntitiesGetBoundingBoxLLA(SUEntitiesRef entities, struct SUBoundingBox3D* bbox);
 
@@ -307,14 +329,16 @@ SU_RESULT SUEntitiesGetPolyline3ds(
   produces SketchUp models with unexpected state. Avoid using these functions
   and instead use SUGeometryInputRef along with SUEntitiesFill().
 
-@param[in] entities The entities object.
-@param[in] len      The length of the array of face objects.
-@param[in] faces    The array of face objects to add.
+@param[in,out] entities The entities object.
+@param[in]     len      The length of the array of face objects.
+@param[in]     faces    The array of face objects to add.
 @related SUEntitiesRef
 @return
 - \ref SU_ERROR_NONE on success
 - \ref SU_ERROR_INVALID_INPUT if entities is not a valid object
 - \ref SU_ERROR_NULL_POINTER_INPUT if faces is NULL
+
+@own{faces}
 */
 SU_RESULT SUEntitiesAddFaces(SUEntitiesRef entities, size_t len, const SUFaceRef faces[]);
 
@@ -325,14 +349,16 @@ NOTE: This function does not merge geometry, which will likely create an invalid
 SketchUp model. It is recommended to use SUGeometryInput instead which does
 correctly merge geometry.
 
-@param[in] entities The entities object.
-@param[in] len      The length of the array of edge objects.
-@param[in] edges    The array of edge objects to add.
+@param[in,out] entities The entities object.
+@param[in]     len      The length of the array of edge objects.
+@param[in]     edges    The array of edge objects to add.
 @related SUEntitiesRef
 @return
 - \ref SU_ERROR_NONE on success
 - \ref SU_ERROR_INVALID_INPUT if entities is not a valid object
 - \ref SU_ERROR_NULL_POINTER_INPUT if edges is NULL
+
+@own{edges}
 */
 SU_RESULT SUEntitiesAddEdges(SUEntitiesRef entities, size_t len, const SUEdgeRef edges[]);
 
@@ -343,14 +369,16 @@ NOTE: This function does not merge geometry, which will likely create an invalid
 SketchUp model. It is recommended to use SUGeometryInput instead which does
 correctly merge geometry.
 
-@param[in] entities The entities object.
-@param[in] len      The length of the array of curve objects.
-@param[in] curves   The array of curve objects to add.
+@param[in,out] entities The entities object.
+@param[in]     len      The length of the array of curve objects.
+@param[in]     curves   The array of curve objects to add.
 @related SUEntitiesRef
 @return
 - \ref SU_ERROR_NONE on success
 - \ref SU_ERROR_INVALID_INPUT if entities is not a valid object
 - \ref SU_ERROR_NULL_POINTER_INPUT if curves is NULL
+
+@own{curves}
 */
 SU_RESULT SUEntitiesAddCurves(SUEntitiesRef entities, size_t len, const SUCurveRef curves[]);
 
@@ -362,28 +390,32 @@ NOTE: This function does not merge geometry, which will likely create an invalid
 SketchUp model. It is recommended to use SUGeometryInput instead which does
 correctly merge geometry.
 
-@param[in] entities The entities object.
-@param[in] len      The length of the array of curve objects.
-@param[in] curves   The array of arccurve objects to add.
+@param[in,out] entities The entities object.
+@param[in]     len      The length of the array of curve objects.
+@param[in]     curves   The array of arccurve objects to add.
 @related SUEntitiesRef
 @return
 - \ref SU_ERROR_NONE on success
 - \ref SU_ERROR_INVALID_INPUT if entities is not a valid object
 - \ref SU_ERROR_NULL_POINTER_INPUT if curves is NULL
+
+@own{curves}
 */
 SU_RESULT SUEntitiesAddArcCurves(SUEntitiesRef entities, size_t len, const SUArcCurveRef curves[]);
 
 /**
 @brief Adds guide point objects to an entities object.
 @since SketchUp 2014 M1, API 2.1
-@param[in] entities     The entities object.
-@param[in] len          The length of the array of guide point objects.
-@param[in] guide_points The array of guide point objects to add.
+@param[in,out] entities     The entities object.
+@param[in]     len          The length of the array of guide point objects.
+@param[in]     guide_points The array of guide point objects to add.
 @related SUEntitiesRef
 @return
 - \ref SU_ERROR_NONE on success
 - \ref SU_ERROR_INVALID_INPUT if entities is not a valid object
 - \ref SU_ERROR_NULL_POINTER_INPUT if guide_points is NULL
+
+@own{guide_points}
 */
 SU_RESULT SUEntitiesAddGuidePoints(
     SUEntitiesRef entities, size_t len, const SUGuidePointRef guide_points[]);
@@ -391,53 +423,61 @@ SU_RESULT SUEntitiesAddGuidePoints(
 /**
 @brief Adds guide line objects to an entities object.
 @since SketchUp 2016, API 4.0
-@param[in] entities    The entities object.
-@param[in] len         The length of the array of guide line objects.
-@param[in] guide_lines The array of guide line objects to add.
+@param[in,out] entities    The entities object.
+@param[in]     len         The length of the array of guide line objects.
+@param[in]     guide_lines The array of guide line objects to add.
 @related SUEntitiesRef
 @return
 - \ref SU_ERROR_NONE on success
 - \ref SU_ERROR_INVALID_INPUT if entities is not a valid object
 - \ref SU_ERROR_NULL_POINTER_INPUT if guide_lines is NULL
+
+@own{guild_lines}
 */
 SU_RESULT SUEntitiesAddGuideLines(
     SUEntitiesRef entities, size_t len, const SUGuideLineRef guide_lines[]);
 
 /**
 @brief Adds a group object to an entities object.
-@param[in] entities The entities object.
-@param[in] group    The group object to add.
+@param[in,out] entities The entities object.
+@param[in]     group    The group object to add.
 @related SUEntitiesRef
 @return
 - \ref SU_ERROR_NONE on success
 - \ref SU_ERROR_INVALID_INPUT if entities or group is not a valid object
+
+@own{group}
 */
 SU_RESULT SUEntitiesAddGroup(SUEntitiesRef entities, SUGroupRef group);
 
 /**
 @brief Adds an image object to an entities object.
-@param[in] entities The entities object.
-@param[in] image    The image object to add.
+@param[in,out] entities The entities object.
+@param[in]     image    The image object to add.
 @related SUEntitiesRef
 @return
 - \ref SU_ERROR_NONE on success
 - \ref SU_ERROR_INVALID_INPUT if entities or image is not a valid object
+
+@own{image}
 */
 SU_RESULT SUEntitiesAddImage(SUEntitiesRef entities, SUImageRef image);
 
 /**
 @brief Adds a component instance object to the entities.
-@param[in]  entities The entities object.
-@param[in]  instance The component instance object to add.
-@param[out] name     The unique name that is assigned to definition of the
-                     component instance. This can be NULL in which case the
-                     caller does not need to retrieve the assigned name.
+@param[in,out]  entities The entities object.
+@param[in]      instance The component instance object to add.
+@param[out]     name     The unique name that is assigned to definition of the
+                         component instance. This can be NULL in which case the
+                         caller does not need to retrieve the assigned name.
 @related SUEntitiesRef
 @return
 - \ref SU_ERROR_NONE on success
 - \ref SU_ERROR_INVALID_INPUT if entities or instance is not a valid object
 - \ref SU_ERROR_INVALID_OUTPUT if name (when not NULL) does not refer to a valid
   \ref SUStringRef object
+
+@own{instance}
 */
 SU_RESULT SUEntitiesAddInstance(
     SUEntitiesRef entities, SUComponentInstanceRef instance, SUStringRef* name);
@@ -445,14 +485,16 @@ SU_RESULT SUEntitiesAddInstance(
 /**
 @brief Adds section plane objects to an entities object.
 @since SketchUp 2016, API 4.0
-@param[in] entities        The entities object.
-@param[in] len             The length of the array of section planes objects.
-@param[in] section_planes  The array of section planes objects to add.
+@param[in,out] entities        The entities object.
+@param[in]     len             The length of the array of section planes objects.
+@param[in]     section_planes  The array of section planes objects to add.
 @related SUEntitiesRef
 @return
 - \ref SU_ERROR_NONE on success
 - \ref SU_ERROR_INVALID_INPUT if entities is not a valid object
 - \ref SU_ERROR_NULL_POINTER_INPUT if section_planes is NULL
+
+@own{section_planes}
 */
 SU_RESULT SUEntitiesAddSectionPlanes(
     SUEntitiesRef entities, size_t len, const SUSectionPlaneRef section_planes[]);
@@ -460,14 +502,16 @@ SU_RESULT SUEntitiesAddSectionPlanes(
 /**
 @brief Adds text objects to an entities object.
 @since SketchUp 2018, API 6.0
-@param[in] entities The entities object.
-@param[in] len      The length of the array of text objects.
-@param[in] texts    The array of text objects to add.
+@param[in,out] entities The entities object.
+@param[in]     len      The length of the array of text objects.
+@param[in]     texts    The array of text objects to add.
 @related SUEntitiesRef
 @return
 - \ref SU_ERROR_NONE on success
 - \ref SU_ERROR_INVALID_INPUT if entities is not a valid object
 - \ref SU_ERROR_NULL_POINTER_INPUT if texts is NULL
+
+@own{texts}
 */
 SU_RESULT SUEntitiesAddTexts(SUEntitiesRef entities, size_t len, const SUTextRef texts[]);
 
@@ -621,7 +665,7 @@ SU_RESULT SUEntitiesGetNumDimensions(SUEntitiesRef entities, size_t* count);
 - \ref SU_ERROR_NULL_POINTER_OUTPUT if dimensions or count is NULL
 */
 SU_RESULT SUEntitiesGetDimensions(
-    SUEntitiesRef entities, size_t len, SUDimensionRef* dimensions, size_t* count);
+    SUEntitiesRef entities, size_t len, SUDimensionRef dimensions[], size_t* count);
 
 /**
 @brief Retrieves the texts in the entities.
@@ -641,10 +685,10 @@ SU_RESULT SUEntitiesGetTexts(SUEntitiesRef entities, size_t len, SUTextRef texts
 /**
 @brief Applies a 3D transformation to the elements of the provided entity array.
 @since SketchUp 2017, API 5.0
-@param[in] entities The entities object.
-@param[in] len      The number of entities in the array.
-@param[in] elements The elements to be transformed.
-@param[in] trans    The transform to be applied.
+@param[in,out] entities The entities object.
+@param[in]     len      The number of entities in the array.
+@param[in]     elements The elements to be transformed.
+@param[in]     trans    The transform to be applied.
 @related SUEntitiesRef
 @return
 - \ref SU_ERROR_NONE on success
@@ -663,10 +707,10 @@ SU_RESULT SUEntitiesTransform(
        array. The arrays of elements and transformations must be the same
        length.
 @since SketchUp 2017, API 5.0
-@param[in] entities  The entities object.
-@param[in] len       The number of entities in the array.
-@param[in] elements  The elements to be transformed.
-@param[in] tranforms The transformations to be applied.
+@param[in,out] entities  The entities object.
+@param[in]     len       The number of entities in the array.
+@param[in]     elements  The elements to be transformed.
+@param[in]     tranforms The transformations to be applied.
 @related SUEntitiesRef
 @return
 - \ref SU_ERROR_NONE on success
@@ -685,9 +729,9 @@ SU_RESULT SUEntitiesTransformMultiple(
        destroyed, so the array elements are invalidated to prevent user from
        attempting to use destroyed entities.
 @since SketchUp 2017, API 5.0
-@param[in] entities The entities object.
-@param[in] len      The number of entities in the array.
-@param[in] elements The elements to be destroyed.
+@param[in,out] entities The entities object.
+@param[in]     len      The number of entities in the array.
+@param[in]     elements The elements to be destroyed.
 @related SUEntitiesRef
 @return
 - \ref SU_ERROR_NONE on success
@@ -753,10 +797,10 @@ SU_RESULT SUEntitiesEntityListFill(
        curves meet.
 
 @since SketchUp 2020.1, API 8.1
-@param[in]  entities   The entities object to be queried.
-@param[in]  num_edges  The length of the array of edge objects.
-@param[in]  edges      The array of edge objects to weld.
-@param[out] list       The list object to be filled with \ref SUCurveRef objects.
+@param[in,out]  entities   The entities object to be queried.
+@param[in]      num_edges  The length of the array of edge objects.
+@param[in]      edges      The array of edge objects to weld.
+@param[out]     list       The list object to be filled with \ref SUCurveRef objects.
 @related SUEntitiesRef
 @see SUArcCurveRef
 @see SUCurveRef
@@ -816,8 +860,9 @@ SU_RESULT SUEntitiesGetActiveSectionPlane(SUEntitiesRef entities, SUSectionPlane
 @since SketchUp 2021.1, API 9.1
 @bug Before SketchUp 2023.1 (API 11.1) this function would not accept SU_INVALID as a valid
         \p section_plane value and would have returned SU_ERROR_INVALID_INPUT instead
-@param[in] entities
-@param[in] section_plane The section plane to activate or \p SU_INVALID if none should be active.
+@param[in,out] entities
+@param[in]     section_plane The section plane to activate or \p SU_INVALID if none should be
+                             active.
 @related SUEntitiesRef
 @return
 - \ref SU_ERROR_NONE on success

data/sketchup-sdk-win/headers/SketchUpAPI/model/entity.h

@@ -47,6 +47,8 @@ SU_RESULT SUEntityGetID(SUEntityRef entity, int32_t* entity_id);
 @note Only a subset of entity types support PIDs. Refer to the list
       below for which and when support was added.
 
+SketchUp 2025.0
+  - SUEnvironmentRef
 SketchUp 2020.1
   - SUComponentDefinitionRef
   - SUFontRef
@@ -81,6 +83,7 @@ SketchUp 2017
 */
 SU_RESULT SUEntityGetPersistentID(SUEntityRef entity, int64_t* entity_pid);
 
+
 /**
 @brief Retrieves the number of attribute dictionaries of an entity.
 
@@ -118,10 +121,10 @@ SU_RESULT SUEntityGetAttributeDictionaries(
        must not belong to another entity. In other words, each dictionary should
        be added to one entity only.
 @since SketchUp 2018 M0, API 6.0
-@param[in] entity     The entity.
-@param[in] dictionary The dictionary object to be added. If the function is
-                      successful, don't call SUAttributeDictionaryRelease on the
-                      dictionary because the new entity will take ownership.
+@param[in,out] entity     The entity.
+@param[in]     dictionary The dictionary object to be added. If the function is
+                          successful, don't call SUAttributeDictionaryRelease on the
+                          dictionary because the new entity will take ownership.
 @related SUEntityRef
 @return
 - \ref SU_ERROR_NONE on success