Heap History Viewer 使用与配置指南

1. 项目目录结构及介绍

Heap History Viewer 项目的主要目录结构如下：

heap_history_viewer/
├── .gitignore
├── CMakeLists.txt
├── HeapVizGL.pro
├── HeapVizGL_tests.pro
├── LICENSE
├── README.md
├── active_pages.vert
├── activeregioncache.cpp
├── activeregioncache.h
├── activeregionsdiagramlayer.cpp
├── activeregionsdiagramlayer.h
├── address_shader.vert
├── addressdiagramlayer.cpp
├── addressdiagramlayer.h
├── conan.cmake
├── displayheapwindow.cpp
├── displayheapwindow.h
├── event_shader.vert
├── eventdiagramlayer.cpp
├── eventdiagramlayer.h
├── glheapdiagram.cpp
├── glheapdiagram.h
├── glheapdiagramlayer.cpp
├── glheapdiagramlayer.h
├── glsl_simulation_functions.cpp
├── glsl_simulation_functions.h
├── grid.frag
├── grid.vert
├── gridlayer.cpp
├── gridlayer.h
├── heap.json
├── heapblock.cpp
├── heapblock.h
├── heapblockdiagramlayer.cpp
├── heapblockdiagramlayer.h
├── heaphistory.cpp
├── heaphistory.h
├── heapvizwindow.cpp
├── heapvizwindow.h
├── heapvizwindow.ui
├── heapwindow.cpp
├── heapwindow.h
├── json.hpp
├── linearbrightnesscolorscale.cpp
├── linearbrightnesscolorscale.h
├── main.cpp
├── resource.qrc
├── simple.frag
├── simple.vert
├── testactiveregioncache.cpp
├── testactiveregioncache.h
├── testdisplayheapwindow.cpp
├── testdisplayheapwindow.h
├── transform3d.cpp
├── transform3d.h
├── ui_heapvizwindow.h
├── vertex.cpp
└── vertex.h

• README.md：项目的说明文档，包含了项目的基本信息和如何使用项目。
• LICENSE：项目的许可证文件，本项目采用的是开源许可证。
• CMakeLists.txt：CMake 的配置文件，用于构建项目。
• HeapVizGL.pro：Qt 的项目文件，与 CMake 配合使用，用于构建项目。
• heap.json：示例数据文件，包含了堆历史数据。

其余文件为项目源代码，包括头文件和实现文件，以及一些辅助脚本和测试代码。

2. 项目的启动文件介绍

项目的启动文件为 main.cpp，这是程序的入口点。以下是一个简化的 main.cpp 文件内容：

#include <QApplication>
#include "heapvizwindow.h"

int main(int argc, char *argv[])
{
    QApplication a(argc, argv);
    HeapVizWindow w;
    w.show();
    return a.exec();
}

这段代码首先包含了 Qt 的应用程序类 QApplication 和自定义的 HeapVizWindow 类。在 main 函数中，创建了一个 QApplication 实例和一个 HeapVizWindow 实例，然后显示窗口，并进入 Qt 的事件循环。

3. 项目的配置文件介绍

项目的配置文件主要是 CMakeLists.txt，它用于配置 CMake 构建系统。以下是一个简化的 CMakeLists.txt 文件内容：

cmake_minimum_required(VERSION 3.10)
project(HeapHistoryViewer)

set(CMAKE_CXX_STANDARD 11)

find_package(Qt5 COMPONENTS Widgets REQUIRED)
find_package(Qt5 COMPONENTS OpenGL REQUIRED)
find_package(Qt5 COMPONENTS Concurrent REQUIRED)

include_directories(${CMAKE_CURRENT_SOURCE_DIR}/include)

add_executable(HeapHistoryViewer main.cpp heapvizwindow.cpp heapwindow.cpp)

target_link_libraries(HeapHistoryViewer Qt5::Widgets Qt5::OpenGL Qt5::Concurrent)

这段代码设置了项目所需的最小 CMake 版本，定义了项目名称，设置了 C++ 标准，找到了 Qt5 的相关组件，并包含了必要的目录。之后，它创建了一个可执行文件 HeapHistoryViewer，链接了必要的 Qt 库。

通过上述介绍，用户可以了解到项目的基本结构，启动方式以及如何配置构建系统。