DGMLWriter.h

#pragma once
 
#include <Foundation/Math/Color.h>
#include <Foundation/Strings/String.h>
 
class plFormatString;
 
class PL_FOUNDATION_DLL plDGMLGraph
{
public:
  enum class Direction : plUInt8
  {
    TopToBottom,
    BottomToTop,
    LeftToRight,
    RightToLeft
  };
 
  enum class Layout : plUInt8
  {
    Free,
    Tree,
    DependencyMatrix
  };
 
  enum class NodeShape : plUInt8
  {
    None,
    Rectangle,
    RoundedRectangle,
    Button
  };
 
  enum class GroupType : plUInt8
  {
    None,
    Expanded,
    Collapsed,
  };
 
  using NodeId = plUInt32;
  using PropertyId = plUInt32;
  using ConnectionId = plUInt32;
 
  struct NodeDesc
  {
    plColor m_Color = plColor::White;
    NodeShape m_Shape = NodeShape::Rectangle;
  };
 
  plDGMLGraph(Direction graphDirection = Direction::LeftToRight, Layout graphLayout = Layout::Tree);
 
  NodeId AddNode(plStringView sTitle, const NodeDesc* pDesc = nullptr);
 
  NodeId AddGroup(plStringView sTitle, GroupType type, const NodeDesc* pDesc = nullptr);
 
  void AddNodeToGroup(NodeId node, NodeId group);
 
  ConnectionId AddConnection(NodeId source, NodeId target, plStringView sLabel = {});
 
  PropertyId AddPropertyType(plStringView sName);
 
  void AddNodeProperty(NodeId node, PropertyId property, const plFormatString& fmt);
 
protected:
  friend class plDGMLGraphWriter;
 
  struct Connection
  {
    NodeId m_Source;
    NodeId m_Target;
    plString m_sLabel;
  };
 
  struct PropertyType
  {
    plString m_Name;
  };
 
  struct PropertyValue
  {
    PropertyId m_PropertyId;
    plString m_sValue;
  };
 
  struct Node
  {
    plString m_Title;
    GroupType m_GroupType = GroupType::None;
    NodeId m_ParentGroup = 0xFFFFFFFF;
    NodeDesc m_Desc;
    plDynamicArray<PropertyValue> m_Properties;
  };
 
  plHybridArray<Node, 16> m_Nodes;
 
  plHybridArray<Connection, 32> m_Connections;
 
  plHybridArray<PropertyType, 16> m_PropertyTypes;
 
  Direction m_Direction;
 
  Layout m_Layout;
};
 
class PL_FOUNDATION_DLL plDGMLGraphWriter
{
public:
  static plResult WriteGraphToFile(plStringView sFileName, const plDGMLGraph& graph);
 
  static plResult WriteGraphToString(plStringBuilder& ref_sStringBuilder, const plDGMLGraph& graph);
};