Создание объекта текстуры с дескриптором текстуры

MTLTextureDescriptor определяет свойства, использующиеся для создания a MTLTexture объект, включая его размер изображения (ширина, высота и глубина), формат пикселя, расположение (тип массива или тип куба) и число множественных отображений. MTLTextureDescriptor свойства только используются во время создания a MTLTexture объект. После создания a MTLTexture объект, свойство изменяется в MTLTextureDescriptor объект больше не имеет эффекта на ту текстуру.

Создать одну или более текстур из дескриптора:

1. Создайте пользовательское MTLTextureDescriptor объект, содержащий свойства текстуры, описывающие данные текстуры:

   • textureType свойство указывает размерность и расположение текстуры (например, массив или куб).

   • width, height, и depth свойства указывают, что множественно отображается размер пикселя в каждой размерности основной текстуры уровня.

   • pixelFormat свойство указывает, как пиксель сохранен в текстуре.

   • arrayLength свойство указывает число элементов матрицы для a MTLTextureType1DArray или MTLTextureType2DArray введите объект текстуры.

   • mipmapLevelCount свойство указывает число уровней множественного отображения.

   • sampleCount свойство указывает число выборок в каждом пикселе.

   • resourceOptions свойство указывает поведение своего выделения памяти.

2. Создайте текстуру из MTLTextureDescriptor объект путем вызова newTextureWithDescriptor: метод a MTLDevice объект. После создания текстуры вызовите replaceRegion:mipmapLevel:slice:withBytes:bytesPerRow:bytesPerImage: метод для загрузки данных изображения текстуры, как детализировано в Копировании Данных изображения к и от Текстуры.

3. Создать больше MTLTexture объекты, можно снова использовать то же MTLTextureDescriptor объект, изменяя значения свойств дескриптора по мере необходимости.

Перечисление 3-1 показывает код для создания дескриптора текстуры txDesc и установка ее свойств для 3D, 64x64x64 текстура.

Перечисление 3-1  , создающее объект текстуры с пользовательским дескриптором текстуры

MTLTextureDescriptor* txDesc = [MTLTextureDescriptor new];

txDesc.textureType = MTLTextureType3D;

txDesc.height = 64;

txDesc.width = 64;

txDesc.depth = 64;

txDesc.pixelFormat = MTLPixelFormatBGRA8Unorm;

txDesc.arrayLength = 1;

txDesc.mipmapLevelCount = 1;

id <MTLTexture> aTexture = [device newTextureWithDescriptor:txDesc];

Работа с частями текстуры

Часть является синглом 1D, 2D, или 3D изображение текстуры и все его связанные множественные отображения. Для каждой части:

• Размер основного множественного отображения уровня указан width, height, и depth свойства MTLTextureDescriptor объект.

• Масштабированный размер уровня множественного отображения я указан макс. (1, пол (width / ²ⁱ)) x макс. (1, пол (height / ²ⁱ)) x макс. (1, пол (depth / ²ⁱ)). Максимальный уровень множественного отображения является первым уровнем множественного отображения, где достигается размер 1 x 1 x 1.

• Число уровней множественного отображения в одной части может быть определено полом (_log2 (макс. (width, height, depth))) +1.

Все объекты текстуры имеют по крайней мере одну часть; куб и типы текстуры массива могут иметь несколько частей. В методах, пишущих и читающих данные изображения текстуры, обсужденные в Копировании Данных изображения к и от Текстуры, slice основанное на нуле входное значение. Для 1D, 2D, или 3D текстура, существует только одна часть, таким образом, значение slice должен быть 0. Кубическая текстура имеет шесть общих 2D частей, адресуемых от 0 до 5. Для 1DArray и 2DArray типы текстуры, каждый элемент матрицы представляет одну часть. Например, для 2DArray текстурируют тип с arrayLength = 10, существует 10 общих частей, адресуемых от 0 до 9. Для выбора сингла 1D, 2D, или 3D изображение из полной структуры текстуры, сначала выбирают часть, и затем выбирают уровень множественного отображения в той части.

Создание дескриптора текстуры с удобными методами

Для общих 2D и кубических текстур используйте следующие удобные методы создать a MTLTextureDescriptor объект с несколькими из его значений свойств автоматически установил:

• texture2DDescriptorWithPixelFormat:width:height:mipmapped: метод создает a MTLTextureDescriptor объект для 2D текстуры. width и height значения определяют размерности 2D текстуры. type свойство автоматически установлено в MTLTextureType2D, и depth и arrayLength установлены в 1.

• textureCubeDescriptorWithPixelFormat:size:mipmapped: метод создает a MTLTextureDescriptor объект для кубической текстуры, где type свойство установлено в MTLTextureTypeCube, width и height установлены измерить, и depth и arrayLength установлены в 1.

Оба MTLTextureDescriptor удобные методы принимают входное значение, pixelFormat, который определяет формат пикселя текстуры. Оба метода также принимают входное значение mipmapped, который определяет, множественно отображается ли изображение текстуры. (Если mipmapped YES, текстура множественно отображается.)

Перечисление 3-2 использует texture2DDescriptorWithPixelFormat:width:height:mipmapped: метод для создания дескриптора возражает для a 64x64 Не множественно отображающаяся 2D текстура.

Перечисление 3-2  , создающее объект текстуры с дескриптором текстуры удобства

MTLTextureDescriptor *texDesc = [MTLTextureDescriptor 
         texture2DDescriptorWithPixelFormat:MTLPixelFormatBGRA8Unorm 
         width:64 height:64 mipmapped:NO];
id <MTLTexture> myTexture = [device newTextureWithDescriptor:texDesc];

Копирование данных изображения к и от текстуры

Синхронно скопировать данные изображения в или данные копии от выделения ресурсов хранения a MTLTexture объект, используйте следующие методы:

• replaceRegion:mipmapLevel:slice:withBytes:bytesPerRow:bytesPerImage: копирует область пиксельных данных от указателя вызывающей стороны в часть выделения ресурсов хранения указанной части текстуры. replaceRegion:mipmapLevel:withBytes:bytesPerRow: подобный удобный метод, копирующий область пиксельных данных в часть по умолчанию, принимая значения по умолчанию для связанных с частью параметров (т.е. slice = 0 и bytesPerImage = 0).

• getBytes:bytesPerRow:bytesPerImage:fromRegion:mipmapLevel:slice: получает область пиксельных данных от указанной части текстуры. getBytes:bytesPerRow:fromRegion:mipmapLevel: подобный удобный метод, получающий область пиксельных данных от части по умолчанию, принимая значения по умолчанию для связанных с частью параметров (slice = 0 и bytesPerImage = 0).

Перечисление 3-3 показывает, как вызвать replaceRegion:mipmapLevel:slice:withBytes:bytesPerRow:bytesPerImage: для указания текстуры отображают от исходных данных в системной памяти, textureData, в части 0 и множественно отобразите уровень 0.

Перечисление 3-3  , копирующее данные изображения в текстуру

//  pixelSize is the size of one pixel, in bytes

//  width, height - number of pixels in each dimension

NSUInteger myRowBytes = width * pixelSize;

NSUInteger myImageBytes = rowBytes * height;

[tex replaceRegion:MTLRegionMake2D(0,0,width,height)

    mipmapLevel:0 slice:0 withBytes:textureData

    bytesPerRow:myRowBytes bytesPerImage:myImageBytes];