BrickUtils User Manual
Contents
1. select a icon Import bricks and click on LDD project LXF LXFML Once you select an LDD file you will see a progress bar Ha E Import LDD project file Reading LDD project file a 6 Fig 5 LDD project import On success you will see a summary dialog Fig 6 Yes BrickUtils can handle really big projects LDD Import i Imported 18487 bricks Fig 6 LDD project imported When you click on OK button imported parts will transferred on Working List 5 4 Import Ldraw project BrickUtils can import projects in standard Ldraw file format LDR DAT and MPD see Ldraw documentation http www Idraw org As for all other formats go in Working List and select Ny icon Import bricks select LDraw project and the file with project from your computer A progress bar will show Import LDraw project file Reading LDraw project file 27 Fig 7 Importing an Ldraw project As usual you will get a summary on success Fig 8 LDraw Import i Imported 1430 bricks Fig 8 Successfully imported When you click OK button imported parts will transferred on Working List 5 5 Working list editing In the Working list you can edit imported lists or create it manually using search functions available for all part catalog In the toolbar there are a group of buttons e ee S insert a part in list selecting from LDD Bricklink or L2. So you can create special part even if not listed in conversion rules 5 6 Export a list for Bricklink Once you have a populated Working list for example from an imported LDD project you can generate an XML file in Bricklink format to buy bulk parts From Working list click on 9 button Export bricks and select Bricklink mass upload XML from popup menu After you choose a file name you get a dialog to define some options related to how Bricklink will use your imported list e Bricklink export options A List ID empty for main i n Include quantity Enable notification Include in queries Fig 11 Bricklink export dialog The meaning and use of dialog options is known to Bricklink user and will not explained here Your XML file must be loaded in the mass upload page in Bricklink website see http www bricklink com help asp helpID 207 5 7 Exporta printable HTML list You can generate a bill of material also with parts in Working list Click on button Export bricks and select HTML list printable After you choose a file name you get a dialog with some preferences related to the aspect of HTML list HTML export options Add a checkbox Include brick image Image size default 100x100p4 Fig 12 Esportazione HTML You can add a checkbox for every part an image for part define text and image Size The generated list can be viewed in an
3. BrickUtils is a free and Open Source software release under the terms of GNU General Public License version 3 or later at your option So you don t need to pay for any license at all and you don t have to pay anything to anyone to use BrickUtils BrickUtils comes with no warranty of any kind You can use the program as is and if program don t match your expectations don t use it 4 6 Support To obtain support about program you can contact me with my e mail listed at the start of this document or you can go to the program website that you can find in the About dialog There is a mailing list for news and update announcements in the Sourceforge page Please note that BrickUtils was created for my personal use and giving support to user isn t my work Question that are answered in documentation will be ignored 4 7 New releases New versions and updates are released when ready There is no planning Please refer to program website that you can find in About dialog There are some planned features but there is no timeline for releases 4 8 System requirements BrickUtils will require nothing special to works Every computer sold from 2007 will works fine Minimum requirement are e 100MB total disk space program database indexes Ldraw part libraries e 1GBRAM e OpenGL capable video card with minimal 3D acceleration any video card sold from 2007 e monitor with 1024x768 resolution e Java Runtime Environment 6 o
4. EXporta Printable HTM standard dada 15 SO EXPO USA dl 16 SF Osby opto Ale TCS A E e E O O 17 5 9 Migrating from PYLORI i 17 SALO Working MGT And S EU taa 18 LOL Lotorsetidenti icanon datde aia cemnsaeeae 18 OZ AO O CO co ad 20 So a AAA O 20 SI O 21 A TON 21 SA PCa OE O 22 o MISSE DICK COCO R a tadduosessononeonsemecaes 22 5 14 Reference catalogs UP dd 24 5141 Bricklink catalogs Update Sion escenes ne O R 24 914 2 Brick ink Set UPGaleS A N E ei eas 24 2 143 Brick lik parts Cadtalog UPlate sane 25 5 14 4 Bricklink colors and categories UPCate ssseesssssssseeeeccccccececceseaeeeeeeeeecseaeeeseesseeees 26 514 5 Ldraw part libraries UPA A E 26 Sal Programi DUCTAL CNCCS roer O anaes 26 6 BrickUtils Template Cocumentation cccccccsssensssesssccccesccnsssssseccccceecesssesssscccesecessssssenasesceeess 27 6 1 Examples and ready to use templates sssssseesssccccceccccccceeensssssssssssscececcaeescecceasesceees 27 6 2 Date avallablesto templates dadas 27 o RCA 27 EAE EE I E E E E E EEA E S T E TE E E E E AEE 28 02 OPTION r a TO ET EOT 28 1 Legalese LEGO LEGO Digital Designer LEGO Technic are trademarks of the LEGO Group based in Billund Denmark LEGO sets parts and colors are exclusive property of LEGO group BrickUtils is NOT related linked sponsored or supported by LEGO Group 2 Thanks This program cannot be made without databases made available from BrickLink team Man
5. Round 2x20 ere aere R67Bb _ls678b dat_ MENENIE 41 lope 65 2 x2 x2 with Bottom Tube il ae a T E T H List identification Brick shape Set type Official set Set id 3065 1 Set name Olivia s Tree House Category Friends 771 Set year 2012 Notes Available for building yes Brick count 210 Part count 74 Index EEES pora 4 PRAT O O 4 SAS MOS A A A bis 4 ES EN tocino 4 3 2 Changes to previous releasePython VEersiON sssssssescscccccccccccccceeensssssssesssseeeeeceeceeeceeeens 5 Z Vila SVE WTI Ue 5 SALTON RO 5 AEO E A A E E EEE AA E E E AAE N E EAEI E A 6 JEWS A A E 6 A OW To FICK LIS WOLKS cancion si chaesecarp et sin sen Guess anindaceep a teas aneiees 6 A hal Buck USOS A 6 4 4 What Brick WIS won Meyer tidad Seale wide Rihciaiaesntek 7 AS Licenseand WA di 7 ASI O e o o ls da io ately 7 47 NeW TClCASOS unae s a 7 AA A sbawnstsaendaul asbateadteciagede hewnessoesce aa 8 4o TINS es AU o OACI RO 8 A 10 Whereis program dataDase an janice S E 8 AV INIOVG Proa iia 9 AZ VIIA star 9 AMS IDA O aa 9 414 Conversion rales Update nia AA 9 OW OLIN Wi BCS aa aR a n 10 A e cheesy at teadaet 10 Dempo fr Ol AytCk MINK sassacensceamenunetyodeapucsanecautussean taemennnetuecbumeciandaaetuasean aeaceanasaneietuaeaactaeeret 10 Zo MPO LODO aia 11 Import Laraw PLO eb aia 12 da VV OTIS SC ei catala 12 Sl Insert part ion Cal hrs since E OAOA 13 59 2 Change c talos ID TOT Pi 15 SO Exporta st LOL Brake din 15 Do
6. Working list and clears all information entered e Set brick list name Abc to define list name and some other properties e Add to catalog hs to add list as a set or a generic lot 5 10 1 Lot or set identification data To save a list in Working list as a set or lot you need to assign a name and some identification data Click on 4 button to recall a dialog that asks for it Define brick list data Official set id Type ormicalset le Set name Category Other 143 m Year Po Notes Po Set is available for new builds Fig 17 Set data dialog Fields meaning is Official set id it is the number that LEGO Company use to identify an official set It is needed only if your list belongs to an official set If it is a generic lot you can ignore it Search button allow you to search in the Bricklink set database Fig 18 using some parameters o By set set ID contains search type o By generic text free text with full text search rules see 5 5 1 o Release year year when LEGO Company released the set can be exactly before or after By category to search by Bricklink category Search in Gricklink set database Description we et veais e Jr ooo Say cesen omoa id Fig 18 Set search dialog Type can be o Official set it is an official LEGO set o Generic Lot it is bulk lot of parts o MOC built it is a group of
7. codes 4 2 How BrickUtils works It is an open source licensed software developed in Java and uses H2 database totally open source and Java based too to hold all data it needs to work So you don t need to pay any license at all or you don t have to pay anything to anyone to use BrickUtils BrickUtils works on any operating system and platform where Java release 6 is available BrickUtils uses catalog of bricks and sets available from BrickLink Without this catalog program cannot work or works really bad Below we see how get this catalog and how to use it 4 3 What BrickUtils do e Imports LEGO Digital Designer project file LXF or LXFML e Imports BrickLink set inventory and store inventory only for store owners e Imports LDraw file format MPD or LDR e Automatically convert part ID between LDD BrickLink and LDraw part catalogs e Manage your collection of bricks sets MOCs and custom lot of bricks e Display brick shape from LDraw part library e Checks if you can build a model from LDD LDraw or a BrickLink set against your brick catalog and helps you to find alternate bricks e Exports BrickLink Wanted Mass Upload XML file to buy bricks on BrickLink e Exports lists in printable HTML to helps pick bricks from your collection a bill of materials e Exports via template engine allows to create on the fly new export formats using Apache Velocity e over 5100 part conversion rules between LDD Bricklink and Ldra
8. later in Linux works fine with OpenJDK 4 9 Installation Program is only in portable version and needs only few files to work e aJAR file program itself e database file e Ldraw official and unofficial libraries Database and Ldraw libraries are downloaded at first program start Installation procedure is the same for all operating systems Get JAR file from BrickUtils page https sourceforge net projects brickutils and put in a newly created folder anywhere you want in your computer To install and use it you don t need administrative rights so you can use it in any computer Every user that need to use BrickUtils must install a personal copy of program and database Every user has a private catalog This is a design choice To start program please refer to your operating system instruction to start a Java application 4 10 Where is program database Program database is entirely in a file called brickutils h2 db This file holds all data BrickUtils needs to work and user catalogs parts and set Every change in user catalog is in this file If you followed the installation instructions see 4 9 you will find it in the same folder where the program is When you use BrickUtils it will write a new folder called brickutils in the same folder where the program is here the database stores indexes for full text search functions The folder with all files in it are regenerated if missing so you can omit them when you do a b
9. located in same folder of BrickUtils program with vm extension Placing templates in other folder will not work 5 9 Migrating from Python version If you use the Python version and want to migrate to Java version you can import catalogs for bricks and sets but at one condition import catalogs from Python version MUST be the first action before doing anything else because Java program uses a totally different logic Java version can import backup files from Python version so make sure you have a fresh backup from Python version as documented in paragraph 5 3 and 5 4 in the Python version manual At first start in the program menu if it is still possible to import Python version catalogs you will see an menu item named Import from pyBrickUtils Fig 15 Program Preferences Fig 15 Import function from Python version It is a two phase procedure first you must import brick catalog backup file second you must import set catalog backup file This is because in the Java version a part must be linked to a set or a generic lot A part cannot exists in catalog as itself To avoid conflict and wrong part counting if in Python version a quantity of a part is not equal to the sum of parts counted in sets program will create a generic lot with all unlinked part in it Import Ok D Imported 426 parts A in 9 sets from pyErickUtils Catalog Fig 16 End of import from Python version All im
10. 420 i sos on Plate gt x Corner Check mode Needed Use Only available bricks Ka gt Parts 83 Bricks 198 How to select alternate bricks Missing Color mode Ignore color w _ Ignore molding and decoration Parts 68 Bricks 153 ii bricks Alternate part Description Plate Round 1 x 1 Straight 5i Sa oes ela NOA Round 1 x 1 Straight Side 6141 4073 6141 MW Plate Round 1 x 1 Straight Side e141 4073 joa 132 late Round 1x 4 straight side 6141 4073 6141 208 siPlate Round 1 x 1 Straight Side 61414073 16141 ME 2581 Plate Round 1x 1 Straight Side s o Export to HTML Export to Blink XML Export via template Fig 21 Missing parts dialog In Fig 21 you can see an example with default check only parts from available set with no checks for part color color can be any Replacement part selection can be e Parts with same color e Nearest color e Ignore color First option seems useless but you can select it with checkbox below that say Ignore molding and decoration i e it is useful to select parts with slight differences in shape molding variant for same part those that Bricklink records with a letter suffix link 3069a 3069b and so on or with decoration in the same color needed When you find a replacement click on replace button and program will change missing part with chosen part and updating all counts BrickUtils take account for already counted parts and
11. BrickUtils User Manual Version 0 2 1 0 Mario Pascucci lt mpascucci gmail com gt http www romabrick it brickutils E BrickUtils Brick utilities Update Catalogs Program Working List My bricks My sets Master ID LDD ID BLink ID LDraw ID Decor ID Description 2 2423 E ore 2423 dat Plant Leaves 4 x 3 Soar eat pa at rt ee Plant Leaves 6 x 5 aios pois kosz 30153 r ock 1 x 1 Jewel 24 Facet ee ee ee bs et 1 x 1 Jewel 24 Facet 5005 3005 3o05p6016 3005000 aa mmm 55551 Brick 1 x 1 with Cow and Flower Pattern Milk Carton C ene pre preo preoa mmm 2l Pre Modified 2 x 2 with Groove and 1 Stud in Center Jum sasi feast CE MC dat 1 Container Barrel Half Large with Axle Hole i iodo soo fs020 fono dar par 7 x 3 with Double Clips Ladder oos hos 032 3032 dat late 4 x 6 38 3010 30103010 3010 dat ee rick 1 x 4 lzor sor 3031 Plate 4 x 4 a 742c01 Plant Flower Small Sprue of Four A faros S GTO Bright Yellowish Green Bhs CIE pe Small Sprue of Four OEE E EEF A EEE ass7 E a Brick 2 x 2 Corner 43 3622 kBs2 3622 3622 dat ooo o e 443062 e ages 3062b dat 5 Brick Round 1 x 1 Open Stud i 45150746 50746 54200 50746 dat 34 Slope 301 1x 2 3 id 4650746 50746 54200 50746 dat a _ Slope301x1x23 CC 4743888 43888 _ 43888_ 43888 datc 7 Support 1 x 1 x 6 Solid Pilar LJ 486143 6143 3941 6143 dat Brick
12. Draw catalogs see 5 5 1 lt duplicate selected part add a row with the same part selected single selection allowed delete selected parts multiple selection allowed e change color for selected part single selection allowed see below Q Q Q change catalog 1D for selected part searching in LDD Bricklink or Ldraw part catalogs The Working list is fully editable clicking into a cell and typing on your keyboard description quantity catalog ID all are freely editable Of course if you change catalog ID in a cell the other catalog ID will not automatically updated you must do explicitly using search functions Part color can be modified both using toolbar button or clicking in the color cell a panel with colors will show all available colors Select Brick Color Solid colors je e O 5 Transparent colors o Ho o Bc Etc Metallic colors CI gt o o CDS Cancel Fig 9 Color selection If you place mouse cursor on a color a balloon hint will appear with color codes and description from LDD and Bricklink color codes as in Fig 9 for light bluish gray Only list ID is locked and cannot be edited it is used for program internal functions 5 5 1 Insert part from catalogs If you click on an insert button in toolbar you will see a dialog that allow a search in the selected part catalog Add from LDD Catalog ID Master ID Design ID Decor ID Blink 1D Description Updated on
13. UPLOS sets haw e large er specially de OF E B ax Ire 2s item descriptions About Me pages messages etc images ademarks on E allectual p An esp 5 entis yrovided as is with state nplied regarding the quality o any content on or of site LEGO is ofthe LEG cup oft ue as whic h not sp r authorize or endorse this site Use of this a Institutes ai ccep tanc Eure Terma Of Servic ey EET acy Policy Exc change rates provided by 4E com Visitor number thanks for stopping by Monday November 14 2011 O7 57 EST CPU Time 0 0000 seconds 2000 2011 BrickLink corn All rights reserved Fig 23 Catalog download page After you click on Download you will get a file called Parts txt that is few megabytes long In BrickUtils select Bricklink parts item from Update Catalogs menu point out the fresh downloaded file and update procedure starts with a progress dialog A possible hint for a catalog update is when you imported a set inventory from Bricklink see 5 2 and in Working list you see one or more parts with only Bricklink catalog code and description text that say Problem part not found in BL DB Needs an update maybe this happen when a part is not listed in local Bricklink database 5 14 4 Bricklink colors and categories update Bricklink colors and categories are used to identify parts and for categorize sets in your personal Catalog As for sets and parts Bricklink catalogs you can use th
14. ackup or move to another computer at first program start folder and files will rebuild with all indexes needed 4 11 Move program If you want to move program to other disk or path just move the program folder where you want to place it All needed files are in same program folder so you can put in a USB disk and carry it with you It will work on any computer with Java installed 4 12 Uninstall program To remove program from your system you have only to delete program folder If you plan to use again BrickUtils it is a good idea to make a backup copy of your catalog see 4 10 4 13 Update program Program checks at startup if a new version is available but download and installation is a user task This is a design choice To update or upgrade program you will need to put the new JAR in the folder where you placed the program That s all 4 14 Conversion rules updates All program version checks Internet at start up to see if there are updates to rules if an Internet connection is available If new rules are found it will applied to the database showing a dialog with summary Fig 1 Update Ok E i Updated at Parts 10 Colors 1 Fig 1 Updating rules summary dialog Start up check can be disabled from Preferences in Program menu If there are more updates it will be applied one by one at every start up or at every use of Check for updates in Program menu item 5 Working wi
15. arts marked as extra If a template does not use this option all parts are included in generated list Include brick image generate an image for every part in list Image are in PNG format and saved in a subdirectory related to your output file if your file was called explist csv all images will be in folder explist_images in the same folder of explist csv file Image file names are generated using count id in list as name with added png extension So part 1 2 3 will have image file name as 1 png 2 png 3 png Embedded images defines a flag used by template that image must be embedded in generated file as string in Base64 encoding Useful to generate single file HTML output see http en wikipedia org wiki Data URI scheme HTML Image size defines size in pixels Image are always generated as two views of part front and rear each of SizexSize so if you choose 150pixel as size you will have 300x150 pixel images e User string 1 User string 2 available to pass parameters to template E Template export options Excludes extra parts Include brick image Embedded images see docs Image size default 00x1L00px 7 User string 1 User string 2 Fig 14 Template export options After selecting options program asks for output file Please remember that you MUST specify file extension or output file will be without it 5 8 1 Template files Template files are
16. e pD ym De DT A EE 2015 08 1188 4070 4070 Brick Modified 1 x 1 with Headlight 1962 soro 6070 Windscreen x 2 x 12 3 2003 ___f61070_ _ 61070__ Technic Panel Car Mudguard Right O 2207 0b Dragon Head Ninjago Upper Jaw with Medium Blue Se 391 070 55071 30700n07 ie 1x 1 with Dia Panem 2014 02 By design ID O By generic text 0 New Parts Convert to Bricklink LDraw codes Elink 64 3070bp07 LDraw 64 3070bp07 dat Fig 10 Search in LDD part catalog In Fig 10 you see LDD catalog search dialog In every dialog you have three group of controls 1 search criteria How to search parts in catalog a By design ID By Blink ID By LDraw ID selecting this item you will search by catalog ID with a ID contains this string search type So if you enter 070 as search string you will find in LDD catalog 3070 4070 6070 61070 93070 part codes b By generic text it is a full text search mode in all available fields part name category part ID You can end a word with a to say all word starting with add a before a word to say this word must appear or sign to say this word must NOT appear c New parts list last updated parts d Deleted parts lists deleted parts in case of part code redefinition only for Bricklink and Ldraw catalogs e By category lists all parts in category only for Bricklink 2 Aut
17. e same web page to download it selecting Categories and Colors radio buttons see 5 14 3 Catalog files are called respectively categories txt and colors txt 5 14 5 Ldraw part libraries update To update select LDraw part libraries item in Update Catalogs menu BrickUtils will connect and downloads automatically new libraries from Ldraw website one for official part library and one for unofficial part library updating internal databases 5 15 Program preferences On Program selecting Preferences item you can define some program options Preferences checks for update on startup Use in production colors only LDraw official library URL http fwew ldraw org library updates complete zip LDraw unofficial library URL http www draw org library unofficial ldrawunf zip ErickUtils update URL httos sourceforge net projects brickutils files brickutils updates Fig 24 Preferences dialog First option will activate a check for conversion rules catalog at startup Second option will display only present day in use color in part color selection dialog see 5 5 and Fig 9 instead of all colors that LEGO group used in his history Last three options will contains URL for Ldraw and BrickUtils catalog updates Do not change if not explicitly stated or you can lose automatic updates or experiment program malfunction 6 BrickUtils Template documentation Here y
18. e what use for check i e only available parts or parts from selected sets or all parts Dialog is quite complex due to number of functions and information it shows It is splitted in two main area upper where is a list for missing parts lower where you can see replace parts hints if any In right area you can see part shape and color both for missing and replace part Middle area is reserved for check controls and parts count for needed and missing Check if buildable Missing bricks Missing part Master LOD ID BLink ID LDraw ID Y Decor Description 64644 neon ee Minifig Utensil Telescope e 3794 15573 794b 3794 MMM pta Modified 1 x 2 with 1 Stud wit 41763 41763 42023 4176 MM 8 Slope Curved 6 x 1 imvened 7 3035 3035 3035 3035 EEEE 4 Plate 4x 8 85984 85984 85984 8598 EEEE 2 Slope 30 1 x 2 x 2 3 3823 3823 3823 3823 1 Windscreen2x4x2 3037 3037 3037 3037 MMMM 4 Slope 45 2x4 33121 33121 33121 3312 MN 1 crab 98388 98388 9894 9838 EE 1 Bird Friends with Red Beak Pattern 3005 3005 3005 3005 E 2 Brik1x1 50746 50746 54200 5074 ME 2 Slope301x1x2 3_ 6141 5141 or 6141 MN 1 Plate Round 1x 1 ae Side 93095 93095 93095 9309 HA 1 Panelix 2x 1 with Rounded Corn 6141 5141 4073 P 1 ple Round cd Straight Side 92842 92842 92842 9284 MN 1 Propeller 3 Blades 5 Diameter 3623 geez 2624 E 1x3 2
19. ferent you can modify the Working list without re import whole set from a Bricklink set inventory An example is when you have a built set and you bought another box of the same set for use in a MOC the new set is added as available for building 5 11 2 Edit a set To edit a set in catalog you can move it with Mr button that remove set from catalog and place it in Working list ready for editing This is useful when you dismantle a built set to use parts for a MOC or when you want to update a lot because you lose some parts or you bought bricks of same type When set is in Working list you can edit it without any limitation When you done with editing you can save part list as for a new set or lot see 5 10 2 5 12 Part catalog In Java version the My Bricks catalog is only for display you can t change anything from here There is a single function identify set from part ee If you select a part when you click on this button program select set lot from catalog where this part is listed 5 13 Missing brick check This is one of the most powerful functions in program Once you have your catalog of set and bricks see 5 10 and you import your MOC project see 5 3 you can check what parts you need to complete your MOC The check for missing parts button brings a dialog where you can compare parts listed in Working list with parts in your catalog listing missing parts You can choos
20. functions from older release e The brick image isn t anymore static but it is rendered at once and you can rotate the image to view the part from any side e Database updates will not require a complete database download but only a little file with updated and new parts e There is an experimental support for decorated parts parts with printed text or image The check for missing bricks Check if can build was totally rewrote and now you can select a set or sets against do a check for missing parts A part can be identified not only with official LEGO design ID but you can use Bricklink or Ldraw part codes 3 2 Changes to Python version Catalog is a static view no changes are allowed in it All changes must come from Working list that offer all functions to edit your part list Editing for conversion rules between catalogs are removed and now are in a separate program Removed composite part handling when you import an LDD project if a part is composed from many parts the program take the color of first sub part as a part color Many other function will be added in next releases 3 3 What s new in 0 2 1 0 Notification for new program versions At startup program will checks if a new version is available and notify user No downloads are done program upgrade is a user task Export function based on a template engine Program integrates Apache Velocity Template engine to easily create new export formats f
21. h all parts imported Imported brick list 5 43 3003 3003 3003 3003 dat 1 Brick 2 x 2 L 44 4865 15714 4865b 4865b 2 Panel 1 x2 x 1with Rounded Corners E 45 3710 3710 3710 3710da 4 Plaeixa agp 4648336 48336 48336 48336 1 Plate Modified 1 x 2 with Handle onSide LJ 474864 87552 87552 B7552 5 Panel 1 x 2 x 2 with Side Supports Holl 4sl87580 87580 87580 87580 3Y Plate Modified 2 x 2 with Groove and 1 493940 3940 3940 3940 ca MN 1 Suppori2x2x2Stand Ll 5030413 30413 30413 30413 MN 2 Paneltx4x1 52 2431 2431 2431 2431 dat MN 3 Tile Dx 5330350 30350 30350 30350 MN 1 Tile Modified 2 x 3 with 2 Clips ll po a te 5152107 52107 52107 52107 MN 1 Brick Modified 1 x 2 with Studs on 2 Sides LJ ll ll 54020 3020 3020 3020 dat MMMM 4 Plate x4 E EA E A Ss EA 55 4346 4346 4346 4346 da Container Box 2 x 2 x 2 Door with Slot E 563823 3823 3823 3823da 1 Windscreen2x4x2 W 5730106 30106 30106 30106 1 Minifig Utensil Crystal Ball Globe 2 x2 x2 E 58 4536 4536 4536 4536da MN aj Container Cupboard2x3xXDrawer_ 59 3002 3002 3002 3002 da MMMM 2 Brick x3 60l3795 3795 3795 3795 datMWWW 1 Plae2x6 613836 3836 3836 3836 da EEEIEE 1 Minifig Utensil Pushbroom LI 6293568 93568 93568 Pie with Cream Fi
22. ling ET 63 87087 87087 87087 87087 2 Brick Modified 1x 1withStudon1side LI 64 3005 3005 3005 3005 da MM 4 Brick xd i 65 6141 6141 4073 6141 dat 2 Plate Round 1 x 1 Straight Side 66 6141 6141 4073 6141 dat MEEME aj Plate Round 1 x 1 Straight Side 67 6141 6141 4073 6141 dat MN 4 Plate Round 1 x 1 Straight Side EI _ 68j6141 6141 4073 6141 dat MN 2 Plate Round 1 x 1 5traight Side B Fig 3 Imported list from a Bricklink file After that BrickUtils will display a window where you can select the alternate parts from list see http www bricklink com help asp helpID 1562 When you clicks on button in Alt column you will see all the variant for the part as for part with ID 44 in Fig 3 in a dialog Choose alternate part AS Master ID LDD ID BLink ID LDraw ID Color Ot Decor ID Description 4865 4865 4865 48654 2 Panel lx 2 x 1 Fig 4 Alternate parts selection In the above example part come in two variants one with sharp edges and one with smooth edges a really little difference but it is If you want to change part select the part and clicks on OK the main list will display your choice To transfer the list into the Working list click on OK in Imported brick list dialog 5 3 Import LDD project BrickUtils can import both LDD project in LXF format and in LXFML export format From Working List
23. mported from pyBrickUtils DODIR 170 5623 1 Set Basic Bricks Large Creator 2010 Imported from pyBrickUtils 171 6161 1 Set Brick Box Creator 2007 Imported from pyBrickUtils 17216177 1 Set LEGO Basic Bricks Deluxe Creator 2008 Imported from pyBrickUtils 173 Inventario pezzi plates 02 O lmported from pyBrickUtils 174 Remaining bricks O Bricks not belongs to any set Fig 20 Set catalog In Fig 20 you can see an example after an import from Python version Available functions are e Delete selected set EF and remove parts from catalog Copy set in Working list fa without modify the catalog e Move set in Working list o removing from catalog with all parts that belongs to it e Doa backup for selected set im It will write a single file with all data set and parts e Restore or import set and parts f from an exported file add set and parts to catalog The column named Selected will be used for missing brick function see 5 13 that compares the Working list with a selected group of set or lot from your catalog 5 11 1 Duplicate a set If you buy a copy of a set you already own you can add it to catalog using the copy function in that put in Working list an exact copy of the selected set lot ready for add in catalog see 5 10 2 If set is slightly dif
24. nic pins These parts are called extra because the set can be completed without using them When you own a lot of set these parts are in good number so you can count in general catalog Extra parts are traced in catalog but aren t shown in general catalog part list S Add bricks in list as Set Lot MOC Add extra parts Remove parts added to catalog from list Delete set data after add Fig 19 Add to catalog e Remove part added to catalog from list delete added parts from Working list e Delete set data after add remove all data from set identity after add If you want to add more identical set you must add one at time Program take account and maintain what part belongs to what set This is why Working list and identification data is untouched in default dialog settings 5 11 Set catalog My Sets panel contains all your set and lot gt BrickUtils Brick utilities Update Catalogs Program Working List My bricks My sets rrr B ID_ Set Type Name Category Notes Available Selected 165 Lot Ordine da Bricklink 17 5 2013 Imported from pyBrickUtils 166 Lot Lotto LEGO Store 2013 Imported from pyBrickUtils 167 Lot Ordine da Bricklink 3 1 5 2013 Imported from pyBrickUtils 168 Lot Inventario pezzi o1 o o pezzi 01 Imported from pyBrickUtils 169 Lot Ordine da Bricklink 4 6 2013 I
25. omatic part code conversion Convert to XX Y Y codes if selected convert automatically selected part using conversion rules for other catalogs and fills ID fields for added parts in Working list If an equivalent code exists in other catalogs indicator near catalog name will become green and show equivalent code If a code can t be converted the indicator become red IF you disable this check only the searched catalog code will be inserted other cell code remain intact 3 Selected part display in the low right side there is a panel where you can see part shape if a 3D model exists in Ldraw part library Part can be rotated using blue arrows or flipped top bottom or left right with orange arrows To reset part display click on white circular arrow When you search a part a list for part found is displayed with all available information Selecting a part will display in the part shape panel and if a conversion code is available it will shows When you find a part clicking OK will insert part with all codes and description into the Working list 5 5 2 Change catalog ID for a part With a row selected in Working list if you click on search icons Q D D you get same dialog used for add part 5 5 1 but automatic catalog code conversion is disabled and only code for selected catalog is changed Initial search string is taken from selected cell All other fields remain unchanged including description
26. or part lists Please refer to Velocity documentation for details Warning update site is changed If you use new version you don t need to do anything but if you use old version you will not receive updates New URL for updates is https sourceforge net projects brickutils files brickutils updates 3 4 Limitations BrickUtils take account of decorations but for now only some from LDD are recognized The part image is approximate so please take as hint 3D model comes from user supplied models in Ldraw library Catalog code conversion is not reliable at 100 so do not take as absolutely true 4 Quick start 4 1 What ts BrickUtils BrickUtils is an utility for builders that use LEGO Digital Designer or other fan created CAD like LeoCAD MLCAD and many others for designing models The main problem that BrickUtils tries to solve is the answer at the question can I build this model with bricks I own So with BrickUtils you can quickly build your brick catalog and check if you can build a model created with LDD You can also use BrickUtils to check what bricks you need to complete your project designed with LEGO Digital Designer or LDraw compatible software to export a list of such bricks and load it in BrickLink wanted list to buy needed bricks Catalogs in BrickUtils are based on parts and colors available in LDD that is the main source for standard bricks and colors but you can use Bricklink or Ldraw
27. ou will find what data are available to template engine For documentation on how template engine works and how to write templates please refer to Apache Velocity Engine http velocity apache org engine releases velocity 1 7 6 1 Examples and ready to use templates Examples are available on BrickUtils main download site see https sourceforge net projects brickutils files brickutils templates e bricklink vm generates a simpler Wanted List Mass Upload see 5 6 Field User string 1 contains Bricklink wanted list id leave empty for default and User string 2 contains parts conditions N for new U for used leave blanmk for don t care It not uses images e simplehtml vm a less complex version of Export to HTML see 5 7 without checkboxes Image are embedded so checks related options in dialog e simplehtmlimg vm a variant of simplehtml vm where images are external to HTML file in a subdirectory e Idcad vm generates a custom part bin for Roland Merkelt s LDCad LDraw CAD see http www melkert net LDCad Text field User string 1 defines sorting method for parts in bin Remember to place templates in same folder of BrickUtils 6 2 Data available to templates There are three type of data available to template builders part data set data and template generation options 6 2 1 Part data Macro name is bricks It is an iterable of all parts in exported li
28. parts used to build something Set name a name for this set lot If you select an official set from search dialog Set name Category and Year fields will be automatically filled accordingly If it is a lot can hold a name to identify the lot origin e Category it is a Bricklink category Can be used also for generic lot or MOCs e Year when LEGO Company repeased this set or when you purchase a bulk lot or when you built MOC e Notes Free text e Set is available for new builds if program can include bricks in this list in the missing brick checking function see 5 13 Program use a different strategy for set lot and MOC If you add a set or lot part will be added to your catalog while if you add as a MOC parts will be subtracted from your catalog You can use this function to mark some parts as not available for new builds For this reason the checkbox Set is available for new builds is disabled if you select MOC as a type parts aren t available by default 5 10 2 Add to catalog Only after you built a list and identify it you can add to catalog using add to catalog f In the dialog Fig 19 you can select some details on how to add and what to do with list in Working list after an add e Add extra parts when you import Bricklink set inventory some parts are marked as extra because LEGO Company always put some spare for tiny parts like round plates 1x1 or Tech
29. ported sets and lots will have a comment field with Imported from pyBrickUtils while the lot with all unlinked parts will have Remaining bricks as name and Bricks not belongs to any set comment There are two main limitations decorated parts and part count inconsistency In Python version decorated parts are only marked with a flag decorated or not that not accounts different decoration Java version take account for different decoration but we don t have an indication for what decoration is so program put the main ID for part in decoration ID field Is up to you to modify decoration IDs manually or get rid of it see 5 5 2 on editing part data If you modified a part count in Python version there are two situations if parts are more than those counted in all set in catalog exceeding parts are in Remaining bricks generic lot If part are less than counted a part with negative count will placed in Working list Correction is up to you After first import program will refuse to do another import and at next start the item Import from pyBrickUtils will be removed 5 10 Working list and set The Working list is the entry point for our set and lot catalog When you have a list of parts in Working list for a lot or a set you can define set or lot identification to successfully add it to your collection To do it you have e New Working list E remove all parts from
30. r Catalog Features Click on link Download Catalog and you go in page in Fig 22 Select what catalog you want Sets here with options Include Year under Catalog Items Select always XML from Download Format dropdown box Downloaded file is named Sets txt From BrickUtils select Bricklink Sets on menu Update Catalogs Point to downloaded file and updated starts shortly with a progress dialog 5 14 3 Bricklink parts catalog update To download catalog go in page http www bricklink com catalog asp see 5 14 2 Remember to always select XML from Download Format dropdown box Select Catalog Items and Parts from dropdown box Choose options Include Year and Include Dimensions from parts catalog BrickUtils needs these information BrickLink Catalog Download Mozilla Firefox file Modifica Visualizza Cronologia Segnalibri Strumenti Aiuto bo e Fi http www bricklink com catalogDownload asp df BrickLink Catalog Download Unofficial LEGO R Marketplace Ss Se Sey ee SP a a bs pe cial Mess aya Catalog Download Catalog Download Catalog Items Item Types Inventory Parts Categories Set 3 Include Year Colors item No L Include Weight O Part and Color Codes Include Dimensions Download Format XML Download J se aiel amall p arts dr are NC JE Ue fo rani ves pose 2 a haz ari dto a mina years of age LEGI IE D
31. remaining parts of course When you have replaced all parts remaining parts if any can be exported using buttons in lower part writing a printable HTML list see 5 7 a mass upload wanted list to buy parts on Bricklink see 5 6 and a template based list see 5 8 5 14 Reference catalogs update Reference catalogs from Bricklink and Ldraw changes with time Bricklink updates items on daily basis while Ldraw library is updated two or three time at year So while Bricklink needs a weekly update Ldraw updates is announced in Ldraw website so you don t need to update too frequently 5 14 1 Bricklink catalogs updates BrickUtils is heavily based on Bricklink public catalogs so with too old catalogs it may not works well BrickUtils comes with Bricklink catalogs but they are still at program release date so it is better to update before first program use and monthly after that Catalogs must be updated in a specific order i e in the order they are listed in Update Catalogs menu 1 First you must update categories sets and colors see 5 14 2 and 5 14 4 2 Next you must update parts catalog see 5 14 3 Colors and categories changes infrequently so you can update them from time in time 5 14 2 Bricklink set updates OO Bricklink Catalog Download Mozilla Firefox o s Sow File Modifica Visualizza Cronologia Segnalibri Strumenti Aiuto Go yv Ks di BrickLink Catalog Download e http www b
32. ricklink cormicatalogDownload asp Unofficial LEGO R Marketplace Catalog Download Catalog Download a Catalog Items Item Types Inventory Sets t O Categories Set gt Include Year O Colors Item No Ll Include Weight Part and Color Codes C Include Dimensions Download Format XML Download some LEGO sets contain small parts that are NOT suitable for and may pose a hazard to children under 3 years of age LEGO DUPLO sets have larger pieces which are specially designed for children under 3 All text store names item descriptions About Me pages messages etc images or trademarks on this web site are the intellectual property of their respective owners All contentis 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 Use of this Web site constitutes acceptance of the Terms Of Service agreement and Privacy Policy Exchange rates provided by XE com Visitor number thanks for stopping by Friday November 04 2011 05 18 EST CPU Time 0 0000 seconds 2000 2011 BrickLink com All rights reserved Completato ae Fig 22 Bricklink set catalog download page All Bricklink catalogs are available for download in a single page from web page http www bricklink com catalog asp scroll to section called Othe
33. st none excluded To use it in a template you must use a foreach statement foreach b in bricks do something end For every part data available are e b getId returns part sequence number in list and it is unique in a list It is also used to generate image file related to part as b getId png It is an integer e b getDesignID returns design ID or LDD part id It is a string e b getBlID returns BrickLink part id as a string e b getLdrawID returns LDraw library part id dat inclusive as a string e b getName returns part description text It is a string e b getQuantity returns brick quantity in list as an integer e b getLddColor returns part LDD color code as integer b b b b b b b getBlColor returns part Bricklink color code as integer getLdrawColor returns part LDraw color code as integer getHtmlColor returns part color as HTML notation string rrggbb getColorName returns color name uses LDD names isDecorated returns a boolean that is true if part are decorated printed isExtra returns a boolean that is true if part is extra spare getBrickImageBase64Enc returns a PNG image of part encoded as a Base64 string Part sorting order in list is the same on Working list if you change sorting in Working list before exporting you will have parts in the same order in exported document 6 2 2 Set da
34. ta Set data are in macro currentSet Data available are currentSet getSetid set production ID ad a string 8060 1 10234 1 currentSet getName set name description as a string currentSet getCategory Bricklink set category as a string currentSet getYear year of production as integer currentSet getNotes user notes on set as a string currenteSet getType an integer defines set type as follows O O O 1 official set 2 generic lot 3 MOC 6 2 3 Options To allow user defining more complex templates and documents output some options are available excludeExtra a boolean True if Excludes extra parts checkbox in template export dialog is selected see 5 8 imagedir directory name relative to output file where program place image files when Include brick images in template export dialog is selected see 5 8 useri Suser2 string containing what user entered in text fields User string 1 and User string 2 in template export dialog see 5 8
35. th BrickUtils In the following section are explained most common procedures and involved program functions 5 1 First start At first start BrickUtils will download some needed files from Internet e main database from Sourceforge e Ldraw official part library e Ldraw unofficial part library First run You need some files to get program working database and LDraw part libraries Do you want to download from Internet Hit No to exit program Fig 2 First start up reminder first displaying a dialog with a conformation request Fig 2 Press Yes and program will download needed files After that BrickUtils is fully functional This message must appear only at first run If appears after that there is a problem somewhere 5 2 Import from Bricklink BrickUtils can import various list formats from Bricklink e set inventory e store inventory only user with seller profile on Bricklink e orders placed or received e wanted list mass upload XML file created with other programs or by BriclUtils itself For orders store inventory and wanted list BrickUtils will read only part data not price conditions and similar information After you have obtained an XML file from Bricklink vedi 5 14 2 from Working list select y icon Import bricks and from menu select Bricklink XML dump Once you select XML file from your computer program will show a progress bar followed by a summary dialog wit
36. w catalogs with automatic update e over 180 conversion rules for LDD Bricklink e LDraw color codes with automatic update e Automatic database upgrade without lose your catalogs e XML file export and import for your parts and set as a backup for your collection e Full text search on LDD LDraw Bricklink catalogs and for Bricklink set catalog e Can Build function includes export buttons to create a wanted mass upload file accepted by BrickLink or a printable HTML bill of material from missing bricks e Complete user manual PDF english and italian e Works on any platform with Java Runtime Environment release 6 or newer On Linux platforms it works fine with OpenJDK 4 4 What BrickUtils won t never do e BrickUtils do not use images from BrickLink to do so it needs an explicit permission from BrickLink owner that wasn t granted to me e BrickUtils will never do direct queries to BrickLink website it is explicitly prohibited by terms of use e accordingly BrickUtils will never do store selections and compute best prices for parts or lists because those data aren t available for download and programs that do automated web queries are explicitly prohibited by BrickLink So no features that needs these functions will never added to BrickUtils In 2014 February Bricklink released documentation about API key but for now it are limited to web development useless for client programs 4 5 License and Warranty
37. y browser and printed if you prefer using it as a bill of material to pick parts from your brick collection A checkbox is useful when you load list in a browser as a mark for found missing parts 15 32064 32064 132064a dat 1 White 1 LJ Technic Brick 1 x 2 with Axle Hole A bh Technic Axle 2 Notched 16 32062 32062 132062 dat 21 MN Bright Red l Technic Axle and Pin Connector Angled 6 90 17 32014 32014 32014 dat 1 white 1 0 d egrees 18 3004 3004 3004 dat 1 White 7 O Brick 1 x 2 19 50746 54200 50746 dat 23 MN Bright Blue 3 D Slope 30 1x 1x 2 3 p 20 161252 161252 61252 dat 194 Medium Stone Grey O r NZ Plate Modified 1 x 1 with Clip Horizontal thick NY NN open O clip 21 3068 3068b 3068b dat 23 MM Bright Blue 1 0 E xy lt gt Tile 2 x 2 with Groove Fig 13 HTML list example In Fig 13 you can see an example of a generated list with part image and some information about part 5 8 Export using a template BrickUtils integrates Apache Velocity Template Engine that allows creation of complex document in various formats based on template language and macros See 6 BrickUtils Template documentation paragraph for detailed documentation Using mmr function program will ask for a template to use After youi choose one program will ask some options for export Fig 14 Options are Excludes extra parts defines a flag used by templates to exclude p
38. y thanks to the thousands of LEGO fans that maintains BrickLink sets and parts catalogs Thanks to LDraw team and contributors that maintains a big database of 3D brick models Other thanks e to Superkalle user at Eurobricks moderator for LEGO Digital Designer and other digital tools forum for listing changes in latest release of LDD e to Calabar user at Eurobricks for countless ideas and tips on program functions e to Leo Valiant that suggested store inventory import function and tested several program versions reporting bugs e to Shawn Redford for testing several versions and reporting bugs Special thanks go to all Romabrick people http www romabrick it for support and suggestions and for pulling me out from the dark age 3 Release notes 3 1 What s new BrickUtils become a Java application Python version development stops to release 0 1 6 1 and will not receive further update Who uses that and previous release can migrate almost painless to the Java version where are an importing tool from Python release catalogs see 5 9 All functions in previous release are implemented in Java version with more but most important thing is a complete rewrite for internal program logic to remove some limitations New and improved things e itis a pure Java application so it will run in any platform that support Java Runtime Envoronment 6 or later e Redesigned user interface maintaining logic and
Download Pdf Manuals
Related Search