diff options
Diffstat (limited to 'files/fr/web/api/webgl_api/by_example')
15 files changed, 1772 insertions, 0 deletions
diff --git a/files/fr/web/api/webgl_api/by_example/appliquer_des_couleurs/index.html b/files/fr/web/api/webgl_api/by_example/appliquer_des_couleurs/index.html new file mode 100644 index 0000000000..1d8db41a20 --- /dev/null +++ b/files/fr/web/api/webgl_api/by_example/appliquer_des_couleurs/index.html @@ -0,0 +1,100 @@ +--- +title: Appliquer des couleurs +slug: Web/API/WebGL_API/By_example/Appliquer_des_couleurs +tags: + - Apprendre + - Débutant + - Exemple + - Graphisme + - Tutoriel + - WebGL +translation_of: Web/API/WebGL_API/By_example/Clearing_with_colors +--- +<div>{{IncludeSubnav("/fr/Apprendre")}}</div> + +<p>{{PreviousNext("Apprendre/WebGL/Par_exemple/Détecter_WebGL","Apprendre/WebGL/Par_exemple/Appliquer_une_couleur_%C3%A0_la_souris")}}</p> + +<p class="summary">Dans cet article, on voit comment appliquer une couleur unie dans le contexte de rendu.</p> + +<p>{{EmbedLiveSample("Appliquer_une_couleur_unie_dans_le_contexte_WebGL",660,300)}}</p> + +<h3 id="Appliquer_une_couleur_unie_dans_le_contexte_WebGL">Appliquer une couleur unie dans le contexte WebGL</h3> + +<p>Voici l'application la plus simple de {{Glossary("WebGL")}} : appliquer un vert uni dans le {{domxref("WebGLRenderingContext","contexte de rendu")}}. On notera que la feuille de style {{Glossary("CSS")}} définit l'arrière-plan comme étant noir. Ainsi, quand le canevas s'affiche en vert, on sait que {{Glossary("WebGL")}} a fonctionné comme il fallait.</p> + +<p>Par ailleurs, vous pouvez remarquer que, pour appliquer une couleur unie sur le tampon (<em>buffer</em>) de dessin, on utilise deux étapes. Tout d'abord, on applique la couleur verte grâce à la méthode {{domxref("WebGLRenderingContext.clearColor()","clearColor()")}}. Cette opération ne modifie que l'état interne de {{Glossary("WebGL")}}, rien n'est peint/affiché pour le moment. Ensuite, on dessine « réellement » avec la méthode {{domxref("WebGLRenderingContext.clear()","clear()")}}. C'est la méthode classique pour dessiner avec WebGL. Il y a seulement quelques méthodes qui « dessinent » (dont <code>clear()</code>), toutes les autres méthodes permettent d'obtenir ou de modifier les variables liées aux états de WebGL (dont la couleur à appliquer).</p> + +<p>Il existe de nombreuses options pour modifier les états {{Glossary("WebGL")}}. La couleur à appliquer en est une parmi d'autres.{{Glossary("WebGL")}}/{{Glossary("OpenGL")}} est souvent qualifié d'automate à états. En fait, lorsque vous manipulez ces variables internes, ces « interrupteurs », vous modifiez l'état interne de WebGL, qui modifie à son tour la façon dont la sortie est retranscrite (dans cet exemple, cela correspond à l'étape où les pixels sont passés en vert).</p> + +<p>Enfin, vous pouvez voir que les couleurs manipulées en WebGL sont décrites avec le format {{Glossary("RGBA")}}. Ce format décrit quatre composantes numériques pour les intensités respectives des tons rouge (R), vert (<em>green</em> G), bleu (B) et alpha (qui correspond à l'opacité). C'est pour ça que <code>clearColor()</code> prend quatre arguments.</p> + +<pre class="brush: html"><p>Un programme WebGL très simple qui affiche une couleur.</p> +<!-- Le texte d'un élément canvas est affiché uniquement + si canvas n'est pas supporté. --> +<canvas>Il semblerait que votre navigateur ne supporte pas + le canevas HTML5</canvas> +</pre> + +<pre class="brush: css">body { + text-align : center; +} +canvas { + display : block; + width : 280px; + height : 210px; + margin : auto; + padding : 0; + border : none; + background-color : black; +} +</pre> + +<pre class="brush: js">// On exécute tout dans le gestionnaire d'événement +// correspondant au chargement de la fenêtre. De cette +// façon, le DOM est complètement chargé et mis en forme +// avant de le manipuler et d'encombrer la portée globale. +// On donne un nom au gestionnaire (setupWebGL) afin de +// pouvoir y faire référence par la suite. +window.addEventListener("load", function setupWebGL (evt) { + "use strict" + + // On fait le ménage : le gestionnaire se supprime lui- + // même car il n'a besoin d'être exécuté qu'une fois. + window.removeEventListener(evt.type, setupWebGL, false); + + // On fait référence aux éléments du document. + var paragraph = document.querySelector("p"), + canvas = document.querySelector("canvas"); + + // On récupère le contexte de rendu WebGL. + var gl = canvas.getContext("webgl") + || canvas.getContext("experimental-webgl"); + + // Si cela échoue, on informe l'utilisateur. + // Sinon, on initialise la zone de dessin et on + // applique une couleur dans le contexte. + if (!gl) { + paragraph.innerHTML = "Échec de la récupération du " + + "contexte WebGL. Votre navigateur peut ne pas " + + " supporter WebGL."; + return; + } + paragraph.innerHTML = + "Félicitations, votre navigateur supporte WebGL. "; + gl.viewport(0, 0, + gl.drawingBufferWidth, gl.drawingBufferHeight); + + // On définit la couleur qu'on veut appliquer + // (ici un vert foncé). + gl.clearColor(0.0, 0.5, 0.0, 1.0); + + // Enfin, on applique la couleur dans le contexte. C'est + // cette fonction qui « dessine » réellement quelque chose. + gl.clear(gl.COLOR_BUFFER_BIT); + +}, false); +</pre> + +<p>Le code source de cet exemple est également disponible sur <a href="https://github.com/idofilin/webgl-by-example/tree/master/clearing-with-colors">GitHub</a>.</p> + +<div>{{PreviousNext("Apprendre/WebGL/Par_exemple/Détecter_WebGL","Apprendre/WebGL/Par_exemple/Appliquer_une_couleur_%C3%A0_la_souris")}}</div> diff --git a/files/fr/web/api/webgl_api/by_example/appliquer_des_découpes_simples/index.html b/files/fr/web/api/webgl_api/by_example/appliquer_des_découpes_simples/index.html new file mode 100644 index 0000000000..3995861e83 --- /dev/null +++ b/files/fr/web/api/webgl_api/by_example/appliquer_des_découpes_simples/index.html @@ -0,0 +1,90 @@ +--- +title: Appliquer des découpes simples +slug: Web/API/WebGL_API/By_example/Appliquer_des_découpes_simples +tags: + - Apprendre + - Débutant + - Exemple + - Graphisme + - Tutoriel + - WebGL +translation_of: Web/API/WebGL_API/By_example/Basic_scissoring +--- +<div>{{IncludeSubnav("/fr/Apprendre")}}</div> + +<p>{{PreviousNext("Apprendre/WebGL/Par_exemple/Masque_de_couleur","Apprendre/WebGL/Par_exemple/Tailles_de_canvas_et_WebGL")}}</p> + +<p class="summary">Dans cet article, on illustre comment dessiner des rectangles et des carrés grâce à des opérations de découpe simple (<em>scissoring</em>).</p> + +<p>{{EmbedLiveSample("Appliquer_les_changements_sur_le_buffer_lors_de_la_découpe",660,330)}}</p> + +<h3 id="Appliquer_les_changements_sur_le_buffer_lors_de_la_découpe">Appliquer les changements sur le <em>buffer</em> lors de la découpe</h3> + +<p>Voici une démonstration simple des opérations appliquées sur le contexte de rendu avec la méthode {{domxref("WebGLRenderingContext.scissor","scissor")}}.</p> + +<p>La commande {{domxref("WebGLRenderingContext.clear","clear()")}} permet de dessiner la couleur d'applique (définie à l'aide de {{domxref("WebGLRenderingContext.clearColor","clearColor()")}}) sur tous les pixels du tampon (<em>buffer</em>) de dessin. La commande {{domxref("WebGLRenderingContext.scissor","scissor()")}} permet quant à elle de définir un masque qui permet de ne modifier que les pixels contenus dans un rectangle donné.</p> + +<p>Cet article représente une excellente occasion pour distinguer les <em>pixels</em> des <em>fragments</em>. Un pixel est un élément d'une image (en pratique c'est un point) sur l'écran ou un élément unique du tampon de dessin (l'espace mémoire qui contient les données relatives aux pixels comme les différentes composantes couleur). Un <em>fragment</em> fait référence au pixel manipulé par les processus {{Glossary("WebGL")}}.</p> + +<p>Cette distinction existe car la couleur d'un fragment (et ses autres caractéristiques comme la profondeur) peut être manipulée et modifiée à plusieurs reprises avant d'être écrite à l'écran. On a déjà vu comment la couleur d'un fragment pouvait être modifiée au cours des opérations graphiques en appliquant un {{domxref("WebGLRenderingContext.colorMask()","masque de couleur", "", 1)}}. Il existe d'autres cas où les fragments sont ignorés (le pixel n'est pass mis à jour) ou d'autres où ils interagissent avec la valeur du pixel existant (afin de fusionner les couleurs pour les éléments transparents qui composent une scène).</p> + +<p>Ici, on voit une autre distinction entre les fragments et les pixels. La découpe est une étape distincte du processus graphique de {{Glossary("WebGL")}}/{{Glossary("OpenGL")}} (elle est traitée après l'applique de couleur et avant le masque de couleur). Avant que les pixels réels soient mis à jour, les fragments doivent passer le test de la découpe. S'ils réussissent ce test, ils continuent dans le processus de traitement et les pixels correspondants sont mis à jours. S'ils échouent, le processus rejette les fragments et ils ne sont plus gérés pour les traitements ultérieurs, les pixels correspondants ne seront pas mis à jour. Seuls les fragments appartenant à la zone rectangulaire donnée réussissent le test et seuls les pixels correspondants sont mis à jour. Au final, on obtient un rectangle qui est dessiné à l'écran.</p> + +<p>Par défaut, l'étape de découpe est désactivée dans le processus. Ici, on l'active avec la méthode {{domxref("WebGLRenderingContext.enable","enable()")}} (<code>enable()</code> sera utilisée pour activer de nombreuses autres fonctionnalités liées à WebGL) avec la constante <code>SCISSOR_TEST</code>. Là aussi, on voit l'ordre généralement utilisé pour les commandes {{Glossary("WebGL")}}. Tout d'abord, on modifie l'état de WebGL (ici on active le test de découpe et on crée un masque rectangulaire). Une fois que l'état a bien été modifié, on exécute les commandes de dessin (ici <code>clear()</code>) pour commencer le processus de traitement des fragments.</p> + +<pre class="brush: html"><p>Le résultat de la découpe.</p> +<canvas>Il semblerait que votre navigateur + ne supporte pas l'élément canvas.</canvas> +</pre> + +<pre class="brush: css">body { + text-align : center; +} +canvas { + display : block; + width : 280px; + height : 210px; + margin : auto; + padding : 0; + border : none; + background-color : black; +} +</pre> + +<pre class="brush: js" id="livesample-js">window.addEventListener("load", function setupWebGL (evt) { + "use strict" + window.removeEventListener(evt.type, setupWebGL, false); + var paragraph = document.querySelector("p"); + var canvas = document.querySelector("canvas"); + + // Les deux lignes suivantes définissent la taille, + // en pixels CSS, du buffer de dessin qui est la même + // que celle du canevas (définie avec CSS). + canvas.width = canvas.clientWidth; + canvas.height = canvas.clientHeight; + + var gl = canvas.getContext("webgl") + || canvas.getContext("experimental-webgl"); + if (!gl) { + paragraph.innerHTML = "Échec de la récupération du " + + "contexte WebGL. Votre navigateur pourrait ne pas " + + "supporter WebGL."; + return; + } + gl.viewport(0, 0, + gl.drawingBufferWidth, gl.drawingBufferHeight); + + // On applique une découpe et on définit la taille de + // la zone de découpe. + gl.enable(gl.SCISSOR_TEST); + gl.scissor(40, 20, 60, 170); + + // On applique un jaune uni dans le contexte de rendu. + gl.clearColor(1.0, 1.0, 0.0, 1.0); + gl.clear(gl.COLOR_BUFFER_BIT); +}, false); +</pre> + +<p>Le code source de cet exemple est également disponible sur <a href="https://github.com/idofilin/webgl-by-example/tree/master/basic-scissoring">GitHub</a>.</p> + +<p>{{PreviousNext("Apprendre/WebGL/Par_exemple/Masque_de_couleur","Apprendre/WebGL/Par_exemple/Tailles_de_canvas_et_WebGL")}}</p> diff --git a/files/fr/web/api/webgl_api/by_example/appliquer_une_couleur_à_la_souris/index.html b/files/fr/web/api/webgl_api/by_example/appliquer_une_couleur_à_la_souris/index.html new file mode 100644 index 0000000000..7ca07c36e6 --- /dev/null +++ b/files/fr/web/api/webgl_api/by_example/appliquer_une_couleur_à_la_souris/index.html @@ -0,0 +1,122 @@ +--- +title: Appliquer une couleur à la souris +slug: Web/API/WebGL_API/By_example/Appliquer_une_couleur_à_la_souris +tags: + - Apprendre + - Débutant + - Exemple + - Graphisme + - Tutoriel + - WebGL +translation_of: Web/API/WebGL_API/By_example/Clearing_by_clicking +--- +<div>{{IncludeSubnav("/fr/Apprendre")}}</div> + +<p>{{PreviousNext("Apprendre/WebGL/Par_exemple/Appliquer_des_couleurs","Apprendre/WebGL/Par_exemple/Cr%C3%A9er_une_animation_color%C3%A9e")}}</p> + +<p class="summary">Dans cet article, on voit comment combiner les interactions de l'utilisateur et les opérations graphiques. Plus précisément, dans cet exemple, chaque clic de l'utilisateur déclenchera l'application d'une couleur aléatoire dans le contexte de rendu.</p> + +<p>{{EmbedLiveSample("Appliquer_des_couleurs_aléatoires_dans_le_contexte_de_rendu",660,410)}}</p> + +<h3 id="Appliquer_des_couleurs_aléatoires_dans_le_contexte_de_rendu">Appliquer des couleurs aléatoires dans le contexte de rendu</h3> + +<p>Cet exemple illustre simplement comment associer WebGL aux interactions utilisateur. Chaque fois que l'utilisateur cliquera sur le canevas ou sur le bouton, une couleur aléatoire sera appliquée sur le contexte de rendu.</p> + +<p>Ici, on montre comment on place les appels aux fonctions WebGL dans la fonction qui gère les événements :</p> + +<pre class="brush: html"><p>Un programme WebGL très simple qui affiche des couleurs + suite aux interactions utilisateur.</p> +<p>Vous pouvez cliquer sur le canevas ou sur le bouton pour + modifier la couleur.</p> +<canvas id="canvas-view">Il semblerait que votre navigateur + ne supporte pas l'élément canvas.</canvas> +<button id="color-switcher">Cliquez ici pour changer la couleur</button> +</pre> + +<pre class="brush: css">body { + text-align : center; +} +button { + display : inline-block; + font-size : inherit; + margin : auto; + padding : 0.6em; +} +canvas { + display : block; + width : 280px; + height : 210px; + margin : auto; + padding : 0; + border : none; + background-color : black; +} +</pre> + +<pre class="brush: js">// On exécute tout dans le gestionnaire d'événement +// correspondant au chargement de la fenêtre. De cette +// façon, le DOM est complètement chargé et mis en forme +// avant de le manipuler et d'encombrer la portée globale. +// On donne un nom au gestionnaire (setupWebGL) afin de +// pouvoir y faire référence par la suite. +window.addEventListener("load", function setupWebGL (evt) { + "use strict" + + // On fait le ménage : le gestionnaire se supprime lui- + // même car il n'a besoin d'être exécuté qu'une fois. + window.removeEventListener(evt.type, setupWebGL, false); + + // On ajoute le même gestionnaire de clic sur le canevas + // et sur le bouton. + var canvas = document.querySelector("#canvas-view"); + var button = document.querySelector("#color-switcher"); + canvas.addEventListener("click", switchColor, false); + button.addEventListener("click", switchColor, false); + + // On crée une variable qui contiendra WebGLRenderingContext. + var gl; + + // La déclaration du gestionnaire d'événement pour le clic. + function switchColor () { + + // On utilise la variable gl définie en dehors. + // Si elle n'est pas définie, on récupère WebGLRenderingContext. + // Si cela échoue, on avertit l'utilisateur. Sinon, on + // initialise la zone de dessin (viewport) + if (!gl) { + gl = canvas.getContext("webgl") + || canvas.getContext("experimental-webgl"); + if (!gl) { + alert("Échec de la récupération du \n" + + "contexte WebGL. Votre navigateur peut ne pas \n" + + " supporter WebGL."); + return; + } + gl.viewport(0, 0, + gl.drawingBufferWidth, gl.drawingBufferHeight); + } + + // On obtient une couleur aléatoire grâce + // à une fonction auxiliaire. + var color = getRandomColor(); + + // On choisit cette couleur comme couleur à appliquer. + gl.clearColor(color[0], color[1], color[2], 1.0); + + // On applique la nouvelle couleur dans le contexte. + // C'est cette fonction qui effectue « réellement » + // le dessin sur la zone. + gl.clear(gl.COLOR_BUFFER_BIT); + } + + // Une fonction auxiliaire pour créer une couleur aléatoire. + function getRandomColor() { + return [Math.random(), Math.random(), Math.random()]; + } + +}, false); +</pre> + +<p>Le code source de cet exemple est également disponible sur <a href="https://github.com/idofilin/webgl-by-example/tree/master/clearing-by-clicking">GitHub</a>.</p> + +<div>{{PreviousNext("Apprendre/WebGL/Par_exemple/Appliquer_des_couleurs","Apprendre/WebGL/Par_exemple/Cr%C3%A9er_une_animation_color%C3%A9e")}}</div> diff --git a/files/fr/web/api/webgl_api/by_example/créer_une_animation_avec_découpe_et_applique/index.html b/files/fr/web/api/webgl_api/by_example/créer_une_animation_avec_découpe_et_applique/index.html new file mode 100644 index 0000000000..8eb25287ab --- /dev/null +++ b/files/fr/web/api/webgl_api/by_example/créer_une_animation_avec_découpe_et_applique/index.html @@ -0,0 +1,162 @@ +--- +title: Créer une animation avec découpe et applique +slug: Web/API/WebGL_API/By_example/Créer_une_animation_avec_découpe_et_applique +tags: + - Apprendre + - Débutant + - Exemple + - Graphisme + - Tutoriel + - WebGL +translation_of: Web/API/WebGL_API/By_example/Scissor_animation +--- +<div>{{IncludeSubnav("/fr/Apprendre")}}</div> + +<p>{{PreviousNext("Apprendre/WebGL/Par_exemple/Modèle_1","Apprendre/WebGL/Par_exemple/Une_pluie_de_rectangle")}}</p> + +<p class="summary">Dans cet article, on voit comment créer des animations grâce à des opérations de découpe et d'applique.</p> + +<p>{{EmbedLiveSample("Une_animation_grâce_à_des_découpes",660,425)}}</p> + +<h3 id="Une_animation_grâce_à_des_découpes">Une animation grâce à des découpes</h3> + +<p>Dans cet exemple, on anime des carrés grâce aux méthodes {{domxref("WebGLRenderingContext.scissor()","scissor()")}} et {{domxref("WebGLRenderingContext.clear()","clear()")}}. Ensuite, on crée à nouveau une boucle d'animation grâce aux <em>timers</em>. Cette fois-ci, la position du carré (la zone de découpe) est mise à jour à chaque <em>frame </em>(on a environ une frame rafraîchie toutes les 17 millisecondes, ce qui correspond environ à 60fps (<em>frame per second</em> ou <em>frame </em>par seconde).</p> + +<p>En revanche, la couleur du carré (définie avec {{domxref("WebGLRenderingContext.clearColor()","clearColor")}}) est uniquement mise à jour lorsqu'un nouveau carré est créé. On voit ici que {{Glossary("WebGL")}} est un automate. Pour chaque carré, on définit sa couleur une fois puis on met à jour sa position à chaque <em>frame</em>. L'état lié à la couleur reste tel quel jusqu'à ce qu'un nouveau carré soit créé.</p> + +<pre class="brush: html hidden"><p>Une animation WebGL obtenue en appliquant des couleurs +unies sur le buffer de dessin et en utilisant des tests de découpe.</p> +<button id="animation-onoff"> + Cliquez ici pour +<strong>[verbe ici]</strong> + l'animation</button> +<canvas>Il semblerait que votre navigateur + ne supporte pas l'élément HTML5 canvas.</canvas> +</pre> + +<pre class="brush: css hidden">body { + text-align : center; +} +canvas { + width : 280px; + height : 210px; + margin : auto; + padding : 0; + border : none; + background-color : black; +} +button { + display : block; + font-size : inherit; + margin : auto; + padding : 0.6em; +} +</pre> + +<pre class="brush: js hidden">;(function(){ +</pre> + +<pre class="brush: js">"use strict" +window.addEventListener("load", setupAnimation, false); +// Voici les variables qui permettront de +// manipuler le contexte WebGL, la couleur +// et la position des carrés. +var gl, + color = getRandomColor(), + position; + +function setupAnimation (evt) { + window.removeEventListener(evt.type, setupAnimation, false); + if (!(gl = getRenderingContext())) + return; + + gl.enable(gl.SCISSOR_TEST); + gl.clearColor(color[0], color[1], color[2], 1.0); + + // À la différence de la fenêtre du navigateur, + // l'axe vertical de WebGL va dans le sens croissant + // du bas vers le haut. Dans cette position, on indique + // que la position initiale du carré est en haut à gauche + // du contexte de dessin + position = [0, gl.drawingBufferHeight]; + + var button = document.querySelector("button"); + var timer; + function startAnimation(evt) { + button.removeEventListener(evt.type, startAnimation, false); + button.addEventListener("click", stopAnimation, false); + document.querySelector("strong").innerHTML = "arrêter"; + timer = setInterval(drawAnimation, 17); + drawAnimation(); + } + function stopAnimation(evt) { + button.removeEventListener(evt.type, stopAnimation, false); + button.addEventListener("click", startAnimation, false); + document.querySelector("strong").innerHTML = "lancer"; + clearInterval(timer); + } + stopAnimation({type: "click"}); +} + +// Les variables qui permettront de stocker la taille +// et la vitesse du carré. +var size = [60, 60], + velocity = 3.0; +function drawAnimation () { + gl.scissor(position[0], position[1], size[0] , size[1]); + gl.clear(gl.COLOR_BUFFER_BIT); + // À chaque frame, on définit une position plus basse + // pour le carré, c'est cela qui crée une illusion + // de mouvement. + position[1] -= velocity; + // Lorsque le carré atteint le bas, on crée un nouveau + // carré avec une nouvelle vitesse et une nouvelle + // couleur. + if (position[1] < 0) { + // La position horizontale est choisie aléatoirement. + // La position verticale correspond au haut + // du buffer de dessin. + position = [ + Math.random()*(gl.drawingBufferWidth - size[0]), + gl.drawingBufferHeight + ]; + // Ici on détermine une vitesse aléatoire + // comprise entre 1.0 et 7.0 + velocity = 1.0 + 6.0*Math.random(); + color = getRandomColor(); + gl.clearColor(color[0], color[1], color[2], 1.0); + } +} + +function getRandomColor() { + return [Math.random(), Math.random(), Math.random()]; +} +</pre> + +<pre class="brush: js hidden">function getRenderingContext() { + var canvas = document.querySelector("canvas"); + canvas.width = canvas.clientWidth; + canvas.height = canvas.clientHeight; + var gl = canvas.getContext("webgl") + || canvas.getContext("experimental-webgl"); + if (!gl) { + var paragraph = document.querySelector("p"); + paragraph.innerHTML = "Échec de l'obtention du contexte " + + "WebGL. Votre navigateur ne supporte peut-être pas " + + "WebGL."; + return null; + } + gl.viewport(0, 0, + gl.drawingBufferWidth, gl.drawingBufferHeight); + gl.clearColor(0.0, 0.0, 0.0, 1.0); + gl.clear(gl.COLOR_BUFFER_BIT); + return gl; +} +</pre> + +<pre class="brush: js hidden">})(); +</pre> + +<p>Le code source de cet exemple est également disponible sur <a href="https://github.com/idofilin/webgl-by-example/tree/master/scissor-animation">GitHub</a>.</p> + +<p>{{PreviousNext("Apprendre/WebGL/Par_exemple/Modèle_1","Apprendre/WebGL/Par_exemple/Une_pluie_de_rectangle")}}</p> diff --git a/files/fr/web/api/webgl_api/by_example/créer_une_animation_colorée/index.html b/files/fr/web/api/webgl_api/by_example/créer_une_animation_colorée/index.html new file mode 100644 index 0000000000..a38d174808 --- /dev/null +++ b/files/fr/web/api/webgl_api/by_example/créer_une_animation_colorée/index.html @@ -0,0 +1,139 @@ +--- +title: Créer une animation colorée +slug: Web/API/WebGL_API/By_example/Créer_une_animation_colorée +tags: + - Apprendre + - Débutant + - Exemple + - Graphisme + - Tutoriel + - WebGL +translation_of: Web/API/WebGL_API/By_example/Simple_color_animation +--- +<div>{{IncludeSubnav("/fr/Apprendre")}}</div> + +<p>{{PreviousNext("Apprendre/WebGL/Par_exemple/Appliquer_une_couleur_à_la_souris","Apprendre/WebGL/Par_exemple/Masque_de_couleur")}}</p> + +<p class="summary">Dans cet exemple, on crée une animation avec des couleurs en appliquant chaque seconde une couleur aléatoire dans le contexte de rendu {{Glossary("WebGL")}}.</p> + +<p>{{EmbedLiveSample("Créer_une_animation_avec_clear",660,425)}}</p> + +<h3 id="Créer_une_animation_avec_clear">Créer une animation avec <code> clear</code></h3> + +<p>Cet exemple illustre comment lancer une animation avec WebGL et gérer les interactions de l'utilisateur. L'utilisateur peut lancer, arrêter et reprendre l'animation en cliquant sur le bouton.</p> + +<p>Cette fois, on place les appels à la fonction WebGL à l'intérieur d'un gestionnaire d'événement de <em>timer</em>. Un gestionnaire d'événements pour les clics permet de gérer les interactions simples (lancer et arrêter l'animation). Le <em>timer</em> et la fonction de gestion du <em>timer</em> créent une boucle d'animation qui permet d'exécuter un ensemble de commandes pour le dessin à des intervalles réguliers (généralement, pour chaque <em>frame</em>, dans ce cas, on a une fréquence d'une <em>frame </em>par seconde).</p> + +<pre class="brush: html"><p>Un programme WebGL simple qui crée une animation colorée.</p> +<p>Vous pouvez sur le bouton pour activer/désactiver l'animation.</p> +<canvas id="canvas-view">Il semblerait que votre navigateur ne + supporte pas l'élément canvas.</canvas> +<button id="animation-onoff"> + Cliquez ici pour +<strong>[le verbe de l'action]</strong> + l'animation +</button> +</pre> + +<pre class="brush: css">body { + text-align : center; +} +button { + display : inline-block; + font-size : inherit; + margin : auto; + padding : 0.6em; +} +canvas { + display : block; + width : 280px; + height : 210px; + margin : auto; + padding : 0; + border : none; + background-color : black; +} +</pre> + +<pre class="brush: js" id="livesample-js">window.addEventListener("load", function setupAnimation (evt) { + "use strict" + window.removeEventListener(evt.type, setupAnimation, false); + + // Une variable pour gérer le timer qui contrôle + // l'animation. + var timer; + + // On ajoute un gestionnaire d'événement pour le clic. + var button = document.querySelector("#animation-onoff"); + var verb = document.querySelector("strong"); + function startAnimation(evt) { + button.removeEventListener(evt.type, startAnimation, false); + button.addEventListener("click", stopAnimation, false); + verb.innerHTML="arrêter"; + + // On place une boucle d'animation : on repeint + // environ chaque seconde. + timer = setInterval(drawAnimation, 1000); + + // On dessine une frame d'animation afin de + // fournir un feedback à l'utilisateur. + drawAnimation(); + } + + function stopAnimation(evt) { + button.removeEventListener(evt.type, stopAnimation, false); + button.addEventListener("click", startAnimation, false); + verb.innerHTML="lancer"; + // On arrête l'animation en réinitialisant le timer. + clearInterval(timer); + } + + // On appelle stopAnimation() une fois pour mettre en place + // les gestionnaires d'événement pour le canevas et le bouton. + stopAnimation({type: "click"}); + + var gl; + function drawAnimation () { + if (!gl) { + var canvas = document.getElementById("canvas-view"); + gl = canvas.getContext("webgl") + ||canvas.getContext("experimental-webgl"); + if (!gl) { + + // On ne veut pas avoir plusieurs messages d'alerte + // donc on arrête l'animation en réinitialisant le + // timer. + clearInterval(timer); + alert("Échec du chargement du contexte WebGL.\n" + + "Votre navigateur peut ne pas supporter WebGL."); + return; + + } + gl.viewport(0, 0, + gl.drawingBufferWidth, gl.drawingBufferHeight); + } + + // On génère une couleur aléatoire avec une fonction + // auxiliaire. + var color = getRandomColor(); + + // On applique la couleur obtenue dans le + // contexte WebGLRenderingContext + gl.clearColor(color[0], color[1], color[2], 1.0); + + // On propage le changement dans le contexte + // avec la méthode clear. + gl.clear(gl.COLOR_BUFFER_BIT); + } + + // Une fonction auxiliaire qui fournit une + // couleur aléatoire. + function getRandomColor() { + return [Math.random(), Math.random(), Math.random()]; + } +}, false); +</pre> + +<p>Le code source de cet exemple est également disponible sur <a href="https://github.com/idofilin/webgl-by-example/tree/master/simple-color-animation">GitHub</a>.</p> + +<p>{{PreviousNext("Apprendre/WebGL/Par_exemple/Appliquer_une_couleur_à_la_souris","Apprendre/WebGL/Par_exemple/Masque_de_couleur")}}</p> diff --git a/files/fr/web/api/webgl_api/by_example/détecter_webgl/index.html b/files/fr/web/api/webgl_api/by_example/détecter_webgl/index.html new file mode 100644 index 0000000000..fec1fd88a0 --- /dev/null +++ b/files/fr/web/api/webgl_api/by_example/détecter_webgl/index.html @@ -0,0 +1,79 @@ +--- +title: Détecter WebGL +slug: Web/API/WebGL_API/By_example/Détecter_WebGL +tags: + - Apprendre + - Débutant + - Exemple + - Graphisme + - Tutoriel + - WebGL +translation_of: Web/API/WebGL_API/By_example/Detect_WebGL +--- +<div>{{IncludeSubnav("/fr/Apprendre")}}</div> + +<div>{{PreviousNext("Apprendre/WebGL/Par_exemple","Apprendre/WebGL/Par_exemple/Appliquer_des_couleurs")}}</div> + +<p class="summary">Dans cet exemple, on voit comment détecter un contexte de rendu {{Glossary("WebGL")}} et afficher le résultat à l'utilisateur.</p> + +<p>{{EmbedLiveSample("Détecter_le_support_WebGL",660,150)}}</p> + +<h3 id="Détecter_le_support_WebGL">Détecter le support WebGL</h3> + +<p>Dans ce premier exemple, on vérifie si le navigateur prend en charge {{Glossary("WebGL")}}. Pour cela, on essaye d'obtenir le {{domxref("WebGLRenderingContext","contexte de rendu WebGL","",1)}} à partir d'un élément {{domxref("HTMLCanvasElement","canvas")}}. Le {{domxref("WebGLRenderingContext","contexte de rendu WebGL", "", 1)}} est une interface qui permet de connaître et de modifier l'état du moteur graphique WebGL, d'envoyer des données à WebGL et d'exécuter des commandes de dessin.</p> + +<p>La gestion d'une machine graphique au sein d'une seule interface n'est pas propre à {{Glossary("WebGL")}}. Les autres {̣{Glossary("API")}} graphiques comme {{domxref("CanvasRenderingContext2D","le contexte de rendu 2D du canevas", "", 1)}}. Cependant, les propriétés et variables qui peuvent être manipulées changent d'une API à l'autre.</p> + +<pre class="brush: html"><p>[ On affichera ici le résultat de la détection du support WebGL ]</p> +<button>Cliquez ici pour détecter WebGLRenderingContext</button> +</pre> + +<pre class="brush: css">body { + text-align : center; +} +button { + display : block; + font-size : inherit; + margin : auto; + padding : 0.6em; +} +</pre> + +<pre class="brush: js">// On exécute tout dans le gestionnaire d'événement +// correspondant au chargement de la fenêtre. De cette +// façon, le DOM est complètement chargé et mis en forme +// avant de le manipuler. +window.addEventListener("load", function() { + var paragraph = document.querySelector("p"), + button = document.querySelector("button"); + + // On ajoute un gestionnaire d'événement pour + // le clic sur le bouton + button.addEventListener("click", detectWebGLContext, false); + function detectWebGLContext () { + + // On crée un élément canvas. Le canvas n'est pas + // ajouté au document et il n'est donc jamais + // affiché dans la fenêtre du navigateur + var canvas = document.createElement("canvas"); + + // On récupère le contexte WebGLRenderingContext + // depuis l'élément canvas. + var gl = canvas.getContext("webgl") + || canvas.getContext("experimental-webgl"); + + // On affiche le résultat. + if (gl && gl instanceof WebGLRenderingContext) { + paragraph.innerHTML = + "Félicitations, votre navigateur supporte WebGL."; + } else { + paragraph.innerHTML = "Échec du contexte WebGL. " + + "Votre navigateur peut ne pas supporter WebGL."; + } + } +}, false); +</pre> + +<p>Le code source de cet exemple est également disponible sur <a href="https://github.com/idofilin/webgl-by-example/tree/master/detect-webgl">GitHub</a>.</p> + +<div>{{PreviousNext("Apprendre/WebGL/Par_exemple","Apprendre/WebGL/Par_exemple/Appliquer_des_couleurs")}}</div> diff --git a/files/fr/web/api/webgl_api/by_example/générer_des_textures_avec_du_code/index.html b/files/fr/web/api/webgl_api/by_example/générer_des_textures_avec_du_code/index.html new file mode 100644 index 0000000000..cd7d71f0c5 --- /dev/null +++ b/files/fr/web/api/webgl_api/by_example/générer_des_textures_avec_du_code/index.html @@ -0,0 +1,164 @@ +--- +title: Générer des textures avec du code +slug: Web/API/WebGL_API/By_example/Générer_des_textures_avec_du_code +tags: + - Apprendre + - Débutant + - Exemple + - Graphisme + - Tutoriel + - WebGL +translation_of: Web/API/WebGL_API/By_example/Textures_from_code +--- +<div>{{draft}}{{IncludeSubnav("/fr/Apprendre")}}</div> + +<p>{{PreviousNext("Apprendre/WebGL/Par_exemple/Introduction_aux_attributs_vertex","Apprendre/WebGL/Par_exemple/Les_textures_vidéos")}}</p> + +<p class="summary">Dans cet article, on illustre simplement comment générer des textures procédurales avec des fragments de <em>shader</em><em>s</em>.</p> + +<p>{{EmbedLiveSample("Dessiner_des_textures_avec_du_code",660,350)}}</p> + +<h3 id="Dessiner_des_textures_avec_du_code">Dessiner des textures avec du code</h3> + +<p>Il est possible d'appliquer des textures en effectuant des calculs pour chaque pixel du fragment de <em>shader</em>.</p> + +<pre class="brush: html hidden"><p>Génération d'une texture à partir de code. Simple demonstration + de la génération de textures procédurale</p> +<canvas>Il semblerait que votre navigateur ne supporte + pas l'élément canvas.</canvas> +</pre> + +<pre class="brush: css hidden">body { + text-align : center; +} +canvas { + width : 280px; + height : 210px; + margin : auto; + padding : 0; + border : none; + background-color : black; +} +button { + display : block; + font-size : inherit; + margin : auto; + padding : 0.6em; +} +</pre> + +<pre class="brush: html"><script type="x-shader/x-vertex" id="vertex-shader"> +#version 100 +precision highp float; +void main() { + gl_Position = vec4(0.0, 0.0, 0.0, 1.0); + gl_PointSize = 128.0; +} +</script> +</pre> + +<pre class="brush: html"><script type="x-shader/x-fragment" id="fragment-shader"> +#version 100 +precision mediump float; +// On définit une variation radiale (à partir du centre) +void main() { + vec2 fragmentPosition = 2.0*gl_PointCoord - 1.0; + float distance = length(fragmentPosition); + float distanceSqrd = distance * distance; + gl_FragColor = vec4( + 0.2/distanceSqrd, + 0.1/distanceSqrd, + 0.0, 1.0 ); +} +</script> +</pre> + +<pre class="brush: js hidden">;(function(){ +</pre> + +<pre class="brush: js">"use strict" +window.addEventListener("load", setupWebGL, false); +var gl, + program; +function setupWebGL (evt) { + window.removeEventListener(evt.type, setupWebGL, false); + if (!(gl = getRenderingContext())) + return; + + var source = document.querySelector("#vertex-shader").innerHTML; + var vertexShader = gl.createShader(gl.VERTEX_SHADER); + gl.shaderSource(vertexShader,source); + gl.compileShader(vertexShader); + source = document.querySelector("#fragment-shader").innerHTML + var fragmentShader = gl.createShader(gl.FRAGMENT_SHADER); + gl.shaderSource(fragmentShader,source); + gl.compileShader(fragmentShader); + program = gl.createProgram(); + gl.attachShader(program, vertexShader); + gl.attachShader(program, fragmentShader); + gl.linkProgram(program); + gl.detachShader(program, vertexShader); + gl.detachShader(program, fragmentShader); + gl.deleteShader(vertexShader); + gl.deleteShader(fragmentShader); + if (!gl.getProgramParameter(program, gl.LINK_STATUS)) { + var linkErrLog = gl.getProgramInfoLog(program); + cleanup(); + document.querySelector("p").innerHTML = + "La liaison du programme de shader a échoué. " + + "Journal d'erreur : " + linkErrLog; + return; + } + initializeAttributes(); + gl.useProgram(program); + gl.drawArrays(gl.POINTS, 0, 1); + cleanup(); +} + +var buffer; +function initializeAttributes() { + gl.enableVertexAttribArray(0); + buffer = gl.createBuffer(); + gl.bindBuffer(gl.ARRAY_BUFFER, buffer); + gl.bufferData(gl.ARRAY_BUFFER, new Float32Array([0.0, 0.0]), gl.STATIC_DRAW); + gl.vertexAttribPointer(0, 2, gl.FLOAT, false, 0, 0); +} + +function cleanup() { +gl.useProgram(null); +if (buffer) + gl.deleteBuffer(buffer); +if (program) + gl.deleteProgram(program); +} +</pre> + +<pre class="brush: js hidden">function getRenderingContext() { + var canvas = document.querySelector("canvas"); + canvas.width = canvas.clientWidth; + canvas.height = canvas.clientHeight; + var gl = canvas.getContext("webgl") + || canvas.getContext("experimental-webgl"); + if (!gl) { + var paragraph = document.querySelector("p"); + paragraph.innerHTML = "Échec de l'obtention du contexte" + + " WebGL. Votre navigateur ne supporte peut-être" + + " pas WebGL."; + return null; + } + gl.viewport(0, 0, + gl.drawingBufferWidth, gl.drawingBufferHeight); + gl.clearColor(0.0, 0.0, 0.0, 1.0); + gl.clear(gl.COLOR_BUFFER_BIT); + return gl; +} +</pre> + +<div class="hidden"> +<pre class="brush: js">})(); +</pre> +</div> + +<p>Le code source de cet exemple est également disponible sur <a href="https://github.com/idofilin/webgl-by-example/tree/master/textures-from-code">GitHub</a>.</p> + +<p>{{PreviousNext("Apprendre/WebGL/Par_exemple/Introduction_aux_attributs_vertex","Apprendre/WebGL/Par_exemple/Les_textures_vidéos")}}</p> diff --git a/files/fr/web/api/webgl_api/by_example/hello_glsl/index.html b/files/fr/web/api/webgl_api/by_example/hello_glsl/index.html new file mode 100644 index 0000000000..b26df25f0f --- /dev/null +++ b/files/fr/web/api/webgl_api/by_example/hello_glsl/index.html @@ -0,0 +1,159 @@ +--- +title: Hello GLSL +slug: Web/API/WebGL_API/By_example/Hello_GLSL +tags: + - Apprendre + - Débutant + - Exemple + - Graphisme + - Tutoriel + - WebGL +translation_of: Web/API/WebGL_API/By_example/Hello_GLSL +--- +<div>{{IncludeSubnav("/fr/Apprendre")}}</div> + +<p>{{PreviousNext("Apprendre/WebGL/Par_exemple/Une_pluie_de_rectangle","Apprendre/WebGL/Par_exemple/Introduction_aux_attributs_vertex")}}</p> + +<p class="summary">Dans cet article, on décrit un programme de manipulation de <em>shaders</em> qui dessine un carré de couleur.</p> + +<div class="note"> +<p><strong>Note :</strong> Cet exemple devrait fonctionner pour l'ensemble des navigateurs récents. Cependant, pour les versions anciennes ou mobiles, il peut y avoir des dysfonctionnements. Si le canevas reste blanc, vous pouvez vérifier le résultat avec l'exemple suivant qui dessine exactement la même chose. Assurez-vous de bien lire les explications et le code présent sur cette page avant de passer à la suivante.</p> +</div> + +<p>{{EmbedLiveSample("Hello_World_en_GLSL",660,425)}}</p> + +<h3 id="Hello_World_en_GLSL"><em>Hello World</em> en GLSL</h3> + +<p>Voici un exemple de premier programme qu'on peut écrire pour manipuler des <em>shaders</em>.</p> + +<pre class="brush: html hidden"><p>Hello World! Hello GLSL!</p> +<canvas>Votre navigateur semble ne pas + supporter l'élément HTML5.</canvas> +</pre> + +<pre class="brush: css hidden">body { + text-align : center; +} +canvas { + width : 280px; + height : 210px; + margin : auto; + padding : 0; + border : none; + background-color : black; +} + +button { + display : block; + font-size : inherit; + margin : auto; + padding : 0.6em; +} +</pre> + +<pre class="brush: html"><script type="x-shader/x-vertex" id="vertex-shader"> +#version 100 +void main() { + gl_Position = vec4(0.0, 0.0, 0.0, 1.0); + gl_PointSize = 64.0; +} +</script> +</pre> + +<pre class="brush: html"><script type="x-shader/x-fragment" id="fragment-shader"> +#version 100 +void main() { + gl_FragColor = vec4(0.18, 0.54, 0.34, 1.0); +} +</script> +</pre> + +<pre class="brush: js hidden">;(function(){ +</pre> + +<pre class="brush: js">"use strict" +window.addEventListener("load", setupWebGL, false); +var gl, + program; +function setupWebGL (evt) { + window.removeEventListener(evt.type, setupWebGL, false); + if (!(gl = getRenderingContext())) + return; + + var source = document.querySelector("#vertex-shader").innerHTML; + var vertexShader = gl.createShader(gl.VERTEX_SHADER); + gl.shaderSource(vertexShader,source); + gl.compileShader(vertexShader); + source = document.querySelector("#fragment-shader").innerHTML + var fragmentShader = gl.createShader(gl.FRAGMENT_SHADER); + gl.shaderSource(fragmentShader,source); + gl.compileShader(fragmentShader); + program = gl.createProgram(); + gl.attachShader(program, vertexShader); + gl.attachShader(program, fragmentShader); + gl.linkProgram(program); + gl.detachShader(program, vertexShader); + gl.detachShader(program, fragmentShader); + gl.deleteShader(vertexShader); + gl.deleteShader(fragmentShader); + if (!gl.getProgramParameter(program, gl.LINK_STATUS)) { + var linkErrLog = gl.getProgramInfoLog(program); + cleanup(); + document.querySelector("p").innerHTML = + "La liaison du programme a échoué." + + "Journal d'erreur : " + linkErrLog; + return; + } + + initializeAttributes(); + + gl.useProgram(program); + gl.drawArrays(gl.POINTS, 0, 1); + + cleanup(); +} + +var buffer; +function initializeAttributes() { + gl.enableVertexAttribArray(0); + buffer = gl.createBuffer(); + gl.bindBuffer(gl.ARRAY_BUFFER, buffer); + gl.vertexAttribPointer(0, 1, gl.FLOAT, false, 0, 0); +} + +function cleanup() { +gl.useProgram(null); +if (buffer) + gl.deleteBuffer(buffer); +if (program) + gl.deleteProgram(program); +} +</pre> + +<pre class="brush: js hidden">function getRenderingContext() { + var canvas = document.querySelector("canvas"); + canvas.width = canvas.clientWidth; + canvas.height = canvas.clientHeight; + var gl = canvas.getContext("webgl") + || canvas.getContext("experimental-webgl"); + if (!gl) { + var paragraph = document.querySelector("p"); + paragraph.innerHTML = "Échec de l'obtention du contexte" + + " WebGL. Votre navigateur ne supporte peut-être" + + " pas WebGL."; + return null; + } + gl.viewport(0, 0, + gl.drawingBufferWidth, gl.drawingBufferHeight); + gl.clearColor(0.0, 0.0, 0.0, 1.0); + gl.clear(gl.COLOR_BUFFER_BIT); + return gl; +} +</pre> + +<pre class="brush: js hidden">})(); +</pre> + +<p>Le code source de cet exemple est également disponible sur <a href="https://github.com/idofilin/webgl-by-example/tree/master/hello-glsl">GitHub</a>.</p> + +<p>{{PreviousNext("Apprendre/WebGL/Par_exemple/Une_pluie_de_rectangle","Apprendre/WebGL/Par_exemple/Introduction_aux_attributs_vertex")}}</p> diff --git a/files/fr/web/api/webgl_api/by_example/index.html b/files/fr/web/api/webgl_api/by_example/index.html new file mode 100644 index 0000000000..b7741c417f --- /dev/null +++ b/files/fr/web/api/webgl_api/by_example/index.html @@ -0,0 +1,72 @@ +--- +title: WebGL par l'exemple +slug: Web/API/WebGL_API/By_example +tags: + - Apprendre + - Débutant + - Graphisme + - WebGL +translation_of: Web/API/WebGL_API/By_example +--- +<div>{{IncludeSubnav("/fr/docs/Apprendre")}}</div> + +<p>{{Next("Apprendre/WebGL/Par_exemple/Détecter_WebGL")}}</p> + +<div class="summary"> +<p id="webgl-by-example-summary"><em>WebGL par l'exemple</em> est une série d'articles illustrant les concepts et les possibilités offertes par WebGL. Chaque exemple est accompagné d'explications. Ces démonstrations sont triés par sujet et par niveau de difficulté. Les concepts abordés sont, entre autres, le contexte de rendu, la programmation avec les <em>shaders</em>, les textures, la géométrie et l'interaction avec les utilisateurs.</p> +</div> + +<h2 id="Les_exemples_par_catégorie">Les exemples, par catégorie</h2> + +<p>Les exemples de cette section sont triés par ordre de difficulté croissante. Plutôt que de les présenter sous la forme d'une longue liste, ils sont également répartis selon différentes catégories. Un sujet peut être abordé dans plusieurs exemples afin de couvrir des notions simples, intermédiaires ou avancées.</p> + +<p>Plutôt que de manipuler des <em>shaders</em>, optimiser des géométrie et gérer la mémoire {{Glossary("GPU")}} dans le premier exemple, la progression se fera étape par étape afin que les exemples et les concepts puissent mieux être compris.</p> + +<p>Les exemples sont expliqués, avec des commentaires dans le code et des paragraphes dédiés. Nous vous invitons à lire l'ensemble des commentaires au fur et à mesure, notamment pour les exemples plus avancés où ce qui a été vu auparavant ne sera pas expliqué à nouveau.</p> + +<h3 id="Apprendre_à_connaître_le_contexte_de_rendu">Apprendre à connaître le contexte de rendu</h3> + +<dl> + <dt><a href="/fr/docs/Apprendre/WebGL/Par_exemple/Détecter_WebGL">Détecter WebGL</a></dt> + <dd>Dans cet exemple, on montre comment détecter un contexte de rendu {{Glossary("WebGL")}} et l'afficher pour l'utilisateur.</dd> + <dt><a href="/fr/docs/Apprendre/WebGL/Par_exemple/Appliquer_des_couleurs">Appliquer des couleurs</a></dt> + <dd>Dans cet exemple, on illustre comment appliquer une couleur unie dans un contexte de rendu.</dd> + <dt><a href="/fr/docs/Apprendre/WebGL/Par_exemple/Appliquer_une_couleur_à_la_souris">Appliquer une couleur à la souris</a></dt> + <dd>Ici, on montre comment combiner des interactions utilisateurs avec des opérations graphiques (là, on appliquera une couleur aléatoire dans le contexte à chaque clic de l'utilisateur).</dd> + <dt><a href="/fr/docs/Apprendre/WebGL/Par_exemple/Créer_une_animation_colorée">Créer une animation colorée</a></dt> + <dd>Dans cet exemple, on crée une animation simple avec des couleurs en appliquant chaque seconde une couleur aléatoire dans le contexte de rendu WebGL.</dd> + <dt><a href="/fr/docs/Apprendre/WebGL/Par_exemple/Masque_de_couleur">Avoir un masque de couleur</a></dt> + <dd>Modifier des couleurs aléatoires avec des masques de couleur pour limiter l'intervalle de couleurs qu'on souhaite utiliser.</dd> + <dt><a href="/fr/docs/Apprendre/WebGL/Par_exemple/Appliquer_des_découpes_simples">Appliquer des découpes simples</a></dt> + <dd>Dans cet exemple, on dessine des rectangles et des carrés simples grâce à des opérations de découpage (<em>scissoring</em>).</dd> + <dt><a href="/fr/docs/Apprendre/WebGL/Par_exemple/Tailles_de_canvas_et_WebGL">La taille du canevas et WebGL</a></dt> + <dd>Dans cet exemple, on observe ce qui se produit quand on définit (ou pas) la taille de l'élément <code>canvas</code> associé.</dd> + <dt><a href="/fr/docs/Apprendre/WebGL/Par_exemple/Modèle_1">Modèle 1</a></dt> + <dd>Dans cet exemple, on évoque les fragments de code qui seront utilisés pour les exemples qui suivent (et dans lesquels ils seront cachés car identiques). On définiera également une fonction JavaScript utilitaire pour initialiser WebGL plus facilement.</dd> + <dt><a href="/fr/docs/Apprendre/WebGL/Par_exemple/Créer_une_animation_avec_découpe_et_applique">Créer une animation avec du découpage et de l'applique</a></dt> + <dd>Avec cet article, on illustre comment créer des animations grâce aux opérations de découpe et d'applique.</dd> + <dt><a href="/fr/docs/Apprendre/WebGL/Par_exemple/Une_pluie_de_rectangle">Une pluie de rectangle</a></dt> + <dd>On voit ici un jeu, simple, qui mélange les découpes, les animations et les interactions utilisateurs.</dd> +</dl> + +<div> +<h3 id="Les_bases_de_la_programmation_avec_les_shaders">Les bases de la programmation avec les <em>shaders</em></h3> + +<dl> + <dt><a href="/fr/docs/Apprendre/WebGL/Par_exemple/Hello_GLSL">Hello GLSL</a></dt> + <dd>Un programme de manipulation des shaders simple qui dessine un carré.</dd> + <dt><a href="/fr/docs/Apprendre/WebGL/Par_exemple/Introduction_aux_attributs_vertex">Introduction aux attributs de vertex</a></dt> + <dd>Ici, on combine la programmation des shaders et les interactions utilisateurs grâce aux attributs de vertex.</dd> + <dt><a href="/fr/docs/Apprendre/WebGL/Par_exemple/Générer_des_textures_avec_du_code">Générer des textures avec du code</a></dt> + <dd>Une démonstration simple sur l'utilisation des <em>shaders</em> et des textures procédurales.</dd> +</dl> + +<h3 id="Divers_exemples_avancés">Divers exemples avancés</h3> + +<dl> + <dt><a href="/fr/docs/Apprendre/WebGL/Par_exemple/Les_textures_vidéos">Les textures vidéos</a></dt> + <dd>Dans cet exemple, on voit comment utiliser des fichiers vidéos comme des textures.</dd> +</dl> + +<p>{{Next("Apprendre/WebGL/Par_exemple/Détecter_WebGL")}}</p> +</div> diff --git a/files/fr/web/api/webgl_api/by_example/introduction_aux_attributs_vertex/index.html b/files/fr/web/api/webgl_api/by_example/introduction_aux_attributs_vertex/index.html new file mode 100644 index 0000000000..612dbad79c --- /dev/null +++ b/files/fr/web/api/webgl_api/by_example/introduction_aux_attributs_vertex/index.html @@ -0,0 +1,171 @@ +--- +title: Introduction aux attributs de vertex +slug: Web/API/WebGL_API/By_example/Introduction_aux_attributs_vertex +tags: + - Apprendre + - Débutant + - Exemple + - Graphisme + - Tutoriel + - WebGL +translation_of: Web/API/WebGL_API/By_example/Hello_vertex_attributes +--- +<div>{{IncludeSubnav("/fr/Apprendre")}}</div> + +<p>{{PreviousNext("Apprendre/WebGL/Par_exemple/Hello_GLSL","Apprendre/WebGL/Par_exemple/Générer_des_textures_avec_du_code")}}</p> + +<p class="summary">Avec cet exemple, on voit comment combiner la programmation des <em>shaders</em> et les interactions utilisateurs grâce aux attributs des <em>vertex</em>.</p> + +<p>{{EmbedLiveSample("Un_Hello_World_en_GLSL",660,425)}}</p> + +<h3 id="Un_Hello_World_en_GLSL">Un <em>Hello World</em> en GLSL</h3> + +<p>Voici comment envoyer des données saisies à un programme de manipulation des <em>shaders</em> en utilisant la mémoire GPU.</p> + +<pre class="brush: html hidden"><p>Voici le premier exemple où on manipule des attributs et où +on envoie des données au GPU. Cliquez sur le canevas pour modifier +la position horizontale du carré.</p> +<canvas>Il semblerait que votre navigateur ne supporte pas + l'élément HTML5 canvas.</canvas> +</pre> + +<pre class="brush: css hidden">body { + text-align : center; +} +canvas { + width : 280px; + height : 210px; + margin : auto; + padding : 0; + border : none; + background-color : black; +} +button { + display : block; + font-size : inherit; + margin : auto; + padding : 0.6em; +} +</pre> + +<pre class="brush: html"><script type="x-shader/x-vertex" id="vertex-shader"> +#version 100 +precision highp float; + +attribute float position; + +void main() { + gl_Position = vec4(position, 0.0, 0.0, 1.0); + gl_PointSize = 64.0; +} +</script> +</pre> + +<pre class="brush: html"><script type="x-shader/x-fragment" id="fragment-shader"> +#version 100 +precision mediump float; +void main() { + gl_FragColor = vec4(0.18, 0.54, 0.34, 1.0); +} +</script> +</pre> + +<pre class="brush: js hidden">;(function(){ +</pre> + +<pre class="brush: js">"use strict" +window.addEventListener("load", setupWebGL, false); +var gl, + program; +function setupWebGL (evt) { + window.removeEventListener(evt.type, setupWebGL, false); + if (!(gl = getRenderingContext())) + return; + + var source = document.querySelector("#vertex-shader").innerHTML; + var vertexShader = gl.createShader(gl.VERTEX_SHADER); + gl.shaderSource(vertexShader,source); + gl.compileShader(vertexShader); + source = document.querySelector("#fragment-shader").innerHTML + var fragmentShader = gl.createShader(gl.FRAGMENT_SHADER); + gl.shaderSource(fragmentShader,source); + gl.compileShader(fragmentShader); + program = gl.createProgram(); + gl.attachShader(program, vertexShader); + gl.attachShader(program, fragmentShader); + gl.linkProgram(program); + gl.detachShader(program, vertexShader); + gl.detachShader(program, fragmentShader); + gl.deleteShader(vertexShader); + gl.deleteShader(fragmentShader); + if (!gl.getProgramParameter(program, gl.LINK_STATUS)) { + var linkErrLog = gl.getProgramInfoLog(program); + cleanup(); + document.querySelector("p").innerHTML = + "Shader program did not link successfully. " + + "Error log: " + linkErrLog; + return; + } + + initializeAttributes(); + gl.useProgram(program); + gl.drawArrays(gl.POINTS, 0, 1); + + document.querySelector("canvas").addEventListener("click", + function (evt) { + var clickXrelativToCanvas = + evt.pageX - evt.target.offsetLeft; + var clickXinWebGLCoords = + 2.0 * (clickXrelativToCanvas- gl.drawingBufferWidth/2) + / gl.drawingBufferWidth; + gl.bufferData(gl.ARRAY_BUFFER, + new Float32Array([clickXinWebGLCoords]), gl.STATIC_DRAW); + gl.drawArrays(gl.POINTS, 0, 1); + }, false); +} + +var buffer; +function initializeAttributes() { + gl.enableVertexAttribArray(0); + buffer = gl.createBuffer(); + gl.bindBuffer(gl.ARRAY_BUFFER, buffer); + gl.bufferData(gl.ARRAY_BUFFER, new Float32Array([0.0]), gl.STATIC_DRAW); + gl.vertexAttribPointer(0, 1, gl.FLOAT, false, 0, 0); +} + +window.addEventListener("beforeunload", cleanup, true); +function cleanup() { + gl.useProgram(null); + if (buffer) + gl.deleteBuffer(buffer); + if (program) + gl.deleteProgram(program); +} +</pre> + +<pre class="brush: js hidden">function getRenderingContext() { + var canvas = document.querySelector("canvas"); + canvas.width = canvas.clientWidth; + canvas.height = canvas.clientHeight; + var gl = canvas.getContext("webgl") + || canvas.getContext("experimental-webgl"); + if (!gl) { + var paragraph = document.querySelector("p"); + paragraph.innerHTML = "Failed to get WebGL context." + + "Your browser or device may not support WebGL."; + return null; + } + gl.viewport(0, 0, + gl.drawingBufferWidth, gl.drawingBufferHeight); + gl.clearColor(0.0, 0.0, 0.0, 1.0); + gl.clear(gl.COLOR_BUFFER_BIT); + return gl; +} +</pre> + +<pre class="brush: js hidden">})(); +</pre> + +<p>Le code source de cet exemple est également disponible sur <a href="https://github.com/idofilin/webgl-by-example/tree/master/hello-vertex-attributes">GitHub</a>.</p> + +<p>{{PreviousNext("Apprendre/WebGL/Par_exemple/Hello_GLSL","Apprendre/WebGL/Par_exemple/Générer_des_textures_avec_du_code")}}</p> diff --git a/files/fr/web/api/webgl_api/by_example/les_textures_vidéos/index.html b/files/fr/web/api/webgl_api/by_example/les_textures_vidéos/index.html new file mode 100644 index 0000000000..ab1ea5a388 --- /dev/null +++ b/files/fr/web/api/webgl_api/by_example/les_textures_vidéos/index.html @@ -0,0 +1,23 @@ +--- +title: Les textures vidéos +slug: Web/API/WebGL_API/By_example/Les_textures_vidéos +tags: + - Apprendre + - Avancé + - Exemple + - Graphisme + - Tutoriel + - WebGL +translation_of: Web/API/WebGL_API/By_example/Video_textures +--- +<div>{{draft}}{{IncludeSubnav("/fr/Apprendre")}}</div> + +<p>{{Previous("Apprendre/WebGL/Par_exemple/Générer_des_textures_avec_du_code")}}</p> + +<p class="summary">Cet exemple illustre comment utiliser des fichiers vidéos comme textures.</p> + +<h3 id="Des_textures_à_partir_de_vidéos">Des textures à partir de vidéos</h3> + +<p>{{EmbedGHLiveSample('webgl-examples/tutorial/sample8/index.html', 670, 510)}}</p> + +<p>{{Previous("Apprendre/WebGL/Par_exemple/Générer_des_textures_avec_du_code")}}</p> diff --git a/files/fr/web/api/webgl_api/by_example/masque_de_couleur/index.html b/files/fr/web/api/webgl_api/by_example/masque_de_couleur/index.html new file mode 100644 index 0000000000..ad5e0dd461 --- /dev/null +++ b/files/fr/web/api/webgl_api/by_example/masque_de_couleur/index.html @@ -0,0 +1,136 @@ +--- +title: Masque de couleur +slug: Web/API/WebGL_API/By_example/Masque_de_couleur +tags: + - Apprendre + - Débutant + - Exemple + - Graphisme + - Tutoriel + - WebGL +translation_of: Web/API/WebGL_API/By_example/Color_masking +--- +<div>{{IncludeSubnav("/fr/Apprendre")}}</div> + +<p>{{PreviousNext("Apprendre/WebGL/Par_exemple/Créer_une_animation_colorée","Apprendre/WebGL/Par_exemple/Appliquer_des_découpes_simples")}}</p> + +<div id="color-masking"> +<div class="summary"> +<p>Dans cet article, on modifie des couleurs aléatoires grâce à un masque de couleur. Cela permet de limiter la plage de couleurs affichées à certains tons.</p> +</div> + +<p>{{EmbedLiveSample("color-masking-source",660,425)}}</p> + +<div id="color-masking-intro"> +<h3 id="Appliquer_un_masque_sur_des_couleurs_aléatoires">Appliquer un masque sur des couleurs aléatoires</h3> + +<p>Dans cet exemple, on modifie les couleurs aléatoires utilisées pour une animation grâce à l'opération {{domxref("WebGLRenderingContext.colorMask()","colorMask()")}}. D'une certaine façon, cette opération est analogue à la modification qu'on obtient lorsqu'on regarde à travers du verre teinté ou derrière une filtre coloré. Ainsi, en masquant les canaux vert et bleu, on ne pourra recevoir que les composantes rouges des pixels et cela donnera l'impression de regarder à travers du verre teinté de rouge.</p> + +<p>Les masques de couleur nous permettent d'illustrer quelques concepts de base <a href="https://en.wikipedia.org/wiki/Color_theory">de la théorie des couleurs</a>. En masquant certaines composantes, on rapproche les couleurs affichées de la couleur complémentaire. Ainsi, en masquant le bleu et le rouge, on obtiendrait des tons de vert. En masquant uniquement le canal bleu, on obtiendra des tons de jaune (dont orange, marron, olive, etc.) qui est la couleur complémentaire du bleu. De la même façon, en masquant uniquement le vert, on obtiendrait des tons magenta (pourpres, rouges, etc.) et en masquant uniquement le rouge, on obtiendrait des tons cyan.</p> + +<p>On voit que les appels à <code>colorMask()</code> sont uniquement déclenchés lorsque l'utilisateur clique sur l'un des boutons. En revanche, le rendu est fait chaque seconde grâce au timer. L'état du masque de couleur lié à {{Glossary("WebGL")}} est conservé et il n'est donc pas nécessaire d'appeler <code>colorMask()</code> à chaque frame pour régler le masque. Cela illustre la manière dont WebGL est un automate a état. Dans un premier temps, on initialise l'état de WebGL et ensuite, à chaque frame, on déclenche uniquement les opérations de dessin.</p> + +<p>Les masques de couleurs permettent d'avoir un contrôle précis pour mettre à jour les pixels à l'écran. En limitant les canaux de couleur qui sont utilisés à chaque commande de dessin, on peut utiliser chaque canal à bon escient et on peut par exemple stocler une image en ton de gris.</p> + +<p>Enfin, l'application d'un masque de couleur nous montre que {{Glossary("WebGL")}} n'est pas seulement un automate à états mais aussi un <em>processus</em> graphique. Cela signifie que les opérations graphiques liées à WebGL sont effectuées dans un ordre donné et que le résultat de chaque opération sert de point d'entrée pour l'opération suivante. Ainsi, l'opération d'applique définit la valeur pour chaque pixel. L'application du masque se produit plus tard dans le processus et modifie la couleur. Ainsi, le résultat final affiché à l'écran est teinté par la couleur du masque.</p> +</div> + +<div id="color-masking-source"> +<pre class="brush: html"><p>Tinting the displayed colors with color masking.</p> +<canvas>Il semblerait que votre navigateur ne supporte pas + l'élément HTML5 canvas.</canvas> +<button id="red-toggle">On</button> +<button id="green-toggle">On</button> +<button id="blue-toggle">On</button> +</pre> + +<pre class="brush: css">body { + text-align : center; +} +canvas { + display : block; + width : 280px; + height : 210px; + margin : auto; + padding : 0; + border : none; + background-color : black; +} +button { + display : inline-block; + font-family : serif; + font-size : inherit; + font-weight : 900; + color : white; + margin : auto; + padding : 0.6em 1.2em; +} +#red-toggle { + background-color : red; +} +#green-toggle { + background-color : green; +} +#blue-toggle { + background-color : blue; +} +</pre> + +<pre class="brush: js" id="livesample-js">window.addEventListener("load", function setupAnimation (evt) { + "use strict" + window.removeEventListener(evt.type, setupAnimation, false); + + var canvas = document.querySelector("canvas"); + var gl = canvas.getContext("webgl") + || canvas.getContext("experimental-webgl"); + if (!gl) { + document.querySelector("p").innerHTML = + "Échec lors de l'obtention du contexte WebGL." + + "Votre navigateur ou appareil ne supporte " + + "peut-être pas WebGL."; + return; + } + gl.viewport(0, 0, + gl.drawingBufferWidth, gl.drawingBufferHeight); + + var timer = setInterval(drawAnimation, 1000); + + var mask = [true, true, true]; + var redtoggle = document.querySelector("#red-toggle"), + greentoggle = document.querySelector("#green-toggle"), + bluetoggle = document.querySelector("#blue-toggle"); + redtoggle.addEventListener("click", setColorMask, false); + greentoggle.addEventListener("click", setColorMask, false); + bluetoggle.addEventListener("click", setColorMask, false); + + function setColorMask(evt) { + var index = + evt.target === greentoggle && 1 + || evt.target === bluetoggle && 2 + || 0; + mask[index] = !mask[index]; + if (mask[index] === true) + evt.target.innerHTML="On"; + else + evt.target.innerHTML="Off"; + gl.colorMask(mask[0], mask[1], mask[2], true); + drawAnimation(); + }; + + function drawAnimation () { + var color = getRandomColor(); + gl.clearColor(color[0], color[1], color[2], 1.0); + gl.clear(gl.COLOR_BUFFER_BIT); + } + + function getRandomColor() { + return [Math.random(), Math.random(), Math.random()]; + } +}, false); +</pre> + +<p>Le code source de cet exemple est également disponible sur <a href="https://github.com/idofilin/webgl-by-example/tree/master/color-masking">GitHub</a>.</p> +</div> +</div> + +<p>{{PreviousNext("Apprendre/WebGL/Par_exemple/Créer_une_animation_colorée","Apprendre/WebGL/Par_exemple/Appliquer_des_découpes_simples")}}</p> diff --git a/files/fr/web/api/webgl_api/by_example/modèle_1/index.html b/files/fr/web/api/webgl_api/by_example/modèle_1/index.html new file mode 100644 index 0000000000..a055a358c8 --- /dev/null +++ b/files/fr/web/api/webgl_api/by_example/modèle_1/index.html @@ -0,0 +1,97 @@ +--- +title: Modèle 1 +slug: Web/API/WebGL_API/By_example/Modèle_1 +tags: + - Apprendre + - Débutant + - Exemple + - Tutoriel + - WebGL +translation_of: Web/API/WebGL_API/By_example/Boilerplate_1 +--- +<div>{{IncludeSubnav("/fr/Apprendre")}}</div> + +<p>{{PreviousNext("Apprendre/WebGL/Par_exemple/Tailles_de_canvas_et_WebGL","Apprendre/WebGL/Par_exemple/Créer_une_animation_avec_découpe_et_applique")}}</p> + +<p class="summary">Dans cet article, on décrit les fragments de code qui seront réutilisés pour les exemples suivants (où ils seront masqués pour une meilleur lisibilité). Parmi ce code, on définit une fonction JavaScript utilitaire qui permet de simplifier l'initialisation de WebGL.</p> + +<p>{{EmbedLiveSample("Socle_pour_l'initialisation_du_contexte_WebGL",660,400)}}</p> + +<h2 id="Socle_pour_l'initialisation_du_contexte_WebGL">Socle pour l'initialisation du contexte WebGL</h2> + +<p>Nous avons vu plusieurs fois les mêmes morceaux de {{Glossary("HTML")}}, {{Glossary("CSS")}} et {{Glossary("JavaScript")}}. Nous allons donc les cacher par la suite afin de mieux nous concentrer sur les parties du code qui sont pertinentes pour l'apprentissage de {{Glossary("WebGL")}}.</p> + +<p>Plus précisément, le code HTML contiendra</p> + +<ul> + <li>Un élément {{HTMLElement("p")}} qui décrira l'exemple et qui permettra d'afficher des messages d'erreur</li> + <li>Un élément {{HTMLElement("canvas")}}</li> + <li>Un bouton (élément {{HTMLElement("button")}})</li> +</ul> + +<p>Les règles CSS s'appliqueront aux éléments <code>body</code>, <code>canvas</code> et <code>button</code>. Les éléments supplémentaires pour le code CSS et HTML seront détaillés dans les pages des exemples concernés.</p> + +<p>Dans les exemples suivants, on utilisera la fonction utilitaire JavaScript <code>getRenderingContext</code> pour initialiser {{domxref("WebGLRenderingContext","le contexte de rendu WebGL", "", 1)}}. Grâce aux exemples précédents, vous devriez pouvoir comprendre le rôle de cette fonction. Pour résumer, celle-ci</p> + +<ul> + <li>Obtient le contexte de rendu de la part de l'élément <code>canvas</code></li> + <li>Initialise le buffer de dessin</li> + <li>Nettoie le buffer avec <code>clear</code></li> + <li>Applique le contexte initialisé</li> +</ul> + +<p>S'il y a une erreur, la fonction affiche un message d'erreur et renvoie <code>null</code>.</p> + +<p>Enfin, tout le code JavaScript est exécuté par une fonction immédiatement appelée (une technique plutôt commune avec JavaScript). La déclaration de la fonction et son invocation seront cachées.</p> + +<pre class="brush: html"><p>[ Un texte qui décrit l'exemple. ]</p> +<button>[ Un bouton optionnel pour les interactions. ]</button> +<canvas>Il semblerait que votre navigateur ne supporte + pas le canevas HTML5.</canvas> +</pre> + +<pre class="brush: css">body { + text-align : center; +} +canvas { + display : block; + width : 280px; + height : 210px; + margin : auto; + padding : 0; + border : none; + background-color : black; +} +button { + display : block; + font-size : inherit; + margin : auto; + padding : 0.6em; +} +</pre> + +<pre class="brush: js">function getRenderingContext() { + var canvas = document.querySelector("canvas"); + canvas.width = canvas.clientWidth; + canvas.height = canvas.clientHeight; + var gl = canvas.getContext("webgl") + || canvas.getContext("experimental-webgl"); + if (!gl) { + var paragraph = document.querySelector("p"); + paragraph.innerHTML = "Échec de l'obtention du " + + "contexte WebGL." + + "Votre navigateur ou appareil ne supporte " + + "peut-être pas WebGL."; + return null; + } + gl.viewport(0, 0, + gl.drawingBufferWidth, gl.drawingBufferHeight); + gl.clearColor(0.0, 0.0, 0.0, 1.0); + gl.clear(gl.COLOR_BUFFER_BIT); + return gl; +} +</pre> + +<p>Le code source de cet exemple est également disponible sur <a href="https://github.com/idofilin/webgl-by-example/tree/master/boilerplate-1">GitHub</a>.</p> + +<p>{{PreviousNext("Apprendre/WebGL/Par_exemple/Tailles_de_canvas_et_WebGL","Apprendre/WebGL/Par_exemple/Créer_une_animation_avec_découpe_et_applique")}}</p> diff --git a/files/fr/web/api/webgl_api/by_example/tailles_de_canvas_et_webgl/index.html b/files/fr/web/api/webgl_api/by_example/tailles_de_canvas_et_webgl/index.html new file mode 100644 index 0000000000..086e0394a7 --- /dev/null +++ b/files/fr/web/api/webgl_api/by_example/tailles_de_canvas_et_webgl/index.html @@ -0,0 +1,82 @@ +--- +title: Tailles de canvas et WebGL +slug: Web/API/WebGL_API/By_example/Tailles_de_canvas_et_WebGL +tags: + - Apprendre + - Débutant + - Exemple + - Tutoriel + - WebGL +translation_of: Web/API/WebGL_API/By_example/Canvas_size_and_WebGL +--- +<div>{{IncludeSubnav("/fr/Apprendre")}}</div> + +<p>{{PreviousNext("Apprendre/WebGL/Par_exemple/Appliquer_des_découpes_simples","Apprendre/WebGL/Par_exemple/Modèle_1")}}</p> + +<p>{{EmbedLiveSample("Les_effets_liés_à_la_taille_du_canevas_sur_le_rendu_avec_WebGL",660,180)}}</p> + +<p class="summary">Dans cet exemple, on observe l'effet obtenu quand on définit (ou non) la taille du canevas HTML avec sa taille {{Glossary("CSS")}} (exprimée en pixels CSS), tel qu'il apparaît dans la fenêtre du navigateur.</p> + +<h3 id="Les_effets_liés_à_la_taille_du_canevas_sur_le_rendu_avec_WebGL">Les effets liés à la taille du canevas sur le rendu avec WebGL</h3> + +<p>Grâce aux méthodes {{domxref("WebGLRenderingContext.scissor()","scissor()")}} et {{domxref("WebGLRenderingContext.clear()","clear()")}} on peut démontrer que le tampon (<em>buffer</em>) de dessin WebGL est affecté par la taille du canevas (l'élément HTML <code>canvas</code>).</p> + +<p>La taille du premier canevas est définie avec la taille de l'élément, mis en forme, qui est déterminée par {{Glossary("CSS")}}. Pour cela, on affecte respectivement les valeurs {{domxref("Element.clientWidth","clientWidth")}} and {{domxref("Element.clientHeight","clientHeight")}} aux propriétés {{domxref("HTMLCanvasElement.width","width")}} et {{domxref("HTMLCanvasElement.height","height")}}.</p> + +<p>Pour le deuxième canevas, on n'applique pas ce traitement, c'est donc les dimensions internes du canevas : {{domxref("HTMLCanvasElement.width","width")}} et {{domxref("HTMLCanvasElement.height","height")}} qui sont prises en compte. Celles-ci sont différentes des dimensions de l'élément <code>canvas</code> affiché dans le fenêtre du navigateur.</p> + +<p>L'effet devient visible quand on utilise les méthodes {{domxref("WebGLRenderingContext.scissor()","scissor()")}} et {{domxref("WebGLRenderingContext.clear()","clear()")}} pour dessiner un carré au centre du canevas en définissant sa position et sa taille en pixels. Dans le premier canevas, on obtient bien le bon résultat et dans le deuxième, on a la mauvaise forme, la mauvaise taille et la mauvaise position.</p> + +<pre class="brush: html"><p>On compare les deux canevas.</p> +<canvas>Votre navigateur ne semble pas + supporter l'élément HTML5 canvas.</canvas> +<canvas>Votre navigateur ne semble pas + supporter l'élément HTML5 canvas.</canvas> +</pre> + +<pre class="brush: css">body { + text-align : center; +} +canvas { + width : 120px; + height : 80px; + margin : auto; + padding : 0; + border : none; + background-color : black; +} +</pre> + +<pre class="brush: js">window.addEventListener("load", function() { + "use strict" + var firstCanvas = document.getElementsByTagName("canvas")[0], + secondCanvas = document.getElementsByTagName("canvas")[1]; + + // Ici on applique le traitement spécifique au premier + // canevas + firstCanvas.width = firstCanvas.clientWidth; + firstCanvas.height = firstCanvas.clientHeight; + + // Ensuite on traite les deux canevas de la même façon + [firstCanvas, secondCanvas].forEach(function(canvas) { + var gl = canvas.getContext("webgl") + || canvas.getContext("experimental-webgl"); + if (!gl) { + document.querySelector("p").innerHTML = + "Échec de l'obtention du contexte WebGL. " + + "Votre navigateur peut ne pas supporter WebGL."; + return; + } + gl.viewport(0, 0, + gl.drawingBufferWidth, gl.drawingBufferHeight); + gl.enable(gl.SCISSOR_TEST); + gl.scissor(30, 10, 60, 60); + gl.clearColor(1.0, 1.0, 0.0, 1.0); + gl.clear(gl.COLOR_BUFFER_BIT); + }); +}, false); +</pre> + +<p>Le code source de cet exemple est également disponible sur <a href="https://github.com/idofilin/webgl-by-example/tree/master/canvas-size-and-webgl">GitHub</a>.</p> + +<p>{{PreviousNext("Apprendre/WebGL/Par_exemple/Appliquer_des_découpes_simples","Apprendre/WebGL/Par_exemple/Modèle_1")}}</p> diff --git a/files/fr/web/api/webgl_api/by_example/une_pluie_de_rectangle/index.html b/files/fr/web/api/webgl_api/by_example/une_pluie_de_rectangle/index.html new file mode 100644 index 0000000000..e9f9bcdf8c --- /dev/null +++ b/files/fr/web/api/webgl_api/by_example/une_pluie_de_rectangle/index.html @@ -0,0 +1,176 @@ +--- +title: Une pluie de rectangle +slug: Web/API/WebGL_API/By_example/Une_pluie_de_rectangle +tags: + - Apprendre + - Débutant + - Exemple + - Graphisme + - Tutoriel + - WebGL +translation_of: Web/API/WebGL_API/By_example/Raining_rectangles +--- +<div>{{IncludeSubnav("/fr/Apprendre")}}</div> + +<p>{{PreviousNext("Apprendre/WebGL/Par_exemple/Créer_une_animation_avec_découpe_et_applique","Apprendre/WebGL/Par_exemple/Hello_GLSL")}}</p> + +<p class="summary">Cet exemple permet de créer un jeu simple qui illustre ce qu'il est possible de faire avec du « découpage », des animations et des interactions utilisateur.</p> + +<p>{{EmbedLiveSample("Utiliser_des_animations_et_des_interactions_grâce_à_des_découpes",660,425)}}</p> + +<h3 id="Utiliser_des_animations_et_des_interactions_grâce_à_des_découpes">Utiliser des animations et des interactions grâce à des découpes</h3> + +<p>Voici un jeu simple où il faut essayer de cliquer sur les rectangles qui tombent pour en attraper le plus possible. Dans cet exemple, on utilise un approche orientée objet pour représenter les rectangles. Cela permet de mieux gérer l'état du rectangle (sa position, sa couleur, etc.) et cela rend le code plus compact et plus facile à réutiliser.</p> + +<p>Dans cet exemple, on combine l'applique de couleurs unis dans le tampon de dessin et des opérations de découpe. C'est un aperçu d'une application graphique complète qui manipule les différentes phases des processus {{Glossary("WebGL")}} et de son automate.</p> + +<p>De plus, cet exmple illustre comment intégrer des fonctions WebGL dans une boucle de jeu. La boucle de jeu est responsable du dessin pour l'animation, de la gestion des entrées utilisateur et de la réactivité de l'ensemble. Voici comment la boucle de jeu est implémentée avec des <code>setTimeout</code>.</p> + +<pre class="brush: html hidden"><p>Vous en avez attrapé +<strong>0</strong>. + Vous en avez loupé +<strong>0</strong>.</p> +<canvas>Il semblerait que votre + navigateur ne supporte pas l'élément + HTML5 canvas.</canvas> +</pre> + +<pre class="brush: css hidden">body { + text-align : center; +} +canvas { + display : block; + width : 280px; + height : 210px; + margin : auto; + padding : 0; + border : none; + background-color : black; +} +button { + display : block; + font-size : inherit; + margin : auto; + padding : 0.6em; +} +</pre> + +<pre class="brush: js hidden">;(function(){ +</pre> + +<pre class="brush: js" id="livesample-js">"use strict" +window.addEventListener("load", setupAnimation, false); +var gl, + timer, + rainingRect, + scoreDisplay, + missesDisplay; +function setupAnimation (evt) { + window.removeEventListener(evt.type, setupAnimation, false); + if (!(gl = getRenderingContext())) + return; + gl.enable(gl.SCISSOR_TEST); + + rainingRect = new Rectangle(); + timer = setTimeout(drawAnimation, 17); + document.querySelector("canvas") + .addEventListener("click", playerClick, false); + var displays = document.querySelectorAll("strong"); + scoreDisplay = displays[0]; + missesDisplay = displays[1]; +} + +var score = 0, + misses = 0; +function drawAnimation () { + gl.scissor(rainingRect.position[0], rainingRect.position[1], + rainingRect.size[0] , rainingRect.size[1]); + gl.clear(gl.COLOR_BUFFER_BIT); + rainingRect.position[1] -= rainingRect.velocity; + if (rainingRect.position[1] < 0) { + misses += 1; + missesDisplay.innerHTML = misses; + rainingRect = new Rectangle(); + } + // On utilise la fonction setTimeout pour l'animation + // et on appelle ainsi la fonction drawAnimation toutes + // les 17ms, sinon, on n'aurait pas d'animation. + timer = setTimeout(drawAnimation, 17); +} + +function playerClick (evt) { + // Il est nécessaire de transfomer la position de l'événement + // déclenché par le clic, exprimée dans le repèree de la fenêtre + // pour obtenir la position relative au canevas. + // De plus, on rappelle qu'avec WebGL les ordonnées croissent + // selon l'axe vertical, c'est-à-dire l'inverse du système + // utilisé pour la fenêtre du navigateur. + var position = [ + evt.pageX - evt.target.offsetLeft, + gl.drawingBufferHeight - (evt.pageY - evt.target.offsetTop), + ]; + // si le clic est sur un rectangle, on l'attrape. + // On incrémente donc le score et on crée un nouveau rectangle + var diffPos = [ position[0] - rainingRect.position[0], + position[1] - rainingRect.position[1] ]; + if ( diffPos[0] >= 0 && diffPos[0] < rainingRect.size[0] + && diffPos[1] >= 0 && diffPos[1] < rainingRect.size[1] ) { + score += 1; + scoreDisplay.innerHTML = score; + rainingRect = new Rectangle(); + } +} + +function Rectangle () { + // On garde une référence au nouvel objet Rectangle + // plutôt que de risquer une confusion avec this. + var rect = this; + // On prend trois nombres aléatoires pour la taille + // et la position du nouveau rectangle. On utilise + // un nombre différent pour la position et la taille + // car on veut que celles-ci soient indépendantes. + var randNums = getRandomVector(); + rect.size = [ + 5 + 120 * randNums[0], + 5 + 120 * randNums[1] + ]; + rect.position = [ + randNums[2]*(gl.drawingBufferWidth - rect.size[0]), + gl.drawingBufferHeight + ]; + rect.velocity = 1.0 + 6.0*Math.random(); + rect.color = getRandomVector(); + gl.clearColor(rect.color[0], rect.color[1], rect.color[2], 1.0); + function getRandomVector() { + return [Math.random(), Math.random(), Math.random()]; + } +} +</pre> + +<pre class="brush: js hidden">function getRenderingContext() { + var canvas = document.querySelector("canvas"); + canvas.width = canvas.clientWidth; + canvas.height = canvas.clientHeight; + var gl = canvas.getContext("webgl") + || canvas.getContext("experimental-webgl"); + if (!gl) { + var paragraph = document.querySelector("p"); + paragraph.innerHTML = "Échec de l'obtention du contexte." + + " WebGL. Votre navigateur ne supporte peut-être pas " + + " WebGL."; + return null; + } + gl.viewport(0, 0, + gl.drawingBufferWidth, gl.drawingBufferHeight); + gl.clearColor(0.0, 0.0, 0.0, 1.0); + gl.clear(gl.COLOR_BUFFER_BIT); + return gl; +} +</pre> + +<pre class="brush: js hidden">})(); +</pre> + +<p>Le code source de cet exemple est également disponible sur <a href="https://github.com/idofilin/webgl-by-example/tree/master/raining-rectangles">GitHub</a>.</p> + +<p>{{PreviousNext("Apprendre/WebGL/Par_exemple/Créer_une_animation_avec_découpe_et_applique","Apprendre/WebGL/Par_exemple/Hello_GLSL")}}</p> |