OpenCoreImage

A Swift library providing full API compatibility with Apple's CoreImage framework for WebAssembly (WASM) environments.

Overview

OpenCoreImage enables cross-platform Swift code to use CoreImage APIs in WASM environments where Apple's CoreImage is unavailable. The library uses WebGPU as its GPU rendering backend for hardware-accelerated image processing.

#if canImport(CoreImage)
import CoreImage
#else
import OpenCoreImage
#endif

// This code works in both environments
let filter = CIFilter(name: "CIGaussianBlur")
filter?.setValue(inputImage, forKey: kCIInputImageKey)
filter?.setValue(10.0, forKey: kCIInputRadiusKey)
let outputImage = filter?.outputImage

Requirements

• Swift 6.2+
• For WASM: SwiftWasm toolchain

Installation

Add OpenCoreImage to your Package.swift:

dependencies: [
    .package(url: "https://github.com/1amageek/OpenCoreImage.git", branch: "main")
]

Then add it as a dependency to your target:

.target(
    name: "YourTarget",
    dependencies: ["OpenCoreImage"]
)

Building

# Build the package
swift build

# Run tests
swift test

# Build for WASM (requires SwiftWasm toolchain)
swift build --triple wasm32-unknown-wasi

Core Types

Type	Description
CIImage	A representation of an image to be processed or produced by Core Image filters
CIFilter	An image processor that produces an image by manipulating input images
CIContext	The evaluation context for Core Image processing
CIColor	A color object for use with Core Image filters
CIVector	A vector object that can store multiple CGFloat values

Filter Categories

OpenCoreImage provides protocols and implementations for all standard CoreImage filter categories:

• Blur Filters - Gaussian blur, box blur, motion blur, and more
• Color Adjustment Filters - Exposure, hue, saturation, and color transformations
• Color Effect Filters - Photo effects, dithering, and color maps
• Composite Operations - Blend modes and compositing operators
• Convolution Filters - Blurring, sharpening, edge detection
• Distortion Filters - Image distortion effects
• Generator Filters - Barcode, geometric, and special-effect image generation
• Geometry Adjustment Filters - 2D and 3D transformations
• Gradient Filters - Linear and radial gradients
• Halftone Effect Filters - Monochrome and CMYK halftone screens
• Reduction Filters - Statistical analysis of images
• Sharpening Filters - Image sharpening
• Stylizing Filters - Pixelation, line overlays, and other stylized effects
• Tile Effect Filters - Image tiling
• Transition Filters - Transitions between images

Architecture

┌─────────────────────────────────────────────────────────────┐
│                    OpenCoreImage API                        │
│  (CIImage, CIFilter, CIContext, CIKernel - CoreImage API)   │
├─────────────────────────────────────────────────────────────┤
│                  WebGPU Rendering Layer                     │
├─────────────────────────────────────────────────────────────┤
│                     swift-webgpu                            │
│         (SwiftWebGPU - Type-safe WebGPU bindings)           │
├─────────────────────────────────────────────────────────────┤
│                     JavaScriptKit                           │
│              (Swift-to-JavaScript bridge)                   │
├─────────────────────────────────────────────────────────────┤
│                   Browser WebGPU API                        │
└─────────────────────────────────────────────────────────────┘

Dependencies

• OpenCoreGraphics - CoreGraphics API compatibility for WASM
• swift-webgpu - Type-safe WebGPU bindings for Swift

License

MIT License