Contents · Table des matières

Explorer les possibilitées actuelles !

Table des matières

+ Référence rapide — chaque problème courant et où le résoudre sur le site.

↘ Arguments de l'application .app

↘ Objective-C++ vs C++ : synthaxe

↘ Couleurs prévisualitation RGB (web isn't P3)

↘ Lecture documentation Objective-C

↘ Make

↘ Icon de l'application .app

↘ Configuration VIM .vimrc

↘ Configuration ZSH .zshrc

↘ Configuration d'un header en haut de tes fichiers *_*

↘ Affichage du HUD dans Xcode

↘ Informations sur les licences des dépendances externes

→ L'Open Source, C'est quoi ?

↘ C++ : L'opération ternaire

↘ C++ : L'opération modulo

↘ Les modes de stockage des textures : setStorageMode()

↘ Usage flags textures : setUsage()

↘ Les fonctions de comparaison de profondeur Z+ : setDepthCompareFunction()

Fichiers

↘ Fichier .entitlements

Récapitulatif

Vous arrivez au bout de la partie Prise en main. À ce stade, vous savez ouvrir une fenêtre et y accrocher une CAMetalLayer, obtenir un MTLDevice et une MTLCommandQueue, compiler un fichier .metal en MTLLibrary, construire un MTLRenderPipelineState, encoder une passe de rendu, envoyer des sommets au GPU via un MTLBuffer, échantillonner une MTLTexture, et enchaîner les matrices de simd jusqu'à obtenir une scène 3D avec une caméra contrôlable.

Cela fait beaucoup de notions en peu de chapitres. Avant de continuer, prenez le temps de manipuler ce que vous avez écrit : changez les formats de pixels, cassez volontairement le descripteur de vertex pour voir ce que le validateur vous dit, remplacez un setVertexBytes par un vrai buffer, ajoutez un deuxième objet à la scène. Les erreurs que vous provoquez vous-même sont celles que vous saurez diagnostiquer plus tard.

Trois pièges qui reviennent souvent

  • Le NDC de Metal a un z compris entre 0 et 1, pas entre -1 et 1. Une matrice de projection recopiée d'un tutoriel OpenGL donnera une profondeur fausse.
  • L'origine des coordonnées de texture est en haut à gauche. Si vos textures apparaissent à l'envers, c'est presque toujours ça.
  • Les ressources sont liées par numéro de slot ([[buffer(1)]]), jamais par nom. Décaler un index d'un cran ne produit aucune erreur de compilation, seulement un rendu absurde.

Quand vous vous sentez à l'aise avec l'ensemble, passez à la partie Éclairage.

Glossaire

Fondations

Soumission du travail

Pipeline et état

Ressources

Shaders et MSL

Mathématiques et espaces

Structure du projet — chaque fichier, à quoi il sert

Tout le projet du cours, tel qu'il est à la fin des chapitres : les sources, les shaders, les en-têtes partagés entre le CPU et le GPU, les ressources, et tout ce que make fabrique à côté. L'arbre est lu en direct dans le projet reconstruit à partir des chapitres : un fichier ajouté dans un chapitre apparaît ici tout seul.

Clique sur un nœud pour voir son rôle, les chapitres qui le montrent et, s'il est généré, la commande qui le produit. Les nœuds en pointillé n'existent pas encore chez toi, mais tu les verras apparaître : fichiers temporaires d'un éditeur, d'Xcode ou de clangd.

Du code source à l'application

Clique sur un nœud du schéma pour le retrouver dans l'arbre.

L'arborescence

Le .gitignore qui va avec

Tout ce qui est orange ou en pointillé dans l'arbre se reconstruit ou n'appartient qu'à ta machine : ça n'a rien à faire dans git. Cette liste est générée à partir de l'arbre ci-dessus.

Pourquoi Xcode n'apparaît pas

Avec Xcode, les fichiers intermédiaires (.o, .air, l'.app) ne sont pas dans ton dossier : ils vont dans ~/Library/Developer/Xcode/DerivedData/, un dossier par projet. Si Xcode se met à compiler n'importe quoi après un gros changement, supprimer ce dossier (Product ▸ Clean Build Folder, ou à la main) repart de zéro. Ton dossier ne garde que le .xcodeproj, et dedans, xcuserdata/ : tes onglets et points d'arrêt, à ne pas versionner.