Skip to content

Commit abb46e0

Browse files
committed
Update with plans for new stuff.
1 parent bd27f85 commit abb46e0

1 file changed

Lines changed: 11 additions & 166 deletions

File tree

css4-images/Overview.src.html

Lines changed: 11 additions & 166 deletions
Original file line numberDiff line numberDiff line change
@@ -110,8 +110,15 @@ <h3 id="values">
110110
keyword as their property value. For readability it has not been repeated
111111
explicitly.</p>
112112

113-
<h2>
114-
Stuff I'm Pulling From Images 3</h2>
113+
<h2>Planned Features</h2>
114+
115+
<ol>
116+
<li>Logical keywords for specifying linear gradient direction.</li>
117+
118+
<li>Conical gradients</li>
119+
</ol>
120+
121+
<h2>Stuff I'm Pulling From Images 3</h2>
115122

116123

117124

@@ -120,6 +127,8 @@ <h2>
120127
<h3 id="image-notation">
121128
Image Annotations and Fallbacks: the ''image()'' notation</h3>
122129

130+
<p class=issue>I've put the bare image() function with fallback functionality only back into Images 3. The resolution and direction keywords are still intended to show up here in Images 4.</p>
131+
123132
<p>The ''image()'' notation allows an author to tag an image with a few types
124133
of useful processing instructions which can affect the rendering of the image
125134
and to declare fallback images to be used if the original image can't be
@@ -238,171 +247,7 @@ <h3 id='cross-fade-function'>
238247

239248
<!-- ====================================================================== -->
240249

241-
<h2 id="image-processing">
242-
Image Processing</h2>
243-
244-
<h3 id="image-resolution">
245-
Overriding Image Resolutions: the 'image-resolution' property</h3>
246-
247-
<p>The <i>image resolution</i> is defined as the number of image
248-
pixels per unit length, e.g., pixels per inch. Some image formats can
249-
record information about the resolution of images. This information
250-
can be helpful when determining the actual size of the image in the
251-
formatting process. However, the information can also be wrong, in
252-
which case it should be ignored. By default, CSS assumes a resolution
253-
of one image pixel per CSS ''px'' unit; however, the 'image-resolution'
254-
property allows using some other resolution.
255-
256-
<table class="propdef">
257-
<tr>
258-
<th>Name:
259-
<td><dfn>image-resolution</dfn>
260-
<tr>
261-
<th>Value:
262-
<td>from-image || &lt;resolution>
263-
<tr>
264-
<th>Initial:
265-
<td>1dppx
266-
<tr>
267-
<th>Applies to:
268-
<td>all elements
269-
<tr>
270-
<th>Inherited:
271-
<td>yes
272-
<tr>
273-
<th>Media:
274-
<td>visual
275-
<tr>
276-
<th>Computed value:
277-
<td>specified value
278-
</table>
279-
280-
<p>The 'image-resolution' property specifies the resolution of all images used
281-
in or on the element: images in content (e.g. replaced elements and generated
282-
content), background images, list markers, etc. Values have the following
283-
meanings:</p>
284-
285-
<dl>
286-
<dt>&lt;resolution></dt>
287-
<dd>The value sets the resolution of the image. In combination with
288-
''from-image'', the specified resolution is only used if the image
289-
does not have a resolution.</dd>
290-
291-
<dt>from-image</dt>
292-
<dd>The UA must look for the resolution in the image itself. If the
293-
image does not have a resolution, the specified &lt;resolution>
294-
value is used, or ''1dppx'' if none is given.</dd>
295-
</dl>
296-
297-
<p>This property must have no effect on vector images, as vector images
298-
do not have a concept of "resolution".</p>
299-
300-
<p class='note'>Note that for all images other than the contents of replaced
301-
elements, the ''image()'' function may be used to override the resolution set
302-
here.</p>
303-
304-
<div class="example">
305-
<p>This rule specifies that the UA should use the image resolution
306-
found in the image itself, falling back to 1 image pixel per CSS
307-
''px'' unit.</p>
308-
309-
<pre class=css>img { image-resolution: from-image }</pre>
310-
</div>
311250

312-
<div class="example">
313-
<p>Using this rule, the image resolution is set to 300dpi and the
314-
resolution in the image, if any, is ignored.</p>
315-
316-
<pre>img { image-resolution: 300dpi }</pre>
317-
</div>
318-
319-
320-
<div class="example">
321-
<p>These rules both specify that the UA should use the image resolution
322-
found in the image itself. If the image has no resolution, the
323-
resolution is set to 300dpi.</p>
324-
325-
<pre>
326-
img { image-resolution: from-image 300dpi }
327-
img { image-resolution: 300dpi from-image }
328-
</pre>
329-
</div>
330-
331-
<!-- ====================================================================== -->
332-
333-
<h3 id="image-orientation">
334-
Orienting an Image on the Page: the 'image-orientation' property</h3>
335-
336-
<p>Images from camera phones, digital cameras or scanners may be encoded sideways.
337-
For example, the first row of image data may represent the leftmost or
338-
rightmost column of image pixels. Furthermore, often such devices have limited
339-
resources, and do not have the capability to rotate the image into an upright
340-
orientation. However, this type of device may have internal knowledge or can
341-
accept input from its user as to the rotational correction to perform.</p>
342-
343-
<p>The image-orientation property provides a way to specify an "out-of-band"
344-
rotation to be applied to image source data. This facility is not intended to
345-
specify layout transformations such as arbitrary rotation or flipping the image
346-
in the horizontal or vertical direction. It is not needed to correctly orient
347-
an image when printing in landscape versus portrait orientation, as that
348-
rotation is done as part of layout. It should only be used to correct
349-
incorrectly-oriented images.</p>
350-
351-
<table class="propdef">
352-
<tr>
353-
<th>Name:
354-
<td><dfn>image-orientation</dfn>
355-
<tr>
356-
<th>Value:
357-
<td>&lt;angle>
358-
<tr>
359-
<th>Initial:
360-
<td>0deg
361-
<tr>
362-
<th>Applies to:
363-
<td>images
364-
<tr>
365-
<th>Inherited:
366-
<td>no
367-
<tr>
368-
<th>Media:
369-
<td>visual
370-
<tr>
371-
<th>Computed value:
372-
<td>specified value, rounded and normalized (see text)
373-
</table>
374-
375-
<p>'image-orientation' specifies an orthogonal rotation to be applied to an image
376-
before it is laid out. CSS layout processing applies to the image <em>after</em>
377-
rotation. This implies, for example:</p>
378-
379-
<ul>
380-
<li>The intrinsic height and width are derived from the rotated rather than the
381-
original image dimensions;</li>
382-
383-
<li>The height (width) property applies to the vertical (horizontal) dimension
384-
of the image, <em>after</em> rotation.</li>
385-
</ul>
386-
387-
<p>Positive values cause the image to be rotated to the right (in a clockwise
388-
direction), while negative values cause a rotation to the left. The computed
389-
value of the property is calculated by rounding the specified angle to the
390-
nearest quarter-turn (90deg, 100grad, .25turn, etc.), rounding away from 0
391-
(that is, 45deg is rounded to 90deg, while -45deg is rounded to -90deg), then
392-
moduloing the value by 1 turn (360deg, 400grad, etc.).</p>
393-
394-
<div class="example">
395-
<p>The following example rotates the image 90 degrees clockwise:</p>
396-
397-
<pre>
398-
img.ninety { image-orientation: 90deg }
399-
...
400-
&lt;img class="ninety" src=... />
401-
</pre>
402-
403-
<p>The same effect could be achieved with, for example, an angle of -270deg
404-
or 450deg.</p>
405-
</div>
406251

407252
<!-- ====================================================================== -->
408253

0 commit comments

Comments
 (0)