oximedia-timecode 0.1.2

LTC and VITC timecode reading and writing for OxiMedia
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77

# oximedia-timecode

![Status: Alpha](https://img.shields.io/badge/status-alpha-yellow)

LTC and VITC timecode reading and writing for OxiMedia. Provides SMPTE 12M compliant timecode support for all standard frame rates with drop frame, user bits, and real-time operation.

Part of the [oximedia](https://github.com/cool-japan/oximedia) workspace — a comprehensive pure-Rust media processing framework.

Version: 0.1.1 — 2026-03-10

## Features

- **LTC (Linear Timecode)** - Audio-based timecode encoding/decoding
- **VITC (Vertical Interval Timecode)** - Video line-based timecode
- **All Standard Frame Rates** - 23.976, 24, 25, 29.97 DF/NDF, 30, 50, 59.94, 60 fps
- **Drop Frame Support** - Proper SMPTE drop frame arithmetic
- **Non-drop Frame** - Standard non-drop frame timecode
- **User Bits** - 32-bit user data encoding/decoding
- **Burn-in** - Timecode burn-in for video frames
- **Timecode Math** - Add, subtract, compare, and convert timecodes
- **MIDI Timecode (MTC)** - MIDI time code support
- **Drift Detection** - Monitor and correct timecode drift
- **Range Operations** - Timecode range and interval handling
- **Real-time Capable** - Optimized for real-time operations
- **Timecode Continuity** - Detect and handle timecode discontinuities
- **Frame Offset** - Frame-accurate offset arithmetic
- **Timecode Comparison** - Compare and sort timecodes
- **Format Conversion** - Convert between timecode formats
- **Interpolation** - Interpolate timecodes between known points
- **Metadata** - Attach metadata to timecode streams
- **SMPTE Ranges** - Validate against SMPTE timecode ranges
- **Timecode Validation** - Validate timecode values and sequences
- **Sync Mapping** - Map between different timecode streams
- **Calculator Utilities** - High-level timecode calculator API

## Usage

Add to your `Cargo.toml`:

```toml
[dependencies]
oximedia-timecode = "0.1.1"
```

```rust
use oximedia_timecode::{Timecode, FrameRate};

// Create a timecode
let tc = Timecode::new(1, 2, 3, 4, FrameRate::Fps25)?;
println!("{}", tc); // "01:02:03:04"

// Convert to frame count
let frames = tc.to_frames();

// Increment by one frame
let mut tc = Timecode::new(0, 0, 0, 24, FrameRate::Fps25)?;
tc.increment()?;
assert_eq!(tc.seconds, 1);
assert_eq!(tc.frames, 0);

// Drop frame timecode (29.97 DF)
let df_tc = Timecode::new(1, 2, 3, 4, FrameRate::Fps2997DF)?;
println!("{}", df_tc); // "01:02:03;04" (semicolon separator)
```

## API Overview

- `Timecode` — SMPTE timecode with HH:MM:SS:FF representation, drop frame support
- `FrameRate` — Fps23976, Fps24, Fps25, Fps2997DF, Fps2997NDF, Fps30, Fps50, Fps5994, Fps60
- `FrameRateInfo` — Frame rate with drop frame flag
- `TimecodeReader` / `TimecodeWriter` — Traits for LTC/VITC I/O
- `TimecodeError` — Invalid hours, minutes, seconds, frames, drop frame, sync, CRC errors
- Modules: `burn_in`, `continuity`, `drop_frame`, `duration`, `frame_offset`, `frame_rate`, `ltc`, `ltc_encoder`, `ltc_parser`, `midi_timecode`, `reader`, `sync`, `sync_map`, `tc_calculator`, `tc_compare`, `tc_convert`, `tc_drift`, `tc_interpolate`, `tc_math`, `tc_metadata`, `tc_range`, `tc_smpte_ranges`, `tc_validator`, `timecode_calculator`, `timecode_format`, `timecode_range`, `vitc`

## License

Apache-2.0 — Copyright 2024-2026 COOLJAPAN OU (Team Kitasan)