导入导出

简介

实现Pangu资源与导入导出，有多种使用场景。

使用场景

  1. Cook流程中：Cook完需要把开天生产的内容导入到盘古来，以及将盘古的内容导出给开天用
  2. 验证/排查Cook问题：Cook结束后发现地图上没有显示正确的效果，可先通过导入操作查看Cook是否产生了对应文件
  3. 多人协作时可以将Cook的结果提交，此时其他人可以通过更新Cook结果并导入获取到别人Cook的结果。
  4. 比如植被二次编辑器，可能会想删除部分内容
  5. 在盘古之外完成的数据转发，需要重新接入到盘古来

等等其他使用场景，可自行挖掘

资源介绍

本节主要介绍导入导出时涉及到的相关文件

主要资源

盘古资源UE内部资产路径编辑工具导入导出归属类型UE资产类型
Layout/eng_layout.pngT_x%d_y%d_LayoutLayoutLayoutTexture
Layout/eng_mask.pngT_x%d_y%d_MaskMaskLayout|MaskTexture
Layout/eng_biome.pngT_x%d_y%d_BiomeBiomeBiomeTexture
Layout/Edit_Foliage.pngT_x%d_y%d_Edit_FoliageMask|BiomeMask|BiomeTexture
Layout/proxy_heightmap.pngAgent_x%d_y%dUE LandscapeLandscapeHeightActor
Layout/AgentLayers/proxy_{$Layer}.pngAgent_x%d_%dUE LandscapeLayoutActor->Layer[{$Layer}]
Layout/{$Name}.pngT_x%d_y%d_{$Name}MaskMaskTexture
Layer/eng_{$WeightMapLayer}.pngTile_x%d_y%dUE LandscapeLayout|LayerActor->WeightLayer
Layer/hou_{$WeightMapLayer}.pngTile_x%d_y%dUE LandscapeLayout|LayerActor->WeightLayer
Layer/eng_HeightMap.pngTile_x%d_y%dUE LandscapeLayout|LandscapeHeightActor->Layer
Layer/hou_HeightMap.pngTile_x%d_y%dUE LandscapeLayout|LandscapeHeightActor->Layer

盘古所有可导出的资源都可以导入。

bgeo资源文件存在于Tile/k2p/路径下，此类资源不限路径不限类型，BGeo资源导入会介绍。

Fbx资源文件存在于PcgMaps/FBX 路径下，此类资源为开天Cook所用。

全局配置文件

全局配置文件存在于$Map/V00/LevelConfig，对于单个地图仅保存一份。

盘古配置文件用途资源导出类型导出时机
Biomesys/biome_info.jsonBiome工具中描述笔刷分布的配置文件Biome导出Biome笔刷配置
Cliffsys/cliff_info.jsonCliff工具中描述笔刷分布的配置文件Cliff保存Cliff笔刷配置
config/world_info.jsonPanguWorldSetting导出内容BaseCookingInfoCook前导出
Hillsys/hillsys-parms.json暂不使用Hill
Layout/layoutsys_landtypes_info.jsonLayout工具中描述笔刷分布的配置文件Layout保存Layout笔刷配置
Masksys/mask_info.jsonMask工具中描述笔刷分布的配置文件Mask保存Mask笔刷配置
Masksys/{$BrushName}.jsonMask工具中自定义的笔刷Mask保存自定义笔刷分布
Proxysys/proxy_comp_info.jsonProxy工具中对于Mesh组件的描述ProxyProxy导出
{$Splinesys}/PanguCurves/p2k/{$SplineType}.{$SplineName},spline.json各个曲线工具的曲线数据文件Spline曲线数据保存

资源导入

总览

编辑器入口

通过Pangu窗口-小地图-选中地块右键import菜单进入导入界面。 image-20240412140811266

蓝图入口

通过PanguGraph-Pangu Import Res节点-In Import Types参数设置 image-20240412140844590

盘古资源导入

image-20240412141123034

盘古资源导入参数

  • Pangu Import Types：
导入类型释义路径
Real Landscape Height导入真实地形数据Split/Tile/panguoutput
Real Landscape Height (Cooked)导入真实地形数据Split/Tile/k2p
Agent Landscape Height导入代理地形数据Split/Tile/panguoutput
Material Refresh (Cooked)刷新材质Split/Tile/k2p
Weight Map Layer导入权重数据Split/Tile/panguoutput
Weight Map Layer (Cooked)导入权重数据Split/Tile/k2p
External Layer导入额外层权重数据Split/Tile/panguoutput
External Layer (Cooked)导入额外层权重数据Split/Tile/k2p
Render Layer (Cooked)导入渲染层权重数据Split/Tile/k2p
Layout Color导入Layout贴图数据Split/Tile/panguoutput
Layout Color Info导入Layout配置数据LevelConfig/layoutsys
Biome Color导入Biome贴图数据Split/Tile/panguoutput
Biome Color Info导入Biome配置数据LevelConfig/biomesys
Cliff Color导入Cliff贴图数据Split/Tile/panguoutput
Cliff Color Info导入Cliff配置数据LevelConfig/cliffsys
Mask Color导入Mask贴图数据Split/Tile/panguoutput
Mask Color (Cooked)导入Mask贴图数据Split/Tile/k2p
Mask Color Info导入Mask配置数据LevelConfig/masksys
Custom Brush Color导入CustomBrush贴图数据Split/Tile/panguoutput
Custom Brush Color (Cooked)导入CustomBrush贴图数据Split/Tile/k2p
Custom Brush Color Info导入CustomBrush配置数据LevelConfig/CustomBrushsys
Custom Real Landscape Height自定义导入真实地形数据Split/Tile/panguoutput
Custom Real Landscape Height (Cooked)自定义导入真实地形数据Split/Tile/k2p
Custom Agent Landscape Height自定义导入代理地形数据Split/Tile/panguoutput
Custom Weight Map Layer自定义导入权重数据Split/Tile/panguoutput
Custom Weight Map Layer (Cooked)自定义导入权重数据Split/Tile/k2p
  • Cleanup Unreferenced
    • 清理没有引用的材质（材质由盘古导入后按照给定权重自动生成）
  • Spline Types
    • 导入曲线系统的曲线数据 $SplineType.$SplineName.spline.json

当选中了“Custom Real Landscape Height”、“Custom Real Landscape Height (Cooked)”、“Custom Agent Landscape Height”、“Custom Weight Map Layer”或“Custom Weight Map Layer (Cooked)”会显示相应的可配置EditLayer选项，通过名字限定导入的EditLayer。

image-20240412141123034

BGeo资源导入

BGeo 参数介绍

  • BGeoImportAction:
    Action释义
    None不执行任何行为
    Replace替换，导入新的BGeo文件，原先的数据将全部删除。
    Add新增，导入新的BGeo文件，但保留原来的数据。
    Cleanup删除，并不导入BGeo文件，删除全部已经导入的BGeo Actor。
    Cleanup Source File删除源文件，删除路径下对应的BGeo文件，但并不删除已经导入的Actor。
    Cleanup All删除源文件及导入内容。
  • All Bgeo Type
    • 所有的子系统类型，对于BGeo Type下没有的类型也可以通过勾选该项导入。
  • Include Global BGeo
    • 同时导入全局目录下（$HoudiniMaps/V00/Whole）的BGeo文件
  • Cleanup Unreferenced
    • 清理已经导入的资产（Mesh等由Houdini导入生成的资产）
  • BGeo Types
    • 类型与子系统相对应，通常记录了盘古子系统对应的BGeo。 注意：子系统相关的BGeo导入需要叶子文件夹名严格相等（大小写不论）。
  • Additional BGeo Types
    • 此项通常用于扩展BGeo Types，对于BGeo Type中不包含的BGeo类型，您可以手动输入。 如果您通过同一个工具生产出各种不同的资产并且期望能够分别处理，你可以通过在此处分别导入处理。

不同BGeo类型判断依据

通过描述文件中的 Tools字段来判断BGeo类型，当Tools字段中包含多项时，会使用第一个类型作为BGeo类型。作为兼容手段，如果Tools中不包含任何类型，则会使用文件夹名作为BGeo类型。

Source Import面板其他行为

  • Import：导入执行按钮
  • FixUntypedActor：修复Actor的类型错误，对于已经导入的BGeoActor，如果当前不属于任意BGeo类型，则会按照当前Actor所在文件夹给予类型。
  • Cancel：关闭窗口

资源导出

总览

编辑器入口

通过Pangu窗口-小地图-选中地块右键Export，唤出Export面板进行导出。 EditorExport

蓝图入口

EditorExport

导出面板

EditorExport

  • PanguExportTypes
类型释义路径
BaseCookingInfoCook必要基础信息Kaitian/CookInput/cookconfig/ + Project/Saved/.Pangu/KaiTian/ProjectConfig/project_info.json + LevelConfig/Config/World_info.json
RealLandscape真实地形数据Tile/panguoutput/layer
AgentLandscape代理地形数据Tile/panguoutput/agent
ExternalLayer地形额外权重层数据 (准备弃用)Tile/panguoutput/exlayer
RenderLayer地形渲染层数据Tile/panguoutput/render
LayoutRelatedLayout + Agent + Mask (准备弃用)
LayoutLayout贴图数据Tile/panguoutput/layoutsys
BiomeBiome贴图数据Tile/panguoutput/biomesys
CliffCliff贴图数据Tile/panguoutput/cliffsys
MaskMask贴图数据，包含多种MaskTile/panguoutput/masksys
CustomBrush自定义笔刷数据Tile/panguoutput/custombrushsys
Stand导出Stand工具中对各个Actor的额外数据编辑。全局导出时在Whole/ProxyMeshes中，分块导出时在Tile/panguoutput/stand中
VertexColor导出顶点色
CustomParams导出每个地块的自定义参数
TextureForgeConfig贴图锻造配置文件
Custom RealLandscape自定义真实地形数据Tile/panguoutput/layer
Custom AgentLandscape自定义代理地形数据Tile/panguoutput/agent

当选中了“Custom RealLandscape”或“Custom AgentLandscape”会显示相应的可配置EditLayer选项，通过名字限定导入的EditLayer。

image-20240412141123034

  • Spline 选项和工具对应

    • Generic
    • Water
    • Road
    • Race
    • Hill
    • Village
    • Spline Lite
    • Stage

  • Stand导出参数介绍

    • Export All Layers
      • 是否导出全部层下的代理模型信息。取消勾选时会出现Target Layer Names属性，可以设置需要导出的层。
    • Target Layer Names
      • 需要导出的层，可以设置多个层。
    • Global
      • 是否导出到全局路径中，勾选导出到Whole/ProxyMeshes中，不勾选分块导出到Tile/panguoutput/stand中。
    • Level Of Detail
      • 是否导出代理模型的LOD，勾选的话导出模型的全部LOD。