/* * This program is free software; you can redistribute it and/or * modify it under the terms of the GNU General Public License * as published by the Free Software Foundation; either version 2 * of the License, or (at your option) any later version. * * This program 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 General Public License for more details. * * You should have received a copy of the GNU General Public License * along with this program; if not, write to the Free Software Foundation, * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA. * * Copyright 2013, Blender Foundation. */ #include "COM_Debug.h" #include #include #include extern "C" { #include "BLI_fileops.h" #include "BLI_path_util.h" #include "BLI_string.h" #include "BLI_sys_types.h" #include "BKE_appdir.h" #include "BKE_node.h" #include "DNA_node_types.h" } #include "COM_ExecutionSystem.h" #include "COM_Node.h" #include "COM_ReadBufferOperation.h" #include "COM_SetValueOperation.h" #include "COM_ViewerOperation.h" #include "COM_WriteBufferOperation.h" namespace blender::compositor { int DebugInfo::m_file_index = 0; DebugInfo::NodeNameMap DebugInfo::m_node_names; DebugInfo::OpNameMap DebugInfo::m_op_names; std::string DebugInfo::m_current_node_name; std::string DebugInfo::m_current_op_name; DebugInfo::GroupStateMap DebugInfo::m_group_states; static std::string operation_class_name(NodeOperation *op) { std::string full_name = typeid(*op).name(); /* Remove name-spaces. */ size_t pos = full_name.find_last_of(':'); BLI_assert(pos != std::string::npos); return full_name.substr(pos + 1); } std::string DebugInfo::node_name(const Node *node) { NodeNameMap::const_iterator it = m_node_names.find(node); if (it != m_node_names.end()) { return it->second; } return ""; } std::string DebugInfo::operation_name(const NodeOperation *op) { OpNameMap::const_iterator it = m_op_names.find(op); if (it != m_op_names.end()) { return it->second; } return ""; } int DebugInfo::graphviz_operation(const ExecutionSystem *system, NodeOperation *operation, const ExecutionGroup *group, char *str, int maxlen) { int len = 0; std::string fillcolor = "gainsboro"; if (operation->get_flags().is_viewer_operation) { const ViewerOperation *viewer = (const ViewerOperation *)operation; if (viewer->isActiveViewerOutput()) { fillcolor = "lightskyblue1"; } else { fillcolor = "lightskyblue3"; } } else if (operation->isOutputOperation(system->getContext().isRendering())) { fillcolor = "dodgerblue1"; } else if (operation->get_flags().is_set_operation) { fillcolor = "khaki1"; } else if (operation->get_flags().is_read_buffer_operation) { fillcolor = "darkolivegreen3"; } else if (operation->get_flags().is_write_buffer_operation) { fillcolor = "darkorange"; } len += snprintf(str + len, maxlen > len ? maxlen - len : 0, "// OPERATION: %p\r\n", operation); if (group) { len += snprintf(str + len, maxlen > len ? maxlen - len : 0, "\"O_%p_%p\"", operation, group); } else { len += snprintf(str + len, maxlen > len ? maxlen - len : 0, "\"O_%p\"", operation); } len += snprintf(str + len, maxlen > len ? maxlen - len : 0, " [fillcolor=%s,style=filled,shape=record,label=\"{", fillcolor.c_str()); int totinputs = operation->getNumberOfInputSockets(); if (totinputs != 0) { len += snprintf(str + len, maxlen > len ? maxlen - len : 0, "{"); for (int k = 0; k < totinputs; k++) { NodeOperationInput *socket = operation->getInputSocket(k); if (k != 0) { len += snprintf(str + len, maxlen > len ? maxlen - len : 0, "|"); } len += snprintf(str + len, maxlen > len ? maxlen - len : 0, "", socket); switch (socket->getDataType()) { case DataType::Value: len += snprintf(str + len, maxlen > len ? maxlen - len : 0, "Value"); break; case DataType::Vector: len += snprintf(str + len, maxlen > len ? maxlen - len : 0, "Vector"); break; case DataType::Color: len += snprintf(str + len, maxlen > len ? maxlen - len : 0, "Color"); break; } } len += snprintf(str + len, maxlen > len ? maxlen - len : 0, "}"); len += snprintf(str + len, maxlen > len ? maxlen - len : 0, "|"); } if (COM_GRAPHVIZ_SHOW_NODE_NAME) { std::string op_node_name = operation->get_name(); if (!op_node_name.empty()) { len += snprintf( str + len, maxlen > len ? maxlen - len : 0, "%s\\n", (op_node_name + " Node").c_str()); } } len += snprintf(str + len, maxlen > len ? maxlen - len : 0, "%s\\n", operation_class_name(operation).c_str()); len += snprintf(str + len, maxlen > len ? maxlen - len : 0, "#%d (%u,%u)", operation->get_id(), operation->getWidth(), operation->getHeight()); int totoutputs = operation->getNumberOfOutputSockets(); if (totoutputs != 0) { len += snprintf(str + len, maxlen > len ? maxlen - len : 0, "|"); len += snprintf(str + len, maxlen > len ? maxlen - len : 0, "{"); for (int k = 0; k < totoutputs; k++) { NodeOperationOutput *socket = operation->getOutputSocket(k); if (k != 0) { len += snprintf(str + len, maxlen > len ? maxlen - len : 0, "|"); } len += snprintf(str + len, maxlen > len ? maxlen - len : 0, "", socket); switch (socket->getDataType()) { case DataType::Value: if (typeid(*operation) == typeid(SetValueOperation)) { const float value = ((SetValueOperation *)operation)->getValue(); len += snprintf(str + len, maxlen > len ? maxlen - len : 0, "Value\\n%12.4g", value); } else { len += snprintf(str + len, maxlen > len ? maxlen - len : 0, "Value"); } break; case DataType::Vector: len += snprintf(str + len, maxlen > len ? maxlen - len : 0, "Vector"); break; case DataType::Color: len += snprintf(str + len, maxlen > len ? maxlen - len : 0, "Color"); break; } } len += snprintf(str + len, maxlen > len ? maxlen - len : 0, "}"); } len += snprintf(str + len, maxlen > len ? maxlen - len : 0, "}\"]"); len += snprintf(str + len, maxlen > len ? maxlen - len : 0, "\r\n"); return len; } int DebugInfo::graphviz_legend_color(const char *name, const char *color, char *str, int maxlen) { int len = 0; len += snprintf(str + len, maxlen > len ? maxlen - len : 0, "%s\r\n", name, color); return len; } int DebugInfo::graphviz_legend_line( const char * /*name*/, const char * /*color*/, const char * /*style*/, char *str, int maxlen) { /* XXX TODO */ int len = 0; len += snprintf(str + len, maxlen > len ? maxlen - len : 0, "\r\n"); return len; } int DebugInfo::graphviz_legend_group( const char *name, const char *color, const char * /*style*/, char *str, int maxlen) { int len = 0; len += snprintf(str + len, maxlen > len ? maxlen - len : 0, "%s
\r\n", name, color); return len; } int DebugInfo::graphviz_legend(char *str, int maxlen, const bool has_execution_groups) { int len = 0; len += snprintf(str + len, maxlen > len ? maxlen - len : 0, "{\r\n"); if (has_execution_groups) { len += snprintf(str + len, maxlen > len ? maxlen - len : 0, "rank = sink;\r\n"); } len += snprintf( str + len, maxlen > len ? maxlen - len : 0, "Legend [shape=none, margin=0, label=<\r\n"); len += snprintf( str + len, maxlen > len ? maxlen - len : 0, " \r\n"); len += snprintf(str + len, maxlen > len ? maxlen - len : 0, "\r\n"); len += graphviz_legend_color( "NodeOperation", "gainsboro", str + len, maxlen > len ? maxlen - len : 0); len += graphviz_legend_color( "Output", "dodgerblue1", str + len, maxlen > len ? maxlen - len : 0); len += graphviz_legend_color( "Viewer", "lightskyblue3", str + len, maxlen > len ? maxlen - len : 0); len += graphviz_legend_color( "Active Viewer", "lightskyblue1", str + len, maxlen > len ? maxlen - len : 0); if (has_execution_groups) { len += graphviz_legend_color( "Write Buffer", "darkorange", str + len, maxlen > len ? maxlen - len : 0); len += graphviz_legend_color( "Read Buffer", "darkolivegreen3", str + len, maxlen > len ? maxlen - len : 0); } len += graphviz_legend_color( "Input Value", "khaki1", str + len, maxlen > len ? maxlen - len : 0); if (has_execution_groups) { len += snprintf(str + len, maxlen > len ? maxlen - len : 0, "\r\n"); len += graphviz_legend_group( "Group Waiting", "white", "dashed", str + len, maxlen > len ? maxlen - len : 0); len += graphviz_legend_group( "Group Running", "firebrick1", "solid", str + len, maxlen > len ? maxlen - len : 0); len += graphviz_legend_group( "Group Finished", "chartreuse4", "solid", str + len, maxlen > len ? maxlen - len : 0); } len += snprintf(str + len, maxlen > len ? maxlen - len : 0, "
Legend
\r\n"); len += snprintf(str + len, maxlen > len ? maxlen - len : 0, ">];\r\n"); len += snprintf(str + len, maxlen > len ? maxlen - len : 0, "}\r\n"); return len; } bool DebugInfo::graphviz_system(const ExecutionSystem *system, char *str, int maxlen) { char strbuf[64]; int len = 0; len += snprintf(str + len, maxlen > len ? maxlen - len : 0, "digraph compositorexecution {\r\n"); len += snprintf(str + len, maxlen > len ? maxlen - len : 0, "ranksep=1.5\r\n"); len += snprintf(str + len, maxlen > len ? maxlen - len : 0, "rankdir=LR\r\n"); len += snprintf(str + len, maxlen > len ? maxlen - len : 0, "splines=false\r\n"); std::map> op_groups; int index = 0; for (const ExecutionGroup *group : system->m_groups) { len += snprintf(str + len, maxlen > len ? maxlen - len : 0, "// GROUP: %d\r\n", index); len += snprintf(str + len, maxlen > len ? maxlen - len : 0, "subgraph cluster_%d{\r\n", index); /* used as a check for executing group */ if (m_group_states[group] == EG_WAIT) { len += snprintf(str + len, maxlen > len ? maxlen - len : 0, "style=dashed\r\n"); } else if (m_group_states[group] == EG_RUNNING) { len += snprintf(str + len, maxlen > len ? maxlen - len : 0, "style=filled\r\n"); len += snprintf(str + len, maxlen > len ? maxlen - len : 0, "color=black\r\n"); len += snprintf(str + len, maxlen > len ? maxlen - len : 0, "fillcolor=firebrick1\r\n"); } else if (m_group_states[group] == EG_FINISHED) { len += snprintf(str + len, maxlen > len ? maxlen - len : 0, "style=filled\r\n"); len += snprintf(str + len, maxlen > len ? maxlen - len : 0, "color=black\r\n"); len += snprintf(str + len, maxlen > len ? maxlen - len : 0, "fillcolor=chartreuse4\r\n"); } for (NodeOperation *operation : group->m_operations) { sprintf(strbuf, "_%p", group); op_groups[operation].push_back(std::string(strbuf)); len += graphviz_operation( system, operation, group, str + len, maxlen > len ? maxlen - len : 0); } len += snprintf(str + len, maxlen > len ? maxlen - len : 0, "}\r\n"); index++; } /* operations not included in any group */ for (NodeOperation *operation : system->m_operations) { if (op_groups.find(operation) != op_groups.end()) { continue; } op_groups[operation].push_back(std::string("")); len += graphviz_operation( system, operation, nullptr, str + len, maxlen > len ? maxlen - len : 0); } for (NodeOperation *operation : system->m_operations) { if (operation->get_flags().is_read_buffer_operation) { ReadBufferOperation *read = (ReadBufferOperation *)operation; WriteBufferOperation *write = read->getMemoryProxy()->getWriteBufferOperation(); std::vector &read_groups = op_groups[read]; std::vector &write_groups = op_groups[write]; for (int k = 0; k < write_groups.size(); k++) { for (int l = 0; l < read_groups.size(); l++) { len += snprintf(str + len, maxlen > len ? maxlen - len : 0, "\"O_%p%s\" -> \"O_%p%s\" [style=dotted]\r\n", write, write_groups[k].c_str(), read, read_groups[l].c_str()); } } } } for (NodeOperation *op : system->m_operations) { for (NodeOperationInput &to : op->m_inputs) { NodeOperationOutput *from = to.getLink(); if (!from) { continue; } std::string color; switch (from->getDataType()) { case DataType::Value: color = "gray"; break; case DataType::Vector: color = "blue"; break; case DataType::Color: color = "orange"; break; } NodeOperation *to_op = &to.getOperation(); NodeOperation *from_op = &from->getOperation(); std::vector &from_groups = op_groups[from_op]; std::vector &to_groups = op_groups[to_op]; len += snprintf(str + len, maxlen > len ? maxlen - len : 0, "// CONNECTION: %p.%p -> %p.%p\r\n", from_op, from, to_op, &to); for (int k = 0; k < from_groups.size(); k++) { for (int l = 0; l < to_groups.size(); l++) { len += snprintf(str + len, maxlen > len ? maxlen - len : 0, R"("O_%p%s":"OUT_%p":e -> "O_%p%s":"IN_%p":w)", from_op, from_groups[k].c_str(), from, to_op, to_groups[l].c_str(), &to); len += snprintf( str + len, maxlen > len ? maxlen - len : 0, " [color=%s]", color.c_str()); len += snprintf(str + len, maxlen > len ? maxlen - len : 0, "\r\n"); } } } } const bool has_execution_groups = system->getContext().get_execution_model() == eExecutionModel::Tiled; len += graphviz_legend(str + len, maxlen > len ? maxlen - len : 0, has_execution_groups); len += snprintf(str + len, maxlen > len ? maxlen - len : 0, "}\r\n"); return (len < maxlen); } void DebugInfo::graphviz(const ExecutionSystem *system, StringRefNull name) { if (!COM_EXPORT_GRAPHVIZ) { return; } char str[1000000]; if (graphviz_system(system, str, sizeof(str) - 1)) { char basename[FILE_MAX]; char filename[FILE_MAX]; if (name.is_empty()) { BLI_snprintf(basename, sizeof(basename), "compositor_%d.dot", m_file_index); } else { BLI_strncpy(basename, (name + ".dot").c_str(), sizeof(basename)); } BLI_join_dirfile(filename, sizeof(filename), BKE_tempdir_session(), basename); m_file_index++; std::cout << "Writing compositor debug to: " << filename << "\n"; FILE *fp = BLI_fopen(filename, "wb"); fputs(str, fp); fclose(fp); } } } // namespace blender::compositor