2024-02-22 10:27:40 +00:00
|
|
|
/*================================================================================================*\
|
|
|
|
|
|| ||
|
|
|
|
|
|| /$$$$$$$ /$$ /$$ /$$ /$$ ||
|
|
|
|
|
|| | $$__ $$|__/ | $$ /$ | $$| $$ ||
|
|
|
|
|
|| | $$ \ $$ /$$ /$$$$$$ | $$ /$$$| $$| $$$$$$$ /$$$$$$ /$$$$$$ /$$$$$$ ||
|
|
|
|
|
|| | $$$$$$$ | $$ /$$__ $$ | $$/$$ $$ $$| $$__ $$ /$$__ $$ /$$__ $$ /$$__ $$ ||
|
|
|
|
|
|| | $$__ $$| $$| $$ \ $$ | $$$$_ $$$$| $$ \ $$| $$ \ $$| $$ \ $$| $$ \ $$ ||
|
|
|
|
|
|| | $$ \ $$| $$| $$ | $$ | $$$/ \ $$$| $$ | $$| $$ | $$| $$ | $$| $$ | $$ ||
|
|
|
|
|
|| | $$$$$$$/| $$| $$$$$$$ | $$/ \ $$| $$ | $$| $$$$$$/| $$$$$$/| $$$$$$$/ ||
|
|
|
|
|
|| |_______/ |__/ \____ $$ |__/ \__/|__/ |__/ \______/ \______/ | $$____/ ||
|
|
|
|
|
|| /$$ \ $$ | $$ ||
|
|
|
|
|
|| | $$$$$$/ | $$ ||
|
|
|
|
|
|| \______/ |__/ ||
|
|
|
|
|
|| ||
|
|
|
|
|
|| DESCRIPTION: ||
|
|
|
|
|
|| ------------ ||
|
|
|
|
|
|| ||
|
|
|
|
|
|| This file describes a set of function that can be used to create and manipulate ||
|
|
|
|
|
|| a BigWhoop Codestream. They facilitate the assembly and parsing of the main ||
|
|
|
|
|
|| header and tile bitsreams as well as read and write functions used to access ||
|
|
|
|
|
|| conforming bwc datasets. ||
|
|
|
|
|
|| ||
|
|
|
|
|
|| -------------------------------------------------------------------------------------------- ||
|
|
|
|
|
|| Copyright (c) 2023, High Performance Computing Center - University of Stuttgart ||
|
|
|
|
|
|| ||
|
|
|
|
|
|| Redistribution and use in source and binary forms, with or without modification, are ||
|
|
|
|
|
|| permitted provided that the following conditions are met: ||
|
|
|
|
|
|| ||
|
|
|
|
|
|| (1) Redistributions of source code must retain the above copyright notice, this list of ||
|
|
|
|
|
|| conditions and the following disclaimer. ||
|
|
|
|
|
|| ||
|
|
|
|
|
|| (2) 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. ||
|
|
|
|
|
|| ||
|
|
|
|
|
\*================================================================================================*/
|
2023-06-20 11:43:33 +00:00
|
|
|
#ifndef CODESTREAM_H
|
|
|
|
|
#define CODESTREAM_H
|
|
|
|
|
|
2024-02-22 10:27:40 +00:00
|
|
|
/************************************************************************************************\
|
|
|
|
|
|| _ _ _ ____ _ _ _ ___ ____ ||
|
|
|
|
|
|| | |\ | | | | | | \ |___ ||
|
|
|
|
|
|| | | \| |___ |___ |__| |__/ |___ ||
|
|
|
|
|
|| ||
|
|
|
|
|
\************************************************************************************************/
|
|
|
|
|
#include "types.h"
|
2024-02-22 15:25:52 +00:00
|
|
|
#include "bitstream.h"
|
2023-06-20 11:43:33 +00:00
|
|
|
|
2024-02-22 10:27:40 +00:00
|
|
|
/************************************************************************************************\
|
|
|
|
|
|| _ _ ____ ____ ____ ____ ____ ||
|
|
|
|
|
|| |\/| |__| | |__/ | | [__ ||
|
|
|
|
|
|| | | | | |___ | \ |__| ___] ||
|
|
|
|
|
|| ||
|
|
|
|
|
\************************************************************************************************/
|
|
|
|
|
/*----------------------------------------------------------------------------------------------*\
|
|
|
|
|
! !
|
|
|
|
|
! DESCRIPTION: !
|
|
|
|
|
! ------------ !
|
|
|
|
|
! !
|
|
|
|
|
! These macros define stream manipulation operations to rewind, forward, inquire !
|
2024-02-22 15:25:52 +00:00
|
|
|
! the availability and get access to the current memory position of a bitstrean. !
|
2024-02-22 10:27:40 +00:00
|
|
|
! !
|
|
|
|
|
\*----------------------------------------------------------------------------------------------*/
|
|
|
|
|
#define rewind_stream(stream, delta) \
|
|
|
|
|
{ \
|
|
|
|
|
stream->L -= delta; \
|
|
|
|
|
}
|
2023-06-20 11:43:33 +00:00
|
|
|
|
2024-02-22 10:27:40 +00:00
|
|
|
#define forward_stream(stream, delta) \
|
|
|
|
|
{ \
|
|
|
|
|
stream->L += delta; \
|
|
|
|
|
}
|
2023-06-20 11:43:33 +00:00
|
|
|
|
2024-02-22 10:27:40 +00:00
|
|
|
#define get_access(stream) (uchar*)stream->memory + stream->L
|
2023-06-20 11:43:33 +00:00
|
|
|
|
2024-02-22 10:27:40 +00:00
|
|
|
/************************************************************************************************\
|
|
|
|
|
|| ___ _ _ ___ _ _ ____ ____ _ _ _ _ ____ ___ _ ____ _ _ ____ ||
|
|
|
|
|
|| |__] | | |__] | | | |___ | | |\ | | | | | | |\ | [__ ||
|
|
|
|
|
|| | |__| |__] |___ | |___ | |__| | \| |___ | | |__| | \| ___] ||
|
|
|
|
|
|| ||
|
|
|
|
|
\************************************************************************************************/
|
2024-03-27 16:25:05 +00:00
|
|
|
uchar assemble_main_header (bwc_codec *const field);
|
2024-02-22 10:27:40 +00:00
|
|
|
//==========|==========================|======================|======|======|=====================
|
2024-03-27 16:25:05 +00:00
|
|
|
uchar codestream_write_aux (bwc_span *const header,
|
|
|
|
|
bwc_span *const aux);
|
2024-02-22 10:27:40 +00:00
|
|
|
//==========|==========================|======================|======|======|=====================
|
2024-03-27 16:25:05 +00:00
|
|
|
uchar codestream_write_com (bwc_span *const header,
|
|
|
|
|
bwc_span *const com);
|
2024-02-22 10:27:40 +00:00
|
|
|
//==========|==========================|======================|======|======|=====================
|
2024-07-02 15:58:41 +00:00
|
|
|
size_t assemble_codestream (bwc_codec *const codec,
|
2024-06-28 14:37:19 +00:00
|
|
|
bwc_stream *const stream);
|
2024-02-22 10:27:40 +00:00
|
|
|
//==========|==========================|======================|======|======|=====================
|
2024-06-28 14:37:19 +00:00
|
|
|
bwc_codec* parse_codestream (bwc_codec *const codec,
|
|
|
|
|
bwc_stream *const stream,
|
2024-02-22 10:27:40 +00:00
|
|
|
uint8 const layer);
|
2023-06-20 11:43:33 +00:00
|
|
|
#endif
|
