Applies a function to a signal (input-output) More...

#include <klang.h>

Inheritance diagram for klang::Function< Args >:

Public Member Functions
	Function ()

	Function (std::function< float(Args...)> function)

	operator signal ()

	operator param ()

unsigned int	args () const

std::tuple< Rest... >	tail (const std::tuple< First, Rest... > &t) const

void	input () override

virtual const signal &	input () const

virtual void	input (const signal &source)

First	first (First first, Rest...)

Function< signal, Args... > &	operator() (const FuncArgs &... args)

const float	operator() (const FuncArgs &... args) const

Modifier< signal > &	operator() (params... p)

Function< signal, Args... > &	with (FuncArgs... args)

signal	evaluate () const

virtual void	process () override

klang::Graph &	operator>> (klang::Graph &graph)

klang::GraphPtr &	operator>> (klang::GraphPtr &graph)

TYPE &	operator>> (TYPE &destination)

	operator const signal & () override

	operator const signal & () const override

virtual void	operator<< (const signal &source)

virtual const signal &	output () const

signal	operator+ (TYPE &other)

signal	operator* (TYPE &other)

signal	operator- (TYPE &other)

signal	operator/ (TYPE &other)

Public Attributes
std::function< float(Args...)>	function

std::tuple< Args... >	inputs

signal	in

signal	out

Static Public Attributes
static constexpr unsigned int	ARGS

Detailed Description

template<typename... Args>
struct klang::Function< Args >

Definition at line 2028 of file klang.h.

Constructor & Destructor Documentation

◆ Function() [1/2]

template<typename... Args>

klang::Function< Args >::Function ( )

inline

Definition at line 2034 of file klang.h.

2034: Generic::Function<signal, Args...>(nullptr) { }

klang::Generic::Function

Function() -> Function< signal, Args... >

klang::Stereo::signal

signals< 2 > signal

Stereo audio signal.

Definition klang.h:3308

◆ Function() [2/2]

template<typename... Args>

klang::Function< Args >::Function ( std::function< float(Args...)> function )

inline

Definition at line 2036 of file klang.h.

2036: Generic::Function<signal, Args...>(function) { }

klang::Generic::Function< signal, Args... >::function

std::function< float(Args...)> function

Definition klang.h:1518

Member Function Documentation

◆ args()

unsigned int klang::Generic::Function< signal, Args >::args ( ) const

inlineinherited

Definition at line 1521 of file klang.h.

1521{ return ARGS; }

klang::Generic::Function< signal, Args... >::ARGS

static constexpr unsigned int ARGS

Definition klang.h:1520

◆ evaluate()

signal klang::Generic::Function< signal, Args >::evaluate ( ) const

inlineinherited

Definition at line 1608 of file klang.h.

                              {
        if (!function)
          return 0.f;
                if constexpr (ARGS > 1)
          return std::apply(function, inputs);
                else
          return function(in);
      }

◆ first()

First klang::Generic::Function< signal, Args >::first	(	First	first,
		Rest...	)

inlineinherited

Definition at line 1550 of file klang.h.

1550{ return first; }

klang::Generic::Function< signal, Args... >::first

First first(First first, Rest...)

Definition klang.h:1550

◆ input() [1/3]

void klang::Generic::Function< signal, Args >::input ( )

inlineoverridevirtualinherited

Reimplemented from klang::Generic::Input< signal >.

Definition at line 1544 of file klang.h.

                                  {
                std::get<0>(inputs) = in.value;
            }

◆ input() [2/3]

virtual const signal & klang::Generic::Input< signal >::input ( ) const

inlinevirtualinherited

Reimplemented in klang::Generic::Graph< SIZE >::Series.

Definition at line 1343 of file klang.h.

1343{ return in; }

◆ input() [3/3]

virtual void klang::Generic::Input< signal >::input ( const signal & source )

inlinevirtualinherited

Definition at line 1347 of file klang.h.

1347{ in = source; input(); }

klang::Generic::Input< signal >::input

virtual const signal & input() const

Definition klang.h:1343

◆ operator const signal &() [1/2]

klang::Generic::Modifier< signal >::operator const signal & ( ) const

inlineoverridevirtualinherited

Reimplemented from klang::Generic::Output< signal >.

Definition at line 1450 of file klang.h.

1450{ return out; } // return last output

klang::Generic::Output< signal >::out

signal out

Definition klang.h:1357

◆ operator const signal &() [2/2]

klang::Generic::Modifier< signal >::operator const signal & ( )

inlineoverridevirtualinherited

Reimplemented from klang::Generic::Output< signal >.

Definition at line 1449 of file klang.h.

1449{ process(); return out; } // return processed output

klang::Generic::Modifier< signal >::process

virtual void process() override

Definition klang.h:1453

◆ operator param()

klang::Generic::Function< signal, Args >::operator param ( )

inlineinherited

Definition at line 1488 of file klang.h.

                       { 
        if(function)
          return evaluate(); 
        return 2.f;
      }

◆ operator signal()

klang::Generic::Function< signal, Args >::operator signal ( )

inlineinherited

Definition at line 1482 of file klang.h.

                        { 
        if (function)
          return evaluate();
        process();
        return out; 
      };

◆ operator()() [1/3]

Function< signal, Args... > & klang::Generic::Function< signal, Args >::operator() ( const FuncArgs &... args )

inlineinherited

Definition at line 1554 of file klang.h.

                                                                    {
                if constexpr (ARGS > 1 && sizeof...(FuncArgs) == 1){
                    in = first(args...);
                    std::get<0>(inputs) = in.value;
                    return *this;
                } else if constexpr (ARGS == sizeof...(FuncArgs)){
                    in = first(args...);
                    inputs = std::tuple<Args...>(args...);
                    return *this;
                } else if constexpr (sizeof...(FuncArgs) == (ARGS - 1)){
                    inputs = std::tuple<Args...>(in.value, args...);
                    return *this;
                } else {
                    in = first(args...);
                    std::get<0>(inputs) = in.value;
                    return *this;
                }
      }

◆ operator()() [2/3]

const float klang::Generic::Function< signal, Args >::operator() ( const FuncArgs &... args ) const

inlineinherited

Definition at line 1575 of file klang.h.

                                                            {
        signal in = this->in;
        std::tuple<Args...> inputs = this->inputs;
 
        // configure inputs
        if constexpr (ARGS > 1 && sizeof...(FuncArgs) == 1) {
          in = first(args...);
          std::get<0>(inputs) = in.value;
        } else if constexpr (ARGS == sizeof...(FuncArgs)) {
          in = first(args...);
          inputs = std::tuple<Args...>(args...);
        } else if constexpr (sizeof...(FuncArgs) == (ARGS - 1)) {
          inputs = std::tuple<Args...>(in.value, args...);
        } else {
          in = first(args...);
          std::get<0>(inputs) = in.value;
        }
 
        // return outputs
        if constexpr (ARGS > 1)
          return std::apply(function, inputs);
        else
          return function(in);
      }

◆ operator()() [3/3]

Modifier< signal > & klang::Generic::Modifier< signal >::operator() ( params... p )

inlineinherited

Definition at line 1457 of file klang.h.

                                                {
        set(p...); return *this;
      }

◆ operator*()

signal klang::Generic::Output< signal >::operator* ( TYPE & other )

inlineinherited

Definition at line 1372 of file klang.h.

1372{ process(); return out * (other); }

klang::Generic::Output< signal >::process

virtual void process()=0

◆ operator+()

signal klang::Generic::Output< signal >::operator+ ( TYPE & other )

inlineinherited

Definition at line 1371 of file klang.h.

1371{ process(); return out + (other); }

◆ operator-()

signal klang::Generic::Output< signal >::operator- ( TYPE & other )

inlineinherited

Definition at line 1373 of file klang.h.

1373{ process(); return out - (other); }

◆ operator/()

signal klang::Generic::Output< signal >::operator/ ( TYPE & other )

inlineinherited

Definition at line 1374 of file klang.h.

1374{ process(); return out / (other); }

◆ operator<<()

virtual void klang::Generic::Input< signal >::operator<< ( const signal & source )

inlinevirtualinherited

Definition at line 1346 of file klang.h.

1346{ in = source; input(); }

◆ operator>>() [1/3]

Graph & klang::Generic::Function< signal, Args >::operator>> ( klang::Graph & graph )

inlineinherited

Definition at line 1621 of file klang.h.

                                                                              {
    graph.plot(*this);
    return graph;
  }

◆ operator>>() [2/3]

GraphPtr & klang::Generic::Function< signal, Args >::operator>> ( klang::GraphPtr & graph )

inlineinherited

Definition at line 1622 of file klang.h.

                                                                                    {
    graph.plot(*this);
    return graph;
  }

◆ operator>>() [3/3]

TYPE & klang::Generic::Output< signal >::operator>> ( TYPE & destination )

inlineinherited

Definition at line 1364 of file klang.h.

1364{ process(); return destination = out; }

◆ output()

virtual const signal & klang::Generic::Output< signal >::output ( ) const

inlinevirtualinherited

Definition at line 1360 of file klang.h.

1360{ return out; }

◆ process()

virtual void klang::Generic::Function< signal, Args >::process ( )

inlineoverridevirtualinherited

Reimplemented from klang::Generic::Modifier< signal >.

Definition at line 1617 of file klang.h.

                                      {
        out = evaluate();
      }

◆ tail()

std::tuple< Rest... > klang::Generic::Function< signal, Args >::tail ( const std::tuple< First, Rest... > & t ) const

inlineinherited

Definition at line 1527 of file klang.h.

                                                                      {
        return std::apply( [](const First&, const Rest&... rest) { return std::make_tuple(rest...); },t);
      }

◆ with()

Function< signal, Args... > & klang::Generic::Function< signal, Args >::with ( FuncArgs... args )

inlineinherited

Definition at line 1601 of file klang.h.

                                                            {
                static_assert(sizeof...(FuncArgs) == (ARGS - 1), "with() arguments must have all but first argument.");
                inputs = std::tuple<Args...>(in.value, args...);
                    
                return *this;
            }

Member Data Documentation

◆ ARGS

unsigned int klang::Generic::Function< signal, Args >::ARGS

staticconstexprinherited

Definition at line 1520 of file klang.h.

◆ function

std::function<float(Args...)> klang::Generic::Function< signal, Args >::function

inherited

Definition at line 1518 of file klang.h.

◆ in

signal klang::Generic::Input< signal >::in

inherited

Definition at line 1340 of file klang.h.

1340{ 0.f };

◆ inputs

std::tuple<Args...> klang::Generic::Function< signal, Args >::inputs

inherited

Definition at line 1523 of file klang.h.

◆ out

signal klang::Generic::Output< signal >::out

inherited

Definition at line 1357 of file klang.h.

1357{ 0.f };

Public Member Functions

Public Attributes

Static Public Attributes

Detailed Description

Constructor & Destructor Documentation

◆ Function() [1/2]

◆ Function() [2/2]

Member Function Documentation

◆ args()

◆ evaluate()

◆ first()

◆ input() [1/3]

◆ input() [2/3]

◆ input() [3/3]

◆ operator const signal &() [1/2]

◆ operator const signal &() [2/2]

◆ operator param()

◆ operator signal()

◆ operator()() [1/3]

◆ operator()() [2/3]

◆ operator()() [3/3]

◆ operator*()

◆ operator+()

◆ operator-()

◆ operator/()

◆ operator<<()

◆ operator>>() [1/3]

◆ operator>>() [2/3]

◆ operator>>() [3/3]

◆ output()

◆ process()

◆ tail()

◆ with()

Member Data Documentation

◆ ARGS

◆ function

◆ in

◆ inputs

◆ out