이 페이지에서

SCurveTonemap QML Type

톤 매핑 효과. 더 보기...

Import Statement: import QtQuick3D.Effects 6.12
Status: Deprecated since 6.5

이 유형은 QtQuick3D.Effects 6.5부터 더 이상 권장되지 않습니다. 새로운 코드에서는 이를 사용하지 않는 것을 강력히 권장합니다.

속성

상세 설명

대신 ExtendedSceneEnvironment 를 사용하십시오.

경고: QtQuick3D.Effects에 포함된모든 미리 만들어진 독립형 효과는 Qt 6.5부터 더 이상 사용되지 않는 것으로 간주됩니다. 톤 매핑을 제어하려면 대신 ExtendedSceneEnvironment 을 사용하십시오.

S-커브 톤맵 효과를 보여주는 장면 비교

SCurveTonemap 이펙트는 씬 내 각 픽셀의 휘도를 S자형 곡선에 따라 매핑합니다:

S-커브 톤맵 함수를 나타내는 그래프

이 곡선은 세 부분으로 구성됩니다. 토(toe) 영역은 그림자를 결정하며, toeSlope 및 toeEmphasis 에 의해 제어됩니다. 중간 부분은 전체적인 대비를 결정하며, contrastBoost 을 통해 변경됩니다. 숄더(shoulder) 영역은 하이라이트를 결정하며, shoulderSlope 및 shoulderEmphasis 에 의해 제어됩니다.

속성 설명서

contrastBoost : real

톤맵의 전체적인 명암 대비를 높이거나 낮춥니다. 이는 S-커브의 중간 부분의 기울기를 변경합니다.

설정 범위는 [-1...2] 입니다. 기본값은 0 입니다.

exposureValue : real

톤맵 효과의 노출을 지정합니다. 이 값은 ‘ useExposure ’이 ‘ true ’인 경우에만 사용됩니다. 범위는 ‘ [0.01...16] ’입니다. 기본값은 ‘ 1 ’입니다.

gammaValue : real

톤맵 효과에 사용할 감마 값을 설정합니다. 적절한 값은 [0.1...8] 범위 내에 있습니다. 기본값은 2.2 입니다.

saturationLevel : real

톤맵 효과의 전반적인 채도 수준을 설정합니다. 범위는 [0...2] 이며, 0 는 완전한 그레이스케일이고 2 는 채도가 매우 과한 상태입니다. 기본값은 1 입니다.

shoulderEmphasis : real

S-커브의 어깨 부분 모양을 수정합니다. 범위는 [-1...1] 입니다. 기본값은 0 입니다.

shoulderSlope도 참조하십시오 .

shoulderSlope : real

S-커브의 숄더 부분의 기울기를 설정합니다. 숄더는 하이라이트의 대비가 약해지는 지점을 정의합니다.

범위는 [0...3] 입니다. 기본값은 1 입니다.

shoulderEmphasis도 참조하십시오 .

toeEmphasis : real

S-커브의 끝부분 모양을 수정합니다. 설정 범위는 [-1...1] 입니다. 기본값은 0 입니다.

toeSlope도 참조하십시오 .

toeSlope : real

S-커브의 토 ( toe ) 부분의 기울기를 설정합니다. 토는 그림자의 대비가 떨어지기 시작하는 지점을 정의합니다.

범위는 [0...3] 입니다. 기본값은 1 입니다.

toeEmphasis도 참조하십시오 .

useExposure : bool

이 설정은 이펙트가 휘도 계산 시 exposureValue 대신 whitePoint 을 사용하도록 합니다. 기본값은 false 입니다.

whitePoint : real

톤맵의 백색점을 설정합니다. 이 값은 ` useExposure `가 ` false`인 경우에만 사용됩니다. 범위는 ` [0.01...128]`입니다. 기본값은 ` 1`입니다.

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.