genart.dev
Plugins

Perspective

Perspective grids and vanishing point systems for spatial composition.

Perspective guide layers that provide vanishing point systems and spatial grids for 3D composition.

Installation

npm install @genart-dev/plugin-perspective

Layer Types

Type IDDisplay NameDescription
perspective:one-pointOne-Point PerspectiveSingle vanishing point on the horizon
perspective:two-pointTwo-Point PerspectiveTwo vanishing points on the horizon
perspective:three-pointThree-Point PerspectiveThree vanishing points (includes vertical)
perspective:isometricIsometric30-degree isometric projection grid
perspective:floorFloor GridPerspective-corrected ground plane grid

Properties

perspective:one-point

PropertyTypeDefaultDescription
vanishXnumber0.5Vanishing point X (0-1 normalized)
vanishYnumber0.5Vanishing point Y (0-1 normalized)
rayCountnumber12Number of convergence lines
colorcolor"#00aaff40"Guide line color
lineWidthnumber1Line width in pixels

perspective:two-point

PropertyTypeDefaultDescription
leftVanishXnumber0.0Left vanishing point X
rightVanishXnumber1.0Right vanishing point X
horizonYnumber0.5Horizon line Y position
rayCountnumber8Rays per vanishing point
colorcolor"#00aaff40"Guide line color
lineWidthnumber1Line width

perspective:three-point

PropertyTypeDefaultDescription
leftVanishXnumber0.0Left vanishing point X
rightVanishXnumber1.0Right vanishing point X
horizonYnumber0.4Horizon line Y position
verticalVanishYnumber0.0Vertical vanishing point Y
rayCountnumber6Rays per vanishing point
colorcolor"#00aaff40"Guide line color

perspective:isometric

PropertyTypeDefaultDescription
spacingnumber40Grid line spacing
colorcolor"#00aaff40"Guide line color
lineWidthnumber1Line width

perspective:floor

PropertyTypeDefaultDescription
horizonYnumber0.4Horizon line position
gridSizenumber8Grid divisions
depthnumber0.8Depth scaling factor
colorcolor"#00aaff40"Guide line color

MCP Tools

ToolDescription
design_add_one_point_perspectiveAdd one-point perspective grid
design_add_two_point_perspectiveAdd two-point perspective grid
design_add_three_point_perspectiveAdd three-point perspective grid
design_add_isometricAdd isometric projection grid
design_add_floor_gridAdd perspective floor grid

Example

{
  "tool": "design_add_layer",
  "arguments": {
    "type": "perspective:two-point",
    "properties": {
      "leftVanishX": -0.2,
      "rightVanishX": 1.2,
      "horizonY": 0.35,
      "rayCount": 10,
      "color": "#5588ff50"
    }
  }
}