The Tor Browser / file comparison
comparison: image/decoders/iccjpeg.h
image/decoders/iccjpeg.h
- changeset 0
- 6474c204b198
equal
deleted
inserted
replaced
| -1:000000000000 | 0:f8beb5534ea3 |
|---|---|
| 1 /* This Source Code Form is subject to the terms of the Mozilla Public | |
| 2 * License, v. 2.0. If a copy of the MPL was not distributed with this | |
| 3 * file, You can obtain one at http://mozilla.org/MPL/2.0/. */ | |
| 4 | |
| 5 /* | |
| 6 * iccprofile.h | |
| 7 * | |
| 8 * This file provides code to read and write International Color Consortium | |
| 9 * (ICC) device profiles embedded in JFIF JPEG image files. The ICC has | |
| 10 * defined a standard format for including such data in JPEG "APP2" markers. | |
| 11 * The code given here does not know anything about the internal structure | |
| 12 * of the ICC profile data; it just knows how to put the profile data into | |
| 13 * a JPEG file being written, or get it back out when reading. | |
| 14 * | |
| 15 * This code depends on new features added to the IJG JPEG library as of | |
| 16 * IJG release 6b; it will not compile or work with older IJG versions. | |
| 17 * | |
| 18 * NOTE: this code would need surgery to work on 16-bit-int machines | |
| 19 * with ICC profiles exceeding 64K bytes in size. See iccprofile.c | |
| 20 * for details. | |
| 21 */ | |
| 22 | |
| 23 #include <stdio.h> /* needed to define "FILE", "NULL" */ | |
| 24 #include "jpeglib.h" | |
| 25 | |
| 26 /* | |
| 27 * Reading a JPEG file that may contain an ICC profile requires two steps: | |
| 28 * | |
| 29 * 1. After jpeg_create_decompress() but before jpeg_read_header(), | |
| 30 * call setup_read_icc_profile(). This routine tells the IJG library | |
| 31 * to save in memory any APP2 markers it may find in the file. | |
| 32 * | |
| 33 * 2. After jpeg_read_header(), call read_icc_profile() to find out | |
| 34 * whether there was a profile and obtain it if so. | |
| 35 */ | |
| 36 | |
| 37 | |
| 38 /* | |
| 39 * Prepare for reading an ICC profile | |
| 40 */ | |
| 41 | |
| 42 extern void setup_read_icc_profile JPP((j_decompress_ptr cinfo)); | |
| 43 | |
| 44 | |
| 45 /* | |
| 46 * See if there was an ICC profile in the JPEG file being read; | |
| 47 * if so, reassemble and return the profile data. | |
| 48 * | |
| 49 * TRUE is returned if an ICC profile was found, FALSE if not. | |
| 50 * If TRUE is returned, *icc_data_ptr is set to point to the | |
| 51 * returned data, and *icc_data_len is set to its length. | |
| 52 * | |
| 53 * IMPORTANT: the data at **icc_data_ptr has been allocated with malloc() | |
| 54 * and must be freed by the caller with free() when the caller no longer | |
| 55 * needs it. (Alternatively, we could write this routine to use the | |
| 56 * IJG library's memory allocator, so that the data would be freed implicitly | |
| 57 * at jpeg_finish_decompress() time. But it seems likely that many apps | |
| 58 * will prefer to have the data stick around after decompression finishes.) | |
| 59 */ | |
| 60 | |
| 61 extern boolean read_icc_profile JPP((j_decompress_ptr cinfo, | |
| 62 JOCTET **icc_data_ptr, | |
| 63 unsigned int *icc_data_len)); |
