From patchwork Tue Feb 28 12:32:04 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: Simon Ser X-Patchwork-Id: 13154860 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from gabe.freedesktop.org (gabe.freedesktop.org [131.252.210.177]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.lore.kernel.org (Postfix) with ESMTPS id EE193C64EC7 for ; Tue, 28 Feb 2023 12:32:11 +0000 (UTC) Received: from gabe.freedesktop.org (localhost [127.0.0.1]) by gabe.freedesktop.org (Postfix) with ESMTP id 5E26610E1F9; Tue, 28 Feb 2023 12:32:11 +0000 (UTC) Received: from mail-4323.proton.ch (mail-4323.proton.ch [185.70.43.23]) by gabe.freedesktop.org (Postfix) with ESMTPS id 811FE10E1F9 for ; Tue, 28 Feb 2023 12:32:09 +0000 (UTC) Date: Tue, 28 Feb 2023 12:32:04 +0000 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=emersion.fr; s=protonmail; t=1677587527; x=1677846727; bh=DTLVtJSoFye2hWPJysWIBXFP4OmOyDMN752/zyYO7QM=; h=Date:To:From:Cc:Subject:Message-ID:Feedback-ID:From:To:Cc:Date: Subject:Reply-To:Feedback-ID:Message-ID:BIMI-Selector; b=wolN+blt17QjALM6CVnAs70E2YNVv8XWw2EM2waGoVVAjgyqdoVJU5oLNZIrUDK4c ep9vLz5JTW3lNxYOI7tcq3+JMfT3gTGA2rR5CUGO057Nya4wUklM5KBQqszoaSKPuo HsL9iQNC5c35LDUaabWXvl8NJqomiPkILF6L1YmaEdsoiVGQt5wkGOly7dbWk6V4YE jmbFsIKBy9Tcg6FGpwSp7lvS81NHB7dnz1Qxa7RgsDKIFttIs7sODSVq1XdHklEKMx 6A3jXvC9rjtQ6V4k7iConr1ZMVtT1E5Dyb2Cs6dWmvbEdih4PWWdyoYVf0U6nSKVk+ t9bDnGNm24QfA== To: dri-devel@lists.freedesktop.org From: Simon Ser Subject: [PATCH v2] drm: document connector margin properties Message-ID: <20230228123156.175973-1-contact@emersion.fr> Feedback-ID: 1358184:user:proton MIME-Version: 1.0 X-BeenThere: dri-devel@lists.freedesktop.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Direct Rendering Infrastructure - Development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: Mateusz Kwiatkowski , Pekka Paalanen , =?utf-8?q?Noralf_Tr=C3=B8nnes?= , Maxime Ripard Errors-To: dri-devel-bounces@lists.freedesktop.org Sender: "dri-devel" Add docs for "{left,right,top,bottom} margin" properties. v2: - Mention the purpose: mitigate underscan on TVs - Move out of analog TV section into standard props (Pekka) - Mention HDMI AVI InfoFrames (Pekka, Ville) Signed-off-by: Simon Ser Cc: Maxime Ripard Cc: Daniel Vetter Cc: Pekka Paalanen Cc: Noralf Trønnes Cc: Mateusz Kwiatkowski Cc: Ville Syrjälä Acked-by: Pekka Paalanen --- drivers/gpu/drm/drm_connector.c | 18 ++++++++++++++---- 1 file changed, 14 insertions(+), 4 deletions(-) diff --git a/drivers/gpu/drm/drm_connector.c b/drivers/gpu/drm/drm_connector.c index ffd65eddce42..a180f541736a 100644 --- a/drivers/gpu/drm/drm_connector.c +++ b/drivers/gpu/drm/drm_connector.c @@ -1446,6 +1446,20 @@ static const struct drm_prop_enum_list dp_colorspaces[] = { * a firmware handled hotkey. Therefor userspace must not include the * privacy-screen sw-state in an atomic commit unless it wants to change * its value. + * + * left margin, right margin, top margin, bottom margin: + * Add margins to the connector's viewport. This is typically used to + * mitigate underscan on TVs. + * + * The value is the size in pixels of the black border which will be + * added. The attached CRTC's content will be scaled to fill the whole + * area inside the margin. + * + * The margins configuration might be sent to the sink, e.g. via HDMI AVI + * InfoFrames. + * + * Drivers can set up these properties by calling + * drm_mode_create_tv_margin_properties(). */ int drm_connector_create_standard_properties(struct drm_device *dev) @@ -1590,10 +1604,6 @@ EXPORT_SYMBOL(drm_connector_attach_dp_subconnector_property); /* * TODO: Document the properties: - * - left margin - * - right margin - * - top margin - * - bottom margin * - brightness * - contrast * - flicker reduction