QRhiTextureCopyDescription Class
텍스처 간 복사 작업을 설명합니다. 더 보기...
| 헤더: | #include <rhi/qrhi.h> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS GuiPrivate) target_link_libraries(mytarget PRIVATE Qt6::GuiPrivate) |
| qmake: | QT += gui-private |
| 다음 버전부터: | Qt 6.6부터 |
공개 함수
| QRhiTextureCopyDescription() | |
| int | destinationLayer() const |
| int | destinationLevel() const |
| QPoint | destinationTopLeft() const |
| QSize | pixelSize() const |
| void | setDestinationLayer(int layer) |
| void | setDestinationLevel(int level) |
| void | setDestinationTopLeft(const QPoint &p) |
| void | setPixelSize(const QSize &sz) |
| void | setSourceLayer(int layer) |
| void | setSourceLevel(int level) |
| void | setSourceTopLeft(const QPoint &p) |
| int | sourceLayer() const |
| int | sourceLevel() const |
| QPoint | sourceTopLeft() const |
상세 설명
빈 ` pixelSize()`는 전체 서브리소스를 복사해야 함을 나타냅니다. 따라서 기본 생성된 복사 설명은 레이어 0의 레벨 0에 있는 전체 서브리소스를 복사하게 됩니다.
참고: 소스 텍스처는 QRhiTexture::UsedAsTransferSource 를 사용하여 생성되어야 합니다.
참고: pixelSize(), sourceTopLeft() 및 destinationTopLeft()로 정의된 소스 및 대상사각형은 각각 소스 및 대상 텍스처에 맞아야 합니다. 그렇지 않은 경우 동작은 정의되지 않습니다.
큐브맵, 3D 텍스처 및 텍스처 배열의 경우, 한 번에 하나의 면 또는 슬라이스를 복사할 수 있습니다. 해당 면 또는 슬라이스는 소스 및 대상 레이어 인덱스로 지정됩니다. 밉맵 텍스처의 경우, 한 번에 하나의 밉 레벨을 복사할 수 있습니다. 소스 및 대상 레이어와 밉 레벨 인덱스는 서로 다를 수 있지만, 범위를 벗어난 복사가 발생하지 않도록 크기와 위치를 신중하게 제어해야 합니다. 범위를 벗어난 복사가 발생하면 동작이 정의되지 않습니다.
참고: 이 함수는 호환성 보장이 제한된 RHI API입니다. 자세한 내용은 QRhi 를 참조하십시오.
멤버 함수 문서
[constexpr noexcept default] QRhiTextureCopyDescription::QRhiTextureCopyDescription()
빈 텍스처 복사 설명을 생성합니다.
int QRhiTextureCopyDescription::destinationLayer() const
대상 배열 레이어(큐브맵 면 또는 배열 레이어 인덱스)를 반환합니다. 기본값은 0입니다.
setDestinationLayer()도 참조하십시오 .
int QRhiTextureCopyDescription::destinationLevel() const
목적지 밉 레벨을 반환합니다. 기본값은 0입니다.
setDestinationLevel()도 참조하십시오 .
QPoint QRhiTextureCopyDescription::destinationTopLeft() const
목적지의 왼쪽 상단 좌표를 픽셀 단위로 반환합니다. 기본값은 (0, 0)입니다.
setDestinationTopLeft()도 참조하십시오 .
QSize QRhiTextureCopyDescription::pixelSize() const
복사할 영역의 크기를 반환합니다.
참고: pixelSize()가 비어 있으면 전체 서브리소스가 복사됨을 의미합니다. 따라서 기본 생성된 복사 설명은 레이어 0의 레벨 0에 있는 전체 서브리소스를 복사하게 됩니다.
setPixelSize()도 참조하십시오 .
void QRhiTextureCopyDescription::setDestinationLayer(int layer)
layer 의 대상 배열을 설정합니다.
destinationLayer()도 참조하십시오 .
void QRhiTextureCopyDescription::setDestinationLevel(int level)
대상 미프 level 를 설정합니다.
destinationLevel()도 참조하십시오 .
void QRhiTextureCopyDescription::setDestinationTopLeft(const QPoint &p)
p 의 왼쪽 상단 위치를 설정합니다.
destinationTopLeft()도 참조하십시오 .
void QRhiTextureCopyDescription::setPixelSize(const QSize &sz)
sz 로 복사할 영역의 크기를 설정합니다.
pixelSize()도 참조하십시오 .
void QRhiTextureCopyDescription::setSourceLayer(int layer)
layer 의 소스 배열을 설정합니다.
sourceLayer()도 참조하십시오 .
void QRhiTextureCopyDescription::setSourceLevel(int level)
소스 밉 level 을 설정합니다.
sourceLevel()도 참조하십시오 .
void QRhiTextureCopyDescription::setSourceTopLeft(const QPoint &p)
소스의 왼쪽 상단 위치를 p 로 설정합니다.
sourceTopLeft()도 참조하십시오 .
int QRhiTextureCopyDescription::sourceLayer() const
소스 배열 레이어(큐브맵 면 또는 배열 레이어 인덱스)를 반환합니다. 기본값은 0입니다.
setSourceLayer()도 참조하십시오 .
int QRhiTextureCopyDescription::sourceLevel() const
소스 밉 레벨을 반환합니다. 기본값은 0입니다.
setSourceLevel()도 참조하십시오 .
QPoint QRhiTextureCopyDescription::sourceTopLeft() const
소스의 왼쪽 상단 위치(픽셀 단위)를 반환합니다. 기본값은 (0, 0)입니다.
setSourceTopLeft()도 참조하십시오 .
© 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.
