LDraw

Last updated
LDraw
LDraw.org.png
Area servedWorldwide
OwnerLDraw.org
Created byJames Jessiman
URL https://www.ldraw.org/ OOjs UI icon edit-ltr-progressive.svg
CommercialNo
RegistrationFree
Current statusOnline

LDraw is a system of freeware tools and a 3D graphics file format standard for modeling Lego creations.

Contents

History

The LDraw file format and original program were written by James Jessiman, [1] although the file format has since evolved and extended. [2] [3] [4] [5] [6] [7] [8] He also modeled many of the original parts in the parts library, which is under continuous maintenance and extension by the LDraw community.

Following Jessiman's death in 1997, [9] [10] a variety of programs have been written that use the LDraw parts library, and file format. LDraw models are frequently rendered in POV-Ray or Blender, free 3D ray tracers.

LDraw.org

In 2003, LDraw.org organization has been established, which main task is set to further develop LDraw file format and extend LDraw parts library. Organization is controlled by members of LDraw.org Steering Commitee (LSC for short), elected by users of LDraw.org forum. Core members of LDraw.org are in close ties with James Jessiman's family, which is the owner of the LDraw™ registered trademark.

James Jessiman Memorial Award

James Jessiman
Memorial Award
James Jessiman Memorial Award.png
Awarded for"Contribution to the furthering of LDraw, the DAT format, and James' memory." [11]
Country Australia
First awarded2009 - Present
Website ldraw.org
LDraw.org.png

Since 2001, LDraw.org project org's awards notable contributors with the James Jessiman Memorial Award.

Recipient is selected by LDraw.org Steering Committee, and approved after a consultation with Jessiman's family. [12]

Recipients

File format

LDraw
Filename extensions
.dat, .ldr, .mpd
Developed byJames Jessiman, LDraw.org
Type of format 3D computer graphics, text file
Standards Lego
Open format?yes
Free format?yes
Website ldraw.org

LDraw file format describes "part" (representation of Lego brick) as a set of geometric primitives ("p") in a form of polygonal triangulated mesh.

LDraw "models" consists of LDraw "parts", same way as Lego models consists of Lego bricks.

LDraw file format is plain text file format, and uses comma-separated syntax definition of values.

Units

Lego brick (real) dimensions Lego dimensions.svg
Lego brick (real) dimensions
Measuring LDraw parts size in LeoCAD with "ruler" part (ruler tick: 1 mm) LeoCAD ruler mm.png
Measuring LDraw parts size in LeoCAD with "ruler" part (ruler tick: 1 mm)

LDU (LDraw Units) — is a base distance unit used in the LDraw format, equals to 1/20 of pin step (distance between centers of 2 closest pins on plate), which in turn almost equals to 0.4 millimetre.

Units comparison table
1 =LDUmmLUFlatPStudBrickinComment
LDU0.41418120120124164LDraw Unit [16] [17] [18] — base unit
mm212585161818764364 millimetre = 0.1 cm = 0.01 dm = 0.001 m
LU41.612151516116Lego Unit [19] = 1 p («plastic» [20] ) — thickness of brick wall
Flat83.2225251318plate height without pin — distance between edges of closest pins
P208.05212156516pin step— distance between centers of two closest pins
Stud208.052121565161x1 brick width (real width: P-0.2 mm = 7.8 mm)
Brick249.66311211238brick height without pin
in6425.41683153153112 inch = 112 feet = 136 yard
Notes: dimension in and mm are approximated (in mm — rounded to the first decimaldigit)

Some editors (like, LeoCAD) displaying dimensions and coordinates using only LDU. For measuring and converting sizes from LDU to other units and vice versa, LDraw users created few parts in a form of ruler, [21] that could be used directly in LDraw editors during visual modeling, that especially useful for scale model making.

Scale

LDraw, same as Lego, uses 1:42½ (Lego minifigure scale) as base for scaling real world object for scale modeling. Its may drift between 1:40 to 1:43, which are popular among other interests.

Specification

The LDraw format can divide a model into steps so that the building instructions can be incorporated into the design, and also allows for steps that rotate the camera and even move parts around in an elementary fashion. It also allows for models to be incorporated in the construction of larger models to make design easier. This also makes the file format space efficient: instead of specifying the polygons of every single stud of a specific brick for example, a shared stud file is included multiple times with transformation applied.

Parts, models, sub-models and polygons are all treated the same and are not specific to Lego models (only the parts library is). The format could be used to store any type of 3D model. Some have created bricks of other building systems for use with LDraw.

The following main three filename extensions are used by LDraw: [22]

The file format uses plain text data, and uses the charset UTF-8 without BOM.

Example File: 3003.dat, the Implementation of a 2 x 2 Brick

0 Brick  2 x  2 0 Name: 3003.dat 0 Author: James Jessiman 0 !LDRAW_ORG Part UPDATE 2002-03 0 !LICENSE Redistributable under CCAL version 2.0 : see CAreadme.txt  0 BFC CERTIFY CCW  0 !HISTORY 2001-10-26 [PTadmin] Official Update 2001-01 0 !HISTORY 2002-05-07 [unknown] BFC Certification 0 !HISTORY 2002-06-11 [PTadmin] Official Update 2002-03 0 !HISTORY 2007-05-07 [PTadmin] Header formatted for Contributor Agreement 0 !HISTORY 2008-07-01 [PTadmin] Official Update 2008-01  1 16 0 4 0 1 0 0 0 -5 0 0 0 1 stud4.dat  0 BFC INVERTNEXT 1 16 0 24 0 16 0 0 0 -20 0 0 0 16 box5.dat  4 16 20 24 20 16 24 16 -16 24 16 -20 24 20 4 16 -20 24 20 -16 24 16 -16 24 -16 -20 24 -20 4 16 -20 24 -20 -16 24 -16 16 24 -16 20 24 -20 4 16 20 24 -20 16 24 -16 16 24 16 20 24 20  1 16 0 24 0 20 0 0 0 -24 0 0 0 20 box5.dat  1 16 10 0 10 1 0 0 0 1 0 0 0 1 stud.dat 1 16 -10 0 10 1 0 0 0 1 0 0 0 1 stud.dat 1 16 10 0 -10 1 0 0 0 1 0 0 0 1 stud.dat 1 16 -10 0 -10 1 0 0 0 1 0 0 0 1 stud.dat 

The above code defines the basic 2×2 brick. It consists of a five-sided box (box5.dat, outside) and an inverted five-sided box (inside), the connection between those two, consisting of four quads (the four lines starting with 4), the four studs on top of it (stud.dat) and the long hollow stud in the inside (stud4.dat).

All lines in an LDraw file are either empty or start with a command number, where 0 means no command (though over time, some lines starting with 0 followed by specific text in capitals also got a meaning as meta commands). [23] The command 1 for example includes a subfile. It specifies the file's path and a transformation matrix that should be applied to it, as well as its color (where 16 means "use the color that was used when including the current file"). Command 4 specifies a four-sided polygon. There are also commands that define 2D lines. Such lines give the parts a clear contour even in non-shaded orthographic renderings.

Example File: pyramid.ldr, a Lego Model of a Pyramid

The following code specifies a simple pyramid model with three layers made of 2 x 4 bricks (brick # 3001) with changing color and a 2 x 2 brick on top.

0 Example Pyramid for Demonstration of LDRAW Library 0 Name: pyramid.ldr 0 Author: James Jessiman  1 1 -40 -24 60 1 0 0 0 1 0 0 0 1 3001.dat 1 1 40 -24 60 1 0 0 0 1 0 0 0 1 3001.dat 1 1 60 -24 0 0 0 1 0 1 0 -1 0 0 3001.dat 1 1 40 -24 -60 1 0 0 0 1 0 0 0 1 3001.dat 1 1 -40 -24 -60 1 0 0 0 1 0 0 0 1 3001.dat 1 1 -60 -24 0 0 0 1 0 1 0 -1 0 0 3001.dat  0 STEP  1 4 -20 -48 40 1 0 0 0 1 0 0 0 1 3001.dat 1 4 40 -48 20 0 0 1 0 1 0 -1 0 0 3001.dat 1 4 20 -48 -40 1 0 0 0 1 0 0 0 1 3001.dat 1 4 -40 -48 -20 0 0 1 0 1 0 -1 0 0 3001.dat  0 STEP  1 14 0 -72 20 1 0 0 0 1 0 0 0 1 3001.dat 1 14 0 -72 -20 1 0 0 0 1 0 0 0 1 3001.dat  0 STEP  1 0 0 -96 0 1 0 0 0 1 0 0 0 1 3003.dat  0 STEP 

Other examples

See also

Related Research Articles

<span class="mw-page-title-main">Lego</span> Plastic construction toy

Lego is a line of plastic construction toys manufactured by the Lego Group, a privately held company based in Billund, Denmark. Lego consists of variously coloured interlocking plastic bricks made of acrylonitrile butadiene styrene (ABS) that accompany an array of gears, figurines called minifigures, and various other parts. Its pieces can be assembled and connected in many ways to construct objects, including vehicles, buildings, and working robots. Assembled Lego models can be taken apart, and their pieces can be reused to create new constructions.

<span class="mw-page-title-main">Ogg</span> Open container format maintained by the Xiph.Org Foundation

Ogg is a free, open container format maintained by the Xiph.Org Foundation. The authors of the Ogg format state that it is unrestricted by software patents and is designed to provide for efficient streaming and manipulation of high-quality digital multimedia. Its name is derived from "ogging", jargon from the computer game Netrek.

Lego Technic is a line of Lego interconnecting plastic rods and parts. The purpose of this series is to create advanced models of working vehicles and machines, compared to the simpler brick-building properties of normal Lego.

<span class="mw-page-title-main">Lego Duplo</span> Lego theme for toddlers

Lego Duplo is a core product range of the construction toy Lego by The Lego Group, designed for children from 1+12 to 5 years old. Duplo bricks are twice the size of traditional Lego bricks in each of their three dimensions, making them easier to handle and less likely to be swallowed and choked on by younger children. Despite their size, they are still compatible with traditional Lego bricks.

<span class="mw-page-title-main">EAGLE (program)</span> Scriptable electronic design automation application

EAGLE is a scriptable electronic design automation (EDA) application with schematic capture, printed circuit board (PCB) layout, auto-router and computer-aided manufacturing (CAM) features. EAGLE stands for Easily Applicable Graphical Layout Editor and is developed by CadSoft Computer GmbH. The company was acquired by Autodesk Inc. in 2016 who announced to support the product up to 2026 only.

<span class="mw-page-title-main">Lego minifigure</span> Plastic figurines manufactured by the Lego Group

A Lego minifigure, often simply referred to as a Lego figure or a minifig, is a small plastic articulated figurine made of special Lego bricks produced by Danish building toy manufacturer The Lego Group. They were first produced in 1978 and have been a success, with over 4 billion produced worldwide as of 2020. Minifigures are usually found within Lego sets, although they are also sold separately as collectables in blind bags, or can be custom-built in Lego stores and on lego.com. While some are named as specific characters, either licensed from already existing franchises or of Lego's own creation, many are unnamed and are designed simply to fit within a certain theme. They are highly customizable, and parts from different figures can be mixed and matched, resulting in many combinations.

<span class="mw-page-title-main">Lego Trains</span> Lego theme

Lego Trains is a product range and theme of the construction toy Lego, which incorporates buildable train sets. The Lego Trains theme became a sub-theme of Lego City in 2006. Products in the range have included locomotives, tracks, rolling stock, stations, signal boxes, and other track-side buildings and accessories. The theme is popular among adult fans, as well as children, and has spawned international associations and conventions. The train system is sometimes referred to as 'L-gauge' among Lego fans, in reference to traditional model railway scales. Lego trains use a nominal gauge of 37.5 mm, based on 5-stud track centerlines gauge, corresponding with a circa 1:38 scale.

Office Open XML is a zipped, XML-based file format developed by Microsoft for representing spreadsheets, charts, presentations and word processing documents. Ecma International standardized the initial version as ECMA-376. ISO and IEC standardized later versions as ISO/IEC 29500.

<span class="mw-page-title-main">Lego Mindstorms NXT</span> Programmable robotics kit

Lego Mindstorms NXT is a programmable robotics kit released by Lego on August 2, 2006. It replaced the Robotics Invention System, the first-generation Lego Mindstorms kit. The base kit ships in two versions: the retail version and the education base set. It comes with the NXT-G programming software or the optional LabVIEW for Lego Mindstorms. A variety of unofficial languages exist, such as NXC, NBC, leJOS NXJ, and RobotC. A second-generation set, Lego Mindstorms NXT 2.0, was released on August 1, 2009, with a color sensor and other upgrades. The third-generation EV3 was released in September 2013.

<span class="mw-page-title-main">Lego Digital Designer</span> Program to build models using virtual LEGO bricks

Lego Digital Designer is a discontinued CAD software made by Qube Software and the Lego Group. It allows people to design a virtual model using a selection of virtual Lego bricks. These models could be saved locally as uploaded to the Lego website for sharing and ordering as a physical product. It is available for macOS and Windows, but only as a 32-bit application, which means that it no longer runs on newer versions of macOS. The program allows users to build models using virtual Lego bricks, in a computer-aided design like manner. Until 16 January 2012, these could be uploaded, along with instructions and a box design, to the Lego Design byME website, from where the models could be ordered for delivery as a real, packaged set. Users can also take screenshots of their models and store the models on their computer in an .LXF file. On 9 November 2011, Lego declared that the Design byME service was going to end on 16 January 2012, due to its failure to meet quality expectations and for being too complex. In its absence, custom brick orders have had to be made via the Pick a Brick service. The closing of Design byME has not affected the ability of users to print custom instructions for their models.

<span class="mw-page-title-main">Lego clone</span> Childrens Lego-style construction blocks

A Lego clone is a line or brand of children's construction blocks which is mechanically compatible with Lego brand blocks, but is produced by another manufacturer. The blocks were originally patented by The Lego Group in 1961 as "toy building bricks", and the company has since remained dominant in this market. Some competitors have moved to take advantage of Lego brand recognition by advertising their own products as compatible with Lego, with statements such as "compatible with leading building bricks".

Nexo Knights is a 3D animated television series that aired on Cartoon Network and premiered in 2015. It was produced by the Lego Group to coincide with the Lego theme of the same name. The series is based on a fantasy castle concept and is set in a futuristic kingdom called Knighton, which is home to five young knights. The storyline follows the adventures of the five knights as they defend their home from a court jester named Jestro and his monsters. Four seasons were produced for a total of 40 episodes. The fourth season finished airing in 2017. In 2018, the Lego Group discontinued the Nexo Knights theme, which also resulted in the cancellation of the series.

<span class="mw-page-title-main">Well-known URI</span>

A well-known URI is a Uniform Resource Identifier for URL path prefixes that start with /.well-known/. They are implemented in webservers so that requests to the servers for well-known services or information are available at URLs consistent well-known locations across servers.

glTF 3D scene and model file format

glTF is a standard file format for three-dimensional scenes and models. A glTF file uses one of two possible file extensions: .gltf (JSON/ASCII) or .glb (binary). Both .gltf and .glb files may reference external binary and texture resources. Alternatively, both formats may be self-contained by directly embedding binary data buffers. An open standard developed and maintained by the Khronos Group, it supports 3D model geometry, appearance, scene graph hierarchy, and animation. It is intended to be a streamlined, interoperable format for the delivery of 3D assets, while minimizing file size and runtime processing by apps. As such, its creators have described it as the "JPEG of 3D."

<span class="mw-page-title-main">Hilary Page</span> English toy maker

Hilary "Harry" Fisher Page was an English toy maker and inventor of Self-Locking Building Bricks, the predecessor of Lego bricks. He founded the Kiddicraft toy company.

BrickLink is the largest online marketplace for reselling Lego products. Its website also offers resources for Lego fans, including an extensive catalog of products and parts and community forums.

<span class="mw-page-title-main">LeoCAD</span> CAD program for visualising Lego models

LeoCAD is a free and open-source 3D CAD program for creating virtual Lego models by using parts from LDraw library. It was developed by Leonardo Zide in 1997.

<span class="mw-page-title-main">Building blocks (toy)</span>

Building blocks are modular construction parts, usually made of plastic, which can be assembled in a form-fit manner. The basic components are usually cuboid-shaped, cylindrically studded at the top in a grid pattern, hollow-bodied at the bottom and smooth at the sides. The structured upper surface interacts by friction and positive locking with the correspondingly negative lower surface of other clamping components, so that complex designs can be assembled. The design allows the parts to be connected with compressive force and the blocks to be clamped with plastic pins.

<span class="mw-page-title-main">Lego fandom</span> Fan community

Lego fandom is the fan community that exists around the Lego toys.

References

  1. "LDraw.org - File Format 1.0.2". LDraw.org. Retrieved 9 July 2019.
  2. "LDraw.org - CATEGORY and KEYWORDS Language Extension". www.ldraw.org. Retrieved 2019-07-09.
  3. "LDraw.org - Colour Definition Language Extension". www.ldraw.org. Retrieved 2019-07-09.
  4. "LDraw.org - Language Extension for Back Face Culling (BFC)". www.ldraw.org. Retrieved 2019-07-09.
  5. "LDraw.org - MPD Language Extension". www.ldraw.org. Retrieved 2019-07-09.
  6. "LDraw.org - Official Model Repository (OMR) Specification Version 1.0.3". www.ldraw.org. Retrieved 2019-07-09.
  7. "LDraw.org - Language Extension for Texture Mapping". www.ldraw.org. Retrieved 2019-07-09.
  8. "LDraw.org - Localisation Guideline". www.ldraw.org. Retrieved 2019-07-09.
  9. Courtney, Bliss & Herrera 2003, p. 396.
  10. OrionP (8 November 2003). "James Jessiman Memorial". LDraw.org. Retrieved 9 July 2019. On July 25, 1997, James Jessiman passed away.
  11. "James Jessiman Memorial Award". LDraw.org. Retrieved 2024-09-01.
  12. "LDraw.org - James Jessiman Memorial". ldraw.org. Retrieved 2024-09-29.
  13. "Meet Leonardo Zide". wiki.ldraw.org. Retrieved 2024-09-29.
  14. "Scalable Ambient Obscurance". research.nvidia.com (Research). Retrieved 2024-09-30.
  15. McGuire, Morgan; Mara, Michael; Luebke, David (2012-06-25). "Scalable ambient obscurance". Proceedings of the Fourth ACM SIGGRAPH / Eurographics conference on High-Performance Graphics. Eurographics Association. pp. 97–103. ISBN   978-3-905674-41-5 . Retrieved 30 September 2024. We thank Naty Hoffman (Activision Studio Central), Leonardo Zide (Treyarch), and Louis Bavoil (NVIDIA) for their input on this paper and implementation, [...].
  16. "LDraw.org - LDraw File Format Specification". ldraw.org. Retrieved 2024-09-25.
  17. "LDraw measuring tools". philohome.com. Retrieved 2024-09-25.
  18. "LEGO Unit Converter". studs.sariel.pl. Retrieved 2024-09-25.
  19. "The LEGO Brick". The BYU Design Review. 2019-12-18. Retrieved 2024-09-25.
  20. Alphin, Tom. "LEGO figures in Scale models". BRICK ARCHITECT. Retrieved 2024-09-25.
  21. "Holly-Wood.it > LDraw > Helper parts". www.holly-wood.it. Retrieved 2024-10-03. HlduR.dat (Helper - LDU Ruler).
  22. Courtney, Bliss & Herrera 2003, p. 322.
  23. Courtney, Bliss & Herrera 2003, pp. 152–153.

Further reading