WaylandSurface QML Type (Uncreatable)
출력 장치상의 직사각형 영역을 나타냅니다. 더 보기...
| Import Statement: | import QtWayland.Compositor |
| In C++: | QWaylandSurface |
참고: 이 유형은 생성할 수 없는 유형입니다. QML에서 인스턴스화할 수 없습니다.
속성
- bufferScale : size
- bufferSize : size
- client : WaylandClient
- contentOrientation : enum
- cursorSurface : bool
- destinationSize : size
- hasContent : bool
- inhibitsIdle : bool
- isOpaque : bool
(since 6.4) - origin : enum
- sourceGeometry : rect
- useTextureAlpha : bool
신호
- childAdded(WaylandSurface child)
- void dragStarted(WaylandDrag drag)
- surfaceDestroyed()
방법
- void destroy()
- void initialize(WaylandCompositor compositor, WaylandClient client, int id, int version)
- bool isDestroyed()
상세 설명
이 유형은 출력 장치에 표시되는 직사각형 픽셀 영역을 캡슐화합니다. 이는 Wayland 프로토콜의 wl_surface 인터페이스에 해당합니다.
속성 설명
bufferScale : size [read-only]
이 속성은 WaylandSurface 의 버퍼 배율을 저장합니다. 버퍼 배율을 사용하면 클라이언트가 고해상도 출력에 사용할 고해상도 버퍼 데이터를 제공할 수 있습니다.
bufferSize : size [read-only]
이 속성은 이 WaylandSurface 의 현재 버퍼 크기를 표면 좌표가 아닌 픽셀 단위로 저장합니다.
표면 좌표계의 크기를 확인하려면 대신 ` destinationSize `를 사용하십시오.
destinationSize 및 bufferScale도 참조하십시오 .
client : WaylandClient [read-only]
이 속성은 WaylandSurface 을 사용하는 클라이언트를 보관합니다.
contentOrientation : enum [read-only]
이 속성은 WaylandSurface 의 콘텐츠 방향을 나타냅니다.
WaylandOutput.transform도 참조하십시오 .
cursorSurface : bool
이 속성은 WaylandSurface 가 커서 표면인지 여부와 관계없이 성립합니다.
destinationSize : size [read-only]
이 속성은 표면 좌표계에서 이 WaylandSurface 의 크기를 나타냅니다.
bufferScale 및 bufferSize도 참조하십시오 .
hasContent : bool [read-only]
이 속성은 표면에 현재 확정된, null이 아닌 버퍼가 있는지 여부를 나타냅니다.
WaylandSurface::bufferSize도 참조하십시오 .
inhibitsIdle : bool [read-only]
이 속성은 해당 표면이 화면 어둡게 하기, 화면 잠금, 화면 보호기 등 컴포지터의 유휴 동작을 억제하도록 설계되었는지 여부를 나타냅니다.
IdleInhibitManagerV1도 참조하십시오 .
isOpaque : bool [read-only, since 6.4]
이 속성은 클라이언트가 set_opaque_region 요청을 통해 보고한 대로 표면이 완전히 불투명한지 여부와 관계없이 유지됩니다.
이 속성은 Qt 6.4에서 도입되었습니다.
origin : enum [read-only]
이 속성은 ‘ WaylandSurface ’의 버퍼 원점을 저장하며, 표면에 버퍼가 없는 경우에는 ‘ WaylandSurface.OriginTopLeft’를 저장합니다.
다음과 같은 값을 가질 수 있습니다:
- WaylandSurface.OriginTopLeft: 원점은 버퍼의 왼쪽 상단 모서리입니다.
- WaylandSurface.OriginBottomLeft: 원점이 버퍼의 왼쪽 하단 모서리입니다.
sourceGeometry : rect [read-only]
이 속성은 화면에 렌더링되어야 하는 첨부된 Wayland 버퍼의 일부를 나타냅니다. 좌표는 버퍼의 모서리를 기준으로 하며, bufferScale 에 따라 스케일링됩니다.
bufferScale, bufferSize 및 destinationSize도 참조하십시오 .
useTextureAlpha : bool [default: true]
이 속성은 표면이 블렌딩에 텍스처 알파를 사용할지 여부를 지정합니다.
true 인 경우, 서피스의 알파 채널이 블렌딩에 사용되며, false 인 경우, 서피스는 불투명하게 처리됩니다.
Signal 문서
childAdded(WaylandSurface child)
이 신호는 wl_subsurface( child)가 표면에 추가되었을 때 발생합니다.
참고: 해당 핸들러는 onChildAdded 입니다.
void dragStarted(WaylandDrag drag)
이 신호는 drag 가 이 표면에서 시작되었을 때 전송됩니다.
참고: 해당 핸들러는 onDragStarted 입니다.
surfaceDestroyed()
이 신호는 해당 wl_surface가 소멸될 때 발생합니다.
참고: 해당 핸들러는 onSurfaceDestroyed 입니다.
메서드 문서
void destroy()
WaylandSurface 를 삭제합니다.
void initialize(WaylandCompositor compositor, WaylandClient client, int id, int version)
지정된 ` compositor ` 및 ` client`, 그리고 ` id ` 및 ` version`을 사용하여 ` WaylandSurface `을 초기화합니다.
bool isDestroyed()
WaylandSurface 가 소멸된 경우 ` true `을 반환합니다. 그렇지 않은 경우 ` false`을 반환합니다.
© 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.