This is an archived snapshot of W3C's public bugzilla bug tracker, decommissioned in April 2019. Please see the home page for more details.

Bug 9942 - The sentence "The shadowBlur attribute specifies the size of the blurring effect." is misleading, It should say "The shadowBlur attribute specifies the level of the blurring effect."
Summary: The sentence "The shadowBlur attribute specifies the size of the blurring eff...
Status: CLOSED FIXED
Alias: None
Product: HTML WG
Classification: Unclassified
Component: pre-LC1 HTML Canvas 2D Context (editor: Ian Hickson) (show other bugs)
Version: unspecified
Hardware: Other other
: P3 normal
Target Milestone: ---
Assignee: Ian 'Hixie' Hickson
QA Contact: HTML WG Bugzilla archive list
URL: http://www.whatwg.org/specs/web-apps/...
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2010-06-17 09:47 UTC by contributor
Modified: 2010-12-22 12:56 UTC (History)
5 users (show)

See Also:


Attachments

Description contributor 2010-06-17 09:47:45 UTC
Section: http://www.whatwg.org/specs/web-apps/current-work/complete.html#shadows

Comment:
The sentence "The shadowBlur attribute specifies the size of the blurring
effect." is misleading, It should say "The shadowBlur attribute specifies the
level of the blurring effect."

Posted from: 83.61.74.226
Comment 1 Alejandro G.Castro 2010-06-17 09:51:22 UTC
I've submitted because the sentence could be misleading and cause the implementors to think the shadowBlur is the radius of the blur, and it fits better with the previous description in the parameters list.
Comment 2 Alejandro G.Castro 2010-08-10 12:32:27 UTC
Not sure if this is the proper place to point out this, anyway it seems interesting information. After this time I've checked the 3 specifications related with shadows and blurs:

   - SVG -> http://www.w3.org/TR/SVG/filters.html#feGaussianBlurStdDeviationAttribute
   - HTML5 canvas shadows -> http://www.whatwg.org/specs/web-apps/current-work/#shadows
   - CSS3 -> http://www.w3.org/TR/css3-background/#the-box-shadow

Considering all of them are going to be implemented in the same application (the web engines) and that probably we can consider them part of the same API, having different parameters seems confusing: some of them use the blur radius and do not recomend blur algorithm and others use the standard deviation and even recommend a way to do it.

I hope this helps :).
Comment 3 Ian 'Hixie' Hickson 2010-09-10 22:57:23 UTC
EDITOR'S RESPONSE: This is an Editor's Response to your comment. If you are satisfied with this response, please change the state of this bug to CLOSED. If you have additional information and would like the editor to reconsider, please reopen this bug. If you would like to escalate the issue to the full HTML Working Group, please add the TrackerRequest keyword to this bug, and suggest title and text for the tracker issue; or you may create a tracker issue yourself, if you are able to do so. For more details, see this document:
   http://dev.w3.org/html5/decision-policy/decision-policy.html

Status: Accepted
Change Description: see diff given below
Rationale: Concurred with reporter's comments.
Comment 4 contributor 2010-09-10 22:58:18 UTC
Checked in as WHATWG revision r5467.
Check-in comment: size is misleading
http://html5.org/tools/web-apps-tracker?from=5466&to=5467