Primitives Reference: Difference between revisions
Holly-Wood (talk | contribs) |
Holly-Wood (talk | contribs) |
||
(35 intermediate revisions by the same user not shown) | |||
Line 1: | Line 1: | ||
'''LDraw Primitives Reference''' | '''LDraw Primitives Reference''' | ||
Latest Update: 16.11.2024, added the LDraw 2024-09 primitives. | |||
This page is a source of reference for the LDraw primitives in the \LDraw\p directory. Primitives are defined as highly re-usable components of LEGO parts modelled for LDraw. | This page is a source of reference for the LDraw primitives in the \LDraw\p directory. Primitives are defined as highly re-usable components of LEGO parts modelled for LDraw. | ||
Line 618: | Line 620: | ||
r=28: 1-8ring28, 1-4ring28, 2-4ring28, 4-4ring28<br> | r=28: 1-8ring28, 1-4ring28, 2-4ring28, 4-4ring28<br> | ||
r=29: 1-4ring29, 3-8ring29, 2-4ring29, 3-4ring29, 4-4ring29<br> | r=29: 1-4ring29, 3-8ring29, 2-4ring29, 3-4ring29, 4-4ring29<br> | ||
r=30: 2-4ring30, 4-4ring30<br> | r=30: 1-24ring30, 1-16ring30, 2-4ring30, 4-4ring30<br> | ||
r=31: 2-4ring31, 4-4ring31<br> | r=31: 2-4ring31, 4-4ring31<br> | ||
r=32: 1-8ring32, 2-4ring32, 4-4ring32<br> | r=32: 1-8ring32, 2-4ring32, 4-4ring32<br> | ||
r=33: 1-8ring33, 1-4ring33, 4-4ring33<br> | r=33: 1-8ring33, 1-4ring33, 4-4ring33<br> | ||
r=34: 1-8ring34, 1-4ring34, 4-4ring34<br> | r=34: 1-8ring34, 1-4ring34, 4-4ring34<br> | ||
r=35: 1-8ring35, 4-4ring35<br> | r=35: 1-24ring35, 1-16ring35, 1-8ring35, 4-4ring35<br> | ||
r=36: 1-4ring36, 4-4ring36<br> | r=36: 1-4ring36, 4-4ring36<br> | ||
r=37: 3-8ring37, 2-4ring37, 4-4ring37<br> | r=37: 3-8ring37, 2-4ring37, 4-4ring37<br> | ||
Line 916: | Line 918: | ||
r=2: 1-8con2, 3-16con2, 3-8con2, 1-4con2, 5-16con2, 2-4con2, 4-4con2<br> | r=2: 1-8con2, 3-16con2, 3-8con2, 1-4con2, 5-16con2, 2-4con2, 4-4con2<br> | ||
r=3: 1-16con3, 1-8con3, 3-16con3, 3-8con3, 1-4con3, 2-4con3, 7-8con3, 4-4con3<br> | r=3: 1-16con3, 1-8con3, 3-16con3, 3-8con3, 1-4con3, 2-4con3, 7-8con3, 4-4con3<br> | ||
r=4: 1-8con4, 1-4con4, 3-8con4, 2-4con4, 4-4con4<br> | r=4: 1-8con4, 3-16con4, 1-4con4, 3-8con4, 2-4con4, 4-4con4<br> | ||
r=5: 1-8con5, 3-16con5, 1-4con5, 5-16con5, 2-4con5, 4-4con5<br> | r=5: 1-8con5, 3-16con5, 1-4con5, 3-8con5, 5-16con5, 2-4con5, 4-4con5<br> | ||
r=6: 1-8con6, 3-16con6, 1-4con6, 3-8con6, 2-4con6, 4-4con6<br> | r=6: 1-8con6, 3-16con6, 1-4con6, 3-8con6, 2-4con6, 4-4con6<br> | ||
r=7: 1-4con7, 3-8con7, 2-4con7, 4-4con7<br> | r=7: 1-4con7, 3-8con7, 2-4con7, 4-4con7<br> | ||
r=8: 1-4con8, 2-4con8, 4-4con8<br> | r=8: 1-8con8, 1-4con8, 2-4con8, 4-4con8<br> | ||
r=9: 3-16con9, 1-4con9, 3-8con9, 4-4con9<br> | r=9: 3-16con9, 1-4con9, 3-8con9, 2-4con9, 4-4con9<br> | ||
r=10: 1-8con10, 3-8con10, 1-4con10, 2-4con10, 4-4con10<br> | r=10: 1-8con10, 3-8con10, 1-4con10, 2-4con10, 4-4con10<br> | ||
r=11: 1-4con11, 5-16con11, 2-4con11, 4-4con11<br> | r=11: 1-4con11, 5-16con11, 2-4con11, 4-4con11<br> | ||
r=12: 1-8con12, 3-16con12, 1-4con12, 5-16con12, 3-8con12, 2-4con12, 4-4con12<br> | r=12: 1-8con12, 3-16con12, 1-4con12, 5-16con12, 3-8con12, 2-4con12, 4-4con12<br> | ||
r=13: 1-4con13, 2-4con13, 4-4con13<br> | r=13: 1-4con13, 2-4con13, 4-4con13<br> | ||
r=14: 1-4con14, 4-4con14<br> | r=14: 3-16con14, 1-4con14, 4-4con14<br> | ||
r=15: 1-4con15, 2-4con15, 4-4con15<br> | r=15: 3-16con15, 1-4con15, 2-4con15, 4-4con15<br> | ||
r=16: 1-16con16, 1-4con16, 4-4con16<br> | r=16: 1-16con16, 1-4con16, 4-4con16<br> | ||
r=17: 1-4con17, 4-4con17<br> | r=17: 1-4con17, 4-4con17<br> | ||
Line 937: | Line 939: | ||
r=23: 1-4con23<br> | r=23: 1-4con23<br> | ||
r=24: 1-4con24, 4-4con24<br> | r=24: 1-4con24, 4-4con24<br> | ||
r=25: 3-16con25, 1-4con25, 4-4con25<br> | r=25: 1-8con25, 3-16con25, 1-4con25, 4-4con25<br> | ||
r=27: 1-8con27, 1-4con27<br> | r=27: 1-8con27, 1-4con27<br> | ||
r=28: 1-8con28, 1-4con28, 4-4con28<br> | r=28: 1-8con28, 1-4con28, 4-4con28<br> | ||
r=29: 2-4con29, 4-4con29<br> | r=29: 1-4con29, 2-4con29, 4-4con29<br> | ||
r=30: 4-4con30<br> | r=30: 4-4con30<br> | ||
r=31: 1-4con31<br> | r=31: 1-4con31<br> | ||
Line 965: | Line 967: | ||
High resolution (n-f)(r):<br> | High resolution (n-f)(r):<br> | ||
r=0: 1-4con0, 4-4con0<br> | r=0: 1-4con0, 4-4con0<br> | ||
r=1: 1-16con1, 1-6con1, 1-4con1, 4-4con1<br> | r=1: 1-16con1, 3-16con1, 1-6con1, 1-4con1, 4-4con1<br> | ||
r=2: 1-16con2, 1-6con2, 11-48con2, 5-24con2, 1-4con2, 5-12con2, 4-4con2<br> | r=2: 1-16con2, 1-6con2, 11-48con2, 5-24con2, 1-4con2, 5-12con2, 4-4con2<br> | ||
r=3: 11-48con3, 1-4con3, 5-24con3, 4-4con3<br> | r=3: 11-48con3, 1-8con3, 1-4con3, 5-24con3, 4-4con3<br> | ||
r=4: 1-12con4, 1-6con4, 1-4con4, 4-4con4<br> | r=4: 1-12con4, 1-8con4, 1-6con4, 1-4con4, 4-4con4<br> | ||
r=5: 1-12con5, 1-8con5, 1-6con5, 1-4con5, 4-4con5<br> | r=5: 1-12con5, 1-8con5, 1-6con5, 1-4con5, 4-4con5<br> | ||
r=6: 5-48con6, 1-8con6, 1-4con6, 4-4con6<br> | r=6: 5-48con6, 1-8con6, 1-4con6, 4-4con6<br> | ||
Line 979: | Line 981: | ||
r=13: 1-6con13, 1-4con13, 4-4con13<br> | r=13: 1-6con13, 1-4con13, 4-4con13<br> | ||
r=14: 1-24con14, 5-24con14, 1-8con14, 1-4con14, 3-8con14<br> | r=14: 1-24con14, 5-24con14, 1-8con14, 1-4con14, 3-8con14<br> | ||
r=15: 1-16con15, 1-8con15, 1-4con15, 4-4con15<br> | r=15: 1-24con15, 1-16con15, 1-8con15, 1-4con15, 4-4con15<br> | ||
r=16: 1-24con16, 1-6con16, 5-24con16, 1-4con16, 3-8con16, 4-4con16<br> | r=16: 1-24con16, 1-6con16, 5-24con16, 1-4con16, 3-8con16, 4-4con16<br> | ||
r=17: 1-6con17, 4-4con17<br> | r=17: 1-6con17, 4-4con17<br> | ||
Line 994: | Line 996: | ||
r=29: 5-48con29, 11-48con29, 1-4con29, 4-4con29<br> | r=29: 5-48con29, 11-48con29, 1-4con29, 4-4con29<br> | ||
r=30: 1-8con30, 5-24con30, 1-4con30, 4-4con30<br> | r=30: 1-8con30, 5-24con30, 1-4con30, 4-4con30<br> | ||
r=32: 1-4con32<br> | r=32: 1-24con32, 1-4con32<br> | ||
r=31: 1-6con31, 4-4con31<br> | r=31: 1-6con31, 4-4con31<br> | ||
r=32: 1-4con32<br> | r=32: 1-4con32<br> | ||
Line 1,050: | Line 1,052: | ||
::t01i0702, t01i0714, t01i0769, t01i1250, t01i1579, t01i1667, t01i2000, t01i3261, t01i3333, t01i3600, t01i5556, t01i6000<br> | ::t01i0702, t01i0714, t01i0769, t01i1250, t01i1579, t01i1667, t01i2000, t01i3261, t01i3333, t01i3600, t01i5556, t01i6000<br> | ||
::t02i1111, t02i2000, t02i2258, t02i3333, t02i4000<br> | ::t02i1111, t02i2000, t02i2258, t02i3333, t02i4000<br> | ||
::t04i0462, t04i0625, t04i0857, t04i0909, t04i1111, t04i1304, t04i1333, t04i1429, t04i1538, t04i1765, t04i2000, t04i2258, t04i2500, t04i2667, t04i3077, t04i3333, t04i4000, t04i4167, t04i5000, t04i5455, t04i6381<br> | ::t04i0462, t04i0625, t04i6381, t04i0857, t04i0909, t04i1111, t04i1304, t04i1333, t04i1429, t04i1538, t04i1765, t04i1786, t04i2000, t04i2258, t04i2500, t04i2667, t04i3077, t04i3333, t04i4000, t04i4167, t04i5000, t04i5455, t04i6381<br> | ||
::t08i0909, t08i2000, t08i4167, t08i4235, t08i4588, t08i4643<br> | ::t08i0909, t08i2000, t08i4167, t08i4235, t08i4588, t08i4643<br> | ||
::t16i0909, t16i1429, t16i2000, t16i3333, t16i4643<br> | ::t16i0909, t16i1429, t16i2000, t16i3333, t16i4643<br> | ||
Line 1,057: | Line 1,059: | ||
::t01o0556, t01o0625, t01o0667, t01o0714, t01o1000, t01o1154, t01o1250, t01o1429, t01o1579, t01o2222, t01o2500, t01o3333, t01o3571, t01o3750, t01o3810, t01o3889, t01o4000, t01o4286<br> | ::t01o0556, t01o0625, t01o0667, t01o0714, t01o1000, t01o1154, t01o1250, t01o1429, t01o1579, t01o2222, t01o2500, t01o3333, t01o3571, t01o3750, t01o3810, t01o3889, t01o4000, t01o4286<br> | ||
::t02o0417, t02o0526, t02o1111, t02o1176, t02o2000, t02o2308, t02o3333, t02o4000, t02o4286<br> | ::t02o0417, t02o0526, t02o1111, t02o1176, t02o2000, t02o2308, t02o3333, t02o4000, t02o4286<br> | ||
::t04o0222, t04o0462, t04o0625, t04o0833, t04o0857, t04o0909, t04o1111, t04o1250, t04o1304, t04o1333, t04o1429, t04o1538, t04o1667, t04o1765, t04o1905, t04o2000, t04o2500, t04o2667, t04o3077, t04o3333, t04o3750, t04o4167, t04o5000, t04o6250, t04o6667, ::t04o7000, t04o7500, t04o8750, t04o8889<br> | ::t04o0222, t04o0462, t04o0625, t04o0833, t04o0857, t04o0909, t04o1111, t04o1250, t04o1304, t04o1333, t04o1429, t04o1538, t04o1667, t04o1765, t04o1786, t04o1905, t04o2000, t04o2500, t04o2667, t04o3077, t04o3333, t04o3750, t04o4167, t04o5000, t04o6250, t04o6667, ::t04o7000, t04o7500, t04o8750, t04o8889<br> | ||
::t08o0727, t08o0909, t08o2000, t08o3333, t08o4235, t08o4588, t08o5000, t08o6250<br> | ::t08o0727, t08o0909, t08o2000, t08o3333, t08o4235, t08o4588, t08o5000, t08o6250<br> | ||
::t16o0909, t16o1429, t16o2000, t16o6250<br> | ::t16o0909, t16o1429, t16o2000, t16o6250<br> | ||
Line 1,067: | Line 1,069: | ||
::t08q3333, t08q4000, t08q4444, t08q5000, t08q7500<br> | ::t08q3333, t08q4000, t08q4444, t08q5000, t08q7500<br> | ||
::t16q4000, t16q5000, t16q7500<br> | ::t16q4000, t16q5000, t16q7500<br> | ||
<br> | |||
<br> | |||
Mixed-Mode (ff)(rrrr):<br> | |||
Inner:<br> | |||
::tm04i1000, tm04i1750, tm04i2308 | |||
::tm06i1750, tm06i3063, tm06i8000 | |||
::tm08i0588, tm08i1333, tm08i1818 | |||
::tm16i1914, tm16i5000 | |||
::tm24i3063, tm24i8000 | |||
<br> | |||
Outer:<br> | |||
::tm01o0200, tm01o0882 | |||
::tm04o0360, tm04o0833, tm04o0870, tm04o1750, tm04o2500, tm04o2727, tm04o3750, tm04o4000, tm04o5000 ::tm06o1750, tm06o3063, tm06o8000 | |||
::tm08o0100, tm08o0900, tm08o1333, tm08o2000, tm08o2500 | |||
::tm12o0349 | |||
::tm16o1914, tm16o5000 | |||
::tm24o3063, tm24o8000 | |||
<br> | |||
Tube:<br> | |||
::tm08q0435, tm08q0667, tm08q2111, tm08q2639, tm08q5000 | |||
::tm12q0435 | |||
::tm16q0667 | |||
::tm24q0667 | |||
::tm48q5000 | |||
<br> | |||
<br> | <br> | ||
High resolution (ff)(rrrr):<br> | High resolution (ff)(rrrr):<br> | ||
Inner:<br> | Inner:<br> | ||
::t04i0455<br> | ::t04i0455, t04i4000, t04i4500<br> | ||
::t12i8333<br> | ::t12i8333<br> | ||
<br> | <br> | ||
Outer:<br> | Outer:<br> | ||
::t01o2000<br> | ::t01o2000<br> | ||
::t04o0455, t04o2000<br> | ::t04o0455, t04o2000, t04o4000, t04o4500<br> | ||
::t08o0625, t08o2500<br> | ::t08o0625, t08o2500<br> | ||
::t12i8333, t12o0349, t12o0625<br> | ::t12i8333, t12o0349, t12o0625<br> | ||
Line 1,895: | Line 1,922: | ||
|- | |- | ||
|[[File:Npeghol6d.png|200px|alt=Npeghol6d]] | |[[File:Npeghol6d.png|200px|alt=Npeghol6d]] | ||
|| | |||
|- | |||
| '''npeghol6e.dat''' || '''Technic Peg Hole Negative 0.25 Walls Only''' | |||
|- | |||
|[[File:Npeghol6e.png|200px|alt=Npeghol6e]] | |||
|| | |||
|- | |||
| '''npeghol6f.dat''' || '''Technic Peg Hole Negative 0.25 Padding Small (6.3639 LDU)''' | |||
|- | |||
|[[File:Npeghol6f.png|200px|alt=Npeghol6f]] | |||
|| | |||
|- | |||
| '''npeghol6g.dat''' || '''Technic Peg Hole Negative 0.25 Padding Large (9 LDU)''' | |||
|- | |||
|[[File:Npeghol6g.png|200px|alt=Npeghol6g]] | |||
|| | || | ||
|- | |- | ||
Line 1,991: | Line 2,036: | ||
|- | |- | ||
|[[File:Npeghol20.png|200px|alt=Npeghol20]] | |[[File:Npeghol20.png|200px|alt=Npeghol20]] | ||
|| | |||
|- | |||
| '''npeghol21.dat''' || '''Technic Peg Hole Negative for Alternate Beam Type 4 Half with Recessed Side''' | |||
|- | |||
|[[File:Npeghol21.png|200px|alt=Npeghol21]] | |||
|| | |||
|- | |||
| '''npeghol22.dat''' || '''Technic Peg Hole Negative for Alternate Beam Type 4 Half with Recessed Top Surface''' | |||
|- | |||
|[[File:Npeghol22.png|200px|alt=Npeghol21]] | |||
|| | || | ||
|} | |} | ||
Line 2,121: | Line 2,178: | ||
|colspan="2"| | |colspan="2"| | ||
These primitives represent various components of the Duplo-scale technic parts. | These primitives represent various components of the Duplo-scale technic parts. | ||
|- | |||
| '''dhingesocket.dat''' || '''Duplo Hinge Socket''' | |||
|- | |||
|[[File:Dhingesocket.png|200px|alt=Dhingesocket]] | |||
|- | |||
| '''dhingepin2.dat''' || '''Duplo Hinge Pin with Deep Recess and Reinforcements''' | |||
|- | |||
|[[File:Dhingepin2.png|200px|alt=Dhingepin2]] | |||
|- | |- | ||
Line 2,335: | Line 2,402: | ||
||See note for stud3. | ||See note for stud3. | ||
A semi-circular version of this is also available as 2-4stud4.dat, | A semi-circular version of this is also available as: 5-16stud4, 2-4stud4.dat, 3-4stud4.dat. | ||
|- | |- | ||
Line 2,425: | Line 2,492: | ||
''Currently available primitives:'' | ''Currently available primitives:'' | ||
One fillet: stud4f1n, stud4f1s<br> | One fillet: stud4f1n, stud4f1s, stud4f1w<br> | ||
Two opposite fillets: stud4f2n, stud4f2s, stud4f2w<br> | Two opposite fillets: stud4f2n, stud4f2s, stud4f2w<br> | ||
Three fillets: stud4f3s<br> | Three fillets: stud4f3s<br> | ||
Line 2,799: | Line 2,866: | ||
3x1<br> | 3x1<br> | ||
4x1, 4x4<br> | 4x1, 4x4<br> | ||
5x1<br> | |||
6x1<br> | 6x1<br> | ||
8x1<br> | 8x1<br> | ||
Line 2,869: | Line 2,937: | ||
1x11<br> | 1x11<br> | ||
| | |- | ||
</div> | | '''stugel-mxn''' || '''Stud with Electric Contact Group''' | ||
|- | |||
|[[File:Stugel-2x2.png|200px|alt=Stugel-mxn]] | |||
||''Currently available primitives:'' | |||
2x2<br> | |||
|} | |||
</div> | |||
{| style="text-align:right; width: 100%;" | {| style="text-align:right; width: 100%;" | ||
Line 2,915: | Line 2,991: | ||
|- | |- | ||
|[[File:Logo5.png|200px|alt=Logo5]] | |[[File:Logo5.png|200px|alt=Logo5]] | ||
|| | |||
|- | |||
| '''logo-lego-1.dat''' || '''Logo Lego (1973-1998)''' | |||
|- | |||
|[[File:Logo-lego-1.png|200px|alt=Logo-lego-1]] | |||
|| | || | ||
|- | |- | ||
Line 2,927: | Line 3,009: | ||
|- | |- | ||
|[[File:Logo-lego-4.png|200px|alt=Logo-lego-4]] | |[[File:Logo-lego-4.png|200px|alt=Logo-lego-4]] | ||
|| | |||
|- | |||
| '''logo-lego-5.dat''' || '''Logo LEGO with Open "O", Thin Outline, Relief''' | |||
|- | |||
|[[File:Logo-lego-5.png|200px|alt=Logo-lego-5]] | |||
|| | || | ||
|- | |- | ||
Line 2,940: | Line 3,028: | ||
|+ | |+ | ||
===General logos=== | ===General logos=== | ||
|- | |||
| '''logo-adidas.dat''' || '''Logo Adidas Stripes''' | |||
|- | |||
|[[File:Logo-adidas.png|200px|alt=Logo-adidas]] | |||
||Exact dimensions X = 19; Z = 11.3 | |||
|- | |||
| '''logo-adidas-box.dat''' || '''Logo Adidas Stripes - Outer Box''' | |||
|- | |||
|[[File:Logo-adidas-box.png|200px|alt=Logo-adidas-box]] | |||
||Exact dimensions X = 19; Z = 11.3 | |||
|- | |||
| '''logo-adidas-text.dat''' || '''Logo Adidas Text''' | |||
|- | |||
|[[File:Logo-adidas-text.png|200px|alt=Logo-adidas-text]] | |||
||Exact dimensions X = 25.5; Z = 5.9 | |||
|- | |||
| '''logo-adidas-text-box.dat''' || '''Logo Adidas Text - Outer Box''' | |||
|- | |||
|[[File:Logo-adidas-text-box.png|200px|alt=Logo-adidas-text-box]] | |||
||Exact dimensions X = 25.5; Z = 5.9 | |||
|- | |- | ||
Line 2,964: | Line 3,076: | ||
|[[File:Logo-camaro-script-box.png|200px|alt=Logo-camaro-script-box]] | |[[File:Logo-camaro-script-box.png|200px|alt=Logo-camaro-script-box]] | ||
||Exact dimensions X = 20; Z = 9.39 | ||Exact dimensions X = 20; Z = 9.39 | ||
|- | |||
| '''logo-chevrolet-icon.dat''' || '''Logo Chevrolet Icon''' | |||
|- | |||
|[[File:logo-chevrolet-icon.png|200px|alt=logo-chevrolet-icon]] | |||
||Exact dimensions X = 28.5; Z = 18.5 | |||
|- | |||
| '''logo-chevrolet-text-box''' || '''Logo Chevrolet Icon Outerbox''' | |||
|- | |||
|[[File:Logo-chevrolet-icon-box.png|200px|alt=Logo-chevrolet-icon-box]] | |||
||Exact dimensions X = 28.5; Z = 18.5 | |||
|- | |- | ||
Line 2,978: | Line 3,102: | ||
|- | |- | ||
| '''logo- | | '''logo-chopard-text.dat''' || '''Logo Chopard Text''' | ||
|- | |- | ||
|[[File:Logo- | |[[File:Logo-chopard-text.png|200px|alt=Logo-chopard-text]] | ||
|| | ||Exact dimensions X = 94.8; Z = 10 | ||
|- | |- | ||
| '''logo- | | '''logo-chopard-box''' || '''Logo Chopard - Outer Box''' | ||
|- | |- | ||
|[[File:Logo- | |[[File:Logo-chopard-box.png|200px|alt=Logo-chopard-box]] | ||
|| | ||Exact dimensions X = 94.8; Z = 10 | ||
|- | |- | ||
| '''logo- | | '''logo-dmg-mori-box''' || '''Logo Dmg Mori - Outer Box''' | ||
|- | |- | ||
|[[File:Logo-fire-badge-big-flame.png|200px|alt=Logo-fire-badge-big-flame]] | |[[File:Logo-dmg-mori-box.png|200px|alt=Logo-dmg-mori-box]] | ||
|| | ||Exact dimensions X = 94.2; Z = 10 | ||
|- | |||
| '''logo-dmg-mori-text''' || '''Logo Dmg Mori Text''' | |||
|- | |||
|[[File:Logo-dmg-mori-text.png|200px|alt=Logo-dmg-mori-text]] | |||
||Exact dimensions X = 94.2; Z = 10 | |||
|- | |||
| '''logo-exxon-text.dat''' || '''Logo Exxon Text''' | |||
|- | |||
|[[File:Logo-exxon-text.png|200px|alt=Logo-exxon-text]] | |||
||The height of characters "E", "O", "N" is 20LDU | |||
|- | |||
| '''logo-exxon-box.dat''' || '''Logo Exxon Outer Box''' | |||
|- | |||
|[[File:Logo-exxon-box.png|200px|alt=Logo-exxon-box]] | |||
|| | |||
|- | |||
| '''logo-fire-badge-big-flame.dat''' || '''Logo Fire Badge Big Flame''' | |||
|- | |||
|[[File:Logo-fire-badge-big-flame.png|200px|alt=Logo-fire-badge-big-flame]] | |||
|| | |||
|- | |- | ||
Line 3,138: | Line 3,286: | ||
|[[File:Logo-mdfoods.png|200px|alt=Logo-mdfoods]] | |[[File:Logo-mdfoods.png|200px|alt=Logo-mdfoods]] | ||
|| | || | ||
|- | |||
| '''logo-mclaren-text''' || '''Logo McLaren Text''' | |||
|- | |||
|[[File:Logo-mclaren-text.png|200px|alt=Logo-mclaren-text]] | |||
||Exact dimensions X = 109; Z = 10 | |||
|- | |||
| '''logo-mclaren-text-box''' || '''Logo McLaren Text Outerbox''' | |||
|- | |||
|[[File:Logo-mclaren-text-box.png|200px|alt=Logo-mclaren-text-box]] | |||
||Exact dimensions X = 109; Z = 10 | |||
|- | |- | ||
Line 3,149: | Line 3,309: | ||
|- | |- | ||
|[[File:Logo-nasa-bg.png|200px|alt=Logo-nasa-bg]] | |[[File:Logo-nasa-bg.png|200px|alt=Logo-nasa-bg]] | ||
|| | |||
|- | |||
| '''logo-nintendo-text.dat''' || '''Logo Nintendo Text''' | |||
|- | |||
|[[File:logo-nintendo-text.png|200px|alt=logo-nintendo-text]] | |||
|| | |||
|- | |||
| '''Logo-nintendo-box.dat''' || '''Logo Nintendo Box''' | |||
|- | |||
|[[File:logo-nintendo-box.png|200px|alt=logo-nintendo-box]] | |||
|| | || | ||
|- | |- | ||
Line 3,188: | Line 3,360: | ||
|- | |- | ||
| '''Logo-porsche- | | '''Logo-porsche-badge.dat''' || '''Logo Porsche Badge''' | ||
|- | |||
|[[File:Logo-porsche-badge.png|200px|alt=Logo-porsche-badge]] | |||
||Exact dimensions X = 13.88; Z = 18 | |||
|- | |||
| '''Logo-porsche-badge-box.dat''' || '''Logo Porsche Badge Rounded Outerbox''' | |||
|- | |- | ||
|[[File:Logo-porsche- | |[[File:Logo-porsche-badge-box.png|200px|alt=Logo-porsche-badge-box]] | ||
|| | ||Exact dimensions X = 13.88; Z = 18 | ||
|- | |- | ||
Line 3,197: | Line 3,375: | ||
|- | |- | ||
|[[File:Logo-porsche-text.png|200px|alt=Logo-porsche-text]] | |[[File:Logo-porsche-text.png|200px|alt=Logo-porsche-text]] | ||
|| | ||Exact dimensions X = 102; Z = 8 | ||
|- | |- | ||
| ''' | | '''Logo-porsche-box.dat''' || '''Logo Porsche - Outer box''' | ||
|- | |- | ||
|[[File: | |[[File:Logo-porsche-box.png|200px|alt=Logo-porsche-box]] | ||
|| | ||Exact dimensions X = 102; Z = 8 | ||
|- | |||
| '''Logo-puma-image.dat''' || '''Logo Puma Image''' | |||
|- | |||
|[[File:Logo-puma-image.png|200px|alt=Logo-puma-image]] | |||
||Exact dimensions X = 17.0; Z = 13.24 | |||
|- | |||
| '''Logo-puma-image-box.dat''' || '''Logo Puma Image Outerbox''' | |||
|- | |||
|[[File:Logo-puma-image-box.png|200px|alt=Logo-puma-image-box]] | |||
||Exact dimensions X = 17.0; Z = 13.24 | |||
|- | |- | ||
Line 3,275: | Line 3,465: | ||
|- | |- | ||
|[[File:Logo-sparco-text-outerbox.png|200px|alt=Logo-sparco-text-outerbox]] | |[[File:Logo-sparco-text-outerbox.png|200px|alt=Logo-sparco-text-outerbox]] | ||
|| | |||
|- | |||
| '''logo-star-wars.dat''' || '''Logo Star Wars''' | |||
|- | |||
|[[File:Logo-star-wars.png|200px|alt=logo-star-wars]] | |||
|| | |||
|- | |||
| '''logo-star-wars-box.dat''' || '''Logo Star Wars Box''' | |||
|- | |||
|[[File:Logo-star-wars-box.png|200px|alt=Logo-star-wars-box]] | |||
|| | || | ||
|- | |- | ||
Line 3,312: | Line 3,514: | ||
|[[File:Logo-train-2006-bold-box.png|200px|alt=Logo-train-2006-bold-box]] | |[[File:Logo-train-2006-bold-box.png|200px|alt=Logo-train-2006-bold-box]] | ||
|| | || | ||
|- | |||
| '''logo-volkswagen-background''' || '''Logo Volkswagen "VW" Background Circular''' | |||
|- | |||
|[[File:Logo-volkswagen-background.png|200px|alt=Logo-volkswagen-background]] | |||
|| | |||
|- | |||
| '''logo-volkswagen-circle''' || '''Logo Volkswagen Circle''' | |||
|- | |||
|[[File:Logo-volkswagen-circle.png|200px|alt=Logo-volkswagen-circle]] | |||
|| | |||
|- | |||
| '''logo-volkswagen-text.dat''' || '''Logo Volkswagen "VW"''' | |||
|- | |||
|[[File:Logo-volkswagen-text.png|200px|alt=Logo-volkswagen-text]] | |||
|| | |||
|- | |||
| '''logo-wec-box.dat''' || '''Logo WEC - Outer Box''' | |||
|- | |||
|[[File:Logo-wec-box.png|200px|alt=Logo-wec-box]] | |||
||Exact dimensions X = 44.6; Z = 10 | |||
|- | |||
| '''logo-wec-text.dat''' || '''Logo WEC Text''' | |||
|- | |||
|[[File:Logo-wec-text.png|200px|alt=Logo-wec-text]] | |||
||Exact dimensions X = 44.6; Z = 10 | |||
|} | |} | ||
Line 3,486: | Line 3,718: | ||
|- | |- | ||
|[[File:Joint8socket2.png|200px|alt=Joint8socket2]] | |[[File:Joint8socket2.png|200px|alt=Joint8socket2]] | ||
|| | |||
|- | |||
| '''joint8socket3.dat''' || '''Joint-8 Socket Free Square''' | |||
|- | |||
|[[File:Joint8socket3.png|200px|alt=Joint8socket3]] | |||
|| | || | ||
|} | |} | ||
Line 3,588: | Line 3,826: | ||
|[[File:Clh6.png|200px|alt=Clh6]] | |[[File:Clh6.png|200px|alt=Clh6]] | ||
||This primitive produces the single finger of a click-lock hinge for use on the sides or ends of plates. To use, rotate accordingly and place 2LDu below the top surface. | ||This primitive produces the single finger of a click-lock hinge for use on the sides or ends of plates. To use, rotate accordingly and place 2LDu below the top surface. | ||
|- | |||
| '''clh6d.dat''' || '''Click Lock Hinge Single Finger for Plate Ends - Opening Downwards''' | |||
|- | |||
|[[File:Clh6d.png|200px|alt=Clh6d]] | |||
|| | |||
|- | |||
| '''clh6u.dat''' || '''Click Lock Hinge Single Finger for Plate Ends - Opening Upwards''' | |||
|- | |||
|[[File:Clh6u.png|200px|alt=Clh6u]] | |||
|| | |||
|- | |- | ||
Line 3,596: | Line 3,846: | ||
|- | |- | ||
| '''clh2.dat''' || '''Click | | '''clh2.dat''' || '''Click Lock Hinge Single Finger for Plate Top''' | ||
|- | |- | ||
|[[File:Clh2.png|200px|alt=Clh2]] | |[[File:Clh2.png|200px|alt=Clh2]] | ||
||This primitive produces the single finger of a click-lock hinge for use on the top of plates. To use, rotate accordingly and place 1LDu below the top surface, centered on the stud location. | ||This primitive produces the single finger of a click-lock hinge for use on the top of plates. To use, rotate accordingly and place 1LDu below the top surface, centered on the stud location. | ||
|- | |||
| '''clh2c.dat''' || '''Click Lock Hinge Single Finger - Common Geometry''' | |||
|- | |||
|[[File:Clh2c.png|200px|alt=Clh2c]] | |||
|| | |||
|- | |||
| '''clh8.dat''' || '''Click Lock Hinge Single Finger for Crevices and Ledges''' | |||
|- | |||
|[[File:Clh8.png|200px|alt=Clh8]] | |||
|| | |||
|- | |- | ||
Line 3,727: | Line 3,989: | ||
|- | |- | ||
|[[File:Clip13.png|200px|alt=Clip13]] | |[[File:Clip13.png|200px|alt=Clip13]] | ||
||This primitive produces a thick 'C' clip, with minimal surfaces. | ||This primitive produces a thick 'C' clip, with minimal surfaces. | ||
|- | |||
| '''clip16.dat''' || '''Vertical Thick Clip for Flags''' | |||
|- | |||
|[[File:Clip16.png|200px|alt=Clip16]] | |||
|| | |||
|- | |- | ||
Line 3,981: | Line 4,249: | ||
|style="width: 200px;"| [[File:Bump5000.png|200px|alt=Bump5000]] | |style="width: 200px;"| [[File:Bump5000.png|200px|alt=Bump5000]] | ||
||This file creates a bump with radius= 1 and height= 0.5 LDU | ||This file creates a bump with radius= 1 and height= 0.5 LDU | ||
|- | |||
| '''conscala.dat''' || '''Scala Pin without Base Collar''' | |||
|- | |||
|[[File:Conscala.png|200px|alt=Conscala]] | |||
|| | |||
|- | |||
| '''conscalaq.dat''' || '''Scala Pin without Base Collar - Quarter''' | |||
|- | |||
|[[File:Conscalaq.png|x200px|alt=Conscalaq]] | |||
|| | |||
|- | |- | ||
Latest revision as of 12:34, 16 November 2024
LDraw Primitives Reference
Latest Update: 16.11.2024, added the LDraw 2024-09 primitives.
This page is a source of reference for the LDraw primitives in the \LDraw\p directory. Primitives are defined as highly re-usable components of LEGO parts modelled for LDraw. They serve several purposes :
- To speed up parts authoring by providing a library of components which can be incorporated into several parts
- To allow rendering software to make substitutions of curved components
Within this reference material the available primitives are categorised into:
Each section contains an overview of the characteristics common to all primitives within that category. Primitives are grouped into classes within each category - one class of primitive serving a similar purpose at different sizes or resolutions. For each class of primitive, a brief description of the purpose of the primitive is provided, with notes on its co-ordinate origin, default size and rules for scaling. A list of the available primitives is shown.
An understanding of the orientation of the co-ordinate axes is essential for authoring a part for LDraw. For reference within this page the axes and their direction is shown in this diagram.
Rectilinear primitives
Nomenclature
Boxes are named boxF, with F representing the number of faces a box has. The suffix E represents the number of edges removed.
F and E are may followed by an additional letter. The hyphen is removed if F is accompanied by a modifier.
Face modifiers:
- o - faces are opposite to each other
- t - faces are all touching each other (usually, it's implied, but box4t.dat is a thing)
- u - missing faces form a U-shape
Edge letters:
- p - groups of edges are parallel to each other
- a - some missing faces have no adjacent edges
Scaling and orientation
These rectilinear elements may be scaled in the {x}, {y} and {z} dimensions to make elements of any size. For example
1 16 0 0 0 40 0 0 0 1 0 0 0 20 rect.dat
would generate a 80LDu x 40LDu rectangle in the {x,z} plane.
Although the default orientation of the rect.dat primitive is in the {x,z} plane the LDraw language allows for this to be transformed
1 16 0 0 0 0 1 0 40 0 0 0 0 20 rect.dat
would generate a 80LDu x 40LDu rectangle in the {y,z} plane.
1 16 0 0 0 40 0 0 0 0 20 0 1 0 rect.dat
would generate a 80LDu x 40LDu rectangle in the {x,y} plane.
Do NOT rotate rect primitives outside of right angles: 90°, 180 ... on all axes.
Return to top |
Return to top |
Curved primitives
LDraw represents curved surfaces as polygons. For circular components two series of primitives are provided.
All the circular primitives are orientated in the {x,z} plane with their origin at the centre of the circle and a default radius of 1 LDu. Primitives are provided for complete circles and for commonly used fractions of a complete circle. Where the naming convention includes a prefix of the form n-f this indicates the fraction (n/f) of the circle drawn by the primitive. Where this fraction is less than an entire circle, the primitive starts at {+x,0} and progresses in a conterclockwise direction when viewed from above {-y}.
To avoid rounding errors, it is preferable to use existing fractional circular primitives, or create a new primitive, rather than rotate an existing primitive by anything other than 90 or 180 degrees. For example, use 3-16XXXX.dat rather than combining 1-8XXXX.dat with 1-16XXXX.dat rotated by 22.5 degreees.
To avoid matrix arithmetic problems in some renderers, the third dimension ({y} in the default orientation) of two-dimensional primitives must be given a non-zero scaling factor. LDraw circles are normally formed of 16-sided polygons (hexdecagons) - the regular resolution. For larger elements, where scaling-up of hexadecagons would give too angular an appearance, a series of high resolution primitives based on a 48-sided polygon are available. These may also be used for parts not well suited to a 16-fold symmetry.
These circular elements may be scaled by the same factor in both the {x} and {z} dimensions to make circular elements of greater or less than 1LDu radius. For example
1 16 0 0 0 3 0 0 0 1 0 0 0 3 4-4edge.dat
would generate a circle in the {x,z} plane with a radius of 3LDu.
They may also be scaled asymmetrically in the x and z dimension to make ellipses.
Although the default orientation is in the {x,z} plane the LDraw language allows for these to be transformed
1 16 0 0 0 0 1 0 3 0 0 0 0 3 4-4edge.dat would generate a circle in the {y,z} plane
1 16 0 0 0 3 0 0 0 0 3 0 1 0 4-4edge.dat would generate a circle in the {x,y} plane
Return to top |
Return to top |
Technic primitives
Return to top |
Return to top |
Return to top |
Return to top |
Return to top |
Return to top |
Return to top |
Return to top |
Return to top |
Return to top |
Return to top |
Return to top |
Stud primitives
Each studxxx primitive described below has a matching low resolution stu2xxx primitive, used by the fast-draw mode of renderers - these stu2xxx primitive must never be used in part files. An additional primitive (studline.dat) is used to substitute a single line for studs by the super fast-draw mode of LDraw.
All stud primitives are modelled with the solid disc uppermost, even if designed for the underside of parts (stud3, stud4, stud8, stud11). The origin is at the base of the stud and they extend for 4LDU in the {-y} dimension. To use for the underside, the primitives need to be inverted in the {y} dimension, viz.
1 16 x y z 1 0 0 0 -1 0 0 0 1 stud3.dat
These primitives must not be scaled in the {x} or {z} dimensions. Ideally they should not be scaled in the {y} dimension either, to allow the accurate substitution of chamfered studs by high-quality renderers [but this rule is flouted in the regular brick files, where stud4 is scaled by 5 to generate the underside tube].
Return to top |
Return to top |
Return to top |
Stud group primitives
Stud groups are provided to reduce the size of part files with many regularly spaced studs. The naming convention is stugN-XxZ.dat, where:
- N = type of stud (regular stud, hollow stud, underside stud, etc.)
- X = number of studs on the x axis
- Z = number of studs on the z axis
To prevent an overload of the library with excessive combinations, the numbers on the x and z axis are limited to:
- 1xZ stugs
- Xx1 stugs (Due to stud orientation you cannot rotate a 1xZ stud group by 90 degrees to get a Xx1 stud group)
- XxZ stugs where X = Z
These primitives must not be scaled.
Return to top |
Logo primitives
This section comprises various primitives of LEGO and non-LEGO logos mostly used on patterns and stickers. These might be used as primitives or inlined code to see fit.
Return to top |
Miscellaneous primitives
This section comprises miscellaneous primitives that do not fit neatly into any of the other categories. All are highly specialised and represent components of parts which fit together with each other or other standard parts. As such these primitives are not intended to be re-sized.
Return to top |
Text primitves
The section comprises reusable glyphs for constructing text patterns. These primitives may be re-sized.
The naming convention for these primitives is typeffci, where ff is an arbitrary two-letter abbreviation for the typeface, c is the glyph class (u=upper case letter, l=lower case letter, n=number, s=symbol, a=accented letter) and i is the glyph identifier (a-z for the upper and lower case letters, 0-9 for the numbers).
Return to top |
Duplo primitives
This section comprises primitives for Duplo parts, all of which have been modelled and released into the official library.
Return to top |
Joint-8 Ball primitives
This section comprises miscellaneous primitives that do not fit neatly into any of the other categories. All are highly specialised and represent components of parts which fit together with each other or other standard parts. As such these primitives are not intended to be re-sized.
Return to top |
Minifig primitives
This section comprises primitives for minifig parts. All are highly specialised and represent components of parts which fit together with each other or other standard parts. As such these primitives are not intended to be re-sized.
knob1.dat | Minifig Arm Knob |
hipstud.dat | Stud for Minifig Hips |
hipstuda.dat | Stud for Minifig Hips without Base Edges |
hipstudh.dat | Stud for Minifig Hips with Hole |
Arm primitives
This section comprises miscellaneous primitives that do not fit neatly into any of the other categories. All are highly specialised and represent components of parts which fit together with each other or other standard parts. As such these primitives are not intended to be re-sized.
Return to top |
Click-lock primitives
This section comprises miscellaneous primitives that do not fit neatly into any of the other categories. All are highly specialised and represent components of parts which fit together with each other or other standard parts. As such these primitives are not intended to be re-sized.
Return to top |
Clip primitives
This section comprises miscellaneous primitives that do not fit neatly into any of the other categories. All are highly specialised and represent components of parts which fit together with each other or other standard parts. As such these primitives are not intended to be re-sized.
Return to top |
Wheel holding pin primitives
This section comprises miscellaneous primitives that do not fit neatly into any of the other categories. All are highly specialised and represent components of parts which fit together with each other or other standard parts. As such these primitives are not intended to be re-sized.
Return to top |
Handle primitives
This section comprises miscellaneous primitives that do not fit neatly into any of the other categories. All are highly specialised and represent components of parts which fit together with each other or other standard parts. As such these primitives are not intended to be re-sized.
handle.dat | Handle for Flat Shields |
handle2.dat | Handle for Bent Shields |
phandle1.dat | Bar Handle Attachment with Open Side |
phandle2.dat | Bar Handle Attachment with 2 Open Sides |
Return to top |
Hinge primitives
This section comprises miscellaneous primitives that do not fit neatly into any of the other categories. All are highly specialised and represent components of parts which fit together with each other or other standard parts. As such these primitives are not intended to be re-sized.
Return to top |
ZNAP parts primitives
This section comprises primitives for the ZNAP parts, all of which have been modelled and released into the official library.
Return to top |
Clikits primitives
This section comprises miscellaneous primitives that do not fit neatly into any of the other categories. All are highly specialised and represent components of parts which fit together with each other or other standard parts. As such these primitives are not intended to be re-sized.
clikitsstud.dat | Clikits Stud |
clikitshole.dat | Clikits Hole |
Return to top |
The rest of development
This section comprises miscellaneous primitives that do not fit neatly into any of the other categories. All are highly specialised and represent components of parts which fit together with each other or other standard parts. As such these primitives are not intended to be re-sized.
Return to top |