이 페이지에서

QWaylandXdgOutputV1 Class

컴포지터 내의 디스플레이를 나타냅니다. 더 보기...

헤더: #include <QWaylandXdgOutputV1>
CMake: find_package(Qt6 REQUIRED COMPONENTS WaylandCompositor)
target_link_libraries(mytarget PRIVATE Qt6::WaylandCompositor)
qmake: QT += waylandcompositor
QML에서: XdgOutputV1
상속: QObject

속성

공개 함수

QString description() const
QRect logicalGeometry() const
QPoint logicalPosition() const
QSize logicalSize() const
QString name() const
QWaylandOutput *output() const
void setDescription(const QString &name)
void setLogicalPosition(const QPoint &position)
void setLogicalSize(const QSize &size)
void setName(const QString &name)

신호

상세 설명

속성 설명

description : QString

이 속성은 이 출력에 대한 설명을 포함합니다.

설명에 대한 규칙은 정의되어 있지 않습니다.

초기화 후 이 속성을 변경해도 적용되지 않습니다.

액세스 함수:

QString description() const
void setDescription(const QString &name)

알림 신호:

void descriptionChanged()

[read-only] logicalGeometry : QRect

이 속성은 전역 컴포지터 공간에서 출력의 위치와 크기를 나타냅니다. 이는 논리적 위치와 논리적 크기를 결합한 것입니다.

액세스 함수:

QRect logicalGeometry() const

알림 신호:

void logicalGeometryChanged()

QWaylandXdgOutputV1::logicalPosition 및 QWaylandXdgOutputV1::logicalSize도 참조하십시오 .

logicalPosition : QPoint

이 속성은 전역 컴포지터 공간 내의 출력 좌표를 저장합니다.

기본값은 0, 0입니다.

액세스 함수:

QPoint logicalPosition() const
void setLogicalPosition(const QPoint &position)

알림 신호:

void logicalPositionChanged()

logicalSize : QSize

이 속성은 전역 컴포지터 공간에서 출력의 크기를 지정합니다.

기본값은 -1,-1이며, 이는 유효하지 않습니다.

이는 물리적 크기가 아닌 논리적 크기임을 유의하십시오. 예를 들어, WaylandOutput 모드에서 해상도가 3840x2160이고 배율 계수가 2인 경우:

  • 표면 버퍼를 스케일링하지 않는 컴포지터는 3840x2160의 논리적 크기를 보고합니다.
  • 표면 버퍼를 자동으로 스케일링하는 컴포지터는 1920x1080의 논리적 크기를 보고합니다.
  • 1.5의 분수 스케일링 계수를 사용하는 컴포지터는 2560x1620의 논리적 크기를 보고합니다.

액세스 함수:

QSize logicalSize() const
void setLogicalSize(const QSize &size)

알림 신호:

void logicalSizeChanged()

name : QString

이 속성은 해당 출력의 이름을 저장합니다.

이름 지정 규칙은 컴포지터에 따라 정의되지만, 영문자와 숫자, 하이픈("-")으로만 구성되어야 합니다. 각 이름은 고유하며, 동일한 하드웨어 및 소프트웨어 구성을 사용하는 세션 간에도 일관되게 유지됩니다.

이름의 예로는 "HDMI-A-1", "WL-1", "X11-1" 등이 있습니다. 그러나 이름이 기본 기술을 반영한다고 가정해서는 안 됩니다.

초기화 후 이 속성을 변경해도 적용되지 않습니다.

액세스 함수:

QString name() const
void setName(const QString &name)

알림 신호:

void nameChanged()

[read-only] output : QWaylandOutput*

이 속성은 이 QWaylandXdgOutputV1 와 연관된 QWaylandOutput 를 포함합니다.

액세스 함수:

QWaylandOutput *output() const

알림 신호:

void outputChanged()

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