|
@ -0,0 +1,249 @@ |
|
|
|
|
|
/***************************************************************************** |
|
|
|
|
|
* rtp2435.h: RFC Profile for JPEG |
|
|
|
|
|
***************************************************************************** |
|
|
|
|
|
* Copyright (C) 2019 Josh de Kock |
|
|
|
|
|
* |
|
|
|
|
|
* Authors: Josh de Kock <josh@itanimul.li> |
|
|
|
|
|
* |
|
|
|
|
|
* 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__ */ |
|
|
|
|
|
|