scriptup 0.0.0

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

@@ -0,0 +1,398 @@
+// Copyright 2013-2020 Trimble Inc. All Rights Reserved.
+
+/**
+ * @file
+ * @brief Interfaces for SUCameraRef.
+ */
+#ifndef SKETCHUP_MODEL_CAMERA_H_
+#define SKETCHUP_MODEL_CAMERA_H_
+
+#include <SketchUpAPI/geometry.h>
+#include <SketchUpAPI/common.h>
+#include <SketchUpAPI/unicodestring.h>
+#include <SketchUpAPI/model/defs.h>
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/**
+@struct SUCameraRef
+@brief  References the camera object of a SketchUp model.
+*/
+
+/**
+@brief  Creates a default camera object.
+@since SketchUp 2015, API 3.0
+@param[out] camera The camera object created.
+@related SUCameraRef
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_NULL_POINTER_INPUT if camera is NULL
+- \ref SU_ERROR_OVERWRITE_VALID if camera already refers to a valid object
+*/
+SU_RESULT SUCameraCreate(SUCameraRef* camera);
+
+/**
+@brief  Releases a camera object created by SUCameraCreate.
+@since SketchUp 2015, API 3.0
+@param[in] camera The camera object.
+@related SUCameraRef
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if camera is an invalid object
+- \ref SU_ERROR_NULL_POINTER_INPUT if camera is NULL
+*/
+SU_RESULT SUCameraRelease(SUCameraRef* camera);
+
+/**
+@brief Retrieves the orientation of a camera object.
+@param[in]  camera    The camera object.
+@param[out] position  The position retrieved.
+@param[out] target    The target retrieved.
+@param[out] up_vector The up direction retrieved.
+@related SUCameraRef
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if camera is not a valid object
+- \ref SU_ERROR_NULL_POINTER_OUTPUT if position, target, or up_vector is NULL
+*/
+SU_RESULT SUCameraGetOrientation(
+    SUCameraRef camera, struct SUPoint3D* position, struct SUPoint3D* target,
+    struct SUVector3D* up_vector);
+
+/**
+@brief Sets the position of a camera object.
+@param[in] camera    The camera object.
+@param[in] position  The new eye position.
+@param[in] target    The new target position.
+@param[in] up_vector The new up direction.
+@related SUCameraRef
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if camera is not a valid object
+- \ref SU_ERROR_NULL_POINTER_INPUT if position, target or up_vector is NULL
+*/
+SU_RESULT SUCameraSetOrientation(
+    SUCameraRef camera, const struct SUPoint3D* position, const struct SUPoint3D* target,
+    const struct SUVector3D* up_vector);
+
+/**
+@brief Retrieves the look at matrix of the camera object.
+@since SketchUp 2017, API 5.0
+@param[in]  camera         The camera object.
+@param[out] transformation The look at matrix retrieved.
+@related SUCameraRef
+@return
+- \ref SU_ERROR_NONE on success.
+- \ref SU_ERROR_INVALID_INPUT if camera is not a valid object
+- \ref SU_ERROR_NULL_POINTER_OUTPUT if transformation is NULL
+*/
+SU_RESULT SUCameraGetViewTransformation(
+    SUCameraRef camera, struct SUTransformation* transformation);
+
+/**
+@brief Sets the field of view angle of a camera object. If the camera object is
+       an orthographic camera, the camera object subsequently becomes a
+       perspective camera. The field of view is measured along the vertical
+       direction of the camera.
+@param[in] camera The camera object.
+@param[in] fov    The field of view angle in degrees.
+@related SUCameraRef
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if camera is not a valid object
+*/
+SU_RESULT SUCameraSetPerspectiveFrustumFOV(SUCameraRef camera, double fov);
+
+/**
+@brief Retrieves the field of view in degrees of a camera object. The field of
+       view is measured along the vertical direction of the camera.
+@param[in] camera The camera object.
+@param[out] fov   The field of view retrieved.
+@related SUCameraRef
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if camera is not a valid object
+- \ref SU_ERROR_NO_DATA if camera is not a perspective camera (orthographic
+       camera)
+- \ref SU_ERROR_NULL_POINTER_OUTPUT if fov is NULL
+*/
+SU_RESULT SUCameraGetPerspectiveFrustumFOV(SUCameraRef camera, double* fov);
+
+/**
+@brief Sets the aspect ratio of a camera object.
+@since SketchUp 2017, API 5.0
+@param[in]  camera       The camera object.
+@param[out] aspect_ratio The aspect ratio to be set.
+@related SUCameraRef
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if camera is not a valid object
+- \ref SU_ERROR_OUT_OF_RANGE is aspect_ratio < 0.0
+*/
+SU_RESULT SUCameraSetAspectRatio(SUCameraRef camera, double aspect_ratio);
+
+/**
+@brief Retrieves the aspect ratio of a camera object.
+@param[in]  camera       The camera object.
+@param[out] aspect_ratio The aspect ratio retrieved.
+@related SUCameraRef
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if camera is not a valid object
+- \ref SU_ERROR_NO_DATA if the camera uses the screen aspect ratio
+- \ref SU_ERROR_NULL_POINTER_OUTPUT if aspect_ratio is NULL
+*/
+SU_RESULT SUCameraGetAspectRatio(SUCameraRef camera, double* aspect_ratio);
+
+/**
+@brief Sets the height of a camera object which is used to calculate the
+       orthographic projection of a camera object. If the camera object is a
+       perspective camera, the camera subsequently becomes an orthographic
+       camera.
+@param[in] camera The camera object.
+@param[in] height The height of the camera view.
+@related SUCameraRef
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if camera is not a valid object
+*/
+SU_RESULT SUCameraSetOrthographicFrustumHeight(SUCameraRef camera, double height);
+
+/**
+@brief Retrieves the height of an orthographic camera object.
+@param[in]  camera The camera object.
+@param[out] height The height retrieved.
+@related SUCameraRef
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if camera is not a valid object
+- \ref SU_ERROR_NO_DATA if camera is not an orthographic camera (perspective
+       camera)
+- \ref SU_ERROR_NULL_POINTER_OUTPUT if height is NULL
+*/
+SU_RESULT SUCameraGetOrthographicFrustumHeight(SUCameraRef camera, double* height);
+
+/**
+@brief Sets a camera object perspective or orthographic.
+@param[in] camera      The camera object.
+@param[in] perspective The perspective flag.
+@related SUCameraRef
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if camera is not a valid object
+*/
+SU_RESULT SUCameraSetPerspective(SUCameraRef camera, bool perspective);
+
+/**
+@brief Retrieves whether a camera object is a perspective camera or not
+       (i.e. orthographic).
+@param[in]  camera      The camera object.
+@param[out] perspective The perspective flag retrieved.
+@related SUCameraRef
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if camera is an invalid object
+- \ref SU_ERROR_NULL_POINTER_OUTPUT perspective is NULL
+*/
+SU_RESULT SUCameraGetPerspective(SUCameraRef camera, bool* perspective);
+
+/**
+@brief Retrieves the near and far clipping distances of the camera object.
+@since SketchUp 2017, API 5.0
+@param[in]  camera The camera object.
+@param[out] znear  The near clipping distance.
+@param[out] zfar   The far clipping distance.
+@related SUCameraRef
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if camera is an invalid object
+- \ref SU_ERROR_NULL_POINTER_OUTPUT if znear or zfar is NULL
+*/
+SU_RESULT SUCameraGetClippingDistances(SUCameraRef camera, double* znear, double* zfar);
+
+/**
+@brief Sets whether the field of view value represents the camera view height.
+@since SketchUp 2017, API 5.0
+@param[in] camera        The camera object.
+@param[in] is_fov_height The field of view flag set.
+@related SUCameraRef
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if camera is not a valid object
+*/
+SU_RESULT SUCameraSetFOVIsHeight(SUCameraRef camera, bool is_fov_height);
+
+/**
+@brief Retrieves whether the field of view value represents the camera view
+       height.
+@since SketchUp 2017, API 5.0
+@param[in]  camera        The camera object.
+@param[out] is_fov_height The field of view flag retrieved.
+@related SUCameraRef
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if camera is not a valid object
+- \ref SU_ERROR_NULL_POINTER_OUTPUT is_fov_height is NULL
+*/
+SU_RESULT SUCameraGetFOVIsHeight(SUCameraRef camera, bool* is_fov_height);
+
+/**
+@brief Sets the size of the image on the "film" for a perspective camera. The
+       value is given in millimeters. It is used in the conversions between
+       field of view and focal length.
+@since SketchUp 2017, API 5.0
+@param[in] camera The camera object.
+@param[in] width  The width set in millimeters.
+@related SUCameraRef
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if camera is not a valid object
+*/
+SU_RESULT SUCameraSetImageWidth(SUCameraRef camera, double width);
+
+/**
+@brief Retrieves the size of the image on the image plane of the Camera. By
+       default, this value is not set. If it is set, it is used in the
+       calculation of the focal length from the field of view. Unlike most
+       length values in SketchUp, this width is specified in millimeters rather
+       than in inches.
+@since SketchUp 2017, API 5.0
+@param[in]  camera The camera object.
+@param[out] width  The image width retrieved.
+@related SUCameraRef
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if camera is not a valid object
+- \ref SU_ERROR_NULL_POINTER_OUTPUT width is NULL
+*/
+SU_RESULT SUCameraGetImageWidth(SUCameraRef camera, double* width);
+
+/**
+@brief Sets the description of a camera object.
+@since SketchUp 2017, API 5.0
+@param[in] camera The camera object.
+@param[in] desc   The description to be set.
+Assumed to be UTF-8 encoded.
+@related SUCameraRef
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if camera is not a valid object
+- \ref SU_ERROR_NULL_POINTER_INPUT if desc is NULL
+*/
+SU_RESULT SUCameraSetDescription(SUCameraRef camera, const char* desc);
+
+/**
+@brief Retrieves the description of a camera object.
+@since SketchUp 2017, API 5.0
+@param[in]  camera The camera object.
+@param[out] desc   The description retrieved.
+@related SUCameraRef
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if camera is not a valid object
+- \ref SU_ERROR_NULL_POINTER_OUTPUT if desc is NULL
+- \ref SU_ERROR_INVALID_OUTPUT if desc does not point to a valid \ref
+SUStringRef object
+*/
+SU_RESULT SUCameraGetDescription(SUCameraRef camera, SUStringRef* desc);
+
+/**
+@brief Retrieves the camera's direction vector.
+@since SketchUp 2017, API 5.0
+@param[in]  camera    The camera object.
+@param[out] direction The direction vector retrieved.
+@related SUCameraRef
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if camera is not a valid object
+- \ref SU_ERROR_NULL_POINTER_OUTPUT if direction is NULL
+*/
+SU_RESULT SUCameraGetDirection(SUCameraRef camera, struct SUVector3D* direction);
+
+/**
+@brief Sets whether a camera is two dimensional. 2 point perspective mode and
+       PhotoMatch mode are 2d cameras.
+@since SketchUp 2017, API 5.0
+@param[in] camera  The camera object.
+@param[in] make_2d The flag for specifying if the camera should be 2D.
+@related SUCameraRef
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if camera is not a valid object
+*/
+SU_RESULT SUCameraSet2D(SUCameraRef camera, bool make_2d);
+
+/**
+@brief Retrieves whether a camera object is two dimensional.
+@since SketchUp 2017, API 5.0
+@param[in]  camera The camera object.
+@param[out] is_2d  The 2D flag retrieved.
+@related SUCameraRef
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if camera is an invalid object
+- \ref SU_ERROR_NULL_POINTER_OUTPUT is_2d is NULL
+*/
+SU_RESULT SUCameraGet2D(SUCameraRef camera, bool* is_2d);
+
+/**
+@brief Sets the camera's 2D scale factor.
+@since SketchUp 2017, API 5.0
+@param[in] camera The camera object.
+@param[in] scale  The scale to be set.
+@related SUCameraRef
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if camera is not a valid object
+*/
+SU_RESULT SUCameraSetScale2D(SUCameraRef camera, double scale);
+
+/**
+@brief Retrieves the camera's 2D scale factor.
+@since SketchUp 2017, API 5.0
+@param[in]  camera The camera object.
+@param[out] scale  The scale factor retrieved.
+@related SUCameraRef
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if camera is not a valid object
+- \ref SU_ERROR_NULL_POINTER_OUTPUT if scale is NULL
+*/
+SU_RESULT SUCameraGetScale2D(SUCameraRef camera, double* scale);
+
+/**
+@brief Sets the camera's 2D center point. The point coordinates are in screen
+       space.  Since this is setting the 2D center point the z component of the
+       provided point is ignored.
+@since SketchUp 2017, API 5.0
+@param[in] camera The camera object.
+@param[in] center The center to be set.
+@related SUCameraRef
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if camera is not a valid object
+- \ref SU_ERROR_NULL_POINTER_INPUT if center is NULL
+*/
+SU_RESULT SUCameraSetCenter2D(SUCameraRef camera, const struct SUPoint3D* center);
+
+/**
+@brief Retrieves the camera's 2D center point. Since this is accessing a 2D
+       point with a 3D point structure the z coordinate is always set to 0.0.
+@since SketchUp 2017, API 5.0
+@param[in]  camera The camera object.
+@param[out] center The center point retrieved.
+@related SUCameraRef
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if camera is not a valid object
+- \ref SU_ERROR_NULL_POINTER_OUTPUT if center is NULL
+*/
+SU_RESULT SUCameraGetCenter2D(SUCameraRef camera, struct SUPoint3D* center);
+
+#ifdef __cplusplus
+}  // extern "C"
+#endif
+
+#endif  // SKETCHUP_MODEL_CAMERA_H_

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

@@ -0,0 +1,89 @@
+// Copyright 2016-2020 Trimble Inc. All Rights Reserved
+
+/**
+ * @file
+ * @brief Interfaces for SUClassificationAttributeRef.
+ */
+#ifndef SKETCHUP_MODEL_CLASSIFICATION_ATTRIBUTE_H_
+#define SKETCHUP_MODEL_CLASSIFICATION_ATTRIBUTE_H_
+
+#include <SketchUpAPI/common.h>
+#include <SketchUpAPI/unicodestring.h>
+#include <SketchUpAPI/model/defs.h>
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/**
+@struct SUClassificationAttributeRef
+@brief  References attribute data about a classified component.
+*/
+
+/**
+@brief Retrieves the value of the attribute.
+@since SketchUp 2017, API 5.0
+@param[in]  attribute The classification attribute object.
+@param[out] value     The value of the attribute.
+@related SUClassificationAttributeRef
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if attribute is not a valid object
+- \ref SU_ERROR_NULL_POINTER_OUTPUT if value is NULL
+- \ref SU_ERROR_INVALID_OUTPUT if value does not point to a valid \ref
+  SUTypedValueRef object
+*/
+SU_RESULT SUClassificationAttributeGetValue(
+    SUClassificationAttributeRef attribute, SUTypedValueRef* value);
+
+/**
+@brief Retrieves the path to the attribute.
+@since SketchUp 2017, API 5.0
+@param[in]  attribute The classification attribute object.
+@param[out] path      The attribute name as it should be displayed to the
+                         user.
+@related SUClassificationAttributeRef
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if attribute is not a valid object
+- \ref SU_ERROR_NULL_POINTER_OUTPUT if path is NULL
+- \ref SU_ERROR_INVALID_OUTPUT if path does not point to a valid \ref
+  SUStringRef object
+*/
+SU_RESULT SUClassificationAttributeGetPath(
+    SUClassificationAttributeRef attribute, SUStringRef* path);
+
+/**
+@brief Retrieves the number of children setting of the attribute.
+@since SketchUp 2017, API 5.0
+@param[in]  attribute The classification attribute object.
+@param[out] count     The number of children this attribute contains.
+@related SUClassificationAttributeRef
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if attribute is not a valid object
+- \ref SU_ERROR_NULL_POINTER_OUTPUT if count is NULL
+*/
+SU_RESULT SUClassificationAttributeGetNumChildren(
+    SUClassificationAttributeRef attribute, size_t* count);
+
+/**
+@brief Retrieves the child attribute at the given index.
+@since SketchUp 2017, API 5.0
+@param[in]  attribute The classification attribute object.
+@param[in]  index     The index of the child attribute to get.
+@param[out] child     The child attribute retrieved.
+@related SUClassificationAttributeRef
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if attribute is not a valid object
+- \ref SU_ERROR_NULL_POINTER_OUTPUT if child is NULL
+*/
+SU_RESULT SUClassificationAttributeGetChild(
+    SUClassificationAttributeRef attribute, size_t index, SUClassificationAttributeRef* child);
+
+#ifdef __cplusplus
+}  //  extern "C" {
+#endif
+
+#endif  // SKETCHUP_MODEL_CLASSIFICATION_ATTRIBUTE_H_

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

@@ -0,0 +1,125 @@
+// Copyright 2016-2020 Trimble Inc. All Rights Reserved
+
+/**
+ * @file
+ * @brief Interfaces for SUClassificationInfoRef.
+ */
+#ifndef SKETCHUP_MODEL_CLASSIFICATION_INFO_H_
+#define SKETCHUP_MODEL_CLASSIFICATION_INFO_H_
+
+#include <SketchUpAPI/common.h>
+#include <SketchUpAPI/unicodestring.h>
+#include <SketchUpAPI/model/defs.h>
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/**
+@struct SUClassificationInfoRef
+@brief  References an object with classification information. Each
+        SUClassificationInfoRef contains the names of the schemas and the schema
+        types, and the types attributes. See SUClassificationAttributeRef for
+        details on the type attributes.
+*/
+
+/**
+@brief Releases the classification info. Classification info objects are created
+       from component instance using
+       SUComponentInstanceCreateClassificationInfo(), and must be released using
+       this function. This function also invalidates the given
+       SUClassificationInfoRef.
+@since SketchUp 2017, API 5.0
+@param[in,out]  classification_info The classification info object.
+@related SUClassificationInfoRef
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_NULL_POINTER_INPUT if classification_info is NULL
+- \ref SU_ERROR_INVALID_INPUT if classification_info is not a valid object
+*/
+SU_RESULT SUClassificationInfoRelease(SUClassificationInfoRef* classification_info);
+
+/**
+@brief Retrieves the number of schemas that have been applied to the
+       component instance.
+@since SketchUp 2017, API 5.0
+@param[in]  classification_info The classification info object.
+@param[out] count               The number of classifications.
+@related SUClassificationInfoRef
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if classification_info is not a valid object
+- \ref SU_ERROR_NULL_POINTER_OUTPUT if count is NULL
+*/
+SU_RESULT SUClassificationInfoGetNumSchemas(
+    SUClassificationInfoRef classification_info, size_t* count);
+
+/**
+@brief Retrieves the schema name for the classification at the given index.
+@param[in]  classification_info The classification info object.
+@param[in]  index               The classification index.
+@param[out] schema_name         The name of the schema.
+@related SUClassificationInfoRef
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if classification_info is an invalid object
+- \ref SU_ERROR_OUT_OF_RANGE if index is larger than the number of schemas
+- \ref SU_ERROR_NULL_POINTER_OUTPUT if schema_name is NULL
+- \ref SU_ERROR_INVALID_OUTPUT if *schema_name is not a valid object
+*/
+SU_RESULT SUClassificationInfoGetSchemaName(
+    SUClassificationInfoRef classification_info, size_t index, SUStringRef* schema_name);
+
+/**
+@brief Retrieves the schema type for the classification at the given index.
+@param[in]  classification_info The classification info object.
+@param[in]  index               The classification index.
+@param[out] schema_type         The applied type from the schema.
+@related SUClassificationInfoRef
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if classification_info is an invalid object
+- \ref SU_ERROR_OUT_OF_RANGE if index is larger than the number of schemas
+- \ref SU_ERROR_NULL_POINTER_OUTPUT if schema_type is NULL
+- \ref SU_ERROR_INVALID_OUTPUT if *schema_type is not a valid object
+*/
+SU_RESULT SUClassificationInfoGetSchemaType(
+    SUClassificationInfoRef classification_info, size_t index, SUStringRef* schema_type);
+
+/**
+@brief Retrieves the classification attribute for the classification at the
+       given index.
+@param[in]  classification_info The classification info object.
+@param[in]  index               The classification index.
+@param[out] attribute           The attribute retrieved.
+@related SUClassificationInfoRef
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if classification_info is an invalid object
+- \ref SU_ERROR_OUT_OF_RANGE if index is larger than the number of schemas
+- \ref SU_ERROR_NULL_POINTER_OUTPUT if attribute is NULL
+*/
+SU_RESULT SUClassificationInfoGetSchemaAttribute(
+    SUClassificationInfoRef classification_info, size_t index,
+    SUClassificationAttributeRef* attribute);
+
+/**
+@brief Retrieves the classification attribute with the given path.
+@param[in]  classification_info The classification info object.
+@param[in]  path                The path of the classification attribute to get.
+@param[out] attribute           The attribute retrieved.
+@related SUClassificationInfoRef
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if classification_info is an invalid object
+- \ref SU_ERROR_NULL_POINTER_OUTPUT if attribute is NULL
+*/
+SU_RESULT SUClassificationInfoGetSchemaAttributeByPath(
+    SUClassificationInfoRef classification_info, SUStringRef path,
+    SUClassificationAttributeRef* attribute);
+
+#ifdef __cplusplus
+}  //  extern "C" {
+#endif
+
+#endif  // SKETCHUP_MODEL_CLASSIFICATION_INFO_H_

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

@@ -0,0 +1,86 @@
+// Copyright 2014-2021 Trimble Inc. All Rights Reserved.
+
+/**
+ * @file
+ * @brief Interfaces for SUClassificationsRef.
+ */
+#ifndef SKETCHUP_MODEL_CLASSIFICATIONS_H_
+#define SKETCHUP_MODEL_CLASSIFICATIONS_H_
+
+#include <SketchUpAPI/common.h>
+#include <SketchUpAPI/model/defs.h>
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/**
+@struct SUClassificationsRef
+@brief  Used to manage a Classifications object
+*/
+
+/**
+@brief Loads a schema into a classifications object.
+@param[in]  classifications  The classificationss object.
+@param[in]  schema_file_name The full path of the schema to load.
+@related SUClassificationsRef
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if classifications is not a valid object
+- \ref SU_ERROR_INVALID_INPUT if schema_file_name is not a valid path to a schema
+       or is NULL
+*/
+SU_RESULT SUClassificationsLoadSchema(
+    SUClassificationsRef classifications, const char* schema_file_name);
+
+/**
+@brief Gets a schema from a classifications object.
+@param[in]  classifications  The classifications object.
+@param[in]  schema_name      The name of the schema to get.
+@param[out] schema_ref       The schema retrieved.
+@related SUClassificationsRef
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if classifications is not a valid object
+- \ref SU_ERROR_NULL_POINTER_INPUT if schema_name is NULL
+- \ref SU_ERROR_INVALID_INPUT if schema_name is not a loaded schema
+- \ref SU_ERROR_NULL_POINTER_OUTPUT if schema_ref is NULL
+*/
+SU_RESULT SUClassificationsGetSchema(
+    SUClassificationsRef classifications, const char* schema_name, SUSchemaRef* schema_ref);
+
+/**
+@brief Gets the number of schemata from a classifications object.
+@since SketchUp 2022.0, API 10.0
+@param[in]  classifications  The classifications object.
+@param[out] num_schemas      The number of schemas in the classifications object.
+@related SUClassificationsRef
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if \p classifications is not a valid object
+- \ref SU_ERROR_NULL_POINTER_OUTPUT if \p num_schemas is NULL
+*/
+SU_RESULT SUClassificationsGetNumSchemas(SUClassificationsRef classifications, size_t* num_schemas);
+
+/**
+@brief Retrieves the schemas in the classifications object.
+@since SketchUp 2022.0, API 10.0
+@param[in]  classifications  The classifications object.
+@param[in]  len              The number of schemas to retrieve.
+@param[out] schemas          The schemas retrieved.
+@param[out] count            The number of schemas retrieved.
+@related SUClassificationsRef
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if \p classifications is not a valid object
+- \ref SU_ERROR_NULL_POINTER_OUTPUT if \p schemas or \p count is NULL
+- \ref SU_ERROR_NO_DATA if \p len is greater than 0, but no schemas were found in \p classifications
+*/
+SU_RESULT SUClassificationsGetSchemas(
+    SUClassificationsRef classifications, size_t len, SUSchemaRef schemas[], size_t* count);
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif  // SKETCHUP_MODEL_CLASSIFICATIONS_H_