Sprite Sheet Importer

/* ********************************************************* /
   _____            _ __          _____ __              __
  / ___/____  _____(_) /____     / ___// /_  ___  ___  / /_
  \__ \/ __ \/ ___/ / __/ _ \    \__ \/ __ \/ _ \/ _ \/ __/
 ___/ / /_/ / /  / / /_/  __/   ___/ / / / /  __/  __/ /_
/____/ .___/_/  /_/\__/\___/   /____/_/ /_/\___/\___/\__/
    /_/
          ____                           __
         /  _/___ ___  ____  ____  _____/ /____  _____
         / // __ `__ \/ __ \/ __ \/ ___/ __/ _ \/ ___/
       _/ // / / / / / /_/ / /_/ / /  / /_/  __/ /
      /___/_/ /_/ /_/ .___/\____/_/   \__/\___/_/
                   /_/
*///////////////////////////////////////////////////////////

Created by DarkCampainger
Version 1.0 / August 9, 2012

"'  This tool allows you to import a spritesheet by defining
"'  the sequence of states as they appear in the source image.
"'
"'  The different directions and even frames for any individual
"'  state do not need to be adjacent.
"'
"'  The following can be defined:
"'
"'    - Global icon width, height, spacing, margins, and scan order
"'
"'    - Icon state name, movement flag, rewind flag, directions,
"'      frames, and delays
"
"'  You use the importer by writing a 'blueprint' script that lays
"'      out the states.
"'
"'  See 'skeleton.txt' and 'skeleton.png' for an example blueprint.
"'
"'  Blueprints start with a header that defines the global params:
"'
//      # Defines the width of each state
//
##      Width: 32
//
//      # Defines the height of each state
//
##      Height: 32
//
//      # Spacing defines the INTERNAL spacing between each state.
//      # First number is the horizontal spacing, second is vertical.
//      # Spacing is NOT applied around the outer edges of the
//      #   sprite sheet (hence it being "internal" spacing)
//
##      Spacing: 0 0
//
//      # Margin defines the external margins around the edges of the
//      #   sprite sheet. The margins can be specified individually
//      #   in this order: top, right, bottom, left.
//
##      Margin: 0
//
//      # Order defines how the the importer moves over the sprite sheet.
//      # The first value is the primary direction, followed by the
//      #     secondary direction.
//      # Valid values are ltr (left-to-right), rtl (right-to-left),
//      #     ttb (top-to-bottom), and btt (bottom-to-top).
//
##      Order: ltr, ttb
//
//
"'  After the header you define the strips of state data:
//
//      # Here's all the options used at once:
//
##      "StateName", Movement, Rewind, (S,N,E,W), 8, (1,4,2,1)
//
//      # Each line must start with the state's name in quotes
//      #
//      # The following can optionally be defined (in this order):
//      #    Movement / M   - Load strip as part of movement state
//      #    Rewind / R     - Make state play in reverse
//      #    (S,N,E,W)      - Directions in strip (S,N,E,W,NE,NW,SE,
//      #                     and/or SW). You can leave off the parens
//      #                     if its a single direction
//      #    8              - Number of frames in the state
//      #    (1,4,2,1)      - Delays for each frame (unspecified delays
//      #                     default to the last set delay). You can
//      #                     leave off the parens if its a single delay
//      #
//      # If you define the frame delays, you must specify the
//      #     number of frames
//      #
//      # Based on these strips, the importer moves from grid cell to
//      #     grid cell (based on the order in the header) pulling out
//      #     the required number of sprites for each strip definition.
//      #
//      # If a state's directions or frames aren't located sequentially
//      #     in the sprite sheet, you can define their strips separately
//      #     and they will be correctly combined.