NodeGraphCore.h

Go to the documentation of this file.

/**
 * @file NodeGraphCore.h
 * @brief Core data structures for generic node graph system
 * @author Olympe Engine
 * @date 2026-02-18
 *
 * @details
 * Provides generic data structures for node-based graphs that can be reused
 * across multiple editors (BehaviorTree, HFSM, Animation, Blueprint).
 * All code strictly compliant with C++14 standard.
 */
 
#pragma once
 
#include <cstdint>
#include <string>
#include <vector>
#include <map>
#include "../vector.h"
 
namespace Olympe {
namespace NodeGraph {
 
// ============================================================================
// ID Types
// ============================================================================
 
struct GraphId {
    uint32_t value = 0;
    
    bool operator==(const GraphId& other) const { return value == other.value; }
    bool operator!=(const GraphId& other) const { return value != other.value; }
    bool operator<(const GraphId& other) const { return value < other.value; }
};
 
struct NodeId {
    uint32_t value = 0;
    
    bool operator==(const NodeId& other) const { return value == other.value; }
    bool operator!=(const NodeId& other) const { return value != other.value; }
    bool operator<(const NodeId& other) const { return value < other.value; }
};
 
struct PinId {
    uint32_t value = 0;
    
    bool operator==(const PinId& other) const { return value == other.value; }
    bool operator!=(const PinId& other) const { return value != other.value; }
    bool operator<(const PinId& other) const { return value < other.value; }
};
 
struct LinkId {
    uint32_t value = 0;
    
    bool operator==(const LinkId& other) const { return value == other.value; }
    bool operator!=(const LinkId& other) const { return value != other.value; }
    bool operator<(const LinkId& other) const { return value < other.value; }
};
 
// ============================================================================
// Basic Structures
// ============================================================================
 
using Vector2 = Vector; // Assuming Vector2 is defined in a common math library
/*struct Vector2 {
    float x = 0.0f;
    float y = 0.0f;
    
    Vector2() = default;
    Vector2(float inX, float inY) : x(inX), y(inY) {}
};/**/
 
// ============================================================================
// Node Data
// ============================================================================
 
struct NodeData {
    NodeId id;
    std::string type;
    std::string name;
    Vector2 position;
    std::map<std::string, std::string> parameters;
    std::vector<NodeId> children;
    NodeId decoratorChild;
};
 
// ============================================================================
// Pin Data
// ============================================================================
 
struct PinData {
    PinId id;
    NodeId nodeId;
    std::string type;
    std::string name;
};
 
// ============================================================================
// Link Data
// ============================================================================
 
struct LinkData {
    LinkId id;
    PinId fromPin;
    PinId toPin;
};
 
// ============================================================================
// Editor State
// ============================================================================
 
struct EditorState {
    float zoom = 1.0f;
    Vector2 scrollOffset;
    std::vector<NodeId> selectedNodes;
    std::string layoutDirection = "TopToBottom";
};
 
// ============================================================================
// Layout Direction
// ============================================================================
 
enum class LayoutDirection : uint8_t {
    TopToBottom = 0,
    BottomToTop = 1,
    LeftToRight = 2,
    RightToLeft = 3
};
 
// ============================================================================
// Auto-Layout Configuration
// ============================================================================
 
struct AutoLayoutConfig {
    LayoutDirection direction = LayoutDirection::TopToBottom;
    float horizontalSpacing = 150.0f;  // Spacing between sibling nodes
    float verticalSpacing = 100.0f;    // Spacing between tree levels
    float nodeWidth = 120.0f;          // Estimated node width
    float nodeHeight = 60.0f;          // Estimated node height
    float paddingX = 50.0f;            // Left/right padding
    float paddingY = 50.0f;            // Top/bottom padding
};
 
} // namespace NodeGraph
} // namespace Olympe