SMPTE LTC Generator

SMPTE標準に準拠したLTC（Linear Timecode）を生成するためのPythonツールです。様々なフレームレート（24, 25, 29.97, 30, 59.94, 60fps）でLTCを生成し、WAVファイルとして出力できます。

Touchdesignerでの動作を確認しています。

機能

• SMPTE標準のフレームレート（24, 25, 29.97, 30, 59.94, 60fps）をサポート
• ドロップフレームとノンドロップフレームのタイムコードをサポート（29.97fpsと59.94fps用）
• 時間、分、秒、フレームを指定してLTCを生成
• 現在の時刻からLTCを生成
• 生成したLTCを音声ファイル（WAV）として出力
• ユーザービットデータのサポート（日付、タイムゾーン、リール番号、カメラIDなど）
• ユーザービットフィールド1のサポート（4ビット: 0-15）

インストール

必要なパッケージをインストールします：

pip install -r requirements.txt

使い方

コマンドライン

# デフォルト設定（30fps、ノンドロップフレーム、5秒間のLTC）
python ltc_generator.py

# フレームレートを指定（24fps）
python ltc_generator.py --fps 24

# ドロップフレームタイムコード（29.97fps）
python ltc_generator.py --fps 29.97 --drop-frame

# ノンドロップフレームタイムコード（30fps）を明示的に指定
python ltc_generator.py --fps 30 --non-drop-frame

# タイムコードを指定（01:30:45:10）
python ltc_generator.py --hours 1 --minutes 30 --seconds 45 --frames 10

# 出力ファイル名を指定
python ltc_generator.py --output my_ltc.wav

# 現在の時刻からLTCを生成
python ltc_generator.py --current-time

# 生成するLTCの長さを指定（10秒）
python ltc_generator.py --duration 10.0

# ユーザービットフィールド1を指定（値: 10）
python ltc_generator.py --user-bits-field1 10

# フレームレートとユーザービットフィールド1を指定
python ltc_generator.py --fps 30 --user-bits-field1 15

Pythonコードとして

from ltc_generator import LTCGenerator

# LTCジェネレーターを初期化（フレームレート: 29.97fps、ドロップフレーム）
ltc_gen = LTCGenerator(fps=29.97, use_drop_frame=True, user_bits=user_bits)

# LTCを生成（01:30:45:10、10秒間）
waveform = ltc_gen.generate_ltc(hours=1, minutes=30, seconds=45, frames=10, duration=10.0)

# ファイルに保存
ltc_gen.save_to_file(waveform, 'my_ltc.wav')

# ユーザービットフィールド1を後から変更
ltc_gen.set_user_bits_field1(15)

オプション

基本オプション

• --fps: フレームレート（24, 25, 29.97, 30, 59.94, 60）
• --sample-rate: サンプルレート（デフォルト: 48000Hz）
• --hours: 時間（0-23）
• --minutes: 分（0-59）
• --seconds: 秒（0-59）
• --frames: フレーム（0-fps-1）
• --duration: 生成するLTCの長さ（秒）
• --output: 出力ファイル名
• --current-time: 現在の時刻を使用
• --drop-frame: ドロップフレームタイムコードを使用（29.97fpsと59.94fpsのみ有効）
• --non-drop-frame: ノンドロップフレームタイムコードを使用

ユーザービットオプション

• --user-bits-field1: ユーザービットフィールド1（0-15）
• --user-bits-field2: ユーザービットフィールド2（0-15）
• --user-bits-field3: ユーザービットフィールド3（0-15）
• --user-bits-field4: ユーザービットフィールド4（0-15）
• --user-bits-field5: ユーザービットフィールド5（0-15）
• --user-bits-field6: ユーザービットフィールド6（0-15）
• --user-bits-field7: ユーザービットフィールド7（0-15）
• --user-bits-field8: ユーザービットフィールド8（0-15）

SMPTE標準について

このジェネレーターは以下のSMPTE標準に準拠しています：

• SMPTE 12M-1: タイムコードの規格
• SMPTE 12M-2: LTCのビットレイアウトと信号特性

ライセンス

このプロジェクトはMITライセンスの下で公開されています。詳細はLICENSEファイルを参照してください。