diff --git a/css-shapes-1/Overview.bs b/css-shapes-1/Overview.bs index fe7cd033205c..40228c849952 100644 --- a/css-shapes-1/Overview.bs +++ b/css-shapes-1/Overview.bs @@ -340,13 +340,15 @@ Supported Shapes [ round <<'border-radius'>> ]? ) + <basic-shape-rect> = <> | <> | <> + <> = circle( - <>? + <>? [ at <> ]? ) <> = ellipse( - <>{2}? + <>? [ at <> ]? ) @@ -457,98 +459,62 @@ Supported Shapes
circle()
-
    -
  • - The shape-radius argument represents - r, the radius - of the circle. - Negative values are invalid. - A percentage value here - is resolved from the used width and height - of the reference box as
    - sqrt(width2+height2)/sqrt(2). -
  • -
  • - The <> argument defines - the center of the circle. - Unless otherwise specified, - this defaults to center if omitted. -
  • -
+ * The <> argument defines + the circle's radius. + Rather than referring to the [=gradient box=], + values are resolved against the [=/reference box=]. + + * Two <> values are invalid. + + The <> argument defines + the center of the circle. + Unless otherwise specified, + this defaults to center if omitted.
ellipse()
-
    -
  • - The shape-radius arguments represent - rx and - ry, - the x-axis and y-axis radii - of the ellipse, - in that order. - Negative values for either radius are invalid. - Percentage values here are resolved - against the used width (for the rx value) - and the used height (for the ry value) - of the reference box. -
  • -
  • - The <> argument defines - the center of the ellipse. - Unless otherwise specified, - this defaults to center if omitted. -
  • -
+ * The <> argument defines + the horizontal and vertical radiuses of the ellipse. + Rather than referring to the [=gradient box=], + values are resolved against the [=/reference box=]. + + * The <> argument defines + the center of the ellipse. + Unless otherwise specified, + this defaults to center if omitted.
polygon()
-
    -
  • - <<'fill-rule'>> - - The filling rule used - to determine the interior - of the polygon. - See fill-rule property - in SVG for details. - Possible values are ''nonzero'' - or ''evenodd''. - Default value when omitted is ''nonzero''.
  • -
  • - Each pair argument in the list represents xi and yi - - the x and y axis coordinates of the i-th vertex of the polygon. -
  • -
+ * The <<'fill-rule'>> specifies the filling rule used + to determine the interior + Defaults to ''nonzero'' if omitted. + + * Each <> pair + specifies a vertex of the polygon, + as a horizontal and vertical offset + from the left and top edges of the [=/reference box=]. The UA must close a polygon by connecting the last vertex with the first vertex of the list.
path() -
-
    -
  • - <<'fill-rule'>> - - The filling rule used - to determine the interior - of the path. - See fill-rule property - in SVG for details. - Possible values are ''nonzero'' - or ''evenodd''. - Default value when omitted is ''nonzero''. -
  • - The <> represents an - SVG Path data string. - A path data string that does not conform to the - to the grammar and parsing rules of SVG 1.1, - or that does conform but defines an empty path, - is [=invalid=] and causes the entire ''path()'' to be [=invalid=]. - The initial position is defined - by the first “move to” argument - in the path string. - For the initial direction follow SVG 1.1. -
+ * The <<'fill-rule'>> specifies the filling rule used + to determine the interior + Defaults to ''nonzero'' if omitted. + + * The <> represents an + SVG Path data string. + A path data string that does not conform to the + to the grammar and parsing rules of SVG 1.1, + or that does conform but defines an empty path, + is [=invalid=] and causes the entire ''path()'' to be [=invalid=]. + + The initial position is defined + by the first “move to” argument + in the path string. + For the initial direction follow SVG 1.1. The UA must close a path with an implicit @@ -558,44 +524,6 @@ Supported Shapes (such as 'shape-outside' and 'clip-path'). - The arguments not defined above are defined as follows: - -
-
<> = <> | closest-side | farthest-side -
- Defines a radius for a circle or ellipse. If omitted it defaults to closest-side. -
    -
  • - closest-side - uses the length from the center - of the shape to the closest side - of the reference box. - For circles, - this is the closest side - in any dimension. - For ellipses, - this is the closest side - in the radius dimension. -
  • - farthest-side - uses the length from the center - of the shape to the farthest side - of the reference box. - For circles, - this is the farthest side - in any dimension. - For ellipses, - this is the farthest side - in the radius dimension. -
-
- - Additionally, the three rectangular shape functions - are grouped into a production for convenience: - -
-	<basic-shape-rect> = <> | <> | <>
-	

Computed Values of Basic Shapes

@@ -695,8 +623,8 @@ Interpolation of Basic Shapes
  • If both shapes are the same type, that type is ''ellipse()'' or ''circle()'', - and none of the radii use - the ''closest-side'' or ''farthest-side'' keywords, + and the radiuses are specified as <> + (rather than keywords), interpolate between each value in the shape functions.