Began adding loading and saving image files to image_surface. Could only find normative references for PNG and JPEG. No function descriptions yet. Going to rename rgba_color to bgra_color since that matches the byte order on little-endian systems and since the proper name on big-endian systems would be argb. While rgba is a known term, it doesn't reflect modern data organization. Using bgra is a better reflection of modern realities, and swizzling can always be used internally if needed.

Author: mikebmcl

source/image-surface.tex

@@ -1,6 +1,17 @@
 %!TEX root = io2d.tex
 \rSec0 [imagesurface] {Class \tcode{image_surface}}
 
+\rSec1 [imagesurface.summary] {\tcode{image_surface} summary}
+
+\pnum
+\indexlibrary{\idxcode{image_surface}}
+The class \tcode{image_surface} derives from the \tcode{surface} class and provides an interface to a raster graphics data graphics resource.
+
+\pnum
+\enternote
+Because of the functionality it provides and what it can be used for, it is expected that developers familiar with other graphics technologies will think of the \tcode{image_surface} class as being a form of \term{render target}. This is intentional, though this \documenttypename{} does not formally define or use that term to avoid any minor ambiguities and differences in its meaning between the various graphics technologies that do use the term render target.
+\exitnote
+
 \rSec1 [imagesurface.synopsis] {\tcode{image_surface} synopsis}
 
 \begin{codeblock}
@@ -9,24 +20,11 @@
   public:
     // \ref{imagesurface.cons}, construct/copy/move/destroy:
     image_surface() = delete;
-    image_surface(const image_surface&) = delete;
-    image_surface& operator=(const image_surface&) = delete;
-    image_surface(image_surface&& other) noexcept;
-    image_surface& operator=(image_surface&& other) noexcept;
     image_surface(experimental::io2d::format fmt, int width, int height);
-    image_surface(experimental::io2d::format fmt, int width, int height, 
-      error_code& ec) noexcept;
-    image_surface(vector<unsigned char>& data, experimental::io2d::format fmt,
-      int width, int height);
-    image_surface(vector<unsigned char>& data, experimental::io2d::format fmt,
-      int width, int height, error_code& ec) noexcept;
-    virtual ~image_surface();
+    image_surface(filesystem::path f, experimental::io2d::format fmt);
 
-    // \ref{imagesurface.modifiers}, modifiers:
-    void data(const vector<unsigned char>& data);
-    void data(const vector<unsigned char>& data, error_code& ec) noexcept;
-    vector<unsigned char> data();
-    vector<unsigned char> data(error_code& ec) noexcept;
+    // \ref{imagesurface.members}, members:
+    void save(filesystem::path p);
 
     // \ref{imagesurface.observers}, observers:
     experimental::io2d::format format() const noexcept;
@@ -37,17 +35,6 @@
 } } } }
 \end{codeblock}
 
-\rSec1 [imagesurface.intro] {\tcode{image_surface} Description}
-
-\pnum
-\indexlibrary{\idxcode{image_surface}}
-The class \tcode{image_surface} derives from the \tcode{surface} class and provides an interface to a raster graphics data graphics resource.
-
-\pnum
-\enternote
-Because of the functionality it provides and what it can be used for, it is expected that developers familiar with other graphics technologies will think of the \tcode{image_surface} class as being a form of \term{render target}. This is intentional, though this \documenttypename{} does not formally define or use that term to avoid any minor ambiguities and differences in its meaning between the various graphics technologies that do use it.
-\exitnote
-
 \rSec1 [imagesurface.cons] {\tcode{image_surface} constructors and assignment operators}
 
 \indexlibrary{\idxcode{image_surface}!constructor}

source/normative-references.tex

@@ -15,6 +15,8 @@
 \item ISO/IEC 10646-1:1993, \doccite{Information technology --- Universal 
 Multiple-Octet Coded Character Set (UCS) --- Part 1: Architecture and Basic 
 Multilingual Plane}
+\item ISO/IEC 10918-1, \doccite{Information technology -- Digital compression and coding of continuous-tone still images: Requirements and guidelines}
+\item ISO/IEC 15948 \doccite{Information technology -- Computer graphics and image processing -- Portable Network Graphics (PNG) Functional specification}
 \item ISO/IEC TR 19769:2004, \doccite{Information technology --- Programming 
 languages, their environments and system software interfaces --- Extensions for 
 the programming language C to support new character data types}
@@ -30,6 +32,12 @@
 Keio)
 \end{itemize}
 
+\pnum
+The compressed image data format described in ISO/IEC 10918-1 is hereinafter called the \indexdefn{format!JPEG}\term{JPEG format}.
+
+\pnum
+The datastream and associated file format described in ISO/IEC 15948 is hereinafter called the \indexdefn{format!PNG}\term{PNG format}.
+
 \pnum
 The library described in ISO/IEC TR 19769:2004 is hereinafter called the
 \indexdefn{C!Unicode TR}\term{C Unicode TR}.