From patchwork Fri Oct 25 08:56:16 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Ricardo Ribalda Delgado X-Patchwork-Id: 11211747 Return-Path: Received: from mail.kernel.org (pdx-korg-mail-1.web.codeaurora.org [172.30.200.123]) by pdx-korg-patchwork-2.web.codeaurora.org (Postfix) with ESMTP id D0128112C for ; Fri, 25 Oct 2019 08:56:37 +0000 (UTC) Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by mail.kernel.org (Postfix) with ESMTP id AD42021D71 for ; Fri, 25 Oct 2019 08:56:37 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=default; t=1571993797; bh=oLwgegf6Q1ChDQaB79wa7vkl0pQBYZfYxrtb0pZ5Tck=; h=From:To:Cc:Subject:Date:List-ID:From; b=lKWEjSstv7U6bW5OeTmZAUcy+AodMWSNM5fUQNHXsMw7W4P2Cd0lWOdIoPL8Taofa u/dNjCdeLj8ABHdLnBGeoDgjPCvo1a6p0u7tCGewQ2UprMoS537azL5eLpiMdCSETH 1V8qRFyNCR8NmCnNdKUuinYjl5U70AeI04ISrcj0= Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S2438041AbfJYI4Z (ORCPT ); Fri, 25 Oct 2019 04:56:25 -0400 Received: from mail-lf1-f66.google.com ([209.85.167.66]:42962 "EHLO mail-lf1-f66.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S2393107AbfJYI4Z (ORCPT ); Fri, 25 Oct 2019 04:56:25 -0400 Received: by mail-lf1-f66.google.com with SMTP id z12so1068731lfj.9; Fri, 25 Oct 2019 01:56:23 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:date:message-id:mime-version :content-transfer-encoding; bh=/pf+TC3UkQxsm1lp9DN6oiz74VjHhrWP2wdjdY3KIeQ=; b=dg6Z2mgI4LM/ByPz6/hvLIbxlEydulkdYd2ve9gY/A6Tmp6vVaR6BEcmtBNXQcDT71 G4s9uXxSlqcITNWQ9jMxcKOvlvbpRzeE9MjIXP2lXijEsNtKG9mftIxNI0NadRIARYGI zIdlU/e5+a1xBY/oF+WMXcthR5BLb8/riDwH0/sa3doTYewHNQjHAZc4fVIGxXXmVUPA ILxDJaaXfdH752Li7+fgLDW8U7nTkue7BRtZWwzTki+1M2fGpPLuidhOsYKINBujv4hf mb7PMaORdo3HTmIZQ0kEzDh68gBMl+lzIw29JX2hAFyflzeISc6Wb1/LrflpqeSxvOZ9 rGgw== X-Gm-Message-State: APjAAAWatGy0gEf8CyZfCYolDP5ii+EHEqJIibJdkGAfeGXBQZPaIWwj /hi/XbsvLZOkYp09YpMNwYA= X-Google-Smtp-Source: APXvYqwCbByrEVJHOFUhMkGMI4Ct8W/vGu0UmSOp0hYtipIF4X5VpfmE5dL3HKd/mfD78CTGMsgwFQ== X-Received: by 2002:a19:ad4c:: with SMTP id s12mr1950403lfd.49.1571993782847; Fri, 25 Oct 2019 01:56:22 -0700 (PDT) Received: from neopili.qtec.com (cpe.xe-3-0-1-778.vbrnqe10.dk.customer.tdc.net. [80.197.57.18]) by smtp.gmail.com with ESMTPSA id y135sm571393lfa.92.2019.10.25.01.56.21 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 25 Oct 2019 01:56:21 -0700 (PDT) From: Ricardo Ribalda Delgado To: Sakari Ailus , Hans Verkuil , linux-media , LKML Cc: Ricardo Ribalda Delgado Subject: [PATCH v3] Documentation: media: *_DEFAULT targets for subdevs Date: Fri, 25 Oct 2019 10:56:16 +0200 Message-Id: <20191025085617.23132-1-ribalda@kernel.org> X-Mailer: git-send-email 2.23.0 MIME-Version: 1.0 Sender: linux-media-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-media@vger.kernel.org Some sensors have optical blanking areas, this is, pixels that are painted and do not account for light, only noise. These special pixels are very useful for calibrating the sensor, but should not be displayed on a DEFAULT target. Acked-by: Sakari Ailus Signed-off-by: Ricardo Ribalda Delgado --- Documentation/media/uapi/v4l/v4l2-selection-targets.rst | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/Documentation/media/uapi/v4l/v4l2-selection-targets.rst b/Documentation/media/uapi/v4l/v4l2-selection-targets.rst index f74f239b0510..a69571308a45 100644 --- a/Documentation/media/uapi/v4l/v4l2-selection-targets.rst +++ b/Documentation/media/uapi/v4l/v4l2-selection-targets.rst @@ -38,8 +38,10 @@ of the two interfaces they are used. * - ``V4L2_SEL_TGT_CROP_DEFAULT`` - 0x0001 - Suggested cropping rectangle that covers the "whole picture". + This includes only active pixels and excludes other non-active + pixels such as black pixels. + - Yes - Yes - - No * - ``V4L2_SEL_TGT_CROP_BOUNDS`` - 0x0002 - Bounds of the crop rectangle. All valid crop rectangles fit inside @@ -60,8 +62,8 @@ of the two interfaces they are used. * - ``V4L2_SEL_TGT_COMPOSE_DEFAULT`` - 0x0101 - Suggested composition rectangle that covers the "whole picture". - - Yes - No + - Yes * - ``V4L2_SEL_TGT_COMPOSE_BOUNDS`` - 0x0102 - Bounds of the compose rectangle. All valid compose rectangles fit