bpy.ops.font.text_paste_from_file

描述

从文件中复制文本并将其粘贴到当前的文本对象。

默认情况下，文本将粘贴到光标位置，并覆盖选定的文本。但是，如果指定了 location 参数，则可以将文本粘贴到指定的位置处。

语法

bpy.ops.font.text_paste_from_file(filepath="", filter_blender=False, filter_backup=False, filter_image=False, filter_movie=False, filter_python=False, filter_font=True, filter_sound=False, filter_text=True, filter_archive=True, filter_folder=True, filemode=9, display_type='DEFAULT', sort_method='FILE_SORT_ALPHA', order='NONE', contrast=0.0, brightness=0.0, saturation=0.0, frame_start=1, frame_end=1, map_clamp=[False, False, False], location=(0.0, 0.0, 0.0), relative=False, overwrite=True)

参数

• filepath (string) - 包含要粘贴的文本的文件的路径。
• filter_blender (boolean) - 是否过滤.blend文件。
• filter_backup (boolean) - 是否过滤备份文件（以～结尾）。
• filter_image (boolean) - 是否过滤图像文件（以.jpg, .png等结尾）。
• filter_movie (boolean) - 是否过滤视频文件（以.avi, .mp4等结尾）。
• filter_python (boolean) - 是否过滤Python脚本文件（以.py结尾）。
• filter_font (boolean) - 是否过滤字体文件（以.ttf等结尾）。
• filter_sound (boolean) - 是否过滤声音文件（以.mp3, .wav等结尾）。
• filter_text (boolean) - 是否过滤文本文件（以.txt, .html等结尾）。
• filter_archive (boolean) - 是否过滤归档文件（以.zip, .tar等结尾）。
• filter_folder (boolean) - 是否过滤文件夹。
• filemode (int) - 打开文件时使用的文件模式。
• display_type (enum) - 指定如何显示文件浏览器。
• sort_method (enum) - 指定如何排序文件浏览器中的文件。
• order (enum) - 指定如何排序文件浏览器中的文件。
• contrast (float) - 调整图像的对比度。
• brightness (float) - 调整图像的亮度。
• saturation (float) - 调整图像的饱和度。
• frame_start (int) - 指定使用哪个帧作为动画的开始帧。
• frame_end (int) - 指定使用哪个帧作为动画的结束帧。
• map_clamp (boolean array) - 是否将纹理贴图的坐标限制在0到1之间。
• location (float array) - 粘贴文本的位置。
• relative (boolean) - 是否将文本相对于当前光标位置而不是全局位置。
• overwrite (boolean) - 是否覆盖选定的文本。

返回值

• 如果操作成功，则返回 {'FINISHED'}。

示例

# 打开文件浏览器，并指定要复制的文本所在的文件
bpy.ops.font.text_paste_from_file(filepath="path/to/file.txt")

# 将文本粘贴到指定的位置
bpy.ops.font.text_paste_from_file(filepath="path/to/file.txt", location=(2.0, 0.0, 0.0))

# 将文本相对于当前光标位置粘贴
bpy.ops.font.text_paste_from_file(filepath="path/to/file.txt", relative=True)

# 覆盖选定的文本
bpy.ops.font.text_paste_from_file(filepath="path/to/file.txt", overwrite=True)

异常

• RuntimeError - 如果指定的文件不存在或无法访问，则引发此异常。