ARDOUR::Transform Class Reference

#include <transform.h>

Inheritance diagram for ARDOUR::Transform:

Classes
struct	Context
struct	Operation
struct	Program
struct	Value

Public Types
typedef Evoral::Sequence < Evoral::Beats >::NotePtr	NotePtr
typedef Evoral::Sequence < Evoral::Beats >::Notes	Notes
typedef ARDOUR::MidiModel::NoteDiffCommand::Property	Property

Public Member Functions
	Transform (const Program &prog)
Command *	operator() (boost::shared_ptr< ARDOUR::MidiModel > model, Evoral::Beats position, std::vector< Notes > &seqs)
std::string	name () const
Public Member Functions inherited from ARDOUR::MidiOperator
	MidiOperator ()
virtual	~MidiOperator ()
virtual Command *	operator() (boost::shared_ptr< ARDOUR::MidiModel >, Evoral::Beats, std::vector< Evoral::Sequence< Evoral::Beats >::Notes > &)=0

Private Attributes
const Program	_prog

Detailed Description

Transform notes with a user-defined transformation.

This is essentially an interpreter for a simple concatenative note transformation language (as an AST only, no source code). A "program" calculates a note property value from operations on literal values, and/or values from the current or previous note in the sequence. This allows simple things like "set all notes' velocity to 64" or transitions over time like "set velocity to the previous note's velocity + 10".

The language is forth-like: everything is on a stack, operations pop their arguments from the stack and push their result back on to it.

This is a sweet spot between simplicity and power, it should be simple to use this (with perhaps some minor extensions) to do most "linear-ish" transformations, though it could be extended to have random access and more special values as the need arises.

Definition at line 51 of file transform.h.

Member Typedef Documentation

typedef Evoral::Sequence<Evoral::Beats>::NotePtr ARDOUR::Transform::NotePtr

Definition at line 53 of file transform.h.

typedef Evoral::Sequence<Evoral::Beats>::Notes ARDOUR::Transform::Notes

Definition at line 54 of file transform.h.

typedef ARDOUR::MidiModel::NoteDiffCommand::Property ARDOUR::Transform::Property

Definition at line 55 of file transform.h.

Constructor & Destructor Documentation

ARDOUR::Transform::Transform

(

const Program &

prog

)

Definition at line 27 of file transform.cc.

Member Function Documentation

std::string ARDOUR::Transform::name ( ) const

inlinevirtual

Implements ARDOUR::MidiOperator.

Definition at line 138 of file transform.h.

Command * ARDOUR::Transform::operator()	(	boost::shared_ptr< ARDOUR::MidiModel >	model,
		Evoral::Beats	position,
		std::vector< Notes > &	seqs
	)

Definition at line 123 of file transform.cc.

Member Data Documentation

const Program ARDOUR::Transform::_prog

private

Definition at line 141 of file transform.h.

---

The documentation for this class was generated from the following files:

• /usr/local/music/src/ardour/4.0/libs/ardour/ardour/transform.h
• /usr/local/music/src/ardour/4.0/libs/ardour/transform.cc