Skip to content

Elements

Simply put, elements are the layout nodes you can see and touch. They have a geometry and can be nested.
For instance, a kitchen element contains casework elements, which in turn may contain asset elements, such as a sink.

Edge elements

Start and end points are defined by the referenced edge. For walls, the geometry is an extrusion, and the profile is a result of the width, offset parameters and connected walls.
If edges of two walls share the same vertex, they are connected.
Wall elements can contain opening elements.

sg-edge-element

json
{
    "type": "element:wall",
    "edge": <edge-id>,
    "parameters": {
        "height": 2,
        "offset": 0.1,
        "width": 2
    },
    "elements": [
        // optionally opening elements
    ]
}

Edge element types

  • element:wall

    The standard linear wall.

  • element:spaceDivider

    Element without geometry, used to divide spaces.

Boundary elements

Defined by boundaries of edges.

sg-boundary-element

json
{
    "type": "element:boundaryWall",
    "boundaries": [
        { "edges": [<edge-id>, <edge-id>, <edge-id>] }
    ],
    "parameters": {
        "height": 2,
        "elevation": 0
    }
}

Boundary element types

  • element:boundaryWall

    Polygonal wall, controlled by edges.

  • element:floor

    Bottom geometry for spaces.

  • element:ceiling

    Top geometry for spaces.

Opening elements

Nested inside a wall or slab element.

sg-opening-element

json
{
  "type": "element:opening",
  "parameters": {
    "position": [1, 1],
    "dimensions": [1.5, 1.2]
  },
  "elements": [
    // optional window or door element
  ]
}

Transform elements

For transform elements, semantics and representation is completely decoupled. They are positioned using the standard transform.

sg-transform-element

json
{
    "type": "element:asset",
    "position": [2, 0, -1],
    "rotation": 90,
    "product": <product-id>
}

Transform element types

  • element:asset

Asset elements, such as furniture or technical equipment, reference a product definition. The representation is completely controlled by the product definition.

  • element:beam

    Linear structural support element.

  • element:casework

    Simple cuboid element that can be used standalone or nested in kitchens.

  • element:column

    Structural element that uses by default an extrusion with variable profiles.

  • element:door

    Flexible element for single leaf, double leaf or sliding doors.

  • element:generic

    General purpose element, with completely customizable geometry.

  • element:kitchen

    Assembly element that combines a number of casework elements with optionally contained asset elements.

  • element:ramp

    Simple element with triangular horizontal extrusion.

  • element:stairs

    Assembly element that combines stairFlight elements and slabs to form various stair configurations.

  • element:stairFlight

    Straight or spiral stair flight.

  • element:window

    Simple element with optionally subdivided glass panels.