이 페이지에서

고급 텍스트 예제

텍스트의 고급 기능을 보여주는 Qt Quick 예시입니다.

너비와 굵기 슬라이더를 통해 텍스트를 레이아웃 경계에 맞게 조정하는 가변 글꼴 데모

전통적으로 폰트 패밀리는 제한된 수의 변형으로 배포되어 왔습니다. 즉, 하드코딩된 굵기, 스타일, 너비(및 이들의 조합)로 구성된 세트로, 이를 독립형 폰트로 선택할 수 있습니다.

가변 글꼴은 이러한 개념을 확장한 것입니다. 글꼴 패밀리의 변형을 독립형 글꼴 파일로 배포하는 대신, 단일 가변 글꼴이 보간을 통해 이러한 변형(및 그 외 다양한 변형)을 생성할 수 있습니다.

이는 폰트 내에서 너비, 경사도 또는 굵기와 같은 속성에 대해 소위 “가변 축”을 정의함으로써 달성됩니다. 사용자는 이러한 축을 따라 미리 설정된 값 중에서 선택하거나, 폰트가 지원하는 범위 내에서 임의의 사용자 지정 값을 설정할 수 있습니다.

이 예제에는 “Georama”라는 가변 글꼴이 포함되어 있습니다(저작권 2020 The Georama Project Authors, OFL 1.1에 따라 라이선스 부여됨). 이 글꼴에는 두 개의 가변 축이 있습니다: 하나는 굵기용이고, 다른 하나는 너비용입니다. 사용자는 이 중 하나를 조작하여 글꼴 디자인에 걸쳐 광범위한 변형을 생성할 수 있습니다.

이 예제는 실제 상황에서 이를 어떻게 활용할 수 있는지 보여줍니다. 예제를 시작하면 텍스트 조각들이 엄격한 레이아웃에 정의된 경계 상자 밖으로 뻗어 나옵니다.

너비와 두께를 조정하기 전, 텍스트가 경계 상자 밖으로 넘쳐나는 현상

너비 및/또는 굵기를 미세하게 조정함으로써, 시각 디자이너는 글꼴 크기를 변경하지 않고도 레이아웃에 정확히 맞는 다양한 글꼴 변형을 얻을 수 있습니다.

너비와 두께 조정 후 경계 상자 내에 텍스트 맞추기

이 예제에서는 글꼴의 두 가변 축 각각에 슬라이더를 할당합니다. 그런 다음 가변 축의 값을 슬라이더에 바인딩하여, 사용자가 값을 변경할 때 글꼴이 자동으로 업데이트되도록 합니다.

            font.variableAxes: {
                "wdth": widthSlider.value,
                "wght": weightSlider.value
            }

가변 축은 4자 태그로 지정됩니다. “wdth”나 “wght”와 같은 일부 태그는 관례에 따라 특정 글꼴 속성에 매핑됩니다(이 경우 각각 “width”와 “weight”에 해당). 하지만 4자 태그로 표기되는 한, 폰트는 어떤 축이든 지원할 수 있습니다. 폰트가 지원하는 축에 대한 정보는 대개 파일 이름에 포함되어 있습니다.

예제 실행

다음 경로에서 예제를 실행할 수 있습니다.

code.qt.io의 예제 프로젝트

© 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.