scriptup 2026.0.0 → 2026.0.1

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

@@ -0,0 +1,183 @@
+// Copyright 2024 Trimble Inc. All Rights Reserved.
+
+/**
+ * @file
+ * @brief Interfaces for SUSnapRef.
+ */
+#ifndef SKETCHUP_MODEL_SNAP_H_
+#define SKETCHUP_MODEL_SNAP_H_
+
+#include <SketchUpAPI/common.h>
+#include <SketchUpAPI/geometry.h>
+#include <SketchUpAPI/model/defs.h>
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/**
+@struct SUSnapRef
+@extends SUDrawingElementRef
+@brief  References a snap.
+@since SketchUp 2025.0, API 13.0
+
+A Snap is a custom grip used by SketchUp's Move tool. Snaps can be added at strategic places such
+as connectors to help assembling objects.
+
+\image html snaps.png
+
+SUSnapGetDirection() is the direction a snap is "pointing". This can be thought of as the normal
+direction of the snap. It can also be thought of as the direction you move an object when plugging
+it into another object, e.g. inserting a power coord.
+
+SUSnapGetUp() controls the rotation around the Snap's axis.
+
+When two objects are snapped together, the Snaps have opposite SUSnapGetDirection() vectors but
+matching SUSnapGetUp() vectors.
+*/
+
+/**
+@brief Converts from an \ref SUSnapRef to an \ref SUEntityRef.
+       This is essentially an upcast operation.
+@since SketchUp 2025.0, API 13.0
+@param[in] snap The given snap reference.
+@related SUSnapRef
+@return
+- The converted SUEntityRef if \p snap is a valid snap.
+- If not, the returned reference will be invalid.
+*/
+SU_EXPORT SUEntityRef SUSnapToEntity(SUSnapRef snap);
+
+/**
+@brief Converts from an \ref SUEntityRef to an \ref SUSnapRef.
+       This is essentially a downcast operation so the given entity must be
+       convertible to an \ref SUSnapRef.
+@since SketchUp 2025.0, API 13.0
+@param[in] entity The given entity reference.
+@related SUSnapRef
+@return
+- The converted SUSnapRef if the downcast operation succeeds
+- If not, the returned reference will be invalid
+*/
+SU_EXPORT SUSnapRef SUSnapFromEntity(SUEntityRef entity);
+
+/**
+@brief Converts from an \ref SUSnapRef to an \ref SUDrawingElementRef.
+       This is essentially an upcast operation.
+@since SketchUp 2025.0, API 13.0
+@param[in] snap The given snap reference.
+@related SUSnapRef
+@return
+- The converted \ref SUEntityRef if \p snap is a valid snap.
+- If not, the returned reference will be invalid.
+*/
+SU_EXPORT SUDrawingElementRef SUSnapToDrawingElement(SUSnapRef snap);
+
+/**
+@brief Converts from an \ref SUDrawingElementRef to an \ref SUSnapRef.
+       This is essentially a downcast operation so the given element must be
+       convertible to an SUSnapRef.
+@since SketchUp 2025.0, API 13.0
+@param[in] drawing_elem The given element reference.
+@related SUSnapRef
+@return
+- The converted \ref SUSnapRef if the downcast operation succeeds
+- If not, the returned reference will be invalid
+*/
+SU_EXPORT SUSnapRef SUSnapFromDrawingElement(SUDrawingElementRef drawing_elem);
+
+/**
+@brief Creates a snap at the given position and orientation.
+@since SketchUp 2025.0, API 13.0
+@param[out] snap       The snap object created.
+@param[in]  position   The position of the snap.
+@param[in]  direction  The orientation of the snap. Pass `NULL` to use the default orientation.
+@param[in]  up         The up vector controls the rotation around the \p orientation of the snap.
+                       Pass `NULL` to use the default up vector.
+@related SUSnapRef
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_ARGUMENT if \p direction an \p up are parallel.
+- \ref SU_ERROR_NULL_POINTER_OUTPUT if \p snap is `NULL`
+- \ref SU_ERROR_OVERWRITE_VALID if \p snap already refers to a valid object
+*/
+SU_RESULT SUSnapCreate(
+    SUSnapRef* snap, const struct SUPoint3D position, const struct SUVector3D* direction,
+    const struct SUVector3D* up);
+
+/**
+@brief Releases a snap object and its associated resources.
+@since SketchUp 2025.0, API 13.0
+@param[in] snap The snap object.
+@related SUSnapRef
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_NULL_POINTER_INPUT if \p snap points to an `NULL`
+- \ref SU_ERROR_INVALID_INPUT if the \p snap object is not a valid object.
+*/
+SU_RESULT SUSnapRelease(SUSnapRef* snap);
+
+/**
+@brief Retrieves the position of a snap.
+@since SketchUp 2025.0, API 13.0
+@param[in]  snap     The snap object.
+@param[out] position The position retrieved.
+@related SUSnapRef
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if \p snap point is an invalid object
+- \ref SU_ERROR_NULL_POINTER_OUTPUT if position is `NULL`
+*/
+SU_RESULT SUSnapGetPosition(SUSnapRef snap, struct SUPoint3D* position);
+
+/**
+@brief Retrieves the orientation of a snap.
+@since SketchUp 2025.0, API 13.0
+@param[in]  snap      The snap object.
+@param[out] direction The direction of the snap.
+@related SUSnapRef
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if \p snap point is an invalid object
+- \ref SU_ERROR_NULL_POINTER_OUTPUT if direction is `NULL`
+*/
+SU_RESULT SUSnapGetDirection(SUSnapRef snap, struct SUVector3D* direction);
+
+/**
+@brief Retrieves the up vector of a snap.
+@since SketchUp 2025.0, API 13.0
+@param[in]  snap The snap object.
+@param[out] up   The up vector of the snap.
+@related SUSnapRef
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if \p snap point is an invalid object
+- \ref SU_ERROR_NULL_POINTER_OUTPUT if up is `NULL`
+*/
+
+SU_RESULT SUSnapGetUp(SUSnapRef snap, struct SUVector3D* up);
+/**
+@brief Sets the position, direction and up vector of the snap.
+
+If only \p position is provided then \p direction and \p up remains unchanged.
+
+@since SketchUp 2025.0, API 13.0
+@param[in] snap      The snap object.
+@param[in] position  The position of the snap.
+@param[in] direction The orientation of the snap. Pass `NULL` to use the default orientation.
+@param[in] up        The up vector of the snap. Pass `NULL` to use the default up vector.
+@related SUSnapRef
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_ARGUMENT if \p direction an \p up are parallel.
+- \ref SU_ERROR_NULL_POINTER_INPUT if \p snap is `NULL`
+*/
+SU_RESULT SUSnapSet(
+    SUSnapRef snap, const struct SUPoint3D position, const struct SUVector3D* direction,
+    const struct SUVector3D* up);
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif  // SKETCHUP_MODEL_SNAP_H_

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

@@ -0,0 +1,26 @@
+// Copyright 2024 Trimble Inc. All Rights Reserved.
+
+/**
+ * @file
+ * @brief Interfaces for SUSpaceRef.
+
+  For internal use only at this time. APIs may change.
+ */
+#ifndef SKETCHUP_MODEL_SPACE_H_
+#define SKETCHUP_MODEL_SPACE_H_
+
+#include <SketchUpAPI/common.h>
+#include <SketchUpAPI/geometry.h>
+#include <SketchUpAPI/model/defs.h>
+
+// Forward declarations
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+#ifdef __cplusplus
+}  //  extern "C" {
+#endif
+
+#endif  // SKETCHUP_MODEL_SPACE_H_

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

@@ -1,4 +1,4 @@
-// Copyright 2015 Trimble Inc. All Rights Reserved.
+// Copyright 2015-2025 Trimble Inc. All Rights Reserved.
 
 /**
  * @file
@@ -33,9 +33,9 @@ NOTE: Return value SU_ERROR_SERIALIZATION was added for SketchUp 2019, API 7.0
 @related SUStylesRef
 @return
 - \ref SU_ERROR_NONE on success
-- \ref SU_ERROR_INVALID_INPUT if styles is not a valid object
-- \ref SU_ERROR_NULL_POINTER_INPUT if name is NULL
-- \ref SU_ERROR_SERIALIZATION if style couldn't be created from the file at path
+- \ref SU_ERROR_INVALID_INPUT if \p styles is not a valid object
+- \ref SU_ERROR_NULL_POINTER_INPUT if \p name is NULL
+- \ref SU_ERROR_SERIALIZATION if \p style couldn't be created from the file at \p path
 - \ref SU_ERROR_DUPLICATE if the name corresponds to an existing style
 */
 SU_RESULT SUStylesAddStyle(SUStylesRef styles, const char* path, bool activate);
@@ -48,8 +48,8 @@ SU_RESULT SUStylesAddStyle(SUStylesRef styles, const char* path, bool activate);
 @related SUStylesRef
 @return
 - \ref SU_ERROR_NONE on success
-- \ref SU_ERROR_INVALID_INPUT if styles is not a valid object
-- \ref SU_ERROR_NULL_POINTER_OUTPUT if count is NULL
+- \ref SU_ERROR_INVALID_INPUT if \p styles is not a valid object
+- \ref SU_ERROR_NULL_POINTER_OUTPUT if \p count is NULL
 */
 SU_RESULT SUStylesGetNumStyles(SUStylesRef styles, size_t* count);
 
@@ -63,8 +63,8 @@ SU_RESULT SUStylesGetNumStyles(SUStylesRef styles, size_t* count);
 @related SUStylesRef
 @return
 - \ref SU_ERROR_NONE on success
-- \ref SU_ERROR_INVALID_INPUT if styles is not a valid object
-- \ref SU_ERROR_NULL_POINTER_OUTPUT if style_array or count is NULL
+- \ref SU_ERROR_INVALID_INPUT if \p styles is not a valid object
+- \ref SU_ERROR_NULL_POINTER_OUTPUT if \p style_array or \p count is NULL
 */
 SU_RESULT SUStylesGetStyles(
     SUStylesRef styles, size_t len, SUStyleRef style_array[], size_t* count);
@@ -77,8 +77,8 @@ SU_RESULT SUStylesGetStyles(
 @related SUStylesRef
 @return
 - \ref SU_ERROR_NONE on success
-- \ref SU_ERROR_INVALID_INPUT if styles is not a valid object
-- \ref SU_ERROR_NULL_POINTER_OUTPUT if style is NULL
+- \ref SU_ERROR_INVALID_INPUT if \p styles is not a valid object
+- \ref SU_ERROR_NULL_POINTER_OUTPUT if \p style is NULL
 */
 SU_RESULT SUStylesGetActiveStyle(SUStylesRef styles, SUStyleRef* style);
 
@@ -90,8 +90,8 @@ SU_RESULT SUStylesGetActiveStyle(SUStylesRef styles, SUStyleRef* style);
 @related SUStylesRef
 @return
 - \ref SU_ERROR_NONE on success
-- \ref SU_ERROR_INVALID_INPUT if styles is not a valid object
-- \ref SU_ERROR_NULL_POINTER_OUTPUT if style is NULL
+- \ref SU_ERROR_INVALID_INPUT if \p styles is not a valid object
+- \ref SU_ERROR_NULL_POINTER_OUTPUT if \p style is NULL
 */
 SU_RESULT SUStylesGetSelectedStyle(SUStylesRef styles, SUStyleRef* style);
 
@@ -104,9 +104,9 @@ SU_RESULT SUStylesGetSelectedStyle(SUStylesRef styles, SUStyleRef* style);
 @related SUStylesRef
 @return
 - \ref SU_ERROR_NONE on success
-- \ref SU_ERROR_INVALID_INPUT if styles is not a valid object
-- \ref SU_ERROR_NULL_POINTER_INPUT if guid is NULL
-- \ref SU_ERROR_NULL_POINTER_OUTPUT if style is NULL
+- \ref SU_ERROR_INVALID_INPUT if \p styles is not a valid object
+- \ref SU_ERROR_NULL_POINTER_INPUT if \p guid is NULL
+- \ref SU_ERROR_NULL_POINTER_OUTPUT if \p style is NULL
 */
 SU_RESULT SUStylesGetStyleByGuid(SUStylesRef styles, const char* guid, SUStyleRef* style);
 
@@ -119,10 +119,10 @@ SU_RESULT SUStylesGetStyleByGuid(SUStylesRef styles, const char* guid, SUStyleRe
 @related SUStylesRef
 @return
 - \ref SU_ERROR_NONE on success
-- \ref SU_ERROR_INVALID_INPUT if styles is not a valid object
-- \ref SU_ERROR_NULL_POINTER_INPUT if path is NULL
-- \ref SU_ERROR_NULL_POINTER_OUTPUT if style is NULL
-- \ref SU_ERROR_NO_DATA if no style in styles matches the style at path.
+- \ref SU_ERROR_INVALID_INPUT if \p styles is not a valid object
+- \ref SU_ERROR_NULL_POINTER_INPUT if \p path is NULL
+- \ref SU_ERROR_NULL_POINTER_OUTPUT if \p style is NULL
+- \ref SU_ERROR_NO_DATA if no style in \p styles matches the \p style at \p path.
 */
 SU_RESULT SUStylesGetStyleByPath(SUStylesRef styles, const char* path, SUStyleRef* style);
 
@@ -134,8 +134,8 @@ SU_RESULT SUStylesGetStyleByPath(SUStylesRef styles, const char* path, SUStyleRe
 @related SUStylesRef
 @return
 - \ref SU_ERROR_NONE on success
-- \ref SU_ERROR_INVALID_INPUT if styles is not a valid object
-- \ref SU_ERROR_NULL_POINTER_OUTPUT if changed is NULL
+- \ref SU_ERROR_INVALID_INPUT if \p styles is not a valid object
+- \ref SU_ERROR_NULL_POINTER_OUTPUT if \p changed is NULL
 */
 SU_RESULT SUStylesGetActiveStyleChanged(SUStylesRef styles, bool* changed);
 
@@ -148,20 +148,22 @@ SU_RESULT SUStylesGetActiveStyleChanged(SUStylesRef styles, bool* changed);
 @related SUStylesRef
 @return
 - \ref SU_ERROR_NONE on success
-- \ref SU_ERROR_INVALID_INPUT if any of styles, style, or scene are not
+- \ref SU_ERROR_INVALID_INPUT if any of \p styles, \p style, or \p scene are not
                               valid objects
 */
 SU_RESULT SUStylesApplyStyleToScene(SUStylesRef styles, SUStyleRef style, SUSceneRef scene);
 
 /**
 @brief Sets the selected style.
+@bug Prior to SketchUp 2025.0 setting the selected style to the active style would crash.
 @since SketchUp 2019.2, API 7.1
 @param[in] styles The styles object.
 @param[in] style  The style object.
 @related SUStylesRef
 @return
 - \ref SU_ERROR_NONE on success
-- \ref SU_ERROR_INVALID_INPUT if styles or style are not valid objects
+- \ref SU_ERROR_INVALID_INPUT if \p styles or \p style are not valid objects
+- \ref SU_ERROR_INVALID_ARGUMENT if \p style is the active style
 */
 SU_RESULT SUStylesSetSelectedStyle(SUStylesRef styles, SUStyleRef style);
 
@@ -176,10 +178,10 @@ SU_RESULT SUStylesSetSelectedStyle(SUStylesRef styles, SUStyleRef style);
 @related SUStylesRef
 @return
 - \ref SU_ERROR_NONE on success
-- \ref SU_ERROR_INVALID_INPUT if styles is not a valid object
-- \ref SU_ERROR_NULL_POINTER_INPUT if style is NULL
-- \ref SU_ERROR_INVALID_ARGUMENT if style is not within styles
-- \ref SU_ERROR_OUT_OF_RANGE if the style is the last style in the manager
+- \ref SU_ERROR_INVALID_INPUT if \p styles is not a valid object
+- \ref SU_ERROR_NULL_POINTER_INPUT if \p style is NULL
+- \ref SU_ERROR_INVALID_ARGUMENT if \p style is not within styles
+- \ref SU_ERROR_OUT_OF_RANGE if the \p style is the last style in the manager
 */
 SU_RESULT SUStylesRemoveStyle(SUStylesRef styles, SUStyleRef* style);
 

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

@@ -155,7 +155,9 @@ SU_RESULT SUTextGetString(SUTextRef text, SUStringRef* string);
 SU_RESULT SUTextSetFont(SUTextRef text, SUFontRef font);
 
 /**
-@brief Retrieves the font from the text object
+@brief Retrieves the font from the text object.
+@note The returned font reference may become invalid if another font is
+      assigned to this text object later.
 @since SketchUp 2018, API 6.0
 @param[in]  text The text object.
 @param[out] font The font retrieved.
@@ -274,16 +276,22 @@ SU_RESULT SUTextGetArrowType(SUTextRef text, enum SUArrowType* arrow_type);
 SU_RESULT SUTextSetPoint(SUTextRef text, const struct SUPoint3D* point, SUInstancePathRef path);
 
 /**
- @brief Retrieves the point associated with the text object. The given instance
-        path object either must have been constructed using one of the
-        SUInstancePathCreate* functions or it will be generated on the fly if it
-        is invalid. It must be released using SUInstancePathRelease() when it
-        is no longer needed.
+ @brief Retrieves the point associated with the text object.
+
+The given instance path object either must have been constructed using one of the
++SUInstancePathCreate*+ functions or it will be generated on the fly if it
+is invalid. It must be released using SUInstancePathRelease() when it is no longer needed.
+
 @since SketchUp 2018, API 6.0
+
 @param[in]  text  The text object.
 @param[out] point The point retrieved.
 @param[out] path  The path retrieved.
 @related SUTextRef
+
+@see SUInstancePathCreate
+@see SUInstancePathCreateCopy
+
 @return
 - \ref SU_ERROR_NONE on success
 - \ref SU_ERROR_INVALID_INPUT if text is not a valid object

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

@@ -124,11 +124,14 @@ SU_RESULT SUTextureRelease(SUTextureRef* texture);
 
 /**
 @brief  Retrieves the pixel width, height, and scale factors of the texture.
-        The s_scale and t_scale values are useful when a face doesn't have a
+@note   The s_scale and t_scale values are useful when a face doesn't have a
         material applied directly, but instead inherit from a parent group or
         component instance. Then you want use these values to multiply the
         result of SUMeshHelperGetFrontSTQCoords() or SUUVHelperGetFrontUVQ().
         If the material is applied directly then this would not be needed.
+@note   For PBR textures (metallic, roughness, normal, and ambient occlusion)
+        the s_scale and t_scale values are only used when the PBR material
+        doesn't have a base texture.
 @param[in] texture  The texture object whose dimensions are retrieved.
 @param[out] width   The width in pixels.
 @param[out] height  The height in pixels.
@@ -146,6 +149,25 @@ SU_RESULT SUTextureRelease(SUTextureRef* texture);
 SU_RESULT SUTextureGetDimensions(
     SUTextureRef texture, size_t* width, size_t* height, double* s_scale, double* t_scale);
 
+/**
+@brief  Sets the scale factors of the texture.
+@note   For PBR textures (metallic, roughness, normal, and ambient occlusion)
+        the \p s_scale and \p t_scale values are only used when the PBR material
+        doesn't have a base texture.
+@since SketchUp 2025.0, API 13.0
+\param texture  The texture object whose dimensions are set.
+\param s_scale The s coordinate scale factor to map a pixel into model
+                    coordinates.
+\param t_scale The t coordinate scale factor to map a pixel into model
+                    coordinates.
+@related SUTextureRef
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if \p texture is an invalid object
+- \ref SU_ERROR_OUT_OF_RANGE if \p s_scale, or \p t_scale is smaller or equal to 0
+*/
+SU_RESULT SUTextureSetDimensions(SUTextureRef texture, double s_scale, double t_scale);
+
 /**
 @brief  Returns the total size and bits-per-pixel value of a texture's image
         data. This function is useful to determine the size of the buffer

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

@@ -56,7 +56,7 @@ SU_RESULT SUTypedValueCreate(SUTypedValueRef* typed_value);
 /**
 @brief  Releases a typed value object that was previously created with
         \ref SUTypedValueCreate().
-@param[in] typed_value The typed value object.
+@param[in,out] typed_value The typed value object.
 @related SUTypedValueRef
 @return
 - \ref SU_ERROR_NONE on success
@@ -92,8 +92,8 @@ SU_RESULT SUTypedValueGetByte(SUTypedValueRef typed_value, char* byte_value);
 
 /**
 @brief  Sets the byte value of a typed value object.
-@param[in] typed_value The typed value object.
-@param[in] byte_value  The byte value that is assigned.
+@param[in,out] typed_value The typed value object.
+@param[in]     byte_value  The byte value that is assigned.
 @related SUTypedValueRef
 @return
 - \ref SU_ERROR_NONE on success
@@ -116,8 +116,8 @@ SU_RESULT SUTypedValueGetInt16(SUTypedValueRef typed_value, int16_t* int16_value
 
 /**
 @brief  Sets the int16 value of a typed value object.
-@param[in] typed_value The typed value object.
-@param[in] int16_value The int16 value to set.
+@param[in,out] typed_value The typed value object.
+@param[in]     int16_value The int16 value to set.
 @related SUTypedValueRef
 @return
 - \ref SU_ERROR_NONE on success
@@ -140,8 +140,8 @@ SU_RESULT SUTypedValueGetInt32(SUTypedValueRef typed_value, int32_t* int32_value
 
 /**
 @brief  Sets the int32 value of a typed value object.
-@param[in] typed_value The typed value object.
-@param[in] int32_value The int32 value to set.
+@param[in,out] typed_value The typed value object.
+@param[in]     int32_value The int32 value to set.
 @related SUTypedValueRef
 @return
 - \ref SU_ERROR_NONE on success
@@ -164,8 +164,8 @@ SU_RESULT SUTypedValueGetFloat(SUTypedValueRef typed_value, float* float_value);
 
 /**
 @brief  Sets the float value of a typed value object.
-@param[in] typed_value The typed value object.
-@param[in] float_value The float value to set.
+@param[in,out] typed_value The typed value object.
+@param[in]     float_value The float value to set.
 @related SUTypedValueRef
 @return
 - \ref SU_ERROR_NONE on success
@@ -188,8 +188,8 @@ SU_RESULT SUTypedValueGetDouble(SUTypedValueRef typed_value, double* double_valu
 
 /**
 @brief  Sets the double value of a typed value object.
-@param[in] typed_value  The typed value object.
-@param[in] double_value The double value to set.
+@param[in,out] typed_value  The typed value object.
+@param[in]     double_value The double value to set.
 @related SUTypedValueRef
 @return
 - \ref SU_ERROR_NONE on success
@@ -212,8 +212,8 @@ SU_RESULT SUTypedValueGetBool(SUTypedValueRef typed_value, bool* bool_value);
 
 /**
 @brief  Sets the boolean value of a typed value object.
-@param[in] typed_value The typed value object.
-@param[in] bool_value  The boolean value to set.
+@param[in,out] typed_value The typed value object.
+@param[in]     bool_value  The boolean value to set.
 @related SUTypedValueRef
 @return
 - \ref SU_ERROR_NONE on success
@@ -236,8 +236,8 @@ SU_RESULT SUTypedValueGetColor(SUTypedValueRef typed_value, SUColor* color);
 
 /**
 @brief  Sets the color value of a typed value object.
-@param[in] typed_value The typed value object.
-@param[in] color       The color value to set.
+@param[in,out] typed_value The typed value object.
+@param[in]     color       The color value to set.
 @related SUTypedValueRef
 @return
 - \ref SU_ERROR_NONE on success
@@ -263,8 +263,8 @@ SU_RESULT SUTypedValueGetTime(SUTypedValueRef typed_value, int64_t* time_value);
 /**
 @brief  Sets the time value of a typed value object.  The time value is in
         seconds since January 1, 1970.
-@param[in] typed_value The typed value object.
-@param[in] time_value  The time value that is set.
+@param[in,out] typed_value The typed value object.
+@param[in]     time_value  The time value that is set.
 @related SUTypedValueRef
 @return
 - \ref SU_ERROR_NONE on success
@@ -289,8 +289,8 @@ SU_RESULT SUTypedValueGetString(SUTypedValueRef typed_value, SUStringRef* string
 
 /**
 @brief  Sets the string value of a typed value object.
-@param[in] typed_value The typed value object.
-@param[in] string_value  The string value to set. Assumed to be UTF-8 encoded.
+@param[in,out] typed_value The typed value object.
+@param[in]     string_value  The string value to set. Assumed to be UTF-8 encoded.
 @related SUTypedValueRef
 @return
 - \ref SU_ERROR_NONE on success
@@ -314,8 +314,8 @@ SU_RESULT SUTypedValueGetVector3d(SUTypedValueRef typed_value, double vector3d_v
 
 /**
 @brief  Sets the 3-element vector value of a typed value object.
-@param[in] typed_value The typed value object.
-@param[in] vector3d_value  The 3-element vector value to set.
+@param[in,out] typed_value The typed value object.
+@param[in]     vector3d_value  The 3-element vector value to set.
 @related SUTypedValueRef
 @return
 - \ref SU_ERROR_NONE on success
@@ -325,8 +325,8 @@ SU_RESULT SUTypedValueSetVector3d(SUTypedValueRef typed_value, const double vect
 
 /**
 @brief  Sets the 3D unit vector value of a typed value object.
-@param[in] typed_value    The typed value object.
-@param[in] vector3d_value The 3 vector components. Magnitude is ignored.
+@param[in,out] typed_value    The typed value object.
+@param[in]     vector3d_value The 3 vector components. Magnitude is ignored.
 @related SUTypedValueRef
 @return
 - \ref SU_ERROR_NONE on success
@@ -356,9 +356,9 @@ SU_RESULT SUTypedValueGetArrayItems(
 /**
 @brief  Sets the array of typed value objects of a typed value object.  The
         elements of the given array are copied to the type value object.
-@param[in] typed_value The typed value object.
-@param[in] len         The number of typed value objects to set.
-@param[in] values      The array of typed value objects to set.
+@param[in,out] typed_value The typed value object.
+@param[in]     len         The number of typed value objects to set.
+@param[in]     values      The array of typed value objects to set.
 @related SUTypedValueRef
 @return
 - \ref SU_ERROR_NONE on success

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

@@ -59,8 +59,8 @@ SU_RESULT SUVertexGetPosition(SUVertexRef vertex, struct SUPoint3D* position);
 
 /**
 @brief  Sets the position of a vertex object.
-@param[in] vertex   The vertex object.
-@param[in] position The value used to set the vertex position.
+@param[in,out] vertex   The vertex object.
+@param[in]     position The value used to set the vertex position.
 @related SUVertexRef
 @return
 - \ref SU_ERROR_NONE on success

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

@@ -1,4 +1,4 @@
-// Copyright 2015-2020 Trimble Inc., All rights reserved.
+// Copyright 2015-2024 Trimble Inc., All rights reserved.
 // This file is intended for public distribution.
 
 /**
@@ -80,6 +80,8 @@
 #include <SketchUpAPI/model/entity.h>
 #include <SketchUpAPI/model/entity_list.h>
 #include <SketchUpAPI/model/entity_list_iterator.h>
+#include <SketchUpAPI/model/environment.h>
+#include <SketchUpAPI/model/environments.h>
 #include <SketchUpAPI/model/face.h>
 #include <SketchUpAPI/model/font.h>
 #include <SketchUpAPI/model/geometry_input.h>
@@ -111,6 +113,7 @@
 #include <SketchUpAPI/model/selection.h>
 #include <SketchUpAPI/model/skp.h>
 #include <SketchUpAPI/model/shadow_info.h>
+#include <SketchUpAPI/model/snap.h>
 #include <SketchUpAPI/model/style.h>
 #include <SketchUpAPI/model/styles.h>
 #include <SketchUpAPI/model/text.h>

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

@@ -39,7 +39,7 @@ SU_RESULT SUStringCreate(SUStringRef* out_string_ref);
 @brief Creates a string from a UTF-8 string.
 
 Constructs a string and initializes it to a copy of the provided string,
-which is provided by a `'\0'` (`NULL`) terminated array of 8-bit characters.
+which is provided by a <tt>'\0'</tt> (<tt>NULL</tt>) terminated array of 8-bit characters.
 This string is interpreted as UTF-8.
 You must use SUStringRelease() on this string object to free its memory.
 @param[out] out_string_ref The string object to be created
@@ -130,8 +130,8 @@ SU_RESULT SUStringGetUTF16Length(SUStringRef string_ref, size_t* out_length);
 /**
 @brief Sets the value of a string from a NULL-terminated UTF-8 character array.
 
-@param[in] string_ref The string object.
-@param[in] char_array The character array to be set.
+@param[in,out] string_ref The string object.
+@param[in]     char_array The character array to be set.
 @related SUStringRef
 @return
 - \ref SU_ERROR_NONE on success
@@ -143,8 +143,8 @@ SU_RESULT SUStringSetUTF8(SUStringRef string_ref, const char* char_array);
 /**
 @brief Sets the value of a string from a NULL-terminated UTF-16 character array.
 
-@param[in] string_ref The string object.
-@param[in] char_array The character array to be set.
+@param[in,out] string_ref The string object.
+@param[in]     char_array The character array to be set.
 @related SUStringRef
 @return
 - \ref SU_ERROR_NONE on success
@@ -197,7 +197,7 @@ SU_RESULT SUStringGetUTF16(
 /**
 @brief Trim leading white spaces from the string.
 @since SketchUp 2017, API 5.0
-@param[in]  string_ref The string object.
+@param[in,out]  string_ref The string object.
 @related SUStringRef
 @return
 - \ref SU_ERROR_NONE on success
@@ -208,7 +208,7 @@ SU_RESULT SUStringTrimLeft(SUStringRef string_ref);
 /**
 @brief Trim tailing white spaces from the string.
 @since SketchUp 2017, API 5.0
-@param[in]  string_ref The string object.
+@param[in,out]  string_ref The string object.
 @related SUStringRef
 @return
 - \ref SU_ERROR_NONE on success