Renamed extend to tiling since there was a lot of confusion over what extend meant and if it was a typo for, e.g. extent.

Author: mikebmcl

source/brush.tex

@@ -23,18 +23,18 @@
     brush(surface_brush_factory& f, error_code& ec) noexcept;
 
     // \ref{brush.modifiers}, modifiers:
-    void extend(experimental::io2d::extend e) noexcept;
+    void tiling(experimental::io2d::tiling e) noexcept;
     void filter(experimental::io2d::filter f) noexcept;
     void matrix(const matrix_2d& m) noexcept;
 
     // \ref{brush.observers}, observers:
-    experimental::io2d::extend extend() const noexcept;
+    experimental::io2d::tiling tiling() const noexcept;
     experimental::io2d::filter filter() const noexcept;
     matrix_2d matrix() const noexcept;
     brush_type type() const noexcept;
 
   private:
-    experimental::io2d::extend _Extend; // \expos
+    experimental::io2d::tiling _Tiling; // \expos
     experimental::io2d::filter _Filter; // \expos
     matrix_2d _Matrix;                         // \expos
     brush_type _Brush_type;                    // \expos
@@ -55,7 +55,7 @@
 A \tcode{brush} object's graphics data is immutable. It is observable only by the effect that it produces when the brush is used as a Source Brush (\ref{surface.sourcebrush}) or as a Mask Brush (\ref{surface.rendering} and \ref{surface.masking}).
 
 \pnum
-A \tcode{brush} object also has mutable \tcode{extend}, \tcode{filter}, and \tcode{matrix_2d} observable state data values.
+A \tcode{brush} object also has mutable \tcode{tiling}, \tcode{filter}, and \tcode{matrix_2d} observable state data values.
 
 \pnum
 A \tcode{brush} object has an immutable \tcode{brush_type} observable state data value which indicates the type of brush factory that was used in creating the \tcode{brush} object (Table~\ref{tab:brushtype.meanings}).
@@ -82,22 +82,22 @@
 \rSec2 [brush.sampling.solidcolor] {Sampling from a solid color brush}
 
 \pnum
-When \tcode{b} is a solid color brush, then when sampling from \tcode{b}, the visual data returned shall always be the visual data equivalent to the result of calling \tcode{solid_color_brush_factory::color} on the \tcode{solid_color_brush_factory} from which \tcode{b} was created, regardless of the point which is to be sampled and regardless of the return values of \tcode{b.extend()}, \tcode{b.filter()}, and \tcode{b.matrix()}.
+When \tcode{b} is a solid color brush, then when sampling from \tcode{b}, the visual data returned shall always be the visual data equivalent to the result of calling \tcode{solid_color_brush_factory::color} on the \tcode{solid_color_brush_factory} from which \tcode{b} was created, regardless of the point which is to be sampled and regardless of the return values of \tcode{b.tiling()}, \tcode{b.filter()}, and \tcode{b.matrix()}.
 
 \rSec2 [brush.sampling.linear] {Sampling from a linear gradient brush}
 
 \pnum
-When \tcode{b} is a linear gradient brush, then when sampling from \tcode{b}, the visual data returned shall be from the point \tcode{pt} in the rendered linear gradient, where \tcode{pt} is the return value when passing the point to be sampled to \tcode{b.matrix().transform_coords} and the rendered linear gradient is created as specified by \ref{gradients.linear} and \ref{gradients.sampling}, taking into account the value of \tcode{b.extend()} and \tcode{b.filter()}.
+When \tcode{b} is a linear gradient brush, then when sampling from \tcode{b}, the visual data returned shall be from the point \tcode{pt} in the rendered linear gradient, where \tcode{pt} is the return value when passing the point to be sampled to \tcode{b.matrix().transform_coords} and the rendered linear gradient is created as specified by \ref{gradients.linear} and \ref{gradients.sampling}, taking into account the value of \tcode{b.tiling()} and \tcode{b.filter()}.
 
 \rSec2 [brush.sampling.radial] {Sampling from a radial gradient brush}
 
 \pnum
-When \tcode{b} is a radial gradient brush, then when sampling from \tcode{b}, the visual data returned shall be from the point \tcode{pt} in the rendered radial gradient, where \tcode{pt} is the return value when passing the point to be sampled to \tcode{b.matrix().transform_coords} and the rendered radial gradient is created as specified by \ref{gradients.radial} and \ref{gradients.sampling}, taking into account the value of \tcode{b.extend()} and \tcode{b.filter()}.
+When \tcode{b} is a radial gradient brush, then when sampling from \tcode{b}, the visual data returned shall be from the point \tcode{pt} in the rendered radial gradient, where \tcode{pt} is the return value when passing the point to be sampled to \tcode{b.matrix().transform_coords} and the rendered radial gradient is created as specified by \ref{gradients.radial} and \ref{gradients.sampling}, taking into account the value of \tcode{b.tiling()} and \tcode{b.filter()}.
 
 \rSec2 [brush.sampling.surface] {Sampling from a surface brush}
 
 \pnum
-When \tcode{b} is a surface brush, then when sampling from \tcode{b}, the visual data returned shall be from the point \tcode{pt} in the graphics data of the brush, where \tcode{pt} is the return value when passing the point to be sampled to \tcode{b.matrix().transform_coords}, taking into account the value of \tcode{b.extend()} and \tcode{b.filter()}.
+When \tcode{b} is a surface brush, then when sampling from \tcode{b}, the visual data returned shall be from the point \tcode{pt} in the graphics data of the brush, where \tcode{pt} is the return value when passing the point to be sampled to \tcode{b.matrix().transform_coords}, taking into account the value of \tcode{b.tiling()} and \tcode{b.filter()}.
 
 \rSec1 [brush.cons] {\tcode{brush} constructors and assignment operators}
 
@@ -118,7 +118,7 @@
 \postconditions
 \tcode{_Brush_type == brush_type::solid_color}.
 
-\tcode{_Extend == std::experimental::io2d::extend::none}.
+\tcode{_Tiling == std::experimental::io2d::tiling::none}.
 
 \tcode{_Filter == std::experimental::io2d::filter::fast}.
 
@@ -152,11 +152,11 @@
 \postconditions
 \tcode{_Brush_type == brush_type::linear}.
 
-\tcode{_Extend == std::experimental::io2d::extend::none}.
+\tcode{_Tiling == std::experimental::io2d::tiling::none}.
 
-\tcode{_Filter == std::experimental::io2d::extend::good}.
+\tcode{_Filter == std::experimental::io2d::tiling::good}.
 
-\tcode{_Extend == std::experimental::io2d::extend::none}.
+\tcode{_Tiling == std::experimental::io2d::tiling::none}.
 
 \pnum
 \throws
@@ -186,11 +186,11 @@
 \postconditions
 \tcode{_Brush_type == brush_type::radial}.
 
-\tcode{_Extend == std::experimental::io2d::extend::none}.
+\tcode{_Tiling == std::experimental::io2d::tiling::none}.
 
-\tcode{_Filter == std::experimental::io2d::extend::good}.
+\tcode{_Filter == std::experimental::io2d::tiling::good}.
 
-\tcode{_Extend == std::experimental::io2d::extend::none}.
+\tcode{_Tiling == std::experimental::io2d::tiling::none}.
 
 \pnum
 \throws
@@ -217,11 +217,11 @@
 %\postconditions
 %\tcode{_Brush_type == brush_type::mesh}.
 %
-%\tcode{_Extend == std::experimental::io2d::extend::none}.
+%\tcode{_Tiling == std::experimental::io2d::tiling::none}.
 %
-%\tcode{_Filter == std::experimental::io2d::extend::good}.
+%\tcode{_Filter == std::experimental::io2d::tiling::good}.
 %
-%\tcode{_Extend == std::experimental::io2d::extend::none}.
+%\tcode{_Tiling == std::experimental::io2d::tiling::none}.
 %
 %\pnum
 %\throws
@@ -251,11 +251,11 @@
 \postconditions
 \tcode{_Brush_type == brush_type::surface}.
 
-\tcode{_Extend == std::experimental::io2d::extend::none}.
+\tcode{_Tiling == std::experimental::io2d::tiling::none}.
 
-\tcode{_Filter == std::experimental::io2d::extend::good}.
+\tcode{_Filter == std::experimental::io2d::tiling::good}.
 
-\tcode{_Extend == std::experimental::io2d::extend::none}.
+\tcode{_Tiling == std::experimental::io2d::tiling::none}.
 
 \pnum
 \throws
@@ -270,19 +270,19 @@
 
 \rSec1 [brush.modifiers]{\tcode{brush} modifiers}
 
-\indexlibrary{\idxcode{brush}!\idxcode{extend}}
-\indexlibrary{\idxcode{extend}!\idxcode{brush}}
+\indexlibrary{\idxcode{brush}!\idxcode{tiling}}
+\indexlibrary{\idxcode{tiling}!\idxcode{brush}}
 \begin{itemdecl}
-void extend(experimental::io2d::extend e) noexcept;
+void tiling(experimental::io2d::tiling e) noexcept;
 \end{itemdecl}
 \begin{itemdescr}
 \pnum
 \effects
-Sets the \tcode{extend} value for the \tcode{brush} object.
+Sets the \tcode{tiling} value for the \tcode{brush} object.
 
 \pnum
 \postconditions
-\tcode{_Extend == e}.
+\tcode{_Tiling == e}.
 \end{itemdescr}
 
 \indexlibrary{\idxcode{brush}!\idxcode{filter}}
@@ -317,15 +317,15 @@
 
 \rSec1 [brush.observers]{\tcode{brush} observers}
 
-\indexlibrary{\idxcode{brush}!\idxcode{extend}}
-\indexlibrary{\idxcode{extend}!\idxcode{brush}}
+\indexlibrary{\idxcode{brush}!\idxcode{tiling}}
+\indexlibrary{\idxcode{tiling}!\idxcode{brush}}
 \begin{itemdecl}
-experimental::io2d::extend extend() const noexcept;
+experimental::io2d::tiling tiling() const noexcept;
 \end{itemdecl}
 \begin{itemdescr}
 \pnum
 \returns
-\tcode{_Extend}.
+\tcode{_Tiling}.
 \end{itemdescr}
 
 \indexlibrary{\idxcode{brush}!\idxcode{filter}}

source/brushes.tex

@@ -6,7 +6,7 @@
 Brushes serve as sources of visual data for composing operations.
 
 \pnum
-A brush has its own mutable coordinate space (by default the standard coordinate space). It also posses a mutable \tcode{extend} value and a mutable \tcode{filter} value.
+A brush has its own mutable coordinate space (by default the standard coordinate space). It also posses a mutable \tcode{tiling} value and a mutable \tcode{filter} value.
 
 \pnum
 A brush is created using one of four factory classes:
@@ -25,7 +25,7 @@
 
 \addtocounter{SectionDepthBase}{1}
 \input{gradients}
-\input{extend}
+\input{tiling}
 \input{filter}
 \input{brush-type}
 \input{brush}

source/definitions-fonts.tex

@@ -119,8 +119,8 @@
 \definition{body size}{\iotwod.general.defns.bodysize}
 the font size, measured along the y axis of the glyph's standard coordinate system
 
-\indexdefn{extended body size}
-\definition{extended body size}{\iotwod.general.defns.extendedbodysize}
+\indexdefn{tilinged body size}
+\definition{tilinged body size}{\iotwod.general.defns.tilingedbodysize}
 a reference size with two components, measured respectively along the \xaxis and \yaxis of the glyph's standard coordinate system
 
 \indexdefn{design frame}
@@ -135,5 +135,5 @@
 %
 %\indexdefn{blackness}
 %\definition{blackness}{\iotwod.general.defns.blackness}
-%the ratio of the blackened area of a glyph image to the extended body size area of the glyph image \\
+%the ratio of the blackened area of a glyph image to the tilinged body size area of the glyph image \\
 %\lbrack SOURCE: ISO/IEC 9541-1:2012, definition 3.32 \rbrack

source/experimental-io2d.tex

@@ -22,7 +22,7 @@
   enum class line_join;
   enum class compositing_operator;
   enum class format;
-  enum class extend;
+  enum class tiling;
   enum class filter;
   enum class brush_type;
   enum class subpixel_order;

source/filter.tex

@@ -72,6 +72,6 @@
  \\
  \tcode{bilinear}
  & Bilinear interpolation filtering shall be used.
-% The distance-weighted average of the four nearest pixels is used to create an interpolated color for the destination pixel. If some source pixel values do not exist (e.g. because an edge or corner of the source has been reached) then the current \tcode{extend} should be considered in order to determine the values for the missing source pixels. If a hardware sampler is available and offers bilinear filtering, implementations may use it even if its results do not conform to those produced by the description of bilinear filtering provided by this standard.% Whether mipmapping is used and whether mipmaps are generated for sources that do not have them is \impldef{filter!bilinear mipmapping}.
+% The distance-weighted average of the four nearest pixels is used to create an interpolated color for the destination pixel. If some source pixel values do not exist (e.g. because an edge or corner of the source has been reached) then the current \tcode{tiling} should be considered in order to determine the values for the missing source pixels. If a hardware sampler is available and offers bilinear filtering, implementations may use it even if its results do not conform to those produced by the description of bilinear filtering provided by this standard.% Whether mipmapping is used and whether mipmaps are generated for sources that do not have them is \impldef{filter!bilinear mipmapping}.
  \\
 \end{libreqtab2}

source/font-extents.tex

@@ -145,7 +145,7 @@
 	This value is the distance in untransformed coordinate space units from the top of the font's bounding box to the font's baseline.
 
 	\pnum
-	Some glyphs may extend slightly above the top of the font's bounding box due to hinting or for aesthetic reasons.
+	Some glyphs may tiling slightly above the top of the font's bounding box due to hinting or for aesthetic reasons.
 
 \end{itemdescr}
 
@@ -164,7 +164,7 @@
 	This value is the distance in untransformed coordinate space units from the bottom of the font's bounding box to the font's baseline.
 
 	\pnum
-	Some glyphs may extend slightly below the bottom of the font's bounding box due to hinting or for aesthetic reasons.
+	Some glyphs may tiling slightly below the bottom of the font's bounding box due to hinting or for aesthetic reasons.
 
 	\pnum
 	\enternote

source/gradients.tex

@@ -117,10 +117,10 @@
 where $o$ is a color stop offset value.
 
 \pnum
-The range of potential values for $o$ shall be determined by the \tcode{extend} value of the \tcode{brush} object created using the radial gradient:
+The range of potential values for $o$ shall be determined by the \tcode{tiling} value of the \tcode{brush} object created using the radial gradient:
 \begin{itemize}
-\item For \tcode{extend::none}, the range of potential values for $o$ is $[0,1]$.
-\item For all other \tcode{extend} values, the range of potential values for $o$ is\\ $[$~\tcode{numeric_limits<double>::lowest(),numeric_limits<double>::max()}~$]$.
+\item For \tcode{tiling::none}, the range of potential values for $o$ is $[0,1]$.
+\item For all other \tcode{tiling} values, the range of potential values for $o$ is\\ $[$~\tcode{numeric_limits<double>::lowest(),numeric_limits<double>::max()}~$]$.
 \end{itemize}
 
 \pnum
@@ -181,20 +181,20 @@
 
 \item Where the value of $o$ is in the range $[0,1]$, its color value shall be determined by interpolating between the color stop, $r$, which is the color stop whose offset value is closest to $o$ without being less than $o$ and which can have an adjacent color stop to its left, and the color stop that is adjacent to $r$ on $r$'s left. The acceptable forms of interpolating between color values is set forth later in this section.
 
-\item Where the value of $o$ is outside the range $[0,1]$, its color value depends on the \tcode{extend} value of the brush which is created using the gradient:
+\item Where the value of $o$ is outside the range $[0,1]$, its color value depends on the \tcode{tiling} value of the brush which is created using the gradient:
 	\begin{itemize}
-	\item If the \tcode{extend} value is \tcode{extend::none}, the color value of $o$ shall be \tcode{rgba_color::transparent_black()}.
+	\item If the \tcode{tiling} value is \tcode{tiling::none}, the color value of $o$ shall be \tcode{rgba_color::transparent_black()}.
 
-	\item If the \tcode{extend} value is \tcode{extend::pad}, if $o$ is negative then the color value of $o$ shall be the same as if the value of $o$ was \tcode{0.0}, otherwise the color value of $o$ shall be the same as if the value of $o$ was \tcode{1.0}.
+	\item If the \tcode{tiling} value is \tcode{tiling::pad}, if $o$ is negative then the color value of $o$ shall be the same as if the value of $o$ was \tcode{0.0}, otherwise the color value of $o$ shall be the same as if the value of $o$ was \tcode{1.0}.
 
-	\item If the \tcode{extend} value is \tcode{extend::repeat}, then \tcode{1.0} shall be added to or subtracted from $o$ until $o$ is in the range $[0,1]$, at which point its color value is the color value for the modified value of $o$ as determined by these rules.
+	\item If the \tcode{tiling} value is \tcode{tiling::repeat}, then \tcode{1.0} shall be added to or subtracted from $o$ until $o$ is in the range $[0,1]$, at which point its color value is the color value for the modified value of $o$ as determined by these rules.
 	\enterexample
 	Given $o == 2.1$, after application of this rule $o == 0.1$ and the color value of $o$ shall be the same value as if the initial value of $o$ was $0.1$.
 
 	Given $o == -0.3$, after application of this rule $o == 0.7$ and the color value of $o$ shall be the same as if the initial value of $o$ was $0.7$.
 	\exitexample
 
-	\item If the \tcode{extend} value is \tcode{extend::reflect}, $o$ shall be set to the absolute value of $o$, then 2.0 shall be subtracted from $o$ until $o$ is in the range $[0,2]$, then if $o$ is in the range $(1,2]$ then $o$ shall be set to \tcode{1.0 - (o - 1.0)}, at which point its color value is the color value for the modified value of $o$ as determined by these rules.
+	\item If the \tcode{tiling} value is \tcode{tiling::reflect}, $o$ shall be set to the absolute value of $o$, then 2.0 shall be subtracted from $o$ until $o$ is in the range $[0,2]$, then if $o$ is in the range $(1,2]$ then $o$ shall be set to \tcode{1.0 - (o - 1.0)}, at which point its color value is the color value for the modified value of $o$ as determined by these rules.
 	\enterexample
 	Given $o == 2.8$, after application of this rule $o == 0.8$ and the color value of $o$ shall be the same value as if the initial value of $o$ was $0.8$.
 

source/io2d.tex

@@ -107,7 +107,7 @@
 %\include{line-join}
 %\include{compositing-operator}
 %\include{format}
-%\include{extend}
+%\include{tiling}
 %\include{filter}
 %\include{brush-type}
 %\include{font-slant}