Warning: main(/www/www/htdocs/style/globals.php) [function.main]: failed to open stream: No such file or directory in /www/www/docs/6.4.1/gf/dev_guide/img/img_convert_getfunc.html on line 1
Warning: main() [function.include]: Failed opening '/www/www/htdocs/style/globals.php' for inclusion (include_path='.:/www/www/common:/www/www/php/lib/php') in /www/www/docs/6.4.1/gf/dev_guide/img/img_convert_getfunc.html on line 1
Warning: main(/www/www/htdocs/style/header.php) [function.main]: failed to open stream: No such file or directory in /www/www/docs/6.4.1/gf/dev_guide/img/img_convert_getfunc.html on line 8
Warning: main() [function.include]: Failed opening '/www/www/htdocs/style/header.php' for inclusion (include_path='.:/www/www/common:/www/www/php/lib/php') in /www/www/docs/6.4.1/gf/dev_guide/img/img_convert_getfunc.html on line 8
Get a function to convert one image format to another
#include <img.h>
img_convert_f *img_convert_getfunc( img_format_t src,
img_format_t dst )
- src
- The img_format_t image format to convert from
- dst
- The img_format_t image format to convert to.
img
This function returns a pointer to a data conversion function (or NULL if the requested conversion is not supported) which you can call to convert a run of pixels from format src to format dst. The source and destination formats must be “direct” — palette-based formats are not supported. A conversion function takes the form:
void convert_f( const uint8_t *src,
uint8_t *dst,
unsigned n )
A conversion function is called to convert n pixels from the src buffer, writing the results in the dst buffer. The conversions can be done in place (that is, src can be the same as dst).
Use this function instead of img_convert_data() if you need to repeatedly convert data from one format to another. Calling img_convert_data() each time will add overhead because it has to get the conversion function each time its called. Using this function, you can just call the correct conversion function yourself directly.
- IMG_ERR_OK
- Success.
- IMG_ERR_NOSUPPORT
- One of the formats specified is invalid.
Image library
Safety: | |
Interrupt handler |
No |
Signal handler |
No |
Thread |
No |
img_convert_data(),
IMG_FMT_BPL(),
img_lib_attach()
Warning: main(/www/www/htdocs/style/footer.php) [function.main]: failed to open stream: No such file or directory in /www/www/docs/6.4.1/gf/dev_guide/img/img_convert_getfunc.html on line 129
Warning: main() [function.include]: Failed opening '/www/www/htdocs/style/footer.php' for inclusion (include_path='.:/www/www/common:/www/www/php/lib/php') in /www/www/docs/6.4.1/gf/dev_guide/img/img_convert_getfunc.html on line 129