#pragma section-numbers off
#pragma disable-camelcase

= SDL_AllocPalette =
Use this function to create a palette structure with the specified number of color entries.

<<TableOfContents()>>

== Syntax ==
{{{#!highlight cpp
SDL_Palette* SDL_AllocPalette(int ncolors)
}}}

== Function Parameters ==
||'''ncolors'''||represents the number of color entries in the color palette||

== Return Value ==
Returns a new [[SDL_Palette]] structure on success or NULL on failure (e.g. if there wasn't enough memory); call [[SDL_GetError]]() for more information.

== Code Examples ==
{{{#!highlight cpp
You can add your code example here
}}}

== Remarks ==
The palette entries are initialized to white.

== Related Functions ==
 .[[SDL_FreePalette]]

----
[[CategoryAPI]], [[CategoryPixels]]