cairo_jpg

Introduction

This is an implementation of functions to import and export Cairo surfaces from and to JPEG files. It uses the same function prototypes as Cairo's PNG support.

Description

The implementation is done on top of the Cairo API. It does not access Cairo-internal functions. For compression and decompression a JPEG library is used. It compiles against libjpeg-turbo or the original libjpeg.

The following prototypes are implemented. Their functionality is equal to the PNG functions of Cairo with the advance that there are memory-buffer-based functions as well.

cairo_status_t cairo_image_surface_write_to_jpeg_mem(cairo_surface_t *sfc, unsigned char **data, size_t *len, int quality);
cairo_status_t cairo_image_surface_write_to_jpeg_stream(cairo_surface_t *sfc, cairo_write_func_t write_func, void *closure, int quality);
cairo_status_t cairo_image_surface_write_to_jpeg(cairo_surface_t *sfc, const char *filename, int quality);
cairo_surface_t *cairo_image_surface_create_from_jpeg_mem(void *data, size_t len);
cairo_surface_t *cairo_image_surface_create_from_jpeg_stream(cairo_read_func_t read_func, void *closure);
cairo_surface_t *cairo_image_surface_create_from_jpeg(const char *filename);

To compile this code you need to have installed the packages libcairo2-dev and libjpeg-dev. Compile with the following command to create an object file linkable to your code:

gcc -Wall -c cairo_jpg.c `pkg-config cairo libjpeg --cflags --libs`

Please have a look at the comments within the source files for further details. Don't hesitate to contact me at bf@abenteuerland.at.

Testing

There is a main() function implemented which serves as demonstrational purpose and for testing. To compile with the main() function run the following statement:

gcc -Wall -o cairo_jpg -DCAIRO_JPEG_MAIN `pkg-config cairo libjpeg --cflags` cairo_jpg.c `pkg-config cairo libjpeg --libs`

License

Cairo_JPG is free software: you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

Cairo_JPG is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details.

You should have received a copy of the GNU General Public License along with Cairo_JPG. If not, see https://www.gnu.org/licenses/.