scriptup 2024.0.4 → 2024.0.6

data/sketchup-sdk-win/headers/LayOutAPI/model/page.h

@@ -0,0 +1,261 @@
+// Copyright 2015 Trimble Navigation Ltd. All rights reserved.
+// This file is intended for public distribution.
+
+#ifndef LAYOUT_MODEL_PAGE_H_
+#define LAYOUT_MODEL_PAGE_H_
+
+#include <LayOutAPI/common.h>
+#include <LayOutAPI/model/defs.h>
+
+/**
+@enum LOPageEntityIteratorFlags
+@brief Defines the options that are available when creating a \ref
+       LOEntityIteratorRef for iterating the entities on a page.
+*/
+typedef enum {
+  LOPageEntityIteratorFlags_None = 0x0,  ///< Default iterator behavior. Does not skip any entities.
+  LOPageEntityIteratorFlags_SkipHidden = 0x1,         ///< Skip entities on hidden layers
+  LOPageEntityIteratorFlags_SkipLocked = 0x2,         ///< Skip entities on locked layers
+  LOPageEntityIteratorFlags_SkipHiddenOrLocked = 0x3  ///< Skip entities on hidden or locked layers
+} LOPageEntityIteratorFlags;
+
+/**
+@struct LOPageRef
+@brief References a single page in a document.
+*/
+
+#ifdef __cplusplus
+extern "C" {
+#endif  // __cplusplus
+
+/**
+@brief Gets the name of a page.
+@param[in]  page The page object.
+@param[out] name The name of the page.
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if page does not refer to a valid object
+- \ref SU_ERROR_NULL_POINTER_OUTPUT if name is NULL
+- \ref SU_ERROR_INVALID_OUTPUT if name does not refer to a valid object
+*/
+LO_RESULT LOPageGetName(LOPageRef page, SUStringRef* name);
+
+/**
+@brief Sets the name of a page.
+@param[in] page The page object.
+@param[in] name The new name of the page.
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if page does not refer to a valid object
+- \ref SU_ERROR_NULL_POINTER_INPUT if name is NULL
+- \ref SU_ERROR_UNSUPPORTED if name is an empty string
+*/
+LO_RESULT LOPageSetName(LOPageRef page, const char* name);
+
+/**
+@brief Gets whether or not a page is included in presentations.
+@param[in]  page            The page object.
+@param[out] in_presentation Whether the page will be in a presentation.
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if page does not refer to a valid object
+- \ref SU_ERROR_NULL_POINTER_OUTPUT if in_presentation is NULL
+*/
+LO_RESULT LOPageGetInPresentation(LOPageRef page, bool* in_presentation);
+
+/**
+@brief Sets whether or not a page is included in presentations.
+@param[in] page            The page object.
+@param[in] in_presentation Whether the page should be in a presentation.
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if page does not refer to a valid object
+*/
+LO_RESULT LOPageSetInPresentation(LOPageRef page, bool in_presentation);
+
+/**
+@brief Gets whether or not a layer is visible on a page. Layers in LayOut exist
+       on every page in a document. Each page specifies the visibility of each
+       layer for that page.
+@param[in]  page             The page object.
+@param[in]  layer_definition The layer definition object.
+@param[out] visible          Whether or not the layer is visible.
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if page does not refer to a valid object
+- \ref SU_ERROR_INVALID_INPUT if layer_definition does not refer to a valid
+  object
+- \ref SU_ERROR_NULL_POINTER_OUTPUT if visible is NULL
+- \ref SU_ERROR_GENERIC if page and layer_definition don't belong to the same
+  document
+*/
+LO_RESULT LOPageGetLayerVisible(LOPageRef page, LOLayerRef layer_definition, bool* visible);
+
+/**
+@brief Sets whether or not a layer is visible on a page. Layers in LayOut
+       exist on every page in a document. Each page specifies the visibility of
+       each layer for that page.
+@param[in] page             The page object.
+@param[in] layer_definition The layer definition object.
+@param[in] visible          Whether or not the layer should be visible.
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if page does not refer to a valid object
+- \ref SU_ERROR_INVALID_INPUT if layer_definition does not refer to a valid
+  object
+- \ref SU_ERROR_GENERIC if page and layer_definition don't belong to the same
+  document
+- \ref SU_ERROR_GENERIC if the layer could not be hidden because it would
+  break the rule that there must be at least one unlocked, visible layer on
+  each page
+*/
+LO_RESULT LOPageSetLayerVisible(LOPageRef page, LOLayerRef layer_definition, bool visible);
+
+/**
+@brief Gets references to all the layer instances for a page. The layer
+       instances are in the same order that the layer definitions exist in the
+       document. Use \ref LODocumentGetNumberOfLayers to determine how many
+       layer instances will be returned by this function.
+@param[in]  page            The page object.
+@param[in]  array_size      The size of the array to copy into.
+@param[out] layer_instances The layer instances.
+@param[out] number_copied   The number of layer instances copied.
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if page does not refer to a valid object
+- \ref SU_ERROR_NULL_POINTER_OUTPUT if layer_instances is NULL
+- \ref SU_ERROR_OVERWRITE_VALID if one or more of the objects in the
+  layer_instances array are not a valid object
+- \ref SU_ERROR_NULL_POINTER_OUTPUT if number_copied is NULL
+*/
+LO_RESULT LOPageGetLayerInstances(
+    LOPageRef page, size_t array_size, LOLayerInstanceRef layer_instances[], size_t* number_copied);
+
+/**
+@brief Gets a reference to the layer instance at the given index for this
+       page. The layer instances are in the same order that the layer
+       definitions exist in the document. Use \ref LODocumentGetNumberOfLayers
+       to determine how many layer definitions exist in the document.
+@param[in]  page           The page object.
+@param[in]  index          The index of the layer instance to get.
+@param[out] layer_instance The layer instance object.
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if page does not refer to a valid object
+- \ref SU_ERROR_OUT_OF_RANGE if index is out of range
+- \ref SU_ERROR_NULL_POINTER_OUTPUT if layer_instance is NULL
+- \ref SU_ERROR_OVERWRITE_VALID if *layer_instance already refers to a valid object
+*/
+LO_RESULT LOPageGetLayerInstanceAtIndex(
+    LOPageRef page, size_t index, LOLayerInstanceRef* layer_instance);
+
+/**
+@brief Gets the index of this page in the document.
+@param[in]  page  The page object.
+@param[out] index The index of the page in the document.
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if page does not refer to a valid object
+- \ref SU_ERROR_NULL_POINTER_OUTPUT if index is NULL
+- \ref SU_ERROR_GENERIC if page doesn't belong to a document
+*/
+LO_RESULT LOPageGetPageIndex(LOPageRef page, size_t* index);
+
+/**
+@brief Gets the number of entities at the top of the group hierarchy, on
+       non-shared layers for the given page. This count will include
+       \ref LOGroupRef entities so the group hierarchy can be traversed.
+@param[in]  page                   The page object.
+@param[out] num_nonshared_entities The number of non-shared entities.
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if page does not refer to a valid object
+- \ref SU_ERROR_NULL_POINTER_OUTPUT if num_nonshared_entities is NULL
+*/
+LO_RESULT LOPageGetNumberOfNonSharedEntities(LOPageRef page, size_t* num_nonshared_entities);
+
+/**
+@brief Gets the non-shared entity at the top of the group hierarchy at the
+       specified index for the given page.
+@param[in]  page   The page object.
+@param[in]  index  The 0-based entity index for the desired non-shared entity.
+@param[out] entity The entity object.
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if page does not refer to a valid object
+- \ref SU_ERROR_NULL_POINTER_OUTPUT if entity is NULL
+- \ref SU_ERROR_OVERWRITE_VALID if *entity already refers to a valid object
+- \ref SU_ERROR_OUT_OF_RANGE if index is greater than or equal to the number of
+  non-shared entities returned by LOPageGetNumberOfNonSharedEntities
+*/
+LO_RESULT LOPageGetNonSharedEntityAtIndex(LOPageRef page, size_t index, LOEntityRef* entity);
+
+/**
+@brief Populates a \ref LOEntityListRef with the entities at the top of the
+       group hierarchy, on non-shared layers for the given page. This will
+       include \ref LOGroupRef entities so the group hierarchy can be
+       traversed.
+@param[in]  page        The page object.
+@param[out] entity_list The entity list to populate.
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if page does not refer to a valid object
+- \ref SU_ERROR_INVALID_OUTPUT if entity_list does not refer to a valid object
+*/
+LO_RESULT LOPageGetNonSharedEntities(LOPageRef page, LOEntityListRef entity_list);
+
+/**
+@brief Creates a new entity iterator for the given page. See \ref
+       LOPageEntityIteratorFlags for valid options for flags. This iterator
+       will visit all entities on the page in exactly the same order they are
+       drawn, including entities on shared layers. Entity group hierarchy is
+       ignored with this iterator, so groups are skipped. This is the
+       recommended method for entity iteration when drawing or exporting.
+@param[in]  page               The page object.
+@param[in]  flags              Flags indicating what entities to include.
+@param[out] entity_iterator    The entity iterator object.
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if page does not refer to a valid object
+- \ref SU_ERROR_NULL_POINTER_OUTPUT if entity_iterator is NULL
+- \ref SU_ERROR_OVERWRITE_VALID if *entity_iterator already refers to a valid object
+*/
+LO_RESULT LOPageCreateEntityIterator(
+    LOPageRef page, LOPageEntityIteratorFlags flags, LOEntityIteratorRef* entity_iterator);
+
+/**
+@brief Creates a new reverse entity iterator for the given page. See \ref
+       LOPageEntityIteratorFlags for valid options for flags. This iterator
+       will visit all entities on the page in the reverse order they are drawn,
+       including entities on shared layers. Entity group hierarchy is ignored
+       with this iterator, so groups are skipped. This is the recommended
+       method for entity iteration when picking.
+@param[in]  page               The page object.
+@param[in]  flags              Flags indicating what entities to include.
+@param[out] entity_iterator    The entity iterator object.
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if page does not refer to a valid object
+- \ref SU_ERROR_NULL_POINTER_OUTPUT if entity_iterator is NULL
+- \ref SU_ERROR_OVERWRITE_VALID if *entity_iterator already refers to a valid object
+*/
+LO_RESULT LOPageCreateReverseEntityIterator(
+    LOPageRef page, LOPageEntityIteratorFlags flags, LOEntityIteratorRef* entity_iterator);
+
+/**
+@brief Returns the document that this page belongs to.
+@since LayOut 2018, API 3.0
+@param[in]  page     The page object.
+@param[out] document The document object.
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if page does not refer to a valid object
+- \ref SU_ERROR_NULL_POINTER_OUTPUT if document is NULL
+*/
+LO_RESULT LOPageGetDocument(LOPageRef page, LODocumentRef* document);
+
+#ifdef __cplusplus
+}  // end extern "C"
+#endif  // __cplusplus
+
+#endif  // LAYOUT_MODEL_PAGE_H_

data/sketchup-sdk-win/headers/LayOutAPI/model/pageinfo.h

@@ -0,0 +1,372 @@
+// Copyright 2015-2023 Trimble Inc. All rights reserved.
+// This file is intended for public distribution.
+
+#ifndef LAYOUT_MODEL_PAGEINFO_H_
+#define LAYOUT_MODEL_PAGEINFO_H_
+
+#include <LayOutAPI/common.h>
+#include <LayOutAPI/model/defs.h>
+#include <SketchUpAPI/color.h>
+
+/**
+@struct LOPageInfoRef
+@brief References the page information for a document. This specifies the
+       physical page dimensions and other page-related settings for a document.
+*/
+
+/**
+@enum LOImageResolution
+@brief Defines the different settings available for image resolution.
+*/
+typedef enum {
+  LOImageResolution_Low = 0,  ///< Low resolution, high efficiency.
+  LOImageResolution_Medium,   ///< Medium resolution, medium efficiency.
+  LOImageResolution_High,     ///< High resolution, low efficiency.
+  LONumImageResolutions
+} LOImageResolution;
+
+#ifdef __cplusplus
+extern "C" {
+#endif  // __cplusplus
+
+/**
+@brief Gets the page width.
+@param[in]  pageinfo  The page info object.
+@param[out] width     The page width.
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if \p pageinfo does not refer to a valid object
+- \ref SU_ERROR_NULL_POINTER_OUTPUT if \p width is NULL
+*/
+LO_RESULT LOPageInfoGetWidth(LOPageInfoRef pageinfo, double* width);
+
+/**
+@brief Sets the page width.
+@param[in] pageinfo The page info object.
+@param[in] width    The new page width to use.
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if \p pageinfo does not refer to a valid object
+- \ref SU_ERROR_OUT_OF_RANGE if \p width is less than 1 or greater than 200
+*/
+LO_RESULT LOPageInfoSetWidth(LOPageInfoRef pageinfo, double width);
+
+/**
+@brief Gets the page height.
+@param[in]  pageinfo   The page info object.
+@param[out] height     The page height.
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if \p pageinfo does not refer to a valid object
+- \ref SU_ERROR_NULL_POINTER_OUTPUT if \p height is NULL
+*/
+LO_RESULT LOPageInfoGetHeight(LOPageInfoRef pageinfo, double* height);
+
+/**
+@brief Sets the page height.
+@param[in] pageinfo The page info object.
+@param[in] height   The new page height to use.
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if \p pageinfo does not refer to a valid object
+- \ref SU_ERROR_OUT_OF_RANGE if \p height is less than 1 or greater than 200
+*/
+LO_RESULT LOPageInfoSetHeight(LOPageInfoRef pageinfo, double height);
+
+/**
+@brief Gets the left page margin.
+@param[in]  pageinfo   The page info object.
+@param[out] margin     The left page margin.
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if \p pageinfo does not refer to a valid object
+- \ref SU_ERROR_NULL_POINTER_OUTPUT if \p margin is NULL
+*/
+LO_RESULT LOPageInfoGetLeftMargin(LOPageInfoRef pageinfo, double* margin);
+
+/**
+@brief Gets the right page margin.
+@param[in]  pageinfo   The page info object.
+@param[out] margin     The right page margin.
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if \p pageinfo does not refer to a valid object
+- \ref SU_ERROR_NULL_POINTER_OUTPUT if \p margin is NULL
+*/
+LO_RESULT LOPageInfoGetRightMargin(LOPageInfoRef pageinfo, double* margin);
+
+/**
+@brief Gets the top page margin.
+@param[in]  pageinfo   The page info object.
+@param[out] margin     The top page margin.
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if \p pageinfo does not refer to a valid object
+- \ref SU_ERROR_NULL_POINTER_OUTPUT if \p margin is NULL
+*/
+LO_RESULT LOPageInfoGetTopMargin(LOPageInfoRef pageinfo, double* margin);
+
+/**
+@brief Gets the bottom page margin.
+@param[in]  pageinfo   The page info object.
+@param[out] margin     The bottom page margin.
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if \p pageinfo does not refer to a valid object
+- \ref SU_ERROR_NULL_POINTER_OUTPUT if \p margin is NULL
+*/
+LO_RESULT LOPageInfoGetBottomMargin(LOPageInfoRef pageinfo, double* margin);
+
+/**
+@brief Sets the left page margin.
+@param[in] pageinfo The page info object.
+@param[in] margin   The new left margin to use.
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if \p pageinfo does not refer to a valid object
+- \ref SU_ERROR_OUT_OF_RANGE if \p margin is less than 0 or greater than the page
+  width
+*/
+LO_RESULT LOPageInfoSetLeftMargin(LOPageInfoRef pageinfo, double margin);
+
+/**
+@brief Sets the right page margin.
+@param[in] pageinfo The page info object.
+@param[in] margin   The new right margin to use.
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if \p pageinfo does not refer to a valid object
+- \ref SU_ERROR_OUT_OF_RANGE if \p margin is less than 0 or greater than the page
+  width
+*/
+LO_RESULT LOPageInfoSetRightMargin(LOPageInfoRef pageinfo, double margin);
+
+/**
+@brief Sets the top page margin.
+@param[in] pageinfo The page info object.
+@param[in] margin   The new top margin to use.
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if \p pageinfo does not refer to a valid object
+- \ref SU_ERROR_OUT_OF_RANGE if \p margin is less than 0 or greater than the page
+  height
+*/
+LO_RESULT LOPageInfoSetTopMargin(LOPageInfoRef pageinfo, double margin);
+
+/**
+@brief Sets the bottom page margin.
+@param[in] pageinfo The page info object.
+@param[in] margin   The new bottom margin to use.
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if \p pageinfo does not refer to a valid object
+- \ref SU_ERROR_OUT_OF_RANGE if \p margin is less than 0 or greater than the page
+  height
+*/
+LO_RESULT LOPageInfoSetBottomMargin(LOPageInfoRef pageinfo, double margin);
+
+/**
+@brief Gets the page color.
+@param[in]  pageinfo  The page info object.
+@param[out] color     The page color.
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if \p pageinfo does not refer to a valid object
+- \ref SU_ERROR_NULL_POINTER_OUTPUT if \p color is NULL
+*/
+LO_RESULT LOPageInfoGetPaperColor(LOPageInfoRef pageinfo, SUColor* color);
+
+/**
+@brief Sets the page color.
+@param[in] pageinfo The page info object.
+@param[in] color    The new page color.
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if \p pageinfo does not refer to a valid object
+- \ref SU_ERROR_NULL_POINTER_INPUT if \p color is NULL
+*/
+LO_RESULT LOPageInfoSetPaperColor(LOPageInfoRef pageinfo, const SUColor* color);
+
+/**
+@brief Gets whether or not the page color should be printed.
+@param[in]  pageinfo          The page info object.
+@param[out] print_paper_color Whether or not the page color should be printed.
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if \p pageinfo does not refer to a valid object
+- \ref SU_ERROR_NULL_POINTER_OUTPUT if \p print_paper_color is NULL
+*/
+LO_RESULT LOPageInfoGetPrintPaperColor(LOPageInfoRef pageinfo, bool* print_paper_color);
+
+/**
+@brief Sets whether or not the page color should be printed.
+@param[in] pageinfo          The page info object.
+@param[in] print_paper_color Whether or not the page color should be printed.
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if \p pageinfo does not refer to a valid object
+*/
+LO_RESULT LOPageInfoSetPrintPaperColor(LOPageInfoRef pageinfo, bool print_paper_color);
+
+/**
+@brief Gets the color of the margins.
+@param[in]  pageinfo The page info object.
+@param[out] color    The margin color.
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if \p pageinfo does not refer to a valid object
+- \ref SU_ERROR_NULL_POINTER_OUTPUT if \p color is NULL
+*/
+LO_RESULT LOPageInfoGetMarginColor(LOPageInfoRef pageinfo, SUColor* color);
+
+/**
+@brief Sets the color of the margins.
+@param[in] pageinfo The page info object.
+@param[in] color    The new margin color to use.
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if \p pageinfo does not refer to a valid object
+*/
+LO_RESULT LOPageInfoSetMarginColor(LOPageInfoRef pageinfo, SUColor color);
+
+/**
+@brief Gets whether or not the margins are shown.
+@param[in]  pageinfo     The page info object.
+@param[out] show_margins Whether the margins are shown or not.
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if \p pageinfo does not refer to a valid object
+- \ref SU_ERROR_NULL_POINTER_OUTPUT if \p show_margins is NULL
+*/
+LO_RESULT LOPageInfoGetShowMargins(LOPageInfoRef pageinfo, bool* show_margins);
+
+/**
+@brief Sets whether or not the margins are shown.
+@param[in] pageinfo     The page info object.
+@param[in] show_margins Whether the margins should be shown or not.
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if \p pageinfo does not refer to a valid object
+*/
+LO_RESULT LOPageInfoSetShowMargins(LOPageInfoRef pageinfo, bool show_margins);
+
+/**
+@brief Gets whether or not the margins should be printed.
+@param[in]  pageinfo      The page info object.
+@param[out] print_margins Whether the margins are printed or not.
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if \p pageinfo does not refer to a valid object
+- \ref SU_ERROR_NULL_POINTER_OUTPUT if \p print_margins is NULL
+*/
+LO_RESULT LOPageInfoGetPrintMargins(LOPageInfoRef pageinfo, bool* print_margins);
+
+/**
+@brief Sets whether or not the margins should be printed.
+@param[in] pageinfo      The page info object.
+@param[in] print_margins Whether the margins should be printed or not.
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if \p pageinfo does not refer to a valid object
+*/
+LO_RESULT LOPageInfoSetPrintMargins(LOPageInfoRef pageinfo, bool print_margins);
+
+/**
+@brief Gets the value of the document's display resolution for images and raster
+       models.
+@param[in]  pageinfo   The page info object.
+@param[out] resolution The resolution.
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if \p pageinfo does not refer to a valid object
+- \ref SU_ERROR_NULL_POINTER_OUTPUT if \p resolution is NULL
+*/
+LO_RESULT LOPageInfoGetDisplayResolution(LOPageInfoRef pageinfo, LOImageResolution* resolution);
+
+/**
+@brief Sets the value of the document's display resolution for raster rendered SketchUp models.
+@param[in] pageinfo   The page info object.
+@param[in] resolution The new resolution to use.
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if \p pageinfo does not refer to a valid object
+- \ref SU_ERROR_OUT_OF_RANGE if the value of \p resolution is invalid
+*/
+LO_RESULT LOPageInfoSetDisplayResolution(LOPageInfoRef pageinfo, LOImageResolution resolution);
+
+/**
+@brief Gets the value of the document's output resolution for raster rendered SketchUp models.
+@param[in]  pageinfo   The page info object.
+@param[out] resolution The resolution.
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if \p pageinfo does not refer to a valid object
+- \ref SU_ERROR_NULL_POINTER_OUTPUT if \p resolution is NULL
+*/
+LO_RESULT LOPageInfoGetOutputResolution(LOPageInfoRef pageinfo, LOImageResolution* resolution);
+
+/**
+@brief Sets the value of the document's output resolution for raster rendered SketchUp models.
+@param[in] pageinfo   The page info object.
+@param[in] resolution The new resolution to use.
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if \p pageinfo does not refer to a valid object
+- \ref SU_ERROR_OUT_OF_RANGE if the value of \p resolution is invalid
+*/
+LO_RESULT LOPageInfoSetOutputResolution(LOPageInfoRef pageinfo, LOImageResolution resolution);
+
+/**
+@brief Gets the value of the document's display resolution for images.
+@since LayOut 2023.1, API 8.1
+@param[in]  pageinfo   The page info object.
+@param[out] resolution The resolution.
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if \p pageinfo does not refer to a valid object
+- \ref SU_ERROR_NULL_POINTER_OUTPUT if \p resolution is NULL
+*/
+LO_RESULT LOPageInfoGetImageDisplayResolution(
+    LOPageInfoRef pageinfo, LOImageResolution* resolution);
+
+/**
+@brief Sets the value of the document's display resolution for images.
+@since LayOut 2023.1, API 8.1
+@param[in] pageinfo   The page info object.
+@param[in] resolution The new resolution to use.
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if \p pageinfo does not refer to a valid object
+- \ref SU_ERROR_OUT_OF_RANGE if the value of \p resolution is invalid
+*/
+LO_RESULT LOPageInfoSetImageDisplayResolution(LOPageInfoRef pageinfo, LOImageResolution resolution);
+
+/**
+@brief Gets the value of the document's output resolution for images.
+@since LayOut 2023.1, API 8.1
+@param[in]  pageinfo   The page info object.
+@param[out] resolution The resolution.
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if \p pageinfo does not refer to a valid object
+- \ref SU_ERROR_NULL_POINTER_OUTPUT if \p resolution is NULL
+*/
+LO_RESULT LOPageInfoGetImageOutputResolution(LOPageInfoRef pageinfo, LOImageResolution* resolution);
+
+/**
+@brief Sets the value of the document's output resolution for images.
+@since LayOut 2023.1, API 8.1
+@param[in] pageinfo   The page info object.
+@param[in] resolution The new resolution to use.
+@return
+- \ref SU_ERROR_NONE on success
+- \ref SU_ERROR_INVALID_INPUT if \p pageinfo does not refer to a valid object
+- \ref SU_ERROR_OUT_OF_RANGE if the value of \p resolution is invalid
+*/
+LO_RESULT LOPageInfoSetImageOutputResolution(LOPageInfoRef pageinfo, LOImageResolution resolution);
+
+#ifdef __cplusplus
+}
+#endif  // __cplusplus
+
+#endif  // LAYOUT_MODEL_PAGEINFO_H_