/*
This file is part of Ingen.
Copyright 2007-2012 David Robillard
Ingen is free software: you can redistribute it and/or modify it under the
terms of the GNU Affero General Public License as published by the Free
Software Foundation, either version 3 of the License, or any later version.
Ingen 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 Affero General Public License for details.
You should have received a copy of the GNU Affero General Public License
along with Ingen. If not, see .
*/
#ifndef INGEN_NODE_HPP
#define INGEN_NODE_HPP
#include "ingen/Resource.hpp"
#include "ingen/types.hpp"
#include "raul/Path.hpp"
namespace Raul {
class Atom;
class Path;
class Symbol;
}
namespace Ingen {
class Arc;
class Plugin;
class Store;
/** An object on the audio graph.
*
* The key property of nodes is that all nodes have a path and a symbol, as
* well as a URI.
*
* To avoid ugly inheritance issues and the need for excessive use of
* dynamic_cast, this class contains some members which are only applicable to
* certain types of node. There is a type tag which can be used to determine
* the type of any Node.
*
* @ingroup Ingen
*/
class Node : public Resource
{
public:
enum class GraphType {
GRAPH,
BLOCK,
PORT
};
typedef std::pair ArcsKey;
typedef std::map< ArcsKey, SPtr > Arcs;
// Graphs only
Arcs& arcs() { return _arcs; }
const Arcs& arcs() const { return _arcs; }
// Blocks and graphs only
virtual uint32_t num_ports() const { return 0; }
virtual Node* port(uint32_t index) const { return NULL; }
virtual const Plugin* plugin() const { return NULL; }
// All objects
virtual GraphType graph_type() const = 0;
virtual const Raul::Path& path() const = 0;
virtual const Raul::Symbol& symbol() const = 0;
virtual Node* graph_parent() const = 0;
static Raul::URI root_uri() { return Raul::URI("ingen:/root"); }
static bool uri_is_path(const Raul::URI& uri) {
return uri == root_uri() ||
uri.substr(0, root_uri().length() + 1) == root_uri() + "/";
}
static Raul::Path uri_to_path(const Raul::URI& uri) {
return (uri == root_uri())
? Raul::Path("/")
: Raul::Path(uri.substr(root_uri().length()));
}
static Raul::URI path_to_uri(const Raul::Path& path) {
return Raul::URI(root_uri() + path.c_str());
}
protected:
friend class Store;
virtual void set_path(const Raul::Path& p) = 0;
Node(URIs& uris, const Raul::Path& path)
: Resource(uris, path_to_uri(path))
{}
Arcs _arcs; ///< Graphs only
};
} // namespace Ingen
#endif // INGEN_NODE_HPP