pixel_art.py 5.7 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162
  1. """Pixel art converter — Floyd-Steinberg dithering with preset or named palette.
  2. Named hardware palettes (NES, GameBoy, PICO-8, C64, etc.) ported from
  3. pixel-art-studio (MIT) — see ATTRIBUTION.md.
  4. Usage (import):
  5. from pixel_art import pixel_art
  6. pixel_art("in.png", "out.png", preset="arcade")
  7. pixel_art("in.png", "out.png", preset="nes")
  8. pixel_art("in.png", "out.png", palette="PICO_8", block=6)
  9. Usage (CLI):
  10. python pixel_art.py in.png out.png --preset nes
  11. """
  12. from PIL import Image, ImageEnhance, ImageOps
  13. try:
  14. from .palettes import PALETTES, build_palette_image
  15. except ImportError:
  16. from palettes import PALETTES, build_palette_image
  17. PRESETS = {
  18. # ── Original presets (adaptive palette) ─────────────────────────────
  19. "arcade": {
  20. "contrast": 1.8, "color": 1.5, "sharpness": 1.2,
  21. "posterize_bits": 5, "block": 8, "palette": 16,
  22. },
  23. "snes": {
  24. "contrast": 1.6, "color": 1.4, "sharpness": 1.2,
  25. "posterize_bits": 6, "block": 4, "palette": 32,
  26. },
  27. # ── Hardware-accurate presets (named palette) ───────────────────────
  28. "nes": {
  29. "contrast": 1.5, "color": 1.4, "sharpness": 1.2,
  30. "posterize_bits": 6, "block": 8, "palette": "NES",
  31. },
  32. "gameboy": {
  33. "contrast": 1.5, "color": 1.0, "sharpness": 1.2,
  34. "posterize_bits": 6, "block": 8, "palette": "GAMEBOY_ORIGINAL",
  35. },
  36. "gameboy_pocket": {
  37. "contrast": 1.5, "color": 1.0, "sharpness": 1.2,
  38. "posterize_bits": 6, "block": 8, "palette": "GAMEBOY_POCKET",
  39. },
  40. "pico8": {
  41. "contrast": 1.6, "color": 1.3, "sharpness": 1.2,
  42. "posterize_bits": 6, "block": 6, "palette": "PICO_8",
  43. },
  44. "c64": {
  45. "contrast": 1.6, "color": 1.3, "sharpness": 1.2,
  46. "posterize_bits": 6, "block": 8, "palette": "C64",
  47. },
  48. "apple2": {
  49. "contrast": 1.8, "color": 1.4, "sharpness": 1.2,
  50. "posterize_bits": 5, "block": 10, "palette": "APPLE_II_HI",
  51. },
  52. "teletext": {
  53. "contrast": 1.8, "color": 1.5, "sharpness": 1.2,
  54. "posterize_bits": 5, "block": 10, "palette": "TELETEXT",
  55. },
  56. "mspaint": {
  57. "contrast": 1.6, "color": 1.4, "sharpness": 1.2,
  58. "posterize_bits": 6, "block": 8, "palette": "MICROSOFT_WINDOWS_PAINT",
  59. },
  60. "mono_green": {
  61. "contrast": 1.8, "color": 0.0, "sharpness": 1.2,
  62. "posterize_bits": 5, "block": 6, "palette": "MONO_GREEN",
  63. },
  64. "mono_amber": {
  65. "contrast": 1.8, "color": 0.0, "sharpness": 1.2,
  66. "posterize_bits": 5, "block": 6, "palette": "MONO_AMBER",
  67. },
  68. # ── Artistic palette presets ────────────────────────────────────────
  69. "neon": {
  70. "contrast": 1.8, "color": 1.6, "sharpness": 1.2,
  71. "posterize_bits": 5, "block": 6, "palette": "NEON_CYBER",
  72. },
  73. "pastel": {
  74. "contrast": 1.2, "color": 1.3, "sharpness": 1.1,
  75. "posterize_bits": 6, "block": 6, "palette": "PASTEL_DREAM",
  76. },
  77. }
  78. def pixel_art(input_path, output_path, preset="arcade", **overrides):
  79. """Convert an image to retro pixel art.
  80. Args:
  81. input_path: path to source image
  82. output_path: path to save the resulting PNG
  83. preset: one of PRESETS (arcade, snes, nes, gameboy, pico8, c64, ...)
  84. **overrides: optionally override any preset field. In particular:
  85. palette: int (adaptive N colors) OR str (named palette from PALETTES)
  86. block: int pixel block size
  87. contrast / color / sharpness / posterize_bits: numeric enhancers
  88. Returns:
  89. The resulting PIL.Image.
  90. """
  91. if preset not in PRESETS:
  92. raise ValueError(
  93. f"Unknown preset {preset!r}. Choose from: {sorted(PRESETS)}"
  94. )
  95. cfg = {**PRESETS[preset], **overrides}
  96. img = Image.open(input_path).convert("RGB")
  97. img = ImageEnhance.Contrast(img).enhance(cfg["contrast"])
  98. img = ImageEnhance.Color(img).enhance(cfg["color"])
  99. img = ImageEnhance.Sharpness(img).enhance(cfg["sharpness"])
  100. img = ImageOps.posterize(img, cfg["posterize_bits"])
  101. w, h = img.size
  102. block = cfg["block"]
  103. small = img.resize(
  104. (max(1, w // block), max(1, h // block)),
  105. Image.NEAREST,
  106. )
  107. # Quantize AFTER downscale so Floyd-Steinberg aligns with final pixel grid.
  108. pal = cfg["palette"]
  109. if isinstance(pal, str):
  110. # Named hardware/artistic palette
  111. pal_img = build_palette_image(pal)
  112. quantized = small.quantize(palette=pal_img, dither=Image.FLOYDSTEINBERG)
  113. else:
  114. # Adaptive N-color palette (original behavior)
  115. quantized = small.quantize(colors=int(pal), dither=Image.FLOYDSTEINBERG)
  116. result = quantized.resize((w, h), Image.NEAREST)
  117. result.save(output_path, "PNG")
  118. return result
  119. def main():
  120. import argparse
  121. p = argparse.ArgumentParser(description="Convert image to pixel art.")
  122. p.add_argument("input")
  123. p.add_argument("output")
  124. p.add_argument("--preset", default="arcade", choices=sorted(PRESETS))
  125. p.add_argument("--palette", default=None,
  126. help=f"Override palette: int or name from {sorted(PALETTES)}")
  127. p.add_argument("--block", type=int, default=None)
  128. args = p.parse_args()
  129. overrides = {}
  130. if args.palette is not None:
  131. try:
  132. overrides["palette"] = int(args.palette)
  133. except ValueError:
  134. overrides["palette"] = args.palette
  135. if args.block is not None:
  136. overrides["block"] = args.block
  137. pixel_art(args.input, args.output, preset=args.preset, **overrides)
  138. print(f"Wrote {args.output}")
  139. if __name__ == "__main__":
  140. main()