OMR File Spec - Updated 8/31


OMR File Spec - Updated 8/31
#1
Here's the latest version. Discuss!!
--

The Offical Model Repository Specification
Version: 0.5 (will turn 1.0.0 upon ratification by the LSC)
Author: Orion Pobursky

Purpose:
--------
The Official Model Repository (OMR) is a database of file in the LDraw File Format describing models that are released as sets by LEGO®.

For consistency between models and ease of indexing by software, a standard for the file headers, names, and hierarchy in the OMR is needed. This document will outline the extra requirements (in addition to those set forth in the current LDraw File Format specification) for a model to be included in the OMR

Base Requirements:
------------------
All files in the model will conform to the current LDraw File Format

Base File Naming:
-----------------
Each model in the OMR will consist of several files that are packaged together into a single MPD file. For sets that include instructions for multiple models, each model will have its own MPD file. Each MPD for the set will be named in the following manner:

<Set Number> - <Set Name> - <Sub Model Name>

Where:
<Set Number>: the number assigned on the container of the set
<Set Name>: The name of the set printed on the container in Australian English
<Sub Model Name>: This is Optional in most cases. This is required for alternate models that are detailed in instructions (e.g. the Creator theme). In this case the naming is left to the discretion of the author but should be descriptive of the model contained in the MPD.

For playsets or other sets where there are multiple models that are part of an integral whole, all of the submodels will be contained in one MPD.

Example:
The creator set 4896 - Roaring Roadsters has 3 models in the instructions:
Set 4896 - Roaring Roadsters - Roadster.mpd
Set 4896 - Roaring Roadsters - Dragster.mpd
etc...

MPD File Structure:
-------------------
The MPD will conform to the MPD File Specification.

Each filename will have the structure:
<Set Number> - <Optional Qualifier> - <Individual filename>
Where:
<Set Number> is the the number printed on the model's container
<Optional Qualifier> is a suqential number, starting with 1, added if there are more than one sets that could be assigned <Set Number>.
<Individual filename> is up to the discretion of the author with the following guidance:
- A logical naming scheme is highly desired.
- Individual models in the set (e.g. a vehicle or minifig) shall have their own separate file inside the MPD.
- Minifig file name should have the name of the character, if known

The unofficial parts are allowed to be used. The filename of the unofficial part is subject to the naming rules above (e.g. 33056.dat would be renamed to <MPD Filename> - 33956.dat). It is highly encouraged that any parts created for use in a OMR file be submitted to the LDraw.org Parts Tracker.

If a part is unavailable either officially or on the LDraw.org Parts Tracker, a suitable substitution may be made. If the unavailable part is a patterned part with an unpatterned version available use the unpatterned version. A comment should be inserted stating that a substitution has been made or, if no substitution is available/suitable, that a piece has been omitted. Reference the step and page number of the instructions if possible.

Example:
0 // The next piece should have the Star Wars Hatch pattern per step X on page Y
or
0 // Bionicle piece X should go here per step Y on page Z

File Headers:
-------------
Each individual model file in the MPD must have a standard header format.

Standard Header:
0 FILE <MPD Filename> - <Filename>.ldr
0 <MPD Filename> - <File Description>
0 Name: <MPD Filename> - <Filename>.ldr
0 Author: <Author Name>
0 !LDRAW_ORG Model -OR- 0 !LDRAW_ORG Unofficial_Model
0 !LICENSE Redistributable under CCAL version 2.0 : see CAreadme.txt

0 !THEME Theme name
0 !KEYWORDS words, more words,…,
0 !KEYWORDS words in second row, …, final words

0 !HISTORY YYYY-MM-DD [<Author Name>] Free text description of change. This can wrap to a
0 !HISTORY YYYY-MM-DD [<Author Name>e] second row with the same date if necessary. However authors should lean toward writing longer
0 !HISTORY YYYY-MM-DD [<Author Name>e] single !HISTORY lines(and not feel constrained to the historic 80-character limit on line length)

Where:
<MPD Filename>: The name of the containing MPD
<Filename>: The name of the file
<Author Name>: The name of the author. Real full names (first and last) are required by the LDraw.org Contributer's Agreement
Optional commands are !THEME, !KEYWORDS, and !HISTORY

Example:
To Be Inserted Later

META commands:
--------------
All META commands are allowed in the model file but not specifically required except as specified for the header. If included, any META commands used should enable any instructions generated to be as close to the official instructions as possible.
Reply
Re: OMR File Spec - Updated 8/31
#2
I still find those long names 'ugly' (inside the mpd) but if most don't mind it I could live with it.

But why also add the mpd filename to the description ? Those are suppose to be container independent.
Reply
Re: OMR File Spec - Updated 8/31
#3
Roland Melkert Wrote:
-------------------------------------------------------
> I still find those long names 'ugly' (inside the
> mpd) but if most don't mind it I could live with
> it.
>
> But why also add the mpd filename to the
> description ? Those are suppose to be container
> independent.

I kind of agree here. In LDraw, we have a file name and a Description line.

IMHO, there have to be really good reasons to double tautologically add the description also into the file name and add file name also into the Description line.
Reply
Re: OMR File Spec - Updated 8/31
#4
I agree. I meant to change this when I changed the file naming requirements.
Reply
Re: OMR File Spec - Updated 8/31
#5
> 0 Author: <Author Name>

Why not
0 Author: RealName [UserName]
like we have for parts? This would help to emphasize that authors need to be registered LDraw users to have affirmed the Contributor Agreement.

Chris
Chris (LDraw Parts Library Admin)
Reply
Re: OMR File Spec - Updated 8/31
#6
Because I'm not sure what kind of submission method we'll have initially since it doesn't exist yet. I can add <User Name> and make it optional if the method we use doesn't need it.
Reply
Re: OMR File Spec - Updated 8/31
#7
OMR submissions really ought to be authenticated against the same "single source of the truth" of CA-affirmed users as is used for Parts. Trying to maintain two lists is too error-prone. At present this authentication is the existence of the UserName in the PTSubmit group in the PostNuke CMS database. How that is done with the new CMS has yet to be determined.

Chris
Chris (LDraw Parts Library Admin)
Reply
Re: OMR File Spec - Updated 8/31
#8
Chris Dee Wrote:
> At present
> this authentication is the existence of the
> UserName in the PTSubmit group in the PostNuke CMS
> database. How that is done with the new CMS has
> yet to be determined.

It'll be a user group of the same name. Ideally I'll be able to transfer over accounts but since the way passwords are stored are different it'll require a password reset from everybody.
Reply
« Next Oldest | Next Newest »



Forum Jump:


Users browsing this thread: 1 Guest(s)