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 25904 - Add example with 4 points that form an irregular rect.
Summary: Add example with 4 points that form an irregular rect.
Status: RESOLVED FIXED
Alias: None
Product: FXTF
Classification: Unclassified
Component: Geometry (show other bugs)
Version: unspecified
Hardware: PC All
: P2 normal
Target Milestone: ---
Assignee: Simon Pieters
QA Contact: sideshowbarker+geometry
URL:
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2014-05-28 07:40 UTC by Dirk Schulze
Modified: 2014-06-05 09:47 UTC (History)
1 user (show)

See Also:


Attachments

Description Dirk Schulze 2014-05-28 07:40:01 UTC
http://dev.w3.org/fxtf/geometry/#DOMQuad

We should add an example of 4 dompoints that define a quad and the bounding rect. An irregular rect would be preferred.
Comment 1 Dirk Schulze 2014-05-28 07:42:50 UTC
[[
[Constructor(DOMPointInit p1, DOMPointInit p2,
             DOMPointInit p3, DOMPointInit p4
]]

The example should have one graphics as well.
Comment 2 Dirk Schulze 2014-05-28 19:40:21 UTC
Added an example.
Comment 3 Simon Pieters 2014-06-02 06:19:54 UTC
This is how the example reads in plain text:

[[
This is an example of an irregular quadrilateral:

new DOMQuad({x: 40, y: 25}, {x: 180, y: 8}, {x: 210, y: 150}, {x: 10, y: 180});

Graphical representation of a DOMQuad with 4 points and associated bounding rectangle

An irregular quadrilateral represented by a DOMQuad. The four red colored circles represent the DOMPoint attributes p1 to p4. The dashed rectangle represents the associated bounding rectangle bounds of the DOMQuad.
]]

I'm not sure this is particularly helpful for someone who can't see the image. How would you explain the example without using an image?
Comment 4 Dirk Schulze 2014-06-02 14:42:55 UTC
(In reply to Simon Pieters from comment #3)
> This is how the example reads in plain text:
> 
> [[
> This is an example of an irregular quadrilateral:
> 
> new DOMQuad({x: 40, y: 25}, {x: 180, y: 8}, {x: 210, y: 150}, {x: 10, y:
> 180});
> 
> Graphical representation of a DOMQuad with 4 points and associated bounding
> rectangle
> 
> An irregular quadrilateral represented by a DOMQuad. The four red colored
> circles represent the DOMPoint attributes p1 to p4. The dashed rectangle
> represents the associated bounding rectangle bounds of the DOMQuad.
> ]]
> 
> I'm not sure this is particularly helpful for someone who can't see the
> image. How would you explain the example without using an image?

Any suggestion how you think we should change it?
Comment 5 Simon Pieters 2014-06-03 09:07:38 UTC
How about replacing

> Graphical representation of a DOMQuad with 4 points and associated bounding
> rectangle

with:

A completely asymmetric quadrilateral with none of the sides being vertical or horizontal, and its four corners are marked with red circles. Around this shape is a dashed rectangle with vertical and horizontal sides that tangents the quadrilateral.
Comment 6 Simon Pieters 2014-06-03 09:09:31 UTC
s/tangents/tangent/
Comment 7 Dirk Schulze 2014-06-03 12:28:06 UTC
Ok, used your phrases with small changes:

""
An irregular quadrilateral with none of the sides being vertical or horizontal. Its four corners are marked with red circles. Around this quadrilateral is a dashed rectangle that represents the associated bounding rectangle. All sides of this rectangle are vertical or horizontal and tangent the quadrilateral.
""
Comment 8 Simon Pieters 2014-06-03 12:35:39 UTC
LGTM
Comment 9 Simon Pieters 2014-06-03 12:38:00 UTC
...actually I would remove " that represents the associated bounding rectangle" since the caption says and the image doesn't.
Comment 10 Dirk Schulze 2014-06-05 09:47:15 UTC
(In reply to Simon Pieters from comment #9)
> ...actually I would remove " that represents the associated bounding
> rectangle" since the caption says and the image doesn't.

Done.