/* 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