Rephrased and renamed Vertex buffer -> Vertex input description

Alexis Ronez · Alexis Ronez · commit 8bf834e0f515 · 2019-06-17T18:17:59.000+02:00
diff --git a/fr/04_Vertex_buffers/00_Description_des_entrées_des_sommets.md b/fr/04_Vertex_buffers/00_Description_des_entrées_des_sommets.md
@@ -1,14 +1,15 @@
 ## Introduction
 
-Dans les quatres prochains chapitres nous allons remplacer les vertices inscrites dans le vertex shader par un vertex
-buffer stocké dans la mémoire de la carte graphique. Nous commencerons par une manière simple de procéder en créeant un
+Dans les quatres prochains chapitres nous allons remplacer les sommets inscrits dans le vertex shader par un vertex
+buffer stocké dans la mémoire de la carte graphique. Nous commencerons par une manière simple de procéder en créant un
 buffer manipulable depuis le CPU et en y copiant des données avec `memcpy`. Puis nous verrons comment avantageusement
-utiliser un _staging buffer_ pour accéder à de la mémoire de haute performance.
+utiliser un *staging buffer* pour accéder à de la mémoire de haute performance.
 
 ## Vertex shader
 
-Premièrement, changeons le vertex shader pour ne plus avoir les données dans son code. Ce shader prendra en entrée des
-données utilisées par des variables. Nous indiquons cela en les annotant du mot-clé `in`.
+Premièrement, changeons le vertex shader en retirant les coordonnées des sommets de son code. Elles seront maintenant
+stockés dans une variable. Elle sera liée au contenu du vertex buffer, ce qui est indiqué par le mot-clef `in`. Faisons
+de même avec la couleur.
 
 ```glsl
 #version 450
@@ -29,7 +30,7 @@ void main() {
 }
 ```
 
-Les variables `inPosition` et `inColor` sont des _vertex attributes_. Ce sont des propriétés spécifiques du vertex à
+Les variables `inPosition` et `inColor` sont des *vertex attributes*. Ce sont des propriétés spécifiques du sommet à
 l'origine de l'invocation du shader. Ces données peuvent être de différentes natures, des couleurs aux coordonnées en
 passant par des coordonnées de texture. Recompilez ensuite le vertex shader.
 
@@ -46,10 +47,10 @@ layout(location = 2) in vec3 inColor;
 Vous pouvez trouver plus d'information sur les qualificateurs d'organisation sur
 [le wiki](https://www.khronos.org/opengl/wiki/Layout_Qualifier_(GLSL)).
 
-## Vertices
+## Sommets
 
-Nous déplaçons les données des vertices depuis le code du shader jusqu'au code C++. Commencez par inclure la librairie
-GLM, afin d'utiliser deds vecteurs et des matrices. Nous allons utiliser ces types pour les vecteurs de position et de
+Nous déplaçons les données des sommets depuis le code du shader jusqu'au code C++. Commencez par inclure la librairie
+GLM, afin d'utiliser des vecteurs et des matrices. Nous allons utiliser ces types pour les vecteurs de position et de
 couleur.
 
 ```c++
@@ -75,17 +76,17 @@ const std::vector<Vertex> vertices = {
 };
 ```
 
-Nous utilisons ensuite un tableau de structures pour représenter un ensemble de vertices. Nous utilisons les mêmes
-couleurs et les mêmes positions qu'avant, mais elles sont maintenant combinées en un seul tableau d'objets.
+Nous utiliserons ensuite un tableau de structures pour représenter un ensemble de sommets. Nous utiliserons les mêmes
+couleurs et les mêmes positions qu'avant, mais elles seront combinées en un seul tableau d'objets.
 
 ## Lier les descriptions
 
-La prochaine étape consiste à informer Vulkan de la manière de passer ces données au shader une fois qu'elles sont
+La prochaine étape consiste à indiquer à Vulkan comment passer ces données au shader une fois qu'elles sont
 stockées dans le GPU. Nous verrons plus tard comment les y stocker. Il y a deux types de structures que nous allons
 devoir utiliser.
 
 Pour la première, appelée `VkVertexInputBindingDescription`, nous allons ajouter une fonction à `Vertex` qui renverra
-une instance de cette structure.
+une instance de cette structure. 
 
 ```c++
 struct Vertex {
@@ -101,7 +102,8 @@ struct Vertex {
 ```
 
 Un *vertex binding* décrit la lecture des données stockées en mémoire. Elle fournit le nombre d'octets entre les jeux de
-données et la manière de passer d'un ensemble de données (par exemple une coordonnée) au suivant.
+données et la manière de passer d'un ensemble de données (par exemple une coordonnée) au suivant. Elle permet à Vulkan
+de savoir comment extraire chaque jeu de données correspondant à une invocation du vertex shader du vertex buffer.
 
 ```c++
 VkVertexInputBindingDescription bindingDescription = {};
@@ -116,10 +118,10 @@ séparant les débuts de deux ensembles de données, c'est à dire l'écart entr
 invocation de vertex shader et celles devant être fournies à la suivante. Enfin `inputRate` peut prendre les valeurs
 suivantes :
 
-* `VK_VERTEX_INPUT_RATE_VERTEX`: Passer au jeu de données suivante après chaque vertex
+* `VK_VERTEX_INPUT_RATE_VERTEX`: Passer au jeu de données suivante après chaque sommet
 * `VK_VERTEX_INPUT_RATE_INSTANCE`: Passer au jeu de données suivantes après chaque instance
 
-Nous n'utilisons pas d'_instanced rendering_ donc nous utiliserons la première valeur disponible.
+Nous n'utilisons pas d'*instanced rendering* donc nous utiliserons `VK_VERTEX_INPUT_RATE_VERTEX`.
 
 ## Description des attributs
 
@@ -139,8 +141,9 @@ static std::array<VkVertexInputAttributeDescription, 2> getAttributeDescriptions
 ```
 
 Comme le prototype le laisse entendre, nous allons avoir besoin de deux de ces structures. Elles décrivent chacunes
-l'extraction d'un paquet de données provenant d'un vertex binding. Nous avons deux attributs, la couleur et la position,
-c'est pourquoi nous avons besoin de deux structures.
+l'origine et la nature des données stockées dans une variable shader annotée du `location=x`, et la manière d'en
+déterminer les valeurs depuis les données extraites par le binding. Comme nous avons deux de
+ces variables, nous avons besoin de deux de ces structures. Voici ce qu'il faut remplir pour la position.
 
 ```c++
 attributeDescriptions[0].binding = 0;
@@ -149,10 +152,10 @@ attributeDescriptions[0].format = VK_FORMAT_R32G32_SFLOAT;
 attributeDescriptions[0].offset = offsetof(Vertex, pos);
 ```
 
-Le paramètre `binding` informe Vulkan de la provenance des données vertex par vertex, en lui fournissant le vertex
-binding qui les a extraites. Le paramètre `location` correspond à la valeur donnée à la directive `location` dans le
-code du vertex shader. Dans notre cas l'entrée `0` correspond à la position du vertex stockée dans un vertex de floats
-de 32 bits.
+Le paramètre `binding` informe Vulkan de la provenance des données du sommet qui mené à l'invocation du vertex shader,
+en lui fournissant le vertex binding qui les a extraites. Le paramètre `location` correspond à la valeur donnée à la
+directive `location` dans le code du vertex shader. Dans notre cas l'entrée `0` correspond à la position du sommet
+stockée dans un vecteur de floats de 32 bits.
 
 Le paramètre `format` permet donc de décrire le type de donnée de l'attribut. Étonnement les formats doivent être
 indiqués avec des valeurs énumérées dont les noms semblent correspondre à des gradients de couleur :
@@ -165,8 +168,8 @@ indiqués avec des valeurs énumérées dont les noms semblent correspondre à d
 Comme vous pouvez vous en douter il faudra utiliser le format dont le nombre de composants de couleurs correspond au
 nombre de données à transmettre. Il est autorisé d'utiliser plus de données que ce qui est prévu dans le shader, et ces
 données surnuméraires seront silencieusement ignorées. Si par contre il n'y a pas assez de valeurs les valeurs suivantes
-seront utilisées par défaut pour les valeurs manquantes : 0, 0 et 1 pour les deuxièmes, troisièmes et quatrièmes 
-composantes. Il n'y a pas de valeur par défaut pour le premier membre car ce cas n'est pas possible. Les types 
+seront utilisées par défaut pour les valeurs manquantes : 0, 0 et 1 pour les deuxième, troisième et quatrième
+composantes. Il n'y a pas de valeur par défaut pour le premier membre car ce cas n'est pas autorisé. Les types 
 (`SFLOAT`, `UINT` et `SINT`) et le nombre de bits doivent par contre correspondre parfaitement à ce qui est indiqué dans
 le shader. Voici quelques exemples :
 
@@ -175,9 +178,13 @@ le shader. Voici quelques exemples :
 bits
 * `double` correspond à `VK_FORMAT_R64_SFLOAT` et est un float à précision double (donc de 64 bits)
 
-Le paramètre `format` définit implicitement la taille en octets des données tandis que le paramètre `offset` définit le
-nombre d'octets à lire depuis le début des données vertex par vertex. Notre binding charge le contenu d'un `Vertex`
-à la fois, et l'`offset` sera calculé par la macro `offsetof`.
+Le paramètre `format` définit implicitement la taille en octets des données. Mais le binding extrait dans notre cas deux
+données pour chaque sommet : la position et la couleur. Pour savoir quels octets doivent être mis dans la variable à
+laquelle la structure correspond, le paramètre `offset` permet d'indiquer de combien d'octets il faut se décaler dans
+les données extraites pour se trouver au début de la variable. Ce décalage est calculé automatiquement par la macro
+`offsetof`.
+
+L'attribut de couleur est décrit de la même façon. Essayez de le remplir avant de regarder la solution ci-dessous.
 
 ```c++
 attributeDescriptions[1].binding = 0;
@@ -186,13 +193,10 @@ attributeDescriptions[1].format = VK_FORMAT_R32G32B32_SFLOAT;
 attributeDescriptions[1].offset = offsetof(Vertex, color);
 ```
 
-L'attribut de couleur est décrit de la même façon. Essayez de le remplir avant de regarder la solution dans le code
-fourni.
-
-## Entrée des vertices dans la pipeline
+## Entrée des sommets dans la pipeline
 
-Nous devons maintenant mettre en place la réception par la pipeline graphique des données de vertices. Nous allons
-modifier une structures dans `createGraphicsPipeline`. Trouvez `vertexInputInfo` et ajoutez-y les références aux deux
+Nous devons maintenant mettre en place la réception par la pipeline graphique des données des sommets. Nous allons
+modifier une structure dans `createGraphicsPipeline`. Trouvez `vertexInputInfo` et ajoutez-y les références aux deux
 structures de description que nous venons de créer :
 
 ```c++
@@ -206,7 +210,7 @@ vertexInputInfo.pVertexAttributeDescriptions = attributeDescriptions.data();
 ```
 
 La pipeline peut maintenant accepter les données des vertices dans le format que nous utilisons et les fournir au vertex
-shader. Si  vous lancez le programme vous verrez que les validation layers rapportent qu'aucun vertex buffer n'est mis
+shader. Si vous lancez le programme vous verrez que les validation layers rapportent qu'aucun vertex buffer n'est mis
 en place. Nous allons donc créer un vertex buffer et y placer les données pour que le GPU puisse les utiliser.
 
 [Code C++](/code/17_vertex_input.cpp) /
