TextureMap

概述

Texture Map 是一个 Swift 6 包，用于处理图像和纹理。可以在各种格式之间转换图像或原始数据。专为 iOS、macOS 和 visionOS 打造。由 Metal 提供支持。

特性

跨平台支持:
- 提供对 macOS 和 iOS 的无缝支持，可以互换使用 NSImage 和 UIImage。
高位深颜色支持
- 处理 8 bit、16 bit 和 32 bit 的图形。
图像格式:
- 在 UIImage/NSImage、CGImage、CIImage、CVPixelBuffer、CMSampleBuffer 和 MTLTexture 之间进行转换。
- 跨平台支持获取 TIFF、PNG 和 JPG 数据。
Metal 纹理实用工具:
- 创建具有指定像素格式和尺寸的空纹理。
- 支持 2D、3D 和数组纹理。
- 纹理复制和采样。
原始数据操作:
- 提取归一化或原始纹理数据，格式为 UInt8、Float16 或 Float32。
- 从原始数据数组创建纹理。

安装

通过将其作为 Swift 包集成，将 Texture Map 添加到您的项目中。使用仓库 URL

dependencies: [
    .package(url: "https://github.com/heestand-xyz/TextureMap", from: "2.0.0")
]

要求

平台:
- iOS 16.0+
- macOS 13.0+
- visionOS 1.0+

用法

将图像转换为纹理

import TextureMap

let image: UIImage = UIImage(named: "Example")!
let texture: MTLTexture = try TextureMap.texture(image: image)

从纹理中提取原始数据

let rawChannels: [UInt8] = try TextureMap.raw8(texture: texture)

将纹理转换为图像

let outputImage: UIImage = try await texture.image(colorSpace: .sRGB, bits: ._8)

复制 Metal 纹理

let originalTexture: MTLTexture = ... // Your Metal texture

do {
    let copiedTexture: MTLTexture = try await originalTexture.copy()
    print("Copied texture: \(copiedTexture)")
} catch {
    print("Error copying texture: \(error)")
}

从原始归一化数据创建纹理

let rawTexture: MTLTexture = ...
let bits: TMBits = ._8

do {
    let normalizedRawData: [CGFloat] = try await TextureMap.rawNormalized(texture: rawTexture, bits: bits)
    print("Normalized raw data: \(normalizedRawData)")
} catch {
    print("Error extracting raw data: \(error)")
}

转换纹理颜色空间

let inputTexture: MTLTexture = ...
let fromColorSpace: CGColorSpace = CGColorSpace(name: CGColorSpace.sRGB)!
let toColorSpace: CGColorSpace = CGColorSpace(name: CGColorSpace.displayP3)!

do {
    let convertedTexture: MTLTexture = try await inputTexture.convertColorSpace(from: fromColorSpace, to: toColorSpace)
    print("Converted texture: \(convertedTexture)")
} catch {
    print("Error converting texture color space: \(error)")
}

颜色空间

sRGB: 标准 RGB 空间。
Display P3: 用于 HDR 内容的扩展色域。
XDR: 用于在 XDR 兼容显示器上显示的高位深图形。

贡献

欢迎通过提交 pull request 或报告问题来做出贡献。

许可证

该库在 MIT 许可证下可用。

致谢

由 Anton Heestand 开发