====== Decoration (DED) ======

Light decorations for surfaces.

You can define multiple Decorations for the same texture/flat, but only the
latest one that passes the conditions will be used. By default (if you
specify no usage flags), a Decoration is only used with resources loaded
from an IWAD.

Note that [[Material]] definitions can be used to define light decorations, as well.


===== Syntax =====

  
  <Copy> Decoration
  {
    # If "Copy" is found all the data of the previous definition is
    # copied to this one as defaults. For the first definition in a
    # file "Copy" has no effect.
  
    Texture = ""
    # Name of the texture with which this decoration is used.
  
    Flat = ""
    # Name of the flat with which this decoration is used. You can
    # only specify either a Texture or a Flat, not both.
  
    Flags = flaga | flagb | flagc etc...
    # noiwad: Don't use this decoration if the resource is loaded from an IWAD.
    # pwad: This decoration can be used with PWAD resources (for example custom textures).
    # ext: This decoration can be used with external resources.
  
      Light
      {
        # Each decoration can specify up to 16 lights.
  
        Offset { 0.0 0.0 }
        # Origin of the light in texture coordinates.
  
        Distance = 1.0
        # Distance between the origin of the light and the surface.
  
        Color { 0.0 0.0 0.0 }
        # RGB color (values 0-1) of the light. Color (0,0,0) marks
        # the end of the light definitions. Any lights that follow are
        # not rendered.
  
        Radius = 1.0
        # Radius of the dynamic light.
  
        Halo radius = 0.0
        # Radius of the halo. Zero means no halo is rendered. Note
        # that halo radius 1.0 produces quite a large flare.
  
        Flare map = ""
        # Name of the flare map to use OR a built-in flare texture id to use for the primary flare (i.e. the halo itself).
        # Eg:
        # Flare map = "myflaremap.png" (loaded from the data/<game>/flaremaps folder by default). 
        # Flare map = "1"
  
        # Built-in flare texture ids:
        # 0 = Texture chosen automatically.
        # 1 = Default dynamic light texture.
        # 2 = FLARE.
        # 3 = BRFLARE.
        # 4 = BIGFLARE.
  
        Flare texture = 0
        # DEPRECATED:
        # This parameter has been replaced with "Flare map" as of 1.9.0-beta4.
  
        Top map = ""
        Bottom map = ""
        Side map = ""
        # Name of the light map to use. The top map is used for ceiling
        # planes, the bottom map for floors and the side map for walls.
        # If left blank (the default), the standard round dynlight
        # texture is used. Use "-" to disable a map entirely. No light
        # will then be cast in the direction.
  
        Levels { 0 0 }
        # Two integers (0-255) that mark the sector light levels where
        # the light is at zero and maximum brightness, respectively.
        # For example, the levels { 100 200 } mean that the light is
        # not visible under light level 100, fades gradually to full
        # brightness when nearing light level 200, and stays full
        # bright over 200. The first level can be higher than the
        # second. The behaviour is then reversed: the light is at full
        # brightness only below the lower light level.
  
        Pattern skip { 0 0 }
        # Normally the light is repeated on a surface as many times as
        # the texture or flat repeats. The pattern skip values allow
        # sparser repeats for horizontal and vertical patterns,
        # respectively. For example, the skips { 1 2 } will make the
        # light only appear on every second horizontal repeat and
        # every third vertical repeat.
  
        Pattern offset { 0 0 }
        # Used with pattern skip to offset the origin of the pattern.
        # For example, the offset { 1 0 } will shift the origin of the
        # pattern one full horizontal repeat.
      }
  }