diff options
Diffstat (limited to 'files/fr/web/api/svgmatrix/index.md')
| -rw-r--r-- | files/fr/web/api/svgmatrix/index.md | 243 |
1 files changed, 243 insertions, 0 deletions
diff --git a/files/fr/web/api/svgmatrix/index.md b/files/fr/web/api/svgmatrix/index.md new file mode 100644 index 0000000000..374dd11c20 --- /dev/null +++ b/files/fr/web/api/svgmatrix/index.md @@ -0,0 +1,243 @@ +--- +title: SVGMatrix +slug: Web/API/SVGMatrix +tags: + - Matrice + - Reference +translation_of: Web/API/SVGMatrix +--- +<h2 id="Interface_SVG_matrix">Interface SVG matrix</h2> + +<p>Beaucoup d'opération graphiques de SVG utilisent des matrices 2x3 de la forme :</p> + +<pre>[a c e] +[b d f]</pre> + +<p>laquelle, quand étendue en une matrice 3x3 à des fins d'arithmétique matricielle, devient :</p> + +<pre>[a c e] +[b d f] +[0 0 1] +</pre> + +<p>Un objet <code>SVGMatrix</code> peut être marqué en lecture-seule, ce qui signifie que les tentatives de modification sur cet objet entraîneront un lancement d'exception.</p> + +<h3 id="Vue_d'ensemble_de_l'interface">Vue d'ensemble de l'interface</h3> + +<table class="standard-table"> + <tbody> + <tr> + <th scope="row">Implémente aussi</th> + <td><em>Aucune</em></td> + </tr> + <tr> + <th scope="row">Méthodes</th> + <td> + <ul> + <li>{{ domxref("SVGMatrix") }} <code>multiply(in {{ domxref("SVGMatrix") }} <em>secondMatrix</em>)</code></li> + <li>{{ domxref("SVGMatrix") }} <code>inverse()</code></li> + <li>{{ domxref("SVGMatrix") }} <code>translate(in float <em>x</em>, in float <em>y</em>)</code></li> + <li>{{ domxref("SVGMatrix") }} <code>scale(in float <em>scaleFactor</em>)</code></li> + <li>{{ domxref("SVGMatrix") }} <code>scaleNonUniform(in float scaleFactorX, in float <em>scaleFactorY</em>)</code></li> + <li>{{ domxref("SVGMatrix") }} <code>rotate(in float<code> <em>angle</em>)</code></code></li> + <li>{{ domxref("SVGMatrix") }} <code>rotateFromVector(in float <em>x</em>, in float <em>y</em>)</code></li> + <li>{{ domxref("SVGMatrix") }} <code>flipX()</code></li> + <li>{{ domxref("SVGMatrix") }} <code>flipY()</code></li> + <li>{{ domxref("SVGMatrix") }} <code>skewX(in float <em>angle</em>)</code></li> + <li>{{ domxref("SVGMatrix") }} <code>skewY(in float <em>angle</em>)</code></li> + </ul> + </td> + </tr> + <tr> + <th scope="row">Propriétés</th> + <td> + <ul> + <li>float <code>a</code></li> + <li>float <code>b</code></li> + <li>float <code>c</code></li> + <li>float <code>d</code></li> + <li>float <code>e</code></li> + <li>float <code>f</code></li> + </ul> + </td> + </tr> + <tr> + <th scope="row">Document normatif</th> + <td><a href="http://www.w3.org/TR/SVG/coords.html#InterfaceSVGMatrix">SVG 1.1 (2nd Edition)</a></td> + </tr> + </tbody> +</table> + +<h2 id="Propriétés">Propriétés</h2> + +<table class="standard-table"> + <thead> + <tr> + <th>Nom</th> + <th>Type</th> + <th>Description</th> + </tr> + </thead> + <tbody> + <tr> + <td><code>a</code></td> + <td>float</td> + <td>Le composant <em>a</em> de la matrice.</td> + </tr> + <tr> + <td><code>b</code></td> + <td>float</td> + <td>Le composant <em>b</em> de la matrice.</td> + </tr> + <tr> + <td><code>c</code></td> + <td>float</td> + <td>Le composant c de la matrice.</td> + </tr> + <tr> + <td><code>d</code></td> + <td>float</td> + <td>Le composant <em>d</em> de la matrice.</td> + </tr> + <tr> + <td><code>e</code></td> + <td>float</td> + <td>Le composant <em>e</em> de la matrice.</td> + </tr> + <tr> + <td><code>f</code></td> + <td>float</td> + <td>Le composant <em>f</em> de la matrice.</td> + </tr> + </tbody> +</table> + +<p>Une {{ domxref("DOMException") }} avec le code <code>NO_MODIFICATION_ALLOWED_ERR</code> est levée lors d'une tentative de modification d'un attribut en lecture-seule ou quand l'objet lui-même est en lecture-seule.</p> + +<h2 id="Méthodes">Méthodes</h2> + +<table class="standard-table"> + <thead> + <tr> + <th>Nom & Arguments</th> + <th>Retourne</th> + <th>Description</th> + </tr> + </thead> + <tbody> + <tr> + <td><code><strong>multiply</strong>(in {{ domxref("SVGMatrix") }} <em>secondMatrix</em>)</code></td> + <td>{{ domxref("SVGMatrix") }}</td> + <td>Effectue une multiplication de matrices. Cette matrice est multipliée par une autre matrice, retournant la nouvelle matrice résultante.</td> + </tr> + <tr> + <td><code><strong>inverse</strong>()</code></td> + <td>{{ domxref("SVGMatrix") }}</td> + <td> + <p>Retourne la matrice inverse.</p> + + <p><strong>Exceptions :</strong></p> + + <ul> + <li>une {{ domxref("DOMException") }} avec le code <code>SVG_MATRIX_NOT_INVERTABLE</code> est levée si la matrice n'est pas inversible.</li> + </ul> + </td> + </tr> + <tr> + <td><code><strong>translate</strong>(in float <em>x</em>, in float <em>y</em>)</code></td> + <td>{{ domxref("SVGMatrix") }}</td> + <td> + <div>Effectue une translation sur la matrice courante et retourne la matrice résultante.</div> + </td> + </tr> + <tr> + <td><code><strong>scale</strong>(in float <em>scaleFactor</em>)</code></td> + <td>{{ domxref("SVGMatrix") }}</td> + <td> + <div>Effectue une mise à l'échelle uniforme sur la matrice courante et retourne la matrice résultante.</div> + </td> + </tr> + <tr> + <td><code><strong>scaleNonUniform</strong>(in float <em>scaleFactorX</em>, in float <em>scaleFactorY</em>)</code></td> + <td>{{ domxref("SVGMatrix") }}</td> + <td> + <div>Effectue une mise à l'échelle non-uniforme sur la matrice courante et retourne la matrice résultante.</div> + </td> + </tr> + <tr> + <td><code><strong>rotate</strong>(in float <em>angle</em>)</code></td> + <td>{{ domxref("SVGMatrix") }}</td> + <td> + <div>Effectue une rotation sur la matrice courante et retourne la matrice résultante.</div> + </td> + </tr> + <tr> + <td><code><strong>rotateFromVector</strong>(in float <em>x</em>, in float <em>y</em>)</code></td> + <td>{{ domxref("SVGMatrix") }}</td> + <td> + <p>Effectue une rotation sur la matrice courante et retourne la matrice résultante. L'angle de rotation est déterminé en prenant (+/-) atan(y/x). La direction du vecteur (x, y) détermine si la valeur négative ou positive de l'angle est utilisée.</p> + + <p><strong>Exceptions :</strong></p> + + <ul> + <li>une {{ domxref("DOMException") }} avec le code <code>SVG_INVALID_VALUE_ERR </code>est levée si un de ces paramètres a une valeur invalide.</li> + </ul> + </td> + </tr> + <tr> + <td><code><strong>flipX</strong>()</code></td> + <td>{{ domxref("SVGMatrix") }}</td> + <td> + <div>Effectue une transformation [-1 0 0 1 0 0] et retourne la matrice résultante.</div> + </td> + </tr> + <tr> + <td><code><strong>flipY</strong>()</code></td> + <td>{{ domxref("SVGMatrix") }}</td> + <td> + <div>Effectue une transformation [1 0 0 -1 0 0] et retourne la matrice résultante.</div> + </td> + </tr> + <tr> + <td><code><strong>skewX</strong>(in float <em>angle</em>)</code></td> + <td>{{ domxref("SVGMatrix") }}</td> + <td> + <div>Effectue une transformation de skewX sur la matrice courante et retourne la matrice résultante.</div> + </td> + </tr> + <tr> + <td><code><strong>skewY</strong>(in float <em>angle</em>)</code></td> + <td>{{ domxref("SVGMatrix") }}</td> + <td> + <div>Effectue une transformation de skewY sur la matrice courante et retourne la matrice résultante.</div> + </td> + </tr> + </tbody> +</table> + +<h2 id="Exceptions">Exceptions</h2> + +<p>Une {{domxref("DOMException")}} avec le code <code>NO_MODIFICATION_ALLOWED_ERR</code> est levée lors d'une tentative de mise à jour d'un attribut en lecture seule ou lorsque l'objet lui-même est en lecture seule.</p> + +<h2 id="Specifications">Spécifications</h2> + +<table class="standard-table"> + <thead> + <tr> + <th scope="col">Spécification</th> + <th scope="col">Statut</th> + <th scope="col">Commentaire</th> + </tr> + </thead> + <tbody> + <tr> + <td>{{SpecName("SVG1.1", "coords.html#InterfaceSVGMatrix", "SVGMatrix")}}</td> + <td>{{Spec2("SVG1.1")}}</td> + <td>Définition initiale</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility">Compatibilité des navigateurs</h2> + +<p>{{Compat("api.SVGMatrix")}}</p> |