/usr/include/uhd/convert.hpp is in libuhd-dev 3.9.2-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 | //
// Copyright 2011-2012,2014 Ettus Research LLC
//
// This program is free software: you can redistribute it and/or modify
// it under the terms of the GNU General Public License as published by
// the Free Software Foundation, either version 3 of the License, or
// (at your option) any later version.
//
// This program is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
// GNU General Public License for more details.
//
// You should have received a copy of the GNU General Public License
// along with this program. If not, see <http://www.gnu.org/licenses/>.
//
#ifndef INCLUDED_UHD_CONVERT_HPP
#define INCLUDED_UHD_CONVERT_HPP
#include <uhd/config.hpp>
#include <uhd/types/ref_vector.hpp>
#include <boost/shared_ptr.hpp>
#include <boost/function.hpp>
#include <boost/operators.hpp>
#include <string>
namespace uhd{ namespace convert{
//! A conversion class that implements a conversion from inputs -> outputs.
class converter{
public:
typedef boost::shared_ptr<converter> sptr;
typedef uhd::ref_vector<void *> output_type;
typedef uhd::ref_vector<const void *> input_type;
virtual ~converter(void) = 0;
//! Set the scale factor (used in floating point conversions)
virtual void set_scalar(const double) = 0;
//! The public conversion method to convert inputs -> outputs
UHD_INLINE void conv(const input_type &in, const output_type &out, const size_t num){
if (num != 0) (*this)(in, out, num);
}
private:
//! Callable method: input vectors, output vectors, num samples
//
// This is the guts of the converter. When deriving new converter types,
// this is where the actual conversion routines go.
//
// \param in Pointers to the input buffers
// \param out Pointers to the output buffers
// \param num Number of items in the input buffers to convert
virtual void operator()(const input_type& in, const output_type& out, const size_t num) = 0;
};
//! Conversion factory function typedef
typedef boost::function<converter::sptr(void)> function_type;
//! Priority of conversion routines
typedef int priority_type;
//! Identify a conversion routine in the registry
struct UHD_API id_type : boost::equality_comparable<id_type>{
std::string input_format;
size_t num_inputs;
std::string output_format;
size_t num_outputs;
std::string to_pp_string(void) const;
std::string to_string(void) const;
};
//! Implement equality_comparable interface
UHD_API bool operator==(const id_type &, const id_type &);
/*!
* Register a converter function.
*
* Converters with higher priority are given preference.
*
* \param id identify the conversion
* \param fcn makes a new converter
* \param prio the function priority
*/
UHD_API void register_converter(
const id_type &id,
const function_type &fcn,
const priority_type prio
);
/*!
* Get a converter factory function.
* \param id identify the conversion
* \param prio the desired prio or -1 for best
* \return the converter factory function
*/
UHD_API function_type get_converter(
const id_type &id,
const priority_type prio = -1
);
/*!
* Register the size of a particular item.
* \param format the item format
* \param size the size in bytes
*/
UHD_API void register_bytes_per_item(
const std::string &format, const size_t size
);
//! Convert an item format to a size in bytes
UHD_API size_t get_bytes_per_item(const std::string &format);
}} //namespace
#endif /* INCLUDED_UHD_CONVERT_HPP */
|