sample-metal

KO | EN

gitlite — search

#hacktoberfest #golang #go #android #rust #docker #java #nodejs #windows #pytorch #security #mcp #ios #openai

(★ 306)

Examples for Apple's Metal APIs (rendering and compute).

File Explorer

Download Latest Version (.zip)

- - bug_report.md
  - feature_request.md
  - question.md
- - project.pbxproj
- - App.swift
  - MetalView.swift
  - Shader.metal
  - TessellationRenderer.swift
- - App.entitlements
  - CoreGraphics+Additions.swift
  - Foundation+Additions.swift
  - SIMD+Additions.swift
- - Metal.svg
  - Tessellation.png
- CODE_OF_CONDUCT.md
- CONTRIBUTING.md
- - App.swift
  - CAMetalView.swift
  - MetalView.swift
- - App.swift
  - CAMetalView.swift
  - MetalView.swift
  - Shader.metal
  - Shader.swift
- - App.swift
  - CAMetalView.swift
  - MetalView.swift
  - Renderer.swift
  - Shader.metal
  - Shader.swift
- - App.swift
  - MetalView.swift
  - Renderer.swift
  - Shader.metal
  - Shader.swift
  - teapot.obj
- - project.pbxproj
- - App.swift
  - MetalView.swift
  - Renderer.swift
  - Shader.metal
  - Shader.swift
  - spot.obj
  - spot_texture.png
  - spot_texture.svg
- - App.entitlements
  - CoreGraphics+Additions.swift
  - Foundation+Additions.swift
  - FrameTimer.swift
  - SIMD+Additions.swift
- - IDEWorkspaceChecks.plist
- contents.xcworkspacedata
- - contents.xcworkspacedata
- - CoreGraphics+Additions.swift
  - Foundation+Additions.swift
  - FrameTimer.swift
  - MetalView.swift
  - SIMD+Additions.swift
- contents.xcplayground
- - Page1.png
  - Page2.png
  - Page3.png
  - Page4.png
  - Page5.png
- - App.swift
  - FirstPass.metal
  - MetalView.swift
  - Renderer.swift
  - SecondPass.metal
  - Shaders.swift
- - project.pbxproj
- - CoreGraphics+Additions.swift
  - Foundation+Additions.swift
  - Page.entitlements
  - pikachu.mtl
  - pikachu.obj
  - pikachu.png
  - SIMD+Additions.swift
- - GrayScale.metal
  - main.swift
  - Processor.swift
- - Empty.metal
  - main.swift
- - project.pbxproj
- - CommandLine+Additions.swift
  - Foundation+Additions.swift
  - Metal+Additions.swift
.gitignore
LICENSE
README.md

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

This repo contains code with examples on how to use Apple's Metal GPU APIs. Some sample code has been created entirely by [me](https://github.com/dehesa), while others have been picked from Github. The latter ones are in this repo because they have been heavily modified, not only to support the latest version of Swift and SwiftUI, but also to add support to macOS, iOS, and tvOS. Links to the source Github repos or websites are provided.

## Projects

-   Playgrounds.

- Memory size, stride, and alignment.
    - `MTKView` as a Playground live view.

-   Command-Line apps.

<div>
 <details><summary>GPU Inspector.</summary>

Prints on `stdout` a brief description of all your available GPUs. For example:

```
    Apple M1 Max
      Built-in GPU
      Unified memory (shared with CPU)
        max recommended working set: 48 GB
      Feature set support
        family: apple 1, apple 2, apple 3, apple 4, apple 5, apple 6, apple 7, metal 3
      General Purpose Computing
        max threadgroup memory: 32 kB
        max threads per threadgroup: [1024, 1024, 1024]
        threads execution width: 32
    
    Intel(R) HD Graphics 530
      Built-in GPU (low power)
      Unified memory (shared with CPU)
        max recommended working set: 1.61 GB
      Feature set support
        family: common 1, common 2, common 3, apple 1, apple 2, apple 3, apple 4
      General Purpose Computing
        max threadgroup memory: 64 KB
        max threads per threadgroup: [1024, 1024, 1024]
        threads execution width: 32

AMD Radeon Pro 460
      Built-in GPU
      Discrete memory
        max recommended working set: 4.29 GB
      Feature set support
        family: common 1, common 2, common 3, apple 1, apple 2, apple 3, apple 4
      General Purpose Computing
        max threadgroup memory: 64 KB
        max threads per threadgroup: [1024, 1024, 1024]
        threads execution width: 64
    ```

</details>
 <details><summary>Gray converter.</summary>
 
 Transform an image into its gray-scale version.
 
 This command-line utitily expects a single argument indicating the location of the image to transform and outputs the gray scale version to the `~/Desktop` with name `out.png`.
 You can run it from Xcode by pressing ⌘ + R. This project scheme has an argument where you can specify a different image from the default image.

This utility is based on [Safx](https://github.com/safx)' gray converter [compute sample](https://github.com/safx/Metal-CommandLine-Sample-Swift).

</details>
 </div>

-   [Apple's sample code](https://developer.apple.com/metal/sample-code).

<details><summary>Basic Tessellation.</summary>

[This sample](https://developer.apple.com/library/content/samplecode/MetalBasicTessellation/Introduction/Intro.html) shows how to tessellate a triangle or quad patch with adjustable per-patch tessellation factors.

- [Metal by Example](https://metalbyexample.com).
 [Warren Moore](https://warrenmoore.net) wrote this book in 2015. It was and it remains one of the best introductions to Metal I have found.
 I've migrated most chapters to the latest Swift and I've added support to macOS.

- Clear Screen.
    - Draw 2D triangle.
    - Draw spinning 3D cube.
    - Draw spinning _teapot_ with manual lighting.
    - Draw spinning _cow_ with manual lighting and custom texture.

- [**Shader Exam**](https://github.com/leon196/SIGExam).
 [Leon Denise](http://leon196.github.io) wrote a [tweet](https://twitter.com/leondenise/status/953716696161882114) with a typical shader exam he gives to his students on [SupInfo.com](https://rubika-edu.com).
 - [Page 1](Shader%20Exam/Exam/Page1.png):
 [pass](Shader%20Exam/Page%201/SecondPass.metal#L35),
 [mirror](Shader%20Exam/Page%201/SecondPass.metal#L47),
 [symmetry](Shader%20Exam/Page%201/SecondPass.metal#L57),
 [rotation](Shader%20Exam/Page%201/SecondPass.metal#L67),
 [zoom](Shader%20Exam/Page%201/SecondPass.metal#L91),
 [zoomDistortion](Shader%20Exam/Page%201/SecondPass.metal#L103),
 [repetition](Shader%20Exam/Page%201/SecondPass.metal#L116),
 [spiral](Shader%20Exam/Page%201/SecondPass.metal#L128),
 [thunder](Shader%20Exam/Page%201/SecondPass.metal#L145).
 - [Page 2](Shader%20Exam/Exam/Page2.png): clamp, pli, color direction, pixelated, vague, column, crash, scanline, double frequency.
 - [Page 3](Shader%20Exam/Exam/Page3.png): black & white, threshold, thresholds, sonar, grill, stamp, local negative, chromatic aberration, chroma key
 - [Page 4](Shader%20Exam/Exam/Page4.png): vague, chubby, skinny, twist, glitch, voxel glitch, basic shading, toon shading, cell shading
 - [Page 5](Shader%20Exam/Exam/Page5.png): sphere, sphere repeat, pyramid, polar module, tube twist, tube web, volumetric cloud, strangler fig, kirby

sample-metal

File Explorer

Today's picks

Was this content helpful?

Recent Feedback

sample-metal

File Explorer

Today's picks

Was this content helpful?

Recent Feedback

Download README