1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
|
---
title: rotate3d()
slug: Web/CSS/transform-function/rotate3d()
tags:
- Função CSS
- Referencia
- Transformações CSS
translation_of: Web/CSS/transform-function/rotate3d()
---
<div>{{CSSRef}}</div>
<p>A função <a href="/en-US/docs/Web/CSS">CSS</a> <strong><code>rotate3d()</code></strong> define uma transformação que gira um elemento em torno de um eixo fixo no espaço 3D, sem deformá-lo. Seu resultado é um dado do tipo {{cssxref("<transform-function>")}}.</p>
<p>No espaço 3D, rotações têm três graus de liberdade que, juntos, descrevem um único eixo de rotação. O eixo de rotação é definido por um vetor [x, y, z] e passado pela origem (como definido pela propriedade {{ cssxref("transform-origin") }}). Se, como especificado, o vetor não for <em>normalizado</em> (isto é, se a soma dos quadrados das suas três coordenadas não for 1), o {{glossary("user agent")}} irá normalizá-lo internamente. Um vetor não-normalizável, como o vetor nulo [0, 0, 0], fará com que a rotação seja ignorada, mas sem invalidar toda a propriedade CSS.</p>
<div class="note"><strong>Nota:</strong> Diferente de rotações no plano 2D, a composição de rotações 3D normalmente não é comutativa. Em outras palavras, a ordem na qual as rotações são aplicadas impacta o resultado.</div>
<h2 id="Sintaxe">Sintaxe</h2>
<p>A quantidade de rotação criada por <code>rotate3d()</code> é especificada por três {{cssxref("<number>")}} e um {{cssxref("<angle>")}}. Os <code><number></code> representam as coordenadas x, y e z do vetor, denotando o eixo de rotação. O <code><angle></code> representa o ângulo de rotação; se positivo, o movimento será no sentido horário; se negativo, será no sentido anti-horário.</p>
<pre class="syntaxbox notranslate">rotate3d(<em>x</em>, <em>y</em>, <em>z</em>, <em>a</em>)
</pre>
<h3 id="Valores">Valores</h3>
<dl>
<dt><code>x</code></dt>
<dd>É um {{cssxref("<number>")}} descrevendo a coordenada x do vetor denotando o eixo de rotação que pode ser entre 0 e 1.</dd>
<dt><code>y</code></dt>
<dd>É um {{cssxref("<number>")}} descrevendo a coordenada y do vetor denotando o eixo de rotação que pode ser entre 0 e 1.</dd>
<dt><code>z</code></dt>
<dd>É um {{cssxref("<number>")}} descrevendo a coordenada z do vetor denotando o eixo de rotação que pode ser entre 0 e 1.</dd>
<dt><code>a</code></dt>
<dd>É um {{ cssxref("<angle>") }} representando o ângulo de rotação. Um ângulo positivo denota uma rotação no sentido horário, e um negativo no sentido anti-horário.</dd>
</dl>
<table class="standard-table">
<tbody>
<tr>
<th scope="col">Coordenadas cartesianas em ℝ<sup>2</sup></th>
<td rowspan="2">Essa transformação se aplica ao plano 3D e não pode ser representada em um plano.</td>
</tr>
<tr>
<th scope="col">Coordenadas homogêneas em ℝℙ<sup>2</sup></th>
</tr>
<tr>
<th scope="col">Coordenadas cartesianas em ℝ<sup>3</sup></th>
<td colspan="1"><a href="/@api/deki/files/5987/=transform-functions-rotate3d_cart.png"><img src="/@api/deki/files/5987/=transform-functions-rotate3d_cart.png?size=webview" style="height: 47px; width: 510px;"></a><math> <mfenced><mtable><mtr><mtd>1<mo>+</mo>(1<mo>-</mo>cos(<mi>a</mi>))(<msup><mi>x</mi><mn>2</mn></msup><mo>-</mo>1)</mtd><mtd><mi>z</mi><mo>·</mo>sin(<mi>a</mi>)+<mi>x</mi><mi>y</mi>(1<mo>-</mo>cos(<mi>a</mi>))</mtd><mtd><mo>-</mo><mi>y</mi><mo>·</mo>sin(<mi>a</mi>)<mo>+</mo><mi>x</mi><mi>z</mi><mo>·</mo>(1<mo>-</mo>cos(<mi>a</mi>))</mtd></mtr><mtr><mtd><mo>-</mo><mi>z</mi><mo>·</mo>sin(<mi>a</mi>)<mo>+</mo><mi>x</mi><mi>y</mi><mo>·</mo>(1<mo>-</mo>cos(<mi>a</mi>))</mtd><mtd>1+(1-cos(a))(y2-1)</mtd><mtd><mi>x</mi><mo>·</mo>sin(<mi>a</mi>)<mo>+</mo><mi>y</mi><mi>z</mi><mo>·</mo>(1<mo>-</mo>cos(<mi>a</mi>))</mtd><mtr><mtd>ysin(a) + xz(1-cos(a))</mtd><mtd>-xsin(a)+yz(1-cos(a))</mtd><mtd>1+(1-cos(a))(z2-1)</mtd><mtd>t</mtd></mtr><mtr><mtd>0</mtd><mtd>0</mtd><mtd>0</mtd><mtd>1</mtd></mtr> </mtr></mtable></mfenced></math></td>
</tr>
<tr>
<th scope="col">Coordenadas homogêneas em ℝℙ<sup>3</sup></th>
<td colspan="1"><a href="/@api/deki/files/5986/=transform-functions-rotate3d_hom4.png"><img src="/@api/deki/files/5986/=transform-functions-rotate3d_hom4.png?size=webview" style="height: 61px; width: 522px;"></a></td>
</tr>
</tbody>
</table>
<h2 id="Exemplos">Exemplos</h2>
<h3 id="Rotacionando_no_eixo_y">Rotacionando no eixo y</h3>
<h4 id="HTML">HTML</h4>
<pre class="brush: html notranslate"><div>Normal</div>
<div class="rotated">Rotacionado</div></pre>
<h4 id="CSS">CSS</h4>
<pre class="brush: css notranslate">body {
perspective: 800px;
}
div {
width: 80px;
height: 80px;
background-color: skyblue;
}
.rotated {
transform: rotate3d(0, 1, 0, 60deg);
background-color: pink;
}
</pre>
<h4 id="Resultado">Resultado</h4>
<p>{{EmbedLiveSample("Rotating_on_the_y-axis", "auto", 180)}}</p>
<h3 id="Rotacionando_em_um_eixo_customizado">Rotacionando em um eixo customizado</h3>
<h4 id="HTML_2">HTML</h4>
<pre class="brush: html notranslate"><div>Normal</div>
<div class="rotated">Rotacionado</div></pre>
<h4 id="CSS_2">CSS</h4>
<pre class="brush: css notranslate">body {
perspective: 800px;
}
div {
width: 80px;
height: 80px;
background-color: skyblue;
}
.rotated {
transform: rotate3d(1, 2, -1, 192deg);
background-color: pink;
}
</pre>
<h4 id="Resultado_2">Resultado</h4>
<p>{{EmbedLiveSample("Rotating_on_a_custom_axis", "auto", 180)}}</p>
<h2 id="Browser_compatibility">Compatibilidade com navegadores</h2>
<p>Veja o tipo de dado <code><a href="/en-US/docs/Web/CSS/transform-function#Browser_compatibility"><transform-function></a></code> para informações de compatibilidade.</p>
<h2 id="Ver_também">Ver também</h2>
<ul>
<li>{{cssxref("transform")}}</li>
<li>{{cssxref("<transform-function>")}}</li>
</ul>
|
