Editorial tweaks to image-orientation. Note that EXIF data is ignored in CSS. Add issue about whether that's true for printers; if so we'll need an 'auto' value and they'll need a different default stylesheet.

Author: fantasai

css3-images/Overview.html

@@ -2154,21 +2154,27 @@ <h3 id=image-orientation><span class=secno>6.2. </span> Orienting an Image
    on the Page: the &lsquo;<a href="#image-orientation0"><code
    class=property>image-orientation</code></a>&rsquo; property</h3>
 
-  <p>Images from camera phones, digital cameras or scanners may be encoded
-   sideways. For example, the first row of image data may represent the
-   leftmost or rightmost column of image pixels. Furthermore, often such
+  <p>Sometimes images from camera phones, digital cameras or scanners are
+   encoded sideways. For example, the first row of image data can represent
+   the leftmost or rightmost column of image pixels. Furthermore, often such
    devices have limited resources, and do not have the capability to rotate
    the image into an upright orientation. However, this type of device may
    have internal knowledge or can accept input from its user as to the
-   rotational correction to perform.
-
-  <p>The image-orientation property provides a way to specify an
-   "out-of-band" rotation to be applied to image source data. This facility
-   is not intended to specify layout transformations such as arbitrary
-   rotation or flipping the image in the horizontal or vertical direction. It
-   is not needed to correctly orient an image when printing in landscape
-   versus portrait orientation, as that rotation is done as part of layout.
-   It should only be used to correct incorrectly-oriented images.
+   rotational correction to perform. The &lsquo;<a
+   href="#image-orientation0"><code
+   class=property>image-orientation</code></a>&rsquo; property provides a way
+   to specify an "out-of-band" rotation to be applied to image source data to
+   correctly orient an image.
+
+  <p class=note>Note this facility is not intended to specify layout
+   transformations such as arbitrary rotation or flipping the image in the
+   horizontal or vertical direction. (See <a href="#CSS3-2D-TRANSFORMS"
+   rel=biblioentry>[CSS3-2D-TRANSFORMS]<!--{{CSS3-2D-TRANSFORMS}}--></a> for
+   a feature designed to do that.) It is also not needed to correctly orient
+   an image when printing in landscape versus portrait orientation, as that
+   rotation is done as part of layout. (See <a href="#CSS3PAGE"
+   rel=biblioentry>[CSS3PAGE]<!--{{CSS3PAGE}}--></a>.) It should only be used
+   to correct incorrectly-oriented images.
 
   <table class=propdef>
    <thead>
@@ -2209,15 +2215,13 @@ <h3 id=image-orientation><span class=secno>6.2. </span> Orienting an Image
      <td>specified value, rounded and normalized (see text)
   </table>
 
-  <p>&lsquo;<a href="#image-orientation0"><code
-   class=property>image-orientation</code></a>&rsquo; specifies an orthogonal
-   rotation to be applied to an image before it is laid out. CSS layout
-   processing applies to the image <em>after</em> rotation. This implies, for
-   example:
+  <p>This property specifies an orthogonal rotation to be applied to an image
+   before it is laid out. CSS layout processing applies to the image
+   <em>after</em> rotation. This implies, for example:
 
   <ul>
    <li>The intrinsic height and width are derived from the rotated rather
-    than the original image dimensions;
+    than the original image dimensions.
 
    <li>The height (width) property applies to the vertical (horizontal)
     dimension of the image, <em>after</em> rotation.
@@ -2510,6 +2514,16 @@ <h3 class=no-num id=other-references>Other references</h3>
     </dd>
    <!---->
 
+   <dt id=CSS3-2D-TRANSFORMS>[CSS3-2D-TRANSFORMS]
+
+   <dd>Dean Jackson; David Hyatt; Chris Marrin. <a
+    href="http://www.w3.org/TR/2009/WD-css3-2d-transforms-20091201"><cite>CSS
+    2D Transforms Module Level 3.</cite></a> 1 December 2009. W3C Working
+    Draft. (Work in progress.) URL: <a
+    href="http://www.w3.org/TR/2009/WD-css3-2d-transforms-20091201">http://www.w3.org/TR/2009/WD-css3-2d-transforms-20091201</a>
+    </dd>
+   <!---->
+
    <dt id=CSS3COLOR>[CSS3COLOR]
 
    <dd>Tantek &#199;elik; Chris Lilley; L. David Baron. <a
@@ -2519,6 +2533,16 @@ <h3 class=no-num id=other-references>Other references</h3>
     </dd>
    <!---->
 
+   <dt id=CSS3PAGE>[CSS3PAGE]
+
+   <dd>H&#229;kon Wium Lie; Melinda Grant. <a
+    href="http://www.w3.org/TR/2006/WD-css3-page-20061010"><cite>CSS3 Module:
+    Paged Media.</cite></a> 10 October 2006. W3C Working Draft. (Work in
+    progress.) URL: <a
+    href="http://www.w3.org/TR/2006/WD-css3-page-20061010">http://www.w3.org/TR/2006/WD-css3-page-20061010</a>
+    </dd>
+   <!---->
+
    <dt id=SMIL10>[SMIL10]
 
    <dd>Philipp Hoschka. <a

css3-images/Overview.src.html

@@ -1437,20 +1437,25 @@ <h3 id="image-resolution">
 <h3 id="image-orientation">
 Orienting an Image on the Page: the 'image-orientation' property</h3>
 
-	<p>Images from camera phones, digital cameras or scanners may be encoded sideways.
-	For example, the first row of image data may represent the leftmost or
+	<p>Sometimes images from camera phones, digital cameras or scanners are
+	encoded sideways.
+	For example, the first row of image data can represent the leftmost or
 	rightmost column of image pixels. Furthermore, often such devices have limited
 	resources, and do not have the capability to rotate the image into an upright
 	orientation. However, this type of device may have internal knowledge or can
-	accept input from its user as to the rotational correction to perform.</p>
-
-	<p>The image-orientation property provides a way to specify an "out-of-band"
-	rotation to be applied to image source data. This facility is not intended to
-	specify layout transformations such as arbitrary rotation or flipping the image
-	in the horizontal or vertical direction. It is not needed to correctly orient
-	an image when printing in landscape versus portrait orientation, as that
-	rotation is done as part of layout. It should only be used to correct
-	incorrectly-oriented images.</p>
+	accept input from its user as to the rotational correction to perform.
+	The 'image-orientation' property provides a way to apply an
+	&rdquo;out-of-band&ldquo; rotation to image source data to correctly orient
+	an image.
+
+	<p class="note">Note this facility is not intended to specify layout
+	transformations such as arbitrary rotation or flipping the image in the
+	horizontal or vertical direction. (See [[CSS3-2D-TRANSFORMS]] for a feature
+	designed to do that.)
+	It is also not needed to correctly orient an image when printing in landscape
+	versus portrait orientation, as that rotation is done as part of layout.
+	(See [[CSS3PAGE]].)
+	It should only be used to correct incorrectly-oriented images.</p>
 
 	<table class="propdef">
 		<thead>
@@ -1478,13 +1483,13 @@ <h3 id="image-orientation">
 				<td>specified value, rounded and normalized (see text)
 	</table>
 
-	<p>'image-orientation' specifies an orthogonal rotation to be applied to an image
+	<p>This property specifies an orthogonal rotation to be applied to an image
 	before it is laid out. CSS layout processing applies to the image <em>after</em>
 	rotation. This implies, for example:</p>
 
 	<ul>
 		<li>The intrinsic height and width are derived from the rotated rather than the
-		original image dimensions;</li>
+		original image dimensions.</li>
 
 		<li>The height (width) property applies to the vertical (horizontal) dimension
 		of the image, <em>after</em> rotation.</li>
@@ -1497,6 +1502,10 @@ <h3 id="image-orientation">
 	(that is, 45deg is rounded  to 90deg, while -45deg is rounded to -90deg), then
 	moduloing the value by 1 turn (360deg, 400grad, etc.).</p>
 
+	<p class="note">Note that in CSS, orientation data encoded in the image
+	(e.g. EXIF data) is ignored. <span class="issue">Is this an issue? What
+	do printers do?</span>
+
 	<div class="example">
 		<p>The following example rotates the image 90 degrees clockwise:</p>