scriptup 0.0.0

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

@@ -0,0 +1,49 @@
+// Copyright 2021 Trimble Inc. All Rights Reserved.
+
+/**
+ * @file
+ * @brief Type for SketchUp model file version.
+ */
+#ifndef SKETCHUP_MODEL_MODEL_VERSION_H_
+#define SKETCHUP_MODEL_MODEL_VERSION_H_
+
+#pragma pack(push, 8)
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/**
+@enum SUModelVersion
+@brief SketchUp model file format version
+@since SketchUp 2014, API 2.0
+@note Starting with SketchUp 2021, SketchUp is using a the same file format across versions.
+  For instance, SketchUp 2021 can open a file made in SketchUp 2022.
+*/
+enum SUModelVersion {
+  SUModelVersion_SU3,     ///< SketchUp 3
+  SUModelVersion_SU4,     ///< SketchUp 4
+  SUModelVersion_SU5,     ///< SketchUp 5
+  SUModelVersion_SU6,     ///< SketchUp 6
+  SUModelVersion_SU7,     ///< SketchUp 7
+  SUModelVersion_SU8,     ///< SketchUp 8
+  SUModelVersion_SU2013,  ///< SketchUp 2013
+  SUModelVersion_SU2014,  ///< SketchUp 2014
+  SUModelVersion_SU2015,  ///< SketchUp 2015
+  SUModelVersion_SU2016,  ///< SketchUp 2016
+  SUModelVersion_SU2017,  ///< SketchUp 2017
+  SUModelVersion_SU2018,  ///< SketchUp 2018
+  SUModelVersion_SU2019,  ///< SketchUp 2019
+  SUModelVersion_SU2020,  ///< SketchUp 2020
+  SUModelVersion_SU2021,  ///< "Versionless" file format. Starting with SketchUp 2021.
+  SUModelVersion_Current = SUModelVersion_SU2021  ///< The most current version supported.
+                                                  ///< Added in SketchUp 2022, API 10.0.
+};
+
+#ifdef __cplusplus
+}  // extern "C"
+#endif
+
+#pragma pack(pop)
+
+#endif  // SKETCHUP_MODEL_MODEL_VERSION_H_

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

@@ -0,0 +1,72 @@
+// Copyright 2013 Trimble Inc. All Rights Reserved.
+
+/**
+ * @file
+ * @brief Interfaces for SUOpeningRef.
+ */
+#ifndef SKETCHUP_MODEL_OPENING_H_
+#define SKETCHUP_MODEL_OPENING_H_
+
+#include <SketchUpAPI/common.h>
+#include <SketchUpAPI/geometry.h>
+#include <SketchUpAPI/model/defs.h>
+#include <SketchUpAPI/model/component_instance.h>
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/**
+@struct SUOpeningRef
+@brief  References an opening object, which is a hole in a face created by an
+        attached component instance or group.
+@since SketchUp 2014, API 2.0
+
+*/
+
+/**
+@brief Retrieves the number of points of an opening.
+@since SketchUp 2014, API 2.0
+@param[in]  opening The opening object.
+@param[out] count   The number of points.
+@related SUOpeningRef
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if opening is not a valid object
+- \ref SU_ERROR_NULL_POINTER_OUTPUT if count is NULL
+*/
+SU_RESULT SUOpeningGetNumPoints(SUOpeningRef opening, size_t* count);
+
+/**
+@brief Retrieves the points of an opening object.
+@since SketchUp 2014, API 2.0
+@param[in]  opening  The opening object.
+@param[in]  len      The number of points to retrieve.
+@param[out] points   The points retrieved.
+@param[out] count    The number of points retrieved.
+@related SUOpeningRef
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if opening is not a valid object
+- \ref SU_ERROR_NULL_POINTER_OUTPUT if points or count is NULL
+*/
+SU_RESULT SUOpeningGetPoints(
+    SUOpeningRef opening, size_t len, struct SUPoint3D points[], size_t* count);
+
+/**
+@brief Release an opening object.
+@since SketchUp 2014, API 2.0
+@param[in]  opening  The opening object.
+@related SUOpeningRef
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if opening is not a valid object
+- \ref SU_ERROR_NULL_POINTER_INPUT if points or count is NULL
+*/
+SU_RESULT SUOpeningRelease(SUOpeningRef* opening);
+
+#ifdef __cplusplus
+}  // extern "C" {
+#endif
+
+#endif  // SKETCHUP_MODEL_OPENING_H_

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

@@ -0,0 +1,79 @@
+// Copyright 2013 Trimble Inc.  All Rights Reserved
+
+/**
+ * @file
+ * @brief Interfaces for SUOptionsManagerRef.
+ */
+#ifndef SKETCHUP_MODEL_OPTIONS_MANAGER_H_
+#define SKETCHUP_MODEL_OPTIONS_MANAGER_H_
+
+#include <SketchUpAPI/common.h>
+#include <SketchUpAPI/unicodestring.h>
+#include <SketchUpAPI/model/defs.h>
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/**
+@struct SUOptionsManagerRef
+@brief  Provides access to the different options provider objects in the model.
+        Available options providers are: PageOptions, SlideshowOptions,
+        UnitsOptions and PrintOptions.
+*/
+
+/**
+@brief  Gets the number of available options providers.
+@param[in]  options_manager The options manager object.
+@param[out] count           The number of options available.
+@related SUOptionsManagerRef
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if options_manager is not valid
+- \ref SU_ERROR_NULL_POINTER_OUTPUT if count is NULL
+*/
+SU_RESULT SUOptionsManagerGetNumOptionsProviders(
+    SUOptionsManagerRef options_manager, size_t* count);
+
+/**
+@brief  Retrieves options providers associated with the options manager.
+@param[in] options_manager         The options manager object.
+@param[in] len                     The number of options provider names
+                                   to retrieve.
+@param[out] options_provider_names The options provider names retrieved.
+@param[out] count                  The number of options provider names
+                                   retrieved.
+@related SUOptionsManagerRef
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if options_manager is not a valid object
+- \ref SU_ERROR_NULL_POINTER_OUTPUT if options_providers or count is NULL
+- \ref SU_ERROR_INVALID_OUTPUT if any of the strings in options_provider_names
+  are invalid
+*/
+SU_RESULT SUOptionsManagerGetOptionsProviderNames(
+    SUOptionsManagerRef options_manager, size_t len, SUStringRef options_provider_names[],
+    size_t* count);
+
+/**
+@brief  Retrieves the options provider given a name.
+@param[in] options_manager   The options manager object.
+@param[in] name              The name of the options provider object to get.
+                             Assumed to be UTF-8 encoded.
+@param[out] options_provider The options_provider object retrieved.
+@related SUOptionsManagerRef
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if options_manager is not a valid object
+- \ref SU_ERROR_NULL_POINTER_INPUT if name is NULL
+- \ref SU_ERROR_NULL_POINTER_OUTPUT if options_providers is NULL
+- \ref SU_ERROR_NO_DATA if the requested options provider object does not exist
+*/
+SU_RESULT SUOptionsManagerGetOptionsProviderByName(
+    SUOptionsManagerRef options_manager, const char* name, SUOptionsProviderRef* options_provider);
+
+#ifdef __cplusplus
+}  //  extern "C" {
+#endif
+
+#endif  // SKETCHUP_MODEL_OPTIONS_MANAGER_H_

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

@@ -0,0 +1,166 @@
+// Copyright 2013-2019 Trimble Inc.  All Rights Reserved
+
+/**
+ * @file
+ * @brief Interfaces for SUOptionsProviderRef.
+ */
+#ifndef SKETCHUP_MODEL_OPTIONS_PROVIDER_H_
+#define SKETCHUP_MODEL_OPTIONS_PROVIDER_H_
+
+#include <SketchUpAPI/common.h>
+#include <SketchUpAPI/unicodestring.h>
+#include <SketchUpAPI/model/defs.h>
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/**
+@struct SUOptionsProviderRef
+@brief  Provides ability to get and set options on an options provider object.
+        Available options providers are: PageOptions, SlideshowOptions,
+        UnitsOptions and PrintOptions.
+*/
+
+/**
+@brief  Gets the number of available option keys.
+@param[in]  options_provider The options provider object.
+@param[out] count            The number of keys available.
+@related SUOptionsProviderRef
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if options_provider is not valid
+- \ref SU_ERROR_NULL_POINTER_OUTPUT if count is NULL
+ */
+SU_RESULT SUOptionsProviderGetNumKeys(SUOptionsProviderRef options_provider, size_t* count);
+
+/**
+@brief  Retrieves options providers associated with the options manager.
+@param[in]  options_provider The options provider object.
+@param[in]  len              The number of keys to retrieve.
+@param[out] keys             The keys retrieved.
+@param[out] count            The number of keys retrieved.
+@related SUOptionsProviderRef
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if options_provider is not a valid object
+- \ref SU_ERROR_NULL_POINTER_OUTPUT if keys or count is NULL
+- \ref SU_ERROR_INVALID_OUTPUT if any of the strings in the keys array are
+  invalid.
+ */
+SU_RESULT SUOptionsProviderGetKeys(
+    SUOptionsProviderRef options_provider, size_t len, SUStringRef keys[], size_t* count);
+
+// clang-format off
+/**
+@brief  Gets the value of the given option.
+@param[in]  options_provider The options provider object.
+@param[in]  key              The key that indicates which option to get.
+@param[out] value            The value to get the current option setting.
+@related SUOptionsProviderRef
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if options_provider is not valid
+- \ref SU_ERROR_NULL_POINTER_INPUT if key is NULL
+- \ref SU_ERROR_NULL_POINTER_OUTPUT if value is NULL
+- \ref SU_ERROR_INVALID_OUTPUT if value is invalid
+
+The breakdown of options and value types for each options provider is shown
+in the table below.
+
+Options Provider | Option               | Value Type              | Meaning
+---------------- | -------------------- | ----------------------- | -------
+NamedOptions     | &nbsp;               | &nbsp;                  | (SketchUp 2022.0, API 10.0) Removed from API
+PageOptions      | &nbsp;               | &nbsp;                  | Options for the Scene
+&nbsp;           | ShowTransition       | SUTypedValueType_Bool   | Show scene transitions
+&nbsp;           | TransitionTime       | SUTypedValueType_Double | Number of seconds between each scene transition
+SlideshowOptions | &nbsp;               | &nbsp;                  | Options for the slideshow
+&nbsp;           | LoopSlideshow        | SUTypedValueType_Bool   | Causes the slideshow to loop
+&nbsp;           | SlideTime            | SUTypedValueType_Double | Number of seconds that each slide is shown
+UnitsOptions     | &nbsp;               | &nbsp;                  | Options for units display in the model
+&nbsp;           | LengthPrecision      | SUTypedValueType_Int32  | Number of decimal places of precision shown for length
+&nbsp;           | LengthFormat         | SUTypedValueType_Int32  | Default units format for the model
+&nbsp;           | LengthUnit           | SUTypedValueType_Int32  | Units format for the model
+&nbsp;           | LengthSnapEnabled    | SUTypedValueType_Bool   | Indicates whether length snapping is enabled
+&nbsp;           | LengthSnapLength     | SUTypedValueType_Double | Controls the snapping length size increment
+&nbsp;           | AreaPrecision        | SUTypedValueType_Int32  | (SketchUp 2020.0, API Version 8.0) Number of decimal places of precision shown for area units
+&nbsp;           | AreaUnit             | SUTypedValueType_Int32  | (SketchUp 2019.2, API Version 7.1) Area units format for the model
+&nbsp;           | VolumePrecision      | SUTypedValueType_Int32  | (SketchUp 2020.0, API Version 8.0) Number of decimal places of precision shown for volume units
+&nbsp;           | VolumeUnit           | SUTypedValueType_Int32  | (SketchUp 2019.2, API Version 7.1) Volume units format for the model
+&nbsp;           | AnglePrecision       | SUTypedValueType_Int32  | Number of decimal places of precision shown for angles
+&nbsp;           | AngleSnapEnabled     | SUTypedValueType_Bool   | Indicates whether angle snapping is enabled
+&nbsp;           | SnapAngle            | SUTypedValueType_Double | Controls the angle snapping size increment
+&nbsp;           | SuppressUnitsDisplay | SUTypedValueType_Bool   | Display the units format if LengthFormat is Decimal or Fractional
+&nbsp;           | ForceInchDisplay     | SUTypedValueType_Bool   | Force displaying 0" if LengthFormat is Architectural
+
+Some of the options map to enumerated values, as shown in the table below.
+
+Option       | Value | Meaning
+------------ | ----- | -------
+LengthFormat | 0:    | Decimal
+&nbsp;       | 1:    | Architectural
+&nbsp;       | 2:    | Engineering
+&nbsp;       | 3:    | Fractional
+LengthUnit   | 0:    | Inches
+&nbsp;       | 1:    | Feet
+&nbsp;       | 2:    | Millimeter
+&nbsp;       | 3:    | Centimeter
+&nbsp;       | 4:    | Meter
+&nbsp;       | 5:    | Yard
+AreaUnit     | 0:    | Square Inches
+&nbsp;       | 1:    | Square Feet
+&nbsp;       | 2:    | Square Millimeter
+&nbsp;       | 3:    | Square Centimeter
+&nbsp;       | 4:    | Square Meter
+&nbsp;       | 5:    | Square Yard
+VolumeUnit   | 0:    | Cubic Inches
+&nbsp;       | 1:    | Cubic Feet
+&nbsp;       | 2:    | Cubic Millimeter
+&nbsp;       | 3:    | Cubic Centimeter
+&nbsp;       | 4:    | Cubic Meter
+&nbsp;       | 5:    | Cubic Yard
+&nbsp;       | 6:    | Liter
+&nbsp;       | 7:    | US Gallon
+
+Note that LengthUnit will be overridden by LengthFormat if LengthFormat is not
+set to Decimal. Architectural defaults to inches, Engineering defaults to feet,
+and Fractional defaults to inches.
+ */
+ // clang-format
+SU_RESULT SUOptionsProviderGetValue(
+    SUOptionsProviderRef options_provider, const char* key, SUTypedValueRef* value);
+
+/**
+@brief  Sets the value of the given option.
+@param[in] options_provider The options provider object.
+@param[in] key              The key that indicates which option to set.
+@param[in] value            The value to set the option to.
+@related SUOptionsProviderRef
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if options_provider or value is not valid
+- \ref SU_ERROR_NULL_POINTER_INPUT if key is NULL
+ */
+SU_RESULT SUOptionsProviderSetValue(
+    SUOptionsProviderRef options_provider, const char* key, SUTypedValueRef value);
+
+/**
+@brief Retrieves the name of the options provider.
+@since SketchUp 2016, API 4.0
+@param[in] options_provider The options provider object.
+@param[out] name            The name retrieved.
+@related SUOptionsProviderRef
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if options_provider or value is not valid
+- \ref SU_ERROR_NULL_POINTER_OUTPUT if name is NULL
+- \ref SU_ERROR_INVALID_OUTPUT if name does not point to a valid \ref
+SUStringRef object
+*/
+SU_RESULT SUOptionsProviderGetName(SUOptionsProviderRef options_provider, SUStringRef* name);
+
+#ifdef __cplusplus
+}  //  extern "C" {
+#endif
+
+#endif  // SKETCHUP_MODEL_OPTIONS_PROVIDER_H_

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

@@ -0,0 +1,140 @@
+// Copyright 2013 Trimble Inc. All Rights Reserved.
+
+/**
+ * @file
+ * @brief Interfaces for SUPolyline3dRef.
+ */
+#ifndef SKETCHUP_MODEL_POLYLINE3D_H_
+#define SKETCHUP_MODEL_POLYLINE3D_H_
+
+#include <SketchUpAPI/common.h>
+#include <SketchUpAPI/geometry.h>
+#include <SketchUpAPI/model/defs.h>
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/**
+@struct SUPolyline3dRef
+@extends SUEntityRef
+@brief  A polyline3d object. These are curve-like entities that do not
+        generate inference snaps or affect geometry in any way.
+*/
+
+/**
+@brief  Converts from an \ref SUPolyline3dRef to an \ref SUEntityRef. This is
+        essentially an upcast operation.
+@param[in] line The polyline3d object.
+@related SUPolyline3dRef
+@return
+- The converted \ref SUEntityRef if line is a valid object. If not, the returned
+  reference will be invalid.
+*/
+SU_EXPORT SUEntityRef SUPolyline3dToEntity(SUPolyline3dRef line);
+
+/**
+@brief  Converts from an \ref SUEntityRef to an \ref SUPolyline3dRef. This is
+        essentially a downcast operation so the given entity must be convertible
+        to an \ref SUPolyline3dRef.
+@param[in] entity The given entity reference.
+@related SUPolyline3dRef
+@return
+- The converted \ref SUPolyline3dRef if the downcast operation succeeds. If not,
+  the returned reference will be invalid.
+*/
+SU_EXPORT SUPolyline3dRef SUPolyline3dFromEntity(SUEntityRef entity);
+
+/**
+@brief  Converts from an \ref SUPolyline3dRef to an \ref SUDrawingElementRef.
+        This is essentially an upcast operation.
+@param[in] line The polyline3d object.
+@related SUPolyline3dRef
+@return
+- The converted \ref SUEntityRef if line is a valid object. If not, the returned
+  reference will be invalid.
+*/
+SU_EXPORT SUDrawingElementRef SUPolyline3dToDrawingElement(SUPolyline3dRef line);
+
+/**
+@brief  Converts from an \ref SUDrawingElementRef to an \ref SUPolyline3dRef.
+        This is essentially a downcast operation so the given element must be
+        convertible to an \ref SUPolyline3dRef.
+@param[in] drawing_elem The drawing element object.
+@related SUPolyline3dRef
+@return
+- The converted \ref SUPolyline3dRef if the downcast operation succeeds. If not,
+  the returned reference will be invalid.
+*/
+SU_EXPORT SUPolyline3dRef SUPolyline3dFromDrawingElement(SUDrawingElementRef drawing_elem);
+
+/**
+@brief Creates a new polyline3d object. The polyline3d object must be
+       subsequently deallocated with \ref SUPolyline3dRelease() unless it is
+       associated with a parent object.
+@param[out] polyline The polyline3d object.
+@related SUPolyline3dRef
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_NULL_POINTER_OUTPUT if polyline is NULL
+*/
+SU_RESULT SUPolyline3dCreate(SUPolyline3dRef* polyline);
+
+/**
+@brief Releases a new polyline3d object. The polyline3d object must not be
+       associated with a parent object.
+@param[in] polyline The polyline3d object.
+@related SUPolyline3dRef
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if polyline does not reference a valid object
+- \ref SU_ERROR_NULL_POINTER_INPUT if polyline is NULL
+*/
+SU_RESULT SUPolyline3dRelease(SUPolyline3dRef* polyline);
+
+/**
+@brief Adds points to a polyline3d object.
+@param[in] polyline   The polyline3d object.
+@param[in] num_points Number of points being added.
+@param[in] points     Array of points to add.
+@related SUPolyline3dRef
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if polyline is not a valid object
+- \ref SU_ERROR_NULL_POINTER_INPUT if points is NULL
+*/
+SU_RESULT SUPolyline3dAddPoints(
+    SUPolyline3dRef polyline, size_t num_points, struct SUPoint3D points[]);
+
+/**
+@brief  Retrieves the number of points contained by a polyline3d.
+@param[in]  line  The polyline3d object.
+@param[out] count The number of points available.
+@related SUPolyline3dRef
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if line is an invalid object
+- \ref SU_ERROR_NULL_POINTER_OUTPUT if count is NULL
+*/
+SU_RESULT SUPolyline3dGetNumPoints(SUPolyline3dRef line, size_t* count);
+
+/**
+@brief  Retrieves the points in the polyline3d object.
+@param[in]  line   The polyline3d object.
+@param[in]  len    The maximum number of points to retrieve.
+@param[out] points The points retrieved.
+@param[out] count  The number of points retrieved.
+@related SUPolyline3dRef
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if line is an invalid object
+- \ref SU_ERROR_NULL_POINTER_OUTPUT if points or count is NULL
+*/
+SU_RESULT SUPolyline3dGetPoints(
+    SUPolyline3dRef line, size_t len, struct SUPoint3D points[], size_t* count);
+
+#ifdef __cplusplus
+}  // extern "C"
+#endif
+
+#endif  // SKETCHUP_MODEL_POLYLINE3D_H_

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

@@ -0,0 +1,179 @@
+// Copyright 2013 Trimble Inc.  All rights reserved.
+
+/**
+ * @file
+ * @brief Interfaces for SURenderingOptionsRef.
+ */
+#ifndef SKETCHUP_MODEL_RENDERING_OPTIONS_H_
+#define SKETCHUP_MODEL_RENDERING_OPTIONS_H_
+
+#include <SketchUpAPI/color.h>
+#include <SketchUpAPI/common.h>
+#include <SketchUpAPI/unicodestring.h>
+#include <SketchUpAPI/model/defs.h>
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/**
+@struct SURenderingOptionsRef
+@brief  Used to get and set values in a rendering options object.
+*/
+
+/**
+@brief  Gets the number of available rendering options keys.
+@since SketchUp 2017, API 5.0
+@param[in]  rendering_options The rendering options object.
+@param[out] count             The number of keys available.
+@related SURenderingOptionsRef
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if rendering_options is not valid
+- \ref SU_ERROR_NULL_POINTER_OUTPUT if count is NULL
+*/
+SU_RESULT SURenderingOptionsGetNumKeys(SURenderingOptionsRef rendering_options, size_t* count);
+
+/**
+@brief  Retrieves keys associated with the rendering options object.
+@since SketchUp 2017, API 5.0
+@param[in]  rendering_options The rendering options object.
+@param[in]  len               The number of keys to retrieve.
+@param[out] keys              The keys retrieved.
+@param[out] count             The number of keys retrieved.
+@related SURenderingOptionsRef
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if rendering_options is not a valid object
+- \ref SU_ERROR_NULL_POINTER_OUTPUT if keys or count is NULL
+- \ref SU_ERROR_INVALID_OUTPUT if any of the strings in the keys array are
+  invalid.
+*/
+SU_RESULT SURenderingOptionsGetKeys(
+    SURenderingOptionsRef rendering_options, size_t len, SUStringRef keys[], size_t* count);
+
+/**
+@brief  Sets values in a rendering options object.
+@param[in] rendering_options The rendering options object.
+@param[in] key               The key. Assumed to be UTF-8 encoded.
+@param[in] value_in          The value used to set the option.
+@related SURenderingOptionsRef
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if rendering_options or value_in is an invalid
+  object
+- \ref SU_ERROR_NULL_POINTER_INPUT if key is NULL
+*/
+SU_RESULT SURenderingOptionsSetValue(
+    SURenderingOptionsRef rendering_options, const char* key, SUTypedValueRef value_in);
+
+/**
+@brief  Retrieves the value of a given rendering option.
+@param[in]  rendering_options The rendering options object.
+@param[in]  key               The key. Assumed to be UTF-8 encoded.
+@param[out] value_out         The value retrieved.
+@related SURenderingOptionsRef
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if rendering_options is an invalid object
+- \ref SU_ERROR_NULL_POINTER_INPUT if key is NULL
+- \ref SU_ERROR_INVALID_OUTPUT if value_out is an invalid object
+- \ref SU_ERROR_NULL_POINTER_OUTPUT if value_out is NULL
+
+The breakdown of rendering options and value types is shown in the table below.
+
+Rendering Option         | Value Type
+------------------------ | ----------------------
+BackgroundColor          | SUTypedValueType_Color
+BandColor                | SUTypedValueType_Color
+ConstructionColor        | SUTypedValueType_Color
+DepthQueWidth            | SUTypedValueType_Int32
+DisplayColorByLayer      | SUTypedValueType_Bool
+DisplayDims              | SUTypedValueType_Bool
+DisplayFog               | SUTypedValueType_Bool
+DisplayInstanceAxes      | SUTypedValueType_Bool
+DisplaySectionPlanes (since SketchUp 2014, API 2.0) | SUTypedValueType_Bool
+DisplaySectionCuts (since SketchUp 2015, API 3.0)   | SUTypedValueType_Bool
+DisplaySketchAxes        | SUTypedValueType_Bool
+DisplayText              | SUTypedValueType_Bool
+DisplayWatermarks        | SUTypedValueType_Bool
+DrawBackEdges (since SketchUp 2015, API 3.0)        | SUTypedValueType_Bool
+DrawDepthQue             | SUTypedValueType_Bool
+DrawGround               | SUTypedValueType_Bool
+DrawHidden               | SUTypedValueType_Bool
+DrawHiddenGeometry (since SketchUp 2020, API 8.0)   | SUTypedValueType_Bool
+DrawHiddenObjects (since SketchUp 2020, API 8.0)    | SUTypedValueType_Bool
+DrawHorizon              | SUTypedValueType_Bool
+DrawLineEnds             | SUTypedValueType_Bool
+DrawProfilesOnly         | SUTypedValueType_Bool
+DrawSilhouettes          | SUTypedValueType_Bool
+DrawUnderground          | SUTypedValueType_Bool
+EdgeColorMode            | SUTypedValueType_Int32
+EdgeDisplayMode          | SUTypedValueType_Int32
+EdgeType                 | SUTypedValueType_Int32
+ExtendLines              | SUTypedValueType_Bool
+FaceBackColor            | SUTypedValueType_Color
+FaceFrontColor           | SUTypedValueType_Color
+FogColor                 | SUTypedValueType_Color
+FogEndDist               | SUTypedValueType_Double
+FogStartDist             | SUTypedValueType_Double
+FogUseBkColor            | SUTypedValueType_Bool
+ForegroundColor          | SUTypedValueType_Color
+GroundColor              | SUTypedValueType_Color
+GroundTransparency       | SUTypedValueType_Int32
+HideConstructionGeometry | SUTypedValueType_Bool
+HighlightColor           | SUTypedValueType_Color
+HorizonColor             | SUTypedValueType_Color
+InactiveFade             | SUTypedValueType_Double
+InactiveHidden           | SUTypedValueType_Bool
+InstanceFade             | SUTypedValueType_Double
+InstanceHidden           | SUTypedValueType_Bool
+JitterEdges              | SUTypedValueType_Bool
+LineEndWidth             | SUTypedValueType_Int32
+LineExtension            | SUTypedValueType_Int32
+LockedColor              | SUTypedValueType_Color
+MaterialTransparency     | SUTypedValueType_Bool
+ModelTransparency        | SUTypedValueType_Bool
+RenderMode               | SUTypedValueType_Int32
+SectionActiveColor       | SUTypedValueType_Color
+SectionCutDrawEdges (since SketchUp 2015, API 3.0)  | SUTypedValueType_Bool
+SectionCutFilled (since SketchUp 2018, API 6.0) | SUTypedValueType_Bool
+SectionCutWidth          | SUTypedValueType_Int32
+SectionDefaultCutColor   | SUTypedValueType_Color
+SectionDefaultFillColor (since SketchUp 2018, API 6.0) | SUTypedValueType_Color
+SectionInactiveColor     | SUTypedValueType_Color
+ShowViewName             | SUTypedValueType_Bool
+SilhouetteWidth          | SUTypedValueType_Int32
+SkyColor                 | SUTypedValueType_Color
+Texture                  | SUTypedValueType_Bool
+TransparencySort         | SUTypedValueType_Int32
+
+Some of the options map to enumerated values, as shown in the table below.
+
+Option          | Value | Meaning
+--------------- | ----- | -------
+EdgeColorMode   | 0:    | ObjectColor
+&nbsp;          | 1:    | ForegroundColor
+&nbsp;          | 2:    | DirectionColor
+EdgeDisplayMode | 0:    | EdgeDisplayNone
+&nbsp;          | 1:    | EdgeDisplayAll
+&nbsp;          | 2:    | EdgeDisplayStandalone
+RenderMode      | 0:    | RenderWireframe
+&nbsp;          | 1:    | RenderHidden
+&nbsp;          | 2:    | RenderFlat
+&nbsp;          | 3:    | RenderSmooth
+&nbsp;          | 4:    | RenderTextureObsolete
+&nbsp;          | 5:    | RenderNoMaterials
+EdgeType        | 0:    | EdgeStandard
+&nbsp;          | 1:    | EdgeNPR
+
+@note The rendering option FaceColorMode was removed in SketchUp 2019.1.
+*/
+SU_RESULT SURenderingOptionsGetValue(
+    SURenderingOptionsRef rendering_options, const char* key, SUTypedValueRef* value_out);
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif  // SKETCHUP_MODEL_RENDERING_OPTIONS_H_