Skip to main content
Glama

Render a 3D view

render_3d
Read-only

Render a home or floor plan as a 3D PNG with orthographic elevations, aerial/visitor views, cutaway walls, and sections—no GPU needed. Inspect layouts, furniture, and individual pieces.

Instructions

PNG of the home in 3D (software render with outlines, no GPU needed). view: front|back|left|right|top orthographic elevations — front looks from the plan's bottom edge (large y) toward y=0, back from y=0 toward large y, left from x=0, right from large x; cut=cm makes a section keeping only what is beyond that plane from the viewer (front cut=200 keeps y<200, so the wall at y=0 stays as the backdrop; to remove it look from back), aerial (default; frames the whole building; yaw degrees: 0 from east/+x, 90 from south/plan bottom (default 60); pitch down; zoom >1 farther), visitor (current visitor camera) or cam=i (stored point of view). walls=cutaway drops the walls between the eye and a room to 40 cm, walls=down drops them all; either hides ceilings, roofs and the doors, windows and wall pieces of lowered walls, to see the furniture from the side. piece= draws it alone, seen from its own side (view; aerial is three-quarter), framed the same wherever it stands; part= frames one part of its model; ref=i puts its reference photo beside it, from the photo's side. Keep w/h small. One render runs at a time; this waits its turn.

Input Schema

NameRequiredDescriptionDefault
hNoHeight px (default 360, 64..1200)
wNoWidth px (default 480, 64..1600)
camNoStored point of view index (see cameras)
cutNoElevations: section plane in plan cm (y for front/back, x for left/right, height for top); what lies between the viewer and it is cut away — walls and pieces alike. front views from large y, back from y=0
refNoWith piece: its reference photo at this index, beside the render, from the photo's side and part
yawNoAerial turn, degrees; not with piece
partNoWith piece: frame this part of its model (`model` lists them)
viewNoDefault `aerial`; `front` to `top` are elevations
zoomNoAerial distance factor: 1 frames the building, 2 twice as far
levelNoStoreys drawn: an id like `lv3` draws it and those below, `all` every one (default: as the editor shows them)
pieceNoOnly this piece, framed from its own side
pitchNoAerial height angle, degrees; not with piece
wallsNo`up` (default), `cutaway` or `down`

Output Schema

NameRequiredDescriptionDefault
mimeTypeYes

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed2 schema fields changedv3.2.0
    • changedInput schema / properties / pitch / description
      Previous value: -"Aerial height angle, degrees"New value: +"Aerial height angle, degrees; not with piece"
    • changedInput schema / properties / yaw / description
      Previous value: -"Aerial turn, degrees"New value: +"Aerial turn, degrees; not with piece"
  2. Changed7 schema fields changedv3.0.0
    • addedInput schema / properties / level
      Added value: +{
      +  "description": "Storeys drawn: an id like `lv3` draws it and those below, `all` every one (default: as the editor shows them)",
      +  "type": "string"
      +}
    • addedInput schema / properties / part
      Added value: +{
      +  "description": "With piece: frame this part of its model (`model` lists them)",
      +  "type": "string"
      +}
    • addedInput schema / properties / piece
      Added value: +{
      +  "description": "Only this piece, framed from its own side",
      +  "type": "string"
      +}
    • addedInput schema / properties / ref
      Added value: +{
      +  "description": "With piece: its reference photo at this index, beside the render, from the photo's side and part",
      +  "type": "integer"
      +}
    • changedInput schema / properties / view / description
      Previous value: -"`aerial` (default) or `visitor`"New value: +"Default `aerial`; `front` to `top` are elevations"
    • addedInput schema / properties / view / enum
      Added value: +[
      +  "aerial",
      +  "visitor",
      +  "front",
      +  "back",
      +  "left",
      +  "right",
      +  "top"
      +]
    • removedOutput schema / properties / mimeType / description
      Removed value: -"Type of the image in the content (image/png)"
  3. First observedv0.1.0

TDQS

A4.3/5.0
Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Beyond the readOnlyHint, it discloses important behavior: software rendering with outlines and no GPU, one render at a time with queueing, and side effects of walls=cutaway/down such as hiding ceilings, roofs, doors, windows and wall pieces. This is substantial behavioral context an agent could not infer from annotations.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness3/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is front-loaded with the tool's purpose and contains little wasted text, but it is a dense semicolon-heavy paragraph that is difficult to scan. For 13 parameters the content may be justified, yet the structure could be much clearer.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the rich schema, output schema and readOnly annotation, the description covers the key behavioral aspects an agent needs: output format, view semantics, section cutting, wall handling, piece framing, concurrency limits and sizing guidance. No critical calling context appears to be missing.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is already 100%, but the description adds meaningful semantics beyond the schema for view directions, cut plane behavior, wall visibility modes, piece/part framing and reference-photo orientation. A few parameters such as level and pitch rely mostly on the schema, so it is strong but not exhaustive.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The opening sentence states a specific action, resource and output: a PNG 3D render of the home using a software renderer. The 3D framing and PNG output distinguish it from sibling rendering tools such as render_plan and render_photo.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description explains how to use view, cut, walls, piece, part and ref in detail, but it never explicitly says when to choose this tool over render_photo, render_plan or video. Usage is strongly implied through the rendering modes, but alternatives are not named or compared.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.