2 * This library is free software; you can redistribute it and/or modify it
3 * under the terms of the GNU Lesser General Public License as published
4 * by the Free Software Foundation; either version 2 of the License, or
5 * (at your option) any later version.
7 * This library is distributed in the hope that it will be useful, but
8 * WITHOUT ANY WARRANTY; without even the implied warranty of
9 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
10 * Lesser General Public License for more details.
12 * You should have received a copy of the GNU Lesser General Public
13 * License along with this library; if not, write to the Free Software
14 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
22 /* Motion JPEG library */
39 #define QUICKTIME_MJPA_MARKSIZE 40
40 #define QUICKTIME_JPEG_TAG 0x6d6a7067
41 #define CODEC_TAG_MJPEG "mjpg"
42 #define CODEC_TAG_JPEG "jpeg"
45 struct mjpeg_error_mgr {
46 struct jpeg_error_mgr pub; /* "public" fields */
47 jmp_buf setjmp_buffer; /* for return to caller */
50 typedef struct mjpeg_error_mgr* mjpeg_error_ptr;
53 // The compressor structure is shared between decompressors and compressors
58 unsigned char *output_buffer; /* Buffer for MJPEG output */
59 long output_size; /* Size of image stored in buffer */
60 long output_allocated; /* Allocated size of output buffer */
61 struct jpeg_decompress_struct jpeg_decompress;
62 struct jpeg_compress_struct jpeg_compress;
63 struct mjpeg_error_mgr jpeg_error;
64 pthread_t tid; /* ID of thread */
65 pthread_mutex_t input_lock, output_lock;
66 int done; /* Flag to end */
68 // Pointer to uncompressed YUV rows
69 // [3 planes][downsampled rows][downsampled pixels]
70 unsigned char **rows[3];
71 /* Temp rows for each MCU */
72 unsigned char **mcu_rows[3];
73 /* Height of the field */
80 // Dimensions of user frame buffer
83 // Dimensions for encoder frame buffer
90 // Color model of user interface.
92 // Color model of compressed data. Since MJPA streams use 4:2:0
94 // To save on colormodel permutations, we flag grayscale separately and
95 // just set U and V to 0x80.
97 // Error in compression process
100 mjpeg_compressor *compressors[MAXFIELDS];
101 mjpeg_compressor *decompressors[MAXFIELDS];
103 // Temp frame for interlacing
104 // [3 planes][downsampled rows][downsampled pixels]
105 unsigned char *temp_data;
106 unsigned char **temp_rows[3];
107 unsigned char **row_argument, *y_argument, *u_argument, *v_argument;
109 // Buffer passed to user
110 // This can contain one progressive field or two fields with headers
111 unsigned char *output_data;
113 long output_allocated;
114 // Offset to field2 in output_data
116 // Buffer passed from user
117 unsigned char *input_data;
119 // Offset to field2 in input_data
124 // Workarounds for thread unsafe libraries
125 pthread_mutex_t decompress_init;
126 int decompress_initialized;
134 mjpeg_t* mjpeg_new(int w,
137 void mjpeg_delete(mjpeg_t *mjpeg);
139 void mjpeg_set_quality(mjpeg_t *mjpeg, int quality);
140 void mjpeg_set_float(mjpeg_t *mjpeg, int use_float);
141 // This is useful when producing realtime NTSC output for a JPEG board.
142 void mjpeg_set_deinterlace(mjpeg_t *mjpeg, int value);
143 void mjpeg_set_cpus(mjpeg_t *mjpeg, int cpus);
144 void mjpeg_set_rowspan(mjpeg_t *mjpeg, int rowspan);
147 int mjpeg_get_fields(mjpeg_t *mjpeg);
149 int mjpeg_decompress(mjpeg_t *mjpeg,
150 unsigned char *buffer,
153 unsigned char **row_pointers,
154 unsigned char *y_plane,
155 unsigned char *u_plane,
156 unsigned char *v_plane,
160 int mjpeg_compress(mjpeg_t *mjpeg,
161 unsigned char **row_pointers,
162 unsigned char *y_plane,
163 unsigned char *u_plane,
164 unsigned char *v_plane,
168 // Get buffer information after compressing
169 unsigned char* mjpeg_output_buffer(mjpeg_t *mjpeg);
171 long mjpeg_output_field2(mjpeg_t *mjpeg);
172 // Called before inserting markers by user
173 long mjpeg_output_size(mjpeg_t *mjpeg);
174 // Called before inserting markers by user
175 long mjpeg_output_allocated(mjpeg_t *mjpeg);
176 // Called after inserting markers by user to increase the size
177 void mjpeg_set_output_size(mjpeg_t *mjpeg, long output_size);
179 // Retrieve width and height from a buffer of JPEG data
180 void mjpeg_video_size(unsigned char *data, long data_size, int *w, int *h);
184 // Calculate marker contents and insert them into a buffer.
185 // Reallocates the buffer if it isn't big enough so make sure it's big enough
186 // when passing VFrames.
187 // field2_offset is set to -1 if the markers already exist or the field offset
188 // if markers don't already exist.
189 void mjpeg_insert_quicktime_markers(unsigned char **buffer,
191 long *buffer_allocated,
193 long *field2_offset);
194 void mjpeg_insert_avi_markers(unsigned char **buffer,
196 long *buffer_allocated,
198 long *field2_offset);
200 // Get the second field offset from the markers
201 long mjpeg_get_quicktime_field2(unsigned char *buffer, long buffer_size);
202 // Field dominance is retrieved for the jpeg decoder. AVI stores field
203 // dominance in each field.
204 long mjpeg_get_avi_field2(unsigned char *buffer,
206 int *field_dominance);
207 long mjpeg_get_field2(unsigned char *buffer, long buffer_size);