CLO HELP CENTER

有什么能为您效劳的吗?

Python脚本API

关注

目的

学习在Python脚本API(应用程序编程接口)中所用到的变量。

※参考:

  • 示例文件位置:
    • CLO安装文件。

  • 如何执行示例文件:
    • 请在脚本控制台(console)中输入以下文本

    • py> import example

    • py> from example import *

    • py> exam = example()

    • py> exam.function(mdsa)

    • Function只是一个例子, 请从example.py文件中共找到可用的函数。

    • mdsa是一个python模块,允许用户使用python中的Marvelous Designer函数。



访问路径

  1. 打开Python脚本.

  2. 当Python脚本控制台出现时,输入合适的API.

API

#mdsa = CLO Script API

 

变量

变量名

类型

描述

open_avatar_file_list

String List

列表类型变量, 指定想要打开的虚拟模特文件的目录。

open_garment_file_list

String List

列表类型变量, 指定想要打开的服装文件的目录。

open_animation_file_list

String List

列表类型变量, 指定想要打开的动画文件的目录

save_file_path_list

String List

列表类型变量, 指定文件将被保存的路径及名称。

obj_type_list

Integer List

列表类型变量, 保存需要使用的虚拟模特类型。

simulation_quality_list

Integer List

列表类型变量, 指定模拟类型。

simulation_delay_time_list

Integer List

列表类型变量, 指定默认姿势模拟的时间.

export_scale_unit_list

String List

列表类型变量, 指定导出物体时的缩放,以单位计算.

export_fps_list

Integer List

列表类型变量, 指定导出物体时的FPS.

unified_map_list

Boolean List

列表类型变量, 导出时决定是否统一UV。

export_scale_unit

String

变量, 指定导出物体时的缩放,以单位计算。

export_fps

Integer

变量, 指定导出物体时的FPS。

unified_map

Boolean

变量, 导出时决定是否统一UV。

import_scale_unit_list

String List

列表类型变量, 指定导入物体时的缩放,以单位计算。

import_fps_list

Integer List

列表类型变量, 指定导入物体时的FPS.

import_scale_unit

String

变量, 指定导入物体时的缩放,以单位计算。

import_fps

Integer

变量, 指定导入物体时的FPS.

current_process

Integer

‘Process’ 代表了‘文件打开 -> 模拟 -> 动画 -> 保存文件’的流程. 可以同时计算多个‘Process’。
该变量显示了多进程的进度。

我们不建议访问该变量。

export_option_count

Integer

指定的导出选项列表的大小。当设置独立选项变量时,该值将变为0。

import_option_count

Integer

指定的导入选项列表的大小。 当设置独立选项变量时,该值将变为0。

save_folder_path

String

变量指定保存文件夹。

module_obj

CLO Module

MarvelousDesigner的内部API模块。 我们不建议访问该变量。

 

函数

def initialize(object):

- 重置当前使用的mdsa对象。

def clear_console(object):

- 清除控制台窗口。

def get_split_string(object, string, split_filter_list):

- String = 字符串类型, split_filter_list = 字符串列表类型

- 该函数将返回一个字符串列表(字符串列表 = 源字符串 / split_filter_list). Split_filter_list 是分割标准字符串的列表。

get_split_string函数从第一个字符串中分割了Split_filter_list. 当字符串无法通过第一个字符串进行分割时,(如果一个字符不包含在字符串中) 它将按照顺序查找下一个字符串.

当它找到了一个可以通过split_filter_list来分割的字符串时,它将变回分割字符串列表。当它无法找到一个可分割的字符串时,它将变回空的字符串列表。Split_filter字符将从字符串列表中排除.

- get_split_string(“C:\Users\Public\Documents\MarvelousDesigner\Assets_ver_3.0.9999\default.zpac”, [“\\”, “/”])

- [“C:”, “Users”, “Public”, “Documents”, “MarvelousDesigner”, “Assets_ver_3.0.9999”, “default.zpac”]

def get_file_name(object, file_path):

- file_path是一个字符串

- 此函数仅将从file_path收到的file_name返回为因子。

- get_file_name(“C:\Users\Public\Documents\MarvelousDesigner\Assets_ver_3.0.9999\default.zpac”)

- default.zpac”

def get_filter_file_name(object, file_list, filter):

- file_list是一个字符串列表,filter是字符串。

- 该函数将返回具有特定扩展名的文件列表,这些文件是从file_list中接收的因子。查找文件名时不区分大小写。

def make_valid_folder_path(object, folder_path):.

- Folder_path是一个字符串。

- 当路径的最后一个字符不是 “\” 或 “/”, 它将被认为是无效的路径. 该函数将无效的路径转换为有效格式并返回值。

def get_entry_list(object, folder_path):

- Folder_path是一个字符串。

- get_entry_list将返回Folder_path中文件的列表。

def set_open_option(object, unit = "none", fps = 30):

- 单位是字符串, 允许你将单位值设置为"cm", "mm", "inch", "feet", "m". 默认值为 "mm".

- Fps是一个整数, 默认设置为30fps.

- set_open_option指定obj,cache,fbx和alembic文件的导入选项。 如果您需要导入多个文件并且想要设置不同的选项,请使用set_open_option_list函数。该函数仅决定数值。要将此值应用于Marvelous Designer,必须调用set_app_open_option函数。

def set_save_option(object, unit = "none", fps = 30, unified = False):

- 单位是字符串, 允许你将单位值设置为"cm", "mm", "inch", "feet", "m". 默认值为 "mm".

- Fps是一个整数, 默认设置为30fps.

- Unified是布尔类型, 当它是True, 它会把物体的UV的值由0更改为1。默认为False.

- 设置obj,cache,fbx,alembic和Garment文件的导出选项。如果您需要导出多个文件并想要设置不同的选项,请使用set_save_option_list函数。该函数仅决定值。要将此值应用于Marvelous Designer,必须调用set_app_save_option函数。

- def set_open_option_list(object, unit_list, fps_list):

- unit_list是字符串类型, fps_list时整数列表类型

- 设置obj,cache,fbx,alembic和Garment文件的导入选项。 如果您需要导入多个文件并要设置不同的选项,请调用此函数。因子是列表类型,因子unit_list及fps_list内必须有相同的数量。如果要导入的文件多于option_list,则值将与最后一项设置相同。有关详细信息,请参阅example.py。

def set_save_option_list(object, unit_list, fps_list, unified_map_list):

- unit_list是一个字符串列表, fps_list是整数列表类型,unified_map_list是布尔列表类型。

- 设置obj,cache,fbx,alembic和Garment文件的导出选项。 如果您需要导出多个文件并要设置不同的选项,请调用此函数。因子是列表类型,因子unit_list及fps_list内必须有相同的数量。如果要导入的文件多于option_list,则值将与最后一项设置相同。有关详细信息,请参阅example.py。

def run_app_open_option(object):

- run_app_open_option应用保存在set_open_option函数中的值并指定Marvelous Designer的导入选项。

def run_app_save_option(object):

- run_app_save_option应用保存在set_save_option中的值,它指定Marvelous Designer的导出选项。

- def run_app_open_option(object, index):

- index是整数类型

- 该函数应用保存在set_open_option_list中的值,它指定Marvelous Designer的导出选项。

- 如果set_open_option_list中的选项设置为列表, 它将指定项目的index发送到因子。 Index的最小值是-0,列表总值的最大数值为-1。

def run_app_save_option(object, index):

- index是整数类型

- 在set_save_option_list函数中保存的函数应用值。它指定了Marvelous Designer的导出选项。如果选项作为列表保存在set_save_option_list中,它将保存选项值并将其作为因子发送并应用于所需的项目。Index的最小值为0,整个列表的最大值为-1.

def get_app_open_optin_count(object):

- 将当前导入选项数返回。默认值为0。

def get_app_save_optin_count(object):

- 将当前导出选项数返回。默认值为0。

def set_avatar_file_path(object, open_avatar_file_path):

- open_avatar_file_path是一个字符串类型.

- 添加虚拟模特文件路径。 当数值与其他文件无法匹配时,则加载最后一个虚拟模特文件路径。

def set_avatar_file_path_list(object, open_avatar_file_path_list):

- open_avatar_file_path_list是一个字符串列表类型。

- 设置虚拟模特文件列表。它用于设置外部列表类型数值。如果数值与其他文件列表不匹配,则加载最后一个虚拟模特文件路径。

def set_garment_file_path(object, open_garment_file_path):

- open_garment_file_path是一个字符串类型。

- 添加服装文件路径. 当数量与其他文件不匹配,则最后的服装文件路径将被加载。

def set_garment_file_path_list(object, open_garment_file_path_list):

- open_garment_file_path_list是一个字符串列表类型。

- 设置服装文件列表。它用于设置外部列表类型值。当数值与其他文件无法匹配时,将打开最后一个服装文件路径。 

def set_animation_file_path(object, open_animation_file_path):

- open_animation_file_path是一个字符串列表类型。

- 设置动画文件列表。它用于设置外部列表类型值。 当数值与其他文件无法匹配时,将打开最后一个动画文件路径。 

def set_animation_file_path_list(object, open_animation_file_path_list):

- open_animation_file_path_list是一个字符串列表类型。

- 设置动画文件列表。它用于设置外部列表类型值。 当数值与其他文件无法匹配时,将打开最后一个动画文件路径。 

- def set_simulation_options(object, obj_type = 0, simulation_quality = 0, simulation_delay_time = 5000, process_simulation = True):

- obj_type类型为整数,将根据obj_type的数值载入物体,当数值为0时,物体将被导入为模特;数值为0时,将导入为虚拟模特,数值为1时将导入为附件,数值为2时将导入为服装。默认导入为模特。 

- Simulation_quality类型为整数, 它通过数值来更改模拟质量,数值为0时为普通,1为完成,2为自定义模式。默认设置为普通。

- Simulation_delay_time类型为整数, 此至为动画稳定前的模拟时间。默认值为5000微秒 (1秒=1000微秒 )

- Process_simulation类型为布尔,它决定了是否继续模拟,默认数值为True. 

- 该函数添加了与OBJ类型及模拟相关的导入选项。如果记数与将要导入的文件不匹配或者选项未设置,则值将被设置为默认值。

def avatar_file_open(object, open_file_path, obj_type = 0, scale = "mm", fps = 30):

- open_file_path类型为字符串, obj_type类型为字符串, scale类型为字符串, fps类型为整数。

- 该函数加载位于open_file_path中的虚拟模特文件(avt,obj,fbx,alembic)。 还应用保存的obj_type,scale,fps选项。

def garment_file_open(object, open_file_path):

- open_file_path类型为字符串。

- 该函数加载位于open_file_path中的服装(zpac,pac,zprj)文件。

def animation_file_open(object, open_file_path, scale = "mm", fps = 30):

- open_file_path是字符串类型,scale是字符串类型,fps是整数类型

- 该函数加载位于open_file_path文件中的动画(pos,mc,mcx,pc2,mdd)。也适用于保存比例,fps选项。

def save_file_stand_alone(object, file_path, scale = "mm", fps = 30, unfined_map = True):

- File_path是字符串类型,scale是字符串类型,fps是整数类型,unified_map是布尔类型

- 该函数将加载的文件保存到file_path。它会根据保存在File_path中的扩展名自动指定文件类型。还应用保存的比例,fps,unified_map选项。

def SimulationOn(object, time):

- Time是整数类型, 微秒(1000微秒=1秒)

- 指定时间后开始模拟.

def SimulationOff(object, time):

- Time是整数类型, 微秒(1000微秒=1秒)

- 指定时间后停止模拟.

def StartAnimationRecord(object, time):

- Time是整数类型, 微秒(1000微秒=1秒)

- 在指定时间后开始并录制动画。

def set_save_file_path(object, save_file_path):

- save_file_path是字符串类型

- 该函数将从因子收到的路径添加到save_file_path_list。save_file_path_list需要至少匹配保存的导入文件列表中的一个。

- 可以通过设置set_save_folder_path来取代。 任何一个都必须设置。

def set_save_folder_path(object, save_folder_path):

- save_folder_path是字符串类型

- 此函数将从因子收到的路径设置为保存文件夹路径。保存用以将文件保存为项目文件的路径。 文件的名称将与具有最大计数的导入文件列表相同。 可以通过设置set_save_file_path来取代。 任何一个都必须设置。

def set_garment_folder(object, garment_folder_path, filter = "zpac"):

- garment_folder_path类型为字符串, filter类型为字符串

- 该函数从指定的文件夹加载服装文件,并通过open_garment_file_list进行设置。在设置过滤值的情况下,它通过在过滤器处保存的扩展名来设置open_garment_file_list。

- 过滤器的默认设置是“zpac”。

def set_avatar_folder(object, avatar_folder_path, filter = "avt"):

- avatar_folder_path类型为字符串, filter类型为字符串

- 该函数从指定的文件夹加载虚拟模特文件,并通过set by open_avatar_file_list进行设置. 在设置过滤值的情况下,它通过在过滤器处保存的扩展名来设置open_avatar_file_list。

- 过滤器的默认设置是“avt”。

def set_animation_folder(object, animation_folder_path, filter = "pos"):

- animation_folder_path类型为字符串, filter类型为字符串

- 该函数从指定的文件夹加载动画文件,并通过set by open_animation_file_list进行设置. 在设置过滤值的情况下,它通过在过滤器处保存的扩展名来设置open_animation_file_list。

- 过滤器的默认设置是“pos”。

def get_max_count(object):

- 该函数返回将要打开的文件列表中最大尺寸列表的项目数。

def single_process(object, open_garment_path, open_avatar_path, open_animation_path, save_file_path, obj_type = 0, simulation_delay_time = 5000, simulation_quality = 0, simulation = True, auto_save_project_file = True):

- single_process从因子接收的路径中按顺序加载文件并将结果保存到save_file_path。

- obj_type仅在打开的文件为OBJ时可应用。当obj_type数值为0时,OBJ文件将作为虚拟模特被导入,数值为1时,将作为附件被打开,数值为2时,将作为服装文件被打开。

- simulation_delay_time用于设置处理动画稳定之前的延迟时间。 打开的虚拟模特和服装将模拟开始姿势指定的时间和开始动画。simulation_delay_time用于设置处理动画稳定之前的延迟时间。 打开的虚拟模特和服装将模拟开始姿势指定的时间和开始动画。simulation_delay_time用于设置处理动画稳定之前的延迟时间。 打开的虚拟模特和服装将模拟开始姿势指定的时间和开始动画。simulation_delay_time用于设置处理动画稳定之前的延迟时间。 打开的虚拟模特和服装将模拟开始姿势和指定的时间和开始动画。

- simulation_delay_time使用微秒作为单位 (1000微秒 = 1秒)

- simulation_quality控制模拟的精确度。当数值为0时,将进行普通品质的模拟。当数值为1时,将进行完全模拟。simulation_quality的这些选项与Marvelous Designer的模拟质量相同。 有关详细信息,请参阅Marvelous Designer手册。

- 模拟因子决定是否在加载文件后开始模拟。 如果为True,则加载所有文件后开始模拟。 默认值为True。

- auto_save_project_file是允许将项目文件保存到save_file_path的选项。 默认值为True。

※参考: 调用single_process时,它只保存一次文件。 请使用“process”功能保存多个文件。

def process(object, auto_save_zprj_file = True):

- auto_save_zprj_file是布尔类型,如果将auto_save_zprj_file设置为True,则会将其他Zprj文件保存到保存到save_file_path或save_folder_path的文件夹中。

- process函数打开指定文件并处理和录制动画,然后将其保存为动画、服装及虚拟模特文件。导入/导出设置需要在调用process函数之前完成。Process函数允许通过保存的文件列表和导入/导出选项来保存和加载一个或多个文件。

这篇文章有帮助吗?
1 人中有 1 人觉得有帮助

评论

登录写评论。