- From: Dirk Schulze via cvs-syncmail <cvsmail@w3.org>
- Date: Sun, 26 Feb 2012 17:32:31 +0000
- To: public-css-commits@w3.org
Update of /sources/public/csswg/css3-transforms
In directory hutz:/tmp/cvs-serv11060
Modified Files:
Overview.html Transforms.src.html ChangeLog
Log Message:
2012-02-26 dschulze@adobe.com
Cleanup style of document to match CSS3 background and CSS3 images.
Fixed typos.
Index: Overview.html
===================================================================
RCS file: /sources/public/csswg/css3-transforms/Overview.html,v
retrieving revision 1.31
retrieving revision 1.32
diff -u -d -r1.31 -r1.32
--- Overview.html 26 Feb 2012 05:45:34 -0000 1.31
+++ Overview.html 26 Feb 2012 17:32:28 -0000 1.32
@@ -189,18 +189,22 @@
Transform Rendering</a>
</ul>
- <li><a href="#transform-property"><span class=secno>6. </span> The <code
- class=property>'transform'</code> Property </a>
+ <li><a href="#transform-property"><span class=secno>6. </span> The
+ ‘<code class=css><code
+ class=property>transform</code></code>’ Property </a>
<li><a href="#svg-transform"><span class=secno>7. </span> The SVG
- ‘<code class=property>transform</code>’ Attribute </a>
[...1456 lines suppressed...]
+ class=css>rotate(90deg)</code></code>’ would cause elements to
+ appear rotated one-quarter of a turn in the clockwise direction.
<dt> <code class=css>skew(<angle>[, <angle>])</code>
@@ -2215,10 +2347,10 @@
<p> After interpolation the resulting values are used to position the
element. One way to use these values is to recompose them into a 4x4
- matrix. This can be done using the transform functions of the <a
- href="#effects"><em>transform</em></a> property. This can be done by the
- following pseudo code. The values passed in are the output of the Unmatrix
- function above:
+ matrix. This can be done using the transform functions of the ‘<a
+ href="#effects"><code class=property>transform</code></a>’ property.
+ This can be done by the following pseudo code. The values passed in are
+ the output of the Unmatrix function above:
<pre>
matrix3d(1,0,0,0, 0,1,0,0, 0,0,1,0, perspective[0], perspective[1], perspective[2], perspective[3])
Index: Transforms.src.html
===================================================================
RCS file: /sources/public/csswg/css3-transforms/Transforms.src.html,v
retrieving revision 1.34
retrieving revision 1.35
diff -u -d -r1.34 -r1.35
--- Transforms.src.html 26 Feb 2012 05:45:35 -0000 1.34
+++ Transforms.src.html 26 Feb 2012 17:32:29 -0000 1.35
@@ -105,8 +105,8 @@
with positive values proceeding to the right and down.
</p>
<p>
- This coordinate space can be modified with the <code
- class="property">'transform'</code> property. Using transform, elements
+ This coordinate space can be modified with the '<code
+ class="property">transform</code>' property. Using transform, elements
can be translated, rotated and scaled in two or three dimensional space.
</p>
<p>
@@ -115,25 +115,25 @@
</p>
<ul>
<li>
- The <code class="property"> 'transform-origin'</code> property
+ The '<code class="property">transform-origin</code>' property
provides a convenient way to control the origin about which transforms on
an element are applied.
</li>
<li>
- The <code class="property">'perspective'</code> property allows the author
+ The '<code class="property">perspective</code>' property allows the author
to make child elements with three-dimensional transforms appear as if they live in a common
three-dimensional space.
- The <code class="property">'perspective-origin'</code> property provides control
+ The '<code class="property">perspective-origin</code>' property provides control
over the origin at which perspective is applied, effectively changing the location of
the "vanishing point".
</li>
<li>
- The <code class="property">'transform-style'</code> property allows 3D-transformed
+ The '<code class="property">transform-style</code>' property allows 3D-transformed
elements and their 3D-transformed descendants to share a common three-dimensional
space, allowing the construction of hierarchies of three-dimensional objects.
</li>
<li>
- The <code class="property">'backface-visibility'</code> property comes into play
+ The '<code class="property">backface-visibility</code>' property comes into play
when an element is flipped around via three-dimensional transforms such that its
reverse side is visible to the viewer. In some situations it is desirable to
hide the element in this situation, which is possible using the value of 'hidden'
@@ -141,7 +141,7 @@
</li>
</ul>
<p>
- Note that while some values of the <code class="property">'transform'</code> property
+ Note that while some values of the '<code class="property">transform</code>' property
allow an element to be transformed in a three-dimensional coordinate system, the elements
themselves are not three-dimensional objects. Instead, they exist on a two-dimensional
plane (a flat surface) and have no depth.
@@ -196,7 +196,7 @@
<dd>
<p>
A transformable element in the HTML namespace which is either a block-level or atomic inline-level
- element, or an element in the SVG namespace (see [[SVG11]]) which has the attributes 'transform',
+ element, or an element in the SVG namespace (see [[SVG11]]) which has the attributes '<code class="property">transform</code>',
'patternTransform' or 'gradientTransform'.
</p>
</dd>
@@ -204,14 +204,14 @@
<dt id="TermPerspectiveMatrix"><dfn>perpsective matrix</dfn></dt>
<dd>
<p>
- A matrix computed from the values of the <code class="property">perspective</code> and <code class="property">perspective-origin</code> properties as described <a href="#perspective-matrix-computation">below</a>.
+ A matrix computed from the values of the '<code class="property">perspective</code>' and '<code class="property">perspective-origin</code>' properties as described <a href="#perspective-matrix-computation">below</a>.
</p>
</dd>
<dt id="TermTransformationMatrix"><dfn>transformation matrix</dfn></dt>
<dd>
<p>
- A matrix computed from the values of the <code class="property">transform</code> and <code class="property">transform-origin</code> properties as described <a href="#transformation-matrix-computation">below</a>.
+ A matrix computed from the values of the '<code class="property">transform</code>' and '<code class="property">transform-origin</code>' properties as described <a href="#transformation-matrix-computation">below</a>.
</p>
</dd>
@@ -219,7 +219,7 @@
<dd>
<p>
A containing block hierarchy of one or more levels, instantiated by elements with a computed value for
- the <code class="property">transform-style</code> property of <code class="css">preserve-3d</code>,
+ the '<code class="property">transform-style</code>' property of '<code class="css">preserve-3d</code>',
whose elements share a common three-dimensional coordinate system.
</p>
</dd>
@@ -231,13 +231,13 @@
<h2 id="transform-rendering">The Transform Rendering Model</h2>
<!-- This section is normative -->
<p>
- Specifying a value other than 'none' for the <code class="property">'transform'</code>
+ Specifying a value other than '<code class="css">none</code>' for the '<code class="property">transform</code>'
property establishes a new <em>local coordinate system</em> at the element that it is
applied to. The mapping from where the element would have rendered into that local coordinate system
is given by the element's <a href="#TermTransformationMatrix"><i>transformation matrix</i></a>.
Transformations are cumulative. That is, elements establish their local
coordinate system within the coordinate system of their parent. From the perspective of the
- user, an element effectively accumulates all the <code class="property">'transform'</code>
+ user, an element effectively accumulates all the '<code class="property">transform</code>'
properties of its ancestors as well as any local transform applied to it. The accumulation
of these transforms defines a <em>current transformation matrix (CTM)</em> for the element.
</p>
@@ -252,17 +252,17 @@
</p>
<p id="transformation-matrix-computation">
The <a href="#TermTransformationMatrix"><i>transformation matrix</i></a> is computed
- from the <code class="property">transform</code> and <code class="property">transform-origin</code> properties
+ from the '<code class="property">transform</code>' and '<code class="property">transform-origin</code>' properties
as follows:
<ol>
<li>Start with the identity matrix.</li>
- <li>Translate by the computed X, Y and Z values of <code class="property">transform-origin</code></li>
- <li>Multiply by each of the transform functions in <code class="property">transform</code> property in turn</li>
- <li>Translate by the negated computed X, Y and Z values of <code class="property">transform-origin</code></li>
+ <li>Translate by the computed X, Y and Z values of '<code class="property">transform-origin</code>'</li>
+ <li>Multiply by each of the transform functions in '<code class="property">transform</code>' property in turn</li>
+ <li>Translate by the negated computed X, Y and Z values of '<code class="property">transform-origin</code>'</li>
</ol>
</p>
<p>
- Transforms apply to <a href="#TermTransformableElement">transformable elements</a>.
+ Transforms apply to <span class="term">transformable elements</span>.
</p>
<div class="example">
@@ -284,7 +284,7 @@
transform: translate(80px, 80px) scale(1.5, 1.5) rotate(45deg);
}
</pre>
- <p>This transform moves the element by 80 pixels in both the X and Y directions, then scales the element by 150%, then rotates it 45° clockwise about the Z axis. Note that the scale and rotation operate about the center of the element, since the element has the default transform-origin of 50% 50%.</p>
+ <p>This transform moves the element by 80 pixels in both the X and Y directions, then scales the element by 150%, then rotates it 45° clockwise about the Z axis. Note that the scale and rotation operate about the center of the element, since the element has the default transform-origin of '<code class="css">50% 50%</code>'.</p>
<div class="figure">
<img src="compound_transform.png" alt="The transform specified above">
</div>
@@ -292,9 +292,9 @@
<p>Note that an identical rendering can be obtained by nesting elements with the equivalent transforms:
<pre>
<div style="transform: translate(80px, 80px)">
- <div style="transform: scale(1.5, 1.5)">
- <div style="transform: rotate(45deg)"></div>
- </div>
+ <div style="transform: scale(1.5, 1.5)">
+ <div style="transform: rotate(45deg)"></div>
+ </div>
</div>
</pre>
</div>
@@ -305,12 +305,12 @@
surrounding the transformed element. However, the extent of the overflow
area takes into account transformed elements. This behavior is similar
to what happens when elements are offset via relative positioning.
- Therefore, if the value of the <code class="property">'overflow'</code>
- property is <code class="css">'scroll'</code> or <code class="css">'auto'</code>,
+ Therefore, if the value of the '<code class="property">overflow</code>'
+ property is '<code class="css">scroll</code>' or '<code class="css">auto</code>',
scrollbars will appear as needed to see content that is transformed outside the visible area.
</p>
<p>
- In the HTML namespace, any value other than 'none' for the transform results in the creation of
+ In the HTML namespace, any value other than '<code class="css">none</code>' for the transform results in the creation of
both a stacking context and a containing block. The object acts as a
containing block for fixed positioned descendants.
</p>
@@ -347,9 +347,16 @@
</p>
<pre>
<style>
-div { height: 150px; width: 150px; }
-.container { border: 1px solid black; }
-.transformed { transform: rotateY(50deg); }
+div {
+ height: 150px;
+ width: 150px;
+}
+.container {
+ border: 1px solid black;
+}
+.transformed {
+ transform: rotateY(50deg);
+}
</style>
<div class="container">
@@ -365,18 +372,18 @@
</div>
<p>
- The <code class="property">perspective</code> and <code class="property">perspective-origin</code>
+ The '<code class="property">perspective</code>' and '<code class="property">perspective-origin</code>'
properties can be used to add a feeling of depth to a scene by making elements higher on the Z axis
- (closer to the viewer) appear larger, and those futher away to appear smaller.
+ (closer to the viewer) appear larger, and those further away to appear smaller.
</p>
<p id="perspective-matrix-computation">
The <a href="#TermPerspectiveMatrix"><i>perspective matrix</i></a> is computed as follows:
<!-- Make this more mathy, with matrices? -->
<ol>
<li>Start with the identity matrix.</li>
- <li>Translate by the computed X and Y values of <code class="property">perspective-origin</code></li>
- <li>Multiply by the matrix that would be obtained from the <a href="#perspective-function"><code class="css">perspective(<length>)</code></a> transform function, where the length is provided by the value of the <code class="property">perspective</code> property</li>
- <li>Translate by the negated computed X and Y values of <code class="property">perspective-origin</code></li>
+ <li>Translate by the computed X and Y values of '<code class="property">perspective-origin</code>'</li>
+ <li>Multiply by the matrix that would be obtained from the '<a href="#perspective-function"><code class="css">perspective(<length>)</code></a>' transform function, where the length is provided by the value of the '<code class="property">perspective</code>' property</li>
+ <li>Translate by the negated computed X and Y values of '<code class="property">perspective-origin</code>'</li>
</ol>
</p>
@@ -385,9 +392,17 @@
</p>
<pre>
<style>
-div { height: 150px; width: 150px; }
-.container { perspective: 500px; border: 1px solid black; }
-.transformed { transform: rotateY(50deg); }
+div {
+ height: 150px;
+ width: 150px;
+}
+.container {
+ perspective: 500px;
+ border: 1px solid black;
+}
+.transformed {
+ transform: rotateY(50deg);
+}
</style>
<div class="container">
@@ -400,7 +415,7 @@
</div>
<p>The inner element has the same transform as in the previous example, but its rendering is now influenced by the perspective
property on its parent element. Perspective causes vertices that have positive Z coordinates (closer to the viewer)
- to be scaled up in X and Y, and those futher away (negative Z coordinates) to be scaled down, giving an appearance of depth.
+ to be scaled up in X and Y, and those further away (negative Z coordinates) to be scaled down, giving an appearance of depth.
</p>
</div>
@@ -429,19 +444,32 @@
<div class="example">
<pre>
<style>
-div { height: 150px; width: 150px; }
-.container { perspective: 500px; border: 1px solid black; }
-.transformed { transform: rotateY(50deg); background-color: blue; }
-.child { transform-origin: top left; transform: rotateX(40deg); background-color: lime; }
+div {
+ height: 150px;
+ width: 150px;
+}
+.container {
+ perspective: 500px;
+ border: 1px solid black;
+}
+.transformed {
+ transform: rotateY(50deg);
+ background-color: blue;
+}
+.child {
+ transform-origin: top left;
+ transform: rotateX(40deg);
+ background-color: lime;
+}
</style>
<div class="container">
- <div class="transformed">
- <div class="child"></div>
- </div>
+ <div class="transformed">
+ <div class="child"></div>
+ </div>
</div>
</pre>
- <p>This exmaple shows how nested 3D transforms are rendered in the absence of <code>transform-style: preserve-3d</code>. The blue div is transformed as in the previous example, with its rendering influenced by the perspective on its parent element. The lime element also has a 3D transform, which is a rotation about the X axis (anchored at the top, by virtue of the transform-origin). However, the lime element is being rendered into the plane of its parent because it is not a member of a 3D rendering context; the parent is "flattening".
+ <p>This example shows how nested 3D transforms are rendered in the absence of '<code class="css">transform-style: preserve-3d</code>'. The blue div is transformed as in the previous example, with its rendering influenced by the perspective on its parent element. The lime element also has a 3D transform, which is a rotation about the X axis (anchored at the top, by virtue of the transform-origin). However, the lime element is being rendered into the plane of its parent because it is not a member of a 3D rendering context; the parent is "flattening".
</p>
<div class="figure">
<img src="examples/3d-rendering-context-flat.png" width="240" height="200" alt="Nested 3D transforms, with flattening">
@@ -452,14 +480,14 @@
<ul>
<li>
A <span class="term">3D rendering context</span> is established by a
- a transformable element whose computed value for <code class="property">transform-style</code> is
- <code class="css">'preserve-3d'</code>, and which itself is not part of a 3D rendering context.
+ a <span class="term">transformable element</span> whose computed value for '<code class="property">transform-style</code>' is
+ '<code class="css">preserve-3d</code>', and which itself is not part of a 3D rendering context.
Note that such an element is always a containing block. An element that establishes a 3D rendering context
also participates in that context.
</li>
<li>
- An element whose computed value for <code class="property">transform-style</code> is
- <code style="css">'preserve-3d'</code>, and which itself participates in a
+ An element whose computed value for '<code class="property">transform-style</code>' is
+ '<code class="css">preserve-3d</code>', and which itself participates in a
<span class="term">3D rendering context</span>, extends that 3D rendering context rather than establishing
a new one.
</li>
@@ -490,13 +518,27 @@
<div class="example">
<pre>
<style>
-div { height: 150px; width: 150px; }
-.container { perspective: 500px; border: 1px solid black; }
-.transformed { <b>transform-style: preserve-3d</b>; transform: rotateY(50deg); background-color: blue; }
-.child { transform-origin: top left; transform: rotateX(40deg); background-color: lime; }
+div {
+ height: 150px;
+ width: 150px;
+}
+.container {
+ perspective: 500px;
+ border: 1px solid black;
+}
+.transformed {
+ <b>transform-style: preserve-3d</b>;
+ transform: rotateY(50deg);
+ background-color: blue;
+}
+.child {
+ transform-origin: top left;
+ transform: rotateX(40deg);
+ background-color: lime;
+}
</style>
</pre>
- <p>This example is identical to the previous example, with the addition of <code>transform-style: preserve-3d</code> on the blue element. The blue element now establishes a 3D rendering context, of which the lime element is a member. Now both blue and lime elements share a common three-dimensional space, so the lime element renders as tilting out from its parent, influenced by the perspective on the container.
+ <p>This example is identical to the previous example, with the addition of '<code class="css">transform-style: preserve-3d</code>' on the blue element. The blue element now establishes a 3D rendering context, of which the lime element is a member. Now both blue and lime elements share a common three-dimensional space, so the lime element renders as tilting out from its parent, influenced by the perspective on the container.
</p>
<div class="figure">
<img src="examples/3d-rendering-context-3d.png" width="240" height="200" alt="Nested 3D transforms, with preserve-3d.">
@@ -567,9 +609,9 @@
is towards the viewer. 3D-tranformed elements show the same content on both sides, so the reverse side
looks like a mirror-image of the front side (as if the element were painted onto a sheet of glass).
Normally, elements whose reverse side is towards the viewer remain visible. However, the
- <code class="property">'backface-visibility'</code> property allows the author to make an element invisible
+ '<code class="property">backface-visibility</code>' property allows the author to make an element invisible
when its reverse side is towards the viewer. This behavior is "live"; if an element with
- <code class="css">backface-visibility: hidden</code> were animating,
+ '<code class="css">backface-visibility: hidden</code>' were animating,
such that its front and reverse sides were alternately visible, then it would only be visible when the
front side were towards the viewer.
</p>
@@ -577,11 +619,11 @@
<!-- ======================================================================================================= -->
<h2 id="transform-property">
- The <code class="property">'transform'</code> Property
+ The '<code class="property">transform</code>' Property
</h2>
<p>
A transformation is applied to the coordinate system an element
- renders in through the <code class="property">'transform'</code> property. This property contains a
+ renders in through the '<code class="property">transform</code>' property. This property contains a
list of <a href="#transform-functions">transform functions</a>. The
final transformation value for a coordinate system is obtained by converting
each function in the list to its corresponding matrix like defined in <a href="#mathematical-description">Mathematical
@@ -661,30 +703,30 @@
</div>
<p>The computed value of the transform property is a matrix() or matrix3d() value that describes the matrix that results from concatenating the individual transform functions. If the resulting matrix can be represented as a two-dimensional matrix with no loss of information, then a matrix() value is returned, otherwise a matrix3d() value. For elements with no transform applied, the computed value is 'none'.</p>
- <p>Any value other than 'none' for the transform results in the creation of both a stacking context and a containing block. The object acts as a containing block for fixed positioned descendants.</p>
+ <p>Any value other than '<code class="css">none</code>' for the transform results in the creation of both a stacking context and a containing block. The object acts as a containing block for fixed positioned descendants.</p>
<!-- ======================================================================================================= -->
<h2 id="svg-transform">
- The SVG 'transform' Attribute
+ The SVG '<code class="property">transform</code>' Attribute
</h2>
<p>
The <a href="http://www.w3.org/TR/2011/REC-SVG11-20110816/">SVG 1.1 specification</a> did not
- specify the attributes 'transform', 'gradientTransform' or 'patternTransform' as
- <a href="http://www.w3.org/TR/2011/REC-SVG11-20110816/styling.html#UsingPresentationAttributes">presentation attributes</a>.
+ specify the attributes '<code class="property">transform</code>', 'gradientTransform' or 'patternTransform' as
+ <a href="http://www.w3.org/TR/2011/REC-SVG11-20110816/styling.html#UsingPresentationAttributes"><em>presentation attributes</em></a>.
In order to improve the integration of SVG and HTML, this specification makes these SVG attributes to
- 'presentation attributes' and makes the 'transform' property one that applies to transformable elements in the SVG namespace.
+ 'presentation attributes' and makes the '<code class="property">transform</code>' property one that applies to <span class="term">transformable elements</span> in the SVG namespace.
</p>
<p>
- This specification will also introduce the new presentation attributes <code class="property">'transform-origin'</code>,
- <code class="property">'perspective'</code>, <code class="property">'perspective-origin'</code>,
- <code class="property">'transform-style'</code> and <code class="property">'backface-visibility'</code>
+ This specification will also introduce the new presentation attributes '<code class="property">transform-origin</code>',
+ '<code class="property">perspective</code>', '<code class="property">perspective-origin</code>',
+ '<code class="property">transform-style</code>' and '<code class="property">backface-visibility</code>'
in the SVG namespace. All new introduced presentation attributes are animateable.
</p>
- <h3 id="transform-attribute-specificity">SVG 'transform' attribute specificity</h3>
+ <h3 id="transform-attribute-specificity">SVG '<code class="property">transform</code>' attribute specificity</h3>
<p>Since the previously named SVG attributes become presentation attributes, their participation to the CSS
cascade is determined by the specificity of presentation attributes, as
@@ -694,7 +736,7 @@
<div class="example">
<p>
- This example shows the combination of the <code class="property">'transform'</code> style property and the 'transform' presentation attribute.
+ This example shows the combination of the '<code class="property">transform</code>' style property and the '<code class="property">transform</code>' presentation attribute.
</p>
<pre><svg>
@@ -714,20 +756,20 @@
</div>
<p>
- Because of the participation to the CSS cascade, the <code class="property">'transform'</code> style property overrides the
- 'transform' presentation attribute. Therefore the container gets translated by 100px in horizontal and vertical direction, instead of 200px.
+ Because of the participation to the CSS cascade, the '<code class="property">transform</code>' style property overrides the
+ '<code class="property">transform</code>' presentation attribute. Therefore the container gets translated by '<code class="css">100px</code>' in horizontal and vertical direction, instead of '<code class="css">200px</code>'.
</p>
</div>
- <h3 id="svg-syntax">Syntax of the SVG 'transform' attribute</h3>
+ <h3 id="svg-syntax">Syntax of the SVG '<code class="property">transform</code>' attribute</h3>
<p>
- To provide backward compatibility, the syntax of the 'transform' presentation attribute differs from
- the syntax of the 'transform' style property like shown in the example above. However, the syntax
- used for the 'transform' style property can be used for a 'transform' presentation attribute value.
+ To provide backward compatibility, the syntax of the '<code class="property">transform</code>' presentation attribute differs from
+ the syntax of the '<code class="property">transform</code>' style property like shown in the example above. However, the syntax
+ used for the '<code class="property">transform</code>' style property can be used for a '<code class="property">transform</code>' presentation attribute value.
Authors are advised to follow the rules of <a href="http://www.w3.org/TR/css3-values/#functional-notation">CSS Values and Units Module</a>.
- Therefore an author should write <code>transform="translate(200px, 200px)"</code> instead of
- <code>transform="translate (200 200)"</code> because the second example with the spaces before the '(',
+ Therefore an author should write '<code class="css">transform="translate(200px, 200px)"</code>' instead of
+ '<code class="css">transform="translate (200 200)"</code>' because the second example with the spaces before the '<code class="css">(</code>',
the missing comma between the arguments and the values without the explicit unit notation would be valid for
the attribute only.
</p>
@@ -735,9 +777,9 @@
<h4 id="svg-transform-list">Transform List</h4>
<p>
- The value for the 'transform' attribute consists of a transform list with zero or more transform functions
+ The value for the '<code class="property">transform</code>' attribute consists of a transform list with zero or more transform functions
in the <a href="#svg-functional-notation">functional notation</a>. If the transform list consists of more than one
- transform function, these functions are separated by either a comma (‘,’) with optional whitespace
+ transform function, these functions are separated by either a comma (‘<code class="css">,</code>’) with optional whitespace
before and after the comma or one or more whitespaces. The transform list can have
optional whitespaces before and after the list.
</p>
@@ -748,7 +790,7 @@
The syntax starts with the name of the function followed by optional whitespaces followed by a left
parenthesis followed by optional whitespace followed by the argument(s) to the notation followed by
optional whitespace followed by a right parenthesis. If a function takes more than one argument, the
- arguments are either separated by a comma (‘,’) with optional whitespace before and after the comma
+ arguments are either separated by a comma (‘<code class="css">,</code>’) with optional whitespace before and after the comma
or one or more whitespaces.
</p>
@@ -760,26 +802,26 @@
data types in CSS Values and Units Module gets enhanced as follows:
</p>
- <h5 id="svg-transform-value">The '<translation-value>' and '<length>' type</h5>
+ <h5 id="svg-transform-value">The <var><translation-value></var> and <var><length></var> type</h5>
<p>
- A translation-value or length can be a '<number>' without an unit identifier. In this case
- the <a href="#svg-number"><i>number</i></a> gets interpreted as "user unit". A user unit in the the
+ A translation-value or length can be a <var><number></var> without an unit identifier. In this case
+ the <a href="#svg-number"><var>number</var></a> gets interpreted as "user unit". A user unit in the the
<a href="http://www.w3.org/TR/2003/REC-SVG11-20030114/coords.html#InitialCoordinateSystem">initial
- coordinate system</a> is equivalenced to the parent environment's notion of a px unit.
+ coordinate system</a> is equivalenced to the parent environment's notion of a pixel unit.
</p>
- <h5 id="svg-angle">The '<angle>' type</h5>
+ <h5 id="svg-angle">The <var><angle></var> type</h5>
<p>
- An angle can be a '<number>' without an unit identifier. In this case the <a href="#svg-number"><i>number</i></a>
+ An angle can be a <var><number></var> without an unit identifier. In this case the <a href="#svg-number"><i>number</i></a>
gets interpreted as a value in degrees.
</p>
- <h5 id="svg-number">The '<number>' type</h5>
+ <h5 id="svg-number">The <var><number></var> type</h5>
<p>
- SVG supports scientific notations for numbers. Therefore a <i>number</i> gets parsed like described in SVG
+ SVG supports scientific notations for numbers. Therefore a <var>number</var> gets parsed like described in SVG
<a href="http://www.w3.org/TR/SVG/types.html#DataTypeNumber">Basic data types</a> for SVG attributes.
</p>
@@ -788,16 +830,16 @@
<p>
SVG specifies the attributes 'gradientTransform' and 'patternTransform'. This specification
makes both attributes to presentation attributes. Both attributes use the same <a href="#svg-syntax">syntax</a> as
- the SVG 'transform' attribute. This specification won't introduce corresponding CSS style properties. Instead the
- style can be set by the <code class="property">'transform'</code> style property.
+ the SVG '<code class="property">transform</code>' attribute. This specification won't introduce corresponding CSS style properties. Instead the
+ style can be set by the '<code class="property">transform</code>' style property.
</p>
<h3 id="svg-transformation-functions">SVG transformation functions</h3>
<p>
For backward compatibility to existing SVG content, this specification must support all transform functions
- defined by <a href="http://www.w3.org/TR/SVG/coords.html#TransformAttribute">The 'transform' attribute</a> in SVG 1.1.
- Therefore the two-dimensional transform function <code class="css">rotate(<angle>)</code> gets extended as follows:
+ defined by <a href="http://www.w3.org/TR/SVG/coords.html#TransformAttribute">The '<code class="property">transform</code>' attribute</a> in SVG 1.1.
+ Therefore the two-dimensional transform function '<code class="css">rotate(<angle>)</code>' gets extended as follows:
</p>
<dl>
@@ -806,10 +848,10 @@
</dt>
<dd>
specifies a <a href="#RotateDefined">2D rotation</a> by the angle specified in the parameter about the origin of the element, as defined
- by the <em>transform-origin</em> property. If the optional translation values are specified, the transform origin is translated by that amount
+ by the '<code class="property">transform-origin</code>' property. If the optional translation values are specified, the transform origin is translated by that amount
(using the current transformation matrix) for the duration of the rotate operation.
- For example rotate(90deg, 100px, 100px) would elements cause to appear rotated one-quarter of a turn in the clockwise direction after a translation
- of 100px in the vertical and horizontal direction.
+ For example '<code class="css">rotate(90deg, 100px, 100px)</code>' would elements cause to appear rotated one-quarter of a turn in the clockwise direction after a translation
+ of 100 pixel in the vertical and horizontal direction.
</dd>
</dl>
@@ -821,19 +863,19 @@
<p>
This specification explicitly allows to apply three-dimensional transform functions to the
- <a href="http://www.w3.org/TR/SVG/intro.html#TermContainerElement">container elements</a>:
- 'a', 'g', 'svg', all <a href="http://www.w3.org/TR/SVG/intro.html#TermGraphicsElement">graphics elements</a>, all
- <a href="http://www.w3.org/TR/SVG/intro.html#TermGraphicsReferencingElement">graphics referencing elements</a>
+ <a href="http://www.w3.org/TR/SVG/intro.html#TermContainerElement"><em>container elements</em></a>:
+ 'a', 'g', 'svg', all <a href="http://www.w3.org/TR/SVG/intro.html#TermGraphicsElement"><em>graphics elements</em></a>, all
+ <a href="http://www.w3.org/TR/SVG/intro.html#TermGraphicsReferencingElement"><em>graphics referencing elements</em></a>
and the SVG <a href="http://www.w3.org/TR/SVG/extend.html#ForeignObjectElement">'foreignObject'</a> element.
</p>
<p>
- Three-dimensional transform functions and the properties <code class="property">'perspective'</code>,
- <code class="property">'perspective-origin'</code>, <code class="property">'transform-style'</code>
- and <code class="property">'backface-visibility'</code> can not be used for the elements: 'clipPath', 'mask', 'linearGradient',
+ Three-dimensional transform functions and the properties '<code class="property">perspective</code>',
+ '<code class="property">perspective-origin</code>', '<code class="property">transform-style</code>'
+ and '<code class="property">backface-visibility</code>' can not be used for the elements: 'clipPath', 'mask', 'linearGradient',
'radialGradient' and 'pattern'. If a transform list includes a three-dimensional transform function, the complete
transform list must be ignored. The values of every previously named property must be ignored.
- Transformable elements that are contained by one of these elements can have three-dimensional transform functions.
+ <span class="term">Transformable elements</span> that are contained by one of these elements can have three-dimensional transform functions.
Before a 'clipPath', 'mask' or 'pattern' element can get applied to a target element, user agents must take the drawn results as static
images in analogue of "flattening" the elements and taking the rendered content as a two-dimensional canvas.
</p>
@@ -855,8 +897,8 @@
<div class="example">
<p>
- The 'transform-origin' property on the pattern in the following example specifies a 50% translation of the origin in the horizontal and vertical dimension.
- The 'transform' property specifies a translation as well, but in absolute lengths.
+ The '<code class="property">transform-origin</code>' property on the pattern in the following example specifies a '<code class="css">50%</code>' translation of the origin in the horizontal and vertical dimension.
+ The '<code class="property">transform</code>' property specifies a translation as well, but in absolute lengths.
</p>
<pre><svg>
@@ -878,45 +920,45 @@
<p>
A SVG 'pattern' element doesn't have an object bounding box. Therefore the relative values of the
- <code class="property">'transform-origin'</code> property don't affect the rendering and are treated
- as if zero was specified. The translation on the <code class="property">'transform'</code> property is in
+ '<code class="property">transform-origin</code>' property don't affect the rendering and are treated
+ as if zero was specified. The translation on the '<code class="property">transform</code>' property is in
absolute coordinates and translate the coordinate system by 50 pixel in each direction.
</p>
</div>
- <h3 id="transform-attribute-dom">SVG DOM interface for the 'transform' attribute</h3>
+ <h3 id="transform-attribute-dom">SVG DOM interface for the '<code class="property">transform</code>' attribute</h3>
<p>
The SVG specification defines the
- <a href="http://www.w3.org/TR/2011/REC-SVG11-20110816/coords.html#InterfaceSVGAnimatedTransformList">SVGAnimatedTransformList</a>
+ '<a href="http://www.w3.org/TR/2011/REC-SVG11-20110816/coords.html#InterfaceSVGAnimatedTransformList"><code class="property">SVGAnimatedTransformList</code></a>'
interface in SVG DOM to access the animated and the base value of the SVG transform attribute. To ensure backwards compatibility,
this API must still be supported by user agents.
</p>
<p>
- The <code class="property">'transform'</code> property contributes to the CSS cascade. According to SVG 1.1 user agents conceptually insert a
+ The '<code class="property">transform</code>' property contributes to the CSS cascade. According to SVG 1.1 user agents conceptually insert a
<a href="http://www.w3.org/TR/SVG/styling.html#UsingPresentationAttributes">new author
style sheet</a> for presentation attributes, which is the first in the author style sheet collection.
- <code>baseVal</code> gives the author the possibility to access and modify the values of the SVG 'transform' attribute.
- To provide the necessary backward compatibility to SVG DOM, <code>baseVal</code> must reflect the values of this author style sheet.
- All modifications to SVG DOM objects of <code>baseVal</code> must affect this author style sheet immediately.
+ '<code class="property">baseVal</code>' gives the author the possibility to access and modify the values of the SVG '<code class="property">transform</code>' attribute.
+ To provide the necessary backward compatibility to SVG DOM, '<code class="property">baseVal</code>' must reflect the values of this author style sheet.
+ All modifications to SVG DOM objects of '<code class="property">baseVal</code>' must affect this author style sheet immediately.
</p>
<p>
- <code>animVal</code> represents the computed style of the <code class="property">'transform'</code> property. Therefore it includes all applied
+ '<code class="property">animVal</code>' represents the computed style of the '<code class="property">transform</code>' property. Therefore it includes all applied
<a href="http://www.w3.org/TR/css3-transitions/">CSS3 Transitions</a>, <a href="http://www.w3.org/TR/css3-animations/">CSS3
Animations</a> or <a href="#svg-animation">SVG Animations</a> if any of those are underway. The computed style and SVG DOM
- objects of <code>animVal</code> can not be modified.
+ objects of '<code class="property">animVal</code>' can not be modified.
</p>
<p>
- The attribute <a href="http://www.w3.org/TR/SVG/coords.html#__svg__SVGTransform__type">'type'</a> of
- <a href="http://www.w3.org/TR/SVG/coords.html#InterfaceSVGTransform">SVGTransform</a>
- must return <a href="http://www.w3.org/TR/SVG/coords.html#__svg__SVGTransform__SVG_TRANSFORM_UNKNOWN">
- <code>SVG_TRANSFORM_UNKNOWN</code></a> for <a href="#transformation-functions">Transformation Functions</a> or unit types that
+ The attribute '<a href="http://www.w3.org/TR/SVG/coords.html#__svg__SVGTransform__type"><code class="property">type</code></a>' of
+ <a href="http://www.w3.org/TR/SVG/coords.html#InterfaceSVGTransform">'SVGTransform'</a>
+ must return '<a href="http://www.w3.org/TR/SVG/coords.html#__svg__SVGTransform__SVG_TRANSFORM_UNKNOWN">
+ <code class="css">SVG_TRANSFORM_UNKNOWN</code></a>' for <a href="#transformation-functions">Transformation Functions</a> or unit types that
are not supported by this interface. It might still be possible to get the
- <a href="http://www.w3.org/TR/SVG/coords.html#InterfaceSVGMatrix">SVGMatrix</a> by the attribute
- <a href="http://www.w3.org/TR/SVG/coords.html#__svg__SVGTransform__matrix">'matrix'</a>.
+ '<a href="http://www.w3.org/TR/SVG/coords.html#InterfaceSVGMatrix"><code class="property">SVGMatrix</code></a>' by the attribute
+ '<a href="http://www.w3.org/TR/SVG/coords.html#__svg__SVGTransform__matrix"><code class="property">matrix</code></a>'.
</p>
<h3 id="svg-animation">SVG Animation</h3>
@@ -924,10 +966,10 @@
<h4 id="svg-animate-element">The SVG 'animate' and 'set' element</h4>
<p>
- The SVG 1.1 specification did not define animations of the 'transform' attribute for the SVG
+ The SVG 1.1 specification did not define animations of the '<code class="property">transform</code>' attribute for the SVG
<a href="http://www.w3.org/TR/SVG/animate.html#AnimateElement">'animate'</a> element or the SVG
<a href="http://www.w3.org/TR/SVG/animate.html#SetElement">'set'</a> element.
- This specification explicitly allows the animation of the presentation attributes 'transform', 'gradientTransform' and 'patternTransform'
+ This specification explicitly allows the animation of the presentation attributes '<code class="property">transform</code>', 'gradientTransform' and 'patternTransform'
for the 'animate' and 'set' elements. SVG animation must run the same animation steps as described in section
<a href="#animation">Transitions and Animations between Transform Values</a>.
</p>
@@ -937,7 +979,7 @@
<p>
<a href="http://www.w3.org/TR/SVG/animate.html">SVG 1.1 Animation</a> defines the <a href="http://www.w3.org/TR/SVG/animate.html#TargetAttributes">'attributeName'</a> attribute to specify the
name of the target attribute. For the presentation attributes 'gradientTransform' and 'patternTransform' it will also be possible to use
- the value 'transform'. The same presentation attribute style will get animated.
+ the value '<code class="property">transform</code>'. The same presentation attribute style will get animated.
</p>
<div class="example">
@@ -953,7 +995,7 @@
</linearGradient></pre>
<p>The 'linearGradient' element specifies the 'gradientTransform' presentation attribute. The two 'animate' elements address the target attribute
- 'gradientTransform' and 'transform'. Even so all animations apply to the same gradient transformation by taking the value of the 'gradientTransform'
+ 'gradientTransform' and '<code class="property">transform</code>'. Even so all animations apply to the same gradient transformation by taking the value of the 'gradientTransform'
presentation attribute, applying the scaling of the first animation and applying the translation of the second animation one after the other.</p>
</div>
@@ -961,26 +1003,26 @@
<p>
<a href="http://www.w3.org/TR/SVG/animate.html">SVG 1.1 Animation</a> defines the <a href="http://www.w3.org/TR/SVG/animate.html#TargetAttributes">'attributeType'</a> attribute to specify the
- namespace in which the target attribute and its associated values are defined. The attribute can have the values <code>CSS</code>, <code>XML</code> or
- <code>auto</code>, where <code>auto</code> is the default value.
+ namespace in which the target attribute and its associated values are defined. The attribute can have the values '<code class="css">CSS</code>', '<code class="css">XML</code>' or
+ '<code class="css">auto</code>', where '<code class="css">auto</code>' is the default value.
</p>
<p>
- However, in the combination with the 'transform', 'patternTransform' and 'gradientTransform' presentation attributes, 'attributeType'
- can just be used to indicate the syntax rules used for the transform attribute values. A value of <code>CSS</code> indicates that the transform values should
- be parsed according to the CSS syntax. A value of <code>XML</code> indicates that the transform values should be parsed according to the
- <a href="#svg-syntax">SVG 'transform' syntax</a>.
+ However, in the combination with the '<code class="property">transform</code>', 'patternTransform' and 'gradientTransform' presentation attributes, 'attributeType'
+ can just be used to indicate the syntax rules used for the transform attribute values. A value of '<code class="css">CSS</code>' indicates that the transform values should
+ be parsed according to the CSS syntax. A value of '<code class="css">XML</code>' indicates that the transform values should be parsed according to the
+ SVG '<code class="property">transform</code>' <a href="#svg-syntax">syntax</a>.
</p>
<p>
- User agents are recommended to use the more tolerant <a href="#svg-syntax">SVG 'transform' syntax</a> for a value of <code>auto</code> to parse transform values.
+ User agents are recommended to use the more tolerant SVG '<code class="property">transform</code>' <a href="#svg-syntax">syntax</a> for a value of '<code class="css">auto</code>' to parse transform values.
</p>
<h4 id="svg-animateTransform-extension">The SVG 'animateTransform' element</h4>
<p>
This specification introduces new transform functions that are not supported by <a href="http://www.w3.org/TR/SVG/animate.html">SVG 1.1 Animation</a>. The
- SVG <a href="http://www.w3.org/TR/SVG/animate.html#AnimateTransformElement">'type'</a> attribute gets extended by all
+ SVG '<a href="http://www.w3.org/TR/SVG/animate.html#AnimateTransformElement"><code class="property">type</code></a>' attribute gets extended by all
transform functions listed in <a href="#two-d-transform-functions">2D Transformation Functions</a>,
<a href="#three-d-transform-functions">3D Transformation Functions</a> and <a href="#svg-transformation-functions">SVG
Transformation Functions</a>.
@@ -989,7 +1031,7 @@
<!-- ======================================================================================================= -->
<h2 id="transform-origin-property">
- The <code class="property">'transform-origin'</code> Property
+ The '<code class="property">transform-origin</code>' Property
</h2>
<table class="propdef">
<tbody>
@@ -1063,8 +1105,8 @@
</table>
<p>
- The values of the <code class="property">'transform'</code> and
- <code class="property">'transform-origin'</code> properties are used to compute the
+ The values of the '<code class="property">transform</code>' and
+ '<code class="property">transform-origin</code>' properties are used to compute the
<a href="#TermTransformationMatrix"><i>transformation matrix</i></a>, as described above.
</p>
@@ -1104,7 +1146,7 @@
<!-- ======================================================================================================= -->
<h2 id="transform-style-property">
- The <code class="property">'transform-style'</code> Property
+ The '<code class="property">transform-style</code>' Property
</h2>
<table class="propdef">
<tbody>
@@ -1176,18 +1218,18 @@
</table>
<p>
- A value of <code class="css">preserve-3d</code> for <code class="property">transform-style</code>
+ A value of '<code class="css">preserve-3d</code>' for '<code class="property">transform-style</code>'
establishes a stacking context.
</p>
<p>
The following CSS property values require the user agent to create a flattened representation of
the descendant elements before they can be applied, and therefore override the behavior of
- <code class="property">transform-style</code>: <code class="css">preserve-3d</code>:
+ '<code class="property">transform-style</code>': '<code class="css">preserve-3d</code>':
<ul>
- <li><code class="property">overflow</code>: any value other than 'visible'.</li>
- <li><code class="property">opacity</code>: any value other than 1.</li>
- <li><code class="property">filter</code>: any value other than 'none'.</li>
+ <li>'<code class="property">overflow</code>': any value other than '<code class="property">visible</code>'.</li>
+ <li>'<code class="property">opacity</code>': any value other than 1.</li>
+ <li>'<code class="property">filter</code>': any value other than '<code class="property">none</code>'.</li>
<!-- Others? -->
</ul>
</p>
@@ -1195,15 +1237,15 @@
<p class="desc">Should this affect the computed value of transform-style?</p>
</div>
<p>
- The values of the <code class="property">'transform'</code> and
- <code class="property">'transform-origin'</code> properties are used to compute the
+ The values of the '<code class="property">transform</code>' and
+ '<code class="property">transform-origin</code>' properties are used to compute the
<a href="#TermTransformationMatrix"><i>transformation matrix</i></a>, as described above.
</p>
<!-- ======================================================================================================= -->
<h2 id="perspective-property">
- The <code class="property">'perspective'</code> Property
+ The '<code class="property">perspective</code>' Property
</h2>
<table class="propdef">
<tbody>
@@ -1275,26 +1317,26 @@
</table>
<p>
- If the value is <code class="css">'none'</code>, less than or equal to 0 no
+ If the value is '<code class="css">none</code>', less than or equal to 0 no
perspective transform is applied.
</p>
<p>
- The use of this property with any value other than 'none' establishes a
+ The use of this property with any value other than '<code class="css">none</code>' establishes a
stacking context. It also establishes a containing block (somewhat
- similar to position:relative), just like the 'transform' property does.
+ similar to '<code class="css">position: relative</code>'), just like the '<code class="property">transform</code>' property does.
</p>
<p>
- The values of the <code class="property">perspective</code> and <code class="property">perspective-origin</code>
+ The values of the '<code class="property">perspective</code>' and '<code class="property">perspective-origin</code>'
properties are used to compute the <a href="#TermPerspectiveMatrix"><i>perspective matrix</i></a>, as described above.
</p>
<!-- ======================================================================================================= -->
<h2 id="perspective-origin-property">
- The <code class="property">'perspective-origin'</code> Property
+ The '<code class="property">perspective-origin</code>' Property
</h2>
<p>
- The <code class="property">'perspective-origin'</code> property
+ The '<code class="property">perspective-origin</code>' property
establishes the origin for the <em>perspective</em> property. It
effectively sets the X and Y position at which the viewer appears to be
looking at the children of the element.
@@ -1370,17 +1412,17 @@
</tbody>
</table>
<p>
- The values of the <code class="property">perspective</code> and <code class="property">perspective-origin</code>
+ The values of the '<code class="property">perspective</code>' and '<code class="property">perspective-origin</code>'
properties are used to compute the <a href="#TermPerspectiveMatrix"><i>perspective matrix</i></a>, as described above.
</p>
<!-- ======================================================================================================= -->
<h2 id="backface-visibility-property">
- The <code class="property">'backface-visibility'</code> Property
+ The '<code class="property">backface-visibility</code>' Property
</h2>
<p>
- The <code class="property">'backface-visibility'</code> property
+ The '<code class="property">backface-visibility</code>' property
determines whether or not the "back" side of a transformed element is
visible when facing the viewer. With an identity transform, the front
side of an element faces the viewer. Applying a rotation about Y of 180
@@ -1465,7 +1507,7 @@
</tbody>
</table>
<p>
- The visibility of an element with <code class="css">backface-visibility: hidden</code> is determined
+ The visibility of an element with '<code class="css">backface-visibility: hidden</code>' is determined
as follows:
<ol>
<li>Compute a matrix representing the accumulated transform from the viewport, taking the translations
@@ -1490,13 +1532,13 @@
</h2>
<p>
The value of the <code class="property">transform</code> property is a
- list of <transform-functions> applied in the order provided. The
+ list of <var><transform-functions></var> applied in the order provided. The
individual transform functions are separated by whitespace. The
set of allowed transform functions is given below. In this list the
- type <translation-value> is defined as a <length> or
- <percentage> value, and the <angle> type is defined by <a
+ type <var><translation-value></var> is defined as a <var><length></var> or
+ <var><percentage></var> value, and the <var><angle></var> type is defined by <a
href="http://www.w3.org/TR/css3-values/">CSS Values and Units Module.</a>
- Wherever <angle> is used in this specification, a <number> that is equal to
+ Wherever <var><angle></var> is used in this specification, a <var><number></var> that is equal to
zero is also allowed, which is treated the same as an angle of zero degrees.
</p>
@@ -1550,8 +1592,8 @@
</dt>
<dd>
specifies a <a href="#RotateDefined">2D rotation</a> by the angle specified in the parameter about the origin of the element, as
- defined by the <em>transform-origin</em> property. For example, rotate(90deg) would cause elements to appear rotated one-quarter
- of a turn in the clockwise direction.
+ defined by the '<code class="property">transform-origin</code>' property. For example, '<code class="css">rotate(90deg)</code>'
+ would cause elements to appear rotated one-quarter of a turn in the clockwise direction.
</dd>
<dt>
<code class="css">skew(<angle>[, <angle>])</code>
@@ -1946,7 +1988,7 @@
<p>
After interpolation the resulting values are used to position the element. One way to use these values
is to recompose them into a 4x4 matrix. This can be done using the transform functions of the
- <em>transform</em> property. This can be done by the following pseudo code. The
+ 'transform' property. This can be done by the following pseudo code. The
values passed in are the output of the Unmatrix function above:
</p>
<pre>
Index: ChangeLog
===================================================================
RCS file: /sources/public/csswg/css3-transforms/ChangeLog,v
retrieving revision 1.21
retrieving revision 1.22
diff -u -d -r1.21 -r1.22
--- ChangeLog 26 Feb 2012 05:45:35 -0000 1.21
+++ ChangeLog 26 Feb 2012 17:32:29 -0000 1.22
@@ -1,4 +1,8 @@
2012-02-25 dschulze@adobe.com
+ Cleanup style of document to match CSS3 background and CSS3 images.
+ Fixed typos.
+
+2012-02-25 dschulze@adobe.com
Cleanup SVG related texts, corrected typos.
Added description of SVG DOM changes according to resolutions of SVG WG.
Received on Sunday, 26 February 2012 17:32:37 UTC