Please read oldapi.txt first, much of the stuff behaves in an identical way

This is, for now, a file detailing the new functions which we've added in.



==========================================================================
Light Based Manipulation Functions
==========================================================================

bool imlib2_image_modify_gamma(int img, double gamma)
	A gamma value of "0.0" will be black, 1 will be normal(no change)
	and 2.0 will be exceedingly white.

bool imlib2_image_modify_contrast(int img, double contrast)
	Contrast of 1.0 does nothing, 0.0 will merge to grey,
	2.0 will merge to white.

bool imlib2_image_modify_brightness(int img, double brightness)
	brightness of -1.0 will be absolute black, +1.0 will be all white.


==========================================================================
Image Loading Functions
==========================================================================

handler imlib2_load_image(string file)
	load an image. This only reads the header and assigns and imlib2
	loader to the file, it does not load the data straight in.

handler imlib2_load_image_without_cache(string file)
	load an image as above, but don't touch imlib2's cache in memory
	of recently loaded images. Helps if making changes to disk rapidly

handler imlib2_load_image_immediately(string file)
	load an image immediately, rather than just grabbing the header
	info.

handler imlib2_load_image_immediately_without_cache(string file)
	load image as above, but don't touch imlib2's memory cache at all.


==========================================================================
Image Freeing/Destruction Functions
==========================================================================

bool imlib2_free_image(int img)
	free a given image handler

bool imlib2_free_image_and_decache(int img)
	free a given image handler, and remove it from the memory cache



==========================================================================