                        [Images & Graphics Header]

                        3D Studio File Format (3ds).

                               Autodesk Ltd.

                     Document Revision 0.1 - May 1996

                 3D-Studio Material-Library File Format (.mli)
                               Autodesk Ltd.

  Document Revision 0.1

  May 1996   by Robin Fercoq  ( email robin@mail.fc-net.fr )

  Thanks for previous work: the 3d-studio file format (.3ds) doc
  rewritten by Martin van Velsen (email: vvelsen@ronix.ptf.hro.nl )
  based on a work from Jim Pitts (email: jp5.ukc.ac.uk )

  A lot of the chunks are still undocumented if you know what they do
  please email me Robin Feroq, Martin van Velsen or Jim Pitts.
  As I get more information of the file format,I will document it for
  everyone to see. I will post this regurlarly to alt.3d and alt.3d-
  studio and I can be contacted there if my email does not work.

  Disclaimer.
  This document describes the file format of the .mli files generated by
  3d-studio by Autodesk. By using the information contained within you
  free not to hold me liable if, from its use, you f^Hmuck something up.
  OK?

  A warning beforehand. This docs describes the format of mli files produced
  by version 3.0 and higher of 3d-studio. You can find this information at
  byte 29 in the binary file.

  This document describes the matlibs .mli files generated by 3D-Studio 4
  and I think it covers nearly all of its aspects. If not you can
  contact me or Martin van Velsen or Jim Pitts to add or correct.

  First parts of .3DS files include material definitions with the same
  format than .mli, if you want to understand this part of .3DS files
  you can refer to this document.

  Structure
  ---------

  3D-Studio binary files are made up of "chunks".
  A chunk is a block : with an ID which identifies what it stands for,
  a pointer to the next chunk (relative to the beginning of the chunk),
  and a block of data or a set of subchunks (which allows a hierarchy),
  or possibly none of these (void chunk).
  Pointers point to the next chunk of the same level.
  The pointer of the last chunk of a subset points to the next chunk
  level above.
  Chunk ID is 2 bytes, pointer is 4 bytes.

  If I am not clear you can read the .3ds file format doc.
   ( posted on alt.3d and alt.3d-studio )
    It can also be found at:
      "http://www.ptf.hro.nl/odi/free-d/docs/io/3ds/3ds_bin.doc"
   Or
      "http://www.mediatel.lu"

  Remember DOS standard for short and long integers: always
  least significant byte first. I'll write in the natural
  order (most significant first) except for file extracts.

  Main chunk (level 0)  3DAA
  --------------------------

  The Main chunk is the whole .MLI file. Its ID is 3DAA and the pointer
  is in fact the length of the file.
  Begining looks like: AA 3D A0 0F 00 00 ... (for a file of 4k)

  Material chunk (level 1) AFFF
  -----------------------------

  There is only one type of chunk for level 1: the material chunk which
  is the definition for one material.
  This chunk can be found in .3DS files as a subchunk of the EDIT3DS chunk.
  >From now its all the same with .3DS and .MLI .

  Typical material chunk content (level 2 subchunks)
  --------------------------------------------------

   Id    type     function

  A000   asciiz   material name   [the name terminated by a null char]
  A010   S        ambient color   [RGB1 and RGB2]
  A020   S        diffuse color       idem
  A030   S        specular color      idem
  A040   S        shininess       [amount of]
  A041   S        shin. strength     "
  A050   S        transparency       "
  A052   S        trans. falloff     "
  A053   S        reflect blur       "
  A100   intsh    material type   [1=flat 2=gour. 3=phong 4=metal]
  A084   S        self illum      [amount of]
  A240 * V        some trans. falloff amount (not 0)
  A250 * V        some reflect. blur
  A081 * V        two sided
  A083 * V        transparency ADD
  A085 * V        wire on
  A088 * V        face map
  A08A * V        trans. falloff IN
  A08C * V        soften
  A08e * V        3d wire thickness in units (default is in pix)
  A087   float    wire thickness (always present, in case of forced
                                  wire rendering)

  S -> subchunks
  V -> void
  intsh -> short int (2 bytes)
  intlo -> long int  (4 bytes)

  * -> optional.  Absence of such a chunk leads to "none" or
  to a default value.
  Order respected (as 3DS saves the .MLI)
  Non optional chunks are always present.

  Subchunks of these material characteristics (level 3)
  -----------------------------------------------------

  0011   RGB1
  0012   RGB2

  Each of the three color chunks have 2 subchunks that defines their
  colors. It seems that RGB1 is the color with a gamma (which one ?)
  and RGB2 is the same color but as displayed on top of the material
  editor window. But I'm not quite sure why there is two aspects
  of the same color and what it does.
  Anyway, in material color chunks there is always these two subchunks.

  0030   "amount of"
  A252   "displayed amount of bump"

  A short integer that corresponds to the value displayed.

  Oh, the nice maps
  -----------------

  Map and mask chunks (level 2) come after the material characteristics.
  (just after the A087 chunk)

  All these chunks are optional and have subchunks.

  Map chunks IDs:

                 map       mask

  texture1       A200      A33E
  texture2       A33A      A340
  opacity        A210      A342
  bump           A230      A344
  specular       A204      A348
  shininess      A33C      A346
  self illum     A33D      A34A
  reflection     A220      A34C

  In order to respect the order (well, I know, all this is terribly boring)
  (but I wont joke)  (actually, I have no sens of humour)
  (if I had I wouldn't spend my time with computer binary files, would I ?)
  (and especialy not this one...)
  the chunk of the mask of a map follows the chunk of this map.
  It may be of no importance at all thanks to the chunk structure...

  Typical map or mask chunk content (more level 3 subchunks)
  ----------------------------------------------------------

   0030   intsh    amount of
   A300   asciiz   map's file name
   A351   intsh    map options
   A353   float    map filtering blur ( 7% -> 0.07 )
   A354 * float    1/U scale
   A356 * float    1/V scale
   A358 * float    U offset
   A35A * float    V offset
   A35C * float    map rotation angle
  /A360 * RGB      lum or alpha tint first color (default=00 00 00)
  \A362 * RGB      lum or alpha tint secnd color (default=FF FF FF)
  /A364 * RGB      RGB tint R channel color (default=FF 00 00)
   A366 * RGB      RGB tint G channel color (default=00 FF 00)
  \A368 * RGB      RGB tint B channel color (default=00 00 FF)

  Some optional chunks may or may not be present in a given
  map or mask chunk, depending on the options there is
  for the specific map, or for masks.

--The map options chunk contains two bytes with options coded by bits.

  If read as a short int (ls byte first):

  bit4 bit0: 00 tile (default) 11 decal  01 both
  bit 1: mirror
  bit 2: not used ? (0)
  bit 3: negative
  bit 5: summed area map filtering (instead of pyramidal)
  bit 6: use alpha  (toggles RGBluma/alpha. For masks RGB means RGBluma)
  bit 7: there is a one channel tint (either RGBluma or alpha)
  bit 8: ignore alpha (take RGBluma even if an alpha exists (?))
  bit 9: there is a three channel tint (RGB tint)
  ... not used (0)

  Specific maps
  -------------

  -bump
  For a reason of him 3DS divides the amount of bump by 4.
  ( in the 0030 chunk )
  Nevertheless, the amount actually seen in the material editor
  is coded in a specific subchunk of the bump map chunk: A252
  Just after the A300 chunk.

 -reflection
  The reflection map has no A351 or A353 chunks since there are no
  options for reflection mapping.
  If the map name is only a null caracter, then we have :

 -automatic reflection A310
  A level 2 chunk just after the reflection chunk when there is
  autoreflection. This chunk contains two short ints and two long ints.
  1st short contains 0004. (what does that mean ?)
  2nd short codes for options:
    bit0 seems always set to 1
    bit1 0
    bit2 0
    bit3 First frame only
    bit4 flat mirror
    bitx 0
    next comes a long for the map size
    and the last long is for the "every Nth frame"

And there it is

                                [icon bar]
                   MédiaTel | Map | Search | Contact Us
