mirror of
https://gitlab.freedesktop.org/gstreamer/gstreamer.git
synced 2025-01-01 04:58:47 +00:00
326a229636
Add valid flag to GstJpegQuantTable and GstJpegHuffmanTable so that to determine whether a table actually changed since the last user synchronization point. That way, this makes it possible for some hardware accelerated decoding solution to upload only those tables that changed.
426 lines
14 KiB
C
426 lines
14 KiB
C
/*
|
|
* gstjpegparser.h - JPEG parser
|
|
*
|
|
* Copyright (C) 2011 Intel Corporation
|
|
*
|
|
* This library 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 2.1
|
|
* of the License, or (at your option) any later version.
|
|
*
|
|
* This library 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 Lesser General Public
|
|
* License along with this library; if not, write to the Free
|
|
* Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
|
|
* Boston, MA 02110-1301 USA
|
|
*/
|
|
|
|
#ifndef GST_JPEG_PARSER_H
|
|
#define GST_JPEG_PARSER_H
|
|
|
|
#ifndef GST_USE_UNSTABLE_API
|
|
# warning "The JPEG parsing library is unstable API and may change in future."
|
|
# warning "You can define GST_USE_UNSTABLE_API to avoid this warning."
|
|
#endif
|
|
|
|
#include <gst/gst.h>
|
|
|
|
G_BEGIN_DECLS
|
|
|
|
/**
|
|
* GST_JPEG_MAX_FRAME_COMPONENTS:
|
|
*
|
|
* Maximum number of image components in a frame (Nf).
|
|
*/
|
|
#define GST_JPEG_MAX_FRAME_COMPONENTS 256
|
|
|
|
/**
|
|
* GST_JPEG_MAX_SCAN_COMPONENTS:
|
|
*
|
|
* Maximum number of image components in a scan (Ns).
|
|
*/
|
|
#define GST_JPEG_MAX_SCAN_COMPONENTS 4
|
|
|
|
/**
|
|
* GST_JPEG_MAX_QUANT_ELEMENTS:
|
|
*
|
|
* Number of elements in the quantization table.
|
|
*/
|
|
#define GST_JPEG_MAX_QUANT_ELEMENTS 64
|
|
|
|
typedef struct _GstJpegQuantTable GstJpegQuantTable;
|
|
typedef struct _GstJpegQuantTables GstJpegQuantTables;
|
|
typedef struct _GstJpegHuffmanTable GstJpegHuffmanTable;
|
|
typedef struct _GstJpegHuffmanTables GstJpegHuffmanTables;
|
|
typedef struct _GstJpegScanComponent GstJpegScanComponent;
|
|
typedef struct _GstJpegScanHdr GstJpegScanHdr;
|
|
typedef struct _GstJpegFrameComponent GstJpegFrameComponent;
|
|
typedef struct _GstJpegFrameHdr GstJpegFrameHdr;
|
|
typedef struct _GstJpegTypeOffsetSize GstJpegTypeOffsetSize;
|
|
typedef struct _GstJpegScanOffsetSize GstJpegScanOffsetSize;
|
|
|
|
/**
|
|
* GstJpegParserResult:
|
|
* @GST_JPEG_PARSER_OK: The parsing succeeded
|
|
* @GST_JPEG_PARSER_BROKEN_DATA: The data to parse is broken
|
|
* @GST_JPEG_PARSER_NO_SCAN_FOUND: No scan found during the parsing
|
|
* @GST_JPEG_PARSER_ERROR: An error occured while parsing
|
|
*
|
|
* The result of parsing JPEG data.
|
|
*/
|
|
typedef enum
|
|
{
|
|
GST_JPEG_PARSER_OK,
|
|
GST_JPEG_PARSER_BROKEN_DATA,
|
|
GST_JPEG_PARSER_NO_SCAN_FOUND,
|
|
GST_JPEG_PARSER_ERROR,
|
|
} GstJpegParserResult;
|
|
|
|
/**
|
|
* GstJpegMarkerCode:
|
|
* @GST_JPEG_MARKER_SOF_MIN: Start of frame min marker code
|
|
* @GST_JPEG_MARKER_SOF_MAX: Start of frame max marker code
|
|
* @GST_JPEG_MARKER_DHT: Huffman tabler marker code
|
|
* @GST_JPEG_MARKER_DAC: Arithmetic coding marker code
|
|
* @GST_JPEG_MARKER_RST_MIN: Restart interval min marker code
|
|
* @GST_JPEG_MARKER_RST_MAX: Restart interval max marker code
|
|
* @GST_JPEG_MARKER_SOI: Start of image marker code
|
|
* @GST_JPEG_MARKER_EOI: End of image marker code
|
|
* @GST_JPEG_MARKER_SOS: Start of scan marker code
|
|
* @GST_JPEG_MARKER_DQT: Define quantization table marker code
|
|
* @GST_JPEG_MARKER_DNL: Define number of lines marker code
|
|
* @GST_JPEG_MARKER_DRI: Define restart interval marker code
|
|
* @GST_JPEG_MARKER_APP_MIN: Application segment min marker code
|
|
* @GST_JPEG_MARKER_APP_MAX: Application segment max marker code
|
|
* @GST_JPEG_MARKER_COM: Comment marker code
|
|
*
|
|
* Indicates the type of JPEG segment.
|
|
*/
|
|
typedef enum {
|
|
GST_JPEG_MARKER_SOF_MIN = 0xC0,
|
|
GST_JPEG_MARKER_SOF_MAX = 0xCF,
|
|
GST_JPEG_MARKER_DHT = 0xC4,
|
|
GST_JPEG_MARKER_DAC = 0xCC,
|
|
GST_JPEG_MARKER_RST_MIN = 0xD0,
|
|
GST_JPEG_MARKER_RST_MAX = 0xD7,
|
|
GST_JPEG_MARKER_SOI = 0xD8,
|
|
GST_JPEG_MARKER_EOI = 0xD9,
|
|
GST_JPEG_MARKER_SOS = 0xDA,
|
|
GST_JPEG_MARKER_DQT = 0xDB,
|
|
GST_JPEG_MARKER_DNL = 0xDC,
|
|
GST_JPEG_MARKER_DRI = 0xDD,
|
|
GST_JPEG_MARKER_APP_MIN = 0xE0,
|
|
GST_JPEG_MARKER_APP_MAX = 0xEF,
|
|
GST_JPEG_MARKER_COM = 0xFE,
|
|
} GstJpegMarkerCode;
|
|
|
|
/**
|
|
* GstJpegProfile:
|
|
* @GST_JPEG_PROFILE_BASELINE: Baseline DCT
|
|
* @GST_JPEG_PROFILE_EXTENDED: Extended sequential DCT
|
|
* @GST_JPEG_PROFILE_PROGRESSIVE: Progressive DCT
|
|
* @GST_JPEG_PROFILE_LOSSLESS: Lossless (sequential)
|
|
* @GST_JPEG_PROFILE_ARITHMETIC: Flag for arithmetic coding
|
|
*
|
|
* JPEG encoding processes.
|
|
*/
|
|
typedef enum {
|
|
GST_JPEG_PROFILE_BASELINE = 0x00,
|
|
GST_JPEG_PROFILE_EXTENDED = 0x01,
|
|
GST_JPEG_PROFILE_PROGRESSIVE = 0x02,
|
|
GST_JPEG_PROFILE_LOSSLESS = 0x03,
|
|
GST_JPEG_PROFILE_ARITHMETIC = 0x80
|
|
} GstJpegProfile;
|
|
|
|
/**
|
|
* GstJpegQuantTable:
|
|
* @quant_precision: Quantization table element precision (Pq)
|
|
* @quant_table: Quantization table elements (Qk)
|
|
* @valid: If the quantization table is valid, which means it has
|
|
* already been parsed
|
|
*
|
|
* Quantization table.
|
|
*/
|
|
struct _GstJpegQuantTable
|
|
{
|
|
guint8 quant_precision;
|
|
guint16 quant_table[GST_JPEG_MAX_QUANT_ELEMENTS];
|
|
gboolean valid;
|
|
};
|
|
|
|
/**
|
|
* GstJpegQuantTables:
|
|
* @quant_tables: All quantization tables
|
|
*
|
|
* Helper data structure that holds all quantization tables used to
|
|
* decode an image.
|
|
*/
|
|
struct _GstJpegQuantTables
|
|
{
|
|
GstJpegQuantTable quant_tables[GST_JPEG_MAX_SCAN_COMPONENTS];
|
|
};
|
|
|
|
/**
|
|
* GstJpegHuffmanTable:
|
|
* @huf_bits: Number of Huffman codes of length i + 1 (Li)
|
|
* @huf_vales: Value associated with each Huffman code (Vij)
|
|
* @valid: If the Huffman table is valid, which means it has already
|
|
* been parsed
|
|
*
|
|
* Huffman table.
|
|
*/
|
|
struct _GstJpegHuffmanTable
|
|
{
|
|
guint8 huf_bits[16];
|
|
guint8 huf_values[256];
|
|
gboolean valid;
|
|
};
|
|
|
|
/**
|
|
* GstJpegHuffmanTables:
|
|
* @dc_tables: DC Huffman tables
|
|
* @ac_tables: AC Huffman tables
|
|
*
|
|
* Helper data structure that holds all AC/DC Huffman tables used to
|
|
* decode an image.
|
|
*/
|
|
struct _GstJpegHuffmanTables
|
|
{
|
|
GstJpegHuffmanTable dc_tables[GST_JPEG_MAX_SCAN_COMPONENTS];
|
|
GstJpegHuffmanTable ac_tables[GST_JPEG_MAX_SCAN_COMPONENTS];
|
|
};
|
|
|
|
/**
|
|
* GstJpegScanComponent:
|
|
* @component_selector: Scan component selector (Csj)
|
|
* @dc_selector: DC entropy coding table destination selector (Tdj)
|
|
* @ac_selector: AC entropy coding table destination selector (Taj)
|
|
|
|
* Component-specification parameters.
|
|
*/
|
|
struct _GstJpegScanComponent
|
|
{
|
|
guint8 component_selector; /* 0 .. 255 */
|
|
guint8 dc_selector; /* 0 .. 3 */
|
|
guint8 ac_selector; /* 0 .. 3 */
|
|
};
|
|
|
|
/**
|
|
* GstJpegScanHdr:
|
|
* @num_components: Number of image components in scan (Ns)
|
|
* @components: Image components
|
|
*
|
|
* Scan header.
|
|
*/
|
|
struct _GstJpegScanHdr
|
|
{
|
|
guint8 num_components; /* 1 .. 4 */
|
|
GstJpegScanComponent components[GST_JPEG_MAX_SCAN_COMPONENTS];
|
|
};
|
|
|
|
/**
|
|
* GstJpegFrameComponent:
|
|
* @identifier: Component identifier (Ci)
|
|
* @horizontal_factor: Horizontal sampling factor (Hi)
|
|
* @vertical_factor: Vertical sampling factor (Vi)
|
|
* @quant_table_selector: Quantization table destination selector (Tqi)
|
|
*
|
|
* Component-specification parameters.
|
|
*/
|
|
struct _GstJpegFrameComponent
|
|
{
|
|
guint8 identifier; /* 0 .. 255 */
|
|
guint8 horizontal_factor; /* 1 .. 4 */
|
|
guint8 vertical_factor; /* 1 .. 4 */
|
|
guint8 quant_table_selector; /* 0 .. 3 */
|
|
};
|
|
|
|
/**
|
|
* GstJpegFrameHdr:
|
|
* @profile: JPEG encoding process (see #GstJpegProfile)
|
|
* @sample_precision: Sample precision (P)
|
|
* @height: Number of lines (Y)
|
|
* @width: Number of samples per line (X)
|
|
* @num_components: Number of image components in frame (Nf)
|
|
* @components: Image components
|
|
* @restart_interval: Number of MCU in the restart interval (Ri)
|
|
*
|
|
* Frame header.
|
|
*/
|
|
struct _GstJpegFrameHdr
|
|
{
|
|
guint8 profile;
|
|
guint8 sample_precision; /* 2 .. 16 */
|
|
guint16 width; /* 1 .. 65535 */
|
|
guint16 height; /* 0 .. 65535 */
|
|
guint8 num_components; /* 1 .. 255 */
|
|
GstJpegFrameComponent components[GST_JPEG_MAX_FRAME_COMPONENTS];
|
|
};
|
|
|
|
/**
|
|
* GstJpegTypeOffsetSize:
|
|
* @type: The type of the segment that starts at @offset
|
|
* @offset: The offset to the segment start in bytes
|
|
* @size: The size in bytes of the segment, or -1 if the end was not found
|
|
*
|
|
* A structure that contains the type of a segment, its offset and its size.
|
|
*/
|
|
struct _GstJpegTypeOffsetSize
|
|
{
|
|
guint8 type;
|
|
guint offset;
|
|
gint size;
|
|
};
|
|
|
|
/**
|
|
* GstJpegScanOffsetSize:
|
|
* @header: The header info associated to the scan
|
|
* @data_offset: The offset to the first entropy-coded segment in bytes
|
|
* @data_size: The size in bytes of the scan data, including all ECS
|
|
* and RST segments, or -1 if the end was not found
|
|
*
|
|
* A structure that contains information on a scan. A scan comprises of the
|
|
* scan @header, and all entropy-coded segment (ECS) and restart marker (RST)
|
|
* associated to it. The header type MUST be set to @GST_JPEG_MARKER_SOS.
|
|
*/
|
|
struct _GstJpegScanOffsetSize
|
|
{
|
|
GstJpegTypeOffsetSize header;
|
|
guint data_offset;
|
|
gint data_size;
|
|
};
|
|
|
|
|
|
/**
|
|
* gst_jpeg_parse:
|
|
* @data: The data to parse
|
|
* @size: The size of @data
|
|
* @offset: The offset from which to start parsing
|
|
*
|
|
* Parses the JPEG bitstream contained in @data, and returns the detected
|
|
* segments as a newly-allocated list of #GstJpegTypeOffsetSize elements.
|
|
* The caller is responsible for destroying the list when no longer needed.
|
|
*
|
|
* Returns: a #GList of #GstJpegTypeOffsetSize.
|
|
*/
|
|
GList *gst_jpeg_parse (const guint8 * data,
|
|
gsize size,
|
|
guint offset);
|
|
|
|
/**
|
|
* gst_jpeg_parse_frame_hdr:
|
|
* @hdr: (out): The #GstJpegFrameHdr structure to fill in
|
|
* @data: The data from which to parse the frame header
|
|
* @size: The size of @data
|
|
* @offset: The offset in bytes from which to start parsing @data
|
|
*
|
|
* Parses the @hdr JPEG frame header structure members from @data.
|
|
*
|
|
* Returns: a #GstJpegParserResult
|
|
*/
|
|
GstJpegParserResult gst_jpeg_parse_frame_hdr (GstJpegFrameHdr * hdr,
|
|
const guint8 * data,
|
|
gsize size,
|
|
guint offset);
|
|
|
|
/**
|
|
* gst_jpeg_parse_scan_hdr:
|
|
* @hdr: (out): The #GstJpegScanHdr structure to fill in
|
|
* @data: The data from which to parse the scan header
|
|
* @size: The size of @data
|
|
* @offset: The offset in bytes from which to start parsing @data
|
|
*
|
|
* Parses the @hdr JPEG scan header structure members from @data.
|
|
*
|
|
* Returns: a #GstJpegParserResult
|
|
*/
|
|
GstJpegParserResult gst_jpeg_parse_scan_hdr (GstJpegScanHdr * hdr,
|
|
const guint8 * data,
|
|
gsize size,
|
|
guint offset);
|
|
|
|
/**
|
|
* gst_jpeg_parse_quantization_table:
|
|
* @quant_tables: (out): The #GstJpegQuantizationTable structure to fill in
|
|
* @num_quant_tables: The number of allocated quantization tables in @quant_tables
|
|
* @data: The data from which to parse the quantization table
|
|
* @size: The size of @data
|
|
* @offset: The offset in bytes from which to start parsing @data
|
|
*
|
|
* Parses the JPEG quantization table structure members from @data.
|
|
*
|
|
* Note: @quant_tables represents the complete set of possible
|
|
* quantization tables. However, the parser will only write to the
|
|
* quantization table specified by the table destination identifier
|
|
* (Tq). While doing so, the @valid flag of the specified quantization
|
|
* table will also be set to %TRUE.
|
|
*
|
|
* Returns: a #GstJpegParserResult
|
|
*/
|
|
GstJpegParserResult gst_jpeg_parse_quant_table (GstJpegQuantTables *quant_tables,
|
|
const guint8 * data,
|
|
gsize size,
|
|
guint offset);
|
|
|
|
/**
|
|
* gst_jpeg_parse_huffman_table:
|
|
* @huf_tables: (out): The #GstJpegHuffmanTable structure to fill in
|
|
* @data: The data from which to parse the Huffman table
|
|
* @size: The size of @data
|
|
* @offset: The offset in bytes from which to start parsing @data
|
|
*
|
|
* Parses the JPEG Huffman table structure members from @data.
|
|
*
|
|
* Note: @huf_tables represents the complete set of possible Huffman
|
|
* tables. However, the parser will only write to the Huffman table
|
|
* specified by the table destination identifier (Th). While doing so,
|
|
* the @valid flag of the specified Huffman table will also be set to
|
|
* %TRUE;
|
|
*
|
|
* Returns: a #GstJpegParserResult
|
|
*/
|
|
GstJpegParserResult gst_jpeg_parse_huffman_table (GstJpegHuffmanTables *huf_tables,
|
|
const guint8 * data,
|
|
gsize size,
|
|
guint offset);
|
|
|
|
/**
|
|
* gst_jpeg_parse_restart_interval:
|
|
* @interval: (out): The parsed restart interval value
|
|
* @data: The data from which to parse the restart interval specification
|
|
* @size: The size of @data
|
|
* @offset: The offset in bytes from which to start parsing @data
|
|
*
|
|
* Returns: a #GstJpegParserResult
|
|
*/
|
|
GstJpegParserResult gst_jpeg_parse_restart_interval (guint * interval,
|
|
const guint8 * data,
|
|
gsize size,
|
|
guint offset);
|
|
|
|
/**
|
|
* gst_jpeg_get_default_huffman_tables:
|
|
* @huf_tables: (out): The default DC/AC Huffman tables to fill in
|
|
*
|
|
* Fills in @huf_tables with the default AC/DC Huffman tables, as
|
|
* specified by the JPEG standard.
|
|
*/
|
|
void gst_jpeg_get_default_huffman_tables (
|
|
GstJpegHuffmanTables *huf_tables);
|
|
|
|
/**
|
|
* gst_jpeg_get_default_quantization_table:
|
|
* @quant_tables: (out): The default luma/chroma quant-tables in zigzag mode
|
|
*
|
|
* Fills in @quant_tables with the default quantization tables, as
|
|
* specified by the JPEG standard.
|
|
*/
|
|
void gst_jpeg_get_default_quantization_tables (GstJpegQuantTables *quant_tables);
|
|
|
|
G_END_DECLS
|
|
|
|
#endif /* GST_JPEG_PARSER_H */
|