L'APIMetal n'a pas son LearnOpenGL.com ! En dehors de la documentation d'Apple — dense, uniquement en anglais, Parfois datée et rarement pensée comme un parcours progressif — Il n'existe presque aucune ressource sur Metal, et en particulier sur Metal & C++.
Objectif de ce chapitre
Choisir ton environnement de développement (Make ou Xcode)
Créer le projet
Supprimer le Storyboard
Ajouter le flag adapté à ton environnement de travail (-fno-objc-arc ou -fobjc-weak)
Intégrer les wrappers metal-cpp et metal-cpp-extensions à ton projet
⏱ ~3 min
Prérequis
Aucune connaissance préalable
Un Mac Apple Silicon
Tu vas apprendre à programmer le GPU directement, en C++ et en MSL, sur Apple Silicon. Pas de framework tiers, pas d'abstraction opaque — On utilisera metal-cpp, le wrapper C++officiel d'Apple : Une fine couche de headers au-dessus de l'APIObjective-C native. Même ABI, zéro overhead, et on reste en C++ pur.
Autres langages hôtes possibles
Swift — bindings natifs, très propres, c'est ce qu'Apple met en avant.
Objective-C — l'APIMetal d'origine, toujours supportée à 100 %.
🔑 Astuce Wikipédia
Ce livre contient de nombreux liens Wikipédia. Il est recommandé de les consulter en anglais — Les articles techniques anglophones sont systématiquement plus complets, Mieux sourcés et plus à jour que leurs équivalents français.
La très grande majorité de la documentation est également en anglais : Pages man, Samples Apple Metal, Références C++, PDF de spécification, …
De nombreux raccourcis clavier sont répertoriés dans l'onglet Parcours.
Ce dont tu as besoin
Matériel
Ce livre est écrit sur un M2 Pro, qui expose Metal 4 et les Mesh Shaders — mais pas encore leur accélération matérielle (à partir du M3). Tout le code de ce livre est testé sur cette configuration. Un Mac équipé d'une puce Apple Silicon M1 ou plus récente suffit.
Pourquoi Apple Silicon ?
Sur les puces M, le CPU et le GPU partagent physiquement la même mémoire. Un buffer GPU n'est pas une copie — c'est le même bloc d'octets. Cela change fondamentalement la façon de concevoir un pipeline de données.
Tu peux également vérifier ta configuration en C++ grâce au programme proposé dans le parcours.
Logiciel
Xcode (gratuit sur le Mac App Store) — version 27 minimum.
Terminal (préinstallé). Il te fera gagner un temps considérable.
Création du projet
Personnalisé (make)
Xcode génère une multitude de fichiers : Ils constituent en réalité un programme que nous réécrirons de zéro.
Un Makefile n'est qu'un fichier supplémentaire qui facilite la compilation sans passer par Xcode. C'est la méthode la plus répandue dans le monde du développement — et très satisfaisante. Parfaite pour démarrer et comprendre ce qui se passe réellement. Le chapitre ↘ Makefile
Propose un exemple complet et commenté (en Shell). Attention aux tabulations !
Xcode (recommandé pour les projets plus importants)
Profilage GPU, débogueur Metal intégré et documentation accessible en deux clics.
Nouveau projet → Multiplateforme → Jeu →Metal ou Metal 4→Objective-C→ Crée un dépôt Git si tu veux sauvegarder ton travail.
→ Supprime le fichier Main.storyboard généré automatiquement par Xcode→ Puis, dans le fichier .plist, supprime l'entrée surlignée en bleu sur la capture d'écran → Main storyboard file base name (macOS).
Nous utiliserons une application partagée, entièrement pilotée depuis le code.
désolé pour le mode sombre
Récupérer metal-cpp et ses extensions
Point important concernant la documentation Apple (metal-cpp), que tu dois suivre : L'archive proposée au téléchargement ne contient pas les wrappers d'extensions (metal-cpp-extensions) de l'APIMetal.
Comme tu peux le voir sur la capture d'écran, l'archive metal-cpp_26.4.zip, Qui contient le dossier metal-cpp, ne comprend pas les wrappers AppKit & MetalKit.
Deux solutions s'offrent à toi : soit les récupérer dans le projet d'exemple de la WWDC 2022, Soit cloner le dépôt du cours :
# Shell — update:15/10/26
# Le cursus · The course · De cursus
git clone https://github.com/remdal/Metal-x-C---LearnMSL.dev.git learnmsl.dev-repository
# Les wrappers C++ du dépôt officiel d'Apple — sans metal-cpp-extensions, dont tu auras besoin
# The C++ wrappers from Apple's official repository — without metal-cpp-extensions, which you will need
# De C++-wrappers uit de officiële repository van Apple — zonder metal-cpp-extensions, die je wel nodig hebt
git clone https://github.com/apple/metal-cpp.git metal-cpp
Les wrappers se trouvent dans le dossier Frameworks/ du dépôt du cours.
Régler les flags (Xcode uniquement)
Trois réglages à modifier dans Build Settings, au même endroit que la capture précédente. Utilise le champ de recherche en haut à droite :
Dans Build Settings→ Recherche →C++
Apple Clang - Language - C++→C++ Language Dialect →C++17 [-std=c++17]
Apple Clang - Custom Compiler Flags → Other C++ Flags →-fno-objc-arc(double-clic)
-fno-objc-arc : metal-cpp gère lui-même les compteurs de références.
Si tu as plusieurs Targets (macOS & iOS par exemple), répète ces réglages pour chacune.
À partir du moment où vous incluez Métal dans votre application, le mode de jeu performance s’enclenche.
Quelques rappels
Programme
Un programme est composé de fichiers source — du texte — Que le compilateur traduit en binaire : du code machine exécutable par le processeur.
Dans ce cours, deux compilateurs travaillent en parallèle : clang compile le C++ et l'Objective-C++ en un exécutable pour le CPU, metal compile le MSL en une bibliothèque .metallib pour le GPU.
Un pixel (picture element) est la plus petite unité adressable d'un écran : Une case dans une grille 2D — ton framebuffer — qui stocke une couleur.
Un écran 1920×1080 contient 2 073 600 cases ; un écran 1280×720 en contient 921 600. Le GPU remplit ces cases à chaque frame.
En Metal, ces cases sont alimentées par des fragments : Ce que produit la fonction de fragment, un float4 (R, G, B, A). Attention, un fragment n'est pas exactement un pixel — Plusieurs fragments peuvent contribuer à la même case (recouvrement, MSAA) Et certains sont éliminés avant d'être écrits (test de profondeur, discard).
Sous-pixels
Physiquement, un pixel est composé de trois sous-pixels — rouge, vert, bleu. C'est leur intensité relative qui produit la couleur perçue.
Certains panneaux ajoutent un quatrième sous-pixel blanc (RGBW sur certains LCD, WRGB sur les OLED de téléviseurs) pour gagner en luminosité.
L'alpha, lui, n'existe pas côté écran : C'est une notion purement logicielle qui indique au GPU à quel point un fragment est opaque, utilisée pour le blending.