man fade_in () - Gradually fades the palette from black. Allegro game programming library.
NAME
fade_in - Gradually fades the palette from black. Allegro game programming library.
SYNOPSIS
#include <allegro.h>
void fade_in(const PALETTE p, int speed);
DESCRIPTION
Fades gradually from a black screen to the specified palette. The speed is from 1 (the slowest) up to 64 (instantaneous).
Note that this function will block your game while the fade is in effect, and it won't work right visually if you are not in an 8 bit color depth resolution.