transform_component
Transform a SketchUp component by setting absolute position in mm, relative rotation in degrees, and relative scale factors about its bounding-box center.
Instructions
Move, rotate and/or scale a group or component (mm / degrees).
position: ABSOLUTE target for the entity's bounding-box MIN corner, in mm — the same anchor create_component uses. Applied LAST (after rotation/scale), so the final bbox-min lands exactly at [x, y, z] even in combined calls. It is NOT a relative offset: repeating the same position is idempotent.
rotation: RELATIVE rotation in degrees around the bbox center, applied sequentially about world X, then Y, then Z.
scale: RELATIVE scale factors about the bbox center.
These validations (3-element lists, non-zero scale) apply only to this typed tool — raw Ruby driven through eval_ruby bypasses them.
Returns: JSON {id, name, type, bbox_mm{min,max}|null}. Read bbox_mm to verify the result; it is null for empty geometry.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | Entity ID from a previous response (integer or its string form) | |
| scale | No | relative factors about bbox center, each |s| > 1e-9 | |
| position | No | ABSOLUTE target for the bbox-min corner, mm | |
| rotation | No | relative degrees around bbox center, applied X then Y then Z |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |