TOPIO/BigWhoop
TOPIO/BigWhoop
4
1
Fork 0
Code Issues 26 Pull requests 1 Projects 6 Releases Packages Wiki Activity
BigWhoop/include/library/private/codestream.h

110 lines
9.6 KiB
C
Raw Normal View History

Ported Header files to new coding standard.
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. ||
|| ||
\*================================================================================================*/
Initial commit
2023-06-20 11:43:33 +00:00
#ifndef CODESTREAM_H
#define CODESTREAM_H
Ported Header files to new coding standard.
2024-02-22 10:27:40 +00:00
/************************************************************************************************\
|| _ _ _ ____ _ _ _ ___ ____ ||
|| | |\ | | | | | | \ |___ ||
|| | | \| |___ |___ |__| |__/ |___ ||
|| ||
\************************************************************************************************/
#include "types.h"
Removed the streaming functions from the public header to clean up the API.
2024-02-22 15:25:52 +00:00
#include "bitstream.h"
Initial commit
2023-06-20 11:43:33 +00:00
Ported Header files to new coding standard.
2024-02-22 10:27:40 +00:00
/************************************************************************************************\
|| _ _ ____ ____ ____ ____ ____ ||
|| |\/| |__| | |__/ | | [__ ||
|| | | | | |___ | \ |__| ___] ||
|| ||
\************************************************************************************************/
/*----------------------------------------------------------------------------------------------*\
! !
! DESCRIPTION: !
! ------------ !
! !
! These macros define stream manipulation operations to rewind, forward, inquire !
Removed the streaming functions from the public header to clean up the API.
2024-02-22 15:25:52 +00:00
! the availability and get access to the current memory position of a bitstrean. !
Ported Header files to new coding standard.
2024-02-22 10:27:40 +00:00
! !
\*----------------------------------------------------------------------------------------------*/
#define rewind_stream(stream, delta) \
{ \
stream->L -= delta; \
}
Initial commit
2023-06-20 11:43:33 +00:00
Ported Header files to new coding standard.
2024-02-22 10:27:40 +00:00
#define forward_stream(stream, delta) \
{ \
stream->L += delta; \
}
Initial commit
2023-06-20 11:43:33 +00:00
Ported Header files to new coding standard.
2024-02-22 10:27:40 +00:00
#define get_access(stream) (uchar*)stream->memory + stream->L
Initial commit
2023-06-20 11:43:33 +00:00
Ported Header files to new coding standard.
2024-02-22 10:27:40 +00:00
/************************************************************************************************\
|| ___ _ _ ___ _ _ ____ ____ _ _ _ _ ____ ___ _ ____ _ _ ____ ||
|| |__] | | |__] | | | |___ | | |\ | | | | | | |\ | [__ ||
|| | |__| |__] |___ | |___ | |__| | \| |___ | | |__| | \| ___] ||
|| ||
\************************************************************************************************/
rename field->codec for bwc_codec variables
2024-10-09 09:49:22 +00:00
uchar assemble_main_header (bwc_codec *const codec);
Ported Header files to new coding standard.
2024-02-22 10:27:40 +00:00
//==========|==========================|======================|======|======|=====================
Reorganize bwc_field and bwc_data to split codec settings and data stream semantically into data structures `bwc_codec` and `bwc_stream`. Cleaning up by removal of redundant information like parameter linked list, file extension, and file pointer including associated functionality. Start constructing an API taking void pointers to the original data for compression.
2024-03-27 16:25:05 +00:00
uchar codestream_write_aux (bwc_span *const header,
bwc_span *const aux);
Ported Header files to new coding standard.
2024-02-22 10:27:40 +00:00
//==========|==========================|======================|======|======|=====================
Reorganize bwc_field and bwc_data to split codec settings and data stream semantically into data structures `bwc_codec` and `bwc_stream`. Cleaning up by removal of redundant information like parameter linked list, file extension, and file pointer including associated functionality. Start constructing an API taking void pointers to the original data for compression.
2024-03-27 16:25:05 +00:00
uchar codestream_write_com (bwc_span *const header,
bwc_span *const com);
Ported Header files to new coding standard.
2024-02-22 10:27:40 +00:00
//==========|==========================|======================|======|======|=====================
resolved terminate_stream into shrink_to_fit and transfer_to_span. transferal of stream to span not required in assemble_codestream anymore. assemble_codestream and bwc_compress return the size of the compressed data. user provided buffer is used.
2024-07-02 15:58:41 +00:00
size_t assemble_codestream (bwc_codec *const codec,
Symmetrize API for compression and decompression to follow - allocate codec - initialize stream (using input data/codestream and output buffer from user) - create (de-)compression - run (de-)compression
2024-06-28 14:37:19 +00:00
bwc_stream *const stream);
Ported Header files to new coding standard.
2024-02-22 10:27:40 +00:00
//==========|==========================|======================|======|======|=====================
open and close header with new header structure
2024-11-04 12:57:33 +00:00
bwc_codec* parse_main_header (bwc_codec *const codec,
bwc_stream *const data,
bitstream *const stream);
//==========|==========================|======================|======|======|=====================
Symmetrize API for compression and decompression to follow - allocate codec - initialize stream (using input data/codestream and output buffer from user) - create (de-)compression - run (de-)compression
2024-06-28 14:37:19 +00:00
bwc_codec* parse_codestream (bwc_codec *const codec,
bwc_stream *const stream,
Ported Header files to new coding standard.
2024-02-22 10:27:40 +00:00
uint8 const layer);
Initial commit
2023-06-20 11:43:33 +00:00
#endif
Reference in a new issue Copy permalink