Files
UltraGrid/gpujpeg/libgpujpeg/gpujpeg_writer.h
2012-12-18 13:41:26 +01:00

147 lines
4.1 KiB
C

/**
* Copyright (c) 2011, CESNET z.s.p.o
* Copyright (c) 2011, Silicon Genome, LLC.
*
* All rights reserved.
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions are met:
*
* * Redistributions of source code must retain the above copyright
* notice, this list of conditions and the following disclaimer.
*
* * Redistributions in binary form must reproduce the above copyright
* notice, this list of conditions and the following disclaimer in the
* documentation and/or other materials provided with the distribution.
*
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
* AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
* IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
* ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
* LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
* CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
* SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
* INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
* CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
* ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
* POSSIBILITY OF SUCH DAMAGE.
*/
#ifndef GPUJPEG_WRITER_H
#define GPUJPEG_WRITER_H
#include <libgpujpeg/gpujpeg_type.h>
#ifdef __cplusplus
extern "C" {
#endif
/** JPEG encoder structure predeclaration */
struct gpujpeg_encoder;
/** JPEG writer structure */
struct gpujpeg_writer
{
// Output buffer
uint8_t* buffer;
// Output buffer current position
uint8_t* buffer_current;
// Segment info buffers (every buffer is placed inside another header)
uint8_t* segment_info[GPUJPEG_MAX_SEGMENT_INFO_HEADER_COUNT];
// Segment info buffers count (equals number of segment info headers)
int segment_info_count;
// Segment info current position in scan
uint8_t* segment_info_position;
// Segment info current segment index
int segment_info_index;
};
/**
* Create JPEG writer
*
* @return writer structure if succeeds, otherwise NULL
*/
struct gpujpeg_writer*
gpujpeg_writer_create(struct gpujpeg_encoder* encoder);
/**
* Destroy JPEG writer
*
* @param writer Writer structure
* @return 0 if succeeds, otherwise nonzero
*/
int
gpujpeg_writer_destroy(struct gpujpeg_writer* writer);
/**
* Write one byte to file
*
* @param writer Writer structure
* @param value Byte value to write
* @return void
*/
#define gpujpeg_writer_emit_byte(writer, value) { \
*writer->buffer_current = (uint8_t)(value); \
writer->buffer_current++; }
/**
* Write two bytes to file
*
* @param writer Writer structure
* @param value Two-byte value to write
* @return void
*/
#define gpujpeg_writer_emit_2byte(writer, value) { \
*writer->buffer_current = (uint8_t)(((value) >> 8) & 0xFF); \
writer->buffer_current++; \
*writer->buffer_current = (uint8_t)((value) & 0xFF); \
writer->buffer_current++; }
/**
* Write marker to file
*
* @param writer Writer structure
* @oaran marker Marker to write (JPEG_MARKER_...)
* @return void
*/
#define gpujpeg_writer_emit_marker(writer, marker) { \
*writer->buffer_current = 0xFF;\
writer->buffer_current++; \
*writer->buffer_current = (uint8_t)(marker); \
writer->buffer_current++; }
/**
* Write JPEG header (write soi, app0, Y_dqt, CbCr_dqt, sof, 4 * dht blocks)
*
* @param encoder Encoder structure
* @return void
*/
void
gpujpeg_writer_write_header(struct gpujpeg_encoder* encoder);
/**
* Write segment info for current position in write buffer
*
* @param encoder Encoder structure
* @return void
*/
void
gpujpeg_writer_write_segment_info(struct gpujpeg_encoder* encoder);
/**
* Write scan header for one component
*
* @param encoder Encoder structure
* @param scan_index Scan index
* @return void
*/
void
gpujpeg_writer_write_scan_header(struct gpujpeg_encoder* encoder, int scan_index);
#ifdef __cplusplus
}
#endif
#endif // GPUJPEG_WRITER_H