CGAL库是一个强大的开源工具，以C++库的形式为开发者提供了高效可靠的几何算法。最近再一次使用到这个库，在新的环境下重新配置了一番，发现里面还是有很多丰富的、值得研究的功能的，遂记录下其在Windows下的安装与配置流程。

一、获取CGAL源码

我们可以在CGAL的GitHub仓库的release页面中下载到最新版本的源码压缩包CGAL-6.0.1.zip，将其解压，放在一个合适的位置。

然后需要添加一个环境变量CGAL_DIR，值为源码所在的路径，如D:\MyInclude\cpp\CGAL-6.0.1

二、安装Boost

Boost是CGAL的强制依赖项，二进制版本的Boost可以在SourceForge上找到，这里我们下载的是boost_1_86_0-msvc-14.1-64.exe，下载好后运行程序即可将Boost安装在你指定的位置，这里我将它安装在了D:\MyInclude\cpp\boost_1_86_0

安装好后我们需要设置两个环境变量分别指向库和头文件路径

• BOOST_LIBRARYDIR = D:\MyInclude\cpp\boost_1_86_0\lib64-msvc-14.3
• BOOST_INCLUDEDIR = D:\MyInclude\cpp\boost_1_86_0

一般来说设置这两个环境变量就足以让cmake找到Boost，如果在之后的编译中提示无法找到Boost，可以尝试添加一个额外的环境变量BOOST_ROOT = D:\MyInclude\cpp\boost_1_86_0

这将使cmake能够找到Boost。

此外，需将dll所在文件夹的路径（D:\MyInclude\cpp\boost_1_86_0\lib64-msvc-14.3）添加到PATH环境变量中

tip：上述路径请根据自身情况调整

三、安装GMP和MPFR

GMP和MPFR同样是CGAL所必需的依赖项，在CGAL的release页面我们可以找到作者提供的预编译版本（CGAL-6.0.1-win64-auxiliary-libraries-gmp-mpfr.zip）下载后解压到CGAL的目录中，这样cmake便能够自动检测这些依赖项。

tip：CGAL目录下有文件夹auxiliary，这个压缩包解压出来后也是一个文件夹auxiliary，将其移动过去本质上就是把这个文件夹里的东西放到CGAL\auxiliary文件夹中。

此时，我们便完成了CGAL及其所有必需依赖项的安装。

四、通过CMake使用CGAL

通过在CMakeLists.txt中添加如下语句，便可将程序与CGAL链接起来

find_package(CGAL REQUIRED)
add_executable(my_executable my_source_file.cpp)
target_link_libraries(my_executable CGAL::CGAL)

CGAL库中的其他组件也是类似地进行链接，如CGAL_core

find_package(CGAL REQUIRED COMPONENTS Core)
target_link_libraries(my_executable CGAL::CGAL CGAL::CGAL_Core)

五、使用CGAL+Qt6的示例

这里展示了一个使用CGAL和Qt6实现的一些GUI功能的程序演示（前提是安装了Qt6）

CMakeLists.txt：

cmake_minimum_required(VERSION 3.20.0)
project(Surface_mesh_Examples)

#CGAL_Qt6 is needed for the drawing.
find_package(CGAL REQUIRED OPTIONAL_COMPONENTS Qt6)

#create the executable of the application
create_single_source_cgal_program("draw_surface_mesh.cpp")

if(CGAL_Qt6_FOUND)
  #link it with the required CGAL libraries
  target_link_libraries(draw_surface_mesh PUBLIC CGAL::CGAL_Basic_viewer)
endif()

drawsurfacemesh.cpp：

#include <CGAL/Simple_cartesian.h>
#include <CGAL/Surface_mesh.h>
#include <CGAL/draw_surface_mesh.h>
#include <fstream>
 
typedef CGAL::Simple_cartesian<double>                       Kernel;
typedef Kernel::Point_3                                      Point;
typedef CGAL::Surface_mesh<Point>                            Mesh;
 
int main(int argc, char* argv[])
{
  const std::string filename = (argc>1) ? argv[1] : CGAL::data_file_path("meshes/elephant.off");
 
  Mesh sm;
  if(!CGAL::IO::read_polygon_mesh(filename, sm))
  {
    std::cerr << "Invalid input file: " << filename << std::endl;
    return EXIT_FAILURE;
  }
 
  // Internal color property maps are used if they exist and are called "v:color", "e:color" and "f:color".
  auto vcm = sm.add_property_map<Mesh::Vertex_index, CGAL::IO::Color>("v:color").first;
  auto ecm = sm.add_property_map<Mesh::Edge_index, CGAL::IO::Color>("e:color").first;
  auto fcm = sm.add_property_map<Mesh::Face_index>("f:color", CGAL::IO::white() /*default*/).first;
 
  for(auto v : vertices(sm))
  {
    if(v.idx()%2)
    { put(vcm, v, CGAL::IO::black()); }
    else
    { put(vcm, v, CGAL::IO::blue()); }
  }
 
  for(auto e : edges(sm))
  { put(ecm, e, CGAL::IO::gray()); }
 
  put(fcm, *(sm.faces().begin()), CGAL::IO::red());
 
  // Draw!
  CGAL::draw(sm);
 
  return EXIT_SUCCESS;
}

编译生成后，注意需在生成的可执行程序draw_surface_mesh.exe所在路径下执行以下命令，将此程序所需的Qt6的dll文件自动复制过来

windeployqt.exe ./draw_surface_mesh.exe

并手动将gmp的dll文件gmp-10.dll复制过来

然后运行程序便有如下GUI显示

在日常开发中，数据序列化和配置管理几乎无处不在。YAML和JSON作为两种主流的数据交换格式，各有特色和适用场景。本文将从格式规范入手，深入解析这两种数据格式的特点。

一、JSON格式解析

JSON格式规范

JSON（JavaScript Object Notation）是一种轻量级的数据交换格式，基于JavaScript的对象字面量语法，但完全独立于编程语言。

文件后缀为.json

JSON语法规则

• 数据结构是键值对
• 键必须用双引号包裹
• 值可以是任意 JSON 支持的数据类型
• 键值对之间用逗号分隔
• 对象用大括号 {}，数组用方括号 []
• 字符串只能用双引号，不能用单引号
• 不支持注释
• 不能有多余的逗号

基本数据类型

JSON支持六种基本数据类型：

1. 字符串（String）

{
    "name": "John Doe",
    "description": "这是一个包含中文的字符串",
    "escaped": "包含\"引号\"和\\反斜杠的字符串"
}

2. 数字（Number）

{
    "integer": 42,
    "negative": -17,
    "float": 3.14159,
    "scientific": 1.23e-4,
    "zero": 0
}

3. 布尔值（Boolean）

{
    "enabled": true,
    "disabled": false
}

4. 空值（null）

{
    "empty_value": null
}

5. 对象（Object）

{
    "person": {
        "name": "Alice",
        "age": 30,
        "address": {
            "city": "Beijing",
            "country": "China"
        }
    }
}

6. 数组（Array）

{
    "numbers": [1, 2, 3, 4, 5],
    "mixed": ["string", 42, true, null],
    "nested": [
        {"id": 1, "name": "Item 1"},
        {"id": 2, "name": "Item 2"}
    ]
}

JSON的优势与局限

优势：

• 语法简单，容易读写
• 生态好，几乎所有语言都支持
• 传输体积小，效率高
• 和 JavaScript 天然兼容

局限：

• 不能写注释，配置文档化不方便
• 类型有限，比如没有日期、二进制
• 不支持引用和继承
• 大型配置文件可读性较差

二、YAML格式深度解析

YAML格式规范

YAML（YAML Ain't Markup Language）是一种人类友好的数据序列化标准，设计目标是既容易被人类阅读，又容易被机器解析。

文件后缀为.yaml或.yml

YAML语法规则

• 使用缩进表示层级关系（通常为2个空格，不允许使用Tab）
• 键值对通过冒号 : 分隔，冒号后需有空格
• 列表项以短横线 - 开头，后跟空格
• 字符串可不加引号，包含特殊字符时可用单引号或双引号
• 支持注释，使用 # 表示
• 支持多行字符串（| 保留换行，> 折叠换行）
• 支持锚点（&）和引用（*）
• 支持合并键（<<）
• 支持多文档（用 --- 分隔）
• 对缩进敏感，缩进不一致会导致解析错误

基本语法特性

1. 缩进表示层次结构

database:
  host: localhost
  port: 5432
  credentials:
    username: admin
    password: secret123

2. 列表表示

# 使用短横线表示列表项
fruits:
  - apple
  - banana
  - orange

# 或者使用行内格式
colors: [red, green, blue]

# 嵌套列表
shopping_list:
  - name: groceries
    items:
      - milk
      - bread
      - eggs
  - name: electronics
    items:
      - phone
      - laptop

3. 标量数据类型

# 字符串
name: John Doe
description: "包含特殊字符的字符串"
multiline: |
  这是一个多行字符串
  第二行内容
  第三行内容

folded_string: >
  这是一个折叠字符串，
  多行会被合并成一行，
  除非有空行。

# 数字
age: 30
price: 99.99
scientific: 1.23e-4

# 布尔值
enabled: true
disabled: false
yes_value: yes
no_value: no

# 空值
empty_value: null
tilde_null: ~

# 日期时间
date: 2024-01-15
datetime: 2024-01-15T10:30:00Z

4. 复杂数据结构

# 映射（字典）
person:
  name: Alice
  age: 25
  hobbies:
    - reading
    - swimming
  address:
    street: 123 Main St
    city: Beijing

# 锚点和引用
defaults: &default_settings
  timeout: 30
  retries: 3

development:
  <<: *default_settings
  debug: true

production:
  <<: *default_settings
  debug: false
  timeout: 60

YAML高级特性

1. 注释支持

# 这是一个注释
database:
  host: localhost  # 行尾注释
  port: 5432
  # 可以在任何地方添加注释
  name: mydb

2. 多文档支持

---
# 第一个文档
name: Document 1
type: config
---
# 第二个文档
name: Document 2
type: data
...

3. 类型标记

# 显式指定类型
version: !!str 1.2
count: !!int 100
enabled: !!bool true

YAML的优势与局限

优势：

• 极佳的人类可读性
• 支持注释和文档化
• 支持复杂数据结构和引用
• 多种数据类型支持
• 适合配置文件和数据交换

局限：

• 对缩进极其敏感，容易出错
• 解析器实现复杂，速度略慢
• 某些实现有安全隐患
• 生态和普及度不如 JSON

三、YAML与JSON结构对比

小结：

实际开发中，配置文件推荐用 YAML，数据交换和接口通信还是首选 JSON。YAML 写起来更顺手，但要注意缩进和格式，JSON 则更适合机器处理和网络传输。当然最终选择那种，更重要的还是依照个人乃至团队的习惯。

参考链接：

• JSON 官方规范
• YAML 官方文档
• YAML vs JSON 简明对比（英文）

首先我们进入AdobeGenp的GitHub页面，在Releases中将最新的可执行程序下载下来。

(2025.06.03更新）原仓库已被删除，现可从https://github.com/Cur10s1tyByt3/AdobeGenP-Latest下载程序。

一、安装Adobe Creative Cloud

首先在官网下载Adobe Creative Cloud（https://creativecloud.adobe.com/zh-Hans）（可能需要科学访问）

安装，过程中需要账户，使用邮箱注册即可

安装过程中取消勾选AGS

安装结束进入主界面后，点击左上角菜单 -> 文件 -> 首选项，在常规中将设置的三个条目取消勾选

确认后点击完成。

二、破解Adobe Creative Cloud

安装好后我们可以看到里面的大多数应用程序都是“免费试用”和“购买”两个选项，且点击“免费试用”依然会跳转到购买界面

此时我们将程序关闭，由于我们之前取消了对”关闭Creative Cloud后在后台运行它”的选项，确保了它没有停留在后台运行。

打开我们的破解程序Adobe GenP，注意如果它被识别为威胁并删除，请在Windows安全中心将其还原。

请确保你的Adobe Creative Cloud是否安装在这里显示的默认路径下，如若不然，点击“Path”选择你所安装的路径。确认路径后，点击“Search”找到Adobe Creative Cloud，然后点击“Patch CC”。

当显示“All files patched”时表示已经破解完成。

此时打开Adobe Creative Cloud就会发现里面的程序均可直接安装。

三、破解应用程序

在安装程序之前，可以点击右上角的头像，在首选项 -> 应用程序中修改程序安装位置。

这里以Photoshop为例，首先点击安装Photoshop，等待其下载安装完成。

安装好后如直接打开程序会弹出开始免费试用的窗口。

但我们想要的不是短暂的试用。此时将应用程序关闭，打开Adobe GenP。

点击“Path”选择你的Photoshop的安装路径，然后点击“Search”。

此时会发现它已经成功找到了Photoshop的相关内容，点击“Patch”运行破解。

待其运行结束即破解完成，此时打开Photoshop就会发现可以直接使用且不会弹出免费试用提示了。

由于最近正好想将环境中的Gismo库更新到最新版，需要将Gismo库重新编译一下，正好写下系列文章对Gismo库在不同环境下的安装与配置过程进行简单的介绍。

一、环境需求

1. Visual Studio 2022（2017、2019亦可，本文用以2022版做演示）
2. CMake 于CMake官网（https://cmake.org/download）下载最新版中Windows x64安装程序并执行安装步骤即可

注意：可以在终端中输出cmake --version以检查是否在安装过程中将CMake添加到环境变量中，如若不然，需要在CMake安装路径下找到cmake.exe所在的bin目录，将其添加到环境变量中，应用后重启终端进行检测。

二、源代码获取

我们首先进入Gismo库的GitHub页面（https://github.com/gismo/gismo） 点击右上角Code按钮弹出下拉页面，如果环境中安装了git，可以复制下红框中的链接，在一个指定的文件夹（源代码将下载在这个文件夹中）中打开终端，并输入

git clone https://github.com/gismo/gismo.git

其中中最后的链接即为刚才复制的链接。 但是这个过程可能由于网络问题导致clone失败，如果环境中未安装git或者使用git无法clone的，可以点击最后一个红框中的Download ZIP下载源代码压缩文件，下载后解压出来即可。 克隆下来的文件夹名称为gismo，下载压缩包解压出来的文件夹名称为gismo-stable，我这里是执行克隆过程得到的源代码文件夹gismo，下面统一以此进行讲述，如理解不便，可自行将文件夹gismo-stable名称修改为gismo.

三、Gismo库的构建与安装

首先要记下你刚刚获取的源代码的储存路径，我这里是D:\MyProject\GitHub\gismo. 在任意路径下创建一个文件夹gismo-build，这里将储存后续构建的过程文件，建议创建在源代码文件夹的附近便于你能找到它，我这里是D:\MyInclude\cpp\LibBuild_workspace\gismo-build.

1. 使用cmake-gui生成

我们打开刚才CMake(cmake-gui)，分别填入这两个路径，并点击左下角的Configure 在弹出窗口的第一个框中选择生成器（如VS 2022选择Visual Studio 17 2022），点击Finish. 经过短暂等待得到如图所示的CMake缓存 这里注意，我们首先要将的变量CMAKE_BUILD_TYPE的值修改为Release（当然如果你需要构建Debug模式的库修改为Debug即可），然后取消GISMO_BUILD_EXAMPLES的勾选（如果勾选了则会额外构建一些实例程序，会耗费更多的时间）。 还有一个可选择性修改的变量CMAKE_INSTALL_PREFIX，这个是后续进行安装时的安装路径，可以选择使用它的默认路径，也可根据自己喜好进行修改，这里我修改为了D:\MyInclude\cpp\gismo\Release. 修改好后点击Generate生成 待下方输出框中出现Generating done即为生成完毕

2. 库的构建

在gismo-build文件夹中打开终端（请回忆一下它的路径），当然如果你不知道如何打开终端，你可以尝试一下在文件夹中空白处点击鼠标右键，在下拉选项中点击“在终端中打开” 在终端中输入命令

cmake --build . --config Release

回车执行 接下来耐心等待即可，这个过程需要一定的时间

3. 库的安装

构建完毕后执行命令进行安装

cmake --install . --config Release

此时进入你的安装路径中会发现之前的空文件夹中多出了四个文件夹，gismo库已成功安装

• bin`中包含gismo的dll文件，如果前面的生成过程中勾选了GISMOBUILDEXAMPLES，则会包含所有示例项目对应的可执行程序（.exe`文件）
• include`中包含gismo`的所有头文件
• lib`中包含gismo的lib文件和一些cmake`文件
• share\中包含示例程序的数据文件，如果没有编译示例程序则无需用到这里面的文件

最后，如果你在前面将gismo的安装路径修改为了自定义的路径，且后续计划用CMake来配置使用gismo的项目，那么你还需要设置一个环境变量gismo_DIR，值为lib`的路径，如D:\MyInclude\cpp\gismo\Release\lib,这是为了让你的CMake项目能够通过这个路径下的cmake文件找到gismo`库。（如果你只是在VS中使用，可以无需进行这一步）

注意：修改（添加）了环境变量后，需要开启一个新的终端才能在里面应用修改（修改前开启的终端中该环境变量仍是原值）

终端中查看环境变量

• 在cmd中，执行echo %变量名%，如echo %gismo_DIR%
• 在powershell中，执行$env:变量名，如$env:gismo_DIR

四、如何将Gismo库配置到项目中

1. 直接在VS项目属性中配置

创建一个VS项目，添加一个源文件，并在其中写入简单的测试代码

#include <gismo.h>

using namespace gismo;

int main(int, char**)
{
    gsInfo.precision(3);
    gsKnotVector<>   kv(-1, 0, 3, 3, 1);
    gsBSplineBasis<> bsp(kv);
    gsInfo << bsp.detail() << "\n";
    bsp.uniformRefine();
    gsInfo << bsp.detail() << "\n";
    return 0;
}

注意要将红框中的配置设置为Release模式，因为我们的gismo库也是在Release模式下构建的，如果想在Debug模式下使用则需构建Debug模式的库 可以看到代码中充斥着各种报错，因为我们还没有将gismo库配置进来 右键点击左边的解决方案gismoTest，下拉框中点击属性，在属性页中依次进行以下三项修改：

1. “C/C++” -> “常规” -> “附加包含目录” 中添加include\gismo`路径，这里为D:\MyInclude\cpp\gismo\Release\include\gismo`
2. “链接器” -> “常规” -> “附加库目录” 中添加lib`路径，这里为D:\MyInclude\cpp\gismo\Release\lib`
3. “链接器” -> “输入” -> “附加依赖项” 中添加gismo.lib

修改完属性后点击确定，并将gismo的bin`目录中的gismo.dll复制到此项目源文件所在路径下（即main.cpp`所在路径） 此时程序便能够成功运行

注意：附加依赖项中可以添加gismo.lib或gismo_static.lib，分别表示动态库和静态库，如果添加动态库则需要复制gismo.dll到项目中，添加静态库则不需要

2. 用CMake配置使用gismo的项目

引入

主观上讲我更加喜欢用CMake来配置项目，对我来讲这可能更加清晰（仅代表个人），当然如果想要理解后面配置过程，可能需要有一定的CMake基础。 CMake可以在终端中执行，也有可视化窗口（cmake-gui），一些常见编辑器也有相关插件适配（如 VSCode），其实我更推荐 VSCode+CMake插件 的方案来配置项目（有一些更加便捷的按钮），考虑到普适性，这里我在终端中执行CMake命令。

配置过程

首先在任意一个你喜欢的位置新建一个文件夹，在文件夹中新建两个文件CMakeLists.txt、main.cpp 注意：第一个文件CMakeLists.txt文件名必须完全一致，第二个文件main.cpp为项目源文件，文件名可以修改

在文件CMakeLists.txt中写入如下内容

cmake_minimum_required(VERSION 3.20.0)
project(gismoTest) #项目名

set(EXECUTABLE_OUTPUT_PATH ${PROJECT_SOURCE_DIR}/bin) #设置可执行程序输出路径

find_package(gismo REQUIRED) #搜索gismo库
if(gismo_FOUND)
    message(STATUS "gismo found: ${gismo_DIR}")
    include_directories(${GISMO_INCLUDE_DIRS}) #设置附加包含目录
    link_directories(${GISMO_LIBRARY_DIR}) #设置附加库目录
endif()

add_executable(gismoTest main.cpp)
target_link_libraries(gismoTest PUBLIC gismo) #将目标链接到gismo动态库，如果链接静态库则将gismo修改为gismo_static

在文件main.cpp中写入测试代码

#include <gismo.h>

using namespace gismo;

int main(int, char**)
{
    gsInfo.precision(3);
    gsKnotVector<>   kv(-1, 0, 3, 3, 1);
    gsBSplineBasis<> bsp(kv);
    gsInfo << bsp.detail() << "\n";
    bsp.uniformRefine();
    gsInfo << bsp.detail() << "\n";
    return 0;
}

两个文件修改并保存后，在此路径中打开终端，依次执行

cmake -B build
cmake --build build --config Release

此时会发现文件夹中新增了两个文件夹build`和bin`，将gismo的bin`目录中的gismo.dll复制到此项目的bin\Release`中（即gismoTest.exe所在路径），继续在终端中执行

cd bin\Release
.\gismoTest.exe

即可成功运行项目生成的可执行程序