/* This file is part of Ingen. Copyright 2007-2016 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 . */ #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include namespace ingen { struct Serialiser::Impl { explicit Impl(World& world) : _root_path("/") , _world(world) , _sratom(sratom_new(&_world.uri_map().urid_map())) {} ~Impl() { sratom_free(_sratom); } Impl(const Impl&) = delete; Impl(Impl&&) = delete; Impl& operator=(const Impl&) = delete; Impl& operator=(Impl&&) = delete; enum class Mode { TO_FILE, TO_STRING }; void start_to_file(const raul::Path& root, const FilePath& filename); std::set serialise_graph(const std::shared_ptr& graph, const Sord::Node& graph_id); void serialise_block(const std::shared_ptr& block, const Sord::Node& class_id, const Sord::Node& block_id); void serialise_port(const Node* port, Resource::Graph context, const Sord::Node& port_id); void serialise_properties(Sord::Node id, const Properties& props); void write_bundle(const std::shared_ptr& graph, const URI& uri); Sord::Node path_rdf_node(const raul::Path& path) const; void write_manifest(const FilePath& bundle_path, const std::shared_ptr& graph); void write_plugins(const FilePath& bundle_path, const std::set& plugins); void serialise_arc(const Sord::Node& parent, const std::shared_ptr& arc); std::string finish(); raul::Path _root_path; Mode _mode{Mode::TO_FILE}; URI _base_uri; FilePath _basename; World& _world; Sord::Model* _model{nullptr}; Sratom* _sratom; }; Serialiser::Serialiser(World& world) : me{std::make_unique(world)} {} Serialiser::~Serialiser() = default; void Serialiser::Impl::write_manifest(const FilePath& bundle_path, const std::shared_ptr&) { const FilePath manifest_path(bundle_path / "manifest.ttl"); start_to_file(raul::Path("/"), manifest_path); Sord::World& world = _model->world(); const URIs& uris = _world.uris(); const std::string filename("main.ttl"); const Sord::URI subject(world, filename, _base_uri); _model->add_statement(subject, Sord::URI(world, uris.rdf_type), Sord::URI(world, uris.ingen_Graph)); _model->add_statement(subject, Sord::URI(world, uris.rdf_type), Sord::URI(world, uris.lv2_Plugin)); _model->add_statement(subject, Sord::URI(world, uris.rdfs_seeAlso), Sord::URI(world, filename, _base_uri)); _model->add_statement(subject, Sord::URI(world, uris.lv2_prototype), Sord::URI(world, uris.ingen_GraphPrototype)); finish(); } void Serialiser::Impl::write_plugins(const FilePath& bundle_path, const std::set& plugins) { const FilePath plugins_path(bundle_path / "plugins.ttl"); start_to_file(raul::Path("/"), plugins_path); Sord::World& world = _model->world(); const URIs& uris = _world.uris(); for (const auto& p : plugins) { const Atom& minor = p->get_property(uris.lv2_minorVersion); const Atom& micro = p->get_property(uris.lv2_microVersion); _model->add_statement(Sord::URI(world, p->uri()), Sord::URI(world, uris.rdf_type), Sord::URI(world, uris.lv2_Plugin)); if (minor.is_valid() && micro.is_valid()) { _model->add_statement(Sord::URI(world, p->uri()), Sord::URI(world, uris.lv2_minorVersion), Sord::Literal::integer(world, minor.get())); _model->add_statement(Sord::URI(world, p->uri()), Sord::URI(world, uris.lv2_microVersion), Sord::Literal::integer(world, micro.get())); } } finish(); } void Serialiser::write_bundle(const std::shared_ptr& graph, const URI& uri) { me->write_bundle(graph, uri); } void Serialiser::Impl::write_bundle(const std::shared_ptr& graph, const URI& uri) { FilePath path(uri.path()); if (std::filesystem::exists(path) && !std::filesystem::is_directory(path)) { path = path.parent_path(); } _world.log().info("Writing bundle %1%\n", path); std::filesystem::create_directories(path); const FilePath main_file = path / "main.ttl"; const raul::Path old_root_path = _root_path; start_to_file(graph->path(), main_file); const std::set plugins = serialise_graph(graph, Sord::URI(_model->world(), main_file, _base_uri)); finish(); write_manifest(path, graph); write_plugins(path, plugins); _root_path = old_root_path; } /** Begin a serialization to a file. * * This must be called before any serializing methods. */ void Serialiser::Impl::start_to_file(const raul::Path& root, const FilePath& filename) { _base_uri = URI(filename); _basename = filename.stem(); if (_basename == "main") { _basename = filename.parent_path().stem(); } _model = new Sord::Model(*_world.rdf_world(), _base_uri); _mode = Mode::TO_FILE; _root_path = root; } void Serialiser::start_to_string(const raul::Path& root, const URI& base_uri) { me->_root_path = root; me->_base_uri = base_uri; me->_model = new Sord::Model(*me->_world.rdf_world(), base_uri); me->_mode = Impl::Mode::TO_STRING; } void Serialiser::start_to_file(const raul::Path& root, const FilePath& filename) { me->start_to_file(root, filename); } std::string Serialiser::finish() { return me->finish(); } std::string Serialiser::Impl::finish() { std::string ret; if (_mode == Mode::TO_FILE) { const SerdStatus st = _model->write_to_file(_base_uri, SERD_TURTLE); if (st) { _world.log().error("Error writing file %1% (%2%)\n", _base_uri, serd_strerror(st)); } } else { ret = _model->write_to_string(_base_uri, SERD_TURTLE); } delete _model; _model = nullptr; _base_uri = URI(); return ret; } Sord::Node Serialiser::Impl::path_rdf_node(const raul::Path& path) const { assert(_model); assert(path == _root_path || path.is_child_of(_root_path)); return Sord::URI(_model->world(), path.substr(_root_path.base().length()), _base_uri); } void Serialiser::serialise(const std::shared_ptr& object, Resource::Graph context) { if (!me->_model) { throw std::logic_error( "serialise called without serialisation in progress"); } if (object->graph_type() == Node::GraphType::GRAPH) { me->serialise_graph(object, me->path_rdf_node(object->path())); } else if (object->graph_type() == Node::GraphType::BLOCK) { const Sord::URI plugin_id(me->_model->world(), object->plugin()->uri()); me->serialise_block(object, plugin_id, me->path_rdf_node(object->path())); } else if (object->graph_type() == Node::GraphType::PORT) { me->serialise_port(object.get(), context, me->path_rdf_node(object->path())); } else { me->serialise_properties(me->path_rdf_node(object->path()), object->properties()); } } std::set Serialiser::Impl::serialise_graph(const std::shared_ptr& graph, const Sord::Node& graph_id) { Sord::World& world = _model->world(); const URIs& uris = _world.uris(); _model->add_statement(graph_id, Sord::URI(world, uris.rdf_type), Sord::URI(world, uris.ingen_Graph)); _model->add_statement(graph_id, Sord::URI(world, uris.rdf_type), Sord::URI(world, uris.lv2_Plugin)); _model->add_statement(graph_id, Sord::URI(world, uris.lv2_extensionData), Sord::URI(world, LV2_STATE__interface)); _model->add_statement( graph_id, Sord::URI(world, LV2_UI__ui), Sord::URI(world, "http://drobilla.net/ns/ingen#GraphUIGtk2")); // If the graph has no doap:name (required by LV2), use the basename if (graph->properties().find(uris.doap_name) == graph->properties().end()) { _model->add_statement(graph_id, Sord::URI(world, uris.doap_name), Sord::Literal(world, _basename)); } const Properties props = graph->properties(Resource::Graph::INTERNAL); serialise_properties(graph_id, props); std::set plugins; const Store::const_range kids = _world.store()->children_range(graph); for (auto n = kids.first; n != kids.second; ++n) { if (n->first.parent() != graph->path()) { continue; } if (n->second->graph_type() == Node::GraphType::GRAPH) { const std::shared_ptr subgraph = n->second; SerdURI base_uri; serd_uri_parse(reinterpret_cast(_base_uri.c_str()), &base_uri); const std::string sub_bundle_path = subgraph->path().substr(1) + ".ingen"; SerdURI subgraph_uri; SerdNode subgraph_node = serd_node_new_uri_from_string(reinterpret_cast( sub_bundle_path.c_str()), &base_uri, &subgraph_uri); const Sord::URI subgraph_id(world, reinterpret_cast( subgraph_node.buf)); // Save our state const URI my_base_uri = _base_uri; Sord::Model* my_model = _model; // Write child bundle within this bundle write_bundle(subgraph, subgraph_id); // Restore our state _base_uri = my_base_uri; _model = my_model; // Serialise reference to graph block const Sord::Node block_id(path_rdf_node(subgraph->path())); _model->add_statement(graph_id, Sord::URI(world, uris.ingen_block), block_id); serialise_block(subgraph, subgraph_id, block_id); serd_node_free(&subgraph_node); } else if (n->second->graph_type() == Node::GraphType::BLOCK) { const std::shared_ptr block = n->second; const Sord::URI class_id(world, block->plugin()->uri()); const Sord::Node block_id(path_rdf_node(n->second->path())); _model->add_statement(graph_id, Sord::URI(world, uris.ingen_block), block_id); serialise_block(block, class_id, block_id); plugins.insert(block->plugin()); } } for (uint32_t i = 0; i < graph->num_ports(); ++i) { Node* p = graph->port(i); const Sord::Node port_id = path_rdf_node(p->path()); // Ensure lv2:name always exists so Graph is a valid LV2 plugin if (p->properties().find(uris.lv2_name) == p->properties().end()) { p->set_property(uris.lv2_name, _world.forge().alloc(p->symbol().c_str())); } _model->add_statement(graph_id, Sord::URI(world, LV2_CORE__port), port_id); serialise_port(p, Resource::Graph::DEFAULT, port_id); serialise_port(p, Resource::Graph::INTERNAL, port_id); } for (const auto& a : graph->arcs()) { serialise_arc(graph_id, a.second); } return plugins; } void Serialiser::Impl::serialise_block(const std::shared_ptr& block, const Sord::Node& class_id, const Sord::Node& block_id) { const URIs& uris = _world.uris(); _model->add_statement(block_id, Sord::URI(_model->world(), uris.rdf_type), Sord::URI(_model->world(), uris.ingen_Block)); _model->add_statement(block_id, Sord::URI(_model->world(), uris.lv2_prototype), class_id); // Serialise properties, but remove possibly stale state:state (set again // below) Properties props = block->properties(); props.erase(uris.state_state); serialise_properties(block_id, props); if (_base_uri.scheme() == "file") { const FilePath base_path = _base_uri.file_path(); const FilePath graph_dir = base_path.parent_path(); const FilePath state_dir = graph_dir / std::string(block->symbol()); const FilePath state_file = state_dir / "state.ttl"; if (block->save_state(state_dir)) { _model->add_statement(block_id, Sord::URI(_model->world(), uris.state_state), Sord::URI(_model->world(), URI(state_file))); } } for (uint32_t i = 0; i < block->num_ports(); ++i) { Node* const p = block->port(i); const Sord::Node port_id = path_rdf_node(p->path()); serialise_port(p, Resource::Graph::DEFAULT, port_id); _model->add_statement(block_id, Sord::URI(_model->world(), uris.lv2_port), port_id); } } void Serialiser::Impl::serialise_port(const Node* port, Resource::Graph context, const Sord::Node& port_id) { const URIs& uris = _world.uris(); Sord::World& world = _model->world(); Properties props = port->properties(context); if (context == Resource::Graph::INTERNAL) { // Always write lv2:symbol for Graph ports (required for lv2:Plugin) _model->add_statement(port_id, Sord::URI(world, uris.lv2_symbol), Sord::Literal(world, port->path().symbol())); } else if (context == Resource::Graph::EXTERNAL) { // Never write lv2:index for plugin instances (not persistent/stable) props.erase(uris.lv2_index); } if (context == Resource::Graph::INTERNAL && port->has_property(uris.rdf_type, uris.lv2_ControlPort) && port->has_property(uris.rdf_type, uris.lv2_InputPort)) { const Atom& val = port->get_property(uris.ingen_value); if (val.is_valid()) { props.erase(uris.lv2_default); props.emplace(uris.lv2_default, val); } else { _world.log().warn( "Control input has no value, lv2:default omitted.\n"); } } else if (context != Resource::Graph::INTERNAL && !port->has_property(uris.rdf_type, uris.lv2_InputPort)) { props.erase(uris.ingen_value); } serialise_properties(port_id, props); } void Serialiser::serialise_arc(const Sord::Node& parent, const std::shared_ptr& arc) { me->serialise_arc(parent, arc); } void Serialiser::Impl::serialise_arc(const Sord::Node& parent, const std::shared_ptr& arc) { if (!_model) { throw std::logic_error( "serialise_arc called without serialisation in progress"); } Sord::World& world = _model->world(); const URIs& uris = _world.uris(); const Sord::Node src = path_rdf_node(arc->tail_path()); const Sord::Node dst = path_rdf_node(arc->head_path()); const Sord::Node arc_id = Sord::Node::blank_id(*_world.rdf_world(), "arc"); _model->add_statement(arc_id, Sord::URI(world, uris.ingen_tail), src); _model->add_statement(arc_id, Sord::URI(world, uris.ingen_head), dst); if (parent.is_valid()) { _model->add_statement(parent, Sord::URI(world, uris.ingen_arc), arc_id); } else { _model->add_statement(arc_id, Sord::URI(world, uris.rdf_type), Sord::URI(world, uris.ingen_Arc)); } } static bool skip_property(ingen::URIs& uris, const Sord::Node& predicate) { return (predicate == INGEN__file || predicate == uris.ingen_arc || predicate == uris.ingen_block || predicate == uris.lv2_port); } void Serialiser::Impl::serialise_properties(Sord::Node id, const Properties& props) { LV2_URID_Unmap* unmap = &_world.uri_map().urid_unmap(); const SerdNode base = serd_node_from_string( SERD_URI, reinterpret_cast(_base_uri.c_str())); SerdEnv* env = serd_env_new(&base); SordInserter* inserter = sord_inserter_new(_model->c_obj(), env); sratom_set_sink(_sratom, _base_uri.c_str(), reinterpret_cast( sord_inserter_write_statement), nullptr, inserter); sratom_set_pretty_numbers(_sratom, true); for (const auto& p : props) { const Sord::URI key(_model->world(), p.first); if (!skip_property(_world.uris(), key)) { if (p.second.type() == _world.uris().atom_URI && !strncmp(reinterpret_cast(p.second.get_body()), "ingen:/main/", 12)) { /* Value is a graph URI relative to the running engine. Chop the prefix and save the path relative to the graph file. This allows saving references to bundle resources. */ sratom_write( _sratom, unmap, 0, sord_node_to_serd_node(id.c_obj()), sord_node_to_serd_node(key.c_obj()), p.second.type(), p.second.size(), reinterpret_cast(p.second.get_body()) + 13); } else { sratom_write(_sratom, unmap, 0, sord_node_to_serd_node(id.c_obj()), sord_node_to_serd_node(key.c_obj()), p.second.type(), p.second.size(), p.second.get_body()); } } } sord_inserter_free(inserter); serd_env_free(env); } } // namespace ingen