Kenapa ini penting

Sumber sama — keputusan berbeza

Rupa sebenar filem itu bergantung sepenuhnya kepada cara ia diproses — tiada penukaran langsung, anggaran pantas pemain media sendiri, atau proses BT.2390 yang sebenar.

Video HDR mentah dimainkan pada paparan tanpa sokongan HDR — imej pudar, rata, kontras rendah.

Tiada penukaran

HDR mentah, tiada penukaran

Memainkan fail HDR yang belum disentuh pada paparan atau projektor yang tidak memahami HDR — curve PQ/HLG dipaparkan seolah-olah ia SDR, jadi semuanya kelihatan kelabu, rata, dan pudar.

Video HDR yang sama di-tone-map secara automatik oleh pemain media seperti VLC — highlight hilang perincian, warna beralih.

"Auto" milik pemain atau TV sendiri

Ditukar secara automatik oleh pemain media

Pemain seperti VLC menggunakan tone-mapping pantas mereka sendiri supaya main balik sekurang-kurangnya boleh ditonton — biasanya curve tetap yang kasar yang memotong highlight atau mengubah warna, bukan proses BT.2390 yang disengajakan dengan curve pilihan anda.

Video HDR yang sama ditukar dengan betul kepada SDR menggunakan tone-mapping BT.2390 pada GPU aplikasi ini — highlight seimbang dan warna tepat.

BT.2390 sebenar

Tone-mapping BT.2390 yang betul

EETF ITU-R BT.2390 sebenar, dijalankan pada GPU melalui libplacebo — penurunan highlight terkawal dan warna tepat, output sebagai fail SDR sebenar yang sedia untuk mana-mana paparan standard.

Backend

Tiga cara untuk tone-map. Pilih yang sesuai dengan perkakasan anda.

Video sumber yang sama, tiga saluran paip yang benar-benar berbeza. Tiada apa yang disembunyikan di sebalik butang "auto" — backend dan curve yang anda pilih adalah tepat apa yang dijalankan.

CPU · Standard

FFmpeg standard

Penapis klasik tonemap. Pantas, berfungsi di mana-mana FFmpeg berfungsi, tidak memerlukan GPU.

Curve Hable, Reinhard, Mobius
Mod Pro menambah Linear, Gamma, Clip, dan laluan "None" secara terus

GPU · Vulkan

libplacebo / BT.2390

Menjalankan EETF ITU-R BT.2390 sebenar pada GPU melalui libplacebo, curve rujukan yang sama di mana kebanyakan gred HDR ke SDR profesional dibina.

BT.2390 secara lalai
Mod Pro membuka kunci BT.2446A, ST2094-10, ST2094-40 (HDR10+), dan Auto

Pilihan

HandBrakeCLI

Laluan pengekodan alternatif melalui HandBrakeCLI untuk kes di mana saluran paip sendiri berfungsi lebih baik pada sumber tertentu.

Kawalan resolusi/pengekod yang sama
Penghuraian kemajuan sendiri, dipaparkan secara langsung dalam Activity

Ciri-ciri

Semua yang diperlukan oleh penukaran sebenar untuk menjadi betul.

Dibina berdasarkan bahagian kerja tone-mapping yang benar-benar boleh menjadi salah pada rakaman sebenar: curve yang salah, pengekod yang salah, atau proses yang mengambil alih keseluruhan mesin semasa berjalan.

Praset resolusi

Source (tiada penskalaan), 4K, 1440p, 1080p, 720p, atau 480p. Penskalaan berdasarkan ketinggian, dengan lebar dikira secara automatik supaya nisbah aspek sumber tidak pernah diregangkan.

Menganalisis secara automatik

Pilih sumber dan ia terus dibaca — ciri pemindahan, kedalaman bit, tempoh, metadata HDR10+/Dolby Vision — dengan curve yang dicadangkan untuk fail tersebut. Laluan output SDR diisi untuk anda, dan menyeret fail video ke mana-mana pada tetingkap berfungsi sama seperti butang Browse.

Pratonton Langsung

Bingkai sebenar yang dinyahkod dan di-tone-map dari sumber anda, dikemas kini apabila anda menukar tetapan, dengan semakan pemotongan bayang/highlight supaya curve yang merosakkan perincian dapat dikesan sebelum pengekodan penuh. Lihat pada saiz penuh atau simpan bingkai terus ke cakera.

Anggaran kadar bit langsung

Dikemas kini secara automatik apabila kualiti, resolusi, atau pengekod berubah, supaya gabungan CRF/resolusi yang mengejutkan kelihatan sebelum anda menekan Start.

Tip curve

Layangkan tetikus pada mana-mana curve tone-mapping untuk penjelasan mudah tentang pertukaran sebenarnya — bukan teks pemasaran.

Pilihan pengekod

x264/x265 pada CPU, atau pengekodan perkakasan melalui NVIDIA NVENC, AMD AMF, atau Apple VideoToolbox, dalam H.264 atau H.265.

Output 10-bit & 12-bit

Percuma, tanpa lesen, tanpa binaan berasingan. 10-bit berfungsi dengan mana-mana pengekod H.265 (CPU atau perkakasan); 12-bit tersedia melalui libx265 pada CPU — aplikasi hanya memaparkan pengekod yang benar-benar menyokong kedalaman bit yang anda pilih.

Mod Pro

Membuka julat CRF/CQ penuh (0–51), kawalan ofset kecerahan, dan curve tone-map tambahan — kekal tersembunyi sehingga anda memerlukannya.

Nyahkod dipercepatkan perkakasan

Nyahkod CUDA / DXVA2 / VideoToolbox untuk backend FFmpeg, supaya GPU mengendalikan kedua-dua pembacaan dan tone-mapping.

Keutamaan proses & teras CPU

Efficiency, Balanced, atau Performance, ditambah had teras CPU langsung — kedua-duanya digunakan pada Start dan boleh dilaraskan semasa penukaran berjalan, supaya kumpulan yang panjang tidak mengunci baki mesin anda.

Activity & System

Log langsung yang boleh dilipat menstrim output FFmpeg/HandBrake sebenar dan kemajuan; panel System melaporkan apa yang dikesan pada sistem anda — FFmpeg, Vulkan, HandBrakeCLI — sebelum anda mula menukar.

Persediaan satu klik pada Windows

FFmpeg atau HandBrakeCLI yang hilang dipasang melalui winget dari dalam aplikasi — dari panel System, atau pintasan "Quick install" betul-betul di sebelahnya — dengan output pemasangan distrim secara langsung dalam Activity.

Muat turun

Dapatkan aplikasi

Binaan Windows jika anda hanya mahu menjalankannya, atau kod sumber jika anda menggunakan macOS/Linux atau mahu membaca kod dahulu.

Windows

Windows (.exe)

Binaan fail tunggal, Python tidak diperlukan. FFmpeg masih diperlukan secara berasingan — atau pasang dalam aplikasi melalui winget.

Muat turun .exe terkini

Sentiasa keluaran terkini · Windows 10/11

Sumber

Kod sumber

Memerlukan Python 3.10+ dan pip install -r requirements.txt. Berjalan pada Windows, macOS, dan Linux.

Muat turun .zip sumber

Dilesenkan MIT · cawangan main

Dokumentasi

Panduan pemasangan & penggunaan

Aplikasi ini adalah satu skrip PySide6 tunggal. Tiada pemasang, tiada perkhidmatan latar belakang — anda menjalankannya, dan ia terus memanggil FFmpeg (dan secara pilihan HandBrakeCLI).

Keperluan

Apa yang perlu ada pada mesin sebelum anda melancarkannya.

Komponen	Diperlukan untuk
Python 3.10+	Menjalankan aplikasi itu sendiri
PySide6	Antara muka berasaskan Qt
FFmpeg	Backend tone-mapping standard dan GPU
GPU yang menyokong Vulkan + pemacu	Khususnya backend libplacebo/BT.2390
HandBrakeCLI (pilihan)	Backend HandBrake
psutil (pilihan)	Jeda/sambung semula langsung, kawalan teras CPU, dan statistik sumber CPU/GPU

Pemasangan & menjalankan

Tiga arahan, kemudian anda akan melihat tetingkap.

# 1. Dapatkan skrip dan kebergantungan Python-nya
pip install PySide6 psutil

# 2. Pastikan FFmpeg ada dalam PATH anda
ffmpeg -version

# 3. Lancarkan
python hdr_to_sdr_gui_qt.py

Windows: jika FFmpeg atau HandBrakeCLI tidak dijumpai, buka panel System dan gunakan "Install missing (winget)" dan bukannya memasangnya secara manual.

Aliran kerja asas

Dari fail sumber HDR kepada output SDR.

Pilih fail sumber. Mana-mana bekas HDR yang boleh dibaca oleh FFmpeg — analisis berjalan secara automatik (fungsi pemindahan, kedalaman bit, metadata HDR10+/Dolby Vision, dan curve yang dicadangkan), dan laluan output SDR diisi untuk anda. Menyeret fail ke tetingkap berfungsi sama seperti butang Browse.
Pilih backend dan curve. BT.2390 pada GPU adalah pilihan lalai yang munasabah; tukar kepada FFmpeg standard jika anda tidak mempunyai GPU yang menyokong Vulkan. Layangkan tetikus pada mana-mana curve untuk melihat pertukaran sebenarnya.
Tetapkan resolusi, pengekod, dan kedalaman bit. Biarkan resolusi pada "Source" untuk mengekalkan saiz bingkai dan nisbah aspek asal, atau pilih praset untuk skala turun dalam laluan yang sama.
Laraskan kualiti, atau dayakan mod Pro untuk julat CRF/CQ penuh dan ofset kecerahan. Semak Pratonton Langsung — ia menunjukkan bingkai yang benar-benar di-tone-map dan menandakan pemotongan bayang/highlight — serta anggaran kadar bit langsung sebelum komited.
Tukar, dan perhatikan kemajuan dan output langsung FFmpeg/HandBrake dalam Activity. Jeda/sambung semula, had teras CPU, dan keutamaan proses semuanya boleh dilaraskan semasa berjalan.

Memilih curve

Semua ini adalah pilihan tone-mapping FFmpeg/libplacebo yang sebenar dan didokumenkan — tiada apa di sini yang direka.

Curve	Backend	Bila hendak menggunakannya
BT.2390	GPU	Pilihan lalai — EETF rujukan yang disasarkan oleh kebanyakan gred HDR ke SDR
Hable	CPU	Penurunan gaya filem, tidak memerlukan GPU
Reinhard / Mobius	CPU	Alternatif penurunan highlight yang lebih lembut berbanding Hable
BT.2446A	GPU · Pro	Alternatif berorientasikan penyiaran kepada BT.2390
ST2094-10 / ST2094-40	GPU · Pro	Tone-mapping dinamik; ST2094-40 menggunakan metadata HDR10+ apabila ada
Linear / Gamma / Clip / None	CPU · Pro	Laluan diagnostik atau gred manual, bukan untuk kegunaan umum

Penyelesaian masalah

Panel System adalah perhentian pertama — ia melaporkan dengan tepat apa yang dikesan sebelum anda melaporkan ini sebagai pepijat.

Pilihan BT.2390 (GPU) kelabu — tiada peranti yang menyokong Vulkan dikesan; gunakan sebaliknya curve FFmpeg standard.
Backend HandBrakeCLI hilang — ia adalah pilihan dan hanya muncul sebaik sahaja HandBrakeCLI dijumpai dalam PATH anda.
Penukaran seolah-olah mengambil alih keseluruhan mesin — turunkan keutamaan proses kepada Efficiency.

Tukar mana-mana skrin kepada skrin HDR. Cukup mudah untuk nenek gunakan.