QRhiTextureCopyDescription Class
텍스처 간 복사 작업에 대해 설명합니다. 더 보기...
| Header: | #include <rhi/qrhi.h> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Gui)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] 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
복사할 영역의 크기를 반환합니다.
참고: 픽셀사이즈()가 비어 있으면 전체 하위 리소스를 복사한다는 의미입니다. 따라서 기본적으로 구성된 복사 설명은 레이어 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()도 참조하세요 .
© 2025 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.
