To LUGNET HomepageTo LUGNET News HomepageTo LUGNET Guide Homepage
 Help on Searching
 
Post new message to lugnet.announceOpen lugnet.announce in your NNTP NewsreaderTo LUGNET News Traffic PageSign In (Members)
 Announcements / 251
250  |  252
Subject: 
[ldraw.org] Official Model Repository Filenames/Headers
Newsgroups: 
lugnet.announce, lugnet.cad.dev, lugnet.cad.dev.org.ldraw
Followup-To: 
lugnet.cad.dev.org.ldraw
Date: 
Tue, 15 Jun 1999 20:57:16 GMT
Viewed: 
3347 times
  
After discussing the ldraw.org Official Model Repository header and file
naming system, I feel that we can come to a final resolution.  A lot has been
discussed on the topic, including various file naming systems and also
locations within the models directory.  I would like to say thanks to readers
of cad.dev.org.ldraw for their feedback and suggestions which made this file
system possible.  If you would like to read up on the history and development
of this system, take a look at the thread on cad.dev.org.ldraw.

The file header must be concise and at the same time display all the
information needed for the model/submodel.  Here is the official file header
for the Repository:

0 7140 X-Wing Fighter
0 Name: main.dat
0 Author: Tim Courtney <tim@zacktron.com>
0 ldraw.org Official Model Repository
0 http://www.ldraw.org/repository/official/

Submodel header:

0 7140 X-Wing Fighter, Main Fuselage
0 Name: m-2a.dat
0 Author: Tim Courtney <tim@zacktron.com>
0 ldraw.org Official Model Repository
0 http://www.ldraw.org/repository/official/

Minifig Header:

0 7140 X-Wing Fighter, Luke Skywalker Mini-figure
0 Name: mf-1.dat (see below [1])
0 Author: Tim Courtney <tim@zacktron.com>
0 ldraw.org Official Model Repository
0 http://www.ldraw.org/repository/official/

The apparent resolution for the file names is to stay within the 8.3 file
format and use subdirectories within the models directory to place the files
for TLG sets.  This will be accomplished by a single MPD file which will
extract these files and create the subdirectory structure within the models
directory.

First off, each model will be stored in a subdirectory which is named after
the set number, an optional modifier, and the two-digit year.  This will be
accomplished by placing these directory instructions within the MPD file which
contains the entire set.  All of this will fall under a sets/ subdirectory
under the models/ directory.

              Four digit TLG set number
              |
              | Optional modifier to the year [2]
              | |
              | |  Two digit year - year set was released.
              | |  |
models/sets/XXXXZ-YY/

Terms:

Set - Display of every model and submodel (in essence the whole box).

Model - Individual model in set.  For example, Service Vehicle and X-Wing
Fighter on 7140.  Includes such models as cars, airplanes, helicopters, etc.

Submodel - Sub-assembly (in instructions) of a model.  Also used as the sub-
assemblies that make up rotating parts of the model.

Minifig - Specific to a mini-figure submodel within a set.

Within the set's subdirectory, the following filenames will represent the
following aspects of the set/models.

main.dat - Main instructions, including all models that can be built at once.
Basically, this is just a display of m1.dat through m9.dat

m-1.dat   - First model in main instructions
m-1a.dat  - First submodel of first model
m-1aa.dat - First component of first submodel of first model
m-1ab.dat - Second component of first submodel of first model
m-2.dat   - Second model of main instructions
alt.dat   - Alternate instructions, display file
a-1.dat   - First model of alt. instructions
a-1a.dat  - First submodel of first alternate model

To use further levels of submodels, one could continue adding on letters to
the end until a total of 8 characters in the main filename is reached.

[1] Minifig submodels will be named in order of appearance in the instructions.

mf-1.dat (7140) Luke Skywalker minifig
mf-2.dat (7140) Biggs Darklighter minifig
mf-3.dat (7140) Mechanic minifig

[2] The optional modifier to the year comes into play when there are more than
one set in the specific year that bear that set number.  This usually takes
place with the multi-packs of the late 80's and early 90's, but also occurs in
other sets.  For example, set 1974, a multi-pack:

                         Optional modifier to the year
                         |
C:\LDRAW\MODELS\SETS\1974A-90\MAIN.DAT Flyercracker U.S.A.
C:\LDRAW\MODELS\SETS\1974B-90\MAIN.DAT Smuggler's Hayride
C:\LDRAW\MODELS\SETS\1974C-90\MAIN.DAT Star Quest

Each seperate set/model that was released with that specific set number in
that year gets a modifier in its directory.  The files within the directory
still follow the standard naming system.  Typically the first set in a pack,
or the first set to be released with that number would get A as the modifier,
the second B, etc.

This system of headers and naming files will be implimented on the ldraw.org
Official Model Repository for the re-distribution of official sets to LDraw
users.  Each individual author of official models used in the OMR will recieve
credit for the model in the header and on the ldraw.org website.  The OMR does
not intend to detract from the individual author or the author's website, but
seeks to distribute TLG models to LDraw users free of charge.

-Tim Courtney
ldraw.org Project Coordinator

http://www.ldraw.org
http://www.zacktron.com

AIM:   timcourtne
ICQ:   23951114



1 Message in This Thread:

Entire Thread on One Page:
Nested:  All | Brief | Compact | Dots
Linear:  All | Brief | Compact
    

Custom Search

©2005 LUGNET. All rights reserved. - hosted by steinbruch.info GbR