=pod
=head1 NAME
SDL::Palette -- Color palette for 8-bit pixel formats
=head1 CATEGORY
Core, Video, Structure
=head1 DESCRIPTION
Each pixel in an 8-bit surface is an index into the colors field of the C<SDL::Palette> object stored in its C<SDL::PixelFormat>.
A C<SDL::Palette> is created automatically when SDL allocates a C<SDL::PixelFormat> for a surface.
This class has methods for returning the colors in a palette object.
The colors can be set with L<SDL::Video::set_colors|SDL::Video/set_colors> and L<SDL::Video::set_palette|SDL::Video/set_palette>.
=head1 METHODS
=head2 ncolors
$ncolors = $palette->ncolors();
Returns the number of colors in palette.
=head2 colors
@colors = @{ $palette->colors() };
Returns an array, C<ncolors> in length, of the L<SDL::Color>s in the palette.
=head2 color_index
$color = $palette->color_index( $index );
Returns the L<SDL::Color> at the provided index of the palette.
=head1 SEE ALSO
L<SDL::Video> L<SDL::PixelFormat> L<SDL::Color> L<SDL::Surface>
=head1 AUTHORS
See L<SDL/AUTHORS>.
=cut