================
``\sprites.ini``
================

``pieces.ini`` is the configuration file that defines how animated chess pieces behave in Chess EXTREME.

Each section in this file corresponds to a specific piece and animation state, such as ``[WP_IDLE]`` or ``[BQ_ATTACK]`` (uses the same piece coding as in ``explosions.ini``).

Piece Codes
===========

Each key has two identifiers, the colour and the name of the piece.

``W - P``

``W = White``

``P = Pawn``

Due to this formatting, some pieces have the same first character as another and use a different one instead:

``Knight = N``

Otherwise, use the first character in a piece's name and you should be good.

``[DEFAULT]``
=============

The ``[DEFAULT]`` section provides **fallback settings** used when specific parameters are not defined in a piece’s section.

.. code-block:: text
    :caption: Default animation settings.

    [DEFAULT]
    frame_width=64 ; pixel size of each frame on the sprite sheet  
    frame_height=64 ; pixel size of each frame on the sprite sheet  
    num_frames=1 ; how many frames make up the animation  
    layout=vertical ; frame arrangement (``vertical`` = stacked top to bottom)  
    fps=10 ; playback speed (frames per second)
    loop=true ; whether animation repeats continuously
    scale=1.0 ; scaling multiplier for sprite size  
    offset_x=0 ; horizontal and vertical offsets for sprite positioning 
    offset_y=0 ; horizontal and vertical offsets for sprite positioning