scriptup 0.0.0

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

@@ -0,0 +1,358 @@
+// Copyright 2013 Trimble Inc. All Rights Reserved.
+
+/**
+ * @file
+ * @brief Interfaces for SUTextureRef.
+ */
+#ifndef SKETCHUP_MODEL_TEXTURE_H_
+#define SKETCHUP_MODEL_TEXTURE_H_
+
+#include <stddef.h>
+#include <SketchUpAPI/color.h>
+#include <SketchUpAPI/unicodestring.h>
+#include <SketchUpAPI/model/defs.h>
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/**
+@struct SUTextureRef
+@extends SUEntityRef
+@brief  Used to manage image data that can be associated with any \ref
+        SUEntityRef.
+*/
+
+/**
+@brief  Converts from an \ref SUTextureRef to an \ref SUEntityRef. This is
+        essentially an upcast operation.
+@param[in] texture The texture reference.
+@related SUTextureRef
+@return
+- The converted \ref SUEntityRef if texture is a valid object. If not, the
+  returned reference will be invalid.
+*/
+SU_EXPORT SUEntityRef SUTextureToEntity(SUTextureRef texture);
+
+/**
+@brief  Converts from an \ref SUEntityRef to an \ref SUTextureRef. This is
+        essentially a downcast operation so the given \ref SUEntityRef must be
+        convertible to an \ref SUTextureRef.
+@param[in] entity The entity reference.
+@related SUTextureRef
+@return
+- The converted \ref SUTextureRef if the downcast operation succeeds. If
+  not, the returned reference will be invalid.
+*/
+SU_EXPORT SUTextureRef SUTextureFromEntity(SUEntityRef entity);
+
+/**
+@brief  Creates a new texture object with the specified image data.  If the
+        texture object is not subsequently associated with a parent object (e.g.
+        material), then the texture object must be deallocated with \ref
+        SUTextureRelease.
+@deprecated Will be removed in the next version of the SketchUp API. The
+            functionality is replaced by SUImageRepSetData() followed by
+            SUTextureCreateFromImageRep().
+@param[out] texture        The texture object created.
+@param[in]  width          The width in pixels of the texture data.
+@param[in]  height         The height in pixels of the texture data.
+@param[in]  bits_per_pixel The number of bits per pixel of the image data.
+@param[in]  pixel_data     The source of the pixel data.
+@related SUTextureRef
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_NULL_POINTER_INPUT if pixels is NULL
+- \ref SU_ERROR_NULL_POINTER_OUTPUT texture is NULL
+- \ref SU_ERROR_OVERWRITE_VALID if texture already references a valid object
+*/
+SU_DEPRECATED_FUNCTION("SketchUp API 5.0")
+SU_RESULT SUTextureCreateFromImageData(
+    SUTextureRef* texture, size_t width, size_t height, size_t bits_per_pixel,
+    const SUByte pixel_data[]);
+
+/**
+@brief Creates a new texture object from an image representation object.
+@since SketchUp 2017, API 5.0
+@param[out] texture The texture object created.
+@param[in]  image   The image retrieved.
+@related SUTextureRef
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_NULL_POINTER_OUTPUT if texture is NULL
+- \ref SU_ERROR_OVERWRITE_VALID if texture already references a valid object
+- \ref SU_ERROR_INVALID_INPUT if image is not a valid object
+- \ref SU_ERROR_NO_DATA if the image contains no data
+*/
+SU_RESULT SUTextureCreateFromImageRep(SUTextureRef* texture, SUImageRepRef image);
+
+/**
+@brief  Creates a new texture object from an image file specified by a path.
+        If the texture object is not subsequently associated with a parent
+        object (e.g. material), then the texture object must be deallocated with
+        SUTextureRelease.
+@param[out] texture   The texture object created.
+@param[in]  file_path The file path of the source image file. Assumed to be
+                      UTF-8 encoded.
+@param[in]  s_scale   The scale factor for s coordinate value.
+@param[in]  t_scale   The scale factor for t coordinate value.
+@related SUTextureRef
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_NULL_POINTER_INPUT if file_path is NULL
+- \ref SU_ERROR_SERIALIZATION if the image file could not be opened
+- \ref SU_ERROR_GENERIC if a texture could not be created from the image file
+- \ref SU_ERROR_NULL_POINTER_OUTPUT if texture is NULL
+- \ref SU_ERROR_OVERWRITE_VALID is texture already references a valid object
+*/
+SU_RESULT SUTextureCreateFromFile(
+    SUTextureRef* texture, const char* file_path, double s_scale, double t_scale);
+
+/**
+@brief  Deallocates a texture object and its resources. If the texture object
+        is associated with a parent object (e.g. material) the parent object
+        handles the deallocation of the resources of the texture object and the
+        texture object must not be explicitly deallocated.
+@param[in] texture The texture object to deallocate.
+@related SUTextureRef
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_NULL_POINTER_INPUT if texture is NULL
+- \ref SU_ERROR_INVALID_INPUT if texture does not refer to a valid object
+*/
+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
+        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.
+@param[in] texture  The texture object whose dimensions are retrieved.
+@param[out] width   The width in pixels.
+@param[out] height  The height in pixels.
+@param[out] s_scale The s coordinate scale factor to map a pixel into model
+                    coordinates.
+@param[out] 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 texture is an invalid object
+- \ref SU_ERROR_NULL_POINTER_OUTPUT if width, height, s_scale, or t_scale is
+  NULL
+*/
+SU_RESULT SUTextureGetDimensions(
+    SUTextureRef texture, size_t* width, size_t* height, 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
+        necessary to be passed into \ref SUTextureGetImageData(). The returned
+        data can be used along with the returned bits-per-pixel value and the
+        texture dimensions to compute RGBA values at individual pixels of the
+        texture image.
+@deprecated Will be removed in the next version of the SketchUp API. The
+            functionality is replaced by SUTextureGetImageRep followed by
+            SUImageRepGetImageDataSize.
+@param[in]  texture        The texture object.
+@param[out] data_size      The total size of the image data in bytes.
+@param[out] bits_per_pixel The number of bits per pixel of the image data.
+@related SUTextureRef
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if texture is an invalid object
+- \ref SU_ERROR_NULL_POINTER_OUTPUT if data_size or bits_per_pixel is NULL
+*/
+SU_DEPRECATED_FUNCTION("SketchUp API 5.0")
+SU_RESULT SUTextureGetImageDataSize(
+    SUTextureRef texture, size_t* data_size, size_t* bits_per_pixel);
+
+/**
+@brief  Returns the texture's image data. The given array must be large enough
+        to hold the texture's image data. This size can be obtained by calling
+        \ref SUTextureGetImageDataSize().
+@deprecated Will be removed in the next version of the SketchUp API. The
+            functionality is replaced by SUTextureGetImageRep followed by
+            SUImageRepGetImageData.
+@param[in] texture     The texture object.
+@param[in] data_size   The size of the byte array.
+@param[out] pixel_data The image data retrieved.
+@related SUTextureRef
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if texture is an invalid object
+- \ref SU_ERROR_NULL_POINTER_OUTPUT if pixel_data is NULL
+- \ref SU_ERROR_INSUFFICIENT_SIZE if data_size is insufficient for the image
+  data
+*/
+SU_DEPRECATED_FUNCTION("SketchUp API 5.0")
+SU_RESULT SUTextureGetImageData(SUTextureRef texture, size_t data_size, SUByte pixel_data[]);
+
+/**
+@brief Retrieves a texture's image.  The given image object must have been
+       constructed using one of the SUImageRepCreate*  functions. It must be
+       released using SUImageRepRelease(). The difference between this
+       function and SUTextureGetColorizedImageRep() is that
+       SUTextureGetColorizedImageRep() will retrieve the colorized image
+       rep, if the material has been colorized.
+@since SketchUp 2017, API 5.0
+@param[in]  texture The texture object.
+@param[out] image The image object retrieved.
+@related SUTextureRef
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if texture is not a valid object
+- \ref SU_ERROR_NULL_POINTER_OUTPUT if image is NULL
+- \ref SU_ERROR_INVALID_OUTPUT if image does not point to a valid \ref
+       SUImageRepRef object
+- \ref SU_ERROR_NO_DATA if no image was created
+*/
+SU_RESULT SUTextureGetImageRep(SUTextureRef texture, SUImageRepRef* image);
+
+/**
+@brief  Writes a texture object as an image to disk. If the material has been
+        colorized this will write out a colorized texture.
+        Use \ref SUTextureWriteOriginalToFile() to obtain the original texture
+        without colorization.
+@param[in] texture   The texture object.
+@param[in] file_path The file path destination of the texture image. Assumed to
+                     be UTF-8 encoded.
+@related SUTextureRef
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if texture is not a valid object
+- \ref SU_ERROR_NULL_POINTER_INPUT if file_path is NULL
+- \ref SU_ERROR_SERIALIZATION if image file could not be written to disk
+*/
+SU_RESULT SUTextureWriteToFile(SUTextureRef texture, const char* file_path);
+
+/**
+@brief Sets the image file name string associated with the texture object. If
+       the input texture was constructed using \ref SUTextureCreateFromFile the
+       name will already be set, so calling this function will override the
+       texture's file name string.
+@since SketchUp 2017, API 5.0
+@param[in] texture The texture object.
+@param[in] name    The name string to set as the file name.
+Assumed to be UTF-8 encoded.
+@related SUTextureRef
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if texture is not a valid object
+- \ref SU_ERROR_NULL_POINTER_INPUT if name is NULL
+*/
+SU_RESULT SUTextureSetFileName(SUTextureRef texture, const char* name);
+
+/**
+@brief Retrieves the image file basename of a texture object. A full path may be
+       stored with the texture, but this method will always return a file name
+       string with no path. If the texture was created from an
+       \ref SUImageRepRef created with SUImageRepLoadFile() then this will
+       return only the file extension representing the file format of the image
+       data (e.g. ".png").
+@param[in]  texture   The texture object.
+@param[out] file_name The file name retrieved.
+@related SUTextureRef
+@see SUTextureGetFilePath
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if texture is not a valid object
+- \ref SU_ERROR_GENERIC if the texture is an unknown file type
+- \ref SU_ERROR_NULL_POINTER_OUTPUT if file_name is NULL
+- \ref SU_ERROR_INVALID_OUTPUT if file_name does not point to a valid \ref
+  SUStringRef object
+*/
+SU_RESULT SUTextureGetFileName(SUTextureRef texture, SUStringRef* file_name);
+
+/**
+@brief Retrieves the image file path of a texture object.
+
+If the texture was created from an \ref SUImageRepRef created with SUImageRepLoadFile()
+then this will return only the file extension representing the file format of the image
+data (e.g. ".png").
+
+@param[in]  texture   The texture object.
+@param[out] file_path The file path retrieved.
+@related SUTextureRef
+@since SketchUp 2023.1, API 11.1
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if \p texture is not a valid object
+- \ref SU_ERROR_GENERIC if the \p texture is an unknown file type
+- \ref SU_ERROR_NULL_POINTER_OUTPUT if \p file_path is NULL
+- \ref SU_ERROR_INVALID_OUTPUT if \p file_path does not point to a valid \ref
+  SUStringRef object
+*/
+SU_RESULT SUTextureGetFilePath(SUTextureRef texture, SUStringRef* file_path);
+
+/**
+@brief  Retrieves the value of the flag that indicates whether a texture object
+        uses the alpha channel.
+@param[in] texture             The texture object.
+@param[out] alpha_channel_used The destination of the retrieved value.
+@related SUTextureRef
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if texture is not a valid object
+- \ref SU_ERROR_NULL_POINTER_OUTPUT if alpha_channel_used is NULL
+- \ref SU_ERROR_NO_DATA if the flag value could not be retrieved
+*/
+SU_RESULT SUTextureGetUseAlphaChannel(SUTextureRef texture, bool* alpha_channel_used);
+
+/**
+@brief  Retrieves the average color for the texture.
+@param[in]  texture     The texture object
+@param[out] color_val   The color object
+@related SUTextureRef
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if texture is not a valid object
+- \ref SU_ERROR_NULL_POINTER_OUTPUT if color_val is NULL
+*/
+SU_RESULT SUTextureGetAverageColor(SUTextureRef texture, SUColor* color_val);
+
+/**
+@brief  Retrieves the image rep object of a colorized texture. If a
+        non-colorized texture is used, then the original image rep will be
+        retrieved. The difference between this function and
+        \ref SUTextureGetImageRep is that \ref SUTextureGetImageRep() will always
+        retrieve the original image rep.
+@since SketchUp 2018, API 6.0
+@param[in]  texture   The texture object.
+@param[out] image_rep The retrieved image rep.
+@related SUTextureRef
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if texture is not a valid object
+- \ref SU_ERROR_NULL_POINTER_OUTPUT if image_rep is NULL
+- \ref SU_ERROR_NO_DATA if no data was retrieved from the texture
+- \ref SU_ERROR_OUT_OF_RANGE if the pixel data is out of range
+*/
+SU_RESULT SUTextureGetColorizedImageRep(SUTextureRef texture, SUImageRepRef* image_rep);
+
+/**
+@brief  Writes a texture object as an image to disk without any colorization.
+        If the texture was created from a file on disk this will write out the
+        original file data if the provided file extension matches. This will be
+        the fastest way to extract the original texture from the model.
+        Use SUTextureGetFilename() to obtain the original file format.
+@since SketchUp 2019.2, API 7.1
+@param[in] texture   The texture object.
+@param[in] file_path The file path destination of the texture image. Assumed to
+                     be UTF-8 encoded.
+@related SUTextureRef
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if texture is not a valid object
+- \ref SU_ERROR_NULL_POINTER_INPUT if file_path is NULL
+- \ref SU_ERROR_SERIALIZATION if image file could not be written to disk
+*/
+SU_RESULT SUTextureWriteOriginalToFile(SUTextureRef texture, const char* file_path);
+
+#ifdef __cplusplus
+}  // extern "C"
+#endif
+
+#endif  // SKETCHUP_MODEL_TEXTURE_H_

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

@@ -0,0 +1,280 @@
+// Copyright 2013 Trimble Inc. All Rights Reserved.
+
+/**
+ * @file
+ * @brief Interfaces for SUTextureWriterRef.
+ */
+#ifndef SKETCHUP_MODEL_TEXTURE_WRITER_H_
+#define SKETCHUP_MODEL_TEXTURE_WRITER_H_
+
+#include <SketchUpAPI/geometry.h>
+#include <SketchUpAPI/unicodestring.h>
+#include <SketchUpAPI/model/defs.h>
+#include <SketchUpAPI/model/face.h>
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/**
+@struct SUTextureWriterRef
+@brief  Used to write out textures of various SketchUp model elements to local
+        disk.  For face objects texture writer modifies non-affine textures on
+        write so that the resulting texture image can be mapped with
+        2-dimensional texture coordinates.  The modified UV coordinates are
+        retrieved from a mesh object created with
+        SUMeshHelperCreateWithTextureWriter().
+*/
+
+/**
+@brief  Creates a new texture writer object. The texture writer must be
+        subsequently deallocated with SUTextureWriterRelease().
+@param[out] writer The created texture writer object.
+@related SUTextureWriterRef
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_NULL_POINTER_OUTPUT if writer is NULL
+*/
+SU_RESULT SUTextureWriterCreate(SUTextureWriterRef* writer);
+
+/**
+@brief  Deallocates a texture writer object.
+@param[in] writer The texture writer object.
+@related SUTextureWriterRef
+@return
+- \ref SU_ERROR_NONE on return
+- \ref SU_ERROR_INVALID_INPUT if writer does not reference a valid object
+- \ref SU_ERROR_NULL_POINTER_OUTPUT if writer is NULL
+*/
+SU_RESULT SUTextureWriterRelease(SUTextureWriterRef* writer);
+
+/**
+@brief  Loads an entity to a texture writer object in order to have its texture
+        written to disk. Acceptable entity types are:
+        \ref SUComponentInstanceRef, \ref SUImageRef, \ref SUGroupRef and
+        \ref SULayerRef.
+@param[in]  writer     The texture writer object.
+@param[in]  entity     The entity object.
+@param[out] texture_id The id of the texture.
+@related SUTextureWriterRef
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if writer or entity is not a valid object
+- \ref SU_ERROR_GENERIC if entity is not one of the acceptable types or there is
+  no texture to write
+- \ref SU_ERROR_NULL_POINTER_OUTPUT if texture_id is NULL
+*/
+SU_RESULT SUTextureWriterLoadEntity(
+    SUTextureWriterRef writer, SUEntityRef entity, long* texture_id);
+
+/**
+@brief  Loads a face object to a texture writer object in order to have its
+        front and/or back texture written to local disk.
+@param[in]  writer           The texture writer object.
+@param[in]  face             The face object.
+@param[out] front_texture_id The texture ID of the front texture.
+@param[out] back_texture_id  The texture ID of the back texture.
+@related SUTextureWriterRef
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if writer or face is not a valid object
+- \ref SU_ERROR_NULL_POINTER_OUTPUT if the face object has a front face texture
+  to write, and front_texture_id is NULL
+- \ref SU_ERROR_NULL_POINTER_OUTPUT if the face object has a back face texture
+  to write, and back_texture_id is NULL
+- \ref SU_ERROR_GENERIC if the face object does not a texture to write
+*/
+SU_RESULT SUTextureWriterLoadFace(
+    SUTextureWriterRef writer, SUFaceRef face, long* front_texture_id, long* back_texture_id);
+
+/**
+@brief  Retrieves the total number of textures that are loaded into the texture
+        writer object.
+@param[in]  writer The texture writer object.
+@param[out] count  The number of textures.
+@related SUTextureWriterRef
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if writer is not a valid object
+- \ref SU_ERROR_NULL_POINTER_OUTPUT if count is NULL
+*/
+SU_RESULT SUTextureWriterGetNumTextures(SUTextureWriterRef writer, size_t* count);
+
+/**
+@brief  Writes a texture to a file on disk.
+@param[in] writer      The texture writer object.
+@param[in] texture_id  The id of the texture.
+@param[in] path        The file location on disk to write the texture. If a file
+                       is present at the location it is overwritten. The file
+                       extension of the file path is indicates the file format.
+                       The extension must be one of "jpg", "bmp", "tif", or
+                       "png". Assumed to be UTF-8 encoded.
+@param[in] reduce_size Indicates whether the texture image should be reduced in
+                       size through scaling.
+@related SUTextureWriterRef
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if writer is not a valid object
+- \ref SU_ERROR_NULL_POINTER_INPUT if path is NULL
+- \ref SU_ERROR_SERIALIZATION if a file could not be written to the specified
+  location, or if an invalid file format was specified
+*/
+SU_RESULT SUTextureWriterWriteTexture(
+    SUTextureWriterRef writer, long texture_id, const char* path, bool reduce_size);
+
+/**
+ @brief  Retrieves an image from the given texture_id. The given image
+         representation object must have been constructed using one of the
+         SUImageRepCreate* functions. It must be released using
+         SUImageRepRelease().
+@since SketchUp 2017 M2, API 5.2
+@param[in] writer      The texture writer object.
+@param[in] texture_id  The id of the texture.
+@param[out] image      The image object retrieved.
+@related SUTextureWriterRef
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if writer is not a valid object
+- \ref SU_ERROR_NULL_POINTER_OUTPUT if image is NULL
+- \ref SU_ERROR_INVALID_OUTPUT if image is not a valid object.
+- \ref SU_ERROR_NO_DATA if there is no texture in the given texture_id.
+*/
+SU_RESULT SUTextureWriterGetImageRep(
+    SUTextureWriterRef writer, long texture_id, SUImageRepRef* image);
+
+/**
+@brief  Writes out all the textures loaded into a texture writer object. The
+        file names and formats are those of the image file used to create the
+        texture.  Preexisting files are overwritten.
+@param[in] writer    The texture writer object.
+@param[in] directory The directory on disk to write the textures. Assumed to be
+                     UTF-8 encoded.
+@related SUTextureWriterRef
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if writer is not a valid object
+- \ref SU_ERROR_NULL_POINTER_INPUT if directory is NULL
+- \ref SU_ERROR_INVALID_INPUT if directory is not a object
+- \ref SU_ERROR_SERIALIZATION if the textures could not be written to disk
+*/
+SU_RESULT SUTextureWriterWriteAllTextures(SUTextureWriterRef writer, const char* directory);
+
+/**
+@brief  Retrieves a flag indicating whether a texture object loaded into a
+        texture writer object is linearly interpolated (affine) or perspective
+        corrected.
+@param[in]  writer     The texture writer object.
+@param[in]  texture_id The id of the texture.
+@param[out] is_affine  The affine flag retrieved.
+@related SUTextureWriterRef
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if writer is not a valid object
+- \ref SU_ERROR_NO_DATA if texture_id is not a handle to a loaded texture object
+- \ref SU_ERROR_NULL_POINTER_OUTPUT if is_affine is NULL
+*/
+SU_RESULT SUTextureWriterIsTextureAffine(
+    SUTextureWriterRef writer, long texture_id, bool* is_affine);
+
+/**
+@brief  Retrieves the file path from a texture image written using \ref
+        SUTextureWriterWriteAllTextures.
+@param[in]  writer     The texture writer object.
+@param[in]  texture_id The id of the texture.
+@param[out] file_path  The file path retrieved.
+@related SUTextureWriterRef
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if writer is not a valid object
+- \ref SU_ERROR_NO_DATA if texture_id is not a handle to a loaded and written
+  texture object
+- \ref SU_ERROR_NULL_POINTER_OUTPUT if file_path is NULL
+- \ref SU_ERROR_INVALID_OUTPUT if file_path does not point to a valid \ref
+  SUStringRef object
+*/
+SU_RESULT SUTextureWriterGetTextureFilePath(
+    SUTextureWriterRef writer, long texture_id, SUStringRef* file_path);
+
+/**
+@brief  Given an array of vertex positions, retrieves the corresponding UV
+        coordinates of the front face texture of a face object that has been
+        loaded into the given texture writer object.
+@param[in]  writer    The texture writer object.
+@param[in]  face      The face object.
+@param[in]  len       The number of vertex positions.
+@param[in]  points    The vertex positions.
+@param[out] uv_coords The UV coordinates retrieved.
+@related SUTextureWriterRef
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if writer or face is not a valid object
+- \ref SU_ERROR_NULL_POINTER_OUTPUT if uv_coords is NULL
+- \ref SU_ERROR_NO_DATA if the face object does not have a front face texture
+*/
+SU_RESULT SUTextureWriterGetFrontFaceUVCoords(
+    SUTextureWriterRef writer, SUFaceRef face, size_t len, const struct SUPoint3D points[],
+    struct SUPoint2D uv_coords[]);
+
+/**
+@brief  Given an array of vertex positions, retrieves the corresponding UV
+        coordinates of the back face texture of a face object that has been
+        loaded into the given texture writer object.
+@param[in]  writer    The texture writer object.
+@param[in]  face      The face object.
+@param[in]  len       The number of vertex positions.
+@param[in]  points    The vertex positions.
+@param[out] uv_coords The UV coordinates retrieved.
+@related SUTextureWriterRef
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if writer or face is not a valid object
+- \ref SU_ERROR_NULL_POINTER_OUTPUT if uv_coords is NULL
+- \ref SU_ERROR_NO_DATA if the face object does not have a back face texture
+*/
+SU_RESULT SUTextureWriterGetBackFaceUVCoords(
+    SUTextureWriterRef writer, SUFaceRef face, size_t len, const struct SUPoint3D points[],
+    struct SUPoint2D uv_coords[]);
+
+/**
+@brief  Gets the texture id of a previously loaded entity. Acceptable entity
+        types are: \ref SUComponentInstanceRef, \ref SUImageRef, \ref SUGroupRef
+        and \ref SULayerRef.
+@param[in]  writer     The texture writer object.
+@param[in]  entity     The entity object.
+@param[out] texture_id The texture id retrieved.
+@related SUTextureWriterRef
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if writer or entity is not a valid object
+- \ref SU_ERROR_NULL_POINTER_OUTPUT if texture_id is NULL
+- \ref SU_ERROR_GENERIC if the entity is not one of the acceptable types or it
+  does not have a previously written texture_id
+*/
+SU_RESULT SUTextureWriterGetTextureIdForEntity(
+    SUTextureWriterRef writer, SUEntityRef entity, long* texture_id);
+
+/**
+@brief  Gets the texture id of a previously loaded face.
+@param[in]  writer The texture writer object.
+@param[in]  face   The face object.
+@param[in]  front  The side of the face we are interested in.  True if we want
+                   texture for the front face, false if we want the texture for
+                   the back face.
+@param[out] texture_id The texture id retrieved.
+@related SUTextureWriterRef
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if writer or face is not a valid object
+- \ref SU_ERROR_NULL_POINTER_OUTPUT if the face object has a texture, and
+  texture_id is NULL
+- \ref SU_ERROR_GENERIC if the face object does not have a previously written
+  texture_id
+*/
+SU_RESULT SUTextureWriterGetTextureIdForFace(
+    SUTextureWriterRef writer, SUFaceRef face, bool front, long* texture_id);
+
+#ifdef __cplusplus
+}  // #ifdef __cplusplus
+#endif
+
+#endif  // SKETCHUP_MODEL_TEXTURE_WRITER_H_