QOpenGLTexture Class

// Prepare texture
QOpenGLTexture *texture = new QOpenGLTexture(QImage(fileName).mirrored());
texture->setMinificationFilter(QOpenGLTexture::LinearMipMapLinear);
texture->setMagnificationFilter(QOpenGLTexture::Linear);
...
// Render with texture
texture->bind();
glDrawArrays(...);

멤버 함수 문서

[explicit] QOpenGLTexture::QOpenGLTexture(QOpenGLTexture::Target target)

나중에 target 에 바인딩할 수 있는 QOpenGLTexture 객체를 생성합니다.

이것은 기본 OpenGL 텍스처 객체를 생성하지 않습니다. 따라서 이 생성자를 사용한 구성에는 유효한 현재 OpenGL 컨텍스트가 필요하지 않습니다.

[explicit] QOpenGLTexture::QOpenGLTexture(const QImage &image, QOpenGLTexture::MipMapGeneration genMipMaps = GenerateMipMaps)

나중에 2D 텍스처 대상에 바인딩할 수 있고 image 에 포함된 픽셀 데이터를 포함하는 QOpenGLTexture 객체를 생성합니다. 밉맵 체인을 생성하려면 genMipMaps 을 true 로 설정합니다(기본값입니다).

이렇게 하면 기본 OpenGL 텍스처 객체가 생성됩니다. 따라서 이 생성자를 사용하여 구성하려면 유효한 현재 OpenGL 컨텍스트가 필요합니다.

void QOpenGLTexture::allocateStorage()

형식, 치수, 밉맵 레벨, 배열 레이어 및 큐브맵 면을 고려하여 이 텍스처 오브젝트에 대한 서버 측 스토리지를 할당합니다.

저장소가 할당되면 더 이상 이러한 속성을 변경할 수 없습니다.

지원되는 경우 QOpenGLTexture 불변 텍스처 저장소를 사용합니다.

텍스처에 저장소가 할당되면 setData() 오버로드 중 하나를 통해 픽셀 데이터를 업로드할 수 있습니다.

isStorageAllocated() 및 setData()도 참조하세요 .

void QOpenGLTexture::allocateStorage(QOpenGLTexture::PixelFormat pixelFormat, QOpenGLTexture::PixelType pixelType)

형식, 치수, 밉맵 레벨, 배열 레이어 및 큐브맵 면을 고려하여 이 텍스처 오브젝트에 대한 서버 측 스토리지를 할당합니다.

저장소가 할당되면 더 이상 이러한 프로퍼티를 변경할 수 없습니다.

지원되는 경우 QOpenGLTexture 불변 텍스처 스토리지를 사용합니다. 그러나 불변 텍스처 스토리지를 사용할 수 없는 경우 지정된 pixelFormat 및 pixelType 을 사용하여 변경 가능한 스토리지를 할당합니다. 특정 OpenGL 구현(특히 OpenGL ES 2)에서는 형식과 후속 setData() 호출에 전달되는 유형이 완벽하게 일치해야 합니다.

텍스처에 대한 스토리지가 할당되면 setData() 오버로드 중 하나를 통해 픽셀 데이터를 업로드할 수 있습니다.

isStorageAllocated() 및 setData()도 참조하세요 .

void QOpenGLTexture::bind()

이 텍스처를 렌더링할 준비가 된 현재 활성 텍스처 유닛에 바인딩합니다. 구현은 사용 가능한 경우 EXT_direct_state_access 확장자를 사용하고 그렇지 않은 경우 시뮬레이션하므로 QOpenGLTexture 객체를 수정하기 위해 바인딩할 필요가 없습니다.

release()도 참조하세요 .

void QOpenGLTexture::bind(uint unit, QOpenGLTexture::TextureUnitReset reset = DontResetTextureUnit)

이 텍스처를 렌더링할 준비가 된 텍스처 유닛 unit 에 바인딩합니다. 이 구현은 사용 가능한 경우 EXT_direct_state_access 확장자를 사용하고 그렇지 않은 경우 시뮬레이션하므로 QOpenGLTexture 오브젝트를 수정하기 위해 바인딩할 필요가 없습니다.

파라미터 reset 가 true 인 경우 이 함수는 입력 시 활성화된 텍스처 유닛으로 활성 유닛을 복원합니다.

release()도 참조하세요 .

QColor QOpenGLTexture::borderColor() const

이 텍스처의 borderColor를 반환합니다.

setBorderColor()도 참조하세요 .

void QOpenGLTexture::borderColor(float *border) const

border 이 가리키는 배열의 처음 네 요소에 텍스처 테두리 색상을 씁니다.

setBorderColor()도 참조하세요 .

void QOpenGLTexture::borderColor(int *border) const

border 이 가리키는 배열의 처음 네 요소에 텍스처 테두리 색상을 씁니다.

이것은 오버로드된 함수입니다.

void QOpenGLTexture::borderColor(unsigned int *border) const

border 이 가리키는 배열의 처음 네 요소에 텍스처 테두리 색상을 씁니다.

이것은 오버로드된 함수입니다.

[static] GLuint QOpenGLTexture::boundTextureId(QOpenGLTexture::BindingTarget target)

현재 활성 텍스처 유닛의 target 에 바인딩된 텍스처의 textureId 를 반환합니다.

[static] GLuint QOpenGLTexture::boundTextureId(uint unit, QOpenGLTexture::BindingTarget target)

텍스처 유닛 unit 의 target 에 바인딩된 텍스처의 textureId 를 반환합니다.

QOpenGLTexture::ComparisonFunction QOpenGLTexture::comparisonFunction() const

이 텍스처에 설정된 텍스처 비교 연산자를 반환합니다. 기본적으로 텍스처에는 CompareLessEqual 비교 함수가 있습니다.

setComparisonFunction()도 참조하세요 .

QOpenGLTexture::ComparisonMode QOpenGLTexture::comparisonMode() const

이 텍스처에 설정된 텍스처 비교 모드를 반환합니다. 기본적으로 텍스처에는 CompareNone 비교 모드가 있습니다(즉, 비교가 비활성화됨).

setComparisonMode()도 참조하십시오 .

bool QOpenGLTexture::create()

기본 OpenGL 텍스처 오브젝트를 생성합니다. 이를 위해서는 현재 유효한 OpenGL 컨텍스트가 필요합니다. 텍스처 객체가 이미 존재하는 경우 이 함수는 아무 작업도 수행하지 않습니다.

텍스처 객체가 생성되면 textureId() 함수에서 객체 이름을 얻을 수 있습니다. 이 텍스처와 관련된 일부 원시 OpenGL 호출을 수행하려는 경우 유용할 수 있습니다.

일반적으로 텍스처 객체의 프로퍼티를 설정하는 모든 함수는 사용자를 대신하여 create()를 암시적으로 호출하므로 이 함수를 직접 호출할 필요는 없습니다.

생성에 성공하면 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.

destroy(), isCreated(), textureId()도 참조하세요 .

QOpenGLTexture *QOpenGLTexture::createTextureView(QOpenGLTexture::Target target, QOpenGLTexture::TextureFormat viewFormat, int minimumMipmapLevel, int maximumMipmapLevel, int minimumLayer, int maximumLayer) const

이 텍스처에 텍스처 뷰를 만들려고 시도합니다. 텍스처 뷰는 원본 데이터의 제한된 보기 또는 재해석된 보기를 제공한다는 점에서 SQL의 뷰와 다소 유사합니다. 텍스처 뷰는 더 이상 서버 측 스토리지를 할당하지 않고 소스 텍스처의 스토리지 버퍼에 의존합니다.

텍스처 뷰는 변경 불가능한 저장소를 사용할 때만 사용할 수 있습니다. 텍스처 뷰에 대한 자세한 내용은 http://www.opengl.org/wiki/Texture_Storage#Texture_views 을 참조하세요.

target 인수는 뷰에 사용할 대상을 지정합니다. 원본 대상의 대상에 따라 일부 대상만 사용할 수 있습니다. 예를 들어 Target1DArray 텍스처에 대한 뷰는 Target1DArray 또는 Target1D 중 하나를 지정할 수 있지만 후자의 경우 minimumLayer 및 maximumLayer 로 지정된 배열 레이어 수는 정확히 1이어야 합니다.

viewFormat 에도 간단한 제약 조건이 적용됩니다. 자세한 내용은 위의 링크와 사양을 참조하세요.

minimumMipmapLevel, maximumMipmapLevel, minimumLayer, maximumLayer 인수는 텍스처 뷰에서 액세스할 수 있는 텍스처의 일부를 제한하는 역할을 합니다.

텍스처 뷰 생성이 실패하면 이 함수는 0을 반환합니다. 함수가 성공하면 isTextureView() 함수에서 true 을 반환하는 새 QOpenGLTexture 객체에 대한 포인터를 반환합니다.

isTextureView()도 참조하세요 .

int QOpenGLTexture::depth() const

3D 텍스처의 깊이를 반환합니다.

width(), height() 및 setSize()도 참조하세요 .

QOpenGLTexture::DepthStencilMode QOpenGLTexture::depthStencilMode() const

결합된 뎁스/스텐실 형식을 사용하는 텍스처의 뎁스 스텐실 모드를 반환합니다.

setDepthStencilMode()도 참조하세요 .

void QOpenGLTexture::destroy()

기본 OpenGL 텍스처 오브젝트를 파괴합니다. 이를 위해서는 현재 유효한 OpenGL 컨텍스트가 필요합니다.

create(), isCreated() 및 textureId()도 참조하세요 .

int QOpenGLTexture::faces() const

이 텍스처의 면 수를 반환합니다. 큐브맵 및 큐브맵 배열 유형 타깃의 경우 6이 됩니다.

큐브맵 유형이 아닌 타깃의 경우 1을 반환합니다.

QOpenGLTexture::TextureFormat QOpenGLTexture::format() const

이 텍스처 객체의 형식을 반환합니다.

setFormat()도 참조하십시오 .

void QOpenGLTexture::generateMipMaps()

밉맵 레벨 0에서 이 텍스처 오브젝트에 대한 밉맵을 생성합니다. 밉맵이 필요한 텍스처 대상 및 필터링 옵션을 사용 중이고 자동 밉맵 생성을 비활성화한 경우 이 함수 또는 오버로드를 호출하여 밉맵 체인을 생성해야 합니다.

setAutoMipMapGenerationEnabled(), setMipLevels() 및 mipLevels()도 참조하세요 .

void QOpenGLTexture::generateMipMaps(int baseLevel, bool resetBaseLevel = true)

밉맵 레벨에서 이 텍스처 오브젝트에 대한 밉맵을 생성합니다 baseLevel. 밉맵이 필요한 텍스처 대상 및 필터링 옵션을 사용 중이고 자동 밉맵 생성을 비활성화한 경우 이 함수 또는 오버로드를 호출하여 밉맵 체인을 생성해야 합니다.

baseLevel 이상으로 밉맵을 생성하려면 밉맵 베이스 레벨을 baseLevel 으로 설정한 다음 밉맵 체인을 생성하면 됩니다. resetBaseLevel 가 true 인 경우 텍스처의 baseLevel은 이전 값으로 재설정됩니다.

setAutoMipMapGenerationEnabled(), setMipLevels() 및 mipLevels()도 참조하십시오 .

[static] bool QOpenGLTexture::hasFeature(QOpenGLTexture::Feature feature)

OpenGL 구현 및 버전이 텍스처 기능을 지원하는 경우 true 를 반환합니다 feature.

int QOpenGLTexture::height() const

2D 또는 3D 텍스처의 높이를 반환합니다.

width(), depth() 및 setSize()도 참조하세요 .

bool QOpenGLTexture::isAutoMipMapGenerationEnabled() const

이 텍스처 오브젝트에 대해 자동 밉맵 생성이 활성화되었는지 여부를 반환합니다.

setAutoMipMapGenerationEnabled() 및 generateMipMaps()도 참조하십시오 .

bool QOpenGLTexture::isBound() const

이 텍스처가 현재 활성 텍스처 유닛의 해당 타깃에 바인딩된 경우 true 를 반환합니다.

bind() 및 release()도 참조하세요 .

bool QOpenGLTexture::isBound(uint unit)

이 텍스처가 텍스처 단위 unit 의 해당 타깃에 바인딩된 경우 true 를 반환합니다.

bind() 및 release()도 참조하세요 .

bool QOpenGLTexture::isCreated() const

기본 OpenGL 텍스처 객체가 생성된 경우 true 를 반환합니다.

create(), destroy() 및 textureId()도 참조하세요 .

bool QOpenGLTexture::isFixedSamplePositions() const

이 텍스처가 멀티 샘플 샘플의 고정 패턴을 사용하는지 여부를 반환합니다. 이 텍스처에 저장소가 아직 할당되지 않은 경우 이 함수는 요청된 고정 샘플 위치 설정을 반환합니다.

멀티샘플링을 지원하지 않는 텍스처 타깃의 경우 true 을 반환합니다.

setFixedSamplePositions() 및 isStorageAllocated()도 참조하세요 .

bool QOpenGLTexture::isStorageAllocated() const

이 텍스처에 대한 서버 측 스토리지가 할당된 경우 true 를 반환합니다.

텍스처 형식, 치수, 밉맵 레벨 및 배열 레이어는 저장소가 할당된 후에는 변경할 수 없습니다.

allocateStorage(), setSize(), setMipLevels(), setLayers() 및 setFormat()도 참조하세요 .

bool QOpenGLTexture::isTextureView() const

이 텍스처 객체가 실제로 다른 텍스처 객체에 대한 뷰인 경우 true 를 반환합니다.

createTextureView()도 참조하십시오 .

int QOpenGLTexture::layers() const

이 텍스처의 배열 레이어 수를 반환합니다. 이 텍스처에 스토리지가 아직 할당되지 않은 경우 이 함수는 요청된 배열 레이어 수를 반환합니다.

배열 레이어를 지원하지 않는 텍스처 타깃의 경우 1을 반환합니다.

setLayers() 및 isStorageAllocated()도 참조하세요 .

QPair<float, float> QOpenGLTexture::levelOfDetailRange() const

최소 및 최대 세부 수준 매개변수를 반환합니다.

setLevelOfDetailRange(), minimumLevelOfDetail() 및 maximumLevelOfDetail()도 참조하세요 .

float QOpenGLTexture::levelofDetailBias() const

세부 수준 바이어스 매개변수를 반환합니다.

setLevelofDetailBias()도 참조하세요 .

QOpenGLTexture::Filter QOpenGLTexture::magnificationFilter() const

확대 필터를 반환합니다.

setMagnificationFilter()도 참조하세요 .

float QOpenGLTexture::maximumAnisotropy() const

텍스처 룩업을 수행할 때 고려할 최대 이방성 레벨을 반환합니다. 이를 위해서는 GL_EXT_texture_filter_anisotropic 확장이 필요합니다.

setMaximumAnisotropy()도 참조하세요 .

float QOpenGLTexture::maximumLevelOfDetail() const

최대 세부 수준 매개변수를 반환합니다.

setMaximumLevelOfDetail(), minimumLevelOfDetail() 및 levelOfDetailRange()도 참조하세요 .

int QOpenGLTexture::maximumMipLevels() const

현재 치수가 주어졌을 때 이 텍스처가 가질 수 있는 밉맵 레벨의 최대 개수를 반환합니다.

setMipLevels(), mipLevels(), setSize()도 참조하세요 .

QPair<QOpenGLTexture::Filter, QOpenGLTexture::Filter> QOpenGLTexture::minMagFilters() const

현재 축소 및 확대 필터를 반환합니다.

setMinMagFilters()도 참조하세요 .

QOpenGLTexture::Filter QOpenGLTexture::minificationFilter() const

축소 필터를 반환합니다.

setMinificationFilter()도 참조하세요 .

float QOpenGLTexture::minimumLevelOfDetail() const

최소 세부 수준 매개변수를 반환합니다.

setMinimumLevelOfDetail(), maximumLevelOfDetail() 및 levelOfDetailRange()도 참조하세요 .

int QOpenGLTexture::mipBaseLevel() const

이 텍스처의 모든 텍스처 룩업에 사용되는 밉맵 베이스 레벨을 반환합니다. 기본값은 0입니다.

setMipBaseLevel(), mipMaxLevel(), mipLevelRange()도 참조하세요 .

QPair<int, int> QOpenGLTexture::mipLevelRange() const

이 텍스처로 텍스처 룩업에 사용할 수 있는 밉맵 레벨의 범위를 반환합니다.

setMipLevelRange(), mipBaseLevel(), mipMaxLevel()도 참조하세요 .

int QOpenGLTexture::mipLevels() const

이 텍스처의 밉맵 레벨 수를 반환합니다. 이 텍스처에 스토리지가 아직 할당되지 않은 경우 요청된 밉맵 레벨 수를 반환합니다.

setMipLevels(), maximumMipLevels(), isStorageAllocated()도 참조하세요 .

int QOpenGLTexture::mipMaxLevel() const

이 텍스처의 모든 텍스처 룩업에 사용되는 밉맵 최대 레벨을 반환합니다.

setMipMaxLevel(), mipBaseLevel(), mipLevelRange()도 참조하세요 .

void QOpenGLTexture::release()

현재 활성 텍스처 유닛에서 이 텍스처의 바인딩을 해제합니다.

bind()도 참조하세요 .

void QOpenGLTexture::release(uint unit, QOpenGLTexture::TextureUnitReset reset = DontResetTextureUnit)

텍스처 유닛 unit 에서 이 텍스처를 바인딩 해제합니다.

파라미터 reset 가 true 인 경우 이 함수는 활성 유닛을 입력 시 활성화되었던 텍스처 유닛으로 복원합니다.

int QOpenGLTexture::samples() const

이 텍스처의 멀티 샘플 샘플 포인트 수를 반환합니다. 이 텍스처에 스토리지가 아직 할당되지 않은 경우 이 함수는 요청된 샘플 수를 반환합니다.

멀티샘플링을 지원하지 않는 텍스처 타깃의 경우 0을 반환합니다.

setSamples() 및 isStorageAllocated()도 참조하세요 .

void QOpenGLTexture::setAutoMipMapGenerationEnabled(bool enabled)

enabled 가 true 인 경우 setData()를 통해 레벨 0 밉맵 데이터를 설정할 때마다 이 텍스처 오브젝트에 대한 자동 밉맵 생성을 활성화합니다.

자동 밉맵 생성은 기본적으로 활성화되어 있습니다.

isAutoMipMapGenerationEnabled() 및 generateMipMaps()도 참조하세요 .

void QOpenGLTexture::setBorderColor(const QColor &color)

텍스처의 테두리 색상을 color 로 설정합니다.

borderColor()도 참조하십시오 .

void QOpenGLTexture::setBorderColor(float r, float g, float b, float a)

빨간색은 r, 녹색은 g, 파란색은 b, a 을 알파값으로 설정합니다.

이 함수는 오버로드된 함수입니다.

void QOpenGLTexture::setBorderColor(int r, int g, int b, int a)

빨간색은 r, 녹색은 g, 파란색은 b, 알파 값은 a 으로 설정합니다 .

이 함수는 오버로드된 함수입니다.

void QOpenGLTexture::setBorderColor(uint r, uint g, uint b, uint a)

빨간색은 r, 녹색은 g, 파란색은 b, 알파 값은 a 으로 설정합니다 .

이 함수는 오버로드된 함수입니다.

void QOpenGLTexture::setComparisonFunction(QOpenGLTexture::ComparisonFunction function)

이 텍스처의 텍스처 비교 기능을 function 로 설정합니다. 텍스처 비교 기능은 섀도우 샘플러가 깊이 텍스처를 샘플링할 때 사용됩니다.

comparisonFunction()도 참조하십시오 .

void QOpenGLTexture::setComparisonMode(QOpenGLTexture::ComparisonMode mode)

이 텍스처의 텍스처 비교 모드를 mode 로 설정합니다. 텍스처 비교 모드는 섀도우 샘플러가 깊이 텍스처를 샘플링할 때 사용됩니다.

comparisonMode()도 참조하십시오 .

void QOpenGLTexture::setCompressedData(int mipLevel, int layer, QOpenGLTexture::CubeMapFace cubeFace, int dataSize, const void *data, const QOpenGLPixelTransferOptions *const options = nullptr)

압축 픽셀 data 을 mipLevel, 배열 layer, 및 cubeFace 에 업로드합니다. 픽셀 전송은 선택적으로 options 로 제어할 수 있습니다. dataSize 인수는 data 이 가리키는 데이터의 크기를 지정해야 합니다.

압축된 format()를 사용하지 않는 경우 이 함수 대신 setData()를 사용해야 합니다.

void QOpenGLTexture::setCompressedData(int dataSize, const void *data, const QOpenGLPixelTransferOptions *const options = nullptr)

과부하가 걸린 기능입니다.

void QOpenGLTexture::setCompressedData(int mipLevel, int dataSize, const void *data, const QOpenGLPixelTransferOptions *const options = nullptr)

과부하가 걸린 기능입니다.

void QOpenGLTexture::setCompressedData(int mipLevel, int layer, int dataSize, const void *data, const QOpenGLPixelTransferOptions *const options = nullptr)

과부하가 걸린 기능입니다.

void QOpenGLTexture::setCompressedData(int mipLevel, int layer, int layerCount, QOpenGLTexture::CubeMapFace cubeFace, int dataSize, const void *data, const QOpenGLPixelTransferOptions *const options = nullptr)

이 함수는 오버로드된 함수입니다.

매개변수 layerCount 는 이 호출로 업로드/채우는 텍스처 배열의 레이어 수입니다.

void QOpenGLTexture::setData(int mipLevel, int layer, QOpenGLTexture::CubeMapFace cubeFace, QOpenGLTexture::PixelFormat sourceFormat, QOpenGLTexture::PixelType sourceType, const void *data, const QOpenGLPixelTransferOptions *const options = nullptr)

이 텍스처 오브젝트 mipLevel, 배열 layer, 및 cubeFace 에 대한 픽셀 data 을 업로드합니다. 픽셀 데이터를 업로드하기 전에 저장소가 할당되어 있어야 합니다. 일부 setData()의 오버로드는 적절한 차원, 밉맵 레벨 및 배열 레이어를 설정한 다음 충분한 정보가 있는 경우 스토리지를 할당합니다. 이는 함수 설명서에 명시되어 있습니다.

data 에서 가리키는 픽셀 데이터의 구조는 sourceFormat 과 sourceType 에서 지정합니다. 픽셀 데이터 업로드는 선택적으로 options 로 제어할 수 있습니다.

압축된 format()를 사용하는 경우 이 함수 대신 setCompressedData()를 사용해야 합니다.

setCompressedData()도 참조하세요 .

void QOpenGLTexture::setData(const QImage &image, QOpenGLTexture::MipMapGeneration genMipMaps = GenerateMipMaps)

이 setData()의 오버로드는 저장소를 할당합니다. 픽셀 데이터는 image 에 포함되어 있습니다. 밉맵은 기본적으로 생성됩니다. 밉맵 생성을 끄려면 genMipMaps 을 DontGenerateMipMaps 으로 설정하세요.

이는 과부하가 걸린 기능입니다.

void QOpenGLTexture::setData(QOpenGLTexture::PixelFormat sourceFormat, QOpenGLTexture::PixelType sourceType, const void *data, const QOpenGLPixelTransferOptions *const options = nullptr)

과부하가 걸린 기능입니다.

void QOpenGLTexture::setData(int mipLevel, QOpenGLTexture::PixelFormat sourceFormat, QOpenGLTexture::PixelType sourceType, const void *data, const QOpenGLPixelTransferOptions *const options = nullptr)

과부하가 걸린 기능입니다.

void QOpenGLTexture::setData(int mipLevel, int layer, QOpenGLTexture::PixelFormat sourceFormat, QOpenGLTexture::PixelType sourceType, const void *data, const QOpenGLPixelTransferOptions *const options = nullptr)

과부하가 걸린 기능입니다.

void QOpenGLTexture::setData(int mipLevel, int layer, int layerCount, QOpenGLTexture::CubeMapFace cubeFace, QOpenGLTexture::PixelFormat sourceFormat, QOpenGLTexture::PixelType sourceType, const void *data, const QOpenGLPixelTransferOptions *const options = nullptr)

이 함수는 오버로드된 함수입니다.

파라미터 layerCount 는 이 호출에 의해 업로드/채워지는 텍스처 배열의 레이어 수입니다.

void QOpenGLTexture::setData(int xOffset, int yOffset, int zOffset, int width, int height, int depth, QOpenGLTexture::PixelFormat sourceFormat, QOpenGLTexture::PixelType sourceType, const void *data, const QOpenGLPixelTransferOptions *const options = nullptr)

이것은 오버로드된 함수입니다.

이 오버로드는 텍스처의 일부를 업데이트하는 데 사용됩니다. 파라미터 xOffset, yOffset, zOffset 는 텍스처 내의 텍셀 오프셋을 지정합니다. 파라미터 width, height, depth 는 서브 이미지의 치수를 지정합니다.

data 이 가리키는 픽셀 데이터의 구조는 sourceFormat 과 sourceType 으로 지정됩니다. 픽셀 데이터 업로드는 options 로 선택적으로 제어할 수 있습니다.

void QOpenGLTexture::setData(int xOffset, int yOffset, int zOffset, int width, int height, int depth, int mipLevel, QOpenGLTexture::PixelFormat sourceFormat, QOpenGLTexture::PixelType sourceType, const void *data, const QOpenGLPixelTransferOptions *const options = nullptr)

이것은 오버로드된 함수입니다.

이 오버로드는 텍스처의 일부를 업데이트하는 데 사용됩니다. 파라미터 xOffset, yOffset, zOffset 는 텍스처 내의 텍셀 오프셋을 지정합니다. 파라미터 width, height, depth 는 서브 이미지의 치수를 지정합니다. 업데이트하려는 서브 이미지의 밉 맵 레벨은 mipLevel 로 지정합니다.

data 이 가리키는 픽셀 데이터의 구조는 sourceFormat 과 sourceType 로 지정합니다. 픽셀 데이터 업로드는 options 로 선택적으로 제어할 수 있습니다.

void QOpenGLTexture::setData(int xOffset, int yOffset, int zOffset, int width, int height, int depth, int mipLevel, int layer, QOpenGLTexture::PixelFormat sourceFormat, QOpenGLTexture::PixelType sourceType, const void *data, const QOpenGLPixelTransferOptions *const options = nullptr)

이것은 오버로드된 함수입니다.

이 오버로드는 텍스처의 일부를 업데이트하는 데 사용됩니다. 파라미터 xOffset, yOffset, zOffset 는 텍스처 내의 텍셀 오프셋을 지정합니다. 파라미터 width, height, depth 는 서브 이미지의 치수를 지정합니다. 업데이트하려는 서브 이미지의 밉 맵 레벨과 레이어는 mipLevel 및 layer 으로 지정합니다.

data 이 가리키는 픽셀 데이터의 구조는 sourceFormat 과 sourceType 로 지정합니다. 픽셀 데이터 업로드는 options 로 선택적으로 제어할 수 있습니다.

void QOpenGLTexture::setData(int xOffset, int yOffset, int zOffset, int width, int height, int depth, int mipLevel, int layer, QOpenGLTexture::CubeMapFace face, QOpenGLTexture::PixelFormat sourceFormat, QOpenGLTexture::PixelType sourceType, const void *data, const QOpenGLPixelTransferOptions *const options = nullptr)

이것은 오버로드된 함수입니다.

이 오버로드는 텍스처의 일부를 업데이트하는 데 사용됩니다. 매개변수 xOffset, yOffset, zOffset 는 텍스처 내의 텍셀 오프셋을 지정합니다. 파라미터 width, height, depth 는 서브 이미지의 치수를 지정하고, 업데이트하려는 서브 이미지의 밉 맵 레벨, 레이어 및 큐브 맵 면은 mipLevel, layer, face 로 지정합니다.

data 가 가리키는 픽셀 데이터의 구조는 sourceFormat 과 sourceType 로 지정합니다. 픽셀 데이터 업로드는 options 로 선택적으로 제어할 수 있습니다.

void QOpenGLTexture::setData(int xOffset, int yOffset, int zOffset, int width, int height, int depth, int mipLevel, int layer, QOpenGLTexture::CubeMapFace face, int layerCount, QOpenGLTexture::PixelFormat sourceFormat, QOpenGLTexture::PixelType sourceType, const void *data, const QOpenGLPixelTransferOptions *const options = nullptr)

이것은 오버로드된 함수입니다.

이 오버로드는 텍스처의 일부를 업데이트하는 데 사용됩니다. 매개변수 xOffset, yOffset, zOffset 는 텍스처 내의 텍셀 오프셋을 지정합니다. 파라미터 width, height, depth 는 서브 이미지의 치수를 지정하고, 업데이트하려는 서브 이미지의 밉 맵 레벨, 시작 레이어, 큐브 맵 면 및 레이어 수는 mipLevel, layer, face, layerCount 로 지정합니다.

data 에서 가리키는 픽셀 데이터의 구조는 sourceFormat 과 sourceType 로 지정합니다. 픽셀 데이터 업로드는 options 로 선택적으로 제어할 수 있습니다.

void QOpenGLTexture::setDepthStencilMode(QOpenGLTexture::DepthStencilMode mode)

뎁스/스텐실 형식이 결합된 텍스처를 사용하는 경우 이 함수는 텍스처의 어느 컴포넌트에 액세스할지 mode 로 설정합니다.

파라미터가 DepthMode 로 설정된 경우 셰이더에서 액세스하면 평소와 같이 단일 플로트로 뎁스 컴포넌트에 액세스합니다. 그러나 파라미터가 StencilMode 로 설정된 경우 셰이더는 스텐실 컴포넌트에 액세스합니다.

depthStencilMode()도 참조하십시오 .

void QOpenGLTexture::setFixedSamplePositions(bool fixed)

다중 샘플 지원 텍스처 대상에 사용되는 샘플 위치와 샘플 수를 fixed 로 설정합니다. true 로 설정하면 사용되는 샘플 위치와 샘플 수는 이미지의 모든 텍셀에 대해 동일하며 이미지 크기나 내부 형식에 따라 달라지지 않습니다. 이 함수는 텍스처에 대한 저장소가 할당되기 전에 호출해야 합니다.

멀티샘플링을 지원하지 않는 대상의 경우 이 함수는 효과가 없습니다.

기본값은 true 입니다.

isFixedSamplePositions() 및 isStorageAllocated()도 참조하세요 .

void QOpenGLTexture::setFormat(QOpenGLTexture::TextureFormat format)

이 텍스처 오브젝트의 형식을 format 로 설정합니다. 이 함수는 텍스처 저장소가 할당되기 전에 호출해야 합니다.

모든 포맷이 지원되지 않을 수도 있습니다. 지원되는 형식의 정확한 세트는 OpenGL 구현 및 버전에 따라 다릅니다.

format() 및 allocateStorage()도 참조하세요 .

void QOpenGLTexture::setLayers(int layers)

스토리지를 할당할 layers 배열의 수를 설정합니다. 이 함수는 텍스처에 저장소가 할당되기 전에 호출해야 합니다.

배열 레이어를 지원하지 않는 타깃의 경우 이 함수는 효과가 없습니다.

layers() 및 isStorageAllocated()도 참조하세요 .

void QOpenGLTexture::setLevelOfDetailRange(float min, float max)

최소 세부 수준 파라미터를 min 로, 최대 수준을 max 로 설정합니다.

levelOfDetailRange(), setMinimumLevelOfDetail() 및 setMaximumLevelOfDetail()도 참조하십시오 .

void QOpenGLTexture::setLevelofDetailBias(float bias)

세부 수준 바이어스를 bias 로 설정합니다. 세부 수준 바이어스는 밉매핑 수준이 변경되는 지점에 영향을 줍니다. 세부 수준 바이어스 값을 높이면 전체 이미지가 더 흐릿해지거나 부드러워집니다. 값을 낮추면 전체 이미지가 더 선명해집니다.

levelofDetailBias()도 참조하세요 .

void QOpenGLTexture::setMagnificationFilter(QOpenGLTexture::Filter filter)

배율 필터를 filter 로 설정합니다.

magnificationFilter(), setMinificationFilter() 및 setMinMagFilters()도 참조하세요 .

void QOpenGLTexture::setMaximumAnisotropy(float anisotropy)

OpenGL 구현이 GL_EXT_texture_filter_anisotropic 확장을 지원하는 경우 이 함수는 최대 이방성 레벨을 anisotropy 으로 설정합니다.

maximumAnisotropy()도 참조하세요 .

void QOpenGLTexture::setMaximumLevelOfDetail(float value)

최대 세부 수준을 value 으로 설정합니다. 이렇게 하면 가장 낮은 해상도의 밉맵(가장 높은 밉맵 수준) 선택이 제한됩니다. 기본값은 1000입니다.

maximumLevelOfDetail(), setMinimumLevelOfDetail() 및 setLevelOfDetailRange()도 참조하십시오 .

void QOpenGLTexture::setMinMagFilters(QOpenGLTexture::Filter minificationFilter, QOpenGLTexture::Filter magnificationFilter)

축소 필터를 minificationFilter 로, 확대 필터를 magnificationFilter 로 설정합니다.

minMagFilters(), setMinificationFilter() 및 setMagnificationFilter()도 참조하세요 .

void QOpenGLTexture::setMinificationFilter(QOpenGLTexture::Filter filter)

축약에 사용되는 필터를 filter 로 설정합니다.

minificationFilter(), setMagnificationFilter() 및 setMinMagFilters()도 참조하세요 .

void QOpenGLTexture::setMinimumLevelOfDetail(float value)

최소 세부 수준을 value 으로 설정합니다. 이렇게 하면 최고 해상도 밉맵(가장 낮은 밉맵 수준)의 선택이 제한됩니다. 기본값은 -1000입니다.

minimumLevelOfDetail(), setMaximumLevelOfDetail() 및 setLevelOfDetailRange()도 참조하십시오 .

void QOpenGLTexture::setMipBaseLevel(int baseLevel)

이 텍스처의 모든 텍스처 룩업에 사용되는 기본 밉맵 레벨을 baseLevel 으로 설정합니다.

mipBaseLevel(), setMipMaxLevel() 및 setMipLevelRange()도 참조하십시오 .

void QOpenGLTexture::setMipLevelRange(int baseLevel, int maxLevel)

이 텍스처의 텍스처 룩업에 사용할 수 있는 밉맵 레벨의 범위를 baseLevel ~ maxLevel 범위로 설정합니다.

setMipBaseLevel(), setMipMaxLevel() 및 mipLevelRange()도 참조하십시오 .

void QOpenGLTexture::setMipLevels(int levels)

밉맵을 지원하는 텍스처 타깃의 경우, 이 함수는 저장소를 할당할 밉맵 levels 의 요청 수를 설정합니다. 이 함수는 텍스처에 저장소가 할당되기 전에 호출해야 합니다.

텍스처 타깃이 밉맵을 지원하지 않는 경우 이 함수는 효과가 없습니다.

mipLevels(), maximumMipLevels() 및 isStorageAllocated()도 참조하세요 .

void QOpenGLTexture::setMipMaxLevel(int maxLevel)

이 텍스처의 모든 텍스처 룩업에 사용되는 최대 밉맵 레벨을 maxLevel 로 설정합니다.

mipMaxLevel(), setMipBaseLevel(), setMipLevelRange()도 참조하십시오 .

void QOpenGLTexture::setSamples(int samples)

멀티 샘플 지원 텍스처 타깃에 렌더링할 때 저장소를 할당할 samples 의 수를 설정합니다. 이 함수는 텍스처에 저장소가 할당되기 전에 호출해야 합니다.

멀티샘플링을 지원하지 않는 타깃의 경우 이 함수는 효과가 없습니다.

samples() 및 isStorageAllocated()도 참조하십시오 .

void QOpenGLTexture::setSize(int width, int height = 1, int depth = 1)

이 텍스처 객체의 치수를 width, height, depth 로 설정합니다. 각 치수의 기본값은 1입니다. 허용되는 최대 텍스처 크기는 OpenGL 구현에 따라 달라집니다. 시스템에 리소스가 부족한 경우 최대 크기보다 작은 텍스처에 스토리지를 할당해도 실패할 수 있습니다.

2승이 아닌 width, height 또는 depth 이 제공되고 OpenGL 구현이 2승이 아닌 텍스처 반복을 지원하지 않는 경우 랩 모드는 자동으로 ClampToEdge 으로 설정됩니다.

width(), height() 및 depth()도 참조하세요 .

void QOpenGLTexture::setSwizzleMask(QOpenGLTexture::SwizzleComponent component, QOpenGLTexture::SwizzleValue value)

GLSL 셰이더는 텍스처 함수에 의해 반환된 vec4의 컴포넌트를 재정렬할 수 있습니다. CPU 측 코드에서 이 재정렬을 제어할 수 있는 것도 바람직합니다. 이는 OpenGL 3.3부터 스위즐 마스크를 통해 가능해졌습니다.

텍스처의 각 컴포넌트는 SwizzleValue 옵션 중 하나에 매핑할 수 있습니다.

이 함수는 component 을 출력 value 에 매핑합니다.

swizzleMask()도 참조하십시오 .

void QOpenGLTexture::setSwizzleMask(QOpenGLTexture::SwizzleValue r, QOpenGLTexture::SwizzleValue g, QOpenGLTexture::SwizzleValue b, QOpenGLTexture::SwizzleValue a)

매개변수 r, g, b, a 는 빨강, 초록, 파랑 및 알파 값을 설정하는 데 사용되는 값입니다.

이 함수는 오버로드된 함수입니다.

void QOpenGLTexture::setWrapMode(QOpenGLTexture::WrapMode mode)

모든 텍스처 치수의 래핑(또는 반복 모드)을 mode 로 설정합니다.

wrapMode()도 참조하세요 .

void QOpenGLTexture::setWrapMode(QOpenGLTexture::CoordinateDirection direction, QOpenGLTexture::WrapMode mode)

텍스처 치수를 보유합니다 direction.

이것은 오버로드된 함수입니다.

QOpenGLTexture::SwizzleValue QOpenGLTexture::swizzleMask(QOpenGLTexture::SwizzleComponent component) const

텍스처용 스위즐 마스크를 반환합니다 component.

setSwizzleMask()도 참조하세요 .

QOpenGLTexture::Target QOpenGLTexture::target() const

이 텍스처의 바인딩 타깃을 반환합니다.

GLuint QOpenGLTexture::textureId() const

기본 OpenGL 텍스처 객체의 이름을 반환하거나 아직 생성되지 않은 경우 0을 반환합니다.

create(), destroy() 및 isCreated()도 참조하세요 .

int QOpenGLTexture::width() const

1D, 2D 또는 3D 텍스처의 너비를 반환합니다.

height(), depth() 및 setSize()도 참조하세요 .

QOpenGLTexture::WrapMode QOpenGLTexture::wrapMode(QOpenGLTexture::CoordinateDirection direction) const

텍스처 치수에 대한 래핑 모드를 반환합니다 direction.

setWrapMode()도 참조하세요 .