QOpenGLTexture Class

// Prepare texture
QOpenGLTexture *texture = new QOpenGLTexture(QImage(fileName).flipped());
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()

이 텍스처를 현재 활성화된 텍스처 유닛에 바인딩하여 렌더링 준비를 완료합니다. QOpenGLTexture 객체를 수정하기 위해 반드시 바인딩할 필요는 없습니다. 구현에서는 가능한 경우 EXT_direct_state_access 확장을 사용하고, 불가능한 경우 이를 시뮬레이션하기 때문입니다.

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 구현 및 버전이 feature 텍스처 기능을 지원하는 경우, true 를 반환합니다.

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()도 참조하십시오 .

std::pair<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()도 참조하십시오 .

std::pair<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()도 참조하십시오 .

std::pair<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 구현에 따라 다릅니다. 최대 크기 미만의 텍스처에 대한 저장 공간을 할당하더라도 시스템 리소스가 부족한 경우 할당이 실패할 수 있습니다.

width, height 또는 depth 값이 2의 거듭제곱이 아닌 경우, 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 매개변수는 각각 빨강(red), 녹색(green), 파랑(blue) 및 알파(alpha) 값을 설정하는 데 사용되는 값입니다.

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

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

wrapMode()도 참조하십시오 .

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

텍스처 차원 direction 의 랩(또는 반복 모드)을 mode 로 설정합니다.

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

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

height(), depth() 및 setSize()도 참조하십시오 .

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

direction 의 텍스처 차원에 대한 래핑 모드를 반환합니다.

setWrapMode()도 참조하십시오 .