========================================
  doompal v1.1.0 - Doom Palette Tools 
========================================

USAGE:
  doompal <input>                                    Auto-batch mode
  doompal <command> <input> [output] [options]

COMMANDS:
  cube      <input> [output.cube]                   Generate .cube LUT for image editors
  batch     <input> <o>                             Generate all files (cube, playpal, colormap, split)
  playpal   <input> [output] [--slade] [--blank]    Generate 256×14 PLAYPAL
  colormap  <input> <o> [--blank]                   Generate 256×34 colormap with lighting
  blank     <input> <o>                             Generate blank playpal + colormap (no tints/lighting)
  slade     <input> <o> [--all] [--cell N]          Generate SLADE-style 16×16 grid palette
  extract   <wad> [output] [options]                Extract PLAYPAL/COLORMAP from WAD
  split     <input> <o>                             Generate transparent tint overlay PNG
  cleanpal  <input> [--rgb] [--tolerance N]         Find duplicate/similar pal0 entries
            [--layers]

COMMAND DETAILS:
  cube        Inputs pal0, outputs LUT cube for sRGB image editing apps

  batch       Inputs pal0, outputs:
              - .cube LUT file
              - 256×14 playpal.png
              - 256×34 colormap.png
              - transparent tint split.png

  playpal     Input pal0, output 256×14 playpal PNG
              --slade : Output binary playpal.pal instead of PNG
              --blank : All 14 rows same (no tinting)

  colormap    Input pal0, generate primary colormap with lighting
              --blank : No lighting (full brightness rows 0-31)

  blank       Input pal0, output both:
              - blank playpal (no tints)
              - blank colormap (no lighting)

  slade       Input palette, generate SLADE-style 16×16 grid pal0.png
              --playpal : Output binary playpal.pal (14 palettes) instead of PNG
              --cell N : Cell size (default 8 = 128×128 output)

  extract     Extract from WAD (PLAYPAL + primary COLORMAP if found)
              --boom LUMPNAME : Extract specific Boom colormap
              --boom : Extract all Boom colormaps
              --boomlist : List all Boom colormaps in WAD

  split       Input pal0, output transparent overlay PNG showing
              damage/item/radsuit tints (apply to blank playpals)

  cleanpal    Find IDENTICAL (exact) and SIMILAR (perceptual) pal0
              entries. Lowest index kept, rest cleared. Outputs
              identical/simular (cleared pixels, original positions,
              transparent bg) and aligned (kept colours packed from
              slot 0, transparent tail). Never auto-batched.
              --rgb : Weighted RGB metric (default tolerance 1.1)
                      instead of CIE Lab dE76 (default 2.0)
              --tolerance N : Override tolerance (decimals ok)
              --layers : One PNG per set/cluster (-keepNNN files)

SUPPORTED INPUT FORMATS:
  - playpal.pal        SLADE binary (14 palettes, 10752 bytes)
  - pal0.pal           SLADE binary (single palette, 768 bytes)
  - pal0.png           256×1 PNG (DoomTools style)
  - playpal.png        256×14 PNG (DoomTools style)
  - colormap.png       256×34 PNG (extracts row 0 as pal0)
  - slade_pal0.png     16×16 grid PNG (SLADE style)
  - *.wad              WAD files (extracts PLAYPAL lump)

  Note: Binary colormap lumps (.cmp) are NOT valid inputs

OPTIONS:
  -h, --help           Show this help
  --version            Show version

NOTES:
  Running 'doompal <inputfile>' with no command automatically runs batch mode

EXAMPLES:
  doompal mywad.wad
      Auto-batch: cube + playpal + colormap + split from the WAD's PLAYPAL
  doompal cube pal0.png
      Make a .cube LUT for image editors
  doompal playpal pal0.pal playpal.png --blank
      Blank 256×14 playpal PNG (all rows identical, no tints)
  doompal slade playpal.pal mypal --cell 16
      SLADE-style grid at 256×256 (16px cells)
  doompal extract doom2.wad --boomlist
      List Boom colormaps inside a WAD
  doompal cleanpal playpal.png
      Duplicate/similar colour analysis (CIE Lab, tolerance 2.0)
  doompal cleanpal doom2.wad --tolerance 2.3 --layers
      Analyse the WAD's PLAYPAL, plus one PNG per duplicate group
  doompal cleanpal pal0.png --rgb
      Legacy weighted-RGB metric (tolerance 1.1)

----------------------------------------
             How to use
----------------------------------------
 Place the bat file and the script file
 in a dir which has been added to your
 path. Then simply run it via the bat
 filename from any location on your
 computer using the command line.
 
----------------------------------------
        Python Dependancies
----------------------------------------
 py -m pip install --upgrade pip
 py -m pip install Pillow numpy