4.4 Dither functions

Function: size_t stp_dither_algorithm_count (void)

This function returns the total number of available dither algorithms.

Function: const char * stp_dither_algorithm_name (int id)

This function is used to obtain a pointer to the name string of a given dither algorithm number id. id must be less than the number returned by stp_dither_algorithm_count. If id is out of the allowed range, NULL is returned.

Function: const char * stp_dither_algorithm_text (int id)

This function is used to obtain a pointer to the long name string of a given dither algorithm number id. The string is translated and encoded according to the current locale. Otherwise, its behaviour is identical to stp_dither_algorithm_name.

Function: const char * stp_default_dither_algorithm (void)

This function returns a pointer to the name string of the default dither algorithm.

None of the pointers returned may be freed with free.