home *** CD-ROM | disk | FTP | other *** search
/ GEMini Atari / GEMini_Atari_CD-ROM_Walnut_Creek_December_1993.iso / files / graphics / utility / mdl10 / dl.5 next >
Text File  |  1993-08-25  |  2KB  |  67 lines
  1.  
  2. NAME
  3.     dl - format of DL animation files
  4.  
  5. DESCRIPTION
  6.     DL  files  (with  suffix  .dl) contain bitmapped images, a color
  7.     map, and a set of commands to animate the images.  DL files  are
  8.     not that  predominant (I have only a very few).  There is little
  9.     official documentation that I have found.  This file  is  merely
  10.     an attempt to document the file format.
  11.  
  12.     There are (at least) 2 versions of DL files: version 1 and 2.
  13.  
  14.     DL version 1 file format is:
  15.  
  16.      Size
  17.     (bytes)        Description
  18.     -----------------------------------------------------------
  19.     1        Version number (1). Image format (implicit)
  20.             is 1 (medium)
  21.     20        Title (XOR'ed with 0xff).
  22.     1        Number of screens (nscr).
  23.     1        Number of commands (ncmd).
  24.     1        Unknown. Something to do with colormap and
  25.             border colors.
  26.     768        Colormap (3 bytes per color, 256 colors)
  27.     320*200*nscr    Data for each screen (always 64000 bytes).
  28.     ncmd        Commands in an unknown format. The last
  29.             command can be negative (unknown reason) and
  30.             is to be ignored.
  31.  
  32.     DL version 2 file format is:
  33.  
  34.      Size
  35.     (bytes)        Description
  36.     -----------------------------------------------------------
  37.     1        Version number (2).
  38.     1        Format (0=large320x200, 1=medium160x100).
  39.     20        Title (XOR'ed with 0xff).
  40.     20        Author (XOR'ed with 0xff).
  41.     1        Number of screens (nscr).
  42.     1        Number of commands (ncmd).
  43.     3        Unknown. Something to do with colormap and
  44.             border colors.
  45.     768        Colormap (3 bytes per color, 256 colors).
  46.     320*200*nscr    Data for each screen (if format==0, single
  47.             image per screen, if format==1, 4 images
  48.             per screen)
  49.     2*ncmd        Commands, little-endian (byte swapped 16-bit
  50.             words). The last command can be negative
  51.             (unknown reason) and is to be ignored.
  52.  
  53.     Commands  appear  to  be  just  a list of frames to display in a
  54.     loop.  For example, given four frame images (0 through  3),  the
  55.     commands:
  56.  
  57.         0 1 2 3 2 3 2 3 2 1 2 1 2 1
  58.  
  59.     can create an animation showing these frames in succession.  You
  60.     can  thus  have  far fewer actual bitmap images that "frames" in
  61.     the animation loop.
  62.  
  63. AUTHOR
  64.     Bill Rosenkranz <rosenkra@convex.com> based on  xdl  program  by
  65.     Jonas Yngvesson <jonas-y@isy.liu.se> for the X Windows xdl.
  66.  
  67.