Getting Started - Linux

Before You Start...

These instructions assume you have some tools installed on your system. Here is a list:

wget

You can check if you have wget installed with the command:

wget --version

If you don't have it, you may download it from http://wget.sunsite.dk/.

Perl

You can check if you have Perl installed with the command:

perl --version

If you don't have it, you may download it from http://www.perl.org/.

bzip2

You can check if you have bzip2 installed with the command:

bzip2 --version

If you don't have it, you may download it from http://sources.redhat.com/bzip2/.

GNU Compiler Collection

LDraw tools for Linux come in source code form, so you need the GNU Compiler collection (at least gcc and make) to translate the programs to executable form. These tools usually come in the "development" section of your Linux distribution.

Step 1 (latest update 2006-01-06):

Download and install the LDraw Parts Library.

user$ cd /tmp
user$ wget [http://www.ldraw.org/files/unix-complete.tgz http://www.ldraw.org/files/unix-complete.tgz]
...
user$ su -
Password:
root# cd /usr/local/share/
root# tar xzf /tmp/unix-complete.tgz && echo OK
...
OK
root# mkdir -p ldraw/bitmap
root# chmod a+w ldraw/bitmap
root# chown -R root.root ldraw
root# exit
exit
user$

Step 2 (latest update 2006-01-06):

To view ldraw model use LDView. You can install RPM or tar.gz version (available on sf.net), or build from source. To install LDView3.tgz (root permission is not required):

user$ tar zxvf LDView3.tgz
user$ cd LDView3
user$ ./LDView

To install from RPM (root privilege is required):

root# rpm -i ldview-3.0-1.i386.rpm

To build from source:

user$ su -
root# cvs -z3 -d:pserver:[email protected]/cvsroot/ldview co LDView
root# cd LDView/QT
root# ./makeall
root# make install
root# exit
user$ LDView

Step 3 (latest update 2002-05-23):

Install LDGLite. LDGLite is a rather efficient tool for showing building instructions "on the fly", when you download them as ".dat", ".ldr" or ".mpd" files from the web.

user$ cd /tmp
user$ wget [http://ldglite.sourceforge.net/ldglitesrc0_9_5.zip http://ldglite.sourceforge.net/ldglitesrc0_9_5.zip]
...
user$ unzip -uoa ldglitesrc0_9_5.zip
...
user$ cd ldglite
user$ make -f makefile.linux && echo OK
...
OK

There is a small risk that you may run into errors at this point, if your system lacks some libraries. These errors will probably be of the form .../bin/ld: cannot find -lX11. If you don't know how to handle this, please contact an experienced Linux system administrator.

user$ su
Password:
root# chown root.root l3glite l3gledit ldglite readme.txt
root# mv l3glite l3gledit ldglite /usr/local/bin
root# mv readme.txt /usr/local/share/ldraw/ldglite.readme
root# exit
exit
user$ cd ..
user$ rm -rf ldglite

Now you should be ready to run LDGLite - as the command ldglite - but since the LDraw library has been placed differently from what LDGLite expects, you have to set the environment variable LDRAWDIR to that directory (/usr/local/share/ldraw). You can do that in your runtime configuration scripts, just before you run ldglite, or you can create a script that sets LDRAWDIR and then calls ldglite. I have chosen the last of these three solutions (where I also make sure that there is no limits on the stack size):

user$ su
Password:
root# cat > /usr/local/bin/ldglite-run << THE-END
? #!/bin/tcsh
? setenv LDRAWDIR /usr/local/share/ldraw
? limit stacksize unlimited
? /usr/local/bin/ldglite \$*
? THE-END
root# chmod a+x /usr/local/bin/ldglite-run
root# cat >> /etc/mailcap << THE-END
? application/x-ldraw;/usr/local/bin/ldglite-run -mc %s
? application/x-multi-part-ldraw;/usr/local/bin/ldglite-run -mc %s
? THE-END
root# exit
exit
user$

Step 4 (latest update 2002-05-23):

Now your browser should be ready to open LEGO building instructions directly in LDGLite, when you click on links to them on the internet. You can test it by clicking on tux.dat, which should open a window with building instructions for a penguin (Tux, the mascot of Linux). You may have to restart your browser to make it recognise the existence of LDGLite.

Step 5:

There are currently two ways to create LEGO building instructions on your computer. You can either write/edit the raw text LDraw files or you can use an interactive drawing program, where you can move pieces around on the screen. If you chose the former method, you should just use your usual text editor and skip this step. If you would like to try the latter method, you should install the program LeoCAD.

= [http://www.leocad.org/" target="_top <img src="/gallery/album47/leocad.png" width="150" height="128" alt="" border="0" align="right LeoCAD ]=

LeoCAD is a great 3D editor for Linux (and Windows) which has offered several improvements to the straight LDraw .dat format. It supports some basic animation (via keyframing) and can also export to 3DStudioMax, POV-Ray, and Alias Wavefront.

To compile: (last update 2006-01-06)

user$ svn co http://svn.gerf.org/svn/leocad/tags/leocad-0-74 leocad
user$ cd leocad
user$ make
user# strip bin/leocad
user$ su -
Password:
root# cp bin/leocad /usr/local/bin/

LeoCAD has different part database, what is available at http://www.leocad.org/files

root# cd /tmp
root# wget [http://www.leocad.org/files/pieces.zip http://www.leocad.org/files/pieces.zip]
root# wget [http://www.leocad.org/files/update18.zip http://www.leocad.org/files/update18.zip]
root# mkdir /usr/local/share/leocad
root# cd /usr/local/share/leocad
root# unzip /tmp/pieces.zip
root# unzip /tmp/update18.zip
root# 
root# leocad -l /usr/local/share/leocad

Step 6:

=Dive In!=

Learning how to use your new editor or understanding the LDraw file

format may be a challenge, but with a little practice you will get the hang of it. The [http://www.leocad.org/manual/index.htm LeoCAD Manual] by Leonardo Zide will help you getting started.

Step 7:

=[http://www.ldraw.org/article/140 Introduction to LDraw Utilities]=

There is a lot you can do with LDraw files beyond just creating LEGO models! Many contributors have developed utilities to make the most of the LDraw file format. Check out a brief introduction to a few utilities, and then move on to download them.

Download Software

Check out LDraw.org's (incomplete) list of software packages to download which supplement the standard editors. Download programs like L3P, POV-Ray, various file format converters and rendering tools.

Help!

Need help with any of this? Check out LDraw.org's Help Section, pr check out the Lugnet CAD discussion groups and ask a large group of users for help.