- From: SVG Working Group repository <cam+svgwgrepo@mcc.id.au>
- Date: Thu, 11 Jul 2013 10:44:45 -0700
- To: public-svg-wg@w3.org
details: https://svgwg.org/hg/svg2/rev/bc3caf5c02db
branches:
changeset: 525:bc3caf5c02db
user: Cyril Concolato <cyril.concolato@telecom-paristech.fr>
date: Thu Jul 11 19:42:31 2013 +0200
description:
adding Media Fragments Identifiers
diffstat:
master/changes.html | 6 +++++
master/linking.html | 63 ++++++++++++++++++++++++++++++++++++++++++++++++++--
master/mimereg.html | 8 ++++--
master/refs.html | 14 ++++++++++-
4 files changed, 84 insertions(+), 7 deletions(-)
diffs (242 lines):
diff --git a/master/changes.html b/master/changes.html
--- a/master/changes.html
+++ b/master/changes.html
@@ -308,10 +308,16 @@ have been made.</p>
</ul>
<h3 id="idlindex">IDL Index appendix</h3>
<ul>
<li>Added this appendix.</li>
</ul>
+<h3 id="mediafragments">Media Fragments Identifier</h3>
+
+<ul>
+ <li>Added the possibility to link to SVG resources, including with fragment identifiers defined by the Media Fragment Identifier recommandation.</li>
+</ul>
+
</body>
</html>
diff --git a/master/linking.html b/master/linking.html
--- a/master/linking.html
+++ b/master/linking.html
@@ -495,25 +495,47 @@ or frame to be replaced by the W3C home
<h2 id="LinksIntoSVG">Linking into SVG content: IRI fragments and SVG views</h2>
<p>Because SVG content often represents a picture or drawing
of something, a common need is to link into a particular
<em>view</em> of the document, where a view indicates
the initial transformations so as to present a closeup of a particular
section of the document.</p>
+<dl class="ready-for-wider-review">
<h3 id="SVGFragmentIdentifiers">SVG fragment identifiers</h3>
+<div class="annotation svg2-requirement">
+ <table>
+ <tr>
+ <th>SVG 2 Requirement:</th>
+ <td>Merge the SVG 1.1 SE text and the SVG Tiny 1.2 text on fragment identifiers link traversal and add media fragments.</td>
+ </tr>
+ <tr>
+ <th>Resolution:</th>
+ <td><a href="http://www.w3.org/2012/03/08-svg-irc#T21-05-52">SVG 2 will media fragment identifiers.</a></td>
+ </tr>
+ <tr>
+ <th>Purpose:</th>
+ <td>To align with Media Fragments URI.</td>
+ </tr>
+ <tr>
+ <th>Owner:</th>
+ <td>Cyril (<a href="http://www.w3.org/Graphics/SVG/WG/track/actions/3442">ACTION-3442</a>)</td>
+ </tr>
+ </table>
+</div>
+
<p>To link into a particular view of an SVG document, the IRI fragment
identifier needs to be a correctly formed <dfn id='svg-fragment-identifier'>SVG
fragment identifier</dfn>. An SVG fragment identifier defines the
meaning of the "selector" or "fragment identifier" portion of IRIs that
locate resources of MIME media type "image/svg+xml".</p>
-<p>An SVG fragment identifier can come in two forms:</p>
+<p>An SVG fragment identifier can come in the following forms:</p>
<ul>
<li>Shorthand <em>bare name</em> form of addressing (e.g.,
<span class="attr-value">MyDrawing.svg#MyView</span>). This form of
addressing, which allows addressing an SVG element by its ID, is compatible
with the fragment addressing mechanism for older versions of HTML.</li>
<li id="SVGViewSpecification">An <dfn>SVG view specification</dfn>
@@ -526,23 +548,31 @@ locate resources of MIME media type "ima
<span class='attr-value'>preserveAspectRatio(...)</span>,
<span class='attr-value'>transform(...)</span>,
<span class='attr-value'>zoomAndPan(...)</span> and
<span class='attr-value'>viewTarget(...)</span>, whose parameters have the
same meaning as the corresponding attributes on a <a>'view'</a> element, or,
in the case of <span class='attr-value'>transform(...)</span>, the same
meaning as the corresponding attribute has on a
<a>'g'</a> element).</li>
+
+ <li><em>Basic media fragments identifiers</em> of type spatial or temporal
+ (e.g., <span class="attr-value">MyDrawing.svg#xywh=0,200,1000,1000 or MyAnimation.svg#t=10)</span>)
+ as defined in [<a href="refs.html#ref-MEDIAFRAGMENTSURI">Media Fragments URI 1.0 (basic)</a>] and possibly combined using the & sign (e.g. <span class="attr-value">MyDrawing.svg#xywh=0,200,1000,1000&t=10</span>).
+ <p class="issue">This implies that it is not possible anymore in SVG 2.0 to define id for elements starting with 'xywh=' or 't='.</p>
+ </li>
</ul>
<p>An SVG fragment identifier is defined as follows:</p>
<pre class='grammar'>
-SVGFragmentIdentifier ::= BareName |
- SVGViewSpec
+SVGFragmentIdentifier ::= BareName *( "&" <a href="http://www.w3.org/TR/media-frags/#timesegment">timesegment</a> ) |
+ SVGViewSpec *( "&" <a href="http://www.w3.org/TR/media-frags/#timesegment">timesegment</a> ) |
+ <a href="http://www.w3.org/TR/media-frags/#spacesegment">spacesegment</a> *( "&" timesegment ) |
+ <a href="http://www.w3.org/TR/media-frags/#timesegment">timesegment</a> *( "&" spacesegment )
BareName ::= XML_Name
SVGViewSpec ::= 'svgView(' SVGViewAttributes ')'
SVGViewAttributes ::= SVGViewAttribute |
SVGViewAttribute ';' SVGViewAttributes
SVGViewAttribute ::= viewBoxSpec |
preserveAspectRatioSpec |
@@ -606,16 +636,36 @@ as follows:</p>
<ul>
<li>If no SVG fragment identifier is provided (e.g, the specified IRI did
not contain a "#" character, such as <span class="attr-value">MyDrawing.svg</span>),
then the initial view into the SVG document is established using the view
specification attributes (i.e., <a>'viewBox'</a>, etc.) on the
<a>outermost svg element</a>.</li>
+ <li>If the SVG fragment identifier addresses a <a href="http://www.w3.org/TR/media-frags/#spacesegment">space segment</a>
+ (e.g., <span class="attr-value">MyDrawing.svg#xywh=0,0,100,100</span>),then the initial
+ view into the SVG document is established using the view specification attributes
+ on the <a>outermost svg element</a> where the 'viewBox' is overriden by the
+ x, y, width and height values provided by the fragment identifier.
+ <p class="issue">Do we allow the "pixel:" or "percent:" part of the spatial
+ identifier? If yes, how do they map onto SVG user units?</p>
+ </li>
+
+ <li>If the SVG fragment identifier addresses a <a href="http://www.w3.org/TR/media-frags/#timesegment">time segment</a>
+ (e.g., <span class="attr-value">MyDrawing.svg#t=10</span>),then the initial
+ view into the SVG document is established as if no fragment identifier was
+ provided. The rendering of the SVG Document shall be as if the setCurrentTime
+ method on the SVG Document element had been called with the begin time value
+ from the fragment identifier. Additionally, if an end time value is provided
+ in the fragment identifier, the effect is equivalent to calling the pauseAnimations
+ method on the SVG Document when the document time reaches the end time of the
+ fragment identifier.
+ </li>
+
<li>If the SVG fragment identifier addresses a <a>'view'</a> element within
an SVG document (e.g., <span class="attr-value">MyDrawing.svg#MyView</span>
or <span class="attr-value">MyDrawing.svg#xpointer(id('MyView'))</span>)
then the closest ancestor <a>'svg'</a> element is displayed in the viewport.
Any view specification attributes included on the given <a>'view'</a>
element override the corresponding view specification attributes on the
closest ancestor <a>'svg'</a> element.</li>
@@ -624,17 +674,24 @@ as follows:</p>
then the document fragment defined by the closest ancestor <a>'svg'</a>
element is displayed in the viewport using the SVG view specification
provided by the SVG fragment identifier.</li>
<li>If the SVG fragment identifier addresses any element other than a
<a>'view'</a> element, then the document defined by the closest ancestor
<a>'svg'</a> element is displayed in the viewport using the view
specification attributes on that <a>'svg'</a> element.</li>
+
+ <li>If the SVG fragment identifier addresses a combination of the above
+ non-time related identifiers with a time-related identifier (ie. a timesegment),
+ the behavior of each identifier is applied.
+ </li>
+
</ul>
+</dl>
<h3 id="ViewElement">Predefined views: the <span class="element-name">'view'</span> element</h3>
<edit:with element='view'>
<p>The <span class="element-name">'view'</span> element is defined as follows:</p>
<edit:elementsummary name='view'/>
diff --git a/master/mimereg.html b/master/mimereg.html
--- a/master/mimereg.html
+++ b/master/mimereg.html
@@ -147,22 +147,24 @@ Additional information:</dt>
fourth letter).
<p>Note that the Macintosh file type code 'svgz' (all lowercase) is used as an alias for GZIP
<cite>[<a href="refs.html#ref-RFC1952">RFC1952</a>]</cite> compressed "svg ", <em>i.e.</em>
octet streams of type image/svg+xml, subsequently compressed with gzip.</p></dd>
<dt>Macintosh Universal Type Identifier code: </dt>
<dd><code>org.w3c.svg</code> conforms to <code>public.image</code> and to <code>public.xml</code></dd>
<dt>Windows Clipboard Name:</dt>
<dd>"SVG Image"</dd>
+<dl class="ready-for-wider-review">
<dt>Fragment Identifiers</dt>
<dd>For documents labeled as application/svg+xml, the fragment identifier
- notation is either Shorthand Pointers (formerly called barenames) or
- the SVG-specific <a href="linking.html#LinksIntoSVG">SVG Views</a> syntax;
- both described in the <a href="linking.html#SVGFragmentIdentifiers">fragment
+ notation is either Shorthand Pointers (formerly called barenames),
+ the SVG-specific <a href="linking.html#LinksIntoSVG">SVG Views</a> syntax or a Media Fragment Identifier;
+ all described in the <a href="linking.html#SVGFragmentIdentifiers">fragment
identifiers section of the SVG specification</a>.</dd>
+</dl>
</dl>
</dd>
<dt>
Person & email address to contact for further information:</dt>
<dd>
<p>
Chris Lilley, Doug Schepers (member-svg-media-type@w3.org).
diff --git a/master/refs.html b/master/refs.html
--- a/master/refs.html
+++ b/master/refs.html
@@ -1,9 +1,9 @@
-<?xml version="1.0" encoding="utf-8"?>
+<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional+edit//EN" "xhtml1-transitional+edit.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xmlns:edit="http://xmlns.grorg.org/SVGT12NG/">
<head>
<title>References</title>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
<link rel="stylesheet" title="Default" type="text/css" media="screen" href="style/default_svg.css"/>
<link rel="alternate stylesheet" title="No issues/annotations" type="text/css" media="screen" href="style/default_no_issues.css"/>
<!--
@@ -273,16 +273,28 @@
<dt id="ref-GML" class="normref">[GML]</dt>
<dd>
<cite><a href="http://portal.opengeospatial.org/files/?artifact_id=20509">OpenGIS Geography Markup Language (GML) Encoding Standard, version 3.2.1</a></cite>,
C. Portele, ed.
Open GIS Consortium, 27 August 2007.
<br/>Available at http://portal.opengeospatial.org/files/?artifact_id=20509.
</dd>
+<dl class="references ready-for-wider-review">
+ <dt id="ref-MEDIAFRAGMENTURI" class="normref">[MEDIAFRAGMENTSURI]</dt>
+ <dd>
+ <cite class="w3crec"><a href="http://www.w3.org/TR/2012/REC-media-frags-20120925/">Media Fragments URI 1.0 (basic)</a></cite>,
+ R. Troncy, E. Mannens, S. Pfeiffer, D. Van Deursen, eds.
+ World Wide Web Consoritum, 25 September 2012.
+ <br/>This edition of Media Fragments URI is http://www.w3.org/TR/2012/REC-media-frags-20120925/.
+ <br/>The <a href="http://www.w3.org/TR/media-frags/">latest edition of Media Fragments URI</a> is available at
+ http://www.w3.org/TR/media-frags/.
+ </dd>
+</dl>
+
<dt id="ref-PNG" class="normref">[PNG]</dt>
<dd>
<cite class="w3crec"><a href="http://www.w3.org/TR/2003/REC-PNG-20031110/">Portable Network Graphics (PNG) Specification (Second Edition)</a>:
Information technology — Computer graphics and image processing — Portable Network Graphics (PNG): Functional specification, ISO/IEC 15948:2003 (E)</cite>,
D. Duce, ed. World Wide Web Consortium, 10 November 2003.
<br/>This edition of PNG is http://www.w3.org/TR/2003/REC-PNG-20031110/.
<br/>The <a href="http://www.w3.org/TR/PNG/">latest edition of PNG</a> is available at
http://www.w3.org/TR/PNG/.
Received on Thursday, 11 July 2013 17:45:13 UTC