render_vmf_view
Render a .vmf from a chosen camera and return an image, so you can inspect map geometry, room size, and occlusion instead of inferring them from coordinates.
Instructions
Renders a .vmf from a camera and returns the picture, so the shape of a place can be LOOKED at rather than inferred from coordinates. Flat colour per face, one light, no textures and no props: it shows form and occlusion -- what stands where, what hides what, how much room there is at eye height -- and it deliberately does not show atmosphere, which only a capture from the running game can. Camera convention is Source's own (x forward, y left, z up; angles pitch/yaw/roll; fov horizontal), the same one gmod-mcp's read_view reports, so a rendering and an in-game capture from the same numbers frame the same thing. A face's colour is a stable hash of its material, so the same wall is the same colour in two renderings an edit apart.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"path": "<path>"
},
"name": "render_vmf_view"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| fov | No | Horizontal field of view. | |
| near | No | ||
| path | Yes | Path to the .vmf, absolute or relative to the repo root. | |
| stand | No | Put the eye where a standing player's would be: drop to the floor under `origin` and rise to eye height. Use this rather than guessing a z. | |
| width | No | ||
| angles | No | Pitch, yaw, roll in degrees. Positive pitch looks down, as Source means it. | |
| height | No | ||
| lookAt | No | Aim at this point instead of giving angles. Overrides `angles`. | |
| origin | No | Eye position. Omit with `fromEntity`, or with neither to frame the whole map. | |
| eyeHeight | No | Added to the origin's z. 64 is Source's standing eye height. | |
| fromEntity | No | Stand at this targetname's origin -- an info_player_start, say. | |
| lookAtEntity | No | Aim at this targetname's origin. Overrides `angles` and `lookAt`. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| fov | Yes | ||
| path | Yes | ||
| notes | Yes | ||
| width | Yes | ||
| angles | Yes | ||
| height | Yes | ||
| origin | Yes | ||
| pngBytes | Yes | ||
| brushCount | Yes | ||
| facesDrawn | Yes | ||
| facesBehind | Yes | ||
| facesCulled | Yes | ||
| insideSolid | Yes | The eye is inside a brush, so the picture is the inside of a wall. | |
| skyFraction | Yes | ||
| voidFraction | Yes |