Skip to content
Nils Schmidt edited this page Apr 19, 2015 · 101 revisions

LDPartEditor User Manual (Work In Progress)


This manual does not cover all official LDraw specifications which were ratified by the LDraw Standards Commitee. If you want to start from the beginning, you should probably read the specifications first and gather some experience from the community forums to get started.

Becoming famliar with "part authoring", the creation of parts, is just like playing an instrument: it is a matter of talent, time and effort.

If you want to drop me a note, please create an issue here.

Version 0.8.0

Table of Contents

  1. Getting Started
  2. The Welcome Dialog
  3. The Text Editor
  4. The 3D Editor

0. Getting Started


Make sure that you choose the right architecture for your OS and JVM (64bit or 32bit). Does my JVM support 64-bit?

  1. Download the zip-Archive from here. I recommend to use the 64-bit version, if possible.
  2. Extract the archive content to the location of your choice
    • On windows, double-click "run.bat" to start LPE.
    • On linux/mac, you have to excecute the shell script "run.sh" to start LPE.

The application folder

Please note that this software is in the beta stage. Although, LPE 0.8.0 was carefully tested and developed, there are already known issues for this release. There is a potential risk of data loss.

1. The Welcome Dialog


When you start LDPartEditor for the first time (or you had reset the configuration), you will see the "Welcome Dialog". In this dialog you can specify the path of your LDraw Library, your LDraw Parts Tracker Username and your Real Name.

Dialog on first start

Note: If you want to contribute to the official LDraw library as a part author you have to agree to release the Work under the Creative Commons Attribution License version 2.0 ("the CCAL"). More info here.

Additionally, you can set your part authoring folder and the folder for the unofficial parts library. The benefits of using a seperate library for unofficial parts are quite self-explanatory: You can't mess up the official library content with LDPartEditor.

Note: In the next release 0.8.1, the LDraw path and the unofficial path folder will be automagically filled if you had set the environment variable %LDRAWDIR% (Windows only)

When all paths are specified, you can hit the OK button. The program will load the primitives first and then it will parse the first line of each official library part. This will take some time and it is slower than parsing the parts.lst file, but it guarantees that you will the see the actual library content.

Pro Tip: The application folder will contain a file named config.gz which stores your personal configuration. You can delete this file if you want to reset your settings. This may be neccessary if the 3D view is broken.

2. The Text Editor


The Text Editor

The text editor let you edit the content of a *.dat file.

Pro Tip: You can drag and drop the tabs on other text editor windows and rearrange their order.

Shortkeys:

Keys Action
Alt+Shift+R Sync Edit Edit vertex coordinates ("SyncEdit")
Esc Cancel "SyncEdit"
Alt+F Quick fix all issues in the selection
Ctrl+A Select all
Alt+I Inline selection
Alt+C Round selection
Ctrl+Z Undo
Ctrl+Y Redo
Ctrl+S Save

Analysing Part Errors:

Double Click on Error

A double click on an item in the error list will highlight the line in the text editor.

Context Menu On Error

With a right click, you can open the context menu and trigger a quick fix.

Note: Not all errors and warnings can be fixed automatically. Some of them require human brainpower.

Buttons:

Button Action
New Dat Creates a new *.dat file
OpenDat Opens an existing *.dat file
Undo Undo (max. 100 steps)
Undo Redo
Cut Cut
Copy Copy
Paste Paste
Delete Delete
Toggle Error List Toggles the part error list visibility.
Find and Replace Opens a standard search and replace dialog. The dialog uses the text editor tab which was last selected.
Sort Sorts the text editor content by a custom criteria. You can set the scope to file or selection and you can sort by... 1. ...colour, ascending. 2. ...colour, descending. 3. ...type, ascending. 4. ...type, descending. 5. ...type and then colour, ascending. 6. ...type and then colour, descending. Pro Tip: The sorting process will not change the BFC winding or !TEXMAP definitions.
Split Quads Splits selected quad lines (type 4) into triangles (type 3)
Unrectifier Splits all quad lines (type 4) into triangles (type 3) and inlines all rect primitives
Duplicates Removes all duplicates and all invisible optional lines
Inline Inlines the selection with partial BFC conformity
Inline Deep Inlines the selection recursively with partial BFC conformity and no comments and whitespace ("Deep Inline")
Inline Linked Inlines the selection "linked" so that the inlined file can be automatically exported with the Subfile Compiler (see Features for the advanced user)
Compile Subfile Data Parses the file for !LPE INLINE meta commands and builds the subfiles automatically (see Features for the advanced user)
Round Rounds the selection. Rounding Settings You can customise the rounding settings by pressing Ctrl and clicking on this button
Toggle TEXMAP Toggles texmap geometry data meta command for the selected text !:
Toggle Comment Toggles the comment mask for the selected text
Palette Opens a dialog for choosing a colour for the selected text. Pro Tip: You can customise the colour palette by pressing Ctrl and clicking on a colour button

Features for the advanced user

3. The 3D Editor


The 3DEditor

Clone this wiki locally