Holly-Wood.it
Contact About me
Home > MLCad > Setup tutorial

< Back

Home
Building Instructions
Installation advice for the LDraw Parts Library and MLCad  
 
This tutorial will teach you how to set up a simple LDraw system with the MLCad editor and the LDraw Parts Library. Furthermore it will show you tips and tricks and help with troubleshooting problems you might encounter. The tutorial assumes that both the install files:

LDrawParts.exe – http://www.ldraw.org/Downloads-req-viewdownload-cid-1.html
mlcad330.zip – http://www.lm-software.com/mlcad/

have been downloaded to your hard disk. The tutorial is based on MLCad 3.3 and the new unified LDraw Parts Library 2008-01 and is grouped in two sections:

Installing the LDraw Parts Library
Installing MLCad

 
 
Installing the LDraw parts library  top
 
The LDraw parts library is a collection of LDraw-format CAD files representing many of LEGO bricks produced. The parts library is required to use any of the LDraw CAD programs such as MLCad, LPUb or LDView.
 
Screenshot1
 
1.

First we are going to install the LDraw Parts Library. Either double click the executable LDrawParts.exe setup file or select Open from the contextual menu. This pops up a dialogue asking for your preferred language. Select English from the drop down box and confirm you choice by hitting the OK button.

 
LDraw
MLCad
Wallpapers
Space
Western/Studios
Miscellaneous
LSynth
LDView
Sitemap
[ deutsch ]
[ italiano ]
  Screenshot2  
 
  2. There haven't yet been any compatibility problems reported with other applications (including programs of the LDraw System of Tools) running while installing the library; nonetheless it is a good idea to follow this recommendation. Click the Next > button and proceed to the next dialogue only AFTER you have saved your work and closed all open programs.
 
Screenshot3  
 
  3. Read the License Agreement for the LDraw Parts Library by scrolling down and understand the legal terms of the license. After installation you can find the Legal Code (CAlicense.txt) as well as the easy-reading text shown in the above dialogue (CAreadme.txt) in the library's root folder or on the LDraw.org web site. An addition you'll find some rules (NonCAreadme.txt) which governs so-called NonCA-Parts.  
4. After reading and agreeing with the license select I accept the agreement to proceed with the installation or press Cancel to abandon the setup.
5. The Next > button will only become accessible after you've agreed to the license terms. Click Next > and go to the next screen.
 
Screenshot4  
6. It is recommended that you install the library in the proposed C:\Programs\LDraw folder. Change the location only if you're an experienced user.
7. Click the Next > button and proceed to the next dialog.
Screenshot5
 
 
8. The type of installation chosen from the drop down box allows you to install the following segments of the official LDraw library.

Core parts library The library of officially released parts for which the authors have agreed to the Contributor Agreement, allowing their work to be re-distributed. Full details of this agreement can be found in the CAreadme.txt and CAlicense.txt files in the same folder as this file. This download is restricted to generic colour versions of each part and does not contain duplicate copies of part files where different numbers have been used for the same physical part. This library may be re-distributed, subject to the conditions laid out in CAreadme.txt.
Alias parts library The library of officially released part aliases. This includes generic colour versions of parts that are physically identical to parts in the core parts library, but have a different part numbers, either because of production differences between opaque and transparent parts or due to evolution of the part numbering scheme.
Physical colour parts library The library of officially released physical colour parts. This includes hard-coded colour versions of parts or composite parts.
Non re-distributable parts library The library of officially released parts for which the authors have not agreed to the Contributor Agreement, or where we have been unable to contact the original author. This download is restricted to generic colour versions of each part and does not contain duplicate copies of part files where different numbers have been used for the same physical part. This library MAY NOT be re-distributed, as detailed in the conditions laid out in NonCAreadme.txt file.

For broadest use I recommend installing:
  • Core parts library
  • Non re-distributable parts library
but NOT:
  • Alias parts library
  • Physical colour parts library
 
   
     
   
  9. Click the Next > button and proceed to the next dialogue.  
 
  Screenshot6  
 
  10. Check the summary of your settings and...
11. Click the Install button to start copying the files.
 
  Screenshot7
 
  12. You may abort the installation at any time by selecting the Cancel.
 
Screenshot8  
 
13. The installer will roll back and delete all files which may have been installed up to this stage if you confirm this dialog.  
 
Screenshot9  
 
  14. Once all the part files have been installed the setup program will automatically start mklist.exe. This is an utility that creates the list of available parts. This list (parts.lst) is used by MLCad and by several other third-party utilities. You should re-run MKList after installing new parts updates, or you may run it at any other time to change the sort order of your list of parts. In the unlikely event the installer failed to run this parts list compiler you have to run it manually. Navigate to the LDraw folder launch mklist.exe and choose to create the list sorted [N]umerically or by [D]escription. Most people use Description sorting and enter a D or d in the pop-up dialogue, but you can change to whichever order you prefer at any time by re-running mklist.exe.  
 
  Screenshot10  
 
15. Click the Finish button to exit setup.  
 
  Screenshot11  
 
  16. At this stage your LDraw folder should contain the above files and subdirectories:  
 
 
\MODELS\ Directory where your model .dat files are stored. There are two sample model .dat files installed for you to look at - Car.dat and Pyramid.dat.
\P\ Directory where parts primitives are located. Parts primitives are typically highly reusable components used by the part files in the LDraw library.
\P\48\ Directory where high resolution parts primitives are located. These are typically used for large curved parts where excessive scaling of the regular curved primitives would produce an undesirable result.
\PARTS\ This directory holds all the actual parts that can be used in creating or rendering your models. A list of these parts can be seen by viewing the parts.lst file in a text editor.
\PARTS\S\ This directory holds sub-parts that are used by the LDraw parts to optimise file size and improve parts development efficiency.
mklist.exe Utility that creates a list of available parts. Read above for more details.
mklist-c.zip Zip archive of the MKList source code.
PARTS.LST Your listing of all usable parts available. This list is created by running MKList.exe and choosing to create the list sorted [N]umerically or by [D]escription. Read above for more details. The content can be viewed in a text editor.
ldconfig.ldr Configuration file specifying the properties of LDraw colours.
ldcfgalt.ldr Alternative configuration file specifying the properties of LDraw colours with LDraw-style edges.
CAlicense.txt Legal Code (the full license) for the LDraw Parts Library licensed by the Creative Commons Attribution Licence 2.0 as specified by the LDraw Contributor Agreement (CA).
CAreadme.txt README file with human-readable expression of some key terms to understand the Legal Code (the full license) for the LDraw Parts Library licensed by the Creative Commons Attribution Licence 2.0 as specified by the LDraw Contributor Agreement (CA).
NonCAreadme.txt README file for the LDraw NonCA-Parts Library NOT licensed by the Creative Commons Attribution Licence 2.0 as specified by the LDraw Contributor Agreement (CA).
Readme.txt Short README file explaining what files and subdirectories are present in your LDraw installation, describing the LDraw library structure and listing links to some sites on the internet where you can find help and further information.
unins000.exe Uninstaller to remove the LDraw Parts Library with all his files.
unins000.dat Setup uninstall log file created during setup needed by the uninstaller utiliy.
 
 
  Installing MLCad  top
 
  You are now ready to install MLCad, the actual editor, to build models and output pictures as well as building instructions and parts lists.  
 
  Screenshot12  
 
17. Unpack the content of mlcad330.zip into the C:\Programs\MLCad folder and launch the MLCAD.exe program (consider creating program shortcuts in the Start Menu folder as well as Desktop and Quick Launch icons).  
 
Screenshot13  
 
  18. Before MLCad's standard interface will pop up you have to define the path to the LDraw Parts Library if the program cannot find the path to the \Parts\ and \P\ directories itself. This has to be done only once. MLCad will store the location in its registry. Enter C:\Programs\LDraw into the Base path: box or browse for it.
 
 
Screenshot14  
 
19. Confirm your choice with OK after the Status: field has changed to OK!
 
Screenshot15  
 
  20. The first time you start up MLCad the interface will show all tool bars and so-called panes - and yes, it will look a bit messy. The pile of bars and panes have to be rearranged to accommodate proper working. The bars can be moved around, float above the interface or be docked to the borders. Move your cursor to the small vertical line at the left-hand border of the single bars, press and hold the left mouse-button and move the mouse to relocate the toolbar to a new position. The panes can be resized by moving the cursor over the border dividing them. Once the cursor has changed hold the left mouse-button and drag the border in the direction shown by the small arrows. Release the mouse-button then the pane has shrunk or grown to the desired size.
If you have a small monitor with low resolution it is recommended you hide some of those which are seldom needed. Select the View menu, the Toolbars tab, then Expert bar (View > Toolbars > Expertbar). This will deselect/untick the bar from the list. Hide:
  • Expertbar
  • Extasbar
  • Controlbar
 
  (The screenshot shows all menus and dialogs in one composed image).
Screenshot16
 
 
  21. The next step is to change some of MLCad's default settings to ease working with the interface. Its not really important that you understand all the details explained below right away – I'll report them just for completeness and later reference. For now select: Settings > General > Change...  
22. In the pop-up dialogue select the General tab.
23. Copy the setting as shown above. If you think they don't accommodate the way you work feel free to change them:
  • The LDraw base path has already been set at the first launch of the program. If for some reason you wanna change it or would like to load an alternative LDraw Parts Library simply press the Browse... button and search for the new directory.
  • Enter your name or nickname in the Author name: box. This name will brand all LDraw model files you create with your name.
  • Uncheck Show Warnings. Most of the warning produced by MLCad are related to erroneous references in LDraw parts, multiple version or parts their part number has changed. If your Parts Library doesn't contain any unofficial or custom part files it is however very unlikely that MLCad will encounter any problems and pop-up a warning. It is strongly recommended to disable the warnings if you plan to download and work with the library of non-certified parts. The number and frequency of the pop-ups can be rather annoying though it doesn't add much to your building experience.
  • Make sure Enable screen selection is checked. It allows you selecting parts in the building area by holding the left mouse-button and dragging a rectangle. All parts within or touched by the rectangle and not hidden by others will be selected. A comfortable way selecting transparent parts which are sometimes hard to catch by simple clicking on them.
  • Check Activate edit mode on load. If checked, automatically activates the Edit Mode when a new model is loaded, otherwise MLCad activates the View Mode.
  • Check Register file types. It will register the file type .dat, .ldr and .mpd to MLCad. File type associations help Windows identify the programs that are required to open certain files or applications and automatically start the program when you for example double-click on the file in your Windows Explorer.
  • Select On in the Automatic part upgrade drop down box. This setting controls how MLCad handles updated parts during the load of a model containing an old version of those parts. MLCad detects updated parts by looking at the first comment line within the part. If it contains ~moved to in the parts description the part needs to be updated:
    • If the option is Off MLCad will not check for newer parts.
    • Selecting Ask MLCad will check for newer parts and opens a dialog asking if it should update the model to use the newer parts.
    • The third option On causes MLCad to update the model always without asking. However you will get a message after parts have been updated. Upgrading in this term means, that references to older versions of a part are replaced with references to the newest parts, parts not updated are left untouched.
  • The Language drop down box toggles the program's language between its native English and other supported languages. If you haven't downloaded and installed any localized language files it will offer only English. Read more in the language tutorial.
 
  Screenshot17  
   
24. Select the Rendering tab.  
  25. Set the options as shown in the screenshot:
  • Check Shading. It will apply a lighting effect to depicting depth perception in your 3D models by varying levels of darkness.
  • Leave Perspective unchecked. This settings affects only the 3D rendering in View Mode, drawing the model in a way that all lines converge to one point augmenting the visual effect. The 3D view in Edit Mode will be always rendered in isometric perspective with all projected line parallel. Since real LEGO building instructions use isometric illustrations it is general practice to not use central perspective.
  • Use BFC statements will only become selectable after Off has been chosen in the Optimization drop down box. BFC stands for back-face culling and determines whether a polygon of a graphical object is visible to the user. The process makes rendering objects quicker and more efficient by reducing the number of polygons for the program to draw. With version 3.00 a completely new, much faster rendering mechanism - much faster than BFC could ever do - has been added, making BFC obsolete. It is present solely for backwards compatibility.
  • Select Maximum in the Optimization drop down box. This option selects internal optimization algorithm which require more memory but result in higher drawing speed.
  • Choose 1 from the drop down box for Line width. All edge lines of LDraw parts will be drawn 1 pixel wide.
  • The Stud mode will heavily affect rendering time and computer power since almost all LDraw part come with at least one stud and they tend to sum up quickly. Normal is fine for small and medium models while it is considered to turn off them altogether when working on large layouts like the moonbase you can see in the wallpaper section:
    • None. No studs will be rendered resulting in lesser memory consumption.
    • Lines. The studs will be represented by a small line.
    • Coarse. A low-res version of the stud using 8 facets instead of the default 16 will be used. The logical choice for all those with little memory or a slow computer since it offers enough detail for fast positioning by not eating all your memory.
    • Normal. Shows the stud in its full glory. Most useful when working in SNOT – Stud not on top or very precise positioning is required and all those who won't compromise on the graphics quality.
  • Activate Draw to selected object only. MLCad goes through the list of parts in the project from top to bottom, executing it line by line and will not draw the remaining parts after the current selected part. If this checkbox is unchecked, all parts are always drawn. This option has no effect in View Mode.

    Note: For fast operation do not activate this mode since the program can use internal speed up routines.
  • Hit the button in the Edit & View mode options box and select a Background Color for the background in the building area if you don't like the default white. The color will be used also as background color for your saved building instructions images but note that it will not be stored in the model file itself.
  • Chose Main-Color (color number 16) for the Color in the Preview options box. Main-Color is a sort of light gray that will augment details – especially on patterned bricks – in the Parts Preview pane and at the same time will not falsify the brick's coloring since all parts in the LDraw Parts Library are by default colored with Main-Color 16.
  • Check Small images. You will see smaller but more parts in the Parts Preview pane. Alternatively click with the right mouse-button in the Parts Preview pane to switch between a larger and smaller representation without the need to call up the settings dialog itself.
26. Close the dialogue by hitting OK.
 
  Your MLCad/LDraw system should now be properly set up and you're ready to start building. You may have also a look at the tutorial to customise MLCad a bit through the MLCad.ini file.

MLCad well!

 top
home | building instructions | ldraw | mlcad | wallpapers | space | western/studios | miscellaneous | lsynth | ldview | sitemap | contact | about me
All content is provided as is, with no warranty stated or implied regarding the quality or accuracy of any content on or off this site.
LEGO® is a trademark of the LEGO Group of companies which does not sponsor, authorize or endorse this site.