MythTV  master
format.h
Go to the documentation of this file.
1 /* format.h rh */
2 
3 #ifndef FORMAT_H
4 #define FORMAT_H
5 
6 #ifdef __GNUC__
7 #define MYTH_PACKED __attribute__((packed))
8 #else
9 #define MYTH_PACKED
10 #endif
11 
12 // Prevent clang-tidy modernize-avoid-c-arrays warnings in these
13 // kernel structures
14 extern "C" {
15 
17 {
18  char finfo[12]; // "NuppelVideo" + \0
19  char version[5]; // "0.05" + \0
20  int width;
21  int height;
22  int desiredwidth; // 0 .. as it is
23  int desiredheight; // 0 .. as it is
24  char pimode; // P .. progressive
25  // I .. interlaced (2 half pics) [NI]
26  double aspect; // physical aspect ratio
27  double fps;
28  int videoblocks; // count of video-blocks -1 .. unknown 0 .. no video
29  int audioblocks; // count of audio-blocks -1 .. unknown 0 .. no audio
30  int textsblocks; // count of text-blocks -1 .. unknown 0 .. no text
32 };
33 
35 {
36  char frametype; // A .. Audio, V .. Video, S .. Sync, T .. Text
37  // R .. Seekpoint: String RTjjjjjjjj (use full packet)
38  // D .. Addition Data for Compressors
39  // ct: R .. RTjpeg Tables, F .. FFMpeg extradata
40  // X .. eXtended data, Q .. SeekTable
41  // K .. KFA table
42 
43  char comptype; // V: 0 .. raw YUV420
44  // 1 .. RTJpeg
45  // 2 .. RTJpeg with lzo afterwards
46  // 3 .. raw YUV420 with lzo afterwards
47  // 4 .. avcodec (fourcc in the extendeddata)
48  // N .. black frame
49  // L .. simply copy last frame (if lost frames)
50  // A: 0 .. Uncompressed (44100/sec 16bit 2ch)
51  // 1 .. lzo compression [NI]
52  // 2 .. layer2 (packet) [NI]
53  // 3 .. layer3 (packet)
54  // F .. flac (lossless) [NI]
55  // S .. shorten (lossless) [NI]
56  // A .. AC3 (packet)
57  // N .. null frame loudless
58  // L .. simply copy last frame (may sound bad) NI
59  // S: B .. Audio and Video sync point [NI]
60  // A .. Audio Sync Information
61  // timecode == effective dsp-frequency*100
62  // when reaching this audio sync point
63  // because many cheap soundcards are unexact
64  // and have a range from 44000 to 44250
65  // instead of the expected exact 44100 S./sec
66  // V .. Next Video Sync
67  // timecode == next video framenumber
68  // S .. Audio,Video,Text Correlation [NI]
69  // M .. New Header - format changed (only aspect now)
70  // T: C .. Closed Caption (US)
71  // T .. Teletext Subtitles (Europe)
72  char keyframe; // 0 .. keyframe
73  // 1 .. nr of frame in gop => no keyframe
74 
75  char filters; // Every bit stands for one type of filter
76  // 1 .. Gauss 5 Pixel (8*m+2*l+2*r+2*a+2*b)/16 [NYI]
77  // 2 .. Gauss 5 Pixel (8*m+1*l+1*r+1*a+1*b)/12 [NYI]
78  // 4 .. Cartoon Filter [NI]
79  // 8 .. Reserverd Filter [NI]
80  // 16 .. Reserverd Filter [NI]
81  // 32 .. Reserverd Filter [NI]
82  // 64 .. Reserverd Filter [NI]
83  // 128 .. Reserverd Filter [NI]
84 
85  int timecode; // Timecodeinformation sec*1000 + msecs
86 
87  int packetlength; // V,A,T: length of following data in stream
88  // S: length of packet correl. information [NI]
89  // R: do not use here! (fixed 'RTjjjjjjjjjjjjjj')
91 
92 // The fourcc's here are for the most part taken from libavcodec.
93 // As to their correctness, I have no idea. The audio ones are surely wrong,
94 // but I suppose it doesn't really matter as long as I'm consistant.
95 
97 {
98  int version; // yes, this is repeated from the file header
99  int video_fourcc; // video encoding method used
100  int audio_fourcc; // audio encoding method used
101  // generic data
105  // codec specific
106  // mp3lame
109  // rtjpeg
113  // libavcodec
118  // seek table offset
119  long long seektable_offset;
120  // key frame adjust offset
122  // unused for later -- total size of 128 integers.
123  // new fields must be added at the end, above this comment.
124  int expansion[109];
125 } MYTH_PACKED;
126 
128 {
129  long long file_offset;
131 } MYTH_PACKED;
132 
134 {
135  int adjust;
137 } MYTH_PACKED;
138 
139 #define FRAMEHEADERSIZE sizeof(rtframeheader)
140 #define FILEHEADERSIZE sizeof(rtfileheader)
141 #define EXTENDEDSIZE sizeof(extendeddata)
142 
144 {
145  int sample;
146  int timecode;
149  unsigned char *buffer;
151  bool forcekey;
152 };
153 
155 {
156  int sample;
157  int timecode;
160  unsigned char *buffer;
161 };
162 
164 {
165  int timecode;
166  int pagenr;
169  unsigned char *buffer;
171 };
172 
174 {
175  unsigned char row;
176  unsigned char col;
177  unsigned char dbl;
178  unsigned char fg;
179  unsigned char bg;
180  unsigned char len;
181 };
182 
184 {
185  unsigned char row;
186  unsigned char rowcount;
187  unsigned char resumedirect;
188  unsigned char resumetext;
189  unsigned char clr; // clear the display
190  unsigned char len; //length of string to follow
191 };
192 
193 // resumedirect codes
194 #define CC_STYLE_POPUP 0x00
195 #define CC_STYLE_PAINT 0x01
196 #define CC_STYLE_ROLLUP 0x02
197 
198 // resumetext special codes
199 #define CC_LINE_CONT 0x02
200 #define CC_MODE_MASK 0xf0
201 #define CC_TXT_MASK 0x20
202 #define CC_CC1 0x00
203 #define CC_CC2 0x10
204 #define CC_TXT1 0x20
205 #define CC_TXT2 0x30
206 #define CC_CC3 0x40
207 #define CC_CC4 0x50
208 #define CC_TXT3 0x60
209 #define CC_TXT4 0x70
210 
211 // end of kernel structures.
212 };
213 
214 #endif
rtframeheader
Definition: format.h:35
extendeddata::version
int version
Definition: format.h:98
rtfileheader::fps
double fps
Definition: format.h:27
teletextsubtitle::row
unsigned char row
Definition: format.h:175
vidbuffertype::buffer
unsigned char * buffer
Definition: format.h:149
rtfileheader::height
int height
Definition: format.h:21
vidbuffertype::bufferlen
int bufferlen
Definition: format.h:150
vidbuffertype::freeToEncode
int freeToEncode
Definition: format.h:147
extendeddata::lavc_maxqdiff
int lavc_maxqdiff
Definition: format.h:117
seektable_entry::file_offset
long long file_offset
Definition: format.h:129
rtfileheader::width
int width
Definition: format.h:20
extendeddata::audio_channels
int audio_channels
Definition: format.h:104
kfatable_entry::keyframe_number
int keyframe_number
Definition: format.h:136
rtfileheader::textsblocks
int textsblocks
Definition: format.h:30
rtfileheader::desiredheight
int desiredheight
Definition: format.h:23
rtframeheader::timecode
int timecode
Definition: format.h:85
seektable_entry
Definition: format.h:128
txtbuffertype::freeToEncode
int freeToEncode
Definition: format.h:167
kfatable_entry
Definition: format.h:134
ccsubtitle::len
unsigned char len
Definition: format.h:190
ccsubtitle::clr
unsigned char clr
Definition: format.h:189
extendeddata::audio_fourcc
int audio_fourcc
Definition: format.h:100
rtfileheader::desiredwidth
int desiredwidth
Definition: format.h:22
extendeddata::rtjpeg_chroma_filter
int rtjpeg_chroma_filter
Definition: format.h:112
vidbuffertype::timecode
int timecode
Definition: format.h:146
audbuffertype
Definition: format.h:155
rtfileheader
Definition: format.h:17
ccsubtitle::resumetext
unsigned char resumetext
Definition: format.h:188
rtframeheader::keyframe
char keyframe
Definition: format.h:72
txtbuffertype::buffer
unsigned char * buffer
Definition: format.h:169
txtbuffertype::bufferlen
int bufferlen
Definition: format.h:170
txtbuffertype
Definition: format.h:164
MYTH_PACKED
#define MYTH_PACKED
Definition: format.h:9
rtfileheader::videoblocks
int videoblocks
Definition: format.h:28
extendeddata::audio_compression_ratio
int audio_compression_ratio
Definition: format.h:107
extendeddata::expansion
int expansion[109]
Definition: format.h:124
teletextsubtitle
Definition: format.h:174
rtframeheader::comptype
char comptype
Definition: format.h:43
audbuffertype::timecode
int timecode
Definition: format.h:157
rtfileheader::pimode
char pimode
Definition: format.h:24
rtfileheader::finfo
char finfo[12]
Definition: format.h:18
extendeddata::video_fourcc
int video_fourcc
Definition: format.h:99
rtfileheader::audioblocks
int audioblocks
Definition: format.h:29
extendeddata::audio_bits_per_sample
int audio_bits_per_sample
Definition: format.h:103
extendeddata::lavc_bitrate
int lavc_bitrate
Definition: format.h:114
vidbuffertype::freeToBuffer
int freeToBuffer
Definition: format.h:148
teletextsubtitle::dbl
unsigned char dbl
Definition: format.h:177
extendeddata::lavc_qmin
int lavc_qmin
Definition: format.h:115
vidbuffertype::sample
int sample
Definition: format.h:145
extendeddata::keyframeadjust_offset
long long keyframeadjust_offset
Definition: format.h:121
teletextsubtitle::len
unsigned char len
Definition: format.h:180
rtframeheader::filters
char filters
Definition: format.h:75
txtbuffertype::timecode
int timecode
Definition: format.h:165
vidbuffertype::forcekey
bool forcekey
Definition: format.h:151
audbuffertype::sample
int sample
Definition: format.h:156
audbuffertype::freeToBuffer
int freeToBuffer
Definition: format.h:159
txtbuffertype::pagenr
int pagenr
Definition: format.h:166
ccsubtitle::rowcount
unsigned char rowcount
Definition: format.h:186
extendeddata::audio_sample_rate
int audio_sample_rate
Definition: format.h:102
rtframeheader::packetlength
int packetlength
Definition: format.h:87
teletextsubtitle::col
unsigned char col
Definition: format.h:176
rtfileheader::aspect
double aspect
Definition: format.h:26
extendeddata
Definition: format.h:97
extendeddata::rtjpeg_quality
int rtjpeg_quality
Definition: format.h:110
extendeddata::audio_quality
int audio_quality
Definition: format.h:108
ccsubtitle::row
unsigned char row
Definition: format.h:185
extendeddata::rtjpeg_luma_filter
int rtjpeg_luma_filter
Definition: format.h:111
rtfileheader::version
char version[5]
Definition: format.h:19
audbuffertype::buffer
unsigned char * buffer
Definition: format.h:160
seektable_entry::keyframe_number
int keyframe_number
Definition: format.h:130
extendeddata::lavc_qmax
int lavc_qmax
Definition: format.h:116
ccsubtitle
Definition: format.h:184
vidbuffertype
Definition: format.h:144
teletextsubtitle::bg
unsigned char bg
Definition: format.h:179
kfatable_entry::adjust
int adjust
Definition: format.h:135
audbuffertype::freeToEncode
int freeToEncode
Definition: format.h:158
rtframeheader::frametype
char frametype
Definition: format.h:36
rtfileheader::keyframedist
int keyframedist
Definition: format.h:31
txtbuffertype::freeToBuffer
int freeToBuffer
Definition: format.h:168
extendeddata::seektable_offset
long long seektable_offset
Definition: format.h:119
ccsubtitle::resumedirect
unsigned char resumedirect
Definition: format.h:187
teletextsubtitle::fg
unsigned char fg
Definition: format.h:178