]> git.nihav.org Git - nihav.git/blame - nihav-core/src/frame.rs
add interfaces for raw data stream handling
[nihav.git] / nihav-core / src / frame.rs
CommitLineData
7673d49a 1//! Packets and decoded frames functionality.
22cb00db 2use std::cmp::max;
a5ba48ac 3//use std::collections::HashMap;
83e603fa 4use std::fmt;
8057a7fd 5pub use std::sync::Arc;
4e8b4f31 6pub use crate::formats::*;
1a967e6b 7pub use crate::refs::*;
2c6462c8 8use std::str::FromStr;
94dbb551 9
7673d49a 10/// Audio stream information.
5869fd63 11#[allow(dead_code)]
66116504 12#[derive(Clone,Copy,PartialEq)]
5869fd63 13pub struct NAAudioInfo {
7673d49a 14 /// Sample rate.
df159213 15 pub sample_rate: u32,
7673d49a 16 /// Number of channels.
df159213 17 pub channels: u8,
7673d49a 18 /// Audio sample format.
df159213 19 pub format: NASoniton,
7673d49a 20 /// Length of one audio block in samples.
df159213 21 pub block_len: usize,
5869fd63
KS
22}
23
24impl NAAudioInfo {
7673d49a 25 /// Constructs a new `NAAudioInfo` instance.
5869fd63
KS
26 pub fn new(sr: u32, ch: u8, fmt: NASoniton, bl: usize) -> Self {
27 NAAudioInfo { sample_rate: sr, channels: ch, format: fmt, block_len: bl }
28 }
7673d49a 29 /// Returns audio sample rate.
66116504 30 pub fn get_sample_rate(&self) -> u32 { self.sample_rate }
7673d49a 31 /// Returns the number of channels.
66116504 32 pub fn get_channels(&self) -> u8 { self.channels }
7673d49a 33 /// Returns sample format.
66116504 34 pub fn get_format(&self) -> NASoniton { self.format }
7673d49a 35 /// Returns one audio block duration in samples.
66116504 36 pub fn get_block_len(&self) -> usize { self.block_len }
5869fd63
KS
37}
38
83e603fa
KS
39impl fmt::Display for NAAudioInfo {
40 fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
41 write!(f, "{} Hz, {} ch", self.sample_rate, self.channels)
42 }
43}
44
7673d49a 45/// Video stream information.
5869fd63 46#[allow(dead_code)]
66116504 47#[derive(Clone,Copy,PartialEq)]
5869fd63 48pub struct NAVideoInfo {
7673d49a 49 /// Picture width.
bf507799 50 pub width: usize,
7673d49a 51 /// Picture height.
bf507799 52 pub height: usize,
7673d49a 53 /// Picture is stored downside up.
bf507799 54 pub flipped: bool,
7673d49a 55 /// Picture pixel format.
bf507799 56 pub format: NAPixelFormaton,
30940e74
KS
57 /// Declared bits per sample.
58 pub bits: u8,
5869fd63
KS
59}
60
61impl NAVideoInfo {
7673d49a 62 /// Constructs a new `NAVideoInfo` instance.
66116504 63 pub fn new(w: usize, h: usize, flip: bool, fmt: NAPixelFormaton) -> Self {
30940e74
KS
64 let bits = fmt.get_total_depth();
65 NAVideoInfo { width: w, height: h, flipped: flip, format: fmt, bits }
5869fd63 66 }
7673d49a 67 /// Returns picture width.
66116504 68 pub fn get_width(&self) -> usize { self.width as usize }
7673d49a 69 /// Returns picture height.
66116504 70 pub fn get_height(&self) -> usize { self.height as usize }
7673d49a 71 /// Returns picture orientation.
66116504 72 pub fn is_flipped(&self) -> bool { self.flipped }
7673d49a 73 /// Returns picture pixel format.
66116504 74 pub fn get_format(&self) -> NAPixelFormaton { self.format }
7673d49a 75 /// Sets new picture width.
dd1b60e1 76 pub fn set_width(&mut self, w: usize) { self.width = w; }
7673d49a 77 /// Sets new picture height.
dd1b60e1 78 pub fn set_height(&mut self, h: usize) { self.height = h; }
5869fd63
KS
79}
80
83e603fa
KS
81impl fmt::Display for NAVideoInfo {
82 fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
83 write!(f, "{}x{}", self.width, self.height)
84 }
85}
86
7673d49a 87/// A list of possible stream information types.
66116504 88#[derive(Clone,Copy,PartialEq)]
5869fd63 89pub enum NACodecTypeInfo {
7673d49a 90 /// No codec present.
5869fd63 91 None,
7673d49a 92 /// Audio codec information.
5869fd63 93 Audio(NAAudioInfo),
7673d49a 94 /// Video codec information.
5869fd63
KS
95 Video(NAVideoInfo),
96}
97
22cb00db 98impl NACodecTypeInfo {
7673d49a 99 /// Returns video stream information.
22cb00db
KS
100 pub fn get_video_info(&self) -> Option<NAVideoInfo> {
101 match *self {
102 NACodecTypeInfo::Video(vinfo) => Some(vinfo),
103 _ => None,
104 }
105 }
7673d49a 106 /// Returns audio stream information.
22cb00db
KS
107 pub fn get_audio_info(&self) -> Option<NAAudioInfo> {
108 match *self {
109 NACodecTypeInfo::Audio(ainfo) => Some(ainfo),
110 _ => None,
111 }
112 }
7673d49a 113 /// Reports whether the current stream is video stream.
5076115b
KS
114 pub fn is_video(&self) -> bool {
115 match *self {
116 NACodecTypeInfo::Video(_) => true,
117 _ => false,
118 }
119 }
7673d49a 120 /// Reports whether the current stream is audio stream.
5076115b
KS
121 pub fn is_audio(&self) -> bool {
122 match *self {
123 NACodecTypeInfo::Audio(_) => true,
124 _ => false,
125 }
126 }
22cb00db
KS
127}
128
83e603fa
KS
129impl fmt::Display for NACodecTypeInfo {
130 fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
131 let ret = match *self {
e243ceb4 132 NACodecTypeInfo::None => "".to_string(),
83e603fa
KS
133 NACodecTypeInfo::Audio(fmt) => format!("{}", fmt),
134 NACodecTypeInfo::Video(fmt) => format!("{}", fmt),
135 };
136 write!(f, "{}", ret)
137 }
138}
139
7673d49a
KS
140/// Decoded video frame.
141///
142/// NihAV frames are stored in native type (8/16/32-bit elements) inside a single buffer.
143/// In case of image with several components those components are stored sequentially and can be accessed in the buffer starting at corresponding component offset.
22cb00db
KS
144#[derive(Clone)]
145pub struct NAVideoBuffer<T> {
6c8e5c40 146 info: NAVideoInfo,
1a967e6b 147 data: NABufferRef<Vec<T>>,
6c8e5c40
KS
148 offs: Vec<usize>,
149 strides: Vec<usize>,
22cb00db
KS
150}
151
152impl<T: Clone> NAVideoBuffer<T> {
6d240c6b
KS
153 /// Constructs video buffer from the provided components.
154 pub fn from_raw_parts(info: NAVideoInfo, data: NABufferRef<Vec<T>>, offs: Vec<usize>, strides: Vec<usize>) -> Self {
155 Self { info, data, offs, strides }
156 }
7673d49a 157 /// Returns the component offset (0 for all unavailable offsets).
22cb00db
KS
158 pub fn get_offset(&self, idx: usize) -> usize {
159 if idx >= self.offs.len() { 0 }
160 else { self.offs[idx] }
161 }
7673d49a 162 /// Returns picture info.
22cb00db 163 pub fn get_info(&self) -> NAVideoInfo { self.info }
7673d49a 164 /// Returns an immutable reference to the data.
1a967e6b 165 pub fn get_data(&self) -> &Vec<T> { self.data.as_ref() }
7673d49a 166 /// Returns a mutable reference to the data.
1a967e6b 167 pub fn get_data_mut(&mut self) -> Option<&mut Vec<T>> { self.data.as_mut() }
7673d49a 168 /// Returns the number of components in picture format.
b914ee01 169 pub fn get_num_components(&self) -> usize { self.offs.len() }
7673d49a 170 /// Creates a copy of current `NAVideoBuffer`.
22cb00db 171 pub fn copy_buffer(&mut self) -> Self {
1a967e6b
KS
172 let mut data: Vec<T> = Vec::with_capacity(self.data.len());
173 data.clone_from(self.data.as_ref());
22cb00db
KS
174 let mut offs: Vec<usize> = Vec::with_capacity(self.offs.len());
175 offs.clone_from(&self.offs);
6c8e5c40
KS
176 let mut strides: Vec<usize> = Vec::with_capacity(self.strides.len());
177 strides.clone_from(&self.strides);
e243ceb4 178 NAVideoBuffer { info: self.info, data: NABufferRef::new(data), offs, strides }
22cb00db 179 }
7673d49a 180 /// Returns stride (distance between subsequent lines) for the requested component.
22cb00db 181 pub fn get_stride(&self, idx: usize) -> usize {
6c8e5c40
KS
182 if idx >= self.strides.len() { return 0; }
183 self.strides[idx]
22cb00db 184 }
7673d49a 185 /// Returns requested component dimensions.
22cb00db
KS
186 pub fn get_dimensions(&self, idx: usize) -> (usize, usize) {
187 get_plane_size(&self.info, idx)
188 }
7673d49a 189 /// Converts current instance into buffer reference.
3fc28ece
KS
190 pub fn into_ref(self) -> NABufferRef<Self> {
191 NABufferRef::new(self)
192 }
fcc25d82
KS
193
194 fn print_contents(&self, datatype: &str) {
195 println!("{} video buffer size {}", datatype, self.data.len());
196 println!(" format {}", self.info);
197 print!(" offsets:");
198 for off in self.offs.iter() {
199 print!(" {}", *off);
200 }
201 println!();
202 print!(" strides:");
203 for stride in self.strides.iter() {
204 print!(" {}", *stride);
205 }
206 println!();
207 }
22cb00db
KS
208}
209
7673d49a 210/// A specialised type for reference-counted `NAVideoBuffer`.
3fc28ece
KS
211pub type NAVideoBufferRef<T> = NABufferRef<NAVideoBuffer<T>>;
212
7673d49a
KS
213/// Decoded audio frame.
214///
215/// NihAV frames are stored in native type (8/16/32-bit elements) inside a single buffer.
216/// In case of planar audio samples for each channel are stored sequentially and can be accessed in the buffer starting at corresponding channel offset.
22cb00db
KS
217#[derive(Clone)]
218pub struct NAAudioBuffer<T> {
219 info: NAAudioInfo,
1a967e6b 220 data: NABufferRef<Vec<T>>,
22cb00db 221 offs: Vec<usize>,
01e2d496 222 stride: usize,
98c6f2f0 223 step: usize,
22cb00db 224 chmap: NAChannelMap,
5076115b 225 len: usize,
22cb00db
KS
226}
227
228impl<T: Clone> NAAudioBuffer<T> {
7673d49a 229 /// Returns the start position of requested channel data.
22cb00db
KS
230 pub fn get_offset(&self, idx: usize) -> usize {
231 if idx >= self.offs.len() { 0 }
232 else { self.offs[idx] }
233 }
7673d49a 234 /// Returns the distance between the start of one channel and the next one.
01e2d496 235 pub fn get_stride(&self) -> usize { self.stride }
98c6f2f0
KS
236 /// Returns the distance between the samples in one channel.
237 pub fn get_step(&self) -> usize { self.step }
7673d49a 238 /// Returns audio format information.
22cb00db 239 pub fn get_info(&self) -> NAAudioInfo { self.info }
7673d49a 240 /// Returns channel map.
8ee4352b 241 pub fn get_chmap(&self) -> &NAChannelMap { &self.chmap }
7673d49a 242 /// Returns an immutable reference to the data.
1a967e6b 243 pub fn get_data(&self) -> &Vec<T> { self.data.as_ref() }
89f25cd7
KS
244 /// Returns reference to the data.
245 pub fn get_data_ref(&self) -> NABufferRef<Vec<T>> { self.data.clone() }
7673d49a 246 /// Returns a mutable reference to the data.
1a967e6b 247 pub fn get_data_mut(&mut self) -> Option<&mut Vec<T>> { self.data.as_mut() }
7673d49a 248 /// Clones current `NAAudioBuffer` into a new one.
22cb00db 249 pub fn copy_buffer(&mut self) -> Self {
1a967e6b
KS
250 let mut data: Vec<T> = Vec::with_capacity(self.data.len());
251 data.clone_from(self.data.as_ref());
22cb00db
KS
252 let mut offs: Vec<usize> = Vec::with_capacity(self.offs.len());
253 offs.clone_from(&self.offs);
98c6f2f0 254 NAAudioBuffer { info: self.info, data: NABufferRef::new(data), offs, chmap: self.get_chmap().clone(), len: self.len, stride: self.stride, step: self.step }
22cb00db 255 }
7673d49a 256 /// Return the length of frame in samples.
5076115b 257 pub fn get_length(&self) -> usize { self.len }
640b1eb0
KS
258 /// Truncates buffer length if possible.
259 ///
260 /// In case when new length is larger than old length nothing is done.
261 pub fn truncate(&mut self, new_len: usize) {
262 self.len = self.len.min(new_len);
263 }
fcc25d82
KS
264
265 fn print_contents(&self, datatype: &str) {
266 println!("Audio buffer with {} data, stride {}, step {}", datatype, self.stride, self.step);
267 println!(" format {}", self.info);
268 println!(" channel map {}", self.chmap);
269 print!(" offsets:");
270 for off in self.offs.iter() {
271 print!(" {}", *off);
272 }
273 println!();
274 }
22cb00db
KS
275}
276
87a1ebc3 277impl NAAudioBuffer<u8> {
7673d49a 278 /// Constructs a new `NAAudioBuffer` instance.
1a967e6b
KS
279 pub fn new_from_buf(info: NAAudioInfo, data: NABufferRef<Vec<u8>>, chmap: NAChannelMap) -> Self {
280 let len = data.len();
98c6f2f0 281 NAAudioBuffer { info, data, chmap, offs: Vec::new(), len, stride: 0, step: 0 }
87a1ebc3
KS
282 }
283}
284
7673d49a 285/// A list of possible decoded frame types.
22cb00db
KS
286#[derive(Clone)]
287pub enum NABufferType {
7673d49a 288 /// 8-bit video buffer.
3fc28ece 289 Video (NAVideoBufferRef<u8>),
7673d49a 290 /// 16-bit video buffer (i.e. every component or packed pixel fits into 16 bits).
3fc28ece 291 Video16 (NAVideoBufferRef<u16>),
7673d49a 292 /// 32-bit video buffer (i.e. every component or packed pixel fits into 32 bits).
3fc28ece 293 Video32 (NAVideoBufferRef<u32>),
7673d49a 294 /// Packed video buffer.
3fc28ece 295 VideoPacked(NAVideoBufferRef<u8>),
7673d49a 296 /// Audio buffer with 8-bit unsigned integer audio.
22cb00db 297 AudioU8 (NAAudioBuffer<u8>),
7673d49a 298 /// Audio buffer with 16-bit signed integer audio.
22cb00db 299 AudioI16 (NAAudioBuffer<i16>),
7673d49a 300 /// Audio buffer with 32-bit signed integer audio.
87a1ebc3 301 AudioI32 (NAAudioBuffer<i32>),
7673d49a 302 /// Audio buffer with 32-bit floating point audio.
22cb00db 303 AudioF32 (NAAudioBuffer<f32>),
7673d49a 304 /// Packed audio buffer.
22cb00db 305 AudioPacked(NAAudioBuffer<u8>),
7673d49a 306 /// Buffer with generic data (e.g. subtitles).
1a967e6b 307 Data (NABufferRef<Vec<u8>>),
7673d49a 308 /// No data present.
22cb00db
KS
309 None,
310}
311
312impl NABufferType {
7673d49a 313 /// Returns the offset to the requested component or channel.
22cb00db
KS
314 pub fn get_offset(&self, idx: usize) -> usize {
315 match *self {
316 NABufferType::Video(ref vb) => vb.get_offset(idx),
317 NABufferType::Video16(ref vb) => vb.get_offset(idx),
3bba1c4a 318 NABufferType::Video32(ref vb) => vb.get_offset(idx),
22cb00db
KS
319 NABufferType::VideoPacked(ref vb) => vb.get_offset(idx),
320 NABufferType::AudioU8(ref ab) => ab.get_offset(idx),
321 NABufferType::AudioI16(ref ab) => ab.get_offset(idx),
fdf4b070 322 NABufferType::AudioI32(ref ab) => ab.get_offset(idx),
22cb00db
KS
323 NABufferType::AudioF32(ref ab) => ab.get_offset(idx),
324 NABufferType::AudioPacked(ref ab) => ab.get_offset(idx),
325 _ => 0,
326 }
327 }
7673d49a 328 /// Returns information for video frames.
3bba1c4a
KS
329 pub fn get_video_info(&self) -> Option<NAVideoInfo> {
330 match *self {
331 NABufferType::Video(ref vb) => Some(vb.get_info()),
332 NABufferType::Video16(ref vb) => Some(vb.get_info()),
333 NABufferType::Video32(ref vb) => Some(vb.get_info()),
334 NABufferType::VideoPacked(ref vb) => Some(vb.get_info()),
335 _ => None,
336 }
337 }
7673d49a 338 /// Returns reference to 8-bit (or packed) video buffer.
3fc28ece 339 pub fn get_vbuf(&self) -> Option<NAVideoBufferRef<u8>> {
22cb00db
KS
340 match *self {
341 NABufferType::Video(ref vb) => Some(vb.clone()),
87a1ebc3
KS
342 NABufferType::VideoPacked(ref vb) => Some(vb.clone()),
343 _ => None,
344 }
345 }
7673d49a 346 /// Returns reference to 16-bit video buffer.
3fc28ece 347 pub fn get_vbuf16(&self) -> Option<NAVideoBufferRef<u16>> {
87a1ebc3
KS
348 match *self {
349 NABufferType::Video16(ref vb) => Some(vb.clone()),
350 _ => None,
351 }
352 }
7673d49a 353 /// Returns reference to 32-bit video buffer.
3fc28ece 354 pub fn get_vbuf32(&self) -> Option<NAVideoBufferRef<u32>> {
3bba1c4a
KS
355 match *self {
356 NABufferType::Video32(ref vb) => Some(vb.clone()),
357 _ => None,
358 }
359 }
7673d49a 360 /// Returns information for audio frames.
049474a0
KS
361 pub fn get_audio_info(&self) -> Option<NAAudioInfo> {
362 match *self {
363 NABufferType::AudioU8(ref ab) => Some(ab.get_info()),
364 NABufferType::AudioI16(ref ab) => Some(ab.get_info()),
365 NABufferType::AudioI32(ref ab) => Some(ab.get_info()),
366 NABufferType::AudioF32(ref ab) => Some(ab.get_info()),
367 NABufferType::AudioPacked(ref ab) => Some(ab.get_info()),
368 _ => None,
369 }
370 }
7673d49a 371 /// Returns audio channel map.
049474a0
KS
372 pub fn get_chmap(&self) -> Option<&NAChannelMap> {
373 match *self {
374 NABufferType::AudioU8(ref ab) => Some(ab.get_chmap()),
375 NABufferType::AudioI16(ref ab) => Some(ab.get_chmap()),
376 NABufferType::AudioI32(ref ab) => Some(ab.get_chmap()),
377 NABufferType::AudioF32(ref ab) => Some(ab.get_chmap()),
378 NABufferType::AudioPacked(ref ab) => Some(ab.get_chmap()),
379 _ => None,
380 }
381 }
7673d49a 382 /// Returns audio frame duration in samples.
049474a0
KS
383 pub fn get_audio_length(&self) -> usize {
384 match *self {
385 NABufferType::AudioU8(ref ab) => ab.get_length(),
386 NABufferType::AudioI16(ref ab) => ab.get_length(),
387 NABufferType::AudioI32(ref ab) => ab.get_length(),
388 NABufferType::AudioF32(ref ab) => ab.get_length(),
389 NABufferType::AudioPacked(ref ab) => ab.get_length(),
390 _ => 0,
391 }
392 }
a1298b7a
KS
393 /// Truncates audio frame duration if possible.
394 pub fn truncate_audio(&mut self, len: usize) {
395 match *self {
396 NABufferType::AudioU8(ref mut ab) => ab.truncate(len),
397 NABufferType::AudioI16(ref mut ab) => ab.truncate(len),
398 NABufferType::AudioI32(ref mut ab) => ab.truncate(len),
399 NABufferType::AudioF32(ref mut ab) => ab.truncate(len),
400 NABufferType::AudioPacked(ref mut ab) => ab.truncate(len),
401 _ => {},
402 };
403 }
7673d49a 404 /// Returns the distance between starts of two channels.
049474a0
KS
405 pub fn get_audio_stride(&self) -> usize {
406 match *self {
407 NABufferType::AudioU8(ref ab) => ab.get_stride(),
408 NABufferType::AudioI16(ref ab) => ab.get_stride(),
409 NABufferType::AudioI32(ref ab) => ab.get_stride(),
410 NABufferType::AudioF32(ref ab) => ab.get_stride(),
411 NABufferType::AudioPacked(ref ab) => ab.get_stride(),
412 _ => 0,
413 }
414 }
98c6f2f0
KS
415 /// Returns the distance between two samples in one channel.
416 pub fn get_audio_step(&self) -> usize {
417 match *self {
418 NABufferType::AudioU8(ref ab) => ab.get_step(),
419 NABufferType::AudioI16(ref ab) => ab.get_step(),
420 NABufferType::AudioI32(ref ab) => ab.get_step(),
421 NABufferType::AudioF32(ref ab) => ab.get_step(),
422 NABufferType::AudioPacked(ref ab) => ab.get_step(),
423 _ => 0,
424 }
425 }
7673d49a 426 /// Returns reference to 8-bit (or packed) audio buffer.
6e09a92e 427 pub fn get_abuf_u8(&self) -> Option<NAAudioBuffer<u8>> {
87a1ebc3
KS
428 match *self {
429 NABufferType::AudioU8(ref ab) => Some(ab.clone()),
430 NABufferType::AudioPacked(ref ab) => Some(ab.clone()),
431 _ => None,
432 }
433 }
7673d49a 434 /// Returns reference to 16-bit audio buffer.
6e09a92e 435 pub fn get_abuf_i16(&self) -> Option<NAAudioBuffer<i16>> {
87a1ebc3
KS
436 match *self {
437 NABufferType::AudioI16(ref ab) => Some(ab.clone()),
438 _ => None,
439 }
440 }
7673d49a 441 /// Returns reference to 32-bit integer audio buffer.
6e09a92e 442 pub fn get_abuf_i32(&self) -> Option<NAAudioBuffer<i32>> {
87a1ebc3
KS
443 match *self {
444 NABufferType::AudioI32(ref ab) => Some(ab.clone()),
445 _ => None,
446 }
447 }
7673d49a 448 /// Returns reference to 32-bit floating point audio buffer.
6e09a92e 449 pub fn get_abuf_f32(&self) -> Option<NAAudioBuffer<f32>> {
87a1ebc3
KS
450 match *self {
451 NABufferType::AudioF32(ref ab) => Some(ab.clone()),
22cb00db
KS
452 _ => None,
453 }
454 }
fcc25d82
KS
455 /// Prints internal buffer layout.
456 pub fn print_buffer_metadata(&self) {
457 match *self {
458 NABufferType::Video(ref buf) => buf.print_contents("8-bit"),
459 NABufferType::Video16(ref buf) => buf.print_contents("16-bit"),
460 NABufferType::Video32(ref buf) => buf.print_contents("32-bit"),
461 NABufferType::VideoPacked(ref buf) => buf.print_contents("packed"),
462 NABufferType::AudioU8(ref buf) => buf.print_contents("8-bit unsigned integer"),
463 NABufferType::AudioI16(ref buf) => buf.print_contents("16-bit integer"),
464 NABufferType::AudioI32(ref buf) => buf.print_contents("32-bit integer"),
465 NABufferType::AudioF32(ref buf) => buf.print_contents("32-bit float"),
466 NABufferType::AudioPacked(ref buf) => buf.print_contents("packed"),
467 NABufferType::Data(ref buf) => { println!("Data buffer, len = {}", buf.len()); },
468 NABufferType::None => { println!("No buffer"); },
469 };
470 }
22cb00db
KS
471}
472
cd830591 473const NA_SIMPLE_VFRAME_COMPONENTS: usize = 4;
7673d49a 474/// Simplified decoded frame data.
cd830591 475pub struct NASimpleVideoFrame<'a, T: Copy> {
7673d49a 476 /// Widths of each picture component.
cd830591 477 pub width: [usize; NA_SIMPLE_VFRAME_COMPONENTS],
7673d49a 478 /// Heights of each picture component.
cd830591 479 pub height: [usize; NA_SIMPLE_VFRAME_COMPONENTS],
7673d49a 480 /// Orientation (upside-down or downside-up) flag.
cd830591 481 pub flip: bool,
7673d49a 482 /// Strides for each component.
cd830591 483 pub stride: [usize; NA_SIMPLE_VFRAME_COMPONENTS],
7673d49a 484 /// Start of each component.
cd830591 485 pub offset: [usize; NA_SIMPLE_VFRAME_COMPONENTS],
7673d49a 486 /// Number of components.
cd830591 487 pub components: usize,
7673d49a 488 /// Pointer to the picture pixel data.
dc45d8ce 489 pub data: &'a mut [T],
cd830591
KS
490}
491
492impl<'a, T:Copy> NASimpleVideoFrame<'a, T> {
7673d49a 493 /// Constructs a new instance of `NASimpleVideoFrame` from `NAVideoBuffer`.
cd830591
KS
494 pub fn from_video_buf(vbuf: &'a mut NAVideoBuffer<T>) -> Option<Self> {
495 let vinfo = vbuf.get_info();
496 let components = vinfo.format.components as usize;
497 if components > NA_SIMPLE_VFRAME_COMPONENTS {
498 return None;
499 }
500 let mut w: [usize; NA_SIMPLE_VFRAME_COMPONENTS] = [0; NA_SIMPLE_VFRAME_COMPONENTS];
501 let mut h: [usize; NA_SIMPLE_VFRAME_COMPONENTS] = [0; NA_SIMPLE_VFRAME_COMPONENTS];
502 let mut s: [usize; NA_SIMPLE_VFRAME_COMPONENTS] = [0; NA_SIMPLE_VFRAME_COMPONENTS];
503 let mut o: [usize; NA_SIMPLE_VFRAME_COMPONENTS] = [0; NA_SIMPLE_VFRAME_COMPONENTS];
504 for comp in 0..components {
505 let (width, height) = vbuf.get_dimensions(comp);
506 w[comp] = width;
507 h[comp] = height;
508 s[comp] = vbuf.get_stride(comp);
509 o[comp] = vbuf.get_offset(comp);
510 }
511 let flip = vinfo.flipped;
512 Some(NASimpleVideoFrame {
513 width: w,
514 height: h,
515 flip,
516 stride: s,
517 offset: o,
518 components,
dc45d8ce 519 data: vbuf.data.as_mut_slice(),
cd830591
KS
520 })
521 }
522}
523
7673d49a 524/// A list of possible frame allocator errors.
22cb00db
KS
525#[derive(Debug,Clone,Copy,PartialEq)]
526pub enum AllocatorError {
7673d49a 527 /// Requested picture dimensions are too large.
22cb00db 528 TooLargeDimensions,
7673d49a 529 /// Invalid input format.
22cb00db
KS
530 FormatError,
531}
532
7673d49a
KS
533/// Constructs a new video buffer with requested format.
534///
535/// `align` is power of two alignment for image. E.g. the value of 5 means that frame dimensions will be padded to be multiple of 32.
22cb00db
KS
536pub fn alloc_video_buffer(vinfo: NAVideoInfo, align: u8) -> Result<NABufferType, AllocatorError> {
537 let fmt = &vinfo.format;
538 let mut new_size: usize = 0;
6c8e5c40
KS
539 let mut offs: Vec<usize> = Vec::new();
540 let mut strides: Vec<usize> = Vec::new();
22cb00db
KS
541
542 for i in 0..fmt.get_num_comp() {
543 if fmt.get_chromaton(i) == None { return Err(AllocatorError::FormatError); }
544 }
545
546 let align_mod = ((1 << align) as usize) - 1;
547 let width = ((vinfo.width as usize) + align_mod) & !align_mod;
548 let height = ((vinfo.height as usize) + align_mod) & !align_mod;
549 let mut max_depth = 0;
550 let mut all_packed = true;
3bba1c4a 551 let mut all_bytealigned = true;
22cb00db 552 for i in 0..fmt.get_num_comp() {
6c8e5c40 553 let ochr = fmt.get_chromaton(i);
e243ceb4 554 if ochr.is_none() { continue; }
6c8e5c40 555 let chr = ochr.unwrap();
22cb00db
KS
556 if !chr.is_packed() {
557 all_packed = false;
3bba1c4a
KS
558 } else if ((chr.get_shift() + chr.get_depth()) & 7) != 0 {
559 all_bytealigned = false;
22cb00db
KS
560 }
561 max_depth = max(max_depth, chr.get_depth());
562 }
3bba1c4a
KS
563 let unfit_elem_size = match fmt.get_elem_size() {
564 2 | 4 => false,
565 _ => true,
566 };
22cb00db
KS
567
568//todo semi-packed like NV12
bc6aac3d
KS
569 if fmt.is_paletted() {
570//todo various-sized palettes?
6c8e5c40
KS
571 let stride = vinfo.get_format().get_chromaton(0).unwrap().get_linesize(width);
572 let pic_sz = stride.checked_mul(height);
bc6aac3d
KS
573 if pic_sz == None { return Err(AllocatorError::TooLargeDimensions); }
574 let pal_size = 256 * (fmt.get_elem_size() as usize);
575 let new_size = pic_sz.unwrap().checked_add(pal_size);
576 if new_size == None { return Err(AllocatorError::TooLargeDimensions); }
577 offs.push(0);
6c8e5c40
KS
578 offs.push(stride * height);
579 strides.push(stride);
e243ceb4
KS
580 let data: Vec<u8> = vec![0; new_size.unwrap()];
581 let buf: NAVideoBuffer<u8> = NAVideoBuffer { data: NABufferRef::new(data), info: vinfo, offs, strides };
3fc28ece 582 Ok(NABufferType::Video(buf.into_ref()))
bc6aac3d 583 } else if !all_packed {
22cb00db 584 for i in 0..fmt.get_num_comp() {
6c8e5c40 585 let ochr = fmt.get_chromaton(i);
e243ceb4 586 if ochr.is_none() { continue; }
6c8e5c40 587 let chr = ochr.unwrap();
74afc7de 588 offs.push(new_size as usize);
6c8e5c40 589 let stride = chr.get_linesize(width);
22cb00db 590 let cur_h = chr.get_height(height);
6c8e5c40 591 let cur_sz = stride.checked_mul(cur_h);
22cb00db
KS
592 if cur_sz == None { return Err(AllocatorError::TooLargeDimensions); }
593 let new_sz = new_size.checked_add(cur_sz.unwrap());
594 if new_sz == None { return Err(AllocatorError::TooLargeDimensions); }
595 new_size = new_sz.unwrap();
6c8e5c40 596 strides.push(stride);
22cb00db
KS
597 }
598 if max_depth <= 8 {
e243ceb4
KS
599 let data: Vec<u8> = vec![0; new_size];
600 let buf: NAVideoBuffer<u8> = NAVideoBuffer { data: NABufferRef::new(data), info: vinfo, offs, strides };
3fc28ece 601 Ok(NABufferType::Video(buf.into_ref()))
3bba1c4a 602 } else if max_depth <= 16 {
e243ceb4
KS
603 let data: Vec<u16> = vec![0; new_size];
604 let buf: NAVideoBuffer<u16> = NAVideoBuffer { data: NABufferRef::new(data), info: vinfo, offs, strides };
3fc28ece 605 Ok(NABufferType::Video16(buf.into_ref()))
3bba1c4a 606 } else {
e243ceb4
KS
607 let data: Vec<u32> = vec![0; new_size];
608 let buf: NAVideoBuffer<u32> = NAVideoBuffer { data: NABufferRef::new(data), info: vinfo, offs, strides };
3fc28ece 609 Ok(NABufferType::Video32(buf.into_ref()))
22cb00db 610 }
3bba1c4a 611 } else if all_bytealigned || unfit_elem_size {
22cb00db
KS
612 let elem_sz = fmt.get_elem_size();
613 let line_sz = width.checked_mul(elem_sz as usize);
614 if line_sz == None { return Err(AllocatorError::TooLargeDimensions); }
615 let new_sz = line_sz.unwrap().checked_mul(height);
616 if new_sz == None { return Err(AllocatorError::TooLargeDimensions); }
617 new_size = new_sz.unwrap();
e243ceb4 618 let data: Vec<u8> = vec![0; new_size];
6c8e5c40 619 strides.push(line_sz.unwrap());
e243ceb4 620 let buf: NAVideoBuffer<u8> = NAVideoBuffer { data: NABufferRef::new(data), info: vinfo, offs, strides };
3fc28ece 621 Ok(NABufferType::VideoPacked(buf.into_ref()))
3bba1c4a
KS
622 } else {
623 let elem_sz = fmt.get_elem_size();
624 let new_sz = width.checked_mul(height);
625 if new_sz == None { return Err(AllocatorError::TooLargeDimensions); }
626 new_size = new_sz.unwrap();
627 match elem_sz {
628 2 => {
e243ceb4 629 let data: Vec<u16> = vec![0; new_size];
3bba1c4a 630 strides.push(width);
e243ceb4 631 let buf: NAVideoBuffer<u16> = NAVideoBuffer { data: NABufferRef::new(data), info: vinfo, offs, strides };
3fc28ece 632 Ok(NABufferType::Video16(buf.into_ref()))
3bba1c4a
KS
633 },
634 4 => {
e243ceb4 635 let data: Vec<u32> = vec![0; new_size];
3bba1c4a 636 strides.push(width);
e243ceb4 637 let buf: NAVideoBuffer<u32> = NAVideoBuffer { data: NABufferRef::new(data), info: vinfo, offs, strides };
3fc28ece 638 Ok(NABufferType::Video32(buf.into_ref()))
3bba1c4a
KS
639 },
640 _ => unreachable!(),
641 }
22cb00db
KS
642 }
643}
644
7673d49a 645/// Constructs a new audio buffer for the requested format and length.
e243ceb4 646#[allow(clippy::collapsible_if)]
22cb00db
KS
647pub fn alloc_audio_buffer(ainfo: NAAudioInfo, nsamples: usize, chmap: NAChannelMap) -> Result<NABufferType, AllocatorError> {
648 let mut offs: Vec<usize> = Vec::new();
98c6f2f0 649 if ainfo.format.is_planar() || ((ainfo.format.get_bits() % 8) == 0) {
22cb00db
KS
650 let len = nsamples.checked_mul(ainfo.channels as usize);
651 if len == None { return Err(AllocatorError::TooLargeDimensions); }
652 let length = len.unwrap();
98c6f2f0
KS
653 let stride;
654 let step;
655 if ainfo.format.is_planar() {
656 stride = nsamples;
657 step = 1;
658 for i in 0..ainfo.channels {
659 offs.push((i as usize) * stride);
660 }
661 } else {
662 stride = 1;
663 step = ainfo.channels as usize;
664 for i in 0..ainfo.channels {
665 offs.push(i as usize);
666 }
22cb00db
KS
667 }
668 if ainfo.format.is_float() {
669 if ainfo.format.get_bits() == 32 {
e243ceb4 670 let data: Vec<f32> = vec![0.0; length];
98c6f2f0 671 let buf: NAAudioBuffer<f32> = NAAudioBuffer { data: NABufferRef::new(data), info: ainfo, offs, chmap, len: nsamples, stride, step };
22cb00db
KS
672 Ok(NABufferType::AudioF32(buf))
673 } else {
674 Err(AllocatorError::TooLargeDimensions)
675 }
676 } else {
677 if ainfo.format.get_bits() == 8 && !ainfo.format.is_signed() {
e243ceb4 678 let data: Vec<u8> = vec![0; length];
98c6f2f0 679 let buf: NAAudioBuffer<u8> = NAAudioBuffer { data: NABufferRef::new(data), info: ainfo, offs, chmap, len: nsamples, stride, step };
22cb00db
KS
680 Ok(NABufferType::AudioU8(buf))
681 } else if ainfo.format.get_bits() == 16 && ainfo.format.is_signed() {
e243ceb4 682 let data: Vec<i16> = vec![0; length];
98c6f2f0 683 let buf: NAAudioBuffer<i16> = NAAudioBuffer { data: NABufferRef::new(data), info: ainfo, offs, chmap, len: nsamples, stride, step };
22cb00db 684 Ok(NABufferType::AudioI16(buf))
4c05fc3e
KS
685 } else if ainfo.format.get_bits() == 32 && ainfo.format.is_signed() {
686 let data: Vec<i32> = vec![0; length];
687 let buf: NAAudioBuffer<i32> = NAAudioBuffer { data: NABufferRef::new(data), info: ainfo, offs, chmap, len: nsamples, stride, step };
688 Ok(NABufferType::AudioI32(buf))
22cb00db
KS
689 } else {
690 Err(AllocatorError::TooLargeDimensions)
691 }
692 }
693 } else {
694 let len = nsamples.checked_mul(ainfo.channels as usize);
695 if len == None { return Err(AllocatorError::TooLargeDimensions); }
696 let length = ainfo.format.get_audio_size(len.unwrap() as u64);
e243ceb4 697 let data: Vec<u8> = vec![0; length];
98c6f2f0 698 let buf: NAAudioBuffer<u8> = NAAudioBuffer { data: NABufferRef::new(data), info: ainfo, offs, chmap, len: nsamples, stride: 0, step: 0 };
1a151e53 699 Ok(NABufferType::AudioPacked(buf))
22cb00db
KS
700 }
701}
702
7673d49a 703/// Constructs a new buffer for generic data.
22cb00db 704pub fn alloc_data_buffer(size: usize) -> Result<NABufferType, AllocatorError> {
e243ceb4 705 let data: Vec<u8> = vec![0; size];
1a967e6b 706 let buf: NABufferRef<Vec<u8>> = NABufferRef::new(data);
22cb00db
KS
707 Ok(NABufferType::Data(buf))
708}
709
7673d49a 710/// Creates a clone of current buffer.
b7c882c1 711pub fn copy_buffer(buf: &NABufferType) -> NABufferType {
22cb00db
KS
712 buf.clone()
713}
714
7673d49a
KS
715/// Video frame pool.
716///
717/// This structure allows codec to effectively reuse old frames instead of allocating and de-allocating frames every time.
718/// Caller can also reserve some frames for its own purposes e.g. display queue.
01613464
KS
719pub struct NAVideoBufferPool<T:Copy> {
720 pool: Vec<NAVideoBufferRef<T>>,
1a967e6b 721 max_len: usize,
01613464 722 add_len: usize,
1a967e6b
KS
723}
724
01613464 725impl<T:Copy> NAVideoBufferPool<T> {
7673d49a 726 /// Constructs a new `NAVideoBufferPool` instance.
1a967e6b
KS
727 pub fn new(max_len: usize) -> Self {
728 Self {
729 pool: Vec::with_capacity(max_len),
730 max_len,
01613464 731 add_len: 0,
1a967e6b
KS
732 }
733 }
7673d49a 734 /// Sets the number of buffers reserved for the user.
01613464
KS
735 pub fn set_dec_bufs(&mut self, add_len: usize) {
736 self.add_len = add_len;
737 }
7673d49a 738 /// Returns an unused buffer from the pool.
01613464
KS
739 pub fn get_free(&mut self) -> Option<NAVideoBufferRef<T>> {
740 for e in self.pool.iter() {
741 if e.get_num_refs() == 1 {
742 return Some(e.clone());
743 }
744 }
745 None
746 }
7673d49a 747 /// Clones provided frame data into a free pool frame.
01613464 748 pub fn get_copy(&mut self, rbuf: &NAVideoBufferRef<T>) -> Option<NAVideoBufferRef<T>> {
e243ceb4 749 let mut dbuf = self.get_free()?;
01613464
KS
750 dbuf.data.copy_from_slice(&rbuf.data);
751 Some(dbuf)
752 }
7673d49a 753 /// Clears the pool from all frames.
01613464 754 pub fn reset(&mut self) {
b191eef3 755 self.pool.clear();
01613464
KS
756 }
757}
758
759impl NAVideoBufferPool<u8> {
7673d49a
KS
760 /// Allocates the target amount of video frames using [`alloc_video_buffer`].
761 ///
762 /// [`alloc_video_buffer`]: ./fn.alloc_video_buffer.html
1a967e6b 763 pub fn prealloc_video(&mut self, vinfo: NAVideoInfo, align: u8) -> Result<(), AllocatorError> {
01613464 764 let nbufs = self.max_len + self.add_len - self.pool.len();
1a967e6b 765 for _ in 0..nbufs {
e243ceb4 766 let vbuf = alloc_video_buffer(vinfo, align)?;
01613464
KS
767 if let NABufferType::Video(buf) = vbuf {
768 self.pool.push(buf);
769 } else if let NABufferType::VideoPacked(buf) = vbuf {
770 self.pool.push(buf);
771 } else {
772 return Err(AllocatorError::FormatError);
773 }
1a967e6b
KS
774 }
775 Ok(())
776 }
01613464
KS
777}
778
779impl NAVideoBufferPool<u16> {
7673d49a
KS
780 /// Allocates the target amount of video frames using [`alloc_video_buffer`].
781 ///
782 /// [`alloc_video_buffer`]: ./fn.alloc_video_buffer.html
01613464
KS
783 pub fn prealloc_video(&mut self, vinfo: NAVideoInfo, align: u8) -> Result<(), AllocatorError> {
784 let nbufs = self.max_len + self.add_len - self.pool.len();
1a967e6b 785 for _ in 0..nbufs {
e243ceb4 786 let vbuf = alloc_video_buffer(vinfo, align)?;
01613464
KS
787 if let NABufferType::Video16(buf) = vbuf {
788 self.pool.push(buf);
789 } else {
790 return Err(AllocatorError::FormatError);
791 }
1a967e6b
KS
792 }
793 Ok(())
794 }
01613464
KS
795}
796
797impl NAVideoBufferPool<u32> {
7673d49a
KS
798 /// Allocates the target amount of video frames using [`alloc_video_buffer`].
799 ///
800 /// [`alloc_video_buffer`]: ./fn.alloc_video_buffer.html
01613464
KS
801 pub fn prealloc_video(&mut self, vinfo: NAVideoInfo, align: u8) -> Result<(), AllocatorError> {
802 let nbufs = self.max_len + self.add_len - self.pool.len();
803 for _ in 0..nbufs {
e243ceb4 804 let vbuf = alloc_video_buffer(vinfo, align)?;
01613464
KS
805 if let NABufferType::Video32(buf) = vbuf {
806 self.pool.push(buf);
807 } else {
808 return Err(AllocatorError::FormatError);
1a967e6b
KS
809 }
810 }
01613464 811 Ok(())
1a967e6b
KS
812 }
813}
814
7673d49a 815/// Information about codec contained in a stream.
5869fd63 816#[allow(dead_code)]
8869d452
KS
817#[derive(Clone)]
818pub struct NACodecInfo {
ccae5343 819 name: &'static str,
5869fd63 820 properties: NACodecTypeInfo,
2422d969 821 extradata: Option<Arc<Vec<u8>>>,
5869fd63
KS
822}
823
7673d49a 824/// A specialised type for reference-counted `NACodecInfo`.
2422d969
KS
825pub type NACodecInfoRef = Arc<NACodecInfo>;
826
8869d452 827impl NACodecInfo {
7673d49a 828 /// Constructs a new instance of `NACodecInfo`.
ccae5343 829 pub fn new(name: &'static str, p: NACodecTypeInfo, edata: Option<Vec<u8>>) -> Self {
8869d452
KS
830 let extradata = match edata {
831 None => None,
2422d969 832 Some(vec) => Some(Arc::new(vec)),
8869d452 833 };
e243ceb4 834 NACodecInfo { name, properties: p, extradata }
8869d452 835 }
7673d49a 836 /// Constructs a new reference-counted instance of `NACodecInfo`.
2422d969 837 pub fn new_ref(name: &'static str, p: NACodecTypeInfo, edata: Option<Arc<Vec<u8>>>) -> Self {
e243ceb4 838 NACodecInfo { name, properties: p, extradata: edata }
66116504 839 }
7673d49a 840 /// Converts current instance into a reference-counted one.
2422d969 841 pub fn into_ref(self) -> NACodecInfoRef { Arc::new(self) }
7673d49a 842 /// Returns codec information.
8869d452 843 pub fn get_properties(&self) -> NACodecTypeInfo { self.properties }
7673d49a 844 /// Returns additional initialisation data required by the codec.
2422d969 845 pub fn get_extradata(&self) -> Option<Arc<Vec<u8>>> {
8869d452
KS
846 if let Some(ref vec) = self.extradata { return Some(vec.clone()); }
847 None
5869fd63 848 }
7673d49a 849 /// Returns codec name.
66116504 850 pub fn get_name(&self) -> &'static str { self.name }
7673d49a 851 /// Reports whether it is a video codec.
66116504
KS
852 pub fn is_video(&self) -> bool {
853 if let NACodecTypeInfo::Video(_) = self.properties { return true; }
854 false
855 }
7673d49a 856 /// Reports whether it is an audio codec.
66116504
KS
857 pub fn is_audio(&self) -> bool {
858 if let NACodecTypeInfo::Audio(_) = self.properties { return true; }
859 false
860 }
7673d49a 861 /// Constructs a new empty reference-counted instance of `NACodecInfo`.
2422d969
KS
862 pub fn new_dummy() -> Arc<Self> {
863 Arc::new(DUMMY_CODEC_INFO)
5076115b 864 }
7673d49a 865 /// Updates codec infomation.
2422d969
KS
866 pub fn replace_info(&self, p: NACodecTypeInfo) -> Arc<Self> {
867 Arc::new(NACodecInfo { name: self.name, properties: p, extradata: self.extradata.clone() })
5076115b 868 }
66116504
KS
869}
870
241e56f1
KS
871impl Default for NACodecInfo {
872 fn default() -> Self { DUMMY_CODEC_INFO }
873}
874
66116504
KS
875impl fmt::Display for NACodecInfo {
876 fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
877 let edata = match self.extradata.clone() {
e243ceb4 878 None => "no extradata".to_string(),
66116504
KS
879 Some(v) => format!("{} byte(s) of extradata", v.len()),
880 };
881 write!(f, "{}: {} {}", self.name, self.properties, edata)
882 }
883}
884
7673d49a 885/// Default empty codec information.
66116504
KS
886pub const DUMMY_CODEC_INFO: NACodecInfo = NACodecInfo {
887 name: "none",
888 properties: NACodecTypeInfo::None,
889 extradata: None };
890
7673d49a 891/// A list of recognized frame types.
88c03b61
KS
892#[derive(Debug,Clone,Copy,PartialEq)]
893#[allow(dead_code)]
894pub enum FrameType {
7673d49a 895 /// Intra frame type.
88c03b61 896 I,
7673d49a 897 /// Inter frame type.
88c03b61 898 P,
7673d49a 899 /// Bidirectionally predicted frame.
88c03b61 900 B,
7673d49a
KS
901 /// Skip frame.
902 ///
903 /// When such frame is encountered then last frame should be used again if it is needed.
bc6aac3d 904 Skip,
7673d49a 905 /// Some other frame type.
88c03b61
KS
906 Other,
907}
908
909impl fmt::Display for FrameType {
910 fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
911 match *self {
912 FrameType::I => write!(f, "I"),
913 FrameType::P => write!(f, "P"),
914 FrameType::B => write!(f, "B"),
bc6aac3d 915 FrameType::Skip => write!(f, "skip"),
88c03b61
KS
916 FrameType::Other => write!(f, "x"),
917 }
918 }
919}
920
7673d49a 921/// Timestamp information.
e189501e
KS
922#[derive(Debug,Clone,Copy)]
923pub struct NATimeInfo {
bf507799
KS
924 /// Presentation timestamp.
925 pub pts: Option<u64>,
926 /// Decode timestamp.
927 pub dts: Option<u64>,
928 /// Duration (in timebase units).
929 pub duration: Option<u64>,
930 /// Timebase numerator.
931 pub tb_num: u32,
932 /// Timebase denominator.
933 pub tb_den: u32,
e189501e
KS
934}
935
936impl NATimeInfo {
7673d49a 937 /// Constructs a new `NATimeInfo` instance.
e189501e 938 pub fn new(pts: Option<u64>, dts: Option<u64>, duration: Option<u64>, tb_num: u32, tb_den: u32) -> Self {
e243ceb4 939 NATimeInfo { pts, dts, duration, tb_num, tb_den }
e189501e 940 }
7673d49a 941 /// Returns presentation timestamp.
e189501e 942 pub fn get_pts(&self) -> Option<u64> { self.pts }
7673d49a 943 /// Returns decoding timestamp.
e189501e 944 pub fn get_dts(&self) -> Option<u64> { self.dts }
7673d49a 945 /// Returns duration.
e189501e 946 pub fn get_duration(&self) -> Option<u64> { self.duration }
7673d49a 947 /// Sets new presentation timestamp.
e189501e 948 pub fn set_pts(&mut self, pts: Option<u64>) { self.pts = pts; }
7673d49a 949 /// Sets new decoding timestamp.
e189501e 950 pub fn set_dts(&mut self, dts: Option<u64>) { self.dts = dts; }
7673d49a 951 /// Sets new duration.
e189501e 952 pub fn set_duration(&mut self, dur: Option<u64>) { self.duration = dur; }
266da7b9 953
7673d49a 954 /// Converts time in given scale into timestamp in given base.
b7c882c1 955 #[allow(clippy::collapsible_if)]
266da7b9 956 pub fn time_to_ts(time: u64, base: u64, tb_num: u32, tb_den: u32) -> u64 {
b36f412c
KS
957 let tb_num = u64::from(tb_num);
958 let tb_den = u64::from(tb_den);
edad6765 959 let tmp = time.checked_mul(tb_den);
266da7b9 960 if let Some(tmp) = tmp {
edad6765 961 tmp / base / tb_num
266da7b9 962 } else {
edad6765
KS
963 if tb_num < base {
964 let coarse = time / tb_num;
965 if let Some(tmp) = coarse.checked_mul(tb_den) {
966 tmp / base
967 } else {
968 (coarse / base) * tb_den
969 }
266da7b9
KS
970 } else {
971 let coarse = time / base;
edad6765
KS
972 if let Some(tmp) = coarse.checked_mul(tb_den) {
973 tmp / tb_num
266da7b9 974 } else {
edad6765 975 (coarse / tb_num) * tb_den
266da7b9
KS
976 }
977 }
978 }
979 }
7673d49a 980 /// Converts timestamp in given base into time in given scale.
a65bdeac 981 pub fn ts_to_time(ts: u64, base: u64, tb_num: u32, tb_den: u32) -> u64 {
b36f412c
KS
982 let tb_num = u64::from(tb_num);
983 let tb_den = u64::from(tb_den);
a65bdeac
KS
984 let tmp = ts.checked_mul(base);
985 if let Some(tmp) = tmp {
986 let tmp2 = tmp.checked_mul(tb_num);
987 if let Some(tmp2) = tmp2 {
988 tmp2 / tb_den
989 } else {
990 (tmp / tb_den) * tb_num
991 }
992 } else {
993 let tmp = ts.checked_mul(tb_num);
994 if let Some(tmp) = tmp {
995 (tmp / tb_den) * base
996 } else {
997 (ts / tb_den) * base * tb_num
998 }
999 }
1000 }
73f0f89f 1001 fn get_cur_ts(&self) -> u64 { self.pts.unwrap_or_else(|| self.dts.unwrap_or(0)) }
0eb53738
KS
1002 fn get_cur_millis(&self) -> u64 {
1003 let ts = self.get_cur_ts();
1004 Self::ts_to_time(ts, 1000, self.tb_num, self.tb_den)
1005 }
1006 /// Checks whether the current time information is earler than provided reference time.
1007 pub fn less_than(&self, time: NATimePoint) -> bool {
1008 if self.pts.is_none() && self.dts.is_none() {
1009 return true;
1010 }
1011 match time {
1012 NATimePoint::PTS(rpts) => self.get_cur_ts() < rpts,
1013 NATimePoint::Milliseconds(ms) => self.get_cur_millis() < ms,
1014 NATimePoint::None => false,
1015 }
1016 }
1017 /// Checks whether the current time information is the same as provided reference time.
1018 pub fn equal(&self, time: NATimePoint) -> bool {
1019 if self.pts.is_none() && self.dts.is_none() {
1020 return time == NATimePoint::None;
1021 }
1022 match time {
1023 NATimePoint::PTS(rpts) => self.get_cur_ts() == rpts,
1024 NATimePoint::Milliseconds(ms) => self.get_cur_millis() == ms,
1025 NATimePoint::None => false,
1026 }
1027 }
e189501e
KS
1028}
1029
2c6462c8
KS
1030/// Time information for specifying durations or seek positions.
1031#[derive(Clone,Copy,Debug,PartialEq)]
1032pub enum NATimePoint {
1033 /// Time in milliseconds.
1034 Milliseconds(u64),
1035 /// Stream timestamp.
1036 PTS(u64),
0eb53738
KS
1037 /// No time information present.
1038 None,
2c6462c8
KS
1039}
1040
0bc221c3
KS
1041impl Default for NATimePoint {
1042 fn default() -> Self {
1043 NATimePoint::None
1044 }
1045}
1046
2c6462c8
KS
1047impl fmt::Display for NATimePoint {
1048 fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
1049 match *self {
1050 NATimePoint::Milliseconds(millis) => {
1051 let tot_s = millis / 1000;
1052 let ms = millis % 1000;
1053 if tot_s < 60 {
1054 if ms != 0 {
1055 return write!(f, "{}.{:03}", tot_s, ms);
1056 } else {
1057 return write!(f, "{}", tot_s);
1058 }
1059 }
1060 let tot_m = tot_s / 60;
1061 let s = tot_s % 60;
1062 if tot_m < 60 {
1063 if ms != 0 {
1064 return write!(f, "{}:{:02}.{:03}", tot_m, s, ms);
1065 } else {
1066 return write!(f, "{}:{:02}", tot_m, s);
1067 }
1068 }
1069 let h = tot_m / 60;
1070 let m = tot_m % 60;
1071 if ms != 0 {
1072 write!(f, "{}:{:02}:{:02}.{:03}", h, m, s, ms)
1073 } else {
1074 write!(f, "{}:{:02}:{:02}", h, m, s)
1075 }
1076 },
1077 NATimePoint::PTS(pts) => {
1078 write!(f, "{}pts", pts)
1079 },
0eb53738
KS
1080 NATimePoint::None => {
1081 write!(f, "none")
1082 },
2c6462c8
KS
1083 }
1084 }
1085}
1086
1087impl FromStr for NATimePoint {
1088 type Err = FormatParseError;
1089
1090 /// Parses the string into time information.
1091 ///
1092 /// Accepted formats are `<u64>pts`, `<u64>ms` or `[hh:][mm:]ss[.ms]`.
1093 fn from_str(s: &str) -> Result<Self, Self::Err> {
1094 if s.is_empty() {
1095 return Err(FormatParseError {});
1096 }
1097 if !s.ends_with("pts") {
1098 if s.ends_with("ms") {
1099 let str_b = s.as_bytes();
1100 let num = std::str::from_utf8(&str_b[..str_b.len() - 2]).unwrap();
1101 let ret = num.parse::<u64>();
1102 if let Ok(val) = ret {
1103 return Ok(NATimePoint::Milliseconds(val));
1104 } else {
1105 return Err(FormatParseError {});
1106 }
1107 }
1108 let mut parts = s.split(':');
1109 let mut hrs = None;
1110 let mut mins = None;
1111 let mut secs = parts.next();
1112 if let Some(part) = parts.next() {
1113 std::mem::swap(&mut mins, &mut secs);
1114 secs = Some(part);
1115 }
1116 if let Some(part) = parts.next() {
1117 std::mem::swap(&mut hrs, &mut mins);
1118 std::mem::swap(&mut mins, &mut secs);
1119 secs = Some(part);
1120 }
1121 if parts.next().is_some() {
1122 return Err(FormatParseError {});
1123 }
1124 let hours = if let Some(val) = hrs {
1125 let ret = val.parse::<u64>();
1126 if ret.is_err() { return Err(FormatParseError {}); }
1127 let val = ret.unwrap();
1128 if val > 1000 { return Err(FormatParseError {}); }
1129 val
1130 } else { 0 };
1131 let minutes = if let Some(val) = mins {
1132 let ret = val.parse::<u64>();
1133 if ret.is_err() { return Err(FormatParseError {}); }
1134 let val = ret.unwrap();
1135 if val >= 60 { return Err(FormatParseError {}); }
1136 val
1137 } else { 0 };
1138 let (seconds, millis) = if let Some(val) = secs {
1139 let mut parts = val.split('.');
1140 let ret = parts.next().unwrap().parse::<u64>();
1141 if ret.is_err() { return Err(FormatParseError {}); }
1142 let seconds = ret.unwrap();
dcabdfd2 1143 if mins.is_some() && seconds >= 60 { return Err(FormatParseError {}); }
2c6462c8
KS
1144 let millis = if let Some(val) = parts.next() {
1145 let mut mval = 0;
1146 let mut base = 0;
1147 for ch in val.chars() {
1148 if ch >= '0' && ch <= '9' {
1149 mval = mval * 10 + u64::from((ch as u8) - b'0');
1150 base += 1;
1151 if base > 3 { break; }
1152 } else {
1153 return Err(FormatParseError {});
1154 }
1155 }
1156 while base < 3 {
1157 mval *= 10;
1158 base += 1;
1159 }
1160 mval
1161 } else { 0 };
1162 (seconds, millis)
1163 } else { unreachable!(); };
1164 let tot_secs = hours * 60 * 60 + minutes * 60 + seconds;
1165 Ok(NATimePoint::Milliseconds(tot_secs * 1000 + millis))
1166 } else {
1167 let str_b = s.as_bytes();
1168 let num = std::str::from_utf8(&str_b[..str_b.len() - 3]).unwrap();
1169 let ret = num.parse::<u64>();
1170 if let Ok(val) = ret {
1171 Ok(NATimePoint::PTS(val))
1172 } else {
1173 Err(FormatParseError {})
1174 }
1175 }
1176 }
1177}
1178
7673d49a 1179/// Decoded frame information.
e189501e
KS
1180#[allow(dead_code)]
1181#[derive(Clone)]
1182pub struct NAFrame {
bf507799
KS
1183 /// Frame timestamp.
1184 pub ts: NATimeInfo,
1185 /// Frame ID.
1186 pub id: i64,
1187 buffer: NABufferType,
1188 info: NACodecInfoRef,
1189 /// Frame type.
1190 pub frame_type: FrameType,
1191 /// Keyframe flag.
1192 pub key: bool,
a5ba48ac 1193// options: HashMap<String, NAValue>,
66116504
KS
1194}
1195
7673d49a 1196/// A specialised type for reference-counted `NAFrame`.
171860fc 1197pub type NAFrameRef = Arc<NAFrame>;
ebd71c92 1198
66116504
KS
1199fn get_plane_size(info: &NAVideoInfo, idx: usize) -> (usize, usize) {
1200 let chromaton = info.get_format().get_chromaton(idx);
e243ceb4 1201 if chromaton.is_none() { return (0, 0); }
66116504
KS
1202 let (hs, vs) = chromaton.unwrap().get_subsampling();
1203 let w = (info.get_width() + ((1 << hs) - 1)) >> hs;
1204 let h = (info.get_height() + ((1 << vs) - 1)) >> vs;
1205 (w, h)
1206}
1207
1208impl NAFrame {
7673d49a 1209 /// Constructs a new `NAFrame` instance.
e189501e 1210 pub fn new(ts: NATimeInfo,
88c03b61
KS
1211 ftype: FrameType,
1212 keyframe: bool,
2422d969 1213 info: NACodecInfoRef,
a5ba48ac 1214 /*options: HashMap<String, NAValue>,*/
22cb00db 1215 buffer: NABufferType) -> Self {
a5ba48ac 1216 NAFrame { ts, id: 0, buffer, info, frame_type: ftype, key: keyframe/*, options*/ }
ebd71c92 1217 }
7673d49a 1218 /// Returns frame format information.
2422d969 1219 pub fn get_info(&self) -> NACodecInfoRef { self.info.clone() }
7673d49a 1220 /// Returns frame type.
bf507799 1221 pub fn get_frame_type(&self) -> FrameType { self.frame_type }
7673d49a 1222 /// Reports whether the frame is a keyframe.
88c03b61 1223 pub fn is_keyframe(&self) -> bool { self.key }
7673d49a 1224 /// Sets new frame type.
bf507799 1225 pub fn set_frame_type(&mut self, ftype: FrameType) { self.frame_type = ftype; }
7673d49a 1226 /// Sets keyframe flag.
88c03b61 1227 pub fn set_keyframe(&mut self, key: bool) { self.key = key; }
7673d49a 1228 /// Returns frame timestamp.
e189501e 1229 pub fn get_time_information(&self) -> NATimeInfo { self.ts }
7673d49a 1230 /// Returns frame presentation time.
e189501e 1231 pub fn get_pts(&self) -> Option<u64> { self.ts.get_pts() }
7673d49a 1232 /// Returns frame decoding time.
e189501e 1233 pub fn get_dts(&self) -> Option<u64> { self.ts.get_dts() }
7673d49a 1234 /// Returns picture ID.
f18bba90 1235 pub fn get_id(&self) -> i64 { self.id }
7673d49a 1236 /// Returns frame display duration.
e189501e 1237 pub fn get_duration(&self) -> Option<u64> { self.ts.get_duration() }
7673d49a 1238 /// Sets new presentation timestamp.
e189501e 1239 pub fn set_pts(&mut self, pts: Option<u64>) { self.ts.set_pts(pts); }
7673d49a 1240 /// Sets new decoding timestamp.
e189501e 1241 pub fn set_dts(&mut self, dts: Option<u64>) { self.ts.set_dts(dts); }
7673d49a 1242 /// Sets new picture ID.
f18bba90 1243 pub fn set_id(&mut self, id: i64) { self.id = id; }
7673d49a 1244 /// Sets new duration.
e189501e 1245 pub fn set_duration(&mut self, dur: Option<u64>) { self.ts.set_duration(dur); }
66116504 1246
7673d49a 1247 /// Returns a reference to the frame data.
22cb00db 1248 pub fn get_buffer(&self) -> NABufferType { self.buffer.clone() }
171860fc 1249
7673d49a 1250 /// Converts current instance into a reference-counted one.
171860fc 1251 pub fn into_ref(self) -> NAFrameRef { Arc::new(self) }
2b8bf9a0
KS
1252
1253 /// Creates new frame with metadata from `NAPacket`.
1254 pub fn new_from_pkt(pkt: &NAPacket, info: NACodecInfoRef, buf: NABufferType) -> NAFrame {
1255 NAFrame::new(pkt.ts, FrameType::Other, pkt.keyframe, info, /*HashMap::new(),*/ buf)
1256 }
5869fd63
KS
1257}
1258
ebd71c92
KS
1259impl fmt::Display for NAFrame {
1260 fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
bf507799 1261 let mut ostr = format!("frame type {}", self.frame_type);
e243ceb4
KS
1262 if let Some(pts) = self.ts.pts { ostr = format!("{} pts {}", ostr, pts); }
1263 if let Some(dts) = self.ts.dts { ostr = format!("{} dts {}", ostr, dts); }
1264 if let Some(dur) = self.ts.duration { ostr = format!("{} duration {}", ostr, dur); }
1265 if self.key { ostr = format!("{} kf", ostr); }
1266 write!(f, "[{}]", ostr)
ebd71c92
KS
1267 }
1268}
88c03b61 1269
7673d49a 1270/// A list of possible stream types.
baf5478c 1271#[derive(Debug,Clone,Copy,PartialEq)]
5869fd63 1272#[allow(dead_code)]
48c88fde 1273pub enum StreamType {
7673d49a 1274 /// Video stream.
48c88fde 1275 Video,
7673d49a 1276 /// Audio stream.
48c88fde 1277 Audio,
7673d49a 1278 /// Subtitles.
48c88fde 1279 Subtitles,
7673d49a 1280 /// Any data stream (or might be an unrecognized audio/video stream).
48c88fde 1281 Data,
7673d49a 1282 /// Nonexistent stream.
48c88fde
KS
1283 None,
1284}
1285
1286impl fmt::Display for StreamType {
1287 fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
1288 match *self {
1289 StreamType::Video => write!(f, "Video"),
1290 StreamType::Audio => write!(f, "Audio"),
1291 StreamType::Subtitles => write!(f, "Subtitles"),
1292 StreamType::Data => write!(f, "Data"),
1293 StreamType::None => write!(f, "-"),
1294 }
1295 }
1296}
1297
7673d49a 1298/// Stream data.
48c88fde
KS
1299#[allow(dead_code)]
1300#[derive(Clone)]
1301pub struct NAStream {
bf507799
KS
1302 media_type: StreamType,
1303 /// Stream ID.
1304 pub id: u32,
1305 num: usize,
1306 info: NACodecInfoRef,
1307 /// Timebase numerator.
1308 pub tb_num: u32,
1309 /// Timebase denominator.
1310 pub tb_den: u32,
a480a0de
KS
1311 /// Duration in timebase units (zero if not available).
1312 pub duration: u64,
e189501e
KS
1313}
1314
7673d49a 1315/// A specialised reference-counted `NAStream` type.
70910ac3
KS
1316pub type NAStreamRef = Arc<NAStream>;
1317
7673d49a 1318/// Downscales the timebase by its greatest common denominator.
b7c882c1 1319#[allow(clippy::comparison_chain)]
e189501e
KS
1320pub fn reduce_timebase(tb_num: u32, tb_den: u32) -> (u32, u32) {
1321 if tb_num == 0 { return (tb_num, tb_den); }
1322 if (tb_den % tb_num) == 0 { return (1, tb_den / tb_num); }
1323
1324 let mut a = tb_num;
1325 let mut b = tb_den;
1326
1327 while a != b {
1328 if a > b { a -= b; }
1329 else if b > a { b -= a; }
1330 }
1331
1332 (tb_num / a, tb_den / a)
5869fd63 1333}
48c88fde
KS
1334
1335impl NAStream {
7673d49a 1336 /// Constructs a new `NAStream` instance.
a480a0de 1337 pub fn new(mt: StreamType, id: u32, info: NACodecInfo, tb_num: u32, tb_den: u32, duration: u64) -> Self {
e189501e 1338 let (n, d) = reduce_timebase(tb_num, tb_den);
a480a0de 1339 NAStream { media_type: mt, id, num: 0, info: info.into_ref(), tb_num: n, tb_den: d, duration }
48c88fde 1340 }
7673d49a 1341 /// Returns stream id.
48c88fde 1342 pub fn get_id(&self) -> u32 { self.id }
7673d49a 1343 /// Returns stream type.
baf5478c 1344 pub fn get_media_type(&self) -> StreamType { self.media_type }
7673d49a 1345 /// Returns stream number assigned by demuxer.
48c88fde 1346 pub fn get_num(&self) -> usize { self.num }
7673d49a 1347 /// Sets stream number.
48c88fde 1348 pub fn set_num(&mut self, num: usize) { self.num = num; }
7673d49a 1349 /// Returns codec information.
2422d969 1350 pub fn get_info(&self) -> NACodecInfoRef { self.info.clone() }
7673d49a 1351 /// Returns stream timebase.
e189501e 1352 pub fn get_timebase(&self) -> (u32, u32) { (self.tb_num, self.tb_den) }
7673d49a 1353 /// Sets new stream timebase.
e189501e
KS
1354 pub fn set_timebase(&mut self, tb_num: u32, tb_den: u32) {
1355 let (n, d) = reduce_timebase(tb_num, tb_den);
1356 self.tb_num = n;
1357 self.tb_den = d;
1358 }
a480a0de
KS
1359 /// Returns stream duration.
1360 pub fn get_duration(&self) -> usize { self.num }
7673d49a 1361 /// Converts current instance into a reference-counted one.
70910ac3 1362 pub fn into_ref(self) -> NAStreamRef { Arc::new(self) }
48c88fde
KS
1363}
1364
1365impl fmt::Display for NAStream {
1366 fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
e189501e 1367 write!(f, "({}#{} @ {}/{} - {})", self.media_type, self.id, self.tb_num, self.tb_den, self.info.get_properties())
48c88fde
KS
1368 }
1369}
1370
8057a7fd
KS
1371/// Side data that may accompany demuxed data.
1372#[derive(Clone)]
1373pub enum NASideData {
1374 /// Palette information.
1375 ///
1376 /// This side data contains a flag signalling that palette has changed since previous time and a reference to the current palette.
1377 /// Palette is stored in 8-bit RGBA format.
1378 Palette(bool, Arc<[u8; 1024]>),
1379 /// Generic user data.
1380 UserData(Arc<Vec<u8>>),
1381}
1382
7673d49a 1383/// Packet with compressed data.
48c88fde
KS
1384#[allow(dead_code)]
1385pub struct NAPacket {
bf507799
KS
1386 stream: NAStreamRef,
1387 /// Packet timestamp.
1388 pub ts: NATimeInfo,
1389 buffer: NABufferRef<Vec<u8>>,
1390 /// Keyframe flag.
1391 pub keyframe: bool,
48c88fde 1392// options: HashMap<String, NAValue<'a>>,
8057a7fd
KS
1393 /// Packet side data (e.g. palette for paletted formats).
1394 pub side_data: Vec<NASideData>,
48c88fde
KS
1395}
1396
1397impl NAPacket {
7673d49a 1398 /// Constructs a new `NAPacket` instance.
70910ac3 1399 pub fn new(str: NAStreamRef, ts: NATimeInfo, kf: bool, vec: Vec<u8>) -> Self {
48c88fde
KS
1400// let mut vec: Vec<u8> = Vec::new();
1401// vec.resize(size, 0);
8057a7fd 1402 NAPacket { stream: str, ts, keyframe: kf, buffer: NABufferRef::new(vec), side_data: Vec::new() }
48c88fde 1403 }
89f25cd7
KS
1404 /// Constructs a new `NAPacket` instance reusing a buffer reference.
1405 pub fn new_from_refbuf(str: NAStreamRef, ts: NATimeInfo, kf: bool, buffer: NABufferRef<Vec<u8>>) -> Self {
1406 NAPacket { stream: str, ts, keyframe: kf, buffer, side_data: Vec::new() }
1407 }
7673d49a 1408 /// Returns information about the stream packet belongs to.
70910ac3 1409 pub fn get_stream(&self) -> NAStreamRef { self.stream.clone() }
7673d49a 1410 /// Returns packet timestamp.
e189501e 1411 pub fn get_time_information(&self) -> NATimeInfo { self.ts }
7673d49a 1412 /// Returns packet presentation timestamp.
e189501e 1413 pub fn get_pts(&self) -> Option<u64> { self.ts.get_pts() }
7673d49a 1414 /// Returns packet decoding timestamp.
e189501e 1415 pub fn get_dts(&self) -> Option<u64> { self.ts.get_dts() }
7673d49a 1416 /// Returns packet duration.
e189501e 1417 pub fn get_duration(&self) -> Option<u64> { self.ts.get_duration() }
7673d49a 1418 /// Reports whether this is a keyframe packet.
48c88fde 1419 pub fn is_keyframe(&self) -> bool { self.keyframe }
7673d49a 1420 /// Returns a reference to packet data.
1a967e6b 1421 pub fn get_buffer(&self) -> NABufferRef<Vec<u8>> { self.buffer.clone() }
8057a7fd
KS
1422 /// Adds side data for a packet.
1423 pub fn add_side_data(&mut self, side_data: NASideData) { self.side_data.push(side_data); }
b3785cd7
KS
1424 /// Assigns packet to a new stream.
1425 pub fn reassign(&mut self, str: NAStreamRef, ts: NATimeInfo) {
1426 self.stream = str;
1427 self.ts = ts;
1428 }
48c88fde
KS
1429}
1430
1431impl Drop for NAPacket {
1432 fn drop(&mut self) {}
1433}
1434
1435impl fmt::Display for NAPacket {
1436 fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
e243ceb4
KS
1437 let mut ostr = format!("[pkt for {} size {}", self.stream, self.buffer.len());
1438 if let Some(pts) = self.ts.pts { ostr = format!("{} pts {}", ostr, pts); }
1439 if let Some(dts) = self.ts.dts { ostr = format!("{} dts {}", ostr, dts); }
1440 if let Some(dur) = self.ts.duration { ostr = format!("{} duration {}", ostr, dur); }
1441 if self.keyframe { ostr = format!("{} kf", ostr); }
1442 ostr += "]";
1443 write!(f, "{}", ostr)
48c88fde
KS
1444 }
1445}
2c6462c8 1446
1ebf572d
KS
1447/// Packet with a piece of data for a raw stream.
1448pub struct NARawData {
1449 stream: NAStreamRef,
1450 buffer: NABufferRef<Vec<u8>>,
1451}
1452
1453impl NARawData {
1454 /// Constructs a new `NARawData` instance.
1455 pub fn new(stream: NAStreamRef, vec: Vec<u8>) -> Self {
1456 Self { stream, buffer: NABufferRef::new(vec) }
1457 }
1458 /// Constructs a new `NARawData` instance reusing a buffer reference.
1459 pub fn new_from_refbuf(stream: NAStreamRef, buffer: NABufferRef<Vec<u8>>) -> Self {
1460 Self { stream, buffer }
1461 }
1462 /// Returns information about the stream this data belongs to.
1463 pub fn get_stream(&self) -> NAStreamRef { self.stream.clone() }
1464 /// Returns a reference to packet data.
1465 pub fn get_buffer(&self) -> NABufferRef<Vec<u8>> { self.buffer.clone() }
1466 /// Assigns raw data to a new stream.
1467 pub fn reassign(&mut self, stream: NAStreamRef) {
1468 self.stream = stream;
1469 }
1470}
1471
1472impl fmt::Display for NARawData {
1473 fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
1474 write!(f, "[raw data for {} size {}]", self.stream, self.buffer.len())
1475 }
1476}
1477
2c6462c8
KS
1478#[cfg(test)]
1479mod test {
1480 use super::*;
1481
1482 #[test]
1483 fn test_time_parse() {
1484 assert_eq!(NATimePoint::PTS(42).to_string(), "42pts");
1485 assert_eq!(NATimePoint::Milliseconds(4242000).to_string(), "1:10:42");
1486 assert_eq!(NATimePoint::Milliseconds(42424242).to_string(), "11:47:04.242");
1487 let ret = NATimePoint::from_str("42pts");
1488 assert_eq!(ret.unwrap(), NATimePoint::PTS(42));
1489 let ret = NATimePoint::from_str("1:2:3");
1490 assert_eq!(ret.unwrap(), NATimePoint::Milliseconds(3723000));
1491 let ret = NATimePoint::from_str("1:2:3.42");
1492 assert_eq!(ret.unwrap(), NATimePoint::Milliseconds(3723420));
1493 }
1494}