From 44140a28337ddeb1cca08f952255ab06512c03b7 Mon Sep 17 00:00:00 2001 From: Rekha M Date: Fri, 9 Jan 2026 16:44:25 +0530 Subject: [PATCH 1/2] update docs --- .../document-apis/classes/ComplexShapeNode.md | 128 ---------------- .../document-apis/classes/EllipseNode.md | 128 ---------------- .../document-apis/classes/FillableNode.md | 128 ---------------- .../document-apis/classes/GridCellNode.md | 128 ---------------- .../document-apis/classes/GridLayoutNode.md | 128 ---------------- .../document-apis/classes/GroupNode.md | 128 ---------------- .../classes/ImageRectangleNode.md | 144 ++---------------- .../document-apis/classes/LineNode.md | 128 ---------------- .../classes/MediaContainerNode.md | 128 ---------------- .../classes/MediaRectangleNode.md | 128 ---------------- .../document-apis/classes/Node.md | 112 -------------- .../document-apis/classes/PathNode.md | 128 ---------------- .../document-apis/classes/RectangleNode.md | 128 ---------------- .../classes/SolidColorShapeNode.md | 128 ---------------- .../classes/StandaloneTextNode.md | 128 ---------------- .../document-apis/classes/StrokableNode.md | 128 ---------------- .../document-apis/classes/StrokeShapeNode.md | 128 ---------------- .../document-apis/classes/TextNode.md | 128 ---------------- .../document-apis/classes/ThreadedTextNode.md | 128 ---------------- .../classes/UnknownMediaRectangleNode.md | 128 ---------------- .../document-apis/classes/UnknownNode.md | 128 ---------------- 21 files changed, 16 insertions(+), 2672 deletions(-) diff --git a/src/pages/references/document-sandbox/document-apis/classes/ComplexShapeNode.md b/src/pages/references/document-sandbox/document-apis/classes/ComplexShapeNode.md index 2f7f9aa2b..21e1fb6c1 100644 --- a/src/pages/references/document-sandbox/document-apis/classes/ComplexShapeNode.md +++ b/src/pages/references/document-sandbox/document-apis/classes/ComplexShapeNode.md @@ -397,134 +397,6 @@ removal. No-op if node is already an orphan. --- -### rescaleProportionalToHeight() - -• **rescaleProportionalToHeight**(`height`): `void` - - - -**IMPORTANT:** This is currently ***experimental only*** and should not be used in any add-ons you will be distributing until it has been declared stable. To use it, you will first need to set the `experimentalApis` flag to `true` in the [`requirements`](../../../manifest/index.md#requirements) section of the `manifest.json`. - -Changes the height to the given value by visually *scaling* the entire content larger or smaller on both axes to -preserve its existing aspect ratio. See [rescaleProportionalToWidth](Node.md#rescaleproportionaltowidth) documentation for additional explanation. - -#### Parameters - -• **height**: `number` - -#### Returns - -`void` - -#### Inherited from - -[`FillableNode`](FillableNode.md).[`rescaleProportionalToHeight`](FillableNode.md#rescaleproportionaltoheight) - ---- - -### rescaleProportionalToWidth() - -• **rescaleProportionalToWidth**(`width`): `void` - - - -**IMPORTANT:** This is currently ***experimental only*** and should not be used in any add-ons you will be distributing until it has been declared stable. To use it, you will first need to set the `experimentalApis` flag to `true` in the [`requirements`](../../../manifest/index.md#requirements) section of the `manifest.json`. - -Changes the width to the given value by visually *scaling* the entire content larger or smaller on both axes to -preserve its existing aspect ratio, keeping its top-left corner ([topLeftLocal](VisualNode.md#topleftlocal)) at a fixed location. - -Scaling changes the size of visual styling elements such as stroke width, corner detailing, and font size. -Contrast this to *resizing* operations (such as [resizeToFitWithin](Node.md#resizetofitwithin)), which adjust the bounding box of an -element while trying to preserve the existing size of visual detailing such as strokes, corners, and fonts. - -Rescaling becomes baked into the updated values of fields such as stroke weight, rectangle width, etc. (it is not -a separate, persistent scale factor multiplier). - -#### Parameters - -• **width**: `number` - -#### Returns - -`void` - -#### Inherited from - -[`FillableNode`](FillableNode.md).[`rescaleProportionalToWidth`](FillableNode.md#rescaleproportionaltowidth) - ---- - -### resizeToCover() - -• **resizeToCover**(`width`, `height`): `void` - - - -**IMPORTANT:** This is currently ***experimental only*** and should not be used in any add-ons you will be distributing until it has been declared stable. To use it, you will first need to set the `experimentalApis` flag to `true` in the [`requirements`](../../../manifest/index.md#requirements) section of the `manifest.json`. - -Resizes the node to completely *cover* a box of the given dimensions, keeping its top-left corner ([topLeftLocal](VisualNode.md#topleftlocal)) -at a fixed location. Nodes with a fixed aspect ratio may extend outside the box on one axis as a result, but -nodes with flexible aspect ratio will be resized to the exact box size specified. See [resizeToFitWithin](Node.md#resizetofitwithin) -documentation for additional explanation. - -#### Parameters - -• **width**: `number` - -• **height**: `number` - -#### Returns - -`void` - -#### Inherited from - -[`FillableNode`](FillableNode.md).[`resizeToCover`](FillableNode.md#resizetocover) - -#### See - -resizeToFitWithin - ---- - -### resizeToFitWithin() - -• **resizeToFitWithin**(`width`, `height`): `void` - - - -**IMPORTANT:** This is currently ***experimental only*** and should not be used in any add-ons you will be distributing until it has been declared stable. To use it, you will first need to set the `experimentalApis` flag to `true` in the [`requirements`](../../../manifest/index.md#requirements) section of the `manifest.json`. - -Resizes the node to fit entirely *within* a box of the given dimensions, keeping its top-left corner ([topLeftLocal](VisualNode.md#topleftlocal)) -at a fixed location. Nodes with a fixed aspect ratio may leave unused space on one axis as a result, but nodes -with flexible aspect ratio will be resized to the exact box size specified. - -Resizing attempts to preserve the existing size of visual styling elements such as stroke width, corner detailing, -and font size as much as possible. Contrast with *rescaling* (such as [rescaleProportionalToWidth](Node.md#rescaleproportionaltowidth)), which -always changes the size of visual detailing in exact proportion to the change in overall bounding box size. This -API may still produce *some* degree of rescaling if necessary for certain shapes with fixed corner/edge detailing -to fit the box better. - -#### Parameters - -• **width**: `number` - -• **height**: `number` - -#### Returns - -`void` - -#### Inherited from - -[`FillableNode`](FillableNode.md).[`resizeToFitWithin`](FillableNode.md#resizetofitwithin) - -#### See - -resizeToCover - ---- - ### setPositionInParent() • **setPositionInParent**(`parentPoint`, `localRegistrationPoint`): `void` diff --git a/src/pages/references/document-sandbox/document-apis/classes/EllipseNode.md b/src/pages/references/document-sandbox/document-apis/classes/EllipseNode.md index a0af62aa2..437e075a2 100644 --- a/src/pages/references/document-sandbox/document-apis/classes/EllipseNode.md +++ b/src/pages/references/document-sandbox/document-apis/classes/EllipseNode.md @@ -440,134 +440,6 @@ removal. No-op if node is already an orphan. --- -### rescaleProportionalToHeight() - -• **rescaleProportionalToHeight**(`height`): `void` - - - -**IMPORTANT:** This is currently ***experimental only*** and should not be used in any add-ons you will be distributing until it has been declared stable. To use it, you will first need to set the `experimentalApis` flag to `true` in the [`requirements`](../../../manifest/index.md#requirements) section of the `manifest.json`. - -Changes the height to the given value by visually *scaling* the entire content larger or smaller on both axes to -preserve its existing aspect ratio. See [rescaleProportionalToWidth](Node.md#rescaleproportionaltowidth) documentation for additional explanation. - -#### Parameters - -• **height**: `number` - -#### Returns - -`void` - -#### Inherited from - -[`FillableNode`](FillableNode.md).[`rescaleProportionalToHeight`](FillableNode.md#rescaleproportionaltoheight) - ---- - -### rescaleProportionalToWidth() - -• **rescaleProportionalToWidth**(`width`): `void` - - - -**IMPORTANT:** This is currently ***experimental only*** and should not be used in any add-ons you will be distributing until it has been declared stable. To use it, you will first need to set the `experimentalApis` flag to `true` in the [`requirements`](../../../manifest/index.md#requirements) section of the `manifest.json`. - -Changes the width to the given value by visually *scaling* the entire content larger or smaller on both axes to -preserve its existing aspect ratio, keeping its top-left corner ([topLeftLocal](VisualNode.md#topleftlocal)) at a fixed location. - -Scaling changes the size of visual styling elements such as stroke width, corner detailing, and font size. -Contrast this to *resizing* operations (such as [resizeToFitWithin](Node.md#resizetofitwithin)), which adjust the bounding box of an -element while trying to preserve the existing size of visual detailing such as strokes, corners, and fonts. - -Rescaling becomes baked into the updated values of fields such as stroke weight, rectangle width, etc. (it is not -a separate, persistent scale factor multiplier). - -#### Parameters - -• **width**: `number` - -#### Returns - -`void` - -#### Inherited from - -[`FillableNode`](FillableNode.md).[`rescaleProportionalToWidth`](FillableNode.md#rescaleproportionaltowidth) - ---- - -### resizeToCover() - -• **resizeToCover**(`width`, `height`): `void` - - - -**IMPORTANT:** This is currently ***experimental only*** and should not be used in any add-ons you will be distributing until it has been declared stable. To use it, you will first need to set the `experimentalApis` flag to `true` in the [`requirements`](../../../manifest/index.md#requirements) section of the `manifest.json`. - -Resizes the node to completely *cover* a box of the given dimensions, keeping its top-left corner ([topLeftLocal](VisualNode.md#topleftlocal)) -at a fixed location. Nodes with a fixed aspect ratio may extend outside the box on one axis as a result, but -nodes with flexible aspect ratio will be resized to the exact box size specified. See [resizeToFitWithin](Node.md#resizetofitwithin) -documentation for additional explanation. - -#### Parameters - -• **width**: `number` - -• **height**: `number` - -#### Returns - -`void` - -#### Inherited from - -[`FillableNode`](FillableNode.md).[`resizeToCover`](FillableNode.md#resizetocover) - -#### See - -resizeToFitWithin - ---- - -### resizeToFitWithin() - -• **resizeToFitWithin**(`width`, `height`): `void` - - - -**IMPORTANT:** This is currently ***experimental only*** and should not be used in any add-ons you will be distributing until it has been declared stable. To use it, you will first need to set the `experimentalApis` flag to `true` in the [`requirements`](../../../manifest/index.md#requirements) section of the `manifest.json`. - -Resizes the node to fit entirely *within* a box of the given dimensions, keeping its top-left corner ([topLeftLocal](VisualNode.md#topleftlocal)) -at a fixed location. Nodes with a fixed aspect ratio may leave unused space on one axis as a result, but nodes -with flexible aspect ratio will be resized to the exact box size specified. - -Resizing attempts to preserve the existing size of visual styling elements such as stroke width, corner detailing, -and font size as much as possible. Contrast with *rescaling* (such as [rescaleProportionalToWidth](Node.md#rescaleproportionaltowidth)), which -always changes the size of visual detailing in exact proportion to the change in overall bounding box size. This -API may still produce *some* degree of rescaling if necessary for certain shapes with fixed corner/edge detailing -to fit the box better. - -#### Parameters - -• **width**: `number` - -• **height**: `number` - -#### Returns - -`void` - -#### Inherited from - -[`FillableNode`](FillableNode.md).[`resizeToFitWithin`](FillableNode.md#resizetofitwithin) - -#### See - -resizeToCover - ---- - ### setPositionInParent() • **setPositionInParent**(`parentPoint`, `localRegistrationPoint`): `void` diff --git a/src/pages/references/document-sandbox/document-apis/classes/FillableNode.md b/src/pages/references/document-sandbox/document-apis/classes/FillableNode.md index 21b8c098d..d0ad7caed 100644 --- a/src/pages/references/document-sandbox/document-apis/classes/FillableNode.md +++ b/src/pages/references/document-sandbox/document-apis/classes/FillableNode.md @@ -407,134 +407,6 @@ removal. No-op if node is already an orphan. --- -### rescaleProportionalToHeight() - -• **rescaleProportionalToHeight**(`height`): `void` - - - -**IMPORTANT:** This is currently ***experimental only*** and should not be used in any add-ons you will be distributing until it has been declared stable. To use it, you will first need to set the `experimentalApis` flag to `true` in the [`requirements`](../../../manifest/index.md#requirements) section of the `manifest.json`. - -Changes the height to the given value by visually *scaling* the entire content larger or smaller on both axes to -preserve its existing aspect ratio. See [rescaleProportionalToWidth](Node.md#rescaleproportionaltowidth) documentation for additional explanation. - -#### Parameters - -• **height**: `number` - -#### Returns - -`void` - -#### Inherited from - -[`StrokableNode`](StrokableNode.md).[`rescaleProportionalToHeight`](StrokableNode.md#rescaleproportionaltoheight) - ---- - -### rescaleProportionalToWidth() - -• **rescaleProportionalToWidth**(`width`): `void` - - - -**IMPORTANT:** This is currently ***experimental only*** and should not be used in any add-ons you will be distributing until it has been declared stable. To use it, you will first need to set the `experimentalApis` flag to `true` in the [`requirements`](../../../manifest/index.md#requirements) section of the `manifest.json`. - -Changes the width to the given value by visually *scaling* the entire content larger or smaller on both axes to -preserve its existing aspect ratio, keeping its top-left corner ([topLeftLocal](VisualNode.md#topleftlocal)) at a fixed location. - -Scaling changes the size of visual styling elements such as stroke width, corner detailing, and font size. -Contrast this to *resizing* operations (such as [resizeToFitWithin](Node.md#resizetofitwithin)), which adjust the bounding box of an -element while trying to preserve the existing size of visual detailing such as strokes, corners, and fonts. - -Rescaling becomes baked into the updated values of fields such as stroke weight, rectangle width, etc. (it is not -a separate, persistent scale factor multiplier). - -#### Parameters - -• **width**: `number` - -#### Returns - -`void` - -#### Inherited from - -[`StrokableNode`](StrokableNode.md).[`rescaleProportionalToWidth`](StrokableNode.md#rescaleproportionaltowidth) - ---- - -### resizeToCover() - -• **resizeToCover**(`width`, `height`): `void` - - - -**IMPORTANT:** This is currently ***experimental only*** and should not be used in any add-ons you will be distributing until it has been declared stable. To use it, you will first need to set the `experimentalApis` flag to `true` in the [`requirements`](../../../manifest/index.md#requirements) section of the `manifest.json`. - -Resizes the node to completely *cover* a box of the given dimensions, keeping its top-left corner ([topLeftLocal](VisualNode.md#topleftlocal)) -at a fixed location. Nodes with a fixed aspect ratio may extend outside the box on one axis as a result, but -nodes with flexible aspect ratio will be resized to the exact box size specified. See [resizeToFitWithin](Node.md#resizetofitwithin) -documentation for additional explanation. - -#### Parameters - -• **width**: `number` - -• **height**: `number` - -#### Returns - -`void` - -#### Inherited from - -[`StrokableNode`](StrokableNode.md).[`resizeToCover`](StrokableNode.md#resizetocover) - -#### See - -resizeToFitWithin - ---- - -### resizeToFitWithin() - -• **resizeToFitWithin**(`width`, `height`): `void` - - - -**IMPORTANT:** This is currently ***experimental only*** and should not be used in any add-ons you will be distributing until it has been declared stable. To use it, you will first need to set the `experimentalApis` flag to `true` in the [`requirements`](../../../manifest/index.md#requirements) section of the `manifest.json`. - -Resizes the node to fit entirely *within* a box of the given dimensions, keeping its top-left corner ([topLeftLocal](VisualNode.md#topleftlocal)) -at a fixed location. Nodes with a fixed aspect ratio may leave unused space on one axis as a result, but nodes -with flexible aspect ratio will be resized to the exact box size specified. - -Resizing attempts to preserve the existing size of visual styling elements such as stroke width, corner detailing, -and font size as much as possible. Contrast with *rescaling* (such as [rescaleProportionalToWidth](Node.md#rescaleproportionaltowidth)), which -always changes the size of visual detailing in exact proportion to the change in overall bounding box size. This -API may still produce *some* degree of rescaling if necessary for certain shapes with fixed corner/edge detailing -to fit the box better. - -#### Parameters - -• **width**: `number` - -• **height**: `number` - -#### Returns - -`void` - -#### Inherited from - -[`StrokableNode`](StrokableNode.md).[`resizeToFitWithin`](StrokableNode.md#resizetofitwithin) - -#### See - -resizeToCover - ---- - ### setPositionInParent() • **setPositionInParent**(`parentPoint`, `localRegistrationPoint`): `void` diff --git a/src/pages/references/document-sandbox/document-apis/classes/GridCellNode.md b/src/pages/references/document-sandbox/document-apis/classes/GridCellNode.md index 34976c6be..3c991faa0 100644 --- a/src/pages/references/document-sandbox/document-apis/classes/GridCellNode.md +++ b/src/pages/references/document-sandbox/document-apis/classes/GridCellNode.md @@ -413,134 +413,6 @@ New content to display. Currently must be a [BitmapImage](BitmapImage.md). --- -### rescaleProportionalToHeight() - -• **rescaleProportionalToHeight**(`height`): `void` - - - -**IMPORTANT:** This is currently ***experimental only*** and should not be used in any add-ons you will be distributing until it has been declared stable. To use it, you will first need to set the `experimentalApis` flag to `true` in the [`requirements`](../../../manifest/index.md#requirements) section of the `manifest.json`. - -Changes the height to the given value by visually *scaling* the entire content larger or smaller on both axes to -preserve its existing aspect ratio. See [rescaleProportionalToWidth](Node.md#rescaleproportionaltowidth) documentation for additional explanation. - -#### Parameters - -• **height**: `number` - -#### Returns - -`void` - -#### Inherited from - -[`Node`](Node.md).[`rescaleProportionalToHeight`](Node.md#rescaleproportionaltoheight) - ---- - -### rescaleProportionalToWidth() - -• **rescaleProportionalToWidth**(`width`): `void` - - - -**IMPORTANT:** This is currently ***experimental only*** and should not be used in any add-ons you will be distributing until it has been declared stable. To use it, you will first need to set the `experimentalApis` flag to `true` in the [`requirements`](../../../manifest/index.md#requirements) section of the `manifest.json`. - -Changes the width to the given value by visually *scaling* the entire content larger or smaller on both axes to -preserve its existing aspect ratio, keeping its top-left corner ([topLeftLocal](VisualNode.md#topleftlocal)) at a fixed location. - -Scaling changes the size of visual styling elements such as stroke width, corner detailing, and font size. -Contrast this to *resizing* operations (such as [resizeToFitWithin](Node.md#resizetofitwithin)), which adjust the bounding box of an -element while trying to preserve the existing size of visual detailing such as strokes, corners, and fonts. - -Rescaling becomes baked into the updated values of fields such as stroke weight, rectangle width, etc. (it is not -a separate, persistent scale factor multiplier). - -#### Parameters - -• **width**: `number` - -#### Returns - -`void` - -#### Inherited from - -[`Node`](Node.md).[`rescaleProportionalToWidth`](Node.md#rescaleproportionaltowidth) - ---- - -### resizeToCover() - -• **resizeToCover**(`width`, `height`): `void` - - - -**IMPORTANT:** This is currently ***experimental only*** and should not be used in any add-ons you will be distributing until it has been declared stable. To use it, you will first need to set the `experimentalApis` flag to `true` in the [`requirements`](../../../manifest/index.md#requirements) section of the `manifest.json`. - -Resizes the node to completely *cover* a box of the given dimensions, keeping its top-left corner ([topLeftLocal](VisualNode.md#topleftlocal)) -at a fixed location. Nodes with a fixed aspect ratio may extend outside the box on one axis as a result, but -nodes with flexible aspect ratio will be resized to the exact box size specified. See [resizeToFitWithin](Node.md#resizetofitwithin) -documentation for additional explanation. - -#### Parameters - -• **width**: `number` - -• **height**: `number` - -#### Returns - -`void` - -#### Inherited from - -[`Node`](Node.md).[`resizeToCover`](Node.md#resizetocover) - -#### See - -resizeToFitWithin - ---- - -### resizeToFitWithin() - -• **resizeToFitWithin**(`width`, `height`): `void` - - - -**IMPORTANT:** This is currently ***experimental only*** and should not be used in any add-ons you will be distributing until it has been declared stable. To use it, you will first need to set the `experimentalApis` flag to `true` in the [`requirements`](../../../manifest/index.md#requirements) section of the `manifest.json`. - -Resizes the node to fit entirely *within* a box of the given dimensions, keeping its top-left corner ([topLeftLocal](VisualNode.md#topleftlocal)) -at a fixed location. Nodes with a fixed aspect ratio may leave unused space on one axis as a result, but nodes -with flexible aspect ratio will be resized to the exact box size specified. - -Resizing attempts to preserve the existing size of visual styling elements such as stroke width, corner detailing, -and font size as much as possible. Contrast with *rescaling* (such as [rescaleProportionalToWidth](Node.md#rescaleproportionaltowidth)), which -always changes the size of visual detailing in exact proportion to the change in overall bounding box size. This -API may still produce *some* degree of rescaling if necessary for certain shapes with fixed corner/edge detailing -to fit the box better. - -#### Parameters - -• **width**: `number` - -• **height**: `number` - -#### Returns - -`void` - -#### Inherited from - -[`Node`](Node.md).[`resizeToFitWithin`](Node.md#resizetofitwithin) - -#### See - -resizeToCover - ---- - ### setPositionInParent() • **setPositionInParent**(`parentPoint`, `localRegistrationPoint`): `void` diff --git a/src/pages/references/document-sandbox/document-apis/classes/GridLayoutNode.md b/src/pages/references/document-sandbox/document-apis/classes/GridLayoutNode.md index 8791e4060..34ab87706 100644 --- a/src/pages/references/document-sandbox/document-apis/classes/GridLayoutNode.md +++ b/src/pages/references/document-sandbox/document-apis/classes/GridLayoutNode.md @@ -417,134 +417,6 @@ removal. No-op if node is already an orphan. --- -### rescaleProportionalToHeight() - -• **rescaleProportionalToHeight**(`height`): `void` - - - -**IMPORTANT:** This is currently ***experimental only*** and should not be used in any add-ons you will be distributing until it has been declared stable. To use it, you will first need to set the `experimentalApis` flag to `true` in the [`requirements`](../../../manifest/index.md#requirements) section of the `manifest.json`. - -Changes the height to the given value by visually *scaling* the entire content larger or smaller on both axes to -preserve its existing aspect ratio. See [rescaleProportionalToWidth](Node.md#rescaleproportionaltowidth) documentation for additional explanation. - -#### Parameters - -• **height**: `number` - -#### Returns - -`void` - -#### Inherited from - -[`Node`](Node.md).[`rescaleProportionalToHeight`](Node.md#rescaleproportionaltoheight) - ---- - -### rescaleProportionalToWidth() - -• **rescaleProportionalToWidth**(`width`): `void` - - - -**IMPORTANT:** This is currently ***experimental only*** and should not be used in any add-ons you will be distributing until it has been declared stable. To use it, you will first need to set the `experimentalApis` flag to `true` in the [`requirements`](../../../manifest/index.md#requirements) section of the `manifest.json`. - -Changes the width to the given value by visually *scaling* the entire content larger or smaller on both axes to -preserve its existing aspect ratio, keeping its top-left corner ([topLeftLocal](VisualNode.md#topleftlocal)) at a fixed location. - -Scaling changes the size of visual styling elements such as stroke width, corner detailing, and font size. -Contrast this to *resizing* operations (such as [resizeToFitWithin](Node.md#resizetofitwithin)), which adjust the bounding box of an -element while trying to preserve the existing size of visual detailing such as strokes, corners, and fonts. - -Rescaling becomes baked into the updated values of fields such as stroke weight, rectangle width, etc. (it is not -a separate, persistent scale factor multiplier). - -#### Parameters - -• **width**: `number` - -#### Returns - -`void` - -#### Inherited from - -[`Node`](Node.md).[`rescaleProportionalToWidth`](Node.md#rescaleproportionaltowidth) - ---- - -### resizeToCover() - -• **resizeToCover**(`width`, `height`): `void` - - - -**IMPORTANT:** This is currently ***experimental only*** and should not be used in any add-ons you will be distributing until it has been declared stable. To use it, you will first need to set the `experimentalApis` flag to `true` in the [`requirements`](../../../manifest/index.md#requirements) section of the `manifest.json`. - -Resizes the node to completely *cover* a box of the given dimensions, keeping its top-left corner ([topLeftLocal](VisualNode.md#topleftlocal)) -at a fixed location. Nodes with a fixed aspect ratio may extend outside the box on one axis as a result, but -nodes with flexible aspect ratio will be resized to the exact box size specified. See [resizeToFitWithin](Node.md#resizetofitwithin) -documentation for additional explanation. - -#### Parameters - -• **width**: `number` - -• **height**: `number` - -#### Returns - -`void` - -#### Inherited from - -[`Node`](Node.md).[`resizeToCover`](Node.md#resizetocover) - -#### See - -resizeToFitWithin - ---- - -### resizeToFitWithin() - -• **resizeToFitWithin**(`width`, `height`): `void` - - - -**IMPORTANT:** This is currently ***experimental only*** and should not be used in any add-ons you will be distributing until it has been declared stable. To use it, you will first need to set the `experimentalApis` flag to `true` in the [`requirements`](../../../manifest/index.md#requirements) section of the `manifest.json`. - -Resizes the node to fit entirely *within* a box of the given dimensions, keeping its top-left corner ([topLeftLocal](VisualNode.md#topleftlocal)) -at a fixed location. Nodes with a fixed aspect ratio may leave unused space on one axis as a result, but nodes -with flexible aspect ratio will be resized to the exact box size specified. - -Resizing attempts to preserve the existing size of visual styling elements such as stroke width, corner detailing, -and font size as much as possible. Contrast with *rescaling* (such as [rescaleProportionalToWidth](Node.md#rescaleproportionaltowidth)), which -always changes the size of visual detailing in exact proportion to the change in overall bounding box size. This -API may still produce *some* degree of rescaling if necessary for certain shapes with fixed corner/edge detailing -to fit the box better. - -#### Parameters - -• **width**: `number` - -• **height**: `number` - -#### Returns - -`void` - -#### Inherited from - -[`Node`](Node.md).[`resizeToFitWithin`](Node.md#resizetofitwithin) - -#### See - -resizeToCover - ---- - ### setPositionInParent() • **setPositionInParent**(`parentPoint`, `localRegistrationPoint`): `void` diff --git a/src/pages/references/document-sandbox/document-apis/classes/GroupNode.md b/src/pages/references/document-sandbox/document-apis/classes/GroupNode.md index 8b51ebd6b..b271e916b 100644 --- a/src/pages/references/document-sandbox/document-apis/classes/GroupNode.md +++ b/src/pages/references/document-sandbox/document-apis/classes/GroupNode.md @@ -419,134 +419,6 @@ removal. No-op if node is already an orphan. --- -### rescaleProportionalToHeight() - -• **rescaleProportionalToHeight**(`height`): `void` - - - -**IMPORTANT:** This is currently ***experimental only*** and should not be used in any add-ons you will be distributing until it has been declared stable. To use it, you will first need to set the `experimentalApis` flag to `true` in the [`requirements`](../../../manifest/index.md#requirements) section of the `manifest.json`. - -Changes the height to the given value by visually *scaling* the entire content larger or smaller on both axes to -preserve its existing aspect ratio. See [rescaleProportionalToWidth](Node.md#rescaleproportionaltowidth) documentation for additional explanation. - -#### Parameters - -• **height**: `number` - -#### Returns - -`void` - -#### Inherited from - -[`Node`](Node.md).[`rescaleProportionalToHeight`](Node.md#rescaleproportionaltoheight) - ---- - -### rescaleProportionalToWidth() - -• **rescaleProportionalToWidth**(`width`): `void` - - - -**IMPORTANT:** This is currently ***experimental only*** and should not be used in any add-ons you will be distributing until it has been declared stable. To use it, you will first need to set the `experimentalApis` flag to `true` in the [`requirements`](../../../manifest/index.md#requirements) section of the `manifest.json`. - -Changes the width to the given value by visually *scaling* the entire content larger or smaller on both axes to -preserve its existing aspect ratio, keeping its top-left corner ([topLeftLocal](VisualNode.md#topleftlocal)) at a fixed location. - -Scaling changes the size of visual styling elements such as stroke width, corner detailing, and font size. -Contrast this to *resizing* operations (such as [resizeToFitWithin](Node.md#resizetofitwithin)), which adjust the bounding box of an -element while trying to preserve the existing size of visual detailing such as strokes, corners, and fonts. - -Rescaling becomes baked into the updated values of fields such as stroke weight, rectangle width, etc. (it is not -a separate, persistent scale factor multiplier). - -#### Parameters - -• **width**: `number` - -#### Returns - -`void` - -#### Inherited from - -[`Node`](Node.md).[`rescaleProportionalToWidth`](Node.md#rescaleproportionaltowidth) - ---- - -### resizeToCover() - -• **resizeToCover**(`width`, `height`): `void` - - - -**IMPORTANT:** This is currently ***experimental only*** and should not be used in any add-ons you will be distributing until it has been declared stable. To use it, you will first need to set the `experimentalApis` flag to `true` in the [`requirements`](../../../manifest/index.md#requirements) section of the `manifest.json`. - -Resizes the node to completely *cover* a box of the given dimensions, keeping its top-left corner ([topLeftLocal](VisualNode.md#topleftlocal)) -at a fixed location. Nodes with a fixed aspect ratio may extend outside the box on one axis as a result, but -nodes with flexible aspect ratio will be resized to the exact box size specified. See [resizeToFitWithin](Node.md#resizetofitwithin) -documentation for additional explanation. - -#### Parameters - -• **width**: `number` - -• **height**: `number` - -#### Returns - -`void` - -#### Inherited from - -[`Node`](Node.md).[`resizeToCover`](Node.md#resizetocover) - -#### See - -resizeToFitWithin - ---- - -### resizeToFitWithin() - -• **resizeToFitWithin**(`width`, `height`): `void` - - - -**IMPORTANT:** This is currently ***experimental only*** and should not be used in any add-ons you will be distributing until it has been declared stable. To use it, you will first need to set the `experimentalApis` flag to `true` in the [`requirements`](../../../manifest/index.md#requirements) section of the `manifest.json`. - -Resizes the node to fit entirely *within* a box of the given dimensions, keeping its top-left corner ([topLeftLocal](VisualNode.md#topleftlocal)) -at a fixed location. Nodes with a fixed aspect ratio may leave unused space on one axis as a result, but nodes -with flexible aspect ratio will be resized to the exact box size specified. - -Resizing attempts to preserve the existing size of visual styling elements such as stroke width, corner detailing, -and font size as much as possible. Contrast with *rescaling* (such as [rescaleProportionalToWidth](Node.md#rescaleproportionaltowidth)), which -always changes the size of visual detailing in exact proportion to the change in overall bounding box size. This -API may still produce *some* degree of rescaling if necessary for certain shapes with fixed corner/edge detailing -to fit the box better. - -#### Parameters - -• **width**: `number` - -• **height**: `number` - -#### Returns - -`void` - -#### Inherited from - -[`Node`](Node.md).[`resizeToFitWithin`](Node.md#resizetofitwithin) - -#### See - -resizeToCover - ---- - ### setPositionInParent() • **setPositionInParent**(`parentPoint`, `localRegistrationPoint`): `void` diff --git a/src/pages/references/document-sandbox/document-apis/classes/ImageRectangleNode.md b/src/pages/references/document-sandbox/document-apis/classes/ImageRectangleNode.md index 3b41bc8e2..36eb86de4 100644 --- a/src/pages/references/document-sandbox/document-apis/classes/ImageRectangleNode.md +++ b/src/pages/references/document-sandbox/document-apis/classes/ImageRectangleNode.md @@ -345,6 +345,22 @@ relative to one another (the target node need not be an ancestor of this node, n --- +### canExportMedia() + +• **canExportMedia**(): `boolean` + + + +**IMPORTANT:** This is currently ***experimental only*** and should not be used in any add-ons you will be distributing until it has been declared stable. To use it, you will first need to set the `experimentalApis` flag to `true` in the [`requirements`](../../../manifest/index.md#requirements) section of the `manifest.json`. + +Returns true if the media can be exported based on the user's entitlements. + +#### Returns + +`boolean` + +--- + ### cloneInPlace() • **cloneInPlace**(): `never` @@ -423,134 +439,6 @@ removal. No-op if node is already an orphan. --- -### rescaleProportionalToHeight() - -• **rescaleProportionalToHeight**(`height`): `void` - - - -**IMPORTANT:** This is currently ***experimental only*** and should not be used in any add-ons you will be distributing until it has been declared stable. To use it, you will first need to set the `experimentalApis` flag to `true` in the [`requirements`](../../../manifest/index.md#requirements) section of the `manifest.json`. - -Changes the height to the given value by visually *scaling* the entire content larger or smaller on both axes to -preserve its existing aspect ratio. See [rescaleProportionalToWidth](Node.md#rescaleproportionaltowidth) documentation for additional explanation. - -#### Parameters - -• **height**: `number` - -#### Returns - -`void` - -#### Inherited from - -[`MediaRectangleNode`](MediaRectangleNode.md).[`rescaleProportionalToHeight`](MediaRectangleNode.md#rescaleproportionaltoheight) - ---- - -### rescaleProportionalToWidth() - -• **rescaleProportionalToWidth**(`width`): `void` - - - -**IMPORTANT:** This is currently ***experimental only*** and should not be used in any add-ons you will be distributing until it has been declared stable. To use it, you will first need to set the `experimentalApis` flag to `true` in the [`requirements`](../../../manifest/index.md#requirements) section of the `manifest.json`. - -Changes the width to the given value by visually *scaling* the entire content larger or smaller on both axes to -preserve its existing aspect ratio, keeping its top-left corner ([topLeftLocal](VisualNode.md#topleftlocal)) at a fixed location. - -Scaling changes the size of visual styling elements such as stroke width, corner detailing, and font size. -Contrast this to *resizing* operations (such as [resizeToFitWithin](Node.md#resizetofitwithin)), which adjust the bounding box of an -element while trying to preserve the existing size of visual detailing such as strokes, corners, and fonts. - -Rescaling becomes baked into the updated values of fields such as stroke weight, rectangle width, etc. (it is not -a separate, persistent scale factor multiplier). - -#### Parameters - -• **width**: `number` - -#### Returns - -`void` - -#### Inherited from - -[`MediaRectangleNode`](MediaRectangleNode.md).[`rescaleProportionalToWidth`](MediaRectangleNode.md#rescaleproportionaltowidth) - ---- - -### resizeToCover() - -• **resizeToCover**(`width`, `height`): `void` - - - -**IMPORTANT:** This is currently ***experimental only*** and should not be used in any add-ons you will be distributing until it has been declared stable. To use it, you will first need to set the `experimentalApis` flag to `true` in the [`requirements`](../../../manifest/index.md#requirements) section of the `manifest.json`. - -Resizes the node to completely *cover* a box of the given dimensions, keeping its top-left corner ([topLeftLocal](VisualNode.md#topleftlocal)) -at a fixed location. Nodes with a fixed aspect ratio may extend outside the box on one axis as a result, but -nodes with flexible aspect ratio will be resized to the exact box size specified. See [resizeToFitWithin](Node.md#resizetofitwithin) -documentation for additional explanation. - -#### Parameters - -• **width**: `number` - -• **height**: `number` - -#### Returns - -`void` - -#### Inherited from - -[`MediaRectangleNode`](MediaRectangleNode.md).[`resizeToCover`](MediaRectangleNode.md#resizetocover) - -#### See - -resizeToFitWithin - ---- - -### resizeToFitWithin() - -• **resizeToFitWithin**(`width`, `height`): `void` - - - -**IMPORTANT:** This is currently ***experimental only*** and should not be used in any add-ons you will be distributing until it has been declared stable. To use it, you will first need to set the `experimentalApis` flag to `true` in the [`requirements`](../../../manifest/index.md#requirements) section of the `manifest.json`. - -Resizes the node to fit entirely *within* a box of the given dimensions, keeping its top-left corner ([topLeftLocal](VisualNode.md#topleftlocal)) -at a fixed location. Nodes with a fixed aspect ratio may leave unused space on one axis as a result, but nodes -with flexible aspect ratio will be resized to the exact box size specified. - -Resizing attempts to preserve the existing size of visual styling elements such as stroke width, corner detailing, -and font size as much as possible. Contrast with *rescaling* (such as [rescaleProportionalToWidth](Node.md#rescaleproportionaltowidth)), which -always changes the size of visual detailing in exact proportion to the change in overall bounding box size. This -API may still produce *some* degree of rescaling if necessary for certain shapes with fixed corner/edge detailing -to fit the box better. - -#### Parameters - -• **width**: `number` - -• **height**: `number` - -#### Returns - -`void` - -#### Inherited from - -[`MediaRectangleNode`](MediaRectangleNode.md).[`resizeToFitWithin`](MediaRectangleNode.md#resizetofitwithin) - -#### See - -resizeToCover - ---- - ### setPositionInParent() • **setPositionInParent**(`parentPoint`, `localRegistrationPoint`): `void` diff --git a/src/pages/references/document-sandbox/document-apis/classes/LineNode.md b/src/pages/references/document-sandbox/document-apis/classes/LineNode.md index 28fc80846..875809226 100644 --- a/src/pages/references/document-sandbox/document-apis/classes/LineNode.md +++ b/src/pages/references/document-sandbox/document-apis/classes/LineNode.md @@ -506,134 +506,6 @@ removal. No-op if node is already an orphan. --- -### rescaleProportionalToHeight() - -• **rescaleProportionalToHeight**(`height`): `void` - - - -**IMPORTANT:** This is currently ***experimental only*** and should not be used in any add-ons you will be distributing until it has been declared stable. To use it, you will first need to set the `experimentalApis` flag to `true` in the [`requirements`](../../../manifest/index.md#requirements) section of the `manifest.json`. - -Changes the height to the given value by visually *scaling* the entire content larger or smaller on both axes to -preserve its existing aspect ratio. See [rescaleProportionalToWidth](Node.md#rescaleproportionaltowidth) documentation for additional explanation. - -#### Parameters - -• **height**: `number` - -#### Returns - -`void` - -#### Inherited from - -[`StrokableNode`](StrokableNode.md).[`rescaleProportionalToHeight`](StrokableNode.md#rescaleproportionaltoheight) - ---- - -### rescaleProportionalToWidth() - -• **rescaleProportionalToWidth**(`width`): `void` - - - -**IMPORTANT:** This is currently ***experimental only*** and should not be used in any add-ons you will be distributing until it has been declared stable. To use it, you will first need to set the `experimentalApis` flag to `true` in the [`requirements`](../../../manifest/index.md#requirements) section of the `manifest.json`. - -Changes the width to the given value by visually *scaling* the entire content larger or smaller on both axes to -preserve its existing aspect ratio, keeping its top-left corner ([topLeftLocal](VisualNode.md#topleftlocal)) at a fixed location. - -Scaling changes the size of visual styling elements such as stroke width, corner detailing, and font size. -Contrast this to *resizing* operations (such as [resizeToFitWithin](Node.md#resizetofitwithin)), which adjust the bounding box of an -element while trying to preserve the existing size of visual detailing such as strokes, corners, and fonts. - -Rescaling becomes baked into the updated values of fields such as stroke weight, rectangle width, etc. (it is not -a separate, persistent scale factor multiplier). - -#### Parameters - -• **width**: `number` - -#### Returns - -`void` - -#### Inherited from - -[`StrokableNode`](StrokableNode.md).[`rescaleProportionalToWidth`](StrokableNode.md#rescaleproportionaltowidth) - ---- - -### resizeToCover() - -• **resizeToCover**(`width`, `height`): `void` - - - -**IMPORTANT:** This is currently ***experimental only*** and should not be used in any add-ons you will be distributing until it has been declared stable. To use it, you will first need to set the `experimentalApis` flag to `true` in the [`requirements`](../../../manifest/index.md#requirements) section of the `manifest.json`. - -Resizes the node to completely *cover* a box of the given dimensions, keeping its top-left corner ([topLeftLocal](VisualNode.md#topleftlocal)) -at a fixed location. Nodes with a fixed aspect ratio may extend outside the box on one axis as a result, but -nodes with flexible aspect ratio will be resized to the exact box size specified. See [resizeToFitWithin](Node.md#resizetofitwithin) -documentation for additional explanation. - -#### Parameters - -• **width**: `number` - -• **height**: `number` - -#### Returns - -`void` - -#### Inherited from - -[`StrokableNode`](StrokableNode.md).[`resizeToCover`](StrokableNode.md#resizetocover) - -#### See - -resizeToFitWithin - ---- - -### resizeToFitWithin() - -• **resizeToFitWithin**(`width`, `height`): `void` - - - -**IMPORTANT:** This is currently ***experimental only*** and should not be used in any add-ons you will be distributing until it has been declared stable. To use it, you will first need to set the `experimentalApis` flag to `true` in the [`requirements`](../../../manifest/index.md#requirements) section of the `manifest.json`. - -Resizes the node to fit entirely *within* a box of the given dimensions, keeping its top-left corner ([topLeftLocal](VisualNode.md#topleftlocal)) -at a fixed location. Nodes with a fixed aspect ratio may leave unused space on one axis as a result, but nodes -with flexible aspect ratio will be resized to the exact box size specified. - -Resizing attempts to preserve the existing size of visual styling elements such as stroke width, corner detailing, -and font size as much as possible. Contrast with *rescaling* (such as [rescaleProportionalToWidth](Node.md#rescaleproportionaltowidth)), which -always changes the size of visual detailing in exact proportion to the change in overall bounding box size. This -API may still produce *some* degree of rescaling if necessary for certain shapes with fixed corner/edge detailing -to fit the box better. - -#### Parameters - -• **width**: `number` - -• **height**: `number` - -#### Returns - -`void` - -#### Inherited from - -[`StrokableNode`](StrokableNode.md).[`resizeToFitWithin`](StrokableNode.md#resizetofitwithin) - -#### See - -resizeToCover - ---- - ### setEndPoints() • **setEndPoints**(`startX`, `startY`, `endX`, `endY`): `void` diff --git a/src/pages/references/document-sandbox/document-apis/classes/MediaContainerNode.md b/src/pages/references/document-sandbox/document-apis/classes/MediaContainerNode.md index 9bf8166ef..d55500959 100644 --- a/src/pages/references/document-sandbox/document-apis/classes/MediaContainerNode.md +++ b/src/pages/references/document-sandbox/document-apis/classes/MediaContainerNode.md @@ -419,134 +419,6 @@ New content to display. Currently must be a [BitmapImage](BitmapImage.md). --- -### rescaleProportionalToHeight() - -• **rescaleProportionalToHeight**(`height`): `void` - - - -**IMPORTANT:** This is currently ***experimental only*** and should not be used in any add-ons you will be distributing until it has been declared stable. To use it, you will first need to set the `experimentalApis` flag to `true` in the [`requirements`](../../../manifest/index.md#requirements) section of the `manifest.json`. - -Changes the height to the given value by visually *scaling* the entire content larger or smaller on both axes to -preserve its existing aspect ratio. See [rescaleProportionalToWidth](Node.md#rescaleproportionaltowidth) documentation for additional explanation. - -#### Parameters - -• **height**: `number` - -#### Returns - -`void` - -#### Inherited from - -[`Node`](Node.md).[`rescaleProportionalToHeight`](Node.md#rescaleproportionaltoheight) - ---- - -### rescaleProportionalToWidth() - -• **rescaleProportionalToWidth**(`width`): `void` - - - -**IMPORTANT:** This is currently ***experimental only*** and should not be used in any add-ons you will be distributing until it has been declared stable. To use it, you will first need to set the `experimentalApis` flag to `true` in the [`requirements`](../../../manifest/index.md#requirements) section of the `manifest.json`. - -Changes the width to the given value by visually *scaling* the entire content larger or smaller on both axes to -preserve its existing aspect ratio, keeping its top-left corner ([topLeftLocal](VisualNode.md#topleftlocal)) at a fixed location. - -Scaling changes the size of visual styling elements such as stroke width, corner detailing, and font size. -Contrast this to *resizing* operations (such as [resizeToFitWithin](Node.md#resizetofitwithin)), which adjust the bounding box of an -element while trying to preserve the existing size of visual detailing such as strokes, corners, and fonts. - -Rescaling becomes baked into the updated values of fields such as stroke weight, rectangle width, etc. (it is not -a separate, persistent scale factor multiplier). - -#### Parameters - -• **width**: `number` - -#### Returns - -`void` - -#### Inherited from - -[`Node`](Node.md).[`rescaleProportionalToWidth`](Node.md#rescaleproportionaltowidth) - ---- - -### resizeToCover() - -• **resizeToCover**(`width`, `height`): `void` - - - -**IMPORTANT:** This is currently ***experimental only*** and should not be used in any add-ons you will be distributing until it has been declared stable. To use it, you will first need to set the `experimentalApis` flag to `true` in the [`requirements`](../../../manifest/index.md#requirements) section of the `manifest.json`. - -Resizes the node to completely *cover* a box of the given dimensions, keeping its top-left corner ([topLeftLocal](VisualNode.md#topleftlocal)) -at a fixed location. Nodes with a fixed aspect ratio may extend outside the box on one axis as a result, but -nodes with flexible aspect ratio will be resized to the exact box size specified. See [resizeToFitWithin](Node.md#resizetofitwithin) -documentation for additional explanation. - -#### Parameters - -• **width**: `number` - -• **height**: `number` - -#### Returns - -`void` - -#### Inherited from - -[`Node`](Node.md).[`resizeToCover`](Node.md#resizetocover) - -#### See - -resizeToFitWithin - ---- - -### resizeToFitWithin() - -• **resizeToFitWithin**(`width`, `height`): `void` - - - -**IMPORTANT:** This is currently ***experimental only*** and should not be used in any add-ons you will be distributing until it has been declared stable. To use it, you will first need to set the `experimentalApis` flag to `true` in the [`requirements`](../../../manifest/index.md#requirements) section of the `manifest.json`. - -Resizes the node to fit entirely *within* a box of the given dimensions, keeping its top-left corner ([topLeftLocal](VisualNode.md#topleftlocal)) -at a fixed location. Nodes with a fixed aspect ratio may leave unused space on one axis as a result, but nodes -with flexible aspect ratio will be resized to the exact box size specified. - -Resizing attempts to preserve the existing size of visual styling elements such as stroke width, corner detailing, -and font size as much as possible. Contrast with *rescaling* (such as [rescaleProportionalToWidth](Node.md#rescaleproportionaltowidth)), which -always changes the size of visual detailing in exact proportion to the change in overall bounding box size. This -API may still produce *some* degree of rescaling if necessary for certain shapes with fixed corner/edge detailing -to fit the box better. - -#### Parameters - -• **width**: `number` - -• **height**: `number` - -#### Returns - -`void` - -#### Inherited from - -[`Node`](Node.md).[`resizeToFitWithin`](Node.md#resizetofitwithin) - -#### See - -resizeToCover - ---- - ### setPositionInParent() • **setPositionInParent**(`parentPoint`, `localRegistrationPoint`): `void` diff --git a/src/pages/references/document-sandbox/document-apis/classes/MediaRectangleNode.md b/src/pages/references/document-sandbox/document-apis/classes/MediaRectangleNode.md index 3e92c5053..d3239b9cd 100644 --- a/src/pages/references/document-sandbox/document-apis/classes/MediaRectangleNode.md +++ b/src/pages/references/document-sandbox/document-apis/classes/MediaRectangleNode.md @@ -414,134 +414,6 @@ removal. No-op if node is already an orphan. --- -### rescaleProportionalToHeight() - -• **rescaleProportionalToHeight**(`height`): `void` - - - -**IMPORTANT:** This is currently ***experimental only*** and should not be used in any add-ons you will be distributing until it has been declared stable. To use it, you will first need to set the `experimentalApis` flag to `true` in the [`requirements`](../../../manifest/index.md#requirements) section of the `manifest.json`. - -Changes the height to the given value by visually *scaling* the entire content larger or smaller on both axes to -preserve its existing aspect ratio. See [rescaleProportionalToWidth](Node.md#rescaleproportionaltowidth) documentation for additional explanation. - -#### Parameters - -• **height**: `number` - -#### Returns - -`void` - -#### Inherited from - -[`Node`](Node.md).[`rescaleProportionalToHeight`](Node.md#rescaleproportionaltoheight) - ---- - -### rescaleProportionalToWidth() - -• **rescaleProportionalToWidth**(`width`): `void` - - - -**IMPORTANT:** This is currently ***experimental only*** and should not be used in any add-ons you will be distributing until it has been declared stable. To use it, you will first need to set the `experimentalApis` flag to `true` in the [`requirements`](../../../manifest/index.md#requirements) section of the `manifest.json`. - -Changes the width to the given value by visually *scaling* the entire content larger or smaller on both axes to -preserve its existing aspect ratio, keeping its top-left corner ([topLeftLocal](VisualNode.md#topleftlocal)) at a fixed location. - -Scaling changes the size of visual styling elements such as stroke width, corner detailing, and font size. -Contrast this to *resizing* operations (such as [resizeToFitWithin](Node.md#resizetofitwithin)), which adjust the bounding box of an -element while trying to preserve the existing size of visual detailing such as strokes, corners, and fonts. - -Rescaling becomes baked into the updated values of fields such as stroke weight, rectangle width, etc. (it is not -a separate, persistent scale factor multiplier). - -#### Parameters - -• **width**: `number` - -#### Returns - -`void` - -#### Inherited from - -[`Node`](Node.md).[`rescaleProportionalToWidth`](Node.md#rescaleproportionaltowidth) - ---- - -### resizeToCover() - -• **resizeToCover**(`width`, `height`): `void` - - - -**IMPORTANT:** This is currently ***experimental only*** and should not be used in any add-ons you will be distributing until it has been declared stable. To use it, you will first need to set the `experimentalApis` flag to `true` in the [`requirements`](../../../manifest/index.md#requirements) section of the `manifest.json`. - -Resizes the node to completely *cover* a box of the given dimensions, keeping its top-left corner ([topLeftLocal](VisualNode.md#topleftlocal)) -at a fixed location. Nodes with a fixed aspect ratio may extend outside the box on one axis as a result, but -nodes with flexible aspect ratio will be resized to the exact box size specified. See [resizeToFitWithin](Node.md#resizetofitwithin) -documentation for additional explanation. - -#### Parameters - -• **width**: `number` - -• **height**: `number` - -#### Returns - -`void` - -#### Inherited from - -[`Node`](Node.md).[`resizeToCover`](Node.md#resizetocover) - -#### See - -resizeToFitWithin - ---- - -### resizeToFitWithin() - -• **resizeToFitWithin**(`width`, `height`): `void` - - - -**IMPORTANT:** This is currently ***experimental only*** and should not be used in any add-ons you will be distributing until it has been declared stable. To use it, you will first need to set the `experimentalApis` flag to `true` in the [`requirements`](../../../manifest/index.md#requirements) section of the `manifest.json`. - -Resizes the node to fit entirely *within* a box of the given dimensions, keeping its top-left corner ([topLeftLocal](VisualNode.md#topleftlocal)) -at a fixed location. Nodes with a fixed aspect ratio may leave unused space on one axis as a result, but nodes -with flexible aspect ratio will be resized to the exact box size specified. - -Resizing attempts to preserve the existing size of visual styling elements such as stroke width, corner detailing, -and font size as much as possible. Contrast with *rescaling* (such as [rescaleProportionalToWidth](Node.md#rescaleproportionaltowidth)), which -always changes the size of visual detailing in exact proportion to the change in overall bounding box size. This -API may still produce *some* degree of rescaling if necessary for certain shapes with fixed corner/edge detailing -to fit the box better. - -#### Parameters - -• **width**: `number` - -• **height**: `number` - -#### Returns - -`void` - -#### Inherited from - -[`Node`](Node.md).[`resizeToFitWithin`](Node.md#resizetofitwithin) - -#### See - -resizeToCover - ---- - ### setPositionInParent() • **setPositionInParent**(`parentPoint`, `localRegistrationPoint`): `void` diff --git a/src/pages/references/document-sandbox/document-apis/classes/Node.md b/src/pages/references/document-sandbox/document-apis/classes/Node.md index 0d4664fbe..a8139426c 100644 --- a/src/pages/references/document-sandbox/document-apis/classes/Node.md +++ b/src/pages/references/document-sandbox/document-apis/classes/Node.md @@ -379,118 +379,6 @@ removal. No-op if node is already an orphan. --- -### rescaleProportionalToHeight() - -• **rescaleProportionalToHeight**(`height`): `void` - - - -**IMPORTANT:** This is currently ***experimental only*** and should not be used in any add-ons you will be distributing until it has been declared stable. To use it, you will first need to set the `experimentalApis` flag to `true` in the [`requirements`](../../../manifest/index.md#requirements) section of the `manifest.json`. - -Changes the height to the given value by visually *scaling* the entire content larger or smaller on both axes to -preserve its existing aspect ratio. See [rescaleProportionalToWidth](Node.md#rescaleproportionaltowidth) documentation for additional explanation. - -#### Parameters - -• **height**: `number` - -#### Returns - -`void` - ---- - -### rescaleProportionalToWidth() - -• **rescaleProportionalToWidth**(`width`): `void` - - - -**IMPORTANT:** This is currently ***experimental only*** and should not be used in any add-ons you will be distributing until it has been declared stable. To use it, you will first need to set the `experimentalApis` flag to `true` in the [`requirements`](../../../manifest/index.md#requirements) section of the `manifest.json`. - -Changes the width to the given value by visually *scaling* the entire content larger or smaller on both axes to -preserve its existing aspect ratio, keeping its top-left corner ([topLeftLocal](VisualNode.md#topleftlocal)) at a fixed location. - -Scaling changes the size of visual styling elements such as stroke width, corner detailing, and font size. -Contrast this to *resizing* operations (such as [resizeToFitWithin](Node.md#resizetofitwithin)), which adjust the bounding box of an -element while trying to preserve the existing size of visual detailing such as strokes, corners, and fonts. - -Rescaling becomes baked into the updated values of fields such as stroke weight, rectangle width, etc. (it is not -a separate, persistent scale factor multiplier). - -#### Parameters - -• **width**: `number` - -#### Returns - -`void` - ---- - -### resizeToCover() - -• **resizeToCover**(`width`, `height`): `void` - - - -**IMPORTANT:** This is currently ***experimental only*** and should not be used in any add-ons you will be distributing until it has been declared stable. To use it, you will first need to set the `experimentalApis` flag to `true` in the [`requirements`](../../../manifest/index.md#requirements) section of the `manifest.json`. - -Resizes the node to completely *cover* a box of the given dimensions, keeping its top-left corner ([topLeftLocal](VisualNode.md#topleftlocal)) -at a fixed location. Nodes with a fixed aspect ratio may extend outside the box on one axis as a result, but -nodes with flexible aspect ratio will be resized to the exact box size specified. See [resizeToFitWithin](Node.md#resizetofitwithin) -documentation for additional explanation. - -#### Parameters - -• **width**: `number` - -• **height**: `number` - -#### Returns - -`void` - -#### See - -resizeToFitWithin - ---- - -### resizeToFitWithin() - -• **resizeToFitWithin**(`width`, `height`): `void` - - - -**IMPORTANT:** This is currently ***experimental only*** and should not be used in any add-ons you will be distributing until it has been declared stable. To use it, you will first need to set the `experimentalApis` flag to `true` in the [`requirements`](../../../manifest/index.md#requirements) section of the `manifest.json`. - -Resizes the node to fit entirely *within* a box of the given dimensions, keeping its top-left corner ([topLeftLocal](VisualNode.md#topleftlocal)) -at a fixed location. Nodes with a fixed aspect ratio may leave unused space on one axis as a result, but nodes -with flexible aspect ratio will be resized to the exact box size specified. - -Resizing attempts to preserve the existing size of visual styling elements such as stroke width, corner detailing, -and font size as much as possible. Contrast with *rescaling* (such as [rescaleProportionalToWidth](Node.md#rescaleproportionaltowidth)), which -always changes the size of visual detailing in exact proportion to the change in overall bounding box size. This -API may still produce *some* degree of rescaling if necessary for certain shapes with fixed corner/edge detailing -to fit the box better. - -#### Parameters - -• **width**: `number` - -• **height**: `number` - -#### Returns - -`void` - -#### See - -resizeToCover - ---- - ### setPositionInParent() • **setPositionInParent**(`parentPoint`, `localRegistrationPoint`): `void` diff --git a/src/pages/references/document-sandbox/document-apis/classes/PathNode.md b/src/pages/references/document-sandbox/document-apis/classes/PathNode.md index 7bd558fa9..c355d6d89 100644 --- a/src/pages/references/document-sandbox/document-apis/classes/PathNode.md +++ b/src/pages/references/document-sandbox/document-apis/classes/PathNode.md @@ -437,134 +437,6 @@ removal. No-op if node is already an orphan. --- -### rescaleProportionalToHeight() - -• **rescaleProportionalToHeight**(`height`): `void` - - - -**IMPORTANT:** This is currently ***experimental only*** and should not be used in any add-ons you will be distributing until it has been declared stable. To use it, you will first need to set the `experimentalApis` flag to `true` in the [`requirements`](../../../manifest/index.md#requirements) section of the `manifest.json`. - -Changes the height to the given value by visually *scaling* the entire content larger or smaller on both axes to -preserve its existing aspect ratio. See [rescaleProportionalToWidth](Node.md#rescaleproportionaltowidth) documentation for additional explanation. - -#### Parameters - -• **height**: `number` - -#### Returns - -`void` - -#### Inherited from - -[`FillableNode`](FillableNode.md).[`rescaleProportionalToHeight`](FillableNode.md#rescaleproportionaltoheight) - ---- - -### rescaleProportionalToWidth() - -• **rescaleProportionalToWidth**(`width`): `void` - - - -**IMPORTANT:** This is currently ***experimental only*** and should not be used in any add-ons you will be distributing until it has been declared stable. To use it, you will first need to set the `experimentalApis` flag to `true` in the [`requirements`](../../../manifest/index.md#requirements) section of the `manifest.json`. - -Changes the width to the given value by visually *scaling* the entire content larger or smaller on both axes to -preserve its existing aspect ratio, keeping its top-left corner ([topLeftLocal](VisualNode.md#topleftlocal)) at a fixed location. - -Scaling changes the size of visual styling elements such as stroke width, corner detailing, and font size. -Contrast this to *resizing* operations (such as [resizeToFitWithin](Node.md#resizetofitwithin)), which adjust the bounding box of an -element while trying to preserve the existing size of visual detailing such as strokes, corners, and fonts. - -Rescaling becomes baked into the updated values of fields such as stroke weight, rectangle width, etc. (it is not -a separate, persistent scale factor multiplier). - -#### Parameters - -• **width**: `number` - -#### Returns - -`void` - -#### Inherited from - -[`FillableNode`](FillableNode.md).[`rescaleProportionalToWidth`](FillableNode.md#rescaleproportionaltowidth) - ---- - -### resizeToCover() - -• **resizeToCover**(`width`, `height`): `void` - - - -**IMPORTANT:** This is currently ***experimental only*** and should not be used in any add-ons you will be distributing until it has been declared stable. To use it, you will first need to set the `experimentalApis` flag to `true` in the [`requirements`](../../../manifest/index.md#requirements) section of the `manifest.json`. - -Resizes the node to completely *cover* a box of the given dimensions, keeping its top-left corner ([topLeftLocal](VisualNode.md#topleftlocal)) -at a fixed location. Nodes with a fixed aspect ratio may extend outside the box on one axis as a result, but -nodes with flexible aspect ratio will be resized to the exact box size specified. See [resizeToFitWithin](Node.md#resizetofitwithin) -documentation for additional explanation. - -#### Parameters - -• **width**: `number` - -• **height**: `number` - -#### Returns - -`void` - -#### Inherited from - -[`FillableNode`](FillableNode.md).[`resizeToCover`](FillableNode.md#resizetocover) - -#### See - -resizeToFitWithin - ---- - -### resizeToFitWithin() - -• **resizeToFitWithin**(`width`, `height`): `void` - - - -**IMPORTANT:** This is currently ***experimental only*** and should not be used in any add-ons you will be distributing until it has been declared stable. To use it, you will first need to set the `experimentalApis` flag to `true` in the [`requirements`](../../../manifest/index.md#requirements) section of the `manifest.json`. - -Resizes the node to fit entirely *within* a box of the given dimensions, keeping its top-left corner ([topLeftLocal](VisualNode.md#topleftlocal)) -at a fixed location. Nodes with a fixed aspect ratio may leave unused space on one axis as a result, but nodes -with flexible aspect ratio will be resized to the exact box size specified. - -Resizing attempts to preserve the existing size of visual styling elements such as stroke width, corner detailing, -and font size as much as possible. Contrast with *rescaling* (such as [rescaleProportionalToWidth](Node.md#rescaleproportionaltowidth)), which -always changes the size of visual detailing in exact proportion to the change in overall bounding box size. This -API may still produce *some* degree of rescaling if necessary for certain shapes with fixed corner/edge detailing -to fit the box better. - -#### Parameters - -• **width**: `number` - -• **height**: `number` - -#### Returns - -`void` - -#### Inherited from - -[`FillableNode`](FillableNode.md).[`resizeToFitWithin`](FillableNode.md#resizetofitwithin) - -#### See - -resizeToCover - ---- - ### setPositionInParent() • **setPositionInParent**(`parentPoint`, `localRegistrationPoint`): `void` diff --git a/src/pages/references/document-sandbox/document-apis/classes/RectangleNode.md b/src/pages/references/document-sandbox/document-apis/classes/RectangleNode.md index 751647e48..e7239ae56 100644 --- a/src/pages/references/document-sandbox/document-apis/classes/RectangleNode.md +++ b/src/pages/references/document-sandbox/document-apis/classes/RectangleNode.md @@ -545,134 +545,6 @@ removal. No-op if node is already an orphan. --- -### rescaleProportionalToHeight() - -• **rescaleProportionalToHeight**(`height`): `void` - - - -**IMPORTANT:** This is currently ***experimental only*** and should not be used in any add-ons you will be distributing until it has been declared stable. To use it, you will first need to set the `experimentalApis` flag to `true` in the [`requirements`](../../../manifest/index.md#requirements) section of the `manifest.json`. - -Changes the height to the given value by visually *scaling* the entire content larger or smaller on both axes to -preserve its existing aspect ratio. See [rescaleProportionalToWidth](Node.md#rescaleproportionaltowidth) documentation for additional explanation. - -#### Parameters - -• **height**: `number` - -#### Returns - -`void` - -#### Inherited from - -[`FillableNode`](FillableNode.md).[`rescaleProportionalToHeight`](FillableNode.md#rescaleproportionaltoheight) - ---- - -### rescaleProportionalToWidth() - -• **rescaleProportionalToWidth**(`width`): `void` - - - -**IMPORTANT:** This is currently ***experimental only*** and should not be used in any add-ons you will be distributing until it has been declared stable. To use it, you will first need to set the `experimentalApis` flag to `true` in the [`requirements`](../../../manifest/index.md#requirements) section of the `manifest.json`. - -Changes the width to the given value by visually *scaling* the entire content larger or smaller on both axes to -preserve its existing aspect ratio, keeping its top-left corner ([topLeftLocal](VisualNode.md#topleftlocal)) at a fixed location. - -Scaling changes the size of visual styling elements such as stroke width, corner detailing, and font size. -Contrast this to *resizing* operations (such as [resizeToFitWithin](Node.md#resizetofitwithin)), which adjust the bounding box of an -element while trying to preserve the existing size of visual detailing such as strokes, corners, and fonts. - -Rescaling becomes baked into the updated values of fields such as stroke weight, rectangle width, etc. (it is not -a separate, persistent scale factor multiplier). - -#### Parameters - -• **width**: `number` - -#### Returns - -`void` - -#### Inherited from - -[`FillableNode`](FillableNode.md).[`rescaleProportionalToWidth`](FillableNode.md#rescaleproportionaltowidth) - ---- - -### resizeToCover() - -• **resizeToCover**(`width`, `height`): `void` - - - -**IMPORTANT:** This is currently ***experimental only*** and should not be used in any add-ons you will be distributing until it has been declared stable. To use it, you will first need to set the `experimentalApis` flag to `true` in the [`requirements`](../../../manifest/index.md#requirements) section of the `manifest.json`. - -Resizes the node to completely *cover* a box of the given dimensions, keeping its top-left corner ([topLeftLocal](VisualNode.md#topleftlocal)) -at a fixed location. Nodes with a fixed aspect ratio may extend outside the box on one axis as a result, but -nodes with flexible aspect ratio will be resized to the exact box size specified. See [resizeToFitWithin](Node.md#resizetofitwithin) -documentation for additional explanation. - -#### Parameters - -• **width**: `number` - -• **height**: `number` - -#### Returns - -`void` - -#### Inherited from - -[`FillableNode`](FillableNode.md).[`resizeToCover`](FillableNode.md#resizetocover) - -#### See - -resizeToFitWithin - ---- - -### resizeToFitWithin() - -• **resizeToFitWithin**(`width`, `height`): `void` - - - -**IMPORTANT:** This is currently ***experimental only*** and should not be used in any add-ons you will be distributing until it has been declared stable. To use it, you will first need to set the `experimentalApis` flag to `true` in the [`requirements`](../../../manifest/index.md#requirements) section of the `manifest.json`. - -Resizes the node to fit entirely *within* a box of the given dimensions, keeping its top-left corner ([topLeftLocal](VisualNode.md#topleftlocal)) -at a fixed location. Nodes with a fixed aspect ratio may leave unused space on one axis as a result, but nodes -with flexible aspect ratio will be resized to the exact box size specified. - -Resizing attempts to preserve the existing size of visual styling elements such as stroke width, corner detailing, -and font size as much as possible. Contrast with *rescaling* (such as [rescaleProportionalToWidth](Node.md#rescaleproportionaltowidth)), which -always changes the size of visual detailing in exact proportion to the change in overall bounding box size. This -API may still produce *some* degree of rescaling if necessary for certain shapes with fixed corner/edge detailing -to fit the box better. - -#### Parameters - -• **width**: `number` - -• **height**: `number` - -#### Returns - -`void` - -#### Inherited from - -[`FillableNode`](FillableNode.md).[`resizeToFitWithin`](FillableNode.md#resizetofitwithin) - -#### See - -resizeToCover - ---- - ### setPositionInParent() • **setPositionInParent**(`parentPoint`, `localRegistrationPoint`): `void` diff --git a/src/pages/references/document-sandbox/document-apis/classes/SolidColorShapeNode.md b/src/pages/references/document-sandbox/document-apis/classes/SolidColorShapeNode.md index 4a84ddbfc..a2f3f5ad1 100644 --- a/src/pages/references/document-sandbox/document-apis/classes/SolidColorShapeNode.md +++ b/src/pages/references/document-sandbox/document-apis/classes/SolidColorShapeNode.md @@ -377,134 +377,6 @@ removal. No-op if node is already an orphan. --- -### rescaleProportionalToHeight() - -• **rescaleProportionalToHeight**(`height`): `void` - - - -**IMPORTANT:** This is currently ***experimental only*** and should not be used in any add-ons you will be distributing until it has been declared stable. To use it, you will first need to set the `experimentalApis` flag to `true` in the [`requirements`](../../../manifest/index.md#requirements) section of the `manifest.json`. - -Changes the height to the given value by visually *scaling* the entire content larger or smaller on both axes to -preserve its existing aspect ratio. See [rescaleProportionalToWidth](Node.md#rescaleproportionaltowidth) documentation for additional explanation. - -#### Parameters - -• **height**: `number` - -#### Returns - -`void` - -#### Inherited from - -[`Node`](Node.md).[`rescaleProportionalToHeight`](Node.md#rescaleproportionaltoheight) - ---- - -### rescaleProportionalToWidth() - -• **rescaleProportionalToWidth**(`width`): `void` - - - -**IMPORTANT:** This is currently ***experimental only*** and should not be used in any add-ons you will be distributing until it has been declared stable. To use it, you will first need to set the `experimentalApis` flag to `true` in the [`requirements`](../../../manifest/index.md#requirements) section of the `manifest.json`. - -Changes the width to the given value by visually *scaling* the entire content larger or smaller on both axes to -preserve its existing aspect ratio, keeping its top-left corner ([topLeftLocal](VisualNode.md#topleftlocal)) at a fixed location. - -Scaling changes the size of visual styling elements such as stroke width, corner detailing, and font size. -Contrast this to *resizing* operations (such as [resizeToFitWithin](Node.md#resizetofitwithin)), which adjust the bounding box of an -element while trying to preserve the existing size of visual detailing such as strokes, corners, and fonts. - -Rescaling becomes baked into the updated values of fields such as stroke weight, rectangle width, etc. (it is not -a separate, persistent scale factor multiplier). - -#### Parameters - -• **width**: `number` - -#### Returns - -`void` - -#### Inherited from - -[`Node`](Node.md).[`rescaleProportionalToWidth`](Node.md#rescaleproportionaltowidth) - ---- - -### resizeToCover() - -• **resizeToCover**(`width`, `height`): `void` - - - -**IMPORTANT:** This is currently ***experimental only*** and should not be used in any add-ons you will be distributing until it has been declared stable. To use it, you will first need to set the `experimentalApis` flag to `true` in the [`requirements`](../../../manifest/index.md#requirements) section of the `manifest.json`. - -Resizes the node to completely *cover* a box of the given dimensions, keeping its top-left corner ([topLeftLocal](VisualNode.md#topleftlocal)) -at a fixed location. Nodes with a fixed aspect ratio may extend outside the box on one axis as a result, but -nodes with flexible aspect ratio will be resized to the exact box size specified. See [resizeToFitWithin](Node.md#resizetofitwithin) -documentation for additional explanation. - -#### Parameters - -• **width**: `number` - -• **height**: `number` - -#### Returns - -`void` - -#### Inherited from - -[`Node`](Node.md).[`resizeToCover`](Node.md#resizetocover) - -#### See - -resizeToFitWithin - ---- - -### resizeToFitWithin() - -• **resizeToFitWithin**(`width`, `height`): `void` - - - -**IMPORTANT:** This is currently ***experimental only*** and should not be used in any add-ons you will be distributing until it has been declared stable. To use it, you will first need to set the `experimentalApis` flag to `true` in the [`requirements`](../../../manifest/index.md#requirements) section of the `manifest.json`. - -Resizes the node to fit entirely *within* a box of the given dimensions, keeping its top-left corner ([topLeftLocal](VisualNode.md#topleftlocal)) -at a fixed location. Nodes with a fixed aspect ratio may leave unused space on one axis as a result, but nodes -with flexible aspect ratio will be resized to the exact box size specified. - -Resizing attempts to preserve the existing size of visual styling elements such as stroke width, corner detailing, -and font size as much as possible. Contrast with *rescaling* (such as [rescaleProportionalToWidth](Node.md#rescaleproportionaltowidth)), which -always changes the size of visual detailing in exact proportion to the change in overall bounding box size. This -API may still produce *some* degree of rescaling if necessary for certain shapes with fixed corner/edge detailing -to fit the box better. - -#### Parameters - -• **width**: `number` - -• **height**: `number` - -#### Returns - -`void` - -#### Inherited from - -[`Node`](Node.md).[`resizeToFitWithin`](Node.md#resizetofitwithin) - -#### See - -resizeToCover - ---- - ### setPositionInParent() • **setPositionInParent**(`parentPoint`, `localRegistrationPoint`): `void` diff --git a/src/pages/references/document-sandbox/document-apis/classes/StandaloneTextNode.md b/src/pages/references/document-sandbox/document-apis/classes/StandaloneTextNode.md index 8aadd6b94..0d1117b5a 100644 --- a/src/pages/references/document-sandbox/document-apis/classes/StandaloneTextNode.md +++ b/src/pages/references/document-sandbox/document-apis/classes/StandaloneTextNode.md @@ -545,134 +545,6 @@ removal. No-op if node is already an orphan. --- -### rescaleProportionalToHeight() - -• **rescaleProportionalToHeight**(`height`): `void` - - - -**IMPORTANT:** This is currently ***experimental only*** and should not be used in any add-ons you will be distributing until it has been declared stable. To use it, you will first need to set the `experimentalApis` flag to `true` in the [`requirements`](../../../manifest/index.md#requirements) section of the `manifest.json`. - -Changes the height to the given value by visually *scaling* the entire content larger or smaller on both axes to -preserve its existing aspect ratio. See [rescaleProportionalToWidth](Node.md#rescaleproportionaltowidth) documentation for additional explanation. - -#### Parameters - -• **height**: `number` - -#### Returns - -`void` - -#### Inherited from - -[`TextNode`](TextNode.md).[`rescaleProportionalToHeight`](TextNode.md#rescaleproportionaltoheight) - ---- - -### rescaleProportionalToWidth() - -• **rescaleProportionalToWidth**(`width`): `void` - - - -**IMPORTANT:** This is currently ***experimental only*** and should not be used in any add-ons you will be distributing until it has been declared stable. To use it, you will first need to set the `experimentalApis` flag to `true` in the [`requirements`](../../../manifest/index.md#requirements) section of the `manifest.json`. - -Changes the width to the given value by visually *scaling* the entire content larger or smaller on both axes to -preserve its existing aspect ratio, keeping its top-left corner ([topLeftLocal](VisualNode.md#topleftlocal)) at a fixed location. - -Scaling changes the size of visual styling elements such as stroke width, corner detailing, and font size. -Contrast this to *resizing* operations (such as [resizeToFitWithin](Node.md#resizetofitwithin)), which adjust the bounding box of an -element while trying to preserve the existing size of visual detailing such as strokes, corners, and fonts. - -Rescaling becomes baked into the updated values of fields such as stroke weight, rectangle width, etc. (it is not -a separate, persistent scale factor multiplier). - -#### Parameters - -• **width**: `number` - -#### Returns - -`void` - -#### Inherited from - -[`TextNode`](TextNode.md).[`rescaleProportionalToWidth`](TextNode.md#rescaleproportionaltowidth) - ---- - -### resizeToCover() - -• **resizeToCover**(`width`, `height`): `void` - - - -**IMPORTANT:** This is currently ***experimental only*** and should not be used in any add-ons you will be distributing until it has been declared stable. To use it, you will first need to set the `experimentalApis` flag to `true` in the [`requirements`](../../../manifest/index.md#requirements) section of the `manifest.json`. - -Resizes the node to completely *cover* a box of the given dimensions, keeping its top-left corner ([topLeftLocal](VisualNode.md#topleftlocal)) -at a fixed location. Nodes with a fixed aspect ratio may extend outside the box on one axis as a result, but -nodes with flexible aspect ratio will be resized to the exact box size specified. See [resizeToFitWithin](Node.md#resizetofitwithin) -documentation for additional explanation. - -#### Parameters - -• **width**: `number` - -• **height**: `number` - -#### Returns - -`void` - -#### Inherited from - -[`TextNode`](TextNode.md).[`resizeToCover`](TextNode.md#resizetocover) - -#### See - -resizeToFitWithin - ---- - -### resizeToFitWithin() - -• **resizeToFitWithin**(`width`, `height`): `void` - - - -**IMPORTANT:** This is currently ***experimental only*** and should not be used in any add-ons you will be distributing until it has been declared stable. To use it, you will first need to set the `experimentalApis` flag to `true` in the [`requirements`](../../../manifest/index.md#requirements) section of the `manifest.json`. - -Resizes the node to fit entirely *within* a box of the given dimensions, keeping its top-left corner ([topLeftLocal](VisualNode.md#topleftlocal)) -at a fixed location. Nodes with a fixed aspect ratio may leave unused space on one axis as a result, but nodes -with flexible aspect ratio will be resized to the exact box size specified. - -Resizing attempts to preserve the existing size of visual styling elements such as stroke width, corner detailing, -and font size as much as possible. Contrast with *rescaling* (such as [rescaleProportionalToWidth](Node.md#rescaleproportionaltowidth)), which -always changes the size of visual detailing in exact proportion to the change in overall bounding box size. This -API may still produce *some* degree of rescaling if necessary for certain shapes with fixed corner/edge detailing -to fit the box better. - -#### Parameters - -• **width**: `number` - -• **height**: `number` - -#### Returns - -`void` - -#### Inherited from - -[`TextNode`](TextNode.md).[`resizeToFitWithin`](TextNode.md#resizetofitwithin) - -#### See - -resizeToCover - ---- - ### setPositionInParent() • **setPositionInParent**(`parentPoint`, `localRegistrationPoint`): `void` diff --git a/src/pages/references/document-sandbox/document-apis/classes/StrokableNode.md b/src/pages/references/document-sandbox/document-apis/classes/StrokableNode.md index fe5804588..3df2f7161 100644 --- a/src/pages/references/document-sandbox/document-apis/classes/StrokableNode.md +++ b/src/pages/references/document-sandbox/document-apis/classes/StrokableNode.md @@ -388,134 +388,6 @@ removal. No-op if node is already an orphan. --- -### rescaleProportionalToHeight() - -• **rescaleProportionalToHeight**(`height`): `void` - - - -**IMPORTANT:** This is currently ***experimental only*** and should not be used in any add-ons you will be distributing until it has been declared stable. To use it, you will first need to set the `experimentalApis` flag to `true` in the [`requirements`](../../../manifest/index.md#requirements) section of the `manifest.json`. - -Changes the height to the given value by visually *scaling* the entire content larger or smaller on both axes to -preserve its existing aspect ratio. See [rescaleProportionalToWidth](Node.md#rescaleproportionaltowidth) documentation for additional explanation. - -#### Parameters - -• **height**: `number` - -#### Returns - -`void` - -#### Inherited from - -[`Node`](Node.md).[`rescaleProportionalToHeight`](Node.md#rescaleproportionaltoheight) - ---- - -### rescaleProportionalToWidth() - -• **rescaleProportionalToWidth**(`width`): `void` - - - -**IMPORTANT:** This is currently ***experimental only*** and should not be used in any add-ons you will be distributing until it has been declared stable. To use it, you will first need to set the `experimentalApis` flag to `true` in the [`requirements`](../../../manifest/index.md#requirements) section of the `manifest.json`. - -Changes the width to the given value by visually *scaling* the entire content larger or smaller on both axes to -preserve its existing aspect ratio, keeping its top-left corner ([topLeftLocal](VisualNode.md#topleftlocal)) at a fixed location. - -Scaling changes the size of visual styling elements such as stroke width, corner detailing, and font size. -Contrast this to *resizing* operations (such as [resizeToFitWithin](Node.md#resizetofitwithin)), which adjust the bounding box of an -element while trying to preserve the existing size of visual detailing such as strokes, corners, and fonts. - -Rescaling becomes baked into the updated values of fields such as stroke weight, rectangle width, etc. (it is not -a separate, persistent scale factor multiplier). - -#### Parameters - -• **width**: `number` - -#### Returns - -`void` - -#### Inherited from - -[`Node`](Node.md).[`rescaleProportionalToWidth`](Node.md#rescaleproportionaltowidth) - ---- - -### resizeToCover() - -• **resizeToCover**(`width`, `height`): `void` - - - -**IMPORTANT:** This is currently ***experimental only*** and should not be used in any add-ons you will be distributing until it has been declared stable. To use it, you will first need to set the `experimentalApis` flag to `true` in the [`requirements`](../../../manifest/index.md#requirements) section of the `manifest.json`. - -Resizes the node to completely *cover* a box of the given dimensions, keeping its top-left corner ([topLeftLocal](VisualNode.md#topleftlocal)) -at a fixed location. Nodes with a fixed aspect ratio may extend outside the box on one axis as a result, but -nodes with flexible aspect ratio will be resized to the exact box size specified. See [resizeToFitWithin](Node.md#resizetofitwithin) -documentation for additional explanation. - -#### Parameters - -• **width**: `number` - -• **height**: `number` - -#### Returns - -`void` - -#### Inherited from - -[`Node`](Node.md).[`resizeToCover`](Node.md#resizetocover) - -#### See - -resizeToFitWithin - ---- - -### resizeToFitWithin() - -• **resizeToFitWithin**(`width`, `height`): `void` - - - -**IMPORTANT:** This is currently ***experimental only*** and should not be used in any add-ons you will be distributing until it has been declared stable. To use it, you will first need to set the `experimentalApis` flag to `true` in the [`requirements`](../../../manifest/index.md#requirements) section of the `manifest.json`. - -Resizes the node to fit entirely *within* a box of the given dimensions, keeping its top-left corner ([topLeftLocal](VisualNode.md#topleftlocal)) -at a fixed location. Nodes with a fixed aspect ratio may leave unused space on one axis as a result, but nodes -with flexible aspect ratio will be resized to the exact box size specified. - -Resizing attempts to preserve the existing size of visual styling elements such as stroke width, corner detailing, -and font size as much as possible. Contrast with *rescaling* (such as [rescaleProportionalToWidth](Node.md#rescaleproportionaltowidth)), which -always changes the size of visual detailing in exact proportion to the change in overall bounding box size. This -API may still produce *some* degree of rescaling if necessary for certain shapes with fixed corner/edge detailing -to fit the box better. - -#### Parameters - -• **width**: `number` - -• **height**: `number` - -#### Returns - -`void` - -#### Inherited from - -[`Node`](Node.md).[`resizeToFitWithin`](Node.md#resizetofitwithin) - -#### See - -resizeToCover - ---- - ### setPositionInParent() • **setPositionInParent**(`parentPoint`, `localRegistrationPoint`): `void` diff --git a/src/pages/references/document-sandbox/document-apis/classes/StrokeShapeNode.md b/src/pages/references/document-sandbox/document-apis/classes/StrokeShapeNode.md index d75295f68..d1efca38a 100644 --- a/src/pages/references/document-sandbox/document-apis/classes/StrokeShapeNode.md +++ b/src/pages/references/document-sandbox/document-apis/classes/StrokeShapeNode.md @@ -379,134 +379,6 @@ removal. No-op if node is already an orphan. --- -### rescaleProportionalToHeight() - -• **rescaleProportionalToHeight**(`height`): `void` - - - -**IMPORTANT:** This is currently ***experimental only*** and should not be used in any add-ons you will be distributing until it has been declared stable. To use it, you will first need to set the `experimentalApis` flag to `true` in the [`requirements`](../../../manifest/index.md#requirements) section of the `manifest.json`. - -Changes the height to the given value by visually *scaling* the entire content larger or smaller on both axes to -preserve its existing aspect ratio. See [rescaleProportionalToWidth](Node.md#rescaleproportionaltowidth) documentation for additional explanation. - -#### Parameters - -• **height**: `number` - -#### Returns - -`void` - -#### Inherited from - -[`StrokableNode`](StrokableNode.md).[`rescaleProportionalToHeight`](StrokableNode.md#rescaleproportionaltoheight) - ---- - -### rescaleProportionalToWidth() - -• **rescaleProportionalToWidth**(`width`): `void` - - - -**IMPORTANT:** This is currently ***experimental only*** and should not be used in any add-ons you will be distributing until it has been declared stable. To use it, you will first need to set the `experimentalApis` flag to `true` in the [`requirements`](../../../manifest/index.md#requirements) section of the `manifest.json`. - -Changes the width to the given value by visually *scaling* the entire content larger or smaller on both axes to -preserve its existing aspect ratio, keeping its top-left corner ([topLeftLocal](VisualNode.md#topleftlocal)) at a fixed location. - -Scaling changes the size of visual styling elements such as stroke width, corner detailing, and font size. -Contrast this to *resizing* operations (such as [resizeToFitWithin](Node.md#resizetofitwithin)), which adjust the bounding box of an -element while trying to preserve the existing size of visual detailing such as strokes, corners, and fonts. - -Rescaling becomes baked into the updated values of fields such as stroke weight, rectangle width, etc. (it is not -a separate, persistent scale factor multiplier). - -#### Parameters - -• **width**: `number` - -#### Returns - -`void` - -#### Inherited from - -[`StrokableNode`](StrokableNode.md).[`rescaleProportionalToWidth`](StrokableNode.md#rescaleproportionaltowidth) - ---- - -### resizeToCover() - -• **resizeToCover**(`width`, `height`): `void` - - - -**IMPORTANT:** This is currently ***experimental only*** and should not be used in any add-ons you will be distributing until it has been declared stable. To use it, you will first need to set the `experimentalApis` flag to `true` in the [`requirements`](../../../manifest/index.md#requirements) section of the `manifest.json`. - -Resizes the node to completely *cover* a box of the given dimensions, keeping its top-left corner ([topLeftLocal](VisualNode.md#topleftlocal)) -at a fixed location. Nodes with a fixed aspect ratio may extend outside the box on one axis as a result, but -nodes with flexible aspect ratio will be resized to the exact box size specified. See [resizeToFitWithin](Node.md#resizetofitwithin) -documentation for additional explanation. - -#### Parameters - -• **width**: `number` - -• **height**: `number` - -#### Returns - -`void` - -#### Inherited from - -[`StrokableNode`](StrokableNode.md).[`resizeToCover`](StrokableNode.md#resizetocover) - -#### See - -resizeToFitWithin - ---- - -### resizeToFitWithin() - -• **resizeToFitWithin**(`width`, `height`): `void` - - - -**IMPORTANT:** This is currently ***experimental only*** and should not be used in any add-ons you will be distributing until it has been declared stable. To use it, you will first need to set the `experimentalApis` flag to `true` in the [`requirements`](../../../manifest/index.md#requirements) section of the `manifest.json`. - -Resizes the node to fit entirely *within* a box of the given dimensions, keeping its top-left corner ([topLeftLocal](VisualNode.md#topleftlocal)) -at a fixed location. Nodes with a fixed aspect ratio may leave unused space on one axis as a result, but nodes -with flexible aspect ratio will be resized to the exact box size specified. - -Resizing attempts to preserve the existing size of visual styling elements such as stroke width, corner detailing, -and font size as much as possible. Contrast with *rescaling* (such as [rescaleProportionalToWidth](Node.md#rescaleproportionaltowidth)), which -always changes the size of visual detailing in exact proportion to the change in overall bounding box size. This -API may still produce *some* degree of rescaling if necessary for certain shapes with fixed corner/edge detailing -to fit the box better. - -#### Parameters - -• **width**: `number` - -• **height**: `number` - -#### Returns - -`void` - -#### Inherited from - -[`StrokableNode`](StrokableNode.md).[`resizeToFitWithin`](StrokableNode.md#resizetofitwithin) - -#### See - -resizeToCover - ---- - ### setPositionInParent() • **setPositionInParent**(`parentPoint`, `localRegistrationPoint`): `void` diff --git a/src/pages/references/document-sandbox/document-apis/classes/TextNode.md b/src/pages/references/document-sandbox/document-apis/classes/TextNode.md index 5f85df56f..c651e303d 100644 --- a/src/pages/references/document-sandbox/document-apis/classes/TextNode.md +++ b/src/pages/references/document-sandbox/document-apis/classes/TextNode.md @@ -532,134 +532,6 @@ removal. No-op if node is already an orphan. --- -### rescaleProportionalToHeight() - -• **rescaleProportionalToHeight**(`height`): `void` - - - -**IMPORTANT:** This is currently ***experimental only*** and should not be used in any add-ons you will be distributing until it has been declared stable. To use it, you will first need to set the `experimentalApis` flag to `true` in the [`requirements`](../../../manifest/index.md#requirements) section of the `manifest.json`. - -Changes the height to the given value by visually *scaling* the entire content larger or smaller on both axes to -preserve its existing aspect ratio. See [rescaleProportionalToWidth](Node.md#rescaleproportionaltowidth) documentation for additional explanation. - -#### Parameters - -• **height**: `number` - -#### Returns - -`void` - -#### Inherited from - -[`Node`](Node.md).[`rescaleProportionalToHeight`](Node.md#rescaleproportionaltoheight) - ---- - -### rescaleProportionalToWidth() - -• **rescaleProportionalToWidth**(`width`): `void` - - - -**IMPORTANT:** This is currently ***experimental only*** and should not be used in any add-ons you will be distributing until it has been declared stable. To use it, you will first need to set the `experimentalApis` flag to `true` in the [`requirements`](../../../manifest/index.md#requirements) section of the `manifest.json`. - -Changes the width to the given value by visually *scaling* the entire content larger or smaller on both axes to -preserve its existing aspect ratio, keeping its top-left corner ([topLeftLocal](VisualNode.md#topleftlocal)) at a fixed location. - -Scaling changes the size of visual styling elements such as stroke width, corner detailing, and font size. -Contrast this to *resizing* operations (such as [resizeToFitWithin](Node.md#resizetofitwithin)), which adjust the bounding box of an -element while trying to preserve the existing size of visual detailing such as strokes, corners, and fonts. - -Rescaling becomes baked into the updated values of fields such as stroke weight, rectangle width, etc. (it is not -a separate, persistent scale factor multiplier). - -#### Parameters - -• **width**: `number` - -#### Returns - -`void` - -#### Inherited from - -[`Node`](Node.md).[`rescaleProportionalToWidth`](Node.md#rescaleproportionaltowidth) - ---- - -### resizeToCover() - -• **resizeToCover**(`width`, `height`): `void` - - - -**IMPORTANT:** This is currently ***experimental only*** and should not be used in any add-ons you will be distributing until it has been declared stable. To use it, you will first need to set the `experimentalApis` flag to `true` in the [`requirements`](../../../manifest/index.md#requirements) section of the `manifest.json`. - -Resizes the node to completely *cover* a box of the given dimensions, keeping its top-left corner ([topLeftLocal](VisualNode.md#topleftlocal)) -at a fixed location. Nodes with a fixed aspect ratio may extend outside the box on one axis as a result, but -nodes with flexible aspect ratio will be resized to the exact box size specified. See [resizeToFitWithin](Node.md#resizetofitwithin) -documentation for additional explanation. - -#### Parameters - -• **width**: `number` - -• **height**: `number` - -#### Returns - -`void` - -#### Inherited from - -[`Node`](Node.md).[`resizeToCover`](Node.md#resizetocover) - -#### See - -resizeToFitWithin - ---- - -### resizeToFitWithin() - -• **resizeToFitWithin**(`width`, `height`): `void` - - - -**IMPORTANT:** This is currently ***experimental only*** and should not be used in any add-ons you will be distributing until it has been declared stable. To use it, you will first need to set the `experimentalApis` flag to `true` in the [`requirements`](../../../manifest/index.md#requirements) section of the `manifest.json`. - -Resizes the node to fit entirely *within* a box of the given dimensions, keeping its top-left corner ([topLeftLocal](VisualNode.md#topleftlocal)) -at a fixed location. Nodes with a fixed aspect ratio may leave unused space on one axis as a result, but nodes -with flexible aspect ratio will be resized to the exact box size specified. - -Resizing attempts to preserve the existing size of visual styling elements such as stroke width, corner detailing, -and font size as much as possible. Contrast with *rescaling* (such as [rescaleProportionalToWidth](Node.md#rescaleproportionaltowidth)), which -always changes the size of visual detailing in exact proportion to the change in overall bounding box size. This -API may still produce *some* degree of rescaling if necessary for certain shapes with fixed corner/edge detailing -to fit the box better. - -#### Parameters - -• **width**: `number` - -• **height**: `number` - -#### Returns - -`void` - -#### Inherited from - -[`Node`](Node.md).[`resizeToFitWithin`](Node.md#resizetofitwithin) - -#### See - -resizeToCover - ---- - ### setPositionInParent() • **setPositionInParent**(`parentPoint`, `localRegistrationPoint`): `void` diff --git a/src/pages/references/document-sandbox/document-apis/classes/ThreadedTextNode.md b/src/pages/references/document-sandbox/document-apis/classes/ThreadedTextNode.md index fee6899ed..3e2600815 100644 --- a/src/pages/references/document-sandbox/document-apis/classes/ThreadedTextNode.md +++ b/src/pages/references/document-sandbox/document-apis/classes/ThreadedTextNode.md @@ -541,134 +541,6 @@ removal. No-op if node is already an orphan. --- -### rescaleProportionalToHeight() - -• **rescaleProportionalToHeight**(`height`): `void` - - - -**IMPORTANT:** This is currently ***experimental only*** and should not be used in any add-ons you will be distributing until it has been declared stable. To use it, you will first need to set the `experimentalApis` flag to `true` in the [`requirements`](../../../manifest/index.md#requirements) section of the `manifest.json`. - -Changes the height to the given value by visually *scaling* the entire content larger or smaller on both axes to -preserve its existing aspect ratio. See [rescaleProportionalToWidth](Node.md#rescaleproportionaltowidth) documentation for additional explanation. - -#### Parameters - -• **height**: `number` - -#### Returns - -`void` - -#### Inherited from - -[`TextNode`](TextNode.md).[`rescaleProportionalToHeight`](TextNode.md#rescaleproportionaltoheight) - ---- - -### rescaleProportionalToWidth() - -• **rescaleProportionalToWidth**(`width`): `void` - - - -**IMPORTANT:** This is currently ***experimental only*** and should not be used in any add-ons you will be distributing until it has been declared stable. To use it, you will first need to set the `experimentalApis` flag to `true` in the [`requirements`](../../../manifest/index.md#requirements) section of the `manifest.json`. - -Changes the width to the given value by visually *scaling* the entire content larger or smaller on both axes to -preserve its existing aspect ratio, keeping its top-left corner ([topLeftLocal](VisualNode.md#topleftlocal)) at a fixed location. - -Scaling changes the size of visual styling elements such as stroke width, corner detailing, and font size. -Contrast this to *resizing* operations (such as [resizeToFitWithin](Node.md#resizetofitwithin)), which adjust the bounding box of an -element while trying to preserve the existing size of visual detailing such as strokes, corners, and fonts. - -Rescaling becomes baked into the updated values of fields such as stroke weight, rectangle width, etc. (it is not -a separate, persistent scale factor multiplier). - -#### Parameters - -• **width**: `number` - -#### Returns - -`void` - -#### Inherited from - -[`TextNode`](TextNode.md).[`rescaleProportionalToWidth`](TextNode.md#rescaleproportionaltowidth) - ---- - -### resizeToCover() - -• **resizeToCover**(`width`, `height`): `void` - - - -**IMPORTANT:** This is currently ***experimental only*** and should not be used in any add-ons you will be distributing until it has been declared stable. To use it, you will first need to set the `experimentalApis` flag to `true` in the [`requirements`](../../../manifest/index.md#requirements) section of the `manifest.json`. - -Resizes the node to completely *cover* a box of the given dimensions, keeping its top-left corner ([topLeftLocal](VisualNode.md#topleftlocal)) -at a fixed location. Nodes with a fixed aspect ratio may extend outside the box on one axis as a result, but -nodes with flexible aspect ratio will be resized to the exact box size specified. See [resizeToFitWithin](Node.md#resizetofitwithin) -documentation for additional explanation. - -#### Parameters - -• **width**: `number` - -• **height**: `number` - -#### Returns - -`void` - -#### Inherited from - -[`TextNode`](TextNode.md).[`resizeToCover`](TextNode.md#resizetocover) - -#### See - -resizeToFitWithin - ---- - -### resizeToFitWithin() - -• **resizeToFitWithin**(`width`, `height`): `void` - - - -**IMPORTANT:** This is currently ***experimental only*** and should not be used in any add-ons you will be distributing until it has been declared stable. To use it, you will first need to set the `experimentalApis` flag to `true` in the [`requirements`](../../../manifest/index.md#requirements) section of the `manifest.json`. - -Resizes the node to fit entirely *within* a box of the given dimensions, keeping its top-left corner ([topLeftLocal](VisualNode.md#topleftlocal)) -at a fixed location. Nodes with a fixed aspect ratio may leave unused space on one axis as a result, but nodes -with flexible aspect ratio will be resized to the exact box size specified. - -Resizing attempts to preserve the existing size of visual styling elements such as stroke width, corner detailing, -and font size as much as possible. Contrast with *rescaling* (such as [rescaleProportionalToWidth](Node.md#rescaleproportionaltowidth)), which -always changes the size of visual detailing in exact proportion to the change in overall bounding box size. This -API may still produce *some* degree of rescaling if necessary for certain shapes with fixed corner/edge detailing -to fit the box better. - -#### Parameters - -• **width**: `number` - -• **height**: `number` - -#### Returns - -`void` - -#### Inherited from - -[`TextNode`](TextNode.md).[`resizeToFitWithin`](TextNode.md#resizetofitwithin) - -#### See - -resizeToCover - ---- - ### setPositionInParent() • **setPositionInParent**(`parentPoint`, `localRegistrationPoint`): `void` diff --git a/src/pages/references/document-sandbox/document-apis/classes/UnknownMediaRectangleNode.md b/src/pages/references/document-sandbox/document-apis/classes/UnknownMediaRectangleNode.md index ca7570cec..39ba19120 100644 --- a/src/pages/references/document-sandbox/document-apis/classes/UnknownMediaRectangleNode.md +++ b/src/pages/references/document-sandbox/document-apis/classes/UnknownMediaRectangleNode.md @@ -404,134 +404,6 @@ removal. No-op if node is already an orphan. --- -### rescaleProportionalToHeight() - -• **rescaleProportionalToHeight**(`height`): `void` - - - -**IMPORTANT:** This is currently ***experimental only*** and should not be used in any add-ons you will be distributing until it has been declared stable. To use it, you will first need to set the `experimentalApis` flag to `true` in the [`requirements`](../../../manifest/index.md#requirements) section of the `manifest.json`. - -Changes the height to the given value by visually *scaling* the entire content larger or smaller on both axes to -preserve its existing aspect ratio. See [rescaleProportionalToWidth](Node.md#rescaleproportionaltowidth) documentation for additional explanation. - -#### Parameters - -• **height**: `number` - -#### Returns - -`void` - -#### Inherited from - -[`MediaRectangleNode`](MediaRectangleNode.md).[`rescaleProportionalToHeight`](MediaRectangleNode.md#rescaleproportionaltoheight) - ---- - -### rescaleProportionalToWidth() - -• **rescaleProportionalToWidth**(`width`): `void` - - - -**IMPORTANT:** This is currently ***experimental only*** and should not be used in any add-ons you will be distributing until it has been declared stable. To use it, you will first need to set the `experimentalApis` flag to `true` in the [`requirements`](../../../manifest/index.md#requirements) section of the `manifest.json`. - -Changes the width to the given value by visually *scaling* the entire content larger or smaller on both axes to -preserve its existing aspect ratio, keeping its top-left corner ([topLeftLocal](VisualNode.md#topleftlocal)) at a fixed location. - -Scaling changes the size of visual styling elements such as stroke width, corner detailing, and font size. -Contrast this to *resizing* operations (such as [resizeToFitWithin](Node.md#resizetofitwithin)), which adjust the bounding box of an -element while trying to preserve the existing size of visual detailing such as strokes, corners, and fonts. - -Rescaling becomes baked into the updated values of fields such as stroke weight, rectangle width, etc. (it is not -a separate, persistent scale factor multiplier). - -#### Parameters - -• **width**: `number` - -#### Returns - -`void` - -#### Inherited from - -[`MediaRectangleNode`](MediaRectangleNode.md).[`rescaleProportionalToWidth`](MediaRectangleNode.md#rescaleproportionaltowidth) - ---- - -### resizeToCover() - -• **resizeToCover**(`width`, `height`): `void` - - - -**IMPORTANT:** This is currently ***experimental only*** and should not be used in any add-ons you will be distributing until it has been declared stable. To use it, you will first need to set the `experimentalApis` flag to `true` in the [`requirements`](../../../manifest/index.md#requirements) section of the `manifest.json`. - -Resizes the node to completely *cover* a box of the given dimensions, keeping its top-left corner ([topLeftLocal](VisualNode.md#topleftlocal)) -at a fixed location. Nodes with a fixed aspect ratio may extend outside the box on one axis as a result, but -nodes with flexible aspect ratio will be resized to the exact box size specified. See [resizeToFitWithin](Node.md#resizetofitwithin) -documentation for additional explanation. - -#### Parameters - -• **width**: `number` - -• **height**: `number` - -#### Returns - -`void` - -#### Inherited from - -[`MediaRectangleNode`](MediaRectangleNode.md).[`resizeToCover`](MediaRectangleNode.md#resizetocover) - -#### See - -resizeToFitWithin - ---- - -### resizeToFitWithin() - -• **resizeToFitWithin**(`width`, `height`): `void` - - - -**IMPORTANT:** This is currently ***experimental only*** and should not be used in any add-ons you will be distributing until it has been declared stable. To use it, you will first need to set the `experimentalApis` flag to `true` in the [`requirements`](../../../manifest/index.md#requirements) section of the `manifest.json`. - -Resizes the node to fit entirely *within* a box of the given dimensions, keeping its top-left corner ([topLeftLocal](VisualNode.md#topleftlocal)) -at a fixed location. Nodes with a fixed aspect ratio may leave unused space on one axis as a result, but nodes -with flexible aspect ratio will be resized to the exact box size specified. - -Resizing attempts to preserve the existing size of visual styling elements such as stroke width, corner detailing, -and font size as much as possible. Contrast with *rescaling* (such as [rescaleProportionalToWidth](Node.md#rescaleproportionaltowidth)), which -always changes the size of visual detailing in exact proportion to the change in overall bounding box size. This -API may still produce *some* degree of rescaling if necessary for certain shapes with fixed corner/edge detailing -to fit the box better. - -#### Parameters - -• **width**: `number` - -• **height**: `number` - -#### Returns - -`void` - -#### Inherited from - -[`MediaRectangleNode`](MediaRectangleNode.md).[`resizeToFitWithin`](MediaRectangleNode.md#resizetofitwithin) - -#### See - -resizeToCover - ---- - ### setPositionInParent() • **setPositionInParent**(`parentPoint`, `localRegistrationPoint`): `void` diff --git a/src/pages/references/document-sandbox/document-apis/classes/UnknownNode.md b/src/pages/references/document-sandbox/document-apis/classes/UnknownNode.md index 1e3b9c196..affd4e86c 100644 --- a/src/pages/references/document-sandbox/document-apis/classes/UnknownNode.md +++ b/src/pages/references/document-sandbox/document-apis/classes/UnknownNode.md @@ -358,134 +358,6 @@ removal. No-op if node is already an orphan. --- -### rescaleProportionalToHeight() - -• **rescaleProportionalToHeight**(`height`): `void` - - - -**IMPORTANT:** This is currently ***experimental only*** and should not be used in any add-ons you will be distributing until it has been declared stable. To use it, you will first need to set the `experimentalApis` flag to `true` in the [`requirements`](../../../manifest/index.md#requirements) section of the `manifest.json`. - -Changes the height to the given value by visually *scaling* the entire content larger or smaller on both axes to -preserve its existing aspect ratio. See [rescaleProportionalToWidth](Node.md#rescaleproportionaltowidth) documentation for additional explanation. - -#### Parameters - -• **height**: `number` - -#### Returns - -`void` - -#### Inherited from - -[`Node`](Node.md).[`rescaleProportionalToHeight`](Node.md#rescaleproportionaltoheight) - ---- - -### rescaleProportionalToWidth() - -• **rescaleProportionalToWidth**(`width`): `void` - - - -**IMPORTANT:** This is currently ***experimental only*** and should not be used in any add-ons you will be distributing until it has been declared stable. To use it, you will first need to set the `experimentalApis` flag to `true` in the [`requirements`](../../../manifest/index.md#requirements) section of the `manifest.json`. - -Changes the width to the given value by visually *scaling* the entire content larger or smaller on both axes to -preserve its existing aspect ratio, keeping its top-left corner ([topLeftLocal](VisualNode.md#topleftlocal)) at a fixed location. - -Scaling changes the size of visual styling elements such as stroke width, corner detailing, and font size. -Contrast this to *resizing* operations (such as [resizeToFitWithin](Node.md#resizetofitwithin)), which adjust the bounding box of an -element while trying to preserve the existing size of visual detailing such as strokes, corners, and fonts. - -Rescaling becomes baked into the updated values of fields such as stroke weight, rectangle width, etc. (it is not -a separate, persistent scale factor multiplier). - -#### Parameters - -• **width**: `number` - -#### Returns - -`void` - -#### Inherited from - -[`Node`](Node.md).[`rescaleProportionalToWidth`](Node.md#rescaleproportionaltowidth) - ---- - -### resizeToCover() - -• **resizeToCover**(`width`, `height`): `void` - - - -**IMPORTANT:** This is currently ***experimental only*** and should not be used in any add-ons you will be distributing until it has been declared stable. To use it, you will first need to set the `experimentalApis` flag to `true` in the [`requirements`](../../../manifest/index.md#requirements) section of the `manifest.json`. - -Resizes the node to completely *cover* a box of the given dimensions, keeping its top-left corner ([topLeftLocal](VisualNode.md#topleftlocal)) -at a fixed location. Nodes with a fixed aspect ratio may extend outside the box on one axis as a result, but -nodes with flexible aspect ratio will be resized to the exact box size specified. See [resizeToFitWithin](Node.md#resizetofitwithin) -documentation for additional explanation. - -#### Parameters - -• **width**: `number` - -• **height**: `number` - -#### Returns - -`void` - -#### Inherited from - -[`Node`](Node.md).[`resizeToCover`](Node.md#resizetocover) - -#### See - -resizeToFitWithin - ---- - -### resizeToFitWithin() - -• **resizeToFitWithin**(`width`, `height`): `void` - - - -**IMPORTANT:** This is currently ***experimental only*** and should not be used in any add-ons you will be distributing until it has been declared stable. To use it, you will first need to set the `experimentalApis` flag to `true` in the [`requirements`](../../../manifest/index.md#requirements) section of the `manifest.json`. - -Resizes the node to fit entirely *within* a box of the given dimensions, keeping its top-left corner ([topLeftLocal](VisualNode.md#topleftlocal)) -at a fixed location. Nodes with a fixed aspect ratio may leave unused space on one axis as a result, but nodes -with flexible aspect ratio will be resized to the exact box size specified. - -Resizing attempts to preserve the existing size of visual styling elements such as stroke width, corner detailing, -and font size as much as possible. Contrast with *rescaling* (such as [rescaleProportionalToWidth](Node.md#rescaleproportionaltowidth)), which -always changes the size of visual detailing in exact proportion to the change in overall bounding box size. This -API may still produce *some* degree of rescaling if necessary for certain shapes with fixed corner/edge detailing -to fit the box better. - -#### Parameters - -• **width**: `number` - -• **height**: `number` - -#### Returns - -`void` - -#### Inherited from - -[`Node`](Node.md).[`resizeToFitWithin`](Node.md#resizetofitwithin) - -#### See - -resizeToCover - ---- - ### setPositionInParent() • **setPositionInParent**(`parentPoint`, `localRegistrationPoint`): `void` From 91863cf61b9ed84fdeabf172204b3664d6efb63a Mon Sep 17 00:00:00 2001 From: Rekha M Date: Wed, 14 Jan 2026 20:05:34 +0530 Subject: [PATCH 2/2] Resize --- .../document-apis/classes/ComplexShapeNode.md | 24 ++++++++++ .../document-apis/classes/EllipseNode.md | 24 ++++++++++ .../document-apis/classes/FillableNode.md | 24 ++++++++++ .../document-apis/classes/GridCellNode.md | 26 +++++++++++ .../document-apis/classes/GridLayoutNode.md | 24 ++++++++++ .../document-apis/classes/GroupNode.md | 24 ++++++++++ .../classes/ImageRectangleNode.md | 24 ++++++++++ .../document-apis/classes/LineNode.md | 24 ++++++++++ .../classes/MediaContainerNode.md | 24 ++++++++++ .../classes/MediaRectangleNode.md | 24 ++++++++++ .../document-apis/classes/Node.md | 20 ++++++++ .../document-apis/classes/PathNode.md | 24 ++++++++++ .../document-apis/classes/RectangleNode.md | 24 ++++++++++ .../classes/SolidColorShapeNode.md | 24 ++++++++++ .../classes/StandaloneTextNode.md | 24 ++++++++++ .../document-apis/classes/StrokableNode.md | 24 ++++++++++ .../document-apis/classes/StrokeShapeNode.md | 24 ++++++++++ .../document-apis/classes/TextNode.md | 24 ++++++++++ .../document-apis/classes/ThreadedTextNode.md | 24 ++++++++++ .../classes/UnknownMediaRectangleNode.md | 24 ++++++++++ .../document-apis/classes/UnknownNode.md | 24 ++++++++++ .../enumerations/ResizeBehavior.md | 38 +++++++++++++++ .../interfaces/CommonResizeOptions.md | 25 ++++++++++ .../RescaleProportionalToHeightOptions.md | 46 +++++++++++++++++++ .../RescaleProportionalToWidthOptions.md | 46 +++++++++++++++++++ .../interfaces/ResizeUsingHeightOptions.md | 46 +++++++++++++++++++ .../interfaces/ResizeUsingWidthOptions.md | 46 +++++++++++++++++++ .../namespaces/Constants/overview.md | 6 +++ .../document-apis/overview.md | 7 +++ .../type-aliases/ResizeOptions.md | 14 ++++++ 30 files changed, 776 insertions(+) create mode 100644 src/pages/references/document-sandbox/document-apis/enumerations/ResizeBehavior.md create mode 100644 src/pages/references/document-sandbox/document-apis/interfaces/CommonResizeOptions.md create mode 100644 src/pages/references/document-sandbox/document-apis/interfaces/RescaleProportionalToHeightOptions.md create mode 100644 src/pages/references/document-sandbox/document-apis/interfaces/RescaleProportionalToWidthOptions.md create mode 100644 src/pages/references/document-sandbox/document-apis/interfaces/ResizeUsingHeightOptions.md create mode 100644 src/pages/references/document-sandbox/document-apis/interfaces/ResizeUsingWidthOptions.md create mode 100644 src/pages/references/document-sandbox/document-apis/type-aliases/ResizeOptions.md diff --git a/src/pages/references/document-sandbox/document-apis/classes/ComplexShapeNode.md b/src/pages/references/document-sandbox/document-apis/classes/ComplexShapeNode.md index 21e1fb6c1..e41570191 100644 --- a/src/pages/references/document-sandbox/document-apis/classes/ComplexShapeNode.md +++ b/src/pages/references/document-sandbox/document-apis/classes/ComplexShapeNode.md @@ -397,6 +397,30 @@ removal. No-op if node is already an orphan. --- +### resize() + +• **resize**(`options`): `void` + + + +**IMPORTANT:** This is currently ***experimental only*** and should not be used in any add-ons you will be distributing until it has been declared stable. To use it, you will first need to set the `experimentalApis` flag to `true` in the [`requirements`](../../../manifest/index.md#requirements) section of the `manifest.json`. + +Resizes this node based on the given [ResizeOptions](../type-aliases/ResizeOptions.md). + +#### Parameters + +• **options**: [`ResizeOptions`](../type-aliases/ResizeOptions.md) + +#### Returns + +`void` + +#### Inherited from + +[`FillableNode`](FillableNode.md).[`resize`](FillableNode.md#resize) + +--- + ### setPositionInParent() • **setPositionInParent**(`parentPoint`, `localRegistrationPoint`): `void` diff --git a/src/pages/references/document-sandbox/document-apis/classes/EllipseNode.md b/src/pages/references/document-sandbox/document-apis/classes/EllipseNode.md index 437e075a2..43b6f2441 100644 --- a/src/pages/references/document-sandbox/document-apis/classes/EllipseNode.md +++ b/src/pages/references/document-sandbox/document-apis/classes/EllipseNode.md @@ -440,6 +440,30 @@ removal. No-op if node is already an orphan. --- +### resize() + +• **resize**(`options`): `void` + + + +**IMPORTANT:** This is currently ***experimental only*** and should not be used in any add-ons you will be distributing until it has been declared stable. To use it, you will first need to set the `experimentalApis` flag to `true` in the [`requirements`](../../../manifest/index.md#requirements) section of the `manifest.json`. + +Resizes this node based on the given [ResizeOptions](../type-aliases/ResizeOptions.md). + +#### Parameters + +• **options**: [`ResizeOptions`](../type-aliases/ResizeOptions.md) + +#### Returns + +`void` + +#### Inherited from + +[`FillableNode`](FillableNode.md).[`resize`](FillableNode.md#resize) + +--- + ### setPositionInParent() • **setPositionInParent**(`parentPoint`, `localRegistrationPoint`): `void` diff --git a/src/pages/references/document-sandbox/document-apis/classes/FillableNode.md b/src/pages/references/document-sandbox/document-apis/classes/FillableNode.md index d0ad7caed..b80daa27b 100644 --- a/src/pages/references/document-sandbox/document-apis/classes/FillableNode.md +++ b/src/pages/references/document-sandbox/document-apis/classes/FillableNode.md @@ -407,6 +407,30 @@ removal. No-op if node is already an orphan. --- +### resize() + +• **resize**(`options`): `void` + + + +**IMPORTANT:** This is currently ***experimental only*** and should not be used in any add-ons you will be distributing until it has been declared stable. To use it, you will first need to set the `experimentalApis` flag to `true` in the [`requirements`](../../../manifest/index.md#requirements) section of the `manifest.json`. + +Resizes this node based on the given [ResizeOptions](../type-aliases/ResizeOptions.md). + +#### Parameters + +• **options**: [`ResizeOptions`](../type-aliases/ResizeOptions.md) + +#### Returns + +`void` + +#### Inherited from + +[`StrokableNode`](StrokableNode.md).[`resize`](StrokableNode.md#resize) + +--- + ### setPositionInParent() • **setPositionInParent**(`parentPoint`, `localRegistrationPoint`): `void` diff --git a/src/pages/references/document-sandbox/document-apis/classes/GridCellNode.md b/src/pages/references/document-sandbox/document-apis/classes/GridCellNode.md index 3c991faa0..885f71e23 100644 --- a/src/pages/references/document-sandbox/document-apis/classes/GridCellNode.md +++ b/src/pages/references/document-sandbox/document-apis/classes/GridCellNode.md @@ -413,6 +413,32 @@ New content to display. Currently must be a [BitmapImage](BitmapImage.md). --- +### resize() + +• **resize**(`options`): `void` + + + +**IMPORTANT:** This is currently ***experimental only*** and should not be used in any add-ons you will be distributing until it has been declared stable. To use it, you will first need to set the `experimentalApis` flag to `true` in the [`requirements`](../../../manifest/index.md#requirements) section of the `manifest.json`. + +Proxy resizing of the MediaRectangleNode *inside* this grid cell. The enclosing grid layout keeps +the crop window (and thus the overall GridCellNode/MediaContainerNode bounds) fixed in position. +*Warning:* This will not change the bounds reported by this GridCellNode itself. + +#### Parameters + +• **options**: [`ResizeOptions`](../type-aliases/ResizeOptions.md) + +#### Returns + +`void` + +#### Overrides + +[`Node`](Node.md).[`resize`](Node.md#resize) + +--- + ### setPositionInParent() • **setPositionInParent**(`parentPoint`, `localRegistrationPoint`): `void` diff --git a/src/pages/references/document-sandbox/document-apis/classes/GridLayoutNode.md b/src/pages/references/document-sandbox/document-apis/classes/GridLayoutNode.md index 34ab87706..ffac4616b 100644 --- a/src/pages/references/document-sandbox/document-apis/classes/GridLayoutNode.md +++ b/src/pages/references/document-sandbox/document-apis/classes/GridLayoutNode.md @@ -417,6 +417,30 @@ removal. No-op if node is already an orphan. --- +### resize() + +• **resize**(`options`): `void` + + + +**IMPORTANT:** This is currently ***experimental only*** and should not be used in any add-ons you will be distributing until it has been declared stable. To use it, you will first need to set the `experimentalApis` flag to `true` in the [`requirements`](../../../manifest/index.md#requirements) section of the `manifest.json`. + +Resizes this node based on the given [ResizeOptions](../type-aliases/ResizeOptions.md). + +#### Parameters + +• **options**: [`ResizeOptions`](../type-aliases/ResizeOptions.md) + +#### Returns + +`void` + +#### Inherited from + +[`Node`](Node.md).[`resize`](Node.md#resize) + +--- + ### setPositionInParent() • **setPositionInParent**(`parentPoint`, `localRegistrationPoint`): `void` diff --git a/src/pages/references/document-sandbox/document-apis/classes/GroupNode.md b/src/pages/references/document-sandbox/document-apis/classes/GroupNode.md index b271e916b..b29bcc591 100644 --- a/src/pages/references/document-sandbox/document-apis/classes/GroupNode.md +++ b/src/pages/references/document-sandbox/document-apis/classes/GroupNode.md @@ -419,6 +419,30 @@ removal. No-op if node is already an orphan. --- +### resize() + +• **resize**(`options`): `void` + + + +**IMPORTANT:** This is currently ***experimental only*** and should not be used in any add-ons you will be distributing until it has been declared stable. To use it, you will first need to set the `experimentalApis` flag to `true` in the [`requirements`](../../../manifest/index.md#requirements) section of the `manifest.json`. + +Resizes this node based on the given [ResizeOptions](../type-aliases/ResizeOptions.md). + +#### Parameters + +• **options**: [`ResizeOptions`](../type-aliases/ResizeOptions.md) + +#### Returns + +`void` + +#### Inherited from + +[`Node`](Node.md).[`resize`](Node.md#resize) + +--- + ### setPositionInParent() • **setPositionInParent**(`parentPoint`, `localRegistrationPoint`): `void` diff --git a/src/pages/references/document-sandbox/document-apis/classes/ImageRectangleNode.md b/src/pages/references/document-sandbox/document-apis/classes/ImageRectangleNode.md index 36eb86de4..1d16c0019 100644 --- a/src/pages/references/document-sandbox/document-apis/classes/ImageRectangleNode.md +++ b/src/pages/references/document-sandbox/document-apis/classes/ImageRectangleNode.md @@ -439,6 +439,30 @@ removal. No-op if node is already an orphan. --- +### resize() + +• **resize**(`options`): `void` + + + +**IMPORTANT:** This is currently ***experimental only*** and should not be used in any add-ons you will be distributing until it has been declared stable. To use it, you will first need to set the `experimentalApis` flag to `true` in the [`requirements`](../../../manifest/index.md#requirements) section of the `manifest.json`. + +Resizes this node based on the given [ResizeOptions](../type-aliases/ResizeOptions.md). + +#### Parameters + +• **options**: [`ResizeOptions`](../type-aliases/ResizeOptions.md) + +#### Returns + +`void` + +#### Inherited from + +[`MediaRectangleNode`](MediaRectangleNode.md).[`resize`](MediaRectangleNode.md#resize) + +--- + ### setPositionInParent() • **setPositionInParent**(`parentPoint`, `localRegistrationPoint`): `void` diff --git a/src/pages/references/document-sandbox/document-apis/classes/LineNode.md b/src/pages/references/document-sandbox/document-apis/classes/LineNode.md index 875809226..8f77cb436 100644 --- a/src/pages/references/document-sandbox/document-apis/classes/LineNode.md +++ b/src/pages/references/document-sandbox/document-apis/classes/LineNode.md @@ -506,6 +506,30 @@ removal. No-op if node is already an orphan. --- +### resize() + +• **resize**(`options`): `void` + + + +**IMPORTANT:** This is currently ***experimental only*** and should not be used in any add-ons you will be distributing until it has been declared stable. To use it, you will first need to set the `experimentalApis` flag to `true` in the [`requirements`](../../../manifest/index.md#requirements) section of the `manifest.json`. + +Resizes this node based on the given [ResizeOptions](../type-aliases/ResizeOptions.md). + +#### Parameters + +• **options**: [`ResizeOptions`](../type-aliases/ResizeOptions.md) + +#### Returns + +`void` + +#### Inherited from + +[`StrokableNode`](StrokableNode.md).[`resize`](StrokableNode.md#resize) + +--- + ### setEndPoints() • **setEndPoints**(`startX`, `startY`, `endX`, `endY`): `void` diff --git a/src/pages/references/document-sandbox/document-apis/classes/MediaContainerNode.md b/src/pages/references/document-sandbox/document-apis/classes/MediaContainerNode.md index d55500959..1fda3eb61 100644 --- a/src/pages/references/document-sandbox/document-apis/classes/MediaContainerNode.md +++ b/src/pages/references/document-sandbox/document-apis/classes/MediaContainerNode.md @@ -419,6 +419,30 @@ New content to display. Currently must be a [BitmapImage](BitmapImage.md). --- +### resize() + +• **resize**(`options`): `void` + + + +**IMPORTANT:** This is currently ***experimental only*** and should not be used in any add-ons you will be distributing until it has been declared stable. To use it, you will first need to set the `experimentalApis` flag to `true` in the [`requirements`](../../../manifest/index.md#requirements) section of the `manifest.json`. + +Resizes this node based on the given [ResizeOptions](../type-aliases/ResizeOptions.md). + +#### Parameters + +• **options**: [`ResizeOptions`](../type-aliases/ResizeOptions.md) + +#### Returns + +`void` + +#### Inherited from + +[`Node`](Node.md).[`resize`](Node.md#resize) + +--- + ### setPositionInParent() • **setPositionInParent**(`parentPoint`, `localRegistrationPoint`): `void` diff --git a/src/pages/references/document-sandbox/document-apis/classes/MediaRectangleNode.md b/src/pages/references/document-sandbox/document-apis/classes/MediaRectangleNode.md index d3239b9cd..2faeb3b58 100644 --- a/src/pages/references/document-sandbox/document-apis/classes/MediaRectangleNode.md +++ b/src/pages/references/document-sandbox/document-apis/classes/MediaRectangleNode.md @@ -414,6 +414,30 @@ removal. No-op if node is already an orphan. --- +### resize() + +• **resize**(`options`): `void` + + + +**IMPORTANT:** This is currently ***experimental only*** and should not be used in any add-ons you will be distributing until it has been declared stable. To use it, you will first need to set the `experimentalApis` flag to `true` in the [`requirements`](../../../manifest/index.md#requirements) section of the `manifest.json`. + +Resizes this node based on the given [ResizeOptions](../type-aliases/ResizeOptions.md). + +#### Parameters + +• **options**: [`ResizeOptions`](../type-aliases/ResizeOptions.md) + +#### Returns + +`void` + +#### Inherited from + +[`Node`](Node.md).[`resize`](Node.md#resize) + +--- + ### setPositionInParent() • **setPositionInParent**(`parentPoint`, `localRegistrationPoint`): `void` diff --git a/src/pages/references/document-sandbox/document-apis/classes/Node.md b/src/pages/references/document-sandbox/document-apis/classes/Node.md index a8139426c..19a6b00da 100644 --- a/src/pages/references/document-sandbox/document-apis/classes/Node.md +++ b/src/pages/references/document-sandbox/document-apis/classes/Node.md @@ -379,6 +379,26 @@ removal. No-op if node is already an orphan. --- +### resize() + +• **resize**(`options`): `void` + + + +**IMPORTANT:** This is currently ***experimental only*** and should not be used in any add-ons you will be distributing until it has been declared stable. To use it, you will first need to set the `experimentalApis` flag to `true` in the [`requirements`](../../../manifest/index.md#requirements) section of the `manifest.json`. + +Resizes this node based on the given [ResizeOptions](../type-aliases/ResizeOptions.md). + +#### Parameters + +• **options**: [`ResizeOptions`](../type-aliases/ResizeOptions.md) + +#### Returns + +`void` + +--- + ### setPositionInParent() • **setPositionInParent**(`parentPoint`, `localRegistrationPoint`): `void` diff --git a/src/pages/references/document-sandbox/document-apis/classes/PathNode.md b/src/pages/references/document-sandbox/document-apis/classes/PathNode.md index c355d6d89..396a6dd19 100644 --- a/src/pages/references/document-sandbox/document-apis/classes/PathNode.md +++ b/src/pages/references/document-sandbox/document-apis/classes/PathNode.md @@ -437,6 +437,30 @@ removal. No-op if node is already an orphan. --- +### resize() + +• **resize**(`options`): `void` + + + +**IMPORTANT:** This is currently ***experimental only*** and should not be used in any add-ons you will be distributing until it has been declared stable. To use it, you will first need to set the `experimentalApis` flag to `true` in the [`requirements`](../../../manifest/index.md#requirements) section of the `manifest.json`. + +Resizes this node based on the given [ResizeOptions](../type-aliases/ResizeOptions.md). + +#### Parameters + +• **options**: [`ResizeOptions`](../type-aliases/ResizeOptions.md) + +#### Returns + +`void` + +#### Inherited from + +[`FillableNode`](FillableNode.md).[`resize`](FillableNode.md#resize) + +--- + ### setPositionInParent() • **setPositionInParent**(`parentPoint`, `localRegistrationPoint`): `void` diff --git a/src/pages/references/document-sandbox/document-apis/classes/RectangleNode.md b/src/pages/references/document-sandbox/document-apis/classes/RectangleNode.md index e7239ae56..a0bdd83da 100644 --- a/src/pages/references/document-sandbox/document-apis/classes/RectangleNode.md +++ b/src/pages/references/document-sandbox/document-apis/classes/RectangleNode.md @@ -545,6 +545,30 @@ removal. No-op if node is already an orphan. --- +### resize() + +• **resize**(`options`): `void` + + + +**IMPORTANT:** This is currently ***experimental only*** and should not be used in any add-ons you will be distributing until it has been declared stable. To use it, you will first need to set the `experimentalApis` flag to `true` in the [`requirements`](../../../manifest/index.md#requirements) section of the `manifest.json`. + +Resizes this node based on the given [ResizeOptions](../type-aliases/ResizeOptions.md). + +#### Parameters + +• **options**: [`ResizeOptions`](../type-aliases/ResizeOptions.md) + +#### Returns + +`void` + +#### Inherited from + +[`FillableNode`](FillableNode.md).[`resize`](FillableNode.md#resize) + +--- + ### setPositionInParent() • **setPositionInParent**(`parentPoint`, `localRegistrationPoint`): `void` diff --git a/src/pages/references/document-sandbox/document-apis/classes/SolidColorShapeNode.md b/src/pages/references/document-sandbox/document-apis/classes/SolidColorShapeNode.md index a2f3f5ad1..f6414eb1d 100644 --- a/src/pages/references/document-sandbox/document-apis/classes/SolidColorShapeNode.md +++ b/src/pages/references/document-sandbox/document-apis/classes/SolidColorShapeNode.md @@ -377,6 +377,30 @@ removal. No-op if node is already an orphan. --- +### resize() + +• **resize**(`options`): `void` + + + +**IMPORTANT:** This is currently ***experimental only*** and should not be used in any add-ons you will be distributing until it has been declared stable. To use it, you will first need to set the `experimentalApis` flag to `true` in the [`requirements`](../../../manifest/index.md#requirements) section of the `manifest.json`. + +Resizes this node based on the given [ResizeOptions](../type-aliases/ResizeOptions.md). + +#### Parameters + +• **options**: [`ResizeOptions`](../type-aliases/ResizeOptions.md) + +#### Returns + +`void` + +#### Inherited from + +[`Node`](Node.md).[`resize`](Node.md#resize) + +--- + ### setPositionInParent() • **setPositionInParent**(`parentPoint`, `localRegistrationPoint`): `void` diff --git a/src/pages/references/document-sandbox/document-apis/classes/StandaloneTextNode.md b/src/pages/references/document-sandbox/document-apis/classes/StandaloneTextNode.md index 0d1117b5a..828423035 100644 --- a/src/pages/references/document-sandbox/document-apis/classes/StandaloneTextNode.md +++ b/src/pages/references/document-sandbox/document-apis/classes/StandaloneTextNode.md @@ -545,6 +545,30 @@ removal. No-op if node is already an orphan. --- +### resize() + +• **resize**(`options`): `void` + + + +**IMPORTANT:** This is currently ***experimental only*** and should not be used in any add-ons you will be distributing until it has been declared stable. To use it, you will first need to set the `experimentalApis` flag to `true` in the [`requirements`](../../../manifest/index.md#requirements) section of the `manifest.json`. + +Resizes this node based on the given [ResizeOptions](../type-aliases/ResizeOptions.md). + +#### Parameters + +• **options**: [`ResizeOptions`](../type-aliases/ResizeOptions.md) + +#### Returns + +`void` + +#### Inherited from + +[`TextNode`](TextNode.md).[`resize`](TextNode.md#resize) + +--- + ### setPositionInParent() • **setPositionInParent**(`parentPoint`, `localRegistrationPoint`): `void` diff --git a/src/pages/references/document-sandbox/document-apis/classes/StrokableNode.md b/src/pages/references/document-sandbox/document-apis/classes/StrokableNode.md index 3df2f7161..6f41a6942 100644 --- a/src/pages/references/document-sandbox/document-apis/classes/StrokableNode.md +++ b/src/pages/references/document-sandbox/document-apis/classes/StrokableNode.md @@ -388,6 +388,30 @@ removal. No-op if node is already an orphan. --- +### resize() + +• **resize**(`options`): `void` + + + +**IMPORTANT:** This is currently ***experimental only*** and should not be used in any add-ons you will be distributing until it has been declared stable. To use it, you will first need to set the `experimentalApis` flag to `true` in the [`requirements`](../../../manifest/index.md#requirements) section of the `manifest.json`. + +Resizes this node based on the given [ResizeOptions](../type-aliases/ResizeOptions.md). + +#### Parameters + +• **options**: [`ResizeOptions`](../type-aliases/ResizeOptions.md) + +#### Returns + +`void` + +#### Inherited from + +[`Node`](Node.md).[`resize`](Node.md#resize) + +--- + ### setPositionInParent() • **setPositionInParent**(`parentPoint`, `localRegistrationPoint`): `void` diff --git a/src/pages/references/document-sandbox/document-apis/classes/StrokeShapeNode.md b/src/pages/references/document-sandbox/document-apis/classes/StrokeShapeNode.md index d1efca38a..192078afd 100644 --- a/src/pages/references/document-sandbox/document-apis/classes/StrokeShapeNode.md +++ b/src/pages/references/document-sandbox/document-apis/classes/StrokeShapeNode.md @@ -379,6 +379,30 @@ removal. No-op if node is already an orphan. --- +### resize() + +• **resize**(`options`): `void` + + + +**IMPORTANT:** This is currently ***experimental only*** and should not be used in any add-ons you will be distributing until it has been declared stable. To use it, you will first need to set the `experimentalApis` flag to `true` in the [`requirements`](../../../manifest/index.md#requirements) section of the `manifest.json`. + +Resizes this node based on the given [ResizeOptions](../type-aliases/ResizeOptions.md). + +#### Parameters + +• **options**: [`ResizeOptions`](../type-aliases/ResizeOptions.md) + +#### Returns + +`void` + +#### Inherited from + +[`StrokableNode`](StrokableNode.md).[`resize`](StrokableNode.md#resize) + +--- + ### setPositionInParent() • **setPositionInParent**(`parentPoint`, `localRegistrationPoint`): `void` diff --git a/src/pages/references/document-sandbox/document-apis/classes/TextNode.md b/src/pages/references/document-sandbox/document-apis/classes/TextNode.md index c651e303d..b25a1bf8e 100644 --- a/src/pages/references/document-sandbox/document-apis/classes/TextNode.md +++ b/src/pages/references/document-sandbox/document-apis/classes/TextNode.md @@ -532,6 +532,30 @@ removal. No-op if node is already an orphan. --- +### resize() + +• **resize**(`options`): `void` + + + +**IMPORTANT:** This is currently ***experimental only*** and should not be used in any add-ons you will be distributing until it has been declared stable. To use it, you will first need to set the `experimentalApis` flag to `true` in the [`requirements`](../../../manifest/index.md#requirements) section of the `manifest.json`. + +Resizes this node based on the given [ResizeOptions](../type-aliases/ResizeOptions.md). + +#### Parameters + +• **options**: [`ResizeOptions`](../type-aliases/ResizeOptions.md) + +#### Returns + +`void` + +#### Inherited from + +[`Node`](Node.md).[`resize`](Node.md#resize) + +--- + ### setPositionInParent() • **setPositionInParent**(`parentPoint`, `localRegistrationPoint`): `void` diff --git a/src/pages/references/document-sandbox/document-apis/classes/ThreadedTextNode.md b/src/pages/references/document-sandbox/document-apis/classes/ThreadedTextNode.md index 3e2600815..fb52fca54 100644 --- a/src/pages/references/document-sandbox/document-apis/classes/ThreadedTextNode.md +++ b/src/pages/references/document-sandbox/document-apis/classes/ThreadedTextNode.md @@ -541,6 +541,30 @@ removal. No-op if node is already an orphan. --- +### resize() + +• **resize**(`options`): `void` + + + +**IMPORTANT:** This is currently ***experimental only*** and should not be used in any add-ons you will be distributing until it has been declared stable. To use it, you will first need to set the `experimentalApis` flag to `true` in the [`requirements`](../../../manifest/index.md#requirements) section of the `manifest.json`. + +Resizes this node based on the given [ResizeOptions](../type-aliases/ResizeOptions.md). + +#### Parameters + +• **options**: [`ResizeOptions`](../type-aliases/ResizeOptions.md) + +#### Returns + +`void` + +#### Inherited from + +[`TextNode`](TextNode.md).[`resize`](TextNode.md#resize) + +--- + ### setPositionInParent() • **setPositionInParent**(`parentPoint`, `localRegistrationPoint`): `void` diff --git a/src/pages/references/document-sandbox/document-apis/classes/UnknownMediaRectangleNode.md b/src/pages/references/document-sandbox/document-apis/classes/UnknownMediaRectangleNode.md index 39ba19120..39cf0c49d 100644 --- a/src/pages/references/document-sandbox/document-apis/classes/UnknownMediaRectangleNode.md +++ b/src/pages/references/document-sandbox/document-apis/classes/UnknownMediaRectangleNode.md @@ -404,6 +404,30 @@ removal. No-op if node is already an orphan. --- +### resize() + +• **resize**(`options`): `void` + + + +**IMPORTANT:** This is currently ***experimental only*** and should not be used in any add-ons you will be distributing until it has been declared stable. To use it, you will first need to set the `experimentalApis` flag to `true` in the [`requirements`](../../../manifest/index.md#requirements) section of the `manifest.json`. + +Resizes this node based on the given [ResizeOptions](../type-aliases/ResizeOptions.md). + +#### Parameters + +• **options**: [`ResizeOptions`](../type-aliases/ResizeOptions.md) + +#### Returns + +`void` + +#### Inherited from + +[`MediaRectangleNode`](MediaRectangleNode.md).[`resize`](MediaRectangleNode.md#resize) + +--- + ### setPositionInParent() • **setPositionInParent**(`parentPoint`, `localRegistrationPoint`): `void` diff --git a/src/pages/references/document-sandbox/document-apis/classes/UnknownNode.md b/src/pages/references/document-sandbox/document-apis/classes/UnknownNode.md index affd4e86c..3f401d042 100644 --- a/src/pages/references/document-sandbox/document-apis/classes/UnknownNode.md +++ b/src/pages/references/document-sandbox/document-apis/classes/UnknownNode.md @@ -358,6 +358,30 @@ removal. No-op if node is already an orphan. --- +### resize() + +• **resize**(`options`): `void` + + + +**IMPORTANT:** This is currently ***experimental only*** and should not be used in any add-ons you will be distributing until it has been declared stable. To use it, you will first need to set the `experimentalApis` flag to `true` in the [`requirements`](../../../manifest/index.md#requirements) section of the `manifest.json`. + +Resizes this node based on the given [ResizeOptions](../type-aliases/ResizeOptions.md). + +#### Parameters + +• **options**: [`ResizeOptions`](../type-aliases/ResizeOptions.md) + +#### Returns + +`void` + +#### Inherited from + +[`Node`](Node.md).[`resize`](Node.md#resize) + +--- + ### setPositionInParent() • **setPositionInParent**(`parentPoint`, `localRegistrationPoint`): `void` diff --git a/src/pages/references/document-sandbox/document-apis/enumerations/ResizeBehavior.md b/src/pages/references/document-sandbox/document-apis/enumerations/ResizeBehavior.md new file mode 100644 index 000000000..b37ce135c --- /dev/null +++ b/src/pages/references/document-sandbox/document-apis/enumerations/ResizeBehavior.md @@ -0,0 +1,38 @@ +[@express-document-sdk](../overview.md) / ResizeBehavior + +# Enumeration: ResizeBehavior + + + +**IMPORTANT:** This is currently ***experimental only*** and should not be used in any add-ons you will be distributing until it has been declared stable. To use it, you will first need to set the `experimentalApis` flag to `true` in the [`requirements`](../../../manifest/index.md#requirements) section of the `manifest.json`. + +An enum for controlling the behavior of [Node.resize](../classes/Node.md#resize). + +## Enumeration Members + +### contain + +• **contain**: `"contain"` + +Resizes the node to fit entirely *within* a box of the given dimensions, keeping its topLeftLocal +at a fixed location. Nodes with a fixed aspect ratio may leave unused space on one axis as a result, +but nodes with flexible aspect ratio will be resized to the exact box size specified. + +--- + +### cover + +• **cover**: `"cover"` + +Resizes the node to completely *cover* a box of the given dimensions, keeping its topLeftLocal +at a fixed location. Nodes with a fixed aspect ratio may extend outside the box on one axis as a result, +but nodes with flexible aspect ratio will be resized to the exact box size specified. + +--- + +### proportional + +• **proportional**: `"proportional"` + +Resizes the node to the given width or height while preserving its current aspect ratio, keeping its +topLeftLocal at a fixed location. diff --git a/src/pages/references/document-sandbox/document-apis/interfaces/CommonResizeOptions.md b/src/pages/references/document-sandbox/document-apis/interfaces/CommonResizeOptions.md new file mode 100644 index 000000000..565878335 --- /dev/null +++ b/src/pages/references/document-sandbox/document-apis/interfaces/CommonResizeOptions.md @@ -0,0 +1,25 @@ +[@express-document-sdk](../overview.md) / CommonResizeOptions + +# Interface: CommonResizeOptions + + + +**IMPORTANT:** This is currently ***experimental only*** and should not be used in any add-ons you will be distributing until it has been declared stable. To use it, you will first need to set the `experimentalApis` flag to `true` in the [`requirements`](../../../manifest/index.md#requirements) section of the `manifest.json`. + +An interface for arbitrary resize operations regardless of whether given a width or height when using [Node.resize](../classes/Node.md#resize). + +## Extended by + +- [`RescaleProportionalToWidthOptions`](RescaleProportionalToWidthOptions.md) +- [`RescaleProportionalToHeightOptions`](RescaleProportionalToHeightOptions.md) +- [`ResizeUsingWidthOptions`](ResizeUsingWidthOptions.md) +- [`ResizeUsingHeightOptions`](ResizeUsingHeightOptions.md) + +## Properties + +### avoidScalingVisualDetailsIfPossible + +• **avoidScalingVisualDetailsIfPossible**: `boolean` + +Whether to try to avoid scaling the content's visual styling (e.g. stroke width, corner detailing, etc.). +Note that some kinds of content may not be able to avoid rescaling in some scenarios. diff --git a/src/pages/references/document-sandbox/document-apis/interfaces/RescaleProportionalToHeightOptions.md b/src/pages/references/document-sandbox/document-apis/interfaces/RescaleProportionalToHeightOptions.md new file mode 100644 index 000000000..eb64bd4eb --- /dev/null +++ b/src/pages/references/document-sandbox/document-apis/interfaces/RescaleProportionalToHeightOptions.md @@ -0,0 +1,46 @@ +[@express-document-sdk](../overview.md) / RescaleProportionalToHeightOptions + +# Interface: RescaleProportionalToHeightOptions + + + +**IMPORTANT:** This is currently ***experimental only*** and should not be used in any add-ons you will be distributing until it has been declared stable. To use it, you will first need to set the `experimentalApis` flag to `true` in the [`requirements`](../../../manifest/index.md#requirements) section of the `manifest.json`. + +An interface for rescaling the node based on a given height when using [Node.resize](../classes/Node.md#resize). + +## Extends + +- [`CommonResizeOptions`](CommonResizeOptions.md) + +## Properties + +### avoidScalingVisualDetailsIfPossible + +• **avoidScalingVisualDetailsIfPossible**: `boolean` + +Whether to try to avoid scaling the content's visual styling (e.g. stroke width, corner detailing, etc.). +Note that some kinds of content may not be able to avoid rescaling in some scenarios. + +#### Inherited from + +[`CommonResizeOptions`](CommonResizeOptions.md).[`avoidScalingVisualDetailsIfPossible`](CommonResizeOptions.md#avoidscalingvisualdetailsifpossible) + +--- + +### behavior + +• **behavior**: [`proportional`](../enumerations/ResizeBehavior.md#proportional) + +--- + +### height + +• **height**: `number` + +--- + +### width? + +• `optional` **width**: `undefined` + +Instead of providing a width, it will be calculated by multiplying the given height by the current aspect ratio. diff --git a/src/pages/references/document-sandbox/document-apis/interfaces/RescaleProportionalToWidthOptions.md b/src/pages/references/document-sandbox/document-apis/interfaces/RescaleProportionalToWidthOptions.md new file mode 100644 index 000000000..b24bb5f91 --- /dev/null +++ b/src/pages/references/document-sandbox/document-apis/interfaces/RescaleProportionalToWidthOptions.md @@ -0,0 +1,46 @@ +[@express-document-sdk](../overview.md) / RescaleProportionalToWidthOptions + +# Interface: RescaleProportionalToWidthOptions + + + +**IMPORTANT:** This is currently ***experimental only*** and should not be used in any add-ons you will be distributing until it has been declared stable. To use it, you will first need to set the `experimentalApis` flag to `true` in the [`requirements`](../../../manifest/index.md#requirements) section of the `manifest.json`. + +An interface for rescaling the node based on a given width when using [Node.resize](../classes/Node.md#resize). + +## Extends + +- [`CommonResizeOptions`](CommonResizeOptions.md) + +## Properties + +### avoidScalingVisualDetailsIfPossible + +• **avoidScalingVisualDetailsIfPossible**: `boolean` + +Whether to try to avoid scaling the content's visual styling (e.g. stroke width, corner detailing, etc.). +Note that some kinds of content may not be able to avoid rescaling in some scenarios. + +#### Inherited from + +[`CommonResizeOptions`](CommonResizeOptions.md).[`avoidScalingVisualDetailsIfPossible`](CommonResizeOptions.md#avoidscalingvisualdetailsifpossible) + +--- + +### behavior + +• **behavior**: [`proportional`](../enumerations/ResizeBehavior.md#proportional) + +--- + +### height? + +• `optional` **height**: `undefined` + +Instead of providing a height, it will be calculated by multiplying the given width by the current aspect ratio. + +--- + +### width + +• **width**: `number` diff --git a/src/pages/references/document-sandbox/document-apis/interfaces/ResizeUsingHeightOptions.md b/src/pages/references/document-sandbox/document-apis/interfaces/ResizeUsingHeightOptions.md new file mode 100644 index 000000000..81d406069 --- /dev/null +++ b/src/pages/references/document-sandbox/document-apis/interfaces/ResizeUsingHeightOptions.md @@ -0,0 +1,46 @@ +[@express-document-sdk](../overview.md) / ResizeUsingHeightOptions + +# Interface: ResizeUsingHeightOptions + + + +**IMPORTANT:** This is currently ***experimental only*** and should not be used in any add-ons you will be distributing until it has been declared stable. To use it, you will first need to set the `experimentalApis` flag to `true` in the [`requirements`](../../../manifest/index.md#requirements) section of the `manifest.json`. + +An interface for resizing the node based on a given height when using [Node.resize](../classes/Node.md#resize). + +## Extends + +- [`CommonResizeOptions`](CommonResizeOptions.md) + +## Properties + +### avoidScalingVisualDetailsIfPossible + +• **avoidScalingVisualDetailsIfPossible**: `boolean` + +Whether to try to avoid scaling the content's visual styling (e.g. stroke width, corner detailing, etc.). +Note that some kinds of content may not be able to avoid rescaling in some scenarios. + +#### Inherited from + +[`CommonResizeOptions`](CommonResizeOptions.md).[`avoidScalingVisualDetailsIfPossible`](CommonResizeOptions.md#avoidscalingvisualdetailsifpossible) + +--- + +### behavior + +• **behavior**: [`contain`](../enumerations/ResizeBehavior.md#contain) \| [`cover`](../enumerations/ResizeBehavior.md#cover) + +--- + +### height + +• **height**: `number` + +--- + +### width? + +• `optional` **width**: `number` + +If a width is not provided, it will be calculated by multiplying the given height by the current aspect ratio. diff --git a/src/pages/references/document-sandbox/document-apis/interfaces/ResizeUsingWidthOptions.md b/src/pages/references/document-sandbox/document-apis/interfaces/ResizeUsingWidthOptions.md new file mode 100644 index 000000000..6eaaae1df --- /dev/null +++ b/src/pages/references/document-sandbox/document-apis/interfaces/ResizeUsingWidthOptions.md @@ -0,0 +1,46 @@ +[@express-document-sdk](../overview.md) / ResizeUsingWidthOptions + +# Interface: ResizeUsingWidthOptions + + + +**IMPORTANT:** This is currently ***experimental only*** and should not be used in any add-ons you will be distributing until it has been declared stable. To use it, you will first need to set the `experimentalApis` flag to `true` in the [`requirements`](../../../manifest/index.md#requirements) section of the `manifest.json`. + +An interface for resizing the node based on a given width when using [Node.resize](../classes/Node.md#resize). + +## Extends + +- [`CommonResizeOptions`](CommonResizeOptions.md) + +## Properties + +### avoidScalingVisualDetailsIfPossible + +• **avoidScalingVisualDetailsIfPossible**: `boolean` + +Whether to try to avoid scaling the content's visual styling (e.g. stroke width, corner detailing, etc.). +Note that some kinds of content may not be able to avoid rescaling in some scenarios. + +#### Inherited from + +[`CommonResizeOptions`](CommonResizeOptions.md).[`avoidScalingVisualDetailsIfPossible`](CommonResizeOptions.md#avoidscalingvisualdetailsifpossible) + +--- + +### behavior + +• **behavior**: [`contain`](../enumerations/ResizeBehavior.md#contain) \| [`cover`](../enumerations/ResizeBehavior.md#cover) + +--- + +### height? + +• `optional` **height**: `number` + +If a height is not provided, it will be calculated by multiplying the given width by the current aspect ratio. + +--- + +### width + +• **width**: `number` diff --git a/src/pages/references/document-sandbox/document-apis/namespaces/Constants/overview.md b/src/pages/references/document-sandbox/document-apis/namespaces/Constants/overview.md index 5c5e75b45..bf49f32c4 100644 --- a/src/pages/references/document-sandbox/document-apis/namespaces/Constants/overview.md +++ b/src/pages/references/document-sandbox/document-apis/namespaces/Constants/overview.md @@ -46,6 +46,12 @@ Re-exports [FillType](../../enumerations/FillType.md) --- +### ResizeBehavior + +Re-exports [ResizeBehavior](../../enumerations/ResizeBehavior.md) + +--- + ### SceneNodeType Re-exports [SceneNodeType](../../enumerations/SceneNodeType.md) diff --git a/src/pages/references/document-sandbox/document-apis/overview.md b/src/pages/references/document-sandbox/document-apis/overview.md index 2798ee4c4..2a44a6bdd 100644 --- a/src/pages/references/document-sandbox/document-apis/overview.md +++ b/src/pages/references/document-sandbox/document-apis/overview.md @@ -11,6 +11,7 @@ - [EditorEvent](enumerations/EditorEvent.md) - [FillRule](enumerations/FillRule.md) - [FillType](enumerations/FillType.md) +- [ResizeBehavior](enumerations/ResizeBehavior.md) - [SceneNodeType](enumerations/SceneNodeType.md) - [StrokePosition](enumerations/StrokePosition.md) - [StrokeType](enumerations/StrokeType.md) @@ -82,6 +83,7 @@ - [CharacterStylesRangeInput](interfaces/CharacterStylesRangeInput.md) - [Color](interfaces/Color.md) - [ColorFill](interfaces/ColorFill.md) +- [CommonResizeOptions](interfaces/CommonResizeOptions.md) - [ContainerNode](interfaces/ContainerNode.md) - [Fill](interfaces/Fill.md) - [IFillableNode](interfaces/IFillableNode.md) @@ -100,6 +102,10 @@ - [Rect](interfaces/Rect.md) - [RectangleGeometry](interfaces/RectangleGeometry.md) - [RemoveListStyleInput](interfaces/RemoveListStyleInput.md) +- [RescaleProportionalToHeightOptions](interfaces/RescaleProportionalToHeightOptions.md) +- [RescaleProportionalToWidthOptions](interfaces/RescaleProportionalToWidthOptions.md) +- [ResizeUsingHeightOptions](interfaces/ResizeUsingHeightOptions.md) +- [ResizeUsingWidthOptions](interfaces/ResizeUsingWidthOptions.md) - [SolidColorStroke](interfaces/SolidColorStroke.md) - [Stroke](interfaces/Stroke.md) - [StyleRange](interfaces/StyleRange.md) @@ -114,6 +120,7 @@ - [Font](type-aliases/Font.md) - [ListStyleInput](type-aliases/ListStyleInput.md) - [OrderedListStyle](type-aliases/OrderedListStyle.md) +- [ResizeOptions](type-aliases/ResizeOptions.md) - [SolidColorStrokeWithOptionalType](type-aliases/SolidColorStrokeWithOptionalType.md) - [UnorderedListStyle](type-aliases/UnorderedListStyle.md) diff --git a/src/pages/references/document-sandbox/document-apis/type-aliases/ResizeOptions.md b/src/pages/references/document-sandbox/document-apis/type-aliases/ResizeOptions.md new file mode 100644 index 000000000..b09b3f354 --- /dev/null +++ b/src/pages/references/document-sandbox/document-apis/type-aliases/ResizeOptions.md @@ -0,0 +1,14 @@ +[@express-document-sdk](../overview.md) / ResizeOptions + +# Type alias: ResizeOptions + +• **ResizeOptions**: [`RescaleProportionalToWidthOptions`](../interfaces/RescaleProportionalToWidthOptions.md) \| [`RescaleProportionalToHeightOptions`](../interfaces/RescaleProportionalToHeightOptions.md) \| [`ResizeUsingWidthOptions`](../interfaces/ResizeUsingWidthOptions.md) \| [`ResizeUsingHeightOptions`](../interfaces/ResizeUsingHeightOptions.md) + + + +**IMPORTANT:** This is currently ***experimental only*** and should not be used in any add-ons you will be distributing until it has been declared stable. To use it, you will first need to set the `experimentalApis` flag to `true` in the [`requirements`](../../../manifest/index.md#requirements) section of the `manifest.json`. + +A type union for providing the necessary arguments to [Node.resize](../classes/Node.md#resize). + +Note that some nodes only support proportional resizing. In some cases this is always true (e.g. images) while in +other cases it is due to the current visual details (e.g. the stroke being too thick to shrink the size of a shape).