ENUM DRM_CONNECTOR_COLOR_FORMAT(9)

okay so bestie, welcome to enum drm_connector_color_format(9) from the Kernel API Manual — it's giving Connector Color Format Request and honestly it's lowkey iconic 💅✨

🌸 NAME

enum drm_connector_color_format — Connector Color Format Request 🎀

✨ SYNOPSIS

bestie, here's the whole enum lineup, no cap:

enum drm_connector_color_format {
    DRM_CONNECTOR_COLOR_FORMAT_AUTO ,
    DRM_CONNECTOR_COLOR_FORMAT_RGB444 ,
    DRM_CONNECTOR_COLOR_FORMAT_YCBCR444 ,
    DRM_CONNECTOR_COLOR_FORMAT_YCBCR422 ,
    DRM_CONNECTOR_COLOR_FORMAT_YCBCR420 ,
    DRM_CONNECTOR_COLOR_FORMAT_COUNT

};

🎀 Constants

• DRM_CONNECTOR_COLOR_FORMAT_AUTO — The driver or display protocol helpers should pick a suitable color format. All implementations of a specific display protocol must behave the same way with "AUTO", but different display protocols do not necessarily have the same "AUTO" semantics.

For HDMI, "AUTO" picks RGB, but falls back to YCbCr 4:2:0 if the bandwidth required for full-scale RGB is not available, or the mode is YCbCr 4:2:0-only, as long as the mode and output both support YCbCr 4:2:0.

For display protocols other than HDMI, the recursive bridge chain format selection picks the first chain of bridge formats that works, as has already been the case before the introduction of the "color format" property. Non-HDMI bridges should therefore either sort their bus output formats by preference, or agree on a unified auto format selection logic that's implemented in a common state helper (like how HDMI does it).

• DRM_CONNECTOR_COLOR_FORMAT_RGB444 — RGB output format. The quantization range depends on the value of the "Broadcast RGB" property if it is present on the connector.
• DRM_CONNECTOR_COLOR_FORMAT_YCBCR444 — YCbCr 4:4:4 output format (ie. not subsampled). Quantization range is "Limited" by default.
• DRM_CONNECTOR_COLOR_FORMAT_YCBCR422 — YCbCr 4:2:2 output format (ie. with horizontal subsampling). Quantization range is "Limited" by default.
• DRM_CONNECTOR_COLOR_FORMAT_YCBCR420 — YCbCr 4:2:0 output format (ie. with horizontal and vertical subsampling). Quantization range is "Limited" by default.
• DRM_CONNECTOR_COLOR_FORMAT_COUNT — Number of valid connector color format values in this enum

💖 Description

This enum, unlike enum drm_output_color_format, is used to specify requests for a specific color format on a connector through the DRM "color format" property. The difference is that it has an "AUTO" value to specify that no specific choice has been made.

👀 SEE ALSO

Kernel file ./include/drm/drm_connector.h — start there, iykyk. Then the whole friend group:

• Kernel file: ./include/drm/drm_connector.h
• enum drm_connector_status(9)
• enum drm_connector_registration_state(9)
• enum drm_connector_tv_mode(9)
• struct drm_scrambling(9)
• struct drm_hdmi_dsc_cap(9)
• struct drm_hdmi_info(9)
• enum drm_link_status(9)
• enum drm_panel_orientation(9)
• enum drm_hdmi_broadcast_rgb(9)
• struct drm_monitor_range_info(9)
• struct drm_luminance_range_info(9)
• enum drm_privacy_screen_status(9)
• enum drm_colorspace(9)
• enum drm_output_color_format(9)
• enum drm_bus_flags(9)
• struct drm_amd_vsdb_info(9)
• struct drm_display_info(9)
• struct drm_connector_tv_margins(9)
• struct drm_tv_connector_state(9)
• struct drm_connector_hdmi_infoframe(9)
• struct drm_connector_state(9)
• struct drm_connector_cec_funcs(9)
• struct drm_connector_infoframe_funcs(9)
• struct drm_connector_hdmi_funcs(9)
• struct drm_connector_funcs(9)
• struct drm_cmdline_mode(9)
• struct drm_connector_hdmi_audio(9)
• struct drm_connector_cec(9)
• struct drm_connector(9)
• drm_connector_lookup(9)
• drm_connector_get(9)
• drm_connector_put(9)
• drm_connector_is_unregistered(9)
• struct drm_tile_group(9)
• struct drm_connector_list_iter(9)
• drm_for_each_connector_iter(9)
• drm_connector_for_each_possible_encoder(9)

💌 cute sign-off time: this page lives under ./include/drm, is dated October 2026, and its footer tag is enum drm_co...color_format(9) — periodt 🫶