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

Pin with Label

Pin with label is a powerful annotation tool that creates visual markers with text labels to highlight important points, display calculated values, or provide contextual information in your 3D models. These pins consist of a line connecting two points with customizable text labels, making them perfect for technical documentation, design reviews, and educational materials.

Understanding Pin with Label​

Pin with label annotations combine geometric positioning with text information to create clear, professional annotations. They're essential for communicating design intent, displaying calculated properties, and marking critical features in your models.

Key components include:

  • Start Point: The point where the pin originates (usually on or near your geometry)
  • End Point: The point where the pin terminates (typically positioned for optimal label visibility)
  • Direction Vector: Controls the orientation of the label text
  • Label Text: The information to display (can be static text or dynamic calculated values)
  • Label Positioning: Offset and size controls for optimal readability

Simple Pin with Static Label​

The most basic use case is creating a pin with static text to mark important points in your model.

A simple pin with a static label
Bitbybit Platform

A simple pin with a static label in Rete

rete logoRete
Script Source (rete)
{
"id": "rete-v2-json",
"nodes": {
"startPoint": {
"id": "startPoint",
"name": "bitbybit.point.pointXYZ",
"customName": "point xyz",
"async": false,
"drawable": true,
"data": {
"genericNodeData": {
"hide": true,
"oneOnOne": false,
"flatten": 0,
"forceExecution": false
},
"x": 0,
"y": 0,
"z": 0
},
"inputs": {},
"position": [
-3,
5
]
},
"endPoint": {
"id": "endPoint",
"name": "bitbybit.point.pointXYZ",
"customName": "point xyz",
"async": false,
"drawable": true,
"data": {
"genericNodeData": {
"hide": true,
"oneOnOne": false,
"flatten": 0,
"forceExecution": false
},
"x": 3,
"y": 2,
"z": 1
},
"inputs": {},
"position": [
-4,
357
]
},
"direction": {
"id": "direction",
"name": "bitbybit.vector.vectorXYZ",
"customName": "vector xyz",
"async": false,
"drawable": true,
"data": {
"genericNodeData": {
"hide": true,
"oneOnOne": false,
"flatten": 0,
"forceExecution": false
},
"x": 1,
"y": 0,
"z": 0
},
"inputs": {},
"position": [
-8,
707
]
},
"pinWithLabel": {
"id": "pinWithLabel",
"name": "bitbybit.occt.dimensions.pinWithLabel",
"customName": "pin with label",
"async": true,
"drawable": true,
"data": {
"genericNodeData": {
"hide": false,
"oneOnOne": false,
"flatten": 0,
"forceExecution": false
},
"startPoint": [
0,
0,
0
],
"endPoint": [
0,
5,
2
],
"direction": [
0,
0,
1
],
"offsetFromStart": 0,
"label": "Important Point",
"labelOffset": 0.3,
"labelSize": 0.4,
"endType": "none",
"arrowSize": 0.3,
"arrowAngle": 30,
"arrowsFlipped": false,
"labelRotation": 0,
"labelFlipHorizontal": false,
"labelFlipVertical": false
},
"inputs": {
"startPoint": {
"connections": [
{
"node": "startPoint",
"output": "result",
"data": {}
}
]
},
"endPoint": {
"connections": [
{
"node": "endPoint",
"output": "result",
"data": {}
}
]
},
"direction": {
"connections": [
{
"node": "direction",
"output": "result",
"data": {}
}
]
}
},
"position": [
568,
313
]
}
},
"modules": {}
}

This basic example demonstrates the essential components of a pin with label:

  • Start Point at origin [0, 0, 0] - where the pin begins
  • End Point at [3, 2, 1] - where the pin terminates and the label appears
  • Direction Vector [1, 0, 0] - controls label text orientation (pointing along X-axis)
  • Static Label text "Important Point" - simple text annotation
  • Label positioning with 0.3 offset and 0.4 size for good readability

Pin with Calculated Properties​

A more practical application combines pin labels with calculated geometric properties, similar to how technical drawings display measurements and specifications.

A sphere with its volume on a pin label
Bitbybit Platform

A sphere with its volume on a pin label in Rete

rete logoRete
Script Source (rete)
{
"id": "rete-v2-json",
"nodes": {
"radius": {
"id": "radius",
"name": "bitbybit.math.numberSlider",
"customName": "number slider",
"async": false,
"drawable": false,
"data": {
"options": {
"min": 1,
"max": 5,
"step": 0.1,
"width": 300,
"updateOnDrag": true
},
"number": 2.5
},
"inputs": {},
"position": [
42,
107
]
},
"sphere": {
"id": "sphere",
"name": "bitbybit.occt.shapes.solid.createSphere",
"customName": "sphere",
"async": true,
"drawable": true,
"data": {
"genericNodeData": {
"hide": false,
"oneOnOne": false,
"flatten": 0,
"forceExecution": false
},
"radius": 2.5,
"center": [
0,
0,
0
]
},
"inputs": {
"radius": {
"connections": [
{
"node": "radius",
"output": "result",
"data": {}
}
]
}
},
"position": [
1028,
63
]
},
"getVolume": {
"id": "getVolume",
"name": "bitbybit.occt.shapes.solid.getSolidVolume",
"customName": "get solid volume",
"async": true,
"drawable": false,
"data": {
"genericNodeData": {
"hide": false,
"oneOnOne": false,
"flatten": 0,
"forceExecution": false
}
},
"inputs": {
"shape": {
"connections": [
{
"node": "sphere",
"output": "result",
"data": {}
}
]
}
},
"position": [
1424,
60
]
},
"roundVolume": {
"id": "roundVolume",
"name": "bitbybit.math.roundToDecimals",
"customName": "round to decimals",
"async": false,
"drawable": false,
"data": {
"genericNodeData": {
"hide": false,
"oneOnOne": false,
"flatten": 0,
"forceExecution": false
},
"number": 1.123456,
"decimalPlaces": 2
},
"inputs": {
"number": {
"connections": [
{
"node": "getVolume",
"output": "result",
"data": {}
}
]
}
},
"position": [
1797,
61
]
},
"formatVolume": {
"id": "formatVolume",
"name": "bitbybit.text.format",
"customName": "format",
"async": false,
"drawable": false,
"data": {
"genericNodeData": {
"hide": false,
"oneOnOne": false,
"flatten": 0,
"forceExecution": false
},
"text": "Vol: {0} m3",
"values": [
"World"
]
},
"inputs": {
"values": {
"connections": [
{
"node": "volumeList",
"output": "list",
"data": {}
}
]
}
},
"position": [
2925,
20
]
},
"volumeList": {
"id": "volumeList",
"name": "bitbybit.lists.createList",
"customName": "create list",
"async": false,
"drawable": false,
"data": {},
"inputs": {
"listElements": {
"connections": [
{
"node": "volumeToString",
"output": "result",
"data": {}
}
]
}
},
"position": [
2546,
97
]
},
"volumeToString": {
"id": "volumeToString",
"name": "bitbybit.text.toString",
"customName": "to string",
"async": false,
"drawable": false,
"data": {
"genericNodeData": {
"hide": false,
"oneOnOne": false,
"flatten": 0,
"forceExecution": false
}
},
"inputs": {
"item": {
"connections": [
{
"node": "roundVolume",
"output": "result",
"data": {}
}
]
}
},
"position": [
2171,
59
]
},
"pinStart": {
"id": "pinStart",
"name": "bitbybit.point.pointXYZ",
"customName": "point xyz",
"async": false,
"drawable": true,
"data": {
"genericNodeData": {
"hide": true,
"oneOnOne": false,
"flatten": 0,
"forceExecution": false
},
"x": 0,
"y": 0,
"z": 0
},
"inputs": {
"z": {
"connections": [
{
"node": "radius",
"output": "result",
"data": {}
}
]
}
},
"position": [
1811,
-1193
]
},
"pinEnd": {
"id": "pinEnd",
"name": "bitbybit.point.pointXYZ",
"customName": "point xyz",
"async": false,
"drawable": true,
"data": {
"genericNodeData": {
"hide": true,
"oneOnOne": false,
"flatten": 0,
"forceExecution": false
},
"x": 4,
"y": 3,
"z": 0
},
"inputs": {
"z": {
"connections": [
{
"node": "pinHeight",
"output": "result",
"data": {}
}
]
}
},
"position": [
2196,
-808
]
},
"pinHeight": {
"id": "pinHeight",
"name": "bitbybit.math.add",
"customName": "add",
"async": false,
"drawable": false,
"data": {
"genericNodeData": {
"hide": false,
"oneOnOne": false,
"flatten": 0,
"forceExecution": false
},
"first": 1,
"second": 2
},
"inputs": {
"first": {
"connections": [
{
"node": "radius",
"output": "result",
"data": {}
}
]
}
},
"position": [
1795,
-731
]
},
"direction": {
"id": "direction",
"name": "bitbybit.vector.vectorXYZ",
"customName": "vector xyz",
"async": false,
"drawable": true,
"data": {
"genericNodeData": {
"hide": true,
"oneOnOne": false,
"flatten": 0,
"forceExecution": false
},
"x": 1,
"y": 0,
"z": 0
},
"inputs": {},
"position": [
2198,
-434
]
},
"volumePin": {
"id": "volumePin",
"name": "bitbybit.occt.dimensions.pinWithLabel",
"customName": "pin with label",
"async": true,
"drawable": true,
"data": {
"genericNodeData": {
"hide": false,
"oneOnOne": false,
"flatten": 0,
"forceExecution": false
},
"startPoint": [
0,
0,
0
],
"endPoint": [
0,
5,
2
],
"direction": [
0,
0,
1
],
"offsetFromStart": 0,
"label": "Volume Pin",
"labelOffset": 0.3,
"labelSize": 0.4,
"endType": "none",
"arrowSize": 0.3,
"arrowAngle": 30,
"arrowsFlipped": false,
"labelRotation": 0,
"labelFlipHorizontal": false,
"labelFlipVertical": false
},
"inputs": {
"startPoint": {
"connections": [
{
"node": "pinStart",
"output": "result",
"data": {}
}
]
},
"endPoint": {
"connections": [
{
"node": "pinEnd",
"output": "result",
"data": {}
}
]
},
"direction": {
"connections": [
{
"node": "direction",
"output": "result",
"data": {}
}
]
},
"label": {
"connections": [
{
"node": "formatVolume",
"output": "result",
"data": {}
}
]
}
},
"position": [
3518,
-858
]
}
},
"modules": {}
}

This example demonstrates how to combine pin labels with calculated geometric properties:

  • Parametric Sphere: Created with a configurable radius (2.5 units)
  • Volume Calculation: Uses getSolidVolume to compute the sphere's volume
  • Dynamic Formatting: Rounds volume to 2 decimal places and formats with units ("Vol: 65.45 m³")
  • Smart Positioning: Pin starts at the sphere's top surface and extends to a clear viewing position
  • Responsive Layout: Pin height adjusts based on sphere radius for consistent visual presentation

This pattern is commonly used in engineering applications where you need to annotate models with calculated properties that update automatically when geometry parameters change.