Way too many changes to document. Key things: history.tex reflects most if not all changes from R7. The specification of the requirements for image_surface_data_type operations and output_surface_data_type operations is complete. experimental-io2d.tex reflects the API I think. Fixed some issues in graph-surf-surfstate.tex. Plenty more still to do but we've made good progress.

Author: mikebmcl

papers/P0267R8.pdf

@@ -15,7 +15,7 @@
 
 \rSec1 [\iotwod.absmatrix.synopsis] {Synopsis}
 \begin{codeblock}
-namespace std::experimemtal::io2d::v1 {
+namespace std::experimental::io2d::v1 {
   template <class GraphicsSurfaces>
   class basic_figure_items<GraphicsSurfaces>::abs_matrix {
   public:
@@ -66,10 +66,13 @@
 \end{itemdecl}
 \begin{itemdescr}
 \pnum
-\effects Equivalent to: \tcode{abs_matrix\{ basic_matrix_2d() \};} 
+\effects Constructs an \tcode{abs_matrix} object.
 
 \pnum
 \postconditions \tcode{data() == GraphicsSurfaces::paths::create_abs_matrix()}.
+
+\pnum
+\remarks The transform matrix is \tcode{basic_matrix_2d<graphics_math_type()}.
 \end{itemdescr}
 
 \indexlibrary{\idxcode{abs_matrix}!constructor}%
@@ -81,7 +84,10 @@
 \requires \tcode{m.is_invertible()} is \tcode{true}.
 
 \pnum
-\effects Constructs an object of type \tcode{abs_matrix}.
+\effects Constructs an \tcode{abs_matrix} object.
+
+\pnum
+\postconditions \tcode{data() == GraphicsSurfaces::paths::create_abs_matrix(m)}.
 
 \pnum
 \remarks The transform matrix is \tcode{m}.

source/abs-matrix.tex

@@ -5,7 +5,7 @@
 
 \pnum
 The antialias enum class specifies the type of anti-aliasing that the rendering
-system uses for rendering and composing paths. See 
+system uses for rendering paths. See 
 Table~\ref{tab:\iotwod.antialias.meanings} for the meaning of each
 \tcode{antialias} enumerator.
 
@@ -40,28 +40,18 @@
  \\ \capsep
  \endhead
  \tcode{none}
- & No anti-aliasing is performed.
+ & No anti-aliasing is performed when performing a rendering operation.
  \\ \rowsep
  \tcode{fast}
- & Some form of anti-aliasing shall be used when this option is selected, but the form used is \impldefplain{antialiasing!fast}.
- \begin{note}
- By specifying this value, the user is hinting that faster anti-aliasing is 
- preferable to better anti-aliasing.
- \end{note}
+ & Some form of anti-aliasing should be used when performing a rendering operation but performance is more important than the quality of the results. The technique used is \impldef{antialiasing!fast}.
  \\ \rowsep
  \tcode{good}
- & Some form of anti-aliasing shall be used when this option is selected, but the form used is \impldefplain{antialiasing!good}.
- \begin{note}
- By specifying this value, the user is hinting that sacrificing some performance 
- to obtain better anti-aliasing is acceptable but that performance is still a 
- concern.
- \end{note}
+ & Some form of anti-aliasing should be used when performing a rendering operation and the sacrificing some performance to obtain better anti-aliasing results than would likely be obtained from \tcode{antialias::fast} is acceptable. The technique used is \impldef{antialiasing!good}.
  \\ \rowsep
  \tcode{best}
- & Some form of anti-aliasing shall be used when this option is selected, but the form used is \impldefplain{antialiasing!best}.
+ & Some form of anti-aliasing should be used when performing a rendering operation and better anti-aliasing results than would likely be obtained from \tcode{antialias::fast} and \tcode{antialias::good} are desired even if performance degrades significantly. The technique used is \impldef{antialiasing!best}.
  \begin{note}
- By specifying this value, the user is hinting that anti-aliasing is more 
- important than performance.
+ This might commonly be chosen when a user is going to render something once and cache the results for repeated use or when a user is rendering something that does not necessarily need performance suitable for real-time computer graphics applications.
  \end{note}
  \\
 \end{libreqtab2}