diff --git a/ietf/rtp2435.h b/ietf/rtp2435.h new file mode 100644 index 0000000..11b5d8b --- /dev/null +++ b/ietf/rtp2435.h @@ -0,0 +1,249 @@ +/***************************************************************************** + * rtp2435.h: RFC Profile for JPEG + ***************************************************************************** + * Copyright (C) 2019 Josh de Kock + * + * Authors: Josh de Kock + * + * Permission is hereby granted, free of charge, to any person obtaining + * a copy of this software and associated documentation files (the + * "Software"), to deal in the Software without restriction, including + * without limitation the rights to use, copy, modify, merge, publish, + * distribute, sublicense, and/or sell copies of the Software, and to + * permit persons to whom the Software is furnished to do so, subject + * to the following conditions: + * + * The above copyright notice and this permission notice shall be + * included in all copies or substantial portions of the Software. + * + * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, + * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF + * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. + * IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY + * CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, + * TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE + * SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. + *****************************************************************************/ + +/* + * RTP Payload Format for JPEG + */ +#ifndef __BITSTREAM_IETF_RTP2435_H__ +#define __BITSTREAM_IETF_RTP2435_H__ + +#ifdef __cplusplus +extern "C" +{ +#endif + +#define RTP_2435_HEADER_SIZE 8 +#define RTP_2435_RESTART_HEADER_SIZE 4 +#define RTP_2435_QUANTIZATION_HEADER_SIZE 4 + +/* + * Reminder : JPEG header which immediately follows the RTP header + 0 1 2 3 + 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | Type-specific | Fragment Offset | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | Type | Q | Width | Height | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + */ + +static inline void rtp2435_set_ts(uint8_t *header, uint8_t ts) +{ + header[0] = ts; +} + +static inline uint8_t rtp2435_get_ts(uint8_t *header) +{ + return header[0]; +} + +static inline void rtp2435_set_offset(uint8_t *header, uint32_t offset) +{ + header[1] = (offset & 0xFF0000) >> 16; + header[2] = (offset & 0xFF00) >> 8; + header[3] = offset & 0xFF; +} + +static inline uint32_t rtp2435_get_offset(uint8_t *header) +{ + return header[1] << 16 | header[2] << 8 | header[3]; +} + +static inline void rtp2435_set_type(uint8_t *header, uint8_t type) +{ + header[4] = type; +} + +static inline uint8_t rtp2435_get_type(uint8_t *header) +{ + return header[4]; +} + +static inline void rtp2435_set_q(uint8_t *header, uint8_t q) +{ + header[5] = q; +} + +static inline uint8_t rtp2435_get_q(uint8_t *header) +{ + return header[5]; +} + +static inline void rtp2435_set_width(uint8_t *header, uint8_t width) +{ + header[6] = width; +} + +static inline uint8_t rtp2435_get_width(uint8_t *header) +{ + return header[6]; +} + +static inline void rtp2435_set_height(uint8_t *header, uint8_t height) +{ + header[7] = height; +} + +static inline uint8_t rtp2435_get_height(uint8_t *header) +{ + return header[7]; +} + +static inline uint8_t *rtp2435_restart(uint8_t *header) +{ + uint8_t t = rtp2435_get_type(header); + if (64 <= t && t <= 127) + return header + RTP_2435_HEADER_SIZE; + else + return NULL; +} + +static inline uint8_t *rtp2435_quantization_table(uint8_t *header) +{ + uint8_t q = rtp2435_get_q(header); + if (128 <= q && q <= 255) { + uint8_t *p; + if ((p = rtp2435_restart(header))) + return p + RTP_2435_RESTART_HEADER_SIZE; + else + return header + RTP_2435_HEADER_SIZE; + } + + return NULL; +} + +/* + * Reminder : Restart Marker header + 0 1 2 3 + 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | Restart Interval |F|L| Restart Count | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + */ + +static inline void rtp2435r_set_first(uint8_t *header) +{ + header[2] |= 0x1; +} + +static inline void rtp2435r_clear_first(uint8_t *header) +{ + header[2] &= ~0x1; +} + +static inline bool rtp2435r_check_first(uint8_t *header) +{ + return !!(header[2] & 0x1); +} + +static inline void rtp2435r_set_last(uint8_t *header) +{ + header[2] |= 0x2; +} + +static inline void rtp2435r_clear_last(uint8_t *header) +{ + header[2] &= ~0x2; +} + +static inline bool rtp2435r_check_last(uint8_t *header) +{ + return !!(header[2] & 0x2); +} + +static inline uint16_t rtp2435r_get_count(uint8_t *header) +{ + return (header[2] << 8 | header[3]) >> 2; +} + +static inline void rtp2435r_set_count(uint8_t *header, uint16_t count) +{ + count = count << 2; + header[2] |= count >> 8; + header[3] = count & 0xFF; +} + +static inline uint16_t rtp2435r_get_interval(uint8_t *header) +{ + return header[0] << 8 | header[1]; +} + +static inline void rtp2435r_set_interval(uint8_t *header, uint16_t interval) +{ + header[0] = (interval & 0xFF00) >> 8; + header[1] = interval & 0xFF; +} + +/* + * Reminder : Quantization Table header + 0 1 2 3 + 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | MBZ | Precision | Length | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + | Quantization Table Data | + | ... | + +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ + */ + +static inline void rtp2435q_set_mbz(uint8_t *header, uint8_t mbz) +{ + header[0] = mbz; +} + +static inline uint8_t rtp2435q_get_mbz(uint8_t *header) +{ + return header[0]; +} + +static inline void rtp2435q_set_precision(uint8_t *header, uint8_t precision) +{ + header[1] = precision; +} + +static inline uint8_t rtp2435q_get_precision(uint8_t *header) +{ + return header[1]; +} + +static inline uint16_t rtp2435q_get_length(uint8_t *header) +{ + return header[2] << 16 | header[3]; +} + +static inline void rtp2435q_set_length(uint8_t *header, uint16_t length) +{ + header[2] = (length & 0xFF00) >> 8; + header[3] = length & 0xFF; +} + +#ifdef __cplusplus +} +#endif + +#endif /* !__BITSTREAM_IETF_RTP2435_H__ */ +