Skip to content

Commit bd05a18

Browse files
dirkschulzesvgeesus
dirkschulze
authored and
svgeesus
committed
Prepare a new CR document
1 parent 836ecd1 commit bd05a18

4 files changed

Lines changed: 164 additions & 24 deletions

File tree

‎css-masking-1/CR.html‎

Lines changed: 26 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -2,8 +2,10 @@
22
<meta content="text/html; charset=utf-8" http-equiv=Content-Type>
33
<title>CSS Masking Module Level 1</title>
44
<link href=../default.css rel=stylesheet type=text/css>
5+
<link href=../csslogo.ico rel="shortcut icon" type=image/x-icon>
56
<link href=https://www.w3.org/StyleSheets/TR/W3C-CR rel=stylesheet type=text/css>
67

8+
<script defer src=//test.csswg.org/harness/annotate.js#css-masking-1_dev type=text/javascript></script>
79
<style type=text/css>
810
a[data-link-type=element]::before,span[data-link-type=element]::before {
911
content: '<';
@@ -57,26 +59,26 @@
5759
</p>
5860
<h1 class="p-name no-ref" id=title>CSS Masking Module Level 1</h1>
5961
<h2 class="no-num no-toc no-ref heading settled heading" id=subtitle><span class=content>W3C Candidate Recommendation,
60-
<span class=dt-updated><span class=value-title title=20140701>1 July 2014</span></span></span></h2>
62+
<span class=dt-updated><span class=value-title title=20140717>17 July 2014</span></span></span></h2>
6163
<div data-fill-with=spec-metadata><dl>
64+
<dt>This version:
65+
<dd><a class=u-url href=http://www.w3.org/TR/2014/CR-css-masking-1-20140717/>http://www.w3.org/TR/2014/CR-css-masking-1-20140717/</a>
66+
<dt>Latest version:
67+
<dd><a href=http://www.w3.org/TR/css-masking-1/>http://www.w3.org/TR/css-masking-1/</a>
68+
<dt>Editor’s Draft:
69+
<dd><a href=http://dev.w3.org/fxtf/css-masking-1/>http://dev.w3.org/fxtf/css-masking-1/</a>
70+
<dt>Previous Versions:
71+
<dd><dd><a href=http://www.w3.org/TR/2014/WD-css-masking-1-20140213/ rel=previous>http://www.w3.org/TR/2014/WD-css-masking-1-20140213/</a>
6272
<dt>Feedback:
6373
<dd><a href="mailto:public-fx@w3.org?subject=%5Bcss-masking%5D%20feedback">public-fx@w3.org</a>
6474
with subject line
6575
“<kbd>[css-masking] <var>… message topic …</var></kbd>”(<a href=http://lists.w3.org/Archives/Public/public-fx/ rel=discussion>archives</a>)
66-
<dt>Editor’s Draft:
67-
<dd><a href=http://dev.w3.org/fxtf/css-masking-1/>http://dev.w3.org/fxtf/css-masking-1/</a>
6876
<dt>Test Suite:
6977
<dd><a href=http://test.csswg.org/suites/css-masking/nightly-unstable/>http://test.csswg.org/suites/css-masking/nightly-unstable/</a>
7078
<dt>Editors:
7179
<dd><dd class="p-author h-card vcard"><a class="p-name fn u-email email" href=mailto:dschulze@adobe.com>Dirk Schulze</a> (<span class="p-org org">Adobe Systems Inc.</span>)
7280
<dd><dd class="p-author h-card vcard"><a class="p-name fn u-email email" href=mailto:bbirtles@mozilla.com>Brian Birtles</a> (<span class="p-org org">Mozilla Japan</span>)
7381
<dd><dd class="p-author h-card vcard"><a class="p-name fn u-url url" href=http://www.xanthir.com/contact/>Tab Atkins Jr.</a> (<span class="p-org org">Google</span>)
74-
<dt>Previous Versions:
75-
<dd><dd><a href=http://www.w3.org/TR/2014/WD-css-masking-1-20140213/ rel=previous>http://www.w3.org/TR/2014/WD-css-masking-1-20140213/</a>
76-
<dt>Latest version:
77-
<dd><a href=http://www.w3.org/TR/css-masking-1/>http://www.w3.org/TR/css-masking-1/</a>
78-
<dt>This version:
79-
<dd><a class=u-url href=http://www.w3.org/TR/2014/CR-css-masking-1-20140701/>http://www.w3.org/TR/2014/CR-css-masking-1-20140701/</a>
8082
</dl>
8183
</div>
8284
<div data-fill-with=warning></div>
@@ -86,10 +88,15 @@ <h2 class="no-num no-toc no-ref heading settled heading" id=subtitle><span class
8688
</div>
8789

8890
<h2 class="no-num no-toc no-ref heading settled heading" id=abstract><span class=content>Abstract</span></h2>
89-
<p class=p-summary data-fill-with=abstract>CSS Masking provides two means for partially or fully hiding portions of visual elements: masking and clipping.</p>
91+
<p class=p-summary data-fill-with=abstract><p>CSS Masking provides two means for partially or fully hiding portions of visual elements: masking and clipping.</p>
92+
93+
94+
95+
<p>Masking describes how to use another graphical element or image as a luminance or alpha mask. Typically, rendering an element via CSS or SVG can conceptually described as if the element, including its children, are drawn into a buffer and then that buffer is composited into the element’s parent. Luminance and alpha masks influence the transparency of this buffer before the compositing stage.</p>
96+
97+
9098

91-
<p>Masking describes how to use another graphical element or image as a luminance or alpha mask. Typically, rendering an element via CSS or SVG can conceptually described as if the element, including its children, are drawn into a buffer and then that buffer is composited into the element’s parent. Luminance and alpha masks influence the transparency of this buffer before the compositing stage.
92-
<p>Clipping describes the visible region of visual elements. The region can be described by using certain SVG graphics elements or basic shapes. Anything outside of this region is not rendered.
99+
<p>Clipping describes the visible region of visual elements. The region can be described by using certain SVG graphics elements or basic shapes. Anything outside of this region is not rendered.</p>
93100

94101
<a href=http://www.w3.org/TR/CSS/>CSS</a> is a language for describing the rendering of structured documents
95102
(such as HTML and XML)
@@ -142,7 +149,7 @@ <h2 class="no-num no-toc no-ref heading settled heading" id=status><span class=c
142149
<p>
143150
A test suite and implementation report for CSS Masking Module Level 1 will be developed during
144151
the Candidate Recommendation phase, which will last a minimum of six months,
145-
and at least until 1 January 2015.
152+
and at least until 17 January 2015.
146153
See the section <a href=#cr-exit-criteria>“CR
147154
exit criteria”</a> for more details.</div>
148155
<div data-fill-with=at-risk></div>
@@ -333,7 +340,7 @@ <h2 class="heading settled heading" data-level=5 id=clipping-paths><span class=s
333340
<div class=example>
334341
<p>Consider a shape that is clipped by a clipping path applied to an ancestor:</p>
335342

336-
<pre><code>&lt;g clip-path="circle()"&gt;
343+
<pre><code class=html>&lt;g clip-path="circle()"&gt;
337344
&lt;path id="shape" d="M0,0 L10,10, L 20,0 z"/&gt;
338345
&lt;/g&gt;</code></pre>
339346

@@ -400,24 +407,23 @@ <h3 class="heading settled heading" data-level=5.1 id=the-clip-path><span class=
400407
<p>If the URI reference is not valid (e.g it points to an object that doesn’t exist or the object is not a <a data-link-type=element href=#elementdef-clippath title=clippath>clipPath</a> element), no clipping is applied.</p>
401408

402409
<div class=example>
403-
<p></p>
410+
<p>This example demonstrates the use of the basic shape <a class="production css-code" data-link-type=function href=http://www.w3.org/TR/css-shapes-1/#funcdef-polygon title=polygon()>&lt;polygon()&gt;</a> as clipping path. Each space separated length pair represents one point of the polygon. The visualized clipping path can be seen in the <a href=#clipping>introduction</a>.</p>
404411
<pre><code class=css>clip-path: polygon(15px 99px, 30px 87px, 65px 99px, 85px 55px,
405412
122px 57px, 184px 73px, 198px 105px, 199px 150px,
406413
145px 159px, 155px 139px, 126px 120px, 112px 138px,
407414
80px 128px, 39px 126px, 24px 104px);</code></pre>
408415
</div>
409416

410417
<div class=example>
411-
<p></p>
418+
<p>In this example, the <a class=property data-link-type=propdesc href=#propdef-clip-path title=clip-path>clip-path</a> property references an SVG <a data-link-type=element href=#elementdef-clippath title=clippath>clipPath</a> element. Each comma separated length pair represents one point of the polygon. As for the previous example, the visualized clipping path can be seen in the <a href=#clipping>introduction</a>.</p>
412419
<pre><code class=css>clip-path: url("#clip1");</code></pre>
413420

414-
<pre><code class=html>&lt;svg&gt;
421+
<pre><code class=html>
415422
&lt;clipPath id="clip1"&gt;
416-
&lt;path d="15,99 30,87 65,99 85,55 122,57 184,73 198,105
423+
&lt;polygon points="15,99 30,87 65,99 85,55 122,57 184,73 198,105
417424
199,150 145,159 155,139 126,120 112,138 80,128 39,126
418425
24,104"/&gt;
419-
&lt;/clipPath&gt;
420-
&lt;/svg&gt;</code></pre>
426+
&lt;/clipPath&gt;</code></pre>
421427
</div>
422428

423429
<h2 class="heading settled heading" data-level=6 id=svg-clipping-paths><span class=secno>6 </span><span class=content>SVG Clipping Path Sources</span><a class=self-link href=#svg-clipping-paths></a></h2>

‎css-masking-1/Overview.html‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -59,7 +59,7 @@
5959
</p>
6060
<h1 class="p-name no-ref" id=title>CSS Masking Module Level 1</h1>
6161
<h2 class="no-num no-toc no-ref heading settled heading" id=subtitle><span class=content>Editor’s Draft,
62-
<span class=dt-updated><span class=value-title title=20140710>10 July 2014</span></span></span></h2>
62+
<span class=dt-updated><span class=value-title title=20140712>12 July 2014</span></span></span></h2>
6363
<div data-fill-with=spec-metadata><dl>
6464
<dt>This version:
6565
<dd><a class=u-url href=http://dev.w3.org/fxtf/css-masking-1/>http://dev.w3.org/fxtf/css-masking-1/</a>
@@ -319,7 +319,7 @@ <h2 class="heading settled heading" data-level=5 id=clipping-paths><span class=s
319319
<div class=example>
320320
<p>Consider a shape that is clipped by a clipping path applied to an ancestor:</p>
321321

322-
<pre><code>&lt;g clip-path="circle()"&gt;
322+
<pre><code class=html>&lt;g clip-path="circle()"&gt;
323323
&lt;path id="shape" d="M0,0 L10,10, L 20,0 z"/&gt;
324324
&lt;/g&gt;</code></pre>
325325

‎css-masking-1/Overview.src.html‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
<h1>CSS Masking Module Level 1</h1>
22
<pre class='metadata'>
33
Status: ED
4-
Deadline: 2014-02-13
4+
Deadline: 2015-01-17
55
ED: http://dev.w3.org/fxtf/css-masking-1/
66
TR: http://www.w3.org/TR/css-masking-1/
77
Previous Version: http://www.w3.org/TR/2014/WD-css-masking-1-20140213/
@@ -178,7 +178,7 @@ <h2 id="clipping-paths">Clipping Paths</h2>
178178
<div class=example>
179179
<p>Consider a shape that is clipped by a clipping path applied to an ancestor:</p>
180180

181-
<pre><code>&lt;g clip-path="circle()">
181+
<pre><code class=html>&lt;g clip-path="circle()">
182182
&lt;path id="shape" d="M0,0 L10,10, L 20,0 z"/>
183183
&lt;/g></code></pre>
184184

‎css-masking-1/issuegen.pl‎

Lines changed: 134 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,134 @@
1+
#!/usr/bin/perl
2+
3+
# Color coding
4+
# Note statuses will get lowercased before lookup
5+
%statusStyle = (
6+
'accepted' => 'a',
7+
'retracted' => 'a',
8+
'rejected' => 'r',
9+
'objection' => 'fo',
10+
'deferred' => 'd',
11+
'invalid' => 'oi',
12+
'outofscope' => 'oi',
13+
);
14+
# Header template is at the end of the file
15+
16+
################################################################################
17+
18+
my $inFile = $ARGV[0];
19+
if (!$inFile) {
20+
print "\nPass in issues list filename for processing!\n\n";
21+
print "~~~~~~~~~~~~~~~~~~~~~ Template for issues-list.txt ~~~~~~~~~~~~~~~~~~~~~\n";
22+
print <<XXX;
23+
24+
Draft: http://www.w3.org/TR/2013/WD-css-text-decor-3-20130103/
25+
Title: CSS Text Decoration Level 3
26+
... anything else you want here, except 4 dashes ...
27+
28+
----
29+
Issue 1.
30+
Summary: [summary]
31+
From: [name]
32+
Comment: [url]
33+
Response: [url]
34+
Closed: [status ... or replace this "Closed" line with "Open"]
35+
Verified: [url]
36+
----
37+
XXX
38+
exit;
39+
}
40+
41+
# Input/Output setup
42+
my $outFile = $inFile;
43+
$outFile =~ s/\.txt/\.html/;
44+
open IN, "<", $inFile || die "Cannot open $inFile: $!";
45+
open OUT, ">", $outFile || die "Cannot open $outFile: $!";
46+
$/ = "----\n";
47+
48+
# Header
49+
&header;
50+
51+
# Issues
52+
while (<IN>) {
53+
chomp;
54+
55+
# Issue number
56+
s/Issue (\d+)\./Issue \1. <a href="#issue-\1">#<\/a>/;
57+
$index = $1;
58+
59+
# Color coding
60+
$code = '';
61+
if (/\nVerified:\s+http/) {
62+
$code = 'a';
63+
}
64+
elsif (/\n(?:Closed|Open):\s+(\S+)/) {
65+
$code = $statusStyle{lc $1};
66+
}
67+
if (/\nOpen/) {
68+
$code .= ' ' if $code;
69+
$code .= 'open';
70+
}
71+
72+
# And print it
73+
print OUT "<pre class='$code' id='issue-$index'>\n";
74+
s/(http\S+)/<a href="\1">\1<\/a>/g;
75+
print OUT;
76+
print OUT "</pre>\n";
77+
}
78+
79+
sub header {
80+
# Read header
81+
local $_ = <IN>;
82+
chomp;
83+
84+
# Extract title and URL
85+
my $title, $url;
86+
for (split /\n+/) {
87+
$title = $1 if (/^Title:\s+(.+)$/);
88+
$url = $1 if (/^Draft:\s+(\S+)/);
89+
}
90+
die "Error: missing document URL or title.\n" unless ($url && $title);
91+
92+
# Process URL to get status, date, shorname
93+
die "Error: Draft URL wrong format.\n" unless
94+
($url =~ /([A-Z]{2})-([a-z0-9-]+)-(\d{8})/);
95+
($status, $shortname, $date) = ($1, $2, $3);
96+
$status = 'LCWD' if ('WD' eq $status && $inFile =~ /[lL][cC]/);
97+
$date = "$1-$2-$3" if ($date =~ /(\d{4})(\d{2})(\d{2})/);
98+
99+
# Print it all out
100+
print OUT <<XXX;
101+
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN">
102+
<title>$title Disposition of Comments for $date $status</title>
103+
<style type="text/css">
104+
.a { background: lightgreen }
105+
.d { background: lightblue }
106+
.r { background: orange }
107+
.fo { background: red }
108+
.open { border: solid red; padding: 0.2em; }
109+
:target { box-shadow: 0.25em 0.25em 0.25em; }
110+
</style>
111+
112+
<h1>$title Disposition of Comments for $date $status</h1>
113+
114+
<p>Last call document: <a href="$url">$url</a>
115+
116+
<p>Editor's draft: <a href="http://dev.w3.org/fxtf/$shortname/">http://dev.w3.org/fxtf/$shortname/</a>
117+
118+
<p>The following color coding convention is used for comments:</p>
119+
120+
<ul>
121+
<li class="a">Accepted or Rejected and positive response
122+
<li class="r">Rejected and no response
123+
<li class="fo">Rejected and negative response
124+
<li class="d">Deferred
125+
<li class="oi">Out-of-Scope or Invalid and not verified
126+
</ul>
127+
128+
<p class=open>Open issues are marked like this</p>
129+
130+
<p>An issue can be closed as <code>Accepted</code>, <code>OutOfScope</code>,
131+
<code>Invalid</code>, <code>Rejected</code>, or <code>Retracted</code>.
132+
<code>Verified</code> indicates commentor's acceptance of the response.</p>
133+
XXX
134+
}

0 commit comments

Comments
 (0)