Bindings: Provide helper method that auto-converts analog

[libsigrok.git] / bindings / cxx / include / libsigrokcxx / libsigrokcxx.hpp

diff --git a/bindings/cxx/include/libsigrokcxx/libsigrokcxx.hpp b/bindings/cxx/include/libsigrokcxx/libsigrokcxx.hpp
index 1db6c7dfecf0cd502ed646266fc46cc5ff62148b..b1ab7a5bd6f6e04a06607c80017e8fc0d9473f73 100644 (file)
--- a/bindings/cxx/include/libsigrokcxx/libsigrokcxx.hpp
+++ b/bindings/cxx/include/libsigrokcxx/libsigrokcxx.hpp
@@ -115,6 +115,7 @@ class SR_API PacketType;
 class SR_API Quantity;
 class SR_API Unit;
 class SR_API QuantityFlag;
+class SR_API Rational;
 class SR_API Input;
 class SR_API InputDevice;
 class SR_API Output;
@@ -232,7 +233,7 @@ private:
                        const char *name, void *cb_data) noexcept;
        static SR_PRIV int close_callback(struct sr_resource *res,
                        void *cb_data) noexcept;
-       static SR_PRIV ssize_t read_callback(const struct sr_resource *res,
+       static SR_PRIV gssize read_callback(const struct sr_resource *res,
                        void *buf, size_t count, void *cb_data) noexcept;
        friend class Context;
 };
@@ -767,10 +768,35 @@ class SR_API Analog :
 public:
        /** Pointer to data. */
        void *data_pointer();
+       /**
+        * Fills dest pointer with the analog data converted to float.
+        * The pointer must have space for num_samples() floats.
+        */
+       void get_data_as_float(float *dest);
        /** Number of samples in this packet. */
        unsigned int num_samples() const;
        /** Channels for which this packet contains data. */
        vector<shared_ptr<Channel> > channels();
+       /** Size of a single sample in bytes. */
+       unsigned int unitsize() const;
+       /** Samples use a signed data type. */
+       bool is_signed() const;
+       /** Samples use float. */
+       bool is_float() const;
+       /** Samples are stored in big-endian order. */
+       bool is_bigendian() const;
+       /**
+        * Number of significant digits after the decimal point if positive,
+        * or number of non-significant digits before the decimal point if negative
+        * (refers to the value we actually read on the wire).
+        */
+       int digits() const;
+       /** TBD */
+       bool is_digits_decimal() const;
+       /** TBD */
+       shared_ptr<Rational> scale();
+       /** TBD */
+       shared_ptr<Rational> offset();
        /** Measured quantity of the samples in this packet. */
        const Quantity *mq() const;
        /** Unit of the samples in this packet. */
@@ -787,6 +813,28 @@ private:
        friend class Packet;
 };
 
+/** Number represented by a numerator/denominator integer pair */
+class SR_API Rational :
+       public ParentOwned<Rational, Analog>
+{
+public:
+       /** Numerator, i.e. the dividend. */
+       int64_t numerator() const;
+       /** Denominator, i.e. the divider. */
+       uint64_t denominator() const;
+       /** Actual (lossy) value. */
+       float value() const;
+private:
+       explicit Rational(const struct sr_rational *structure);
+       ~Rational();
+       shared_ptr<Rational> share_owned_by(shared_ptr<Analog> parent);
+
+       const struct sr_rational *_structure;
+
+       friend class Analog;
+       friend struct std::default_delete<Rational>;
+};
+
 /** An input format supported by the library */
 class SR_API InputFormat :
        public ParentOwned<InputFormat, Context>
@@ -828,6 +876,7 @@ public:
        void send(void *data, size_t length);
        /** Signal end of input data. */
        void end();
+       void reset();
 private:
        Input(shared_ptr<Context> context, const struct sr_input *structure);
        ~Input();