workflow

Extended Workflow Examples

Extended examples and reference material. For essential patterns, see prompt.md.

Common Geometry Operations

# Create face and extrude
face = entities.add_face([0,0,0], [1.m,0,0], [1.m,1.m,0], [0,1.m,0])
face.pushpull(50.cm)

# Create group with geometry
group = entities.add_group
group.entities.add_face(points)

# Transform/move
tr = Geom::Transformation.translation([1.m, 0, 0])
group.transform!(tr)

# Rotation around axis
tr = Geom::Transformation.rotation(ORIGIN, Z_AXIS, 45.degrees)
group.transform!(tr)

# Scale
tr = Geom::Transformation.scaling(2.0)
group.transform!(tr)

# Combined transformation
tr = Geom::Transformation.new(point, xaxis, yaxis, zaxis)

Materials

# Create material
material = model.materials.add('Wood')
material.color = Sketchup::Color.new(139, 69, 19)

# Apply to group (preferred)
group.material = material

# Apply to face (only if explicitly needed)
face.material = material

# Texture
material.texture = '/path/to/texture.jpg'
material.texture.size = [1.m, 1.m]

Components

# Create component definition
definition = model.definitions.add('MyComponent')
definition.entities.add_face(points)

# Place instance
instance = entities.add_instance(definition, transformation)
instance.name = 'Instance 1'

# Access definition from instance
instance.definition.entities.each { |e| puts e }

Curves and Arcs

# Arc (center, xaxis, normal, radius, start_angle, end_angle)
edges = entities.add_arc(center, X_AXIS, Z_AXIS, radius, 0, 90.degrees)

# Circle
edges = entities.add_circle(center, Z_AXIS, radius, 24)

# Polygon
edges = entities.add_ngon(center, Z_AXIS, radius, 6)

# Curve from points
edges = entities.add_curve(points_array)

Layers/Tags

# Create layer
layer = model.layers.add('My Layer')

# Assign to entity
group.layer = layer

# Hide layer
layer.visible = false

Selection and Iteration

# Get selection
selection = model.selection
selection.each { |entity| puts entity }

# Filter by type
groups = entities.grep(Sketchup::Group)
faces = entities.grep(Sketchup::Face)

# Find by name
table = entities.find { |e| e.respond_to?(:name) && e.name == 'Table' }

# Find by attribute
tagged = entities.select { |e| e.get_attribute('supex', 'type') == 'my_tag' }