Skip to content

v0.4.0: Nearest-Neighbor Pixel Scaling, True-Black LED Post-Processing & Agent Skill Enhancements

Latest
Latest

Choose a tag to compare

View all tags
@github-actions github-actions released this 11 Oct 13:26
v0.4.0
1f8413e

What's New in v0.4.0

👾 Nearest-Neighbor Sampling Mode (--nearest / --sampling-mode)

  • Crisp Pixel Art Scaling: Added SamplingMode (BILINEAR default, NEAREST_NEIGHBOR) across PixooImage, ImageProcessor, GifDecoder, PixooClient, and pixoo-cli (#2).
  • Zero Anti-Aliasing Blur: Preserves razor-sharp 1px edges and exact palette colors when downscaling high-resolution AI-generated sprite sheets or upscaling 16×16 / 32×32 retro sprites to the 64×64 matrix.
  • CLI Flags: Added -n, --nearest and --sampling-mode <bilinear|nearest> to both pixoo-cli image and pixoo-cli gif.

💡 Physical LED Matrix Post-Processor (--led-optimize / LedPostProcessor)

  • True-Black (#000000) Clamping: Added LedPostProcessor to clamp near-black dark/shadow background pixels (max(R, G, B) <= blackThreshold, default 15) to exact #000000 so unlit LEDs physically power off instead of firing at minimum PWM duty cycle and causing gray diffuser haze (#3).
  • Semi-Transparent Alpha Compositing: Automatically composites semi-transparent pixels over black before applying the True-Black threshold.
  • Pure-Java Diffuser Saturation Boost: Optional zero-allocation, AWT-free HSV saturation boost (saturationBoost) to help colors punch through the matte diffuser while preserving GraalVM native-image compatibility on macOS.
  • CLI Flags: Added -o, --led-optimize and --black-threshold <0..255> (which automatically enables LED optimization) to pixoo-cli image and pixoo-cli gif (including remote --url GIF streams).

🧩 Unified Java API Overloads

  • Added complete (ScaleMode, SamplingMode, LedPostProcessor) overload combinations across PixooClient.sendImage(PixooImage/BufferedImage/Path) and PixooClient.sendGif(InputStream/Path/URI) + sendGifUrl(String).

🤖 Enhanced pixoo64 Agent Skill & AI Prompt Blueprints

  • Physical LED Optical & Temporal Bible (skills/pixoo64/references/pixoo64-led-bible.md): Documented the True-Black (#000000) LED-off law, diffuser saturation rules (HSV Saturation >= 0.65), 3-step neon bloom ramp, 32-frame hardware ceiling, and static background locking (#1).
  • Empirical Animation Archetypes (skills/pixoo64/references/discovered-patterns.md): Added scenic-loop, character-sprite, abstract-shader, widget-hud, and typography-marquee design patterns.
  • Gemini Nano Banana Prompt Templates (skills/pixoo64/references/nano-banana-prompts.md): Added ready-to-use prompt blueprints and ffmpeg 2×2 sprite-sheet slicing workflows.
  • Curated LED Palettes (skills/pixoo64/references/palettes.json): Added 9 high-saturation, True-Black-anchored palettes tailored for the 64×64 matrix.

🛠️ Build & Developer Experience

  • Added AGENTS.md coding agent guide at the repository root.
  • Added Maven Wrapper (./mvnw) configured with Maven 3.10.0.

🙏 Contributors

Special thanks to @alexismp for contributing PRs #1, #2, and #3!

📦 Pre-compiled Native Binaries

Instantaneous startup (<5ms) without requiring a JVM:

  • macOS (Apple Silicon / aarch64): pixoo-cli-macos-aarch64.zip
  • Linux (x86_64): pixoo-cli-linux-amd64.zip
  • Windows (x86_64): pixoo-cli-windows-amd64.zip

Contributors

alexismp
Assets 5
Loading