This repository contains code to model LEGO® bricks with the OpenSCAD parametric 3D CAD software.
include <lego.scad>
brick(4, 2);
translate([0, unit_width * 3, 0]) plate(2, 2);
translate([0, 0, brick_height * 2]) tile(4, 2);
- u - the so-called "LEGO unit" (1.6mm) which other measurements are defined in terms of.
Other absolute measurements in mm:
- stud_height - height of a stud (1 unit).
- brick_height - height of one brick without studs (6 units).
- plate_height - height of one plate without studs, or of a tile (2 units).
- base_width - width of a one-stud brick or plate (5 units).
- half_width - half the width of a one-stud bric or plate (2.5 units).
These constants can be useful for positioning bricks in a model.
The following helper functions help translate units or base widths into
absolute measurements in mm. Writing something like u(5) or base_width(4) is
significantly less verbose than (u * 5) or (base_width * 5) in complex
expressions.
- u(n) - width of n LEGO units in mm
- base_width(n) - width in mm of a brick with this many studs across
Create a brick with given dimensions.
brick(width, depth, height, studs = true/false, posts = true/false);
Parameters:
- width, depth - dimensions of the brick, measured in studs.
- height - absolute height in mm of brick without studs (default 5 units).
- studs - if true (default), include studs on top and dimples underneath them.
- posts - if true (default), include interior posts.
Create a plate with given dimensions. A plate is a brick of one third height.
plate(width, depth, studs = true/false, posts = true/false);
Parameters:
- width, depth - dimensions of the plate, measured in studs.
- studs - if true (default), include studs on top and dimples underneath them.
- posts - if true (default), include interior posts.
Create a tile with given dimensions. A tile is a plate without studs on top. Modern tiles also have a groove along the bottom edges to facilitate easier removal.
tile(width, depth, posts = true/false, groove = true/false);
Parameters:
- width, depth - dimensions of the plate, measured in studs.
- posts - if true (default except as noted below), include interior posts.
- groove - if true (default), include a groove around the bottom edges.
Interior posts are included by default, except for the special case of a 2x1 (or 1x2) tile, which has no interior post by default.
- https://bricks.stackexchange.com/questions/288/what-are-the-dimensions-of-a-lego-brick
- https://www.bartneck.de/2019/04/21/lego-brick-dimensions-and-measurements/
- http://www.robertcailliau.eu/en/Alphabetical/L/Lego/Dimensions/General%20Considerations/
- https://rebrickable.com/parts/3069a/tile-1-x-2-without-groove/
Andrew Ho andrew@zeuscat.com
LEGO® is a trademark of the LEGO Group of companies which does not sponsor, authorize or endorse this site. The files in this repository are authored by Andrew Ho and are covered by the following 3-clause BSD license:
Copyright (c) 2020, Andrew Ho.
All rights reserved.
Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions
are met:
Redistributions of source code must retain the above copyright notice,
this list of conditions and the following disclaimer.
Redistributions in binary form must reproduce the above copyright
notice, this list of conditions and the following disclaimer in the
documentation and/or other materials provided with the distribution.
Neither the name of the author nor the names of its contributors may
be used to endorse or promote products derived from this software
without specific prior written permission.
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.