Size frame

A size frame defines the positions of grips when the Scale Tool is used on a Live Component in SketchUp.

In Situ

The size frame in SketchUp will automatically appear when using the Scale Tool.

In Graph

Bound Axes

When a size frame’s axis is bound to a parameter and a user stretches the size frame (in SketchUp), the parameter's "value" input will be automatically updated as if the user had directly edited that parameter.

Only either a parameterized number node or parameterized integer node will be able to have a size frame's axis bound to it. To bind a particular axis of a size frame to a particular parameter, right-click a parameterized node and navigate to the "Set Size" menu option. There are three options: Use size X, Use size Y, and Use size Z; each will bind the parameterized node to its respective axis.

Keep in mind that when an axis is bound to a parameter, the parameter receives only the scalar size along that axis, not any directional or orientation information.

Alignment

As the size frame is not defined by a Live Component's bounding box (like a normal component), the alignment of the size frame needs to be manually set.

To set the alignment of a size frame, right-click the background of the graph (no nodes or connections) and navigate to the "Size frame alignment" menu option. There are three options: x, y, and z, each with three options: min, center, and max; each will align the size frame by its extents to the world center / 0,0,0.

Notes

• There is only one size frame per Live Component.
• It is important to note that it is up to the author to ensure that the effects of the size frame accurately reflect the expected behavior of the Live Component. Here are a couple of things to look out for:
  • Be sure that the size frame's intended alignment matches the geometry it's intended to manipulate
    • e.g., the size frame should be aligned to center for each axis if the component is centered on 0,0,0.
  • Be sure that the intended direction of a geometry being manipulated by the size frame is behaving as intended.
    • e.g., a parameter with a binding of "size x" isn’t changing the size in the y direction.
• If you are familiar with the align node, aligning the size frame works similarly to if you were aligning geometry to a value rather than other geometry.
• Resizing a Live Component with the Scale Tool automatically makes that instance of the Live Component unique.
• The visibility of a Live Component's grips is determined by two things:
  • If an axis has been bound to a parameter or not.
  • If the bound parameter's "hide control" input is set to true or not.
• Visibility of the Scale Tool's edge or corner grips is determined by whether all relevant axes are visible (e.g. if both "size x" and "size y" are bound to parameters and visible, then the edge grips associated with those axes will also be visible).

Examples

• Simple Box (With "correct" parameter bindings)
• Simple Box (With "incorrect" parameter bindings)
• Window Template (Size Frame aligned to min, min, min)