# ai-minecraft-skin

A lightweight Elixir library for generating and manipulating Minecraft skin images. This package provides utilities for creating, customizing, and processing Minecraft skin data.

## Installation

Add `ai_minecraft_skin` to your list of dependencies in `mix.exs`:
elixir
def deps do
  [
    {:ai_minecraft_skin, "~> 0.1.0"} # Replace with the latest version
  ]
end

Then run:
shell
mix deps.get

## Usage Examples

Here are several examples showcasing how to use the `ai_minecraft_skin` library.

**1. Creating a basic skin:**
elixir
alias AiMinecraftSkin.Skin

skin = Skin.new()

# The `skin` variable now holds a default skin representation.
# You can then manipulate its layers and colors.

**2. Setting a specific pixel color:**
elixir
alias AiMinecraftSkin.Skin
alias AiMinecraftSkin.Color

skin = Skin.new()
color = Color.new(255, 0, 0) # Red

updated_skin = Skin.set_pixel(skin, :head, 1, 1, color)

# `updated_skin` now contains the skin with the pixel at head (1,1) set to red.

**3. Extracting a specific layer:**
elixir
alias AiMinecraftSkin.Skin

skin = Skin.new()

head_layer = Skin.get_layer(skin, :head)

# `head_layer` contains the image data for the head layer.
# You can then process this layer separately.

**4. Converting skin to a different format (example: grayscale):**
elixir
alias AiMinecraftSkin.Skin
alias AiMinecraftSkin.Transformer

skin = Skin.new()

grayscale_skin =
  skin
  |> Transformer.to_grayscale()

# `grayscale_skin` now contains the skin converted to grayscale.

**5. Combining multiple skins (example: overlaying a hat):**
elixir
alias AiMinecraftSkin.Skin
alias AiMinecraftSkin.Overlay

base_skin = Skin.new()
hat_skin = Skin.new() # Assumes you have a skin representing a hat

overlaid_skin = Overlay.apply(base_skin, hat_skin, :head)

# `overlaid_skin` contains the base skin with the hat skin overlaid on the head.

## Feature Summary

*   **Skin Creation:** Easily generate default Minecraft skin structures.
*   **Pixel Manipulation:** Set and retrieve individual pixel colors in different skin layers.
*   **Layer Access:** Extract specific layers (head, body, arms, legs) for targeted modifications.
*   **Transformation:** Includes basic image transformation functionalities, such as grayscale conversion.
*   **Overlaying:** Utilities for overlaying skins, enabling the creation of custom accessories and details.
*   **Color Management:** Provides a `Color` module for representing and manipulating color values.
*   **Modular Design:** The library is designed with modularity in mind, allowing for easy extension and customization.

## License

MIT

This package is part of the ai-minecraft-skin ecosystem. For advanced features and enterprise-grade tools, visit: https://supermaker.ai/image/ai-minecraft-skin/