mpv-player / mpv-player/mpv

Letterboxing renders brighter than absolute black with `target-colorspace-hint-mode=source`

Open
#17,073 1 comment 1 reaction 0 assignees View on GitHub

Nobody has claimed this yet.

os:win
Dominant language
C
Stars
37k
Forks
3.5k
Avg merge
1d 10h
Merged PRs (30d)
22

Description

mpv Information
mpv v0.40.0-402-gaa2dad035 Copyright © 2000-2025 mpv/MPlayer/mplayer2 projects
 built on Oct 25 2025 00:27:42
libplacebo version: v7.357.0 (v7.351.0-87-g9bffcaf-dirty)
FFmpeg version: N-121522-gd01608e02
FFmpeg library versions:
   libavcodec      62.16.100
   libavdevice     62.2.100
   libavfilter     11.9.100
   libavformat     62.6.101
   libavutil       60.14.100
   libswresample   6.2.100
   libswscale      9.3.100
Other Information
- Windows version: [Version 10.0.26100.6584]
- GPU model, driver and version:
- Source of mpv: github
- Latest known working version: built on Apr 3 2025 05:11:10
libplacebo version: v7.350.0 (v7.349.0-64-gdd16ddf-dirty)
- Issue started after the following happened: target-colorspace-hint-mode=source became necessary to achieve the same behavior as before with target-colorspace-hint=yes, particularly making the display and mpv instance run native PQ videos as HDR.
Reproduction Steps

gpu-api=vulkan
target-colorspace-hint=yes
target-colorspace-hint-mode=source

run HDR content.

Known fix: add target-contrast=inf

Expected Behavior

Blank area around content should appear completely black.

Actual Behavior

When using target-colorspace-hint-mode=source and running HDR content, area around content renders as near-black, not absolute black.
target-contrast=inf remedies this issue.

Log File

output.txt

Sample Files

No response

I carefully read all instruction and confirm that I did the following:
  • I tested with the latest mpv version to validate that the issue is not already fixed.
  • I provided all required information including system and mpv version.
  • I produced the log file with the exact same set of files, parameters, and conditions used in "Reproduction Steps", with the addition of --log-file=output.txt.
  • I produced the log file while the behaviors described in "Actual Behavior" were actively observed.
  • I attached the full, untruncated log file.
  • I attached the backtrace in the case of a crash.

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Reproduce the issue with gpu-api=vulkan, target-colorspace-hint=yes, and target-colorspace-hint-mode=source while running HDR content, then inspect output.txt. Compare the letterboxing with and without target-contrast=inf; done means the blank area is absolute black without requiring that workaround.

Written by the indexing model from the issue text.

Assessment

Tech stack
c
Domain
computer-graphics
Issue type
Bug
Difficulty
4/5
Estimated time
3-5 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.