scriptup 2026.0.0 → 2026.0.1

data/sketchup-sdk-win/headers/SketchUpAPI/common.h

@@ -1,4 +1,4 @@
-// Copyright 2015 Trimble Inc., All rights reserved.
+// Copyright 2015-2024 Trimble Inc. All rights reserved.
 // This file is intended for public distribution.
 
 /**
@@ -90,13 +90,9 @@ typedef wchar_t unichar;  ///< A platform-independent UTF16 type.
     #endif  // GSLAPI_API_EXPORTS
   #endif    // WINDOWS
 
-  #if defined __APPLE__
+  #if defined __APPLE__ && !defined GSLAPI_NO_EXPORTS
     #undef SU_EXPORT
-    #ifdef GSLAPI_API_EXPORTS
-      #define SU_EXPORT __attribute__((visibility("default")))
-    #else
-      #define SU_EXPORT __attribute__((visibility("hidden")))
-    #endif
+    #define SU_EXPORT __attribute__((visibility("default")))
   #endif  // #if defined __APPLE__
 
   #define DEFINE_SU_TYPE(TYPENAME) \
@@ -104,8 +100,6 @@ typedef wchar_t unichar;  ///< A platform-independent UTF16 type.
       void* ptr;                   \
     } TYPENAME;
 
-  // #define SU_RESULT SU_EXPORT enum SUResult
-
 #endif  // DOXYGEN_SHOULD_SKIP_THIS
 
 /**
@@ -158,6 +152,12 @@ typedef unsigned __int32 uint32_t;
   #include <stdint.h>
 #endif  // #if !defined(__STDC_HOSTED__) || (__STDC_HOSTED__ == 0)
 
+#ifndef __cplusplus
+  // C compilers need this header for the bool type.
+  // This header maps bool to C99's _Bool type.
+  #include <stdbool.h>
+#endif
+
 /**
 @brief This macro is used to indicate if functions are intended to be
        deprecated.  If you would like to hide the deprecation warnings simply

data/sketchup-sdk-win/headers/SketchUpAPI/extension_license.h

@@ -42,7 +42,15 @@ struct SUExtensionLicense {
 };
 
 /**
-@brief Acquires a license for a given extension.
+@brief Gets a license for a given extension.
+
+Starting in SketchUp 2025.0 (API 13.0), this function automatically tries to fetch a license from
+Extension Warehouse if the extension doesn't have a license on the current device. This only works
+if the user is signed in. In earlier SketchUp versions, the user has to go to Extension Manager,
+expand the extension in question and press Update License if the license is missing. (For
+performance reasons this automatic fetching is skipped during SketchUp startup. Make sure to do a
+license check when the user interacts with the extension).
+
 @param[in]  extension_id The Extension Warehouse UUID for the extension.
 @param[out] out_license  the licensing retrieved.
 @related SUExtensionLicense

data/sketchup-sdk-win/headers/SketchUpAPI/geometry/point2d.h

@@ -62,11 +62,11 @@ SU_RESULT SUPoint2DOffset(
     const struct SUPoint2D* point1, const struct SUVector2D* vector, struct SUPoint2D* point2);
 
 /**
-@brief Gets the distance between two point objects.
+@brief Gets the distance between two point objects, in inches.
 @since SketchUp 2017, API 5.0
 @param[in]  point1   The first point object.
 @param[in]  point2   The second point object.
-@param[out] distance The distance between the two points.
+@param[out] distance The distance between the two points, in inches.
 @related SUPoint2D
 @return
 - \ref SU_ERROR_NONE on success

data/sketchup-sdk-win/headers/SketchUpAPI/geometry/point3d.h

@@ -63,11 +63,11 @@ SU_RESULT SUPoint3DOffset(
     const struct SUPoint3D* point1, const struct SUVector3D* vector, struct SUPoint3D* point2);
 
 /**
-@brief Gets the distance between two point objects.
+@brief Gets the distance between two point objects, in inches.
 @since SketchUp 2018 M0, API 6.0
 @param[in]  point1   The first point object.
 @param[in]  point2   The second point object.
-@param[out] distance The distance between the two points.
+@param[out] distance The distance between the two points, in inches.
 @related SUPoint3D
 @return
 - \ref SU_ERROR_NONE on success

data/sketchup-sdk-win/headers/SketchUpAPI/geometry/transformation2d.h

@@ -62,7 +62,7 @@ SU_RESULT SUTransformation2DNonUniformScale(
 @since SketchUp 2019, API 7.0
 @param[out] transform The transformation to be set.
 @param[in]  point     The point specifying the translation component of the
-                      transformation.
+                      transformation. The coordinates of the point are in inches.
 @param[in]  scale     The scale value for the transformation.
 @related SUTransformation2D
 @return
@@ -78,7 +78,7 @@ SU_RESULT SUTransformation2DScaleAboutPoint(
 @since SketchUp 2019, API 7.0
 @param[out] transform The transformation to be set.
 @param[in]  point     The point specifying the translation component of the
-                      transformation.
+                      transformation. The coordinates of the point should be expressed in inches.
 @param[in]  x_scale   The x-axis scale value for the transformation.
 @param[in]  y_scale   The y-axis scale value for the transformation.
 @related SUTransformation2D
@@ -96,7 +96,7 @@ SU_RESULT SUTransformation2DNonUniformScaleAboutPoint(
 @since SketchUp 2019, API 7.0
 @param[out] transform The calculated transformation.
 @param[in]  point     The point specifying the translation component of the
-                      transformation.
+                      transformation. The coordinates of the point should be expressed in inches.
 @param[in]  angle     The rotation in radians for the transformation.
 @related SUTransformation2D
 @return

data/sketchup-sdk-win/headers/SketchUpAPI/geometry/vector2d.h

@@ -121,7 +121,7 @@ SU_RESULT SUVector2DNormalize(struct SUVector2D* vector);
 /**
 @brief Reverses a vector.
 @since SketchUp 2017, API 5.0
-@param[in] vector The vector object.
+@param[in,out] vector The vector object.
 @related SUVector2D
 @return
 - \ref SU_ERROR_NONE on success
@@ -173,10 +173,10 @@ SU_RESULT SUVector2DCross(
 SU_RESULT SUVector2DIsUnitVector(const struct SUVector2D* vector, bool* is_unit_vector);
 
 /**
-@brief Gets the length of a vector.
+@brief Gets the length of a vector, in inches.
 @since SketchUp 2017, API 5.0
 @param[in]  vector The vector object.
-@param[out] length The length of the vector.
+@param[out] length The length of the vector, in inches.
 @related SUVector2D
 @return
 - \ref SU_ERROR_NONE on success
@@ -186,10 +186,10 @@ SU_RESULT SUVector2DIsUnitVector(const struct SUVector2D* vector, bool* is_unit_
 SU_RESULT SUVector2DGetLength(const struct SUVector2D* vector, double* length);
 
 /**
-@brief Sets the length of a vector.
+@brief Sets the length of a vector, in inches.
 @since SketchUp 2017, API 5.0
 @param[in,out] vector The vector object.
-@param[in]     length The new length the vector should be.
+@param[in]     length The new length the vector should be, in inches.
 @related SUVector2D
 @return
 - \ref SU_ERROR_NONE on success

data/sketchup-sdk-win/headers/SketchUpAPI/geometry/vector3d.h

@@ -187,10 +187,10 @@ SU_RESULT SUVector3DCross(
 SU_RESULT SUVector3DIsUnitVector(const struct SUVector3D* vector, bool* is_unit_vector);
 
 /**
-@brief Gets the length of a vector.
+@brief Gets the length of a vector, in inches.
 @since SketchUp 2018, API 6.0
 @param[in]  vector The vector object.
-@param[out] length The length of the vector.
+@param[out] length The length of the vector, in inches.
 @related SUVector3D
 @return
 - \ref SU_ERROR_NONE on success
@@ -200,10 +200,10 @@ SU_RESULT SUVector3DIsUnitVector(const struct SUVector3D* vector, bool* is_unit_
 SU_RESULT SUVector3DGetLength(const struct SUVector3D* vector, double* length);
 
 /**
-@brief Sets the length of a vector.
+@brief Sets the length of a vector, in inches.
 @since SketchUp 2018, API 6.0
 @param[in,out] vector The vector object.
-@param[in]     length The new length the vector should be.
+@param[in]     length The new length the vector should be, in inches.
 @related SUVector3D
 @return
 - \ref SU_ERROR_NONE on success

data/sketchup-sdk-win/headers/SketchUpAPI/geometry.h

@@ -18,7 +18,7 @@ extern "C" {
 
 /**
 @struct SUPoint2D
-@brief Represents a point in 2-dimensional space.
+@brief Represents a point in 2-dimensional space. The coordinates are represented in inches.
 */
 struct SUPoint2D {
   double x;  ///< X coordinate
@@ -27,7 +27,7 @@ struct SUPoint2D {
 
 /**
 @struct SUVector2D
-@brief Represents a vector in 2-dimensional space.
+@brief Represents a vector in 2-dimensional space. The magnitudes are represented in inches.
 */
 struct SUVector2D {
   double x;  ///< X magnitude
@@ -36,7 +36,7 @@ struct SUVector2D {
 
 /**
 @struct SUPoint3D
-@brief Represents a point in 3-dimensional space.
+@brief Represents a point in 3-dimensional space. The coordinates are represented in inches.
 */
 struct SUPoint3D {
   double x;  ///< X coordinate
@@ -46,7 +46,7 @@ struct SUPoint3D {
 
 /**
 @struct SUVector3D
-@brief Represents a vector in 3-dimensional space.
+@brief Represents a vector in 3-dimensional space. The magnitudes are represented in inches.
 */
 struct SUVector3D {
   double x;  ///< X magnitude
@@ -70,7 +70,8 @@ struct SUPlane3D {
 /**
 @struct SUBoundingBox3D
 @brief Represents a 3D axis-aligned bounding box represented by the extreme
-       diagonal corner points with minimum and maximum x,y,z coordinates.
+       diagonal corner points with minimum and maximum x,y,z coordinates. The coordinates of the
+       points are in inches.
 */
 struct SUBoundingBox3D {
   struct SUPoint3D min_point;  ///< A 3D point where x, y and z are minimum
@@ -82,7 +83,7 @@ struct SUBoundingBox3D {
 /**
 @struct SUAxisAlignedRect2D
 @brief Represents a 2D rectangle that is aligned with the X and Y axis of the
-       coordinate system.
+       coordinate system. The coordinates of the points of the rectangle are in inches.
 */
 struct SUAxisAlignedRect2D {
   struct SUPoint2D upper_left;   ///< Upper left corner of the bounding box.
@@ -91,7 +92,8 @@ struct SUAxisAlignedRect2D {
 
 /**
 @struct SURay3D
-@brief Represents a 3D ray defined by a point and normal vector.
+@brief Represents a 3D ray defined by a point and normal vector. The coordinates of the point are
+represented in inches.
 @since SketchUp 2018, API 6.0
 */
 struct SURay3D {

data/sketchup-sdk-win/headers/SketchUpAPI/import_export/modelimporterplugin.h

@@ -18,7 +18,7 @@ enum SketchUpOptionsDialogResponse {
   IMPORTER_OPTIONS_ACCEPTED = 2      ///< Importer options accepted.
 };
 
-/** Return type of GetImporterBehavior(). */
+/** @brief Return type of GetImporterBehavior(). */
 enum SketchUpModelImporterBehavior {
   IMPORT_MODEL_AT_ORIGIN = 0,     ///< Preserves coordinates of the imported
                                   ///< geometry.
@@ -123,7 +123,7 @@ class SketchUpModelImporterInterface {
   @brief  This performs the conversion from the selected input file to the
           given temporary output file using options set during the
           ShowOptionsDialog method.  The output file is then inserted into
-          the current model using rules defined by the GetImporterBehavior
+          the current model using rules defined by the GetImporterBehavior()
           method.
   @param[in] input                     The user selected input file. The file
                                        name is specified in UTF-8 and may
@@ -143,15 +143,19 @@ class SketchUpModelImporterInterface {
   virtual bool ConvertToSkp(
       const std::string& input, const std::string& output_skp,
       SketchUpPluginProgressCallback* progress, void* reserved) = 0;
+
   /**
   @brief Displays a modal dialog showing an optional summary of the import
-         process.  The default does nothing.  Note that Ruby scripting often
-         disables this dialog.
+         process.
+
+  The default does nothing.
   */
   virtual void ShowSummaryDialog() {
   }
+
   /**
   @brief  Defines the method SketchUp uses when placing the imported model.
+  @return The import behavior SketchUp should use when importing the model.
   */
   virtual SketchUpModelImporterBehavior GetImporterBehavior() const {
     return IMPORT_MODEL_PRESERVE_ORIGIN;

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

@@ -92,10 +92,10 @@ SU_RESULT SUAttributeDictionaryGetName(SUAttributeDictionaryRef dictionary, SUSt
 
 /**
 @brief Inserts a key-value pair into an attribute dictionary object.
-@param[in] dictionary The attribute dictionary object.
-@param[in] key        The key of the key-value pair. Assumed to be UTF-8
-                      encoded.
-@param[in] value_in   The value of the key-value pair.
+@param[in,out] dictionary The attribute dictionary object.
+@param[in]     key        The key of the key-value pair. Assumed to be UTF-8
+                          encoded.
+@param[in]     value_in   The value of the key-value pair.
 @related SUAttributeDictionaryRef
 @return
 - \ref SU_ERROR_NONE on success

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

@@ -1,4 +1,4 @@
-// Copyright 2013-2020 Trimble Inc. All Rights Reserved.
+// Copyright 2013-2024 Trimble Inc. All Rights Reserved.
 
 /**
  * @file
@@ -34,24 +34,30 @@ extern "C" {
 @brief  References a component definition.
 */
 
+// The SUSnapToBehavior 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/component_definition_snap_to_behavior_private.h>
+#endif
+
 /**
 @struct SUComponentBehavior
 @brief  Describes how the component behaves in a SketchUp model, e.g. how it glues to surfaces.
+
+@note See \ref SUSnapToBehavior 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 SUSnapToBehavior
+@see SUComponentDefinitionGetBehavior
+@see SUComponentDefinitionSetBehavior
 */
 struct SUComponentBehavior {
-  /**
-  @enum SUSnapToBehavior
-  @brief Describes how the component instance can be placed when a user adds
-         it to a model. For example a window component instance should snap
-         to a vertical plane.
-  */
-  enum SUSnapToBehavior {
-    SUSnapToBehavior_None = 0,
-    SUSnapToBehavior_Any,
-    SUSnapToBehavior_Horizontal,
-    SUSnapToBehavior_Vertical,
-    SUSnapToBehavior_Sloped
-  };
+#ifdef __cplusplus
+  // See the note above for why this is included here.
+  #include <SketchUpAPI/model/component_definition_snap_to_behavior_private.h>
+#endif
 
   /**
   How the component should snap to the surface where it's placed.
@@ -167,7 +173,7 @@ SU_RESULT SUComponentDefinitionCreate(SUComponentDefinitionRef* comp_def);
        the provided definition was contained by a model, use
        SUModelRemoveComponentDefinitions() to remove the definition and all
        instances.
-@param[in] comp_def The component definition object.
+@param[in,out] comp_def The component definition object.
 @related SUComponentDefinitionRef
 @return
 - \ref SU_ERROR_NONE on success
@@ -196,10 +202,10 @@ SU_RESULT SUComponentDefinitionGetName(SUComponentDefinitionRef comp_def, SUStri
 @bug Before SketchUp 2022.0.1 (API 10.0) this would not ensure the definition name was unique.
   As of SketchUp 2022.0.1 the component will be given a unique name automatically if needed.
 
-@param[in] comp_def The component definition object.
-@param[in] name The name of the component definition. Assumed to be UTF-8
-                encoded. If the requested name already belongs to another definition in the model,
-                a unique name will be generated based on this name.
+@param[in,out] comp_def The component definition object.
+@param[in]     name The name of the component definition. Assumed to be UTF-8
+                    encoded. If the requested name already belongs to another definition in the
+                    model, a unique name will be generated based on this name.
 @related SUComponentDefinitionRef
 @return
 - \ref SU_ERROR_NONE on success
@@ -231,8 +237,8 @@ SU_RESULT SUComponentDefinitionGetGuid(SUComponentDefinitionRef comp_def, SUStri
 
 /**
 @brief Retrieves the entities of the component definition.
-@param[in]  comp_def The component definition object.
-@param[out] entities The entities retrieved.
+@param[in,out]  comp_def The component definition object.
+@param[out]     entities The entities retrieved.
 @related SUComponentDefinitionRef
 @return
 - \ref SU_ERROR_NONE on success
@@ -258,8 +264,8 @@ SU_RESULT SUComponentDefinitionGetDescription(SUComponentDefinitionRef comp_def,
 
 /**
 @brief Sets the description of the component definition.
-@param[in] comp_def The component definition object.
-@param[in] desc     The description to be set. Assumed to be UTF-8 encoded.
+@param[in,out] comp_def The component definition object.
+@param[in]     desc     The description to be set. Assumed to be UTF-8 encoded.
 @related SUComponentDefinitionRef
 @return
 - \ref SU_ERROR_NONE on success
@@ -347,34 +353,52 @@ SU_RESULT SUComponentDefinitionGetInstances(
 
 /**
 @brief Retrieves the behavior of a component definition.
+
+@note See \ref SUSnapToBehavior 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]  comp_def The component definition object.
 @param[out] behavior The behavior retrieved.
 @related SUComponentDefinitionRef
 @return
 - \ref SU_ERROR_NONE on success
 - \ref SU_ERROR_INVALID_INPUT if comp_def is invalid
+
+@see SUSnapToBehavior
+@see SUComponentBehavior
+@see SUComponentDefinitionGetBehavior
+@see SUComponentDefinitionSetBehavior
 */
 SU_RESULT SUComponentDefinitionGetBehavior(
     SUComponentDefinitionRef comp_def, struct SUComponentBehavior* behavior);
 
 /**
 @brief Sets the component behavior of a component definition.
-@param[in] comp_def The component definition object.
-@param[in] behavior The behavior to set.
+
+@note See \ref SUSnapToBehavior 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,out] comp_def The component definition object.
+@param[in]     behavior The behavior to set.
 @related SUComponentDefinitionRef
 @return
 - \ref SU_ERROR_NONE on success
 - \ref SU_ERROR_INVALID_INPUT if comp_def is invalid
 - \ref SU_ERROR_NULL_POINTER_INPUT if behavior is NULL
+
+@see SUSnapToBehavior
+@see SUComponentBehavior
+@see SUComponentDefinitionGetBehavior
+@see SUComponentDefinitionSetBehavior
 */
 SU_RESULT SUComponentDefinitionSetBehavior(
     SUComponentDefinitionRef comp_def, const struct SUComponentBehavior* behavior);
 
 /**
 @brief Applies a schema type from a schema to a component definition.
-@param[in] comp_def The component definition object.
-@param[in] schema_ref The schema that owns the schema type to apply.
-@param[in] schema_type_ref The schema type to apply.
+@param[in,out] comp_def The component definition object.
+@param[in]     schema_ref The schema that owns the schema type to apply.
+@param[in]     schema_type_ref The schema type to apply.
 @related SUComponentDefinitionRef
 @return
 - \ref SU_ERROR_NONE on success
@@ -463,6 +487,10 @@ SU_RESULT SUComponentDefinitionGetOpenings(
 /**
 @brief Retrieves the insertion point from the component definition.
 @since SketchUp 2016, API 4.0
+
+@deprecated Starting with SketchUp 2020.0, this function returns the default origin `[0, 0, 0]`, as
+  the insertion point can no longer be changed.
+
 @param[in]  comp_def  The component definition object.
 @param[out] point     The insertion point retrieved.
 @related SUComponentDefinitionRef
@@ -493,7 +521,7 @@ SU_RESULT SUComponentDefinitionGetType(
 @brief Updates the faces in the component definition so that they are oriented
        consistently.
 @since SketchUp 2016, API 4.0
-@param[in] comp_def The component definition object.
+@param[in,out] comp_def The component definition object.
 @related SUComponentDefinitionRef
 @return
 - \ref SU_ERROR_NONE on success
@@ -514,8 +542,8 @@ SU_RESULT SUComponentDefinitionOrientFacesConsistently(SUComponentDefinitionRef
          was changed to \ref SU_ERROR_NULL_POINTER_INPUT for consistency with
          other API methods.
 
-@param[in] comp_def  The component definition object.
-@param[in] point     The \ref SUPoint3D to use.
+@param[in,out] comp_def  The component definition object.
+@param[in]     point     The \ref SUPoint3D to use.
 @related SUComponentDefinitionRef
 @return
 - \ref SU_ERROR_NONE
@@ -527,8 +555,8 @@ SU_RESULT SUComponentDefinitionSetInsertPoint(
 /**
 @brief Sets the axes of the component definition.
 @since SketchUp 2016, API 4.0
-@param[in] comp_def The component definition object.
-@param[in] axes     The \ref SUAxesRef to use.
+@param[in,out] comp_def The component definition object.
+@param[in]     axes     The \ref SUAxesRef to use.
 @related SUComponentDefinitionRef
 @return
 - \ref SU_ERROR_NONE on success
@@ -575,6 +603,19 @@ SU_RESULT SUComponentDefinitionIsLiveComponent(SUComponentDefinitionRef comp_def
 SU_RESULT SUComponentDefinitionSaveToFile(
     SUComponentDefinitionRef comp_def, const char* file_path, enum SUModelVersion version);
 
+/**
+ * @brief Retrieves the flag indicating whether the component definition is manifold.
+ * @since SketchUp 2025.0, API 13.0
+ * @param[in] comp_def The component definition object.
+ * @param[out] is_manifold The bool value retrieved.
+ * @related SUComponentDefinitionRef
+ * @return
+ * - \ref SU_ERROR_NONE on success
+ * - \ref SU_ERROR_INVALID_INPUT if \p comp_def is invalid
+ * - \ref SU_ERROR_NULL_POINTER_OUTPUT if \p is_manifold is NULL
+ */
+SU_RESULT SUComponentDefinitionIsManifold(SUComponentDefinitionRef comp_def, bool* is_manifold);
+
 #ifdef __cplusplus
 }  // extern "C"
 #endif

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

@@ -0,0 +1,46 @@
+/**
+ * @file
+ * @brief Definition for \ref SUSnapToBehavior. Don't include directly.
+ *
+ * @warning Do not include this header directly. This file is part of a
+ *   compatibility shim. Instead include `SketchUpAPI/model/component_definition.h`.
+ */
+
+/**
+@enum SUSnapToBehavior
+@headerfile <SketchUpAPI/model/component_definition.h>
+@brief Describes how the component instance can be placed when a user adds it to a model.
+
+For example a window component instance should snap to a vertical plane.
+
+@see SUComponentBehavior
+
+@bug This enum was incorrectly defined inside the \ref SUComponentBehavior 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:
+SUSnapToBehavior behavior;
+SUComponentDefinitionSetBehavior(component_definition, &behavior);
+if (behavior.component_snap == SUSnapToBehavior_Vertical) {
+  // ...
+}
+@endcode
+
+@code
+// Usage from a C++ compiler:
+SUSnapToBehavior behavior;
+SUComponentDefinitionSetBehavior(component_definition, &behavior);
+if (behavior.component_snap == SUComponentBehavior::SUSnapToBehavior_Vertical) {
+  // ...
+}
+@endcode
+*/
+enum SUSnapToBehavior {
+  SUSnapToBehavior_None = 0,
+  SUSnapToBehavior_Any,
+  SUSnapToBehavior_Horizontal,
+  SUSnapToBehavior_Vertical,
+  SUSnapToBehavior_Sloped
+};

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

@@ -72,9 +72,9 @@ SUComponentInstanceFromDrawingElement(SUDrawingElementRef drawing_elem);
 
 /**
 @brief Sets the name of a component instance object.
-@param[in] instance The component instance object.
-@param[in] name     The name string to set the component instance object.
-                    Assumed to be UTF-8 encoded.
+@param[in,out] instance The component instance object.
+@param[in] name         The name string to set the component instance object.
+                        Assumed to be UTF-8 encoded.
 @related SUComponentInstanceRef
 @return
 - \ref SU_ERROR_NONE on success
@@ -86,7 +86,7 @@ SU_RESULT SUComponentInstanceSetName(SUComponentInstanceRef instance, const char
 /**
 @brief Deallocates a component instance object created with
        SUComponentDefinitionCreateInstance().
-@param[in] instance The component instance object.
+@param[in,out] instance The component instance object.
 @related SUComponentInstanceRef
 @return
 - \ref SU_ERROR_NONE on success
@@ -111,8 +111,8 @@ SU_RESULT SUComponentInstanceGetName(SUComponentInstanceRef instance, SUStringRe
 /**
 @brief Sets the globally unique identifier (guid) string of a instance object.
 @since SketchUp 2015, API 3.0
-@param[in]  instance The component instance object.
-@param[in]  guid     The utf-8 formatted guid string.
+@param[in,out]  instance The component instance object.
+@param[in]      guid     The utf-8 formatted guid string.
 @related SUComponentInstanceRef
 @return
 - \ref SU_ERROR_NONE on success
@@ -141,12 +141,12 @@ SU_RESULT SUComponentInstanceGetGuid(SUComponentInstanceRef instance, SUStringRe
 The transform is relative to the parent component. If the parent component is
 the root component of a model, then the transform is relative to absolute
 coordinates.
-@param[in] instance  The component instance object.
-@param[in] transform The affine transform to set.
+@param[in,out] instance  The component instance object.
+@param[in]     transform The affine transform to set.
 @related SUComponentInstanceRef
 @return
 - \ref SU_ERROR_NONE on success
-- \ref SU_ERROR_INVALID_INPUT if instance is not a valid object
+- \ref SU_ERROR_INVALID_INPUT if instance is not a valid object or transform is non invertible
 - \ref SU_ERROR_NULL_POINTER_INPUT if transform is NULL
 */
 SU_RESULT SUComponentInstanceSetTransform(
@@ -184,8 +184,8 @@ SU_RESULT SUComponentInstanceGetDefinition(
 /**
 @brief Locks the instance if is_locked is true, otherwise unlocks the instance.
 @since SketchUp 2016, API 4.0
-@param[in] instance The instance object.
-@param[in] lock     if true lock the instance, otherwise unlock it.
+@param[in,out] instance The instance object.
+@param[in]     lock     if true lock the instance, otherwise unlock it.
 @related SUComponentInstanceRef
 @return
 - \ref SU_ERROR_NONE on success

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

@@ -56,9 +56,9 @@ SU_EXPORT SUCurveRef SUCurveFromEntity(SUEntityRef entity);
         same as the end position of the previous edge in the array.  Each
         element of the array of edges is subsequently associated with the
         created curve object and must not be deallocated via SUEdgeRelease().
-@param curve The curve object created.
-@param edges The array of edge objects.
-@param len   The number of edge objects in the array.
+@param[out] curve The curve object created.
+@param[in]  edges The array of edge objects.
+@param[in]  len   The number of edge objects in the array.
 @related SUCurveRef
 @return
 - \ref SU_ERROR_NONE on success
@@ -74,7 +74,7 @@ SU_RESULT SUCurveCreateWithEdges(SUCurveRef* curve, const SUEdgeRef edges[], siz
 
 /**
 @brief  Releases a curve object and its associated edge objects.
-@param curve The curve object.
+@param[in,out] curve The curve object.
 @related SUCurveRef
 @return
 - \ref SU_ERROR_NONE on success