Skip to main content
OCCT category icon with a stylized logo representation

Introduction to OCCT Wire Basic Primitives

Wires are one-dimensional geometric entities that represent connected sequences of edges forming open or closed curves. OCCT provides several primitive wire types that serve as building blocks for more complex 2D and 3D modeling operations. These wire primitives are commonly used to create profiles for extrusion, sweeping, and other advanced geometric operations.

This example demonstrates the creation of the most common primitive wire types:

  • Circle Wire: A circular wire with specified radius and center
  • Square Wire: A square-shaped wire with specified size and center
  • NGon Wire: A regular polygon wire with specified number of corners
  • Parallelogram Wire: A parallelogram-shaped wire with width, height, and angle
  • Rectangle Wire: A rectangular wire with specified width and length
  • Ellipse Wire: An elliptical wire with major and minor radii
Bitbybit Platform

Creating basic wire primitives

rete logoRete
Script Source (rete)
{
  "id": "rete-v2-json",
  "nodes": {
    "69db19884a370f7c": {
      "id": "69db19884a370f7c",
      "name": "bitbybit.occt.shapes.wire.createCircleWire",
      "customName": "circle wire",
      "async": true,
      "drawable": true,
      "data": {
        "genericNodeData": {
          "hide": false,
          "oneOnOne": false,
          "flatten": 0,
          "forceExecution": false
        },
        "radius": 3,
        "center": [
          0,
          0,
          0
        ],
        "direction": [
          0,
          1,
          0
        ]
      },
      "inputs": {},
      "position": [
        796.38671875,
        208.7109375
      ]
    },
    "5298db5d0bf5b70d": {
      "id": "5298db5d0bf5b70d",
      "name": "bitbybit.occt.shapes.wire.createSquareWire",
      "customName": "square wire",
      "async": true,
      "drawable": true,
      "data": {
        "genericNodeData": {
          "hide": false,
          "oneOnOne": false,
          "flatten": 0,
          "forceExecution": false
        },
        "size": 3,
        "center": [
          0,
          0,
          0
        ],
        "direction": [
          0,
          1,
          0
        ]
      },
      "inputs": {
        "center": {
          "connections": [
            {
              "node": "3a1b9cf45d7c8560",
              "output": "result",
              "data": {}
            }
          ]
        }
      },
      "position": [
        797.1167812876299,
        567.3003348022221
      ]
    },
    "3a1b9cf45d7c8560": {
      "id": "3a1b9cf45d7c8560",
      "name": "bitbybit.vector.vectorXYZ",
      "customName": "vector xyz",
      "async": false,
      "drawable": true,
      "data": {
        "genericNodeData": {
          "hide": true,
          "oneOnOne": false,
          "flatten": 0,
          "forceExecution": false
        },
        "x": 5,
        "y": 0,
        "z": 0
      },
      "inputs": {},
      "position": [
        391.8397443858421,
        609.2541923921959
      ]
    },
    "b03165e52f48ff1b": {
      "id": "b03165e52f48ff1b",
      "name": "bitbybit.vector.vectorXYZ",
      "customName": "vector xyz",
      "async": false,
      "drawable": true,
      "data": {
        "genericNodeData": {
          "hide": true,
          "oneOnOne": false,
          "flatten": 0,
          "forceExecution": false
        },
        "x": -6,
        "y": 0,
        "z": 0
      },
      "inputs": {},
      "position": [
        381.4252369164033,
        1026.2331834569381
      ]
    },
    "ced8e0357556b800": {
      "id": "ced8e0357556b800",
      "name": "bitbybit.occt.shapes.wire.createNGonWire",
      "customName": "ngon wire",
      "async": true,
      "drawable": true,
      "data": {
        "genericNodeData": {
          "hide": false,
          "oneOnOne": false,
          "flatten": 0,
          "forceExecution": false
        },
        "center": [
          0,
          0,
          0
        ],
        "direction": [
          0,
          1,
          0
        ],
        "nrCorners": 6,
        "radius": 2
      },
      "inputs": {
        "center": {
          "connections": [
            {
              "node": "b03165e52f48ff1b",
              "output": "result",
              "data": {}
            }
          ]
        }
      },
      "position": [
        794.3963462853789,
        1024.3436962815244
      ]
    },
    "e76c6df127a9d31c": {
      "id": "e76c6df127a9d31c",
      "name": "bitbybit.occt.shapes.wire.createParallelogramWire",
      "customName": "parallelogram wire",
      "async": true,
      "drawable": true,
      "data": {
        "genericNodeData": {
          "hide": false,
          "oneOnOne": false,
          "flatten": 0,
          "forceExecution": false
        },
        "center": [
          0,
          0,
          0
        ],
        "direction": [
          0,
          1,
          0
        ],
        "aroundCenter": true,
        "width": 3,
        "height": 2,
        "angle": 30
      },
      "inputs": {
        "center": {
          "connections": [
            {
              "node": "adeb74f805b239b8",
              "output": "result",
              "data": {}
            }
          ]
        }
      },
      "position": [
        797.4442178044769,
        1434.5793419960353
      ]
    },
    "adeb74f805b239b8": {
      "id": "adeb74f805b239b8",
      "name": "bitbybit.vector.vectorXYZ",
      "customName": "vector xyz",
      "async": false,
      "drawable": true,
      "data": {
        "genericNodeData": {
          "hide": true,
          "oneOnOne": false,
          "flatten": 0,
          "forceExecution": false
        },
        "x": -11,
        "y": 0,
        "z": 0
      },
      "inputs": {},
      "position": [
        388.5087965238256,
        1437.9832918677564
      ]
    },
    "d41ad1f158b794f3": {
      "id": "d41ad1f158b794f3",
      "name": "bitbybit.occt.shapes.wire.createRectangleWire",
      "customName": "rectangle wire",
      "async": true,
      "drawable": true,
      "data": {
        "genericNodeData": {
          "hide": false,
          "oneOnOne": false,
          "flatten": 0,
          "forceExecution": false
        },
        "width": 2,
        "length": 6,
        "center": [
          0,
          0,
          0
        ],
        "direction": [
          0,
          1,
          0
        ]
      },
      "inputs": {
        "center": {
          "connections": [
            {
              "node": "eb0d53b47065ba27",
              "output": "result",
              "data": {}
            }
          ]
        }
      },
      "position": [
        807.0660770213016,
        1932.65310264216
      ]
    },
    "eb0d53b47065ba27": {
      "id": "eb0d53b47065ba27",
      "name": "bitbybit.vector.vectorXYZ",
      "customName": "vector xyz",
      "async": false,
      "drawable": true,
      "data": {
        "genericNodeData": {
          "hide": true,
          "oneOnOne": false,
          "flatten": 0,
          "forceExecution": false
        },
        "x": 9,
        "y": 0,
        "z": 0
      },
      "inputs": {},
      "position": [
        401.21471645298226,
        2012.097226478838
      ]
    },
    "da4450234db2a464": {
      "id": "da4450234db2a464",
      "name": "bitbybit.vector.vectorXYZ",
      "customName": "vector xyz",
      "async": false,
      "drawable": true,
      "data": {
        "genericNodeData": {
          "hide": true,
          "oneOnOne": false,
          "flatten": 0,
          "forceExecution": false
        },
        "x": 12,
        "y": 0,
        "z": 0
      },
      "inputs": {},
      "position": [
        392.26401312452316,
        2447.940719665186
      ]
    },
    "c34d4412cbfb1af7": {
      "id": "c34d4412cbfb1af7",
      "name": "bitbybit.occt.shapes.wire.createEllipseWire",
      "customName": "ellipse wire",
      "async": true,
      "drawable": true,
      "data": {
        "genericNodeData": {
          "hide": false,
          "oneOnOne": false,
          "flatten": 0,
          "forceExecution": false
        },
        "center": [
          0,
          0,
          0
        ],
        "direction": [
          0,
          1,
          0
        ],
        "radiusMinor": 1,
        "radiusMajor": 4
      },
      "inputs": {
        "center": {
          "connections": [
            {
              "node": "da4450234db2a464",
              "output": "result",
              "data": {}
            }
          ]
        }
      },
      "position": [
        806.3772296257235,
        2442.4598150758247
      ]
    }
  }
}

These primitive wires serve as the foundation for more complex 2D and 3D modeling operations. They can be used to create faces through surface generation, extruded into solids, used as profiles for sweeping operations, or combined and modified to create sophisticated wireframe geometries for engineering and design applications.