scriptup 0.0.0

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

@@ -0,0 +1,92 @@
+// Copyright 2015 Trimble Inc.  All Rights Reserved
+
+/**
+ * @file
+ * @brief Interfaces for SUDynamicComponentAttributeRef.
+ */
+#ifndef SKETCHUP_MODEL_DYNAMIC_COMPONENT_ATTRIBUTE_H_
+#define SKETCHUP_MODEL_DYNAMIC_COMPONENT_ATTRIBUTE_H_
+
+#include <SketchUpAPI/common.h>
+#include <SketchUpAPI/unicodestring.h>
+#include <SketchUpAPI/model/defs.h>
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/**
+@struct SUDynamicComponentAttributeRef
+@brief  References attribute data about a dynamic component.
+*/
+
+/**
+@brief Gets the name of the attribute.
+@since SketchUp 2016, API 4.0
+@param[in]  attribute The dynamic component attribute object.
+@param[out] name      The internal name of the attribute.
+@related SUDynamicComponentAttributeRef
+@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 name is NULL
+- \ref SU_ERROR_INVALID_OUTPUT if name does not point to a valid \ref
+  SUStringRef object
+*/
+SU_RESULT SUDynamicComponentAttributeGetName(
+    SUDynamicComponentAttributeRef attribute, SUStringRef* name);
+
+/**
+@brief Gets the display name of the attribute.
+@since SketchUp 2016, API 4.0
+@param[in]  attribute    The dynamic component attribute object.
+@param[out] display_name The attribute name as it should be displayed to the
+                         user.
+@related SUDynamicComponentAttributeRef
+@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 display_name is NULL
+- \ref SU_ERROR_INVALID_OUTPUT if display_name does not point to a valid \ref
+  SUStringRef object
+*/
+SU_RESULT SUDynamicComponentAttributeGetDisplayName(
+    SUDynamicComponentAttributeRef attribute, SUStringRef* display_name);
+
+/**
+@brief Gets the visibility setting of the attribute.
+@since SketchUp 2016, API 4.0
+@param[in]  attribute  The dynamic component attribute object.
+@param[out] visible    Set to true if the attribute is visible to users and
+                       false if it is not.
+@related SUDynamicComponentAttributeRef
+@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 visible is NULL
+*/
+SU_RESULT SUDynamicComponentAttributeGetVisibility(
+    SUDynamicComponentAttributeRef attribute, bool* visible);
+
+/**
+@brief Gets the display value of the attribute.
+@since SketchUp 2016, API 4.0
+@param[in]  attribute     The dynamic component attribute object.
+@param[out] display_value The value data for the attribute converted to a string
+                          formatted as it should be displayed to the user.
+@related SUDynamicComponentAttributeRef
+@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 display_value is NULL
+- \ref SU_ERROR_INVALID_OUTPUT if display_value does not point to a valid \ref
+  SUStringRef object
+*/
+SU_RESULT SUDynamicComponentAttributeGetDisplayValue(
+    SUDynamicComponentAttributeRef attribute, SUStringRef* display_value);
+
+#ifdef __cplusplus
+}  //  extern "C" {
+#endif
+
+#endif  // SKETCHUP_MODEL_DYNAMIC_COMPONENT_ATTRIBUTE_H_

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

@@ -0,0 +1,70 @@
+// Copyright 2015 Trimble Inc.  All Rights Reserved
+
+/**
+ * @file
+ * @brief Interfaces for SUDynamicComponentInfoRef.
+ */
+#ifndef SKETCHUP_MODEL_DYNAMIC_COMPONENT_INFO_H_
+#define SKETCHUP_MODEL_DYNAMIC_COMPONENT_INFO_H_
+
+#include <SketchUpAPI/common.h>
+#include <SketchUpAPI/unicodestring.h>
+#include <SketchUpAPI/model/defs.h>
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/**
+@struct SUDynamicComponentInfoRef
+@brief  References an object with information about a dynamic component.
+*/
+
+/**
+@brief Releases the DC info. DC info objects are created from component instance
+       using SUComponentInstanceCreateDCInfo(), and must be released using
+       this function. This function also invalidates the given DC info.
+@since SketchUp 2016, API 4.0
+@param[in,out]  dc_info The dynamic component info object.
+@related SUDynamicComponentInfoRef
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_NULL_POINTER_INPUT if dc_info is NULL
+- \ref SU_ERROR_INVALID_INPUT if dc_info is not a valid object
+*/
+SU_RESULT SUDynamicComponentInfoRelease(SUDynamicComponentInfoRef* dc_info);
+
+/**
+@brief Retrieves the number of dynamic component attributes.
+@param[in]  dc_info The dynamic component info object.
+@param[out] count   The number of attributes.
+@related SUDynamicComponentInfoRef
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if dc_info is an invalid object
+- \ref SU_ERROR_NULL_POINTER_OUTPUT if count is NULL
+*/
+SU_RESULT SUDynamicComponentInfoGetNumDCAttributes(
+    SUDynamicComponentInfoRef dc_info, size_t* count);
+
+/**
+@brief Retrieves the dynamic component attributes.
+@param[in]  dc_info    The dynamic component info object.
+@param[in]  len        The number of attributes to retrieve.
+@param[out] attributes The attributes retrieved.
+@param[out] count      The number of attributes retrieved.
+@related SUDynamicComponentInfoRef
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if dc_info is an invalid object
+- \ref SU_ERROR_NULL_POINTER_OUTPUT if attributes or count is NULL
+*/
+SU_RESULT SUDynamicComponentInfoGetDCAttributes(
+    SUDynamicComponentInfoRef dc_info, size_t len, SUDynamicComponentAttributeRef attributes[],
+    size_t* count);
+
+#ifdef __cplusplus
+}  //  extern "C" {
+#endif
+
+#endif  // SKETCHUP_MODEL_DYNAMIC_COMPONENT_INFO_H_

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

@@ -0,0 +1,271 @@
+// Copyright 2013 Trimble Inc. All Rights Reserved.
+
+/**
+ * @file
+ * @brief Interfaces for SUEdgeRef.
+ */
+#ifndef SKETCHUP_MODEL_EDGE_H_
+#define SKETCHUP_MODEL_EDGE_H_
+
+#include <SketchUpAPI/color.h>
+#include <SketchUpAPI/common.h>
+#include <SketchUpAPI/geometry.h>
+#include <SketchUpAPI/unicodestring.h>
+#include <SketchUpAPI/transformation.h>
+#include <SketchUpAPI/model/defs.h>
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/**
+ * @struct SUEdgeRef
+ * @extends SUDrawingElementRef
+ * @brief  References an edge.
+ */
+
+/**
+@brief Converts from an \ref SUEdgeRef to an \ref SUEntityRef.
+       This is essentially an upcast operation.
+@param[in] edge The given edge reference.
+@related SUEdgeRef
+@return
+- The converted \ref SUEntityRef if edge is a valid edge
+- If not, the returned reference will be invalid
+*/
+SU_EXPORT SUEntityRef SUEdgeToEntity(SUEdgeRef edge);
+
+/**
+@brief Converts from an \ref SUEntityRef to an \ref SUEdgeRef.
+       This is essentially a downcast operation so the given entity must be
+       convertible to an \ref SUEdgeRef.
+@param[in] entity The given entity reference.
+@related SUEdgeRef
+@return
+- The converted \ref SUEdgeRef if the downcast operation succeeds
+- If not, the returned reference will be invalid
+*/
+SU_EXPORT SUEdgeRef SUEdgeFromEntity(SUEntityRef entity);
+
+/**
+@brief Converts from an \ref SUEdgeRef to an \ref SUDrawingElementRef.
+       This is essentially an upcast operation.
+@param[in] edge The given edge reference.
+@related SUEdgeRef
+@return
+- The converted \ref SUEntityRef if edge is a valid edge
+- If not, the returned reference will be invalid
+*/
+SU_EXPORT SUDrawingElementRef SUEdgeToDrawingElement(SUEdgeRef edge);
+
+/**
+@brief Converts from an \ref SUDrawingElementRef to an \ref SUEdgeRef.
+       This is essentially a downcast operation so the given element must be
+       convertible to an \ref SUEdgeRef.
+@param[in] drawing_elem The given element reference.
+@related SUEdgeRef
+@return
+- The converted \ref SUEdgeRef if the downcast operation succeeds
+- If not, the returned reference will be invalid.
+*/
+SU_EXPORT SUEdgeRef SUEdgeFromDrawingElement(SUDrawingElementRef drawing_elem);
+
+/**
+@brief Creates a new edge object.
+
+The edge object must be subsequently deallocated with \ref SUEdgeRelease() unless
+the edge object is associated with a parent object.
+@param[out] edge  The edge object.
+@param[in]  start The start position of the edge object.
+@param[in]  end   The end position of the edge object.
+@related SUEdgeRef
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_NULL_POINTER_INPUT if start or end is NULL
+- \ref SU_ERROR_NULL_POINTER_OUTPUT if edge is NULL
+- \ref SU_ERROR_GENERIC if start and end specify the same position.
+*/
+SU_RESULT SUEdgeCreate(SUEdgeRef* edge, const struct SUPoint3D* start, const struct SUPoint3D* end);
+
+/**
+@brief Releases an edge object.
+
+The edge object must have been created with SUEdgeCreate() and not
+subsequently associated with a parent object (e.g. SUEntitiesAddEdges()).
+@param[in] edge The edge object.
+@related SUEdgeRef
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if edge does not reference a valid object
+- \ref SU_ERROR_NULL_POINTER_INPUT if edge is NULL
+*/
+SU_RESULT SUEdgeRelease(SUEdgeRef* edge);
+
+/**
+@brief Retrieves the associated curve object of an edge object.
+@param[in]  edge  The edge object.
+@param[out] curve The curve object retrieved.
+@related SUEdgeRef
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_NULL_POINTER_OUTPUT if curve is NULL
+- \ref SU_ERROR_NO_DATA if the edge object is not associated with a curve
+  object.
+*/
+SU_RESULT SUEdgeGetCurve(SUEdgeRef edge, SUCurveRef* curve);
+
+/**
+@brief Retrieves the starting vertex of an edge object.
+@param[in]  edge   The edge object.
+@param[out] vertex The vertex object retrieved.
+@related SUEdgeRef
+@return
+- \ref SU_ERROR_NONE on success.
+- \ref SU_ERROR_INVALID_INPUT if edge is an invalid edge object
+- \ref SU_ERROR_NULL_POINTER_OUTPUT if vertex is NULL.
+*/
+SU_RESULT SUEdgeGetStartVertex(SUEdgeRef edge, SUVertexRef* vertex);
+
+/**
+@brief Retrieves the end vertex of an edge object.
+@param[in]  edge   The edge object.
+@param[out] vertex The vertex object retrieved.
+@related SUEdgeRef
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if edge is an invalid object
+- \ref SU_ERROR_NULL_POINTER_OUTPUT if vertex is NULL
+*/
+SU_RESULT SUEdgeGetEndVertex(SUEdgeRef edge, SUVertexRef* vertex);
+
+/**
+@brief Sets the soft flag of an edge object.
+@param[in] edge      The edge object.
+@param[in] soft_flag The soft flag to set.
+@related SUEdgeRef
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if edge is an invalid object
+*/
+SU_RESULT SUEdgeSetSoft(SUEdgeRef edge, bool soft_flag);
+
+/**
+@brief Retrieves the soft flag of an edge object.
+@param[in]  edge      The edge object.
+@param[out] soft_flag The soft flag retrieved.
+@related SUEdgeRef
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if edge is an invalid object.
+- \ref SU_ERROR_NULL_POINTER_OUTPUT if soft_flag is NULL
+*/
+SU_RESULT SUEdgeGetSoft(SUEdgeRef edge, bool* soft_flag);
+
+/**
+@brief Sets the smooth flag of an edge object.
+@param[in] edge        The edge object.
+@param[in] smooth_flag The smooth flag to set.
+@related SUEdgeRef
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if edge is an invalid object
+*/
+SU_RESULT SUEdgeSetSmooth(SUEdgeRef edge, bool smooth_flag);
+
+/**
+@brief Retrieves the smooth flag of an edge object.
+@param[in]  edge        The edge object.
+@param[out] smooth_flag The smooth flag retrieved.
+@related SUEdgeRef
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if edge is an invalid object
+- \ref SU_ERROR_NULL_POINTER_OUTPUT if smooth_flag is NULL
+*/
+SU_RESULT SUEdgeGetSmooth(SUEdgeRef edge, bool* smooth_flag);
+
+/**
+@brief Retrieves the number of faces that the edge is associated with.
+@param[in]  edge  The edge object.
+@param[out] count The number of faces.
+@related SUEdgeRef
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if edge is an invalid object
+- \ref SU_ERROR_NULL_POINTER_OUTPUT if count is NULL
+*/
+SU_RESULT SUEdgeGetNumFaces(SUEdgeRef edge, size_t* count);
+
+/**
+@brief Retrieves the face objects associated with an edge object.
+@param[in]  edge  The edge object.
+@param[in]  len   The number of faces to retrieve.
+@param[out] faces The faces retrieved.
+@param[out] count The number of face objects retrieved.
+@related SUEdgeRef
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if edge is an invalid object
+- \ref SU_ERROR_NULL_POINTER_OUTPUT if faces or count is NULL
+*/
+SU_RESULT SUEdgeGetFaces(SUEdgeRef edge, size_t len, SUFaceRef faces[], size_t* count);
+
+/**
+@brief Retrieves the color of an edge object.
+@param[in]  edge  The edge object.
+@param[out] color The color retrieved.
+@related SUEdgeRef
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if edge is not a valid object
+- \ref SU_ERROR_NULL_POINTER_OUTPUT if color is NULL
+*/
+SU_RESULT SUEdgeGetColor(SUEdgeRef edge, SUColor* color);
+
+/**
+@brief Computes the length of the edge with the provided transformation applied.
+@param[in]  edge      The edge object.
+@param[in]  transform A transformation to be appllied to the edge.
+@param[out] length    The length retrieved.
+@related SUEdgeRef
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if edge is not a valid object
+- \ref SU_ERROR_NULL_POINTER_OUTPUT if color is NULL
+*/
+SU_RESULT SUEdgeGetLengthWithTransform(
+    SUEdgeRef edge, const struct SUTransformation* transform, double* length);
+
+/**
+@brief Sets the color of an edge object.
+@param[in] edge  The edge object.
+@param[in] color The color object to set.
+@related SUEdgeRef
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if edge is an invalid object.
+- \ref SU_ERROR_NULL_POINTER_INPUT if color is NULL.
+*/
+SU_RESULT SUEdgeSetColor(SUEdgeRef edge, const SUColor* color);
+
+/**
+@brief Determine if \p edge is reversed in \p face 's bounding loop.
+@since SketchUp 2021.1, API 9.1
+@param [in]  edge The edge object.
+@param [in]  face The face object.
+@param [out] reversed The reverse status retrieved.
+@related SUEdgeRef
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if \p edge is an invalid object.
+- \ref SU_ERROR_INVALID_INPUT if \p face is an invalid object.
+- \ref SU_ERROR_NULL_POINTER_OUTPUT if \p reversed is null.
+- \ref SU_ERROR_INVALID_ARGUMENT if \p edge is not bounding \p face.
+*/
+SU_RESULT SUEdgeReversedInFace(SUEdgeRef edge, SUFaceRef face, bool* reversed);
+
+#ifdef __cplusplus
+}  // extern "C"
+#endif
+
+#endif  // SKETCHUP_MODEL_EDGE_H_

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

@@ -0,0 +1,214 @@
+// Copyright 2013 Trimble Inc. All Rights Reserved.
+
+/**
+ * @file
+ * @brief Interfaces for SUEdgeUseRef.
+ */
+#ifndef SKETCHUP_MODEL_EDGE_USE_H_
+#define SKETCHUP_MODEL_EDGE_USE_H_
+
+#include <SketchUpAPI/common.h>
+#include <SketchUpAPI/geometry.h>
+#include <SketchUpAPI/model/defs.h>
+
+/**
+@struct SUEdgeUseRef
+@extends SUEntityRef
+@brief SUEdgeUseRef objects are used to retrieve the topology of the edges of
+       a polygon. The geometry of the polygon being represented by \ref
+       SULoopRef that is already associated with a face object. The typical use
+       of EdgeUse object is to retrieve them from a face object's loop, and then
+       read the topology values from them.
+*/
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/**
+@brief Converts from an \ref SUEdgeUseRef to an \ref SUEntityRef.
+       This is essentially an upcast operation.
+@param[in] edgeuse The given edge use reference.
+@related SUEdgeUseRef
+@return
+- The converted \ref SUEntityRef if edgeuse is a valid edge use.
+- If not, the returned reference will be invalid.
+*/
+SU_EXPORT SUEntityRef SUEdgeUseToEntity(SUEdgeUseRef edgeuse);
+
+/**
+@brief Converts from an \ref SUEntityRef to an \ref SUEdgeUseRef.
+       This is essentially a downcast operation so the given \ref SUEntityRef
+       must be convertible to an \ref SUEdgeUseRef.
+@param[in] entity The given entity reference.
+@related SUEdgeUseRef
+@return
+- The converted \ref SUEdgeUseRef if the downcast operation succeeds.
+- If not, the returned reference will be invalid.
+*/
+SU_EXPORT SUEdgeUseRef SUEdgeUseFromEntity(SUEntityRef entity);
+
+/**
+@brief Retrieves the edge object the EdgeUse object belongs to.
+@param[in]  edgeuse The EdgeUse object.
+@param[out] edge    The edge object retrieved.
+@related SUEdgeUseRef
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if edgeuse is not a valid object
+- \ref SU_ERROR_NULL_POINTER_OUTPUT if edge is NULL.
+*/
+SU_RESULT SUEdgeUseGetEdge(SUEdgeUseRef edgeuse, SUEdgeRef* edge);
+
+/**
+@brief Retrieves the loop object the EdgeUse object is associated with.
+@param[in]  edgeuse The EdgeUse object.
+@param[out] loop    The loop object retrieved.
+@related SUEdgeUseRef
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if edgeuse is not a valid object
+- \ref SU_ERROR_NULL_POINTER_OUTPUT if loop is NULL
+*/
+SU_RESULT SUEdgeUseGetLoop(SUEdgeUseRef edgeuse, SULoopRef* loop);
+
+/**
+@brief Retrieves the face object the EdgeUse object is associated with.
+@param[in]  edgeuse The EdgeUse object.
+@param[out] face    The face object retrieved.
+@related SUEdgeUseRef
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if edgeuse is not a valid object
+- \ref SU_ERROR_NULL_POINTER_OUTPUT if face is NULL
+*/
+SU_RESULT SUEdgeUseGetFace(SUEdgeUseRef edgeuse, SUFaceRef* face);
+
+/**
+@brief Retrieves the number of EdgeUse objects that are linked to the EdgeUse
+       object.
+@param[in]  edgeuse The EdgeUse object.
+@param[out] count   The number of partners.
+@related SUEdgeUseRef
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if edgeuse is not a valid object
+- \ref SU_ERROR_NULL_POINTER_OUTPUT if count is NULL
+*/
+SU_RESULT SUEdgeUseGetNumPartners(SUEdgeUseRef edgeuse, size_t* count);
+
+/**
+@brief Retrieves the EdgeUse objects that are linked to the EdgeUse object.
+@param[in]  edgeuse  The EdgeUse object.
+@param[in]  len      The number of partners to retrieve.
+@param[out] partners The partners retrieved.
+@param[out] count    The number of partners retrieved.
+@related SUEdgeUseRef
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if edgeuse is not a valid object
+- \ref SU_ERROR_NULL_POINTER_OUTPUT if partners or count is NULL
+*/
+SU_RESULT SUEdgeUseGetPartners(
+    SUEdgeUseRef edgeuse, size_t len, SUEdgeUseRef partners[], size_t* count);
+
+/**
+@brief Retrieves a flag indicating whether this EdgeUse is traversed in the
+       opposite direction as its corresponding edge.
+@param[in]  edgeuse The EdgeUse object.
+@param[out] reversed The retrieved flag.
+@related SUEdgeUseRef
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if edgeuse is not a valid object
+- \ref SU_ERROR_NULL_POINTER_OUTPUT if reversed is NULL.
+*/
+SU_RESULT SUEdgeUseIsReversed(SUEdgeUseRef edgeuse, bool* reversed);
+
+/**
+@brief Retrieves the EdgeUse object just preceding an EdgeUse object in the
+       collection of linked EdgeUses.
+@param[in]  edgeuse      The EdgeUse object.
+@param[out] prev_edgeuse The EdgeUse retrieved.
+@related SUEdgeUseRef
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if edgeuse is not a valid object
+- \ref SU_ERROR_NULL_POINTER_OUTPUT if prev_edgeuse is NULL.
+*/
+SU_RESULT SUEdgeUseGetPrevious(SUEdgeUseRef edgeuse, SUEdgeUseRef* prev_edgeuse);
+
+/**
+@brief Retrieves the EdgeUse object just following an EdgeUse object in the
+       collection of linked EdgeUses.
+@param[in]  edgeuse      The EdgeUse object.
+@param[out] next_edgeuse The EdgeUse retrieved.
+@related SUEdgeUseRef
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if edgeuse is not a valid object
+- \ref SU_ERROR_NULL_POINTER_OUTPUT if next_edgeuse is NULL.
+*/
+SU_RESULT SUEdgeUseGetNext(SUEdgeUseRef edgeuse, SUEdgeUseRef* next_edgeuse);
+
+/**
+@brief Retrieves the start vertex of an EdgeUse object. The start vertex of the
+       EdgeUse object may not be the same as the start vertex of the
+       corresponding edge of the EdgeUse object. An EdgeUse object is part of a
+       face loop whose direction may be the reverse of the direction of the
+       edge.
+@param[in]  edgeuse The EdgeUse object.
+@param[out] vertex  The vertex object retrieved.
+@related SUEdgeUseRef
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if edge is not a valid EdgeUse object
+- \ref SU_ERROR_NULL_POINTER_OUTPUT if vertex is NULL
+*/
+SU_RESULT SUEdgeUseGetStartVertex(SUEdgeUseRef edgeuse, SUVertexRef* vertex);
+
+/**
+@brief Retrieves the end vertex of an EdgeUse object.
+
+The end vertex of the EdgeUse object may not be the same as the end vertex of
+the corresponding edge of the EdgeUse object. An EdgeUse object is part of a
+face loop whose direction may be the reverse of the direction of the edge.
+@param[in]  edgeuse The EdgeUse object.
+@param[out] vertex  The vertex object retrieved.
+@related SUEdgeUseRef
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if edge is not a valid EdgeUse object
+- \ref SU_ERROR_NULL_POINTER_OUTPUT if vertex is NULL
+*/
+SU_RESULT SUEdgeUseGetEndVertex(SUEdgeUseRef edgeuse, SUVertexRef* vertex);
+
+/**
+@brief Retrieves the normal vector at the start vertex of an EdgeUse object.
+@param[in]  edgeuse The EdgeUse object.
+@param[out] normal  The normal vector retrieved.
+@related SUEdgeUseRef
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if edge is not a valid object
+- \ref SU_ERROR_NULL_POINTER_OUTPUT if normal is NULL
+*/
+SU_RESULT SUEdgeUseGetStartVertexNormal(SUEdgeUseRef edgeuse, struct SUVector3D* normal);
+
+/**
+@brief Retrieves the normal vector at the end vertex of an EdgeUse object.
+@param[in]  edgeuse The EdgeUse object.
+@param[out] normal  The normal vector retrieved.
+@related SUEdgeUseRef
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if edge is not a valid object
+- \ref SU_ERROR_NULL_POINTER_OUTPUT if normal is NULL.
+*/
+SU_RESULT SUEdgeUseGetEndVertexNormal(SUEdgeUseRef edgeuse, struct SUVector3D* normal);
+
+#ifdef __cplusplus
+}  //  extern "C" {
+#endif
+
+#endif  // SKETCHUP_MODEL_EDGE_USE_H_