“Vtobjplugin/zh”的版本间的差异

来自Ballance Wiki
跳转至： 导航、 搜索
（更新到3.0版本的说明）
 
第6行： 第6行：
 
|screenshotDesc=vtobjplugin v1.1的导出设置界面（v1.2已经修复此截图中拼写错误）
 
|screenshotDesc=vtobjplugin v1.1的导出设置界面（v1.2已经修复此截图中拼写错误）
 
|author=[[yyc12345]]
 
|author=[[yyc12345]]
−
|suit=Virtools 3.5/5.0
+
|suit=Virtools 3.0/3.5/4.0/5.0
 
|link=[https://github.com/yyc12345/vtobjplugin GitHub仓库]
 
|link=[https://github.com/yyc12345/vtobjplugin GitHub仓库]
 
|dependency=无
 
|dependency=无
 
|status=active
 
|status=active
 
|date=2020年5月31日
 
|date=2020年5月31日
−
|latest=v1.5 (2020年7月13日) {{HLine|0|0}} 稳定版: v1.3 (2020年6月15日)
+
|latest=v3.0 (2024年7月21日) {{HLine|0|0}} 稳定版: v2.2 (2022年12月26日)
 
}}
 
}}
  
−
'''vtobjpugin'''是由[[yyc12345]]开发的，一款复刻{{zh|vt2obj}}的，能够实现更多导出选项的OBJ文件导出插件，适用于{{zh|Virtools}} 3.5和5.0版本。
+
'''vtobjpugin'''是由[[yyc12345]]开发的，一款复刻{{zh|vt2obj}}的，能够实现更多导出选项的OBJ文件导出插件，适用于{{zh|Virtools}} 3.0，3.5，4.0和5.0版本。
  
 
== 特性 ==
 
== 特性 ==
第20行： 第20行：
 
=== 优点 ===
 
=== 优点 ===
  
−
* 可以选择忽略世界变换矩阵（较于vt2obj更优，消除世界变换矩阵即消除物体的移动，旋转和缩放变换）。
+
* 可以选择忽略物体变换（即保持物体原点。较于vt2obj更优。忽略物体变换将保留物体原点，但会消除物体的平移、旋转和缩放）。
−
* 支持{{zh|Blender}}和{{zh|3ds Max}}的重定位脚本，方便复位（在使用忽略世界变换矩阵后方便在编辑软件中重新放置各类模型）。
+
* 支持Blender和3ds Max的重定位脚本，方便复位（在使用忽略物体变换后，方便在在3D软件中将每个物体按其原始变换重新放置到其正确状态）
 
* 支持更好的左右手坐标转换（从翻转Z轴改为交换YZ轴，更加符合Blender和3ds Max的轴向）。
 
* 支持更好的左右手坐标转换（从翻转Z轴改为交换YZ轴，更加符合Blender和3ds Max的轴向）。
−
* 增加更多[[材质]]导出选项。
+
* 增加更多材质导出选项。
−
* 较于vt2obj支持Virtools 3.5，方便导出。
+
* 与vt2obj相比，支持更多Virtools版本。便于Ballance和其他游戏导出3D物体。
−
* 支持每个物体一个文件，非常适合素材导出。
+
* 支持 ''一个物体一个文件''，非常适合素材导出。
  
 
=== 缺点 ===
 
=== 缺点 ===
  
 
* 左右手翻转只能支持YZ轴翻转。
 
* 左右手翻转只能支持YZ轴翻转。
−
* 使用组来分割物体，并且不提供任何其他选项修改。
 
 
* 平滑组没有考虑。
 
* 平滑组没有考虑。
−
* 只能导出3D物体，不能导出线等二维结构。
+
* 只能导出3D物体，不能导出线等二维结构
  
−
== 下载 ==
+
== 操作方法 ==
 +
 
 +
# 将下载好的插件放置到Virtools的<code>InterfacePlugins</code>文件夹中。
 +
# 启动Virtools，加载需要导出的文档。
 +
# 点击菜单栏<code>Wavefront OBJ - 导出物体</code>。
 +
# 在弹出窗口中配置好导出参数，点击<code>好</code>即可导出。
 +
 
 +
== 导出设置说明 ==
 +
 
 +
=== 常规设置 ===
 +
 
 +
* 导出模式：<code>一个物体</code>，<code>一个组</code>，<code>选定物体</code>和<code>全部</code>。对于<code>一个物体</code>和<code>一个组</code>，需要再点击下面的下拉框选择需要导出的物体或组。
 +
* 文件模式：<code>所有物体一个文件</code>和<code>每个物体一个文件</code>。前者文件名将命名为<code>all</code>，后者文件名为物体名称。此选项仅影响OBJ和MTL文件的个数。
 +
* 导出目录：需要是一个已经存在的文件夹。导出中如若碰到同名文件会直接覆盖，需要注意。
 +
 
 +
=== 物体设置 ===
 +
 
 +
* 拆分物体方式：决定是使用 <code>g</code>（组语句）还是 <code>o</code>（物体语句）来划分物体。
 +
* 忽略物体空间变换：议勾选。此选项仅仅是为了提供向vt2obj兼容的功能而存在。
 +
* 转换到右手坐标系：转为右手坐标系，特指Blender和3ds Max类型的右手坐标系。
 +
* 添加名称前缀：添加唯一的名称前缀，以尽量避免可能的名称冲突。
 +
* 移除非ASCII字符：移除导出文件中的所有非ASCII字符，包括对象名称和纹理文件。在一些OBJ导入器不能够正确处理编码的场合可能会有用。
 +
 
 +
=== 重新放置设置 ===
 +
 
 +
如果你没有勾选<code>忽略物体空间变换</code>和<code>转换到右手坐标系</code>，那么下述两项将不可用。
 +
 
 +
重新放置意味着恢复物体的原始变换，包括平移、旋转和缩放。
 +
 
 +
* 生成3ds Max重新放置脚本（3dsmax.ms）
 +
* 生成Blender重新放置脚本（blender.py）
 +
 
 +
=== 材质设置 ===
 +
 
 +
* 导出材质：是否导出MTL文件。如果不勾选，下述所有选项将被禁用。
 +
* 导出贴图：是否在MTL文件中包含贴图。如果不勾选，物体的所有纹理将被移除，只保留其颜色属性，如环境光、漫反射等，并且下述所有选项将被禁用。
 +
* 复制贴图文件：将导出的材质复制到输出目录，如果你已有材质文件列表，可以关闭此选项以节省空间和不必要的IO操作。
 +
* 自定义贴图格式：如果勾选此选项并输入新的扩展名，所有材质都将更改为您指定的新扩展名。不需要输入扩展名开头的点（<code>.</code>）。
  
−
前往[https://github.com/yyc12345/vtobjplugin GitHub仓库]的Release下载最新版本。需要选择合适的Virtools版本。
+
=== 编码设置 ===
  
−
== 操作方法 ==
+
* 文档编码（又名：代码页）
 +
** 系统：使用系统的编码，选择此项即保持与1.x版本的导出器相同的行为。在文档没有出现乱码的情况下，也可以选择此项。
 +
** 自定义：给予用户一个让导出器正确读取物体名称的机会。Virtools使用依赖于系统的多字节编码。因此当Virtools文档的作者与阅读者（你）的系统编码不相同，且作者恰好在文档中使用了非ASCII字符，那么文档将会出现乱码。例如，Ballance使用西欧编码编码了<code>A01_Geländer_01</code>，那么在一些其它编码下则会出现乱码，此时若选择此项并填入<code>28591</code>（[https://docs.microsoft.com/en-us/windows/win32/intl/code-page-identifiers Windows代码页]）则可以正确读取字符并输出正确的文件。
 +
* 在物体和材质文件中使用UTF8：在OBJ和MTL文件中使用UTF8编码，而不是本机编码。此项与下一项通常与文档编码的自定义选项一起使用。
 +
* 在脚本文件中使用UTF8：在重新定位脚本文件中使用UTF8编码。
  
−
# 将插件安装到Virtools的<code>InterfacePlugins</code>文件夹中。
+
== 导出导入技巧 ==
−
# 启动Virtools，加载需要导出的文档。
 
−
# 根据需要，考虑是否需要做额外操作，比如只想导出路面或者某些物体，需要把相关物体归到一个新组中，或者不做任何操作，例如导出单个物体或全部物体。
 
−
# 点击菜单栏{{kbd|Vtobj}}-{{kbd|Export object}}。
 
−
# 弹出窗口中配置好各类参数，点击OK即可导出。
 
  
−
== 导出选项解释 ==
+
由于导出选项的编码部分比较复杂，并且导出的模型主要用于3ds Max以及Blender内的导入，因此在此处分别介绍适用于两个软件的导出设置中的编码部分的设置。
  
−
=== General Setting ===
+
=== 导出 ===
  
−
* Export mode：导出模式，从<code>An object</code>（单个物体），<code>A group</code>（一个组里的所有物体）和<code>All</code>（所有物体）中选择一个。其中前两个选项需要再点击下面的下拉框选择物体或组。
+
此处的设置是基于默认设置（可以单击对话框中的重置为默认按钮来获取它）的修改，如果没有陈述，则保持默认设置，除非你知道你正在做什么。
−
* File mode：文件模式{{kbd|All objects in one file}}（所有物体在一个文件里）和{{kbd|One file per object}}（一个物体一个文件）。前者文件名将命名为{{code|all}}，后者文件名为物体名称。此选项只影响obj和mtl文件个数。
 
−
* Export folder：导出文件夹，需要是已存在的文件夹。导出中如若碰到同名文件会直接覆盖，需要注意。
 
  
−
=== Object Setting ===
+
==== Blender ====
  
−
* Omit object transform data：忽略世界变换矩阵，建议勾选。此选项仅仅是为了提供向vt2obj兼容的功能而存在。
+
* 设置文档编码，如果需要需要的话
−
* Convert to right-hand coordinate system：转为右手坐标系，特指Blender和3ds Max类型的右手坐标系。
+
* 勾选<code>在物体和材质文件中使用UTF8</code>
−
* Add name prefix：增加唯一的名称前缀以规避名称冲突。
+
* 勾选<code>在脚本文件中使用UTF8</code>
 +
* 勾选<code>生成Blender重新放置脚本（blender.py）</code>
  
−
=== Reposition Script ===
+
Blender本身和Blender的OBJ导出插件默认物体文件和脚本文件是以UTF8进行呈现的。因此需要以UTF8模式输出文本，同时不需要消除非ASCII字符，因为Blender可以正确处理这些字符。
  
−
如果{{kbd|Object Setting}}中任意一项不勾选，那么下述两项将不可用。
+
==== 3ds Max ====
  
−
* Generate 3ds Max script (3dsmax.ms)：生成3ds Max的重定位脚本。
+
* 设置文档编码，如果需要需要的话
−
* Generate Blender script (blender.py)：生成Blender的重定位脚本。
+
* <code>在脚本文件中使用UTF8</code>请根据情况勾选，详见之后的注释
 +
* 勾选<code>移除非ASCII字符</code>
 +
* 勾选<code>生成3ds Max重新放置脚本（3dsmax.ms）</code>
  
−
=== Material Setting ===
+
3ds Max的默认OBJ导入器不能识别非ASCII字符，会将其转换为下划线。所以导致生成的脚本和模型文件名内部物体的名称不匹配，进而在执行脚本时出错。因此我们需要在导出时就消除非ASCII字符。同时旧版本的3ds Max的脚本执行器只能识别带有BOM的UTF8文档并正确显示多语言文本，因此需要使用UTF8输出脚本文件。
  
−
* Export mtl file：导出mtl文件，如果不勾选，那么下述所有选项将不可用。
+
3ds Max的两个MAXScript执行方法具有不同的文件读取策略。如果您想使用 ''MAXScript-运行脚本'' 执行脚本，那么您不可以勾选<code>在脚本文件中使用UTF8</code>。如果您想使用先 ''MAXScript-打开脚本''，然后在窗口中使用 ''工具-计算所有'' 来运行脚本，则可以勾选这个选项。
−
* Export texture map in mtl：在mtl中导出贴图文件，如果不需要贴图（即只保留光照等效果），可以不勾选。不勾选此选项下述所有选项将不可用。
 
−
* Copy texture file：将导出材质复制到输出目录，如果你已有材质文件列表，可以关闭此选项以节省空间和不必要的IO操作。
 
−
* Custom texture map format：自定义材质格式。目前由于SDK限制无法读取原有材质格式，如果不勾选并填入后缀那么保存的材质将不具有任何后缀名，这可能会在Windows 10以前的操作系统上引发错误。
 
  
−
== 导入提示 ==
+
=== 导入 ===
  
−
此处就Blender和3ds Max导入做一些提示。此处的设置是以对默认设置（即第一次使用此插件时的设置）为前提进行讲述的
+
以下提示适用于在建议的导出设置（之前介绍的设置）下导出的OBJ和MTL文件。
  
−
=== Blender ===
+
==== Blender ====
  
 
* 坐标轴选择Y forward, Z up（即与Blender默认坐标轴设置一致）
 
* 坐标轴选择Y forward, Z up（即与Blender默认坐标轴设置一致）
−
* 勾选Image search
+
* 根据你之前选择的物体分割模式，勾选<code>Split by Group</code>或<code>Split by Object</code>
−
* Split勾选Group
 
  
−
重定位在Scripting界面加载<code>blender.py</code>并执行即可
+
对于重定位脚本，在Scripting界面加载<code>blender.py</code>并执行即可
  
−
=== 3ds Max ===
+
==== 3ds Max ====
  
−
* 不要勾选翻转YZ轴；
+
* '''不要''' 勾选翻转YZ轴
−
* 法线从文件导入；
+
* 法线从文件导入
−
* 勾选导入材质。
+
* 勾选导入材质
  
−
重定位在菜单栏选择MAXScript-运行脚本，选择<code>3dsmax.ms</code>并执行即可。
+
重定位在菜单栏选择 ''MAXScript-运行脚本''，选择<code>3dsmax.ms</code>并执行即可，或先 ''MAXScript-打开脚本''，然后在窗口中使用 ''工具-计算所有''。根据您之前在导出提示中做出的决定进行选择。
  
 
{{制图教程}}
 
{{制图教程}}
 
[[Category:制图工具]]
 
[[Category:制图工具]]

2024年7月21日 (日) 16:49的最新版本

Ambox-AuthorEdition.png 参与者编辑的条目
这个条目已经被作者或条目相关人物进行了巡查或编辑，因而内容可信度很高。
vtobjplugin
Vtobjplugin.png
vtobjplugin v1.1的导出设置界面（v1.2已经修复此截图中拼写错误）
基本信息
作者 yyc12345
适用于 Virtools 3.0/3.5/4.0/5.0
依赖 无
发布时间 2020年5月31日
最终版本 v3.0 (2024年7月21日)
稳定版: v2.2 (2022年12月26日)
项目地址 GitHub仓库
开发状态 活跃开发中

vtobjpugin是由yyc12345开发的，一款复刻vt2obj的，能够实现更多导出选项的OBJ文件导出插件，适用于Virtools 3.0，3.5，4.0和5.0版本。

特性

优点

  • 可以选择忽略物体变换（即保持物体原点。较于vt2obj更优。忽略物体变换将保留物体原点，但会消除物体的平移、旋转和缩放）。
  • 支持Blender和3ds Max的重定位脚本，方便复位（在使用忽略物体变换后，方便在在3D软件中将每个物体按其原始变换重新放置到其正确状态）
  • 支持更好的左右手坐标转换（从翻转Z轴改为交换YZ轴，更加符合Blender和3ds Max的轴向）。
  • 增加更多材质导出选项。
  • 与vt2obj相比，支持更多Virtools版本。便于Ballance和其他游戏导出3D物体。
  • 支持 一个物体一个文件，非常适合素材导出。

缺点

  • 左右手翻转只能支持YZ轴翻转。
  • 平滑组没有考虑。
  • 只能导出3D物体，不能导出线等二维结构

操作方法

  1. 将下载好的插件放置到Virtools的InterfacePlugins文件夹中。
  2. 启动Virtools，加载需要导出的文档。
  3. 点击菜单栏Wavefront OBJ - 导出物体。
  4. 在弹出窗口中配置好导出参数，点击好即可导出。

导出设置说明

常规设置

  • 导出模式：一个物体，一个组，选定物体和全部。对于一个物体和一个组，需要再点击下面的下拉框选择需要导出的物体或组。
  • 文件模式：所有物体一个文件和每个物体一个文件。前者文件名将命名为all，后者文件名为物体名称。此选项仅影响OBJ和MTL文件的个数。
  • 导出目录：需要是一个已经存在的文件夹。导出中如若碰到同名文件会直接覆盖，需要注意。

物体设置

  • 拆分物体方式：决定是使用 g（组语句）还是 o（物体语句）来划分物体。
  • 忽略物体空间变换：议勾选。此选项仅仅是为了提供向vt2obj兼容的功能而存在。
  • 转换到右手坐标系：转为右手坐标系，特指Blender和3ds Max类型的右手坐标系。
  • 添加名称前缀：添加唯一的名称前缀，以尽量避免可能的名称冲突。
  • 移除非ASCII字符：移除导出文件中的所有非ASCII字符，包括对象名称和纹理文件。在一些OBJ导入器不能够正确处理编码的场合可能会有用。

重新放置设置

如果你没有勾选忽略物体空间变换和转换到右手坐标系，那么下述两项将不可用。

重新放置意味着恢复物体的原始变换，包括平移、旋转和缩放。

  • 生成3ds Max重新放置脚本（3dsmax.ms）
  • 生成Blender重新放置脚本（blender.py）

材质设置

  • 导出材质：是否导出MTL文件。如果不勾选，下述所有选项将被禁用。
  • 导出贴图：是否在MTL文件中包含贴图。如果不勾选，物体的所有纹理将被移除，只保留其颜色属性，如环境光、漫反射等，并且下述所有选项将被禁用。
  • 复制贴图文件：将导出的材质复制到输出目录，如果你已有材质文件列表，可以关闭此选项以节省空间和不必要的IO操作。
  • 自定义贴图格式：如果勾选此选项并输入新的扩展名，所有材质都将更改为您指定的新扩展名。不需要输入扩展名开头的点（.）。

编码设置

  • 文档编码（又名：代码页）
    • 系统：使用系统的编码，选择此项即保持与1.x版本的导出器相同的行为。在文档没有出现乱码的情况下，也可以选择此项。
    • 自定义：给予用户一个让导出器正确读取物体名称的机会。Virtools使用依赖于系统的多字节编码。因此当Virtools文档的作者与阅读者（你）的系统编码不相同，且作者恰好在文档中使用了非ASCII字符，那么文档将会出现乱码。例如，Ballance使用西欧编码编码了A01_Geländer_01，那么在一些其它编码下则会出现乱码，此时若选择此项并填入28591（Windows代码页）则可以正确读取字符并输出正确的文件。
  • 在物体和材质文件中使用UTF8：在OBJ和MTL文件中使用UTF8编码，而不是本机编码。此项与下一项通常与文档编码的自定义选项一起使用。
  • 在脚本文件中使用UTF8：在重新定位脚本文件中使用UTF8编码。

导出导入技巧

由于导出选项的编码部分比较复杂，并且导出的模型主要用于3ds Max以及Blender内的导入，因此在此处分别介绍适用于两个软件的导出设置中的编码部分的设置。

导出

此处的设置是基于默认设置（可以单击对话框中的重置为默认按钮来获取它）的修改，如果没有陈述，则保持默认设置，除非你知道你正在做什么。

Blender

  • 设置文档编码，如果需要需要的话
  • 勾选在物体和材质文件中使用UTF8
  • 勾选在脚本文件中使用UTF8
  • 勾选生成Blender重新放置脚本（blender.py）

Blender本身和Blender的OBJ导出插件默认物体文件和脚本文件是以UTF8进行呈现的。因此需要以UTF8模式输出文本，同时不需要消除非ASCII字符，因为Blender可以正确处理这些字符。

3ds Max

  • 设置文档编码，如果需要需要的话
  • 在脚本文件中使用UTF8请根据情况勾选，详见之后的注释
  • 勾选移除非ASCII字符
  • 勾选生成3ds Max重新放置脚本（3dsmax.ms）

3ds Max的默认OBJ导入器不能识别非ASCII字符，会将其转换为下划线。所以导致生成的脚本和模型文件名内部物体的名称不匹配，进而在执行脚本时出错。因此我们需要在导出时就消除非ASCII字符。同时旧版本的3ds Max的脚本执行器只能识别带有BOM的UTF8文档并正确显示多语言文本，因此需要使用UTF8输出脚本文件。

3ds Max的两个MAXScript执行方法具有不同的文件读取策略。如果您想使用 MAXScript-运行脚本 执行脚本，那么您不可以勾选在脚本文件中使用UTF8。如果您想使用先 MAXScript-打开脚本，然后在窗口中使用 工具-计算所有 来运行脚本，则可以勾选这个选项。

导入

以下提示适用于在建议的导出设置（之前介绍的设置）下导出的OBJ和MTL文件。

Blender

  • 坐标轴选择Y forward, Z up（即与Blender默认坐标轴设置一致）
  • 根据你之前选择的物体分割模式，勾选Split by Group或Split by Object

对于重定位脚本，在Scripting界面加载blender.py并执行即可

3ds Max

  • 不要 勾选翻转YZ轴
  • 法线从文件导入
  • 勾选导入材质

重定位在菜单栏选择 MAXScript-运行脚本，选择3dsmax.ms并执行即可，或先 MAXScript-打开脚本，然后在窗口中使用 工具-计算所有。根据您之前在导出提示中做出的决定进行选择。

查 ·论 ·编
Virtools
了解Virtools
物件元素与组
其他元素相关
Virtools扩展
游戏机制
辅助建模
3ds Max
入门
基本教程
导入导出
进阶教程
Blender
基本操作
辅助程序
取自“https://ballance.jxpxxzj.cn/index.php?title=Vtobjplugin/zh&oldid=8596”