Add a virtual beamforming audio device on ChromeOS.

media/audio/point.h

+// Copyright 2015 The Chromium Authors. All rights reserved.
+// Use of this source code is governed by a BSD-style license that can be
+// found in the LICENSE file.
+
+#ifndef MEDIA_AUDIO_MIC_POSITIONS_H_

[DaleCurtis, 2015/09/03 01:58:37]

Header tag is not correct. Is it worth reusing ui/gfx/geometry/point3_f.h
instead?

[ajm, 2015/09/03 04:19:29]

It appears to do everything we need except for the IsValid method. I added that
because it seemed to be desirable for IPC; if it's required we can always add a
non-member function to handle it.

Not sure what kind of checkdeps problems we're going to run into, but I can give
it a whirl.

[Henrik Grunell, 2015/09/03 07:14:20]

If we can't use an existing point class, maybe a bug for consolidating point
classes/structs in Chromium as a whole? Obviously shouldn't be done in this
large CL.

[ajm, 2015/09/09 01:01:29]

gfx::Point3F works fine. I added a typedef below, which makes it easy to swap in
a different point implementation that conforms to the same interface.

On the other hand, it could make it harder to search for uses of gfx::Point3F. I
can replace all media::Points with gfx::Point3Fs if you prefer.

+#define MEDIA_AUDIO_MIC_POSITIONS_H_
+
+#include <cmath>
+#include <string>
+#include <vector>
+
+#include "media/base/media_export.h"
+
+namespace media {
+
+// Represents a 3D point using Cartesian coordinates in meters.
+class MEDIA_EXPORT Point final {
+ public:
+  Point();
+  Point(float x, float y, float z);
+
+  float x() const { return x_; }
+  float y() const { return y_; }
+  float z() const { return z_; }
+
+  // Checks that all coordinates are finite (not infinite or NaN).
+  bool IsValid() const;
+
+  // Returns a human-readable string of the coordinates.
+  std::string ToString() const;
+
+  Point(const Point&) = default;
+  Point& operator=(const Point&) = default;
+
+  bool operator==(const Point& rhs) const {
+    return x_ == rhs.x_ && y_ == rhs.y_ && z_ == rhs.z_;
+  }
+
+  bool operator!=(const Point& rhs) const { return !(*this == rhs); }
+
+ private:
+  float x_;
+  float y_;
+  float z_;
+};
+
+// Returns a vector of points parsed from a whitespace-separated string
+// formatted
+// as: "x1 y1 z1 ... zn yn zn" for n points.
+//
+// Returns an empty vector if |points_string| is empty or isn't parseable.
+MEDIA_EXPORT std::vector<Point> ParsePointsFromString(
+    const std::string& points_string);
+
+}  // namespace media
+
+#endif  // MEDIA_AUDIO_MIC_POSITIONS_H_