NFT-Art-Generator 项目教程

NFT-Art-Generator 项目教程

1. 项目目录结构及介绍

NFT-Art-Generator/
├── assets/
│   ├── layers/
│   └── metadata/
├── config/
│   ├── config.json
│   └── rarity.json
├── src/
│   ├── main.py
│   ├── utils.py
│   └── generator.py
├── README.md
├── requirements.txt
└── .gitignore

目录结构说明

• assets/: 存放项目的资源文件，包括图层文件和生成的NFT元数据。

  • layers/: 存放NFT的图层文件，每个图层对应一个文件夹。
  • metadata/: 存放生成的NFT元数据文件。

• config/: 存放项目的配置文件。

  • config.json: 项目的全局配置文件，包括输出路径、图层路径等。
  • rarity.json: 定义每个图层的稀有度配置。

• src/: 存放项目的源代码。

  • main.py: 项目的启动文件，负责调用生成器生成NFT。
  • utils.py: 包含一些工具函数，如文件处理、配置读取等。
  • generator.py: 核心生成器代码，负责根据配置生成NFT。

• README.md: 项目的说明文档，包含项目的基本介绍、安装步骤和使用说明。

• requirements.txt: 列出项目依赖的Python库。

• .gitignore: 指定Git版本控制系统忽略的文件和目录。

2. 项目的启动文件介绍

main.py

main.py 是项目的启动文件，负责初始化配置、调用生成器生成NFT，并输出结果。以下是主要代码片段：

import json
from src.generator import NFTGenerator

def main():
    # 读取配置文件
    with open('config/config.json', 'r') as f:
        config = json.load(f)
    
    # 初始化生成器
    generator = NFTGenerator(config)
    
    # 生成NFT
    generator.generate()

if __name__ == "__main__":
    main()

主要功能

1. 读取配置文件: 从 config/config.json 中读取项目的配置信息。
2. 初始化生成器: 根据配置信息初始化 NFTGenerator 对象。
3. 生成NFT: 调用生成器的 generate 方法生成NFT，并保存到指定路径。

3. 项目的配置文件介绍

config.json

config.json 是项目的全局配置文件，包含生成NFT所需的各种配置信息。以下是一个示例配置：

{
    "output_path": "assets/metadata",
    "layers_path": "assets/layers",
    "num_tokens": 10000,
    "metadata_format": "json"
}

配置项说明

• output_path: 生成的NFT元数据文件的输出路径。
• layers_path: 图层文件的存放路径。
• num_tokens: 需要生成的NFT数量。
• metadata_format: 生成的元数据文件格式，如 json 或 csv。

rarity.json

rarity.json 定义了每个图层的稀有度配置，用于控制每个图层在生成NFT时的出现概率。以下是一个示例配置：

{
    "background": {
        "color1": 0.5,
        "color2": 0.3,
        "color3": 0.2
    },
    "eyes": {
        "blue": 0.6,
        "green": 0.3,
        "red": 0.1
    }
}

配置项说明

• background: 背景图层的稀有度配置。
  • color1: 背景颜色1的出现概率为50%。
  • color2: 背景颜色2的出现概率为30%。
  • color3: 背景颜色3的出现概率为20%。
• eyes: 眼睛图层的稀有度配置。
  • blue: 蓝色眼睛的出现概率为60%。
  • green: 绿色眼睛的出现概率为30%。
  • red: 红色眼睛的出现概率为10%。

通过这些配置文件，用户可以灵活地控制NFT的生成过程，包括输出路径、图层路径、生成数量以及每个图层的稀有度。