Initial commit.
[pdfium.git] / core / src / fxcodec / libjpeg / fpdfapi_jcapimin.c
1 #if !defined(_FX_JPEG_TURBO_)\r
2 /*\r
3  * jcapimin.c\r
4  *\r
5  * Copyright (C) 1994-1998, Thomas G. Lane.\r
6  * This file is part of the Independent JPEG Group's software.\r
7  * For conditions of distribution and use, see the accompanying README file.\r
8  *\r
9  * This file contains application interface code for the compression half\r
10  * of the JPEG library.  These are the "minimum" API routines that may be\r
11  * needed in either the normal full-compression case or the transcoding-only\r
12  * case.\r
13  *\r
14  * Most of the routines intended to be called directly by an application\r
15  * are in this file or in jcapistd.c.  But also see jcparam.c for\r
16  * parameter-setup helper routines, jcomapi.c for routines shared by\r
17  * compression and decompression, and jctrans.c for the transcoding case.\r
18  */\r
19 \r
20 #define JPEG_INTERNALS\r
21 #include "jinclude.h"\r
22 #include "jpeglib.h"\r
23 \r
24 \r
25 /*\r
26  * Initialization of a JPEG compression object.\r
27  * The error manager must already be set up (in case memory manager fails).\r
28  */\r
29 \r
30 GLOBAL(void)\r
31 jpeg_CreateCompress (j_compress_ptr cinfo, int version, size_t structsize)\r
32 {\r
33   int i;\r
34 \r
35   /* Guard against version mismatches between library and caller. */\r
36   cinfo->mem = NULL;            /* so jpeg_destroy knows mem mgr not called */\r
37   if (version != JPEG_LIB_VERSION)\r
38     ERREXIT2(cinfo, JERR_BAD_LIB_VERSION, JPEG_LIB_VERSION, version);\r
39   if (structsize != SIZEOF(struct jpeg_compress_struct))\r
40     ERREXIT2(cinfo, JERR_BAD_STRUCT_SIZE, \r
41              (int) SIZEOF(struct jpeg_compress_struct), (int) structsize);\r
42 \r
43   /* For debugging purposes, we zero the whole master structure.\r
44    * But the application has already set the err pointer, and may have set\r
45    * client_data, so we have to save and restore those fields.\r
46    * Note: if application hasn't set client_data, tools like Purify may\r
47    * complain here.\r
48    */\r
49   {\r
50     struct jpeg_error_mgr * err = cinfo->err;\r
51     void * client_data = cinfo->client_data; /* ignore Purify complaint here */\r
52     MEMZERO(cinfo, SIZEOF(struct jpeg_compress_struct));\r
53     cinfo->err = err;\r
54     cinfo->client_data = client_data;\r
55   }\r
56   cinfo->is_decompressor = FALSE;\r
57 \r
58   /* Initialize a memory manager instance for this object */\r
59   jinit_memory_mgr((j_common_ptr) cinfo);\r
60 \r
61   /* Zero out pointers to permanent structures. */\r
62   cinfo->progress = NULL;\r
63   cinfo->dest = NULL;\r
64 \r
65   cinfo->comp_info = NULL;\r
66 \r
67   for (i = 0; i < NUM_QUANT_TBLS; i++)\r
68     cinfo->quant_tbl_ptrs[i] = NULL;\r
69 \r
70   for (i = 0; i < NUM_HUFF_TBLS; i++) {\r
71     cinfo->dc_huff_tbl_ptrs[i] = NULL;\r
72     cinfo->ac_huff_tbl_ptrs[i] = NULL;\r
73   }\r
74 \r
75   cinfo->script_space = NULL;\r
76 \r
77   cinfo->input_gamma = 1.0;     /* in case application forgets */\r
78 \r
79   /* OK, I'm ready */\r
80   cinfo->global_state = CSTATE_START;\r
81 }\r
82 \r
83 \r
84 /*\r
85  * Destruction of a JPEG compression object\r
86  */\r
87 \r
88 GLOBAL(void)\r
89 jpeg_destroy_compress (j_compress_ptr cinfo)\r
90 {\r
91   jpeg_destroy((j_common_ptr) cinfo); /* use common routine */\r
92 }\r
93 \r
94 \r
95 /*\r
96  * Abort processing of a JPEG compression operation,\r
97  * but don't destroy the object itself.\r
98  */\r
99 \r
100 GLOBAL(void)\r
101 jpeg_abort_compress (j_compress_ptr cinfo)\r
102 {\r
103   jpeg_abort((j_common_ptr) cinfo); /* use common routine */\r
104 }\r
105 \r
106 \r
107 /*\r
108  * Forcibly suppress or un-suppress all quantization and Huffman tables.\r
109  * Marks all currently defined tables as already written (if suppress)\r
110  * or not written (if !suppress).  This will control whether they get emitted\r
111  * by a subsequent jpeg_start_compress call.\r
112  *\r
113  * This routine is exported for use by applications that want to produce\r
114  * abbreviated JPEG datastreams.  It logically belongs in jcparam.c, but\r
115  * since it is called by jpeg_start_compress, we put it here --- otherwise\r
116  * jcparam.o would be linked whether the application used it or not.\r
117  */\r
118 \r
119 GLOBAL(void)\r
120 jpeg_suppress_tables (j_compress_ptr cinfo, boolean suppress)\r
121 {\r
122   int i;\r
123   JQUANT_TBL * qtbl;\r
124   JHUFF_TBL * htbl;\r
125 \r
126   for (i = 0; i < NUM_QUANT_TBLS; i++) {\r
127     if ((qtbl = cinfo->quant_tbl_ptrs[i]) != NULL)\r
128       qtbl->sent_table = suppress;\r
129   }\r
130 \r
131   for (i = 0; i < NUM_HUFF_TBLS; i++) {\r
132     if ((htbl = cinfo->dc_huff_tbl_ptrs[i]) != NULL)\r
133       htbl->sent_table = suppress;\r
134     if ((htbl = cinfo->ac_huff_tbl_ptrs[i]) != NULL)\r
135       htbl->sent_table = suppress;\r
136   }\r
137 }\r
138 \r
139 \r
140 /*\r
141  * Finish JPEG compression.\r
142  *\r
143  * If a multipass operating mode was selected, this may do a great deal of\r
144  * work including most of the actual output.\r
145  */\r
146 \r
147 GLOBAL(void)\r
148 jpeg_finish_compress (j_compress_ptr cinfo)\r
149 {\r
150   JDIMENSION iMCU_row;\r
151 \r
152   if (cinfo->global_state == CSTATE_SCANNING ||\r
153       cinfo->global_state == CSTATE_RAW_OK) {\r
154     /* Terminate first pass */\r
155     if (cinfo->next_scanline < cinfo->image_height)\r
156       ERREXIT(cinfo, JERR_TOO_LITTLE_DATA);\r
157     (*cinfo->master->finish_pass) (cinfo);\r
158   } else if (cinfo->global_state != CSTATE_WRCOEFS)\r
159     ERREXIT1(cinfo, JERR_BAD_STATE, cinfo->global_state);\r
160   /* Perform any remaining passes */\r
161   while (! cinfo->master->is_last_pass) {\r
162     (*cinfo->master->prepare_for_pass) (cinfo);\r
163     for (iMCU_row = 0; iMCU_row < cinfo->total_iMCU_rows; iMCU_row++) {\r
164       if (cinfo->progress != NULL) {\r
165         cinfo->progress->pass_counter = (long) iMCU_row;\r
166         cinfo->progress->pass_limit = (long) cinfo->total_iMCU_rows;\r
167         (*cinfo->progress->progress_monitor) ((j_common_ptr) cinfo);\r
168       }\r
169       /* We bypass the main controller and invoke coef controller directly;\r
170        * all work is being done from the coefficient buffer.\r
171        */\r
172       if (! (*cinfo->coef->compress_data) (cinfo, (JSAMPIMAGE) NULL))\r
173         ERREXIT(cinfo, JERR_CANT_SUSPEND);\r
174     }\r
175     (*cinfo->master->finish_pass) (cinfo);\r
176   }\r
177   /* Write EOI, do final cleanup */\r
178   (*cinfo->marker->write_file_trailer) (cinfo);\r
179   (*cinfo->dest->term_destination) (cinfo);\r
180   /* We can use jpeg_abort to release memory and reset global_state */\r
181   jpeg_abort((j_common_ptr) cinfo);\r
182 }\r
183 \r
184 \r
185 /*\r
186  * Write a special marker.\r
187  * This is only recommended for writing COM or APPn markers.\r
188  * Must be called after jpeg_start_compress() and before\r
189  * first call to jpeg_write_scanlines() or jpeg_write_raw_data().\r
190  */\r
191 \r
192 GLOBAL(void)\r
193 jpeg_write_marker (j_compress_ptr cinfo, int marker,\r
194                    const JOCTET *dataptr, unsigned int datalen)\r
195 {\r
196   JMETHOD(void, write_marker_byte, (j_compress_ptr info, int val));\r
197 \r
198   if (cinfo->next_scanline != 0 ||\r
199       (cinfo->global_state != CSTATE_SCANNING &&\r
200        cinfo->global_state != CSTATE_RAW_OK &&\r
201        cinfo->global_state != CSTATE_WRCOEFS))\r
202     ERREXIT1(cinfo, JERR_BAD_STATE, cinfo->global_state);\r
203 \r
204   (*cinfo->marker->write_marker_header) (cinfo, marker, datalen);\r
205   write_marker_byte = cinfo->marker->write_marker_byte; /* copy for speed */\r
206   while (datalen--) {\r
207     (*write_marker_byte) (cinfo, *dataptr);\r
208     dataptr++;\r
209   }\r
210 }\r
211 \r
212 /* Same, but piecemeal. */\r
213 \r
214 GLOBAL(void)\r
215 jpeg_write_m_header (j_compress_ptr cinfo, int marker, unsigned int datalen)\r
216 {\r
217   if (cinfo->next_scanline != 0 ||\r
218       (cinfo->global_state != CSTATE_SCANNING &&\r
219        cinfo->global_state != CSTATE_RAW_OK &&\r
220        cinfo->global_state != CSTATE_WRCOEFS))\r
221     ERREXIT1(cinfo, JERR_BAD_STATE, cinfo->global_state);\r
222 \r
223   (*cinfo->marker->write_marker_header) (cinfo, marker, datalen);\r
224 }\r
225 \r
226 GLOBAL(void)\r
227 jpeg_write_m_byte (j_compress_ptr cinfo, int val)\r
228 {\r
229   (*cinfo->marker->write_marker_byte) (cinfo, val);\r
230 }\r
231 \r
232 \r
233 /*\r
234  * Alternate compression function: just write an abbreviated table file.\r
235  * Before calling this, all parameters and a data destination must be set up.\r
236  *\r
237  * To produce a pair of files containing abbreviated tables and abbreviated\r
238  * image data, one would proceed as follows:\r
239  *\r
240  *              initialize JPEG object\r
241  *              set JPEG parameters\r
242  *              set destination to table file\r
243  *              jpeg_write_tables(cinfo);\r
244  *              set destination to image file\r
245  *              jpeg_start_compress(cinfo, FALSE);\r
246  *              write data...\r
247  *              jpeg_finish_compress(cinfo);\r
248  *\r
249  * jpeg_write_tables has the side effect of marking all tables written\r
250  * (same as jpeg_suppress_tables(..., TRUE)).  Thus a subsequent start_compress\r
251  * will not re-emit the tables unless it is passed write_all_tables=TRUE.\r
252  */\r
253 \r
254 GLOBAL(void)\r
255 jpeg_write_tables (j_compress_ptr cinfo)\r
256 {\r
257   if (cinfo->global_state != CSTATE_START)\r
258     ERREXIT1(cinfo, JERR_BAD_STATE, cinfo->global_state);\r
259 \r
260   /* (Re)initialize error mgr and destination modules */\r
261   (*cinfo->err->reset_error_mgr) ((j_common_ptr) cinfo);\r
262   (*cinfo->dest->init_destination) (cinfo);\r
263   /* Initialize the marker writer ... bit of a crock to do it here. */\r
264   jinit_marker_writer(cinfo);\r
265   /* Write them tables! */\r
266   (*cinfo->marker->write_tables_only) (cinfo);\r
267   /* And clean up. */\r
268   (*cinfo->dest->term_destination) (cinfo);\r
269   /*\r
270    * In library releases up through v6a, we called jpeg_abort() here to free\r
271    * any working memory allocated by the destination manager and marker\r
272    * writer.  Some applications had a problem with that: they allocated space\r
273    * of their own from the library memory manager, and didn't want it to go\r
274    * away during write_tables.  So now we do nothing.  This will cause a\r
275    * memory leak if an app calls write_tables repeatedly without doing a full\r
276    * compression cycle or otherwise resetting the JPEG object.  However, that\r
277    * seems less bad than unexpectedly freeing memory in the normal case.\r
278    * An app that prefers the old behavior can call jpeg_abort for itself after\r
279    * each call to jpeg_write_tables().\r
280    */\r
281 }\r
282 \r
283 #endif //_FX_JPEG_TURBO_\r