附录 A：Tcl 命令参考（第 3 部分）

TIP

源自 Sentaurus Visual 用户指南（W-2024.09），PDF 第 342–406 页。

本部分涵盖从 remove_datasets 到 zoom_plot 的 Tcl 命令。

remove_datasets

移除指定的数据集。

语法

tcl

remove_datasets <stringList>

返回值

整数

示例

tcl

remove_datasets {dataSet1 dataSet2 dataSet3}
#-> 0

参数	说明
`<stringList>`	数据集名称列表。

remove_ellipses

从图中移除椭圆。

TIP

此命令仅适用于 XY 图。

语法

tcl

remove_ellipses <stringList> [-plot <stringValue>]

返回值

已删除的椭圆列表

示例

tcl

remove_ellipses {Ellipse_1 Ellipse_2} -plot Plot_1
#-> Ellipse_1 Ellipse_2

参数	说明
`<stringList>`	椭圆名称列表。
`-plot <stringValue>`	图的名称。如未指定，则使用当前选中的图。

remove_fields

从数据集中移除场。

如未指定 -dataset 或 -plot，命令将使用选中的 2D 或 3D 数据集。

TIP

此命令仅适用于 2D 和 3D 图。

语法

tcl

remove_fields <stringList>
[-dataset <stringValue> | -plot <stringValue>]
[-geom <stringValue>]

返回值

整数

示例

tcl

remove_fields { DopingConcentration X } -plot Plot_n10_des
#-> 0

参数	说明
`<stringList>`	场名称列表。
`-dataset <stringValue>`	要移除场的数据集名称。如未指定，则使用当前活动图。
`-geom <stringValue>`	要移除场的几何体名称。`-geom` 参数只能与 `-plot` 一起使用。如未指定，则使用与图关联的第一个几何体。
`-plot <stringValue>`	要移除场的图名称。如未指定，则使用当前选中的图。

remove_lines

从图中移除线条。

TIP

此命令仅适用于 XY 图和 2D 图。

语法

tcl

remove_lines <stringList> [-plot <stringValue>]

返回值

已删除的线条列表

示例

tcl

remove_lines Line_1 -plot Plot_n60_des
#-> Line_1

参数	说明
`<stringList>`	线条名称列表。
`-plot <stringValue>`	图的名称。如未指定，则使用当前选中的图。

remove_plots

移除指定的图。

语法

tcl

remove_plots <stringList>

返回值

整数

示例

tcl

remove_plots {plotXY plot2D plot3D}
#-> 0

参数	说明
`<stringList>`	要移除的图名称列表。

remove_rectangles

从图中移除矩形。

TIP

此命令仅适用于 XY 图和 2D 图。

语法

tcl

remove_rectangles <stringList> [-plot <stringValue>]

返回值

已删除的矩形列表

示例

tcl

remove_rectangles {Rectangle_1 Rectangle_2} -plot Plot_n60_des
#-> Rectangle_1 Rectangle_2

参数	说明
`<stringList>`	矩形名称列表。
`-plot <stringValue>`	图的名称。如未指定，则使用当前选中的图。

remove_rulers

从图中移除指定的标尺。

语法

tcl

remove_rulers <intList> [-plot <stringValue>]

返回值

整数

示例

tcl

remove_rulers {1 2 3}
#-> 0

参数	说明
`<intList>`	标尺 ID 列表。
`-plot <stringValue>`	要移除标尺的图名称。如未指定，则使用当前选中的图。

remove_streamlines

移除指定的流线。

语法

tcl

remove_streamlines <stringList> [-plot <stringValue>]

返回值

列表

示例

tcl

remove_streamlines {Streamline_1 Streamline_2}
#-> Streamline_1 Streamline_2

参数	说明
`<stringList>`	流线名称列表。
`-plot <stringValue>`	要移除流线的图名称。如未指定，则使用当前选中的图。

remove_textboxes

从图中移除文本框。

TIP

此命令仅适用于 XY 图和 2D 图。

语法

tcl

remove_textboxes <stringList> [-plot <stringValue>]

返回值

已删除的文本框列表

示例

tcl

remove_textboxes {TextBox_1 TextBox_2 TextBox_3} -plot Plot_1
#-> TextBox_1 TextBox_2 TextBox_3

参数	说明
`<stringList>`	文本框名称列表。
`-plot <stringValue>`	图的名称。如未指定，则使用当前选中的图。

render_mode

更新图加载时的渲染状态。如关闭了渲染，在图加载完成后必须将其开启，否则不会显示任何图。

TIP

此命令仅适用于 2D 和 3D 图。

语法

tcl

render_mode [-on | -off]

返回值

渲染模式的当前状态。

示例

tcl

render_mode -on
#-> on

参数	说明
`-on \| -off`	开启或关闭图加载时的渲染。如未指定任何选项，则显示渲染模式的当前状态。

reset_settings

将 Sentaurus Visual 设置重置为默认值。

语法

tcl

reset_settings

返回值

无

示例

tcl

reset_settings

rotate_plot

通过指定轴、角度、方向或平面来旋转 3D 图。可以同时旋转不同的轴。使用的轴和角度说明参见第 123 页的图 71。

TIP

此命令仅适用于 3D 图，且在 Sentaurus Visual 批处理模式下受支持。

语法

tcl

rotate_plot
-alpha <doubleValue> -psi <doubleValue> -theta <doubleValue> |
-angle <doubleValue> -direction (up | down | left | right) |
-plane (xy | yz | xz) |
-x <doubleValue> -y <doubleValue> -z <doubleValue> |
[-absolute] [-plot <stringValue>]

返回值

整数

示例

tcl

rotate_plot -x 10.5 -y 20
#-> 0

rotate_plot -plane xz
#-> 0

rotate_plot -direction up -angle 90
#-> 0

参数	说明
`-alpha <doubleValue>`	使用球坐标 alpha 旋转图（以度为单位）。
`-psi <doubleValue>`	使用球坐标 psi 旋转图（以度为单位）。
`-theta <doubleValue>`	使用球坐标 theta 旋转图（以度为单位）。
`-angle <doubleValue>`	按 `-direction` 指定的方向旋转图，角度由 `-angle` 指定（以度为单位）。
`-direction up \| down \| left \| right`	按指定方向旋转。
`-plane xy \| yz \| xz`	在指定平面上旋转图。
`-x <doubleValue>`	绕 x 轴旋转图（以度为单位）。
`-y <doubleValue>`	绕 y 轴旋转图（以度为单位）。
`-z <doubleValue>`	绕 z 轴旋转图（以度为单位）。
`-absolute`	旋转到绝对位置。
`-plot <stringValue>`	图的名称。如未指定，则使用当前选中的图。

save_plot_to_script

将当前图的图属性和曲线数据导出为 Tcl 文件。

TIP

此命令仅适用于 XY 图。

语法

tcl

save_plot_to_script <stringValue>
[-overwrite] [-plot <stringValue>]

返回值

整数

示例

tcl

save_plot_to_script testFile.tcl -plot Plot_1 -overwrite
#-> 0

参数	说明
`<stringValue>`	指定生成的 Tcl 文件的路径（绝对路径或相对路径）。
`-overwrite`	如果目标 Tcl 文件已存在，是否覆盖。
`-plot <stringValue>`	要导出的图名称。如未指定，则使用当前选中的图。

select_plots

选择图。

语法

tcl

select_plots <stringList>

返回值

列表

示例

tcl

select_plots {plot2D anotherPlot2D}
#-> plot2D anotherPlot2D

参数	说明
`<stringList>`	要选择的图名称列表。传入空列表（`select_plots {}`）将取消选择所有图。

set_angle_prop

设置角度属性。

TIP

此命令仅适用于 2D 图。

语法

tcl

set_angle_prop
[-center <doubleList>] [-color <#rrggbb>]
[-orthogonal_on | orthogonal_off]
[-plot <stringValue>]
[-pos1 <doubleList>] [-pos2 <doubleList>]
[-precision <intValue>] [-show_label | -hide_label]
[-snap_on | -snap_off] [-width <intValue>]

返回值

字符串

示例

tcl

set_angle_prop -color #FF0000
#-> 0

参数	说明
`-center <doubleList>`	设置角度中心或顶点的位置。
`-color <#rrggbb>`	设置角度的颜色。
`-orthogonal_on \| orthogonal_off`	指定是否激活正交移动功能。
`-plot <stringValue>`	图的名称。如未指定，则将属性应用于当前选中的图。
`-pos1 <doubleList>`	设置角度第一个点的位置。
`-pos2 <doubleList>`	设置角度第二个点的位置。
`-precision <intValue>`	设置角度测量的小数精度。
`-show_label \| -hide_label`	指定是否显示或隐藏角度标签。
`-snap_on \| -snap_off`	指定是否激活网格吸附功能。
`-width <intValue>`	设置角度线条的宽度（以像素为单位）。

set_axis_prop

设置坐标轴属性。

如未指定 -axis，则对所有轴设置属性。

TIP

此命令仅适用于 XY 图和 2D 图。

语法

tcl

set_axis_prop
[-anchor <doubleValue>]
[-auto_padding | -manual_padding]
[-auto_precision | -manual_precision]
[-auto_spacing | -manual_spacing]
[-axis x | y | z | y2]
[-inverted | -not_inverted]
[-label_angle <doubleValue>]
[-label_font_att normal | bold | italic | underline | strikeout]
[-label_font_color <#rrggbb>]
[-label_font_factor <doubleValue>]
[-label_font_family arial | courier | times]
[-label_font_size <intValue>]
[-label_format preferred | scientific | engineering | fixed]
[-label_padding <intValue>] [-label_precision <intValue>]
[-major_ticks_length <intValue>]
[-major_ticks_width <intValue>]
[-max <doubleValue>] [-max_auto | -max_fixed]
[-min <doubleValue>] [-min_auto | -min_fixed]
[-minor_ticks_length <intValue>]
[-minor_ticks_position center | in | out]
[-minor_ticks_width <intValue>]
[-nof_minor_ticks <intValue>]
[-padding <intValue>]
[-plot <stringValue>]
[-range {<x1> <x2>}] [-reset]
[-show | -hide] [-show_minor_ticks | -hide_minor_ticks]
[-show_label | -hide_label] [-show_ticks | -hide_ticks]
[-show_title | -hide_title] [-spacing <doubleValue>]
[-ticks_position out | in | center] [-title <stringValue>]
[-title_font_att normal | bold | italic | underline | strikeout]
[-title_font_color <#rrggbb>]
[-title_font_factor <doubleValue>]
[-title_font_family arial | courier | times]
[-title_font_size <intValue>]
[-type linear | log]

返回值

字符串

示例

tcl

set_axis_prop -axis y1 -title "Drain Current"
#-> 0

参数	说明
`-anchor <doubleValue>`	设置刻度锚点。
`-auto_padding \| -manual_padding`	指定自动填充或手动填充坐标轴（仅适用于 XY 图）。
`-auto_precision \| -manual_precision`	设置坐标轴的自动或手动精度。
`-auto_spacing \| -manual_spacing`	设置刻度的间距模式。
`-axis x \| y \| z \| y2`	要应用设置的轴。如未指定，则将属性应用于所有轴。
`-inverted \| -not_inverted`	反转轴值。
`-label_angle <doubleValue>`	设置主刻度标签的旋转角度（仅适用于 XY 图）。仅支持 –90 到 90 度之间的值（含 –90 和 90）。
`-label_font_att normal \| bold \| italic \| underline \| strikeout`	设置轴的字体属性。
`-label_font_color <#rrggbb>`	设置轴的颜色。
`-label_font_factor <doubleValue>`	设置轴的字体大小因子（仅适用于 2D 和 3D 图）。
`-label_font_family arial \| courier \| times`	设置轴的字体。
`-label_font_size <intValue>`	设置轴的字体大小（仅适用于 XY 图）。
`-label_format preferred \| scientific \| engineering \| fixed`	设置轴的数字格式。
`-label_padding <intValue>`	设置轴值的填充。
`-label_precision <intValue>`	设置轴的数字精度。
`-major_ticks_length <intValue>`	设置主刻度的长度。
`-major_ticks_width <intValue>`	设置主刻度的宽度（仅适用于 XY 图）。
`-max <doubleValue>`	设置轴的最大值。
`-max_auto \| -max_fixed`	自动设置轴的最大值，或将轴的最大值固定为用户定义的值（仅适用于 XY 图）。如果指定了 `-max_fixed`，则对数据的任何更改都不会更新范围。
`-min <doubleValue>`	设置轴的最小值。
`-min_auto \| -min_fixed`	自动设置轴的最小值，或将轴的最小值固定为用户定义的值（仅适用于 XY 图）。如果指定了 `-min_fixed`，则对数据的任何更改都不会更新范围。
`-minor_ticks_length <intValue>`	设置次刻度的长度。
`-minor_ticks_position center \| in \| out`	设置次刻度的位置（仅适用于 2D 图）。
`-minor_ticks_width <intValue>`	设置次刻度的宽度（仅适用于 XY 图）。
`-nof_minor_ticks <intValue>`	设置次刻度的数量。
`-padding <intValue>`	设置轴的填充（以像素为单位，仅适用于 XY 图）。如果指定了 `-auto_padding`，则 `-padding` 无效。
`-plot <stringValue>`	图的名称。如未指定，则将属性应用于当前选中的图。
`-range {<x1> <x2>}`	设置轴的范围。
`-reset`	将轴参数重置为默认值（仅适用于 XY 图）。
`-show \| -hide`	显示或隐藏轴。
`-show_minor_ticks \| -hide_minor_ticks`	显示或隐藏次刻度（仅适用于 XY 图）。
`-show_label \| -hide_label`	显示或隐藏标签。
`-show_ticks \| -hide_ticks`	显示或隐藏主刻度。
`-show_title \| -hide_title`	显示或隐藏轴标签。
`-spacing <doubleValue>`	设置刻度之间的间距。
`-ticks_position out \| in \| center`	设置刻度的位置。
`-title <stringValue>`	设置轴标签。
`-title_font_att normal \| bold \| italic \| underline \| strikeout`	设置轴标签的字体属性。
`-title_font_color <#rrggbb>`	设置轴标签颜色。
`-title_font_factor <doubleValue>`	设置字体大小因子（仅适用于 2D 和 3D 图）。
`-title_font_family arial \| courier \| times`	设置轴标签字体。
`-title_font_size <intValue>`	设置轴标签字体大小（仅适用于 XY 图）。
`-type linear \| log`	设置轴的刻度类型（仅适用于 XY 图）。

set_band_diagram

创建能带图。详细信息参见第 92 页的"绘制能带图"。

语法

tcl

set_band_diagram [<stringList>]

返回值

整数

示例

tcl

set_band_diagram Plot_1
#-> 0

参数	说明
`<stringList>`	使用 cutline 函数创建的图列表。

set_best_look

自动配置各种图参数。详细信息参见第 90 页的"最佳外观选项"。

语法

tcl

set_best_look [<stringList>]

返回值

整数

示例

tcl

set_best_look {Plot_1 Plot_2}
#-> 0

参数	说明
`<stringList>`	要应用最佳外观设置的图列表。

set_camera_prop

设置相机属性。

TIP

此命令仅适用于 3D 图。

语法

tcl

set_camera_prop
[-dolly_zoom_on | -dolly_zoom_off]
[-focal_point {<x> <y> <z>}]
[-parallel | -perspective]
[-plot <stringValue>]
[-position {<x> <y> <z>}] [-reset]
[-rot_color <#rrggbb>] [-rot_size <intValue>]
[-rot_width <intValue>]
[-rotation_point {<x> <y> <z>}]
[-setup <listdoubleList>]
[-show_rotation_point | -hide_rotation_point]
[-view_angle <doubleValue>] [-view_up <doubleList>]

返回值

整数

示例

tcl

set_camera_prop -rotation_point {0.2 0.35 -0.25}
#-> 0

参数	说明
`-dolly_zoom_on \| -dolly_zoom_off`	设置在缩放时使用 dolly 缩放而非修改视角。
`-focal_point {<x> <y> <z>}`	设置相机的焦点。
`-parallel \| -perspective`	设置显示图的投影模式：平行投影或透视投影。
`-plot <plotName>`	图的名称。如未指定，则使用当前选中的图。
`-position {<x> <y> <z>}`	设置相机的位置。
`-reset`	将相机设置重置为默认值。
`-rot_color <#rrggbb>`	设置旋转点的颜色。
`-rot_size <intValue>`	设置旋转点的大小。
`-rot_width <intValue>`	设置旋转点的宽度。
`-rotation_point {<x> <y> <z>}`	设置结构的旋转点。
`-setup <listdoubleList>`	指定相机的新设置。
`-show_rotation_point \| -hide_rotation_point`	在图上显示或隐藏旋转点。
`-view_angle <doubleValue>`	设置相机的视角（以度为单位）。
`-view_up <doubleList>`	设置相机的向上向量。

set_capacitance

更改电容的状态。

语法

tcl

set_capacitance <stringValue> -plot <stringValue> [-on | -off]

返回值

整数

示例

tcl

set_capacitance Cap1 -on
#-> 0

参数	说明
`stringValue`	电容的名称。
`-plot`	创建该场的图或数据集名称。如未指定，则使用当前活动图。
`-on \| -off`	开启或关闭电容。

set_contour_labels_prop

设置等值线标签的属性。

语法

tcl

set_contour_labels_prop <stringList>
[-anchor left | center | right]
[-color_bg <#rrggbb>]
[-font_att normal | bold | italic | underline | strikeout]
[-font_color <#rrggbb>]
[-font_factor <doubleValue>]
[-font_family arial | courier | times]
[-format engineering | fixed | preferred | scientific]
[-geom <stringValue>]
[-level_skip <intValue>]
[-plot <stringValue>]
[-precision <intValue>]
[-reset]
[-show_bg | -hide_bg]
[-show_index | -hide_index]
[-spacing <intValue>]

返回值

整数

示例

tcl

set_contour_labels_prop {BandGap DopingConcentration} -precision 3
#-> 0

参数	说明
`<stringList>`	要应用指定属性的场列表。
`-anchor left \| center \| right`	设置等值线标签的锚点。
`-color_bg <#rrggbb>`	设置等值线标签的背景颜色。
`-font_att normal \| bold \| italic \| underline \| strikeout`	设置等值线标签的字体属性。
`-font_color <#rrggbb>`	设置等值线标签的颜色。
`-font_factor <doubleValue>`	设置等值线标签的字体因子。
`-font_family arial \| courier \| times`	设置等值线标签的字体类型。
`-format engineering \| fixed \| preferred \| scientific`	设置等值线标签的格式。
`-geom <stringValue>`	数据集（或几何体）的名称。如未指定，则使用当前活动图中的主数据集。
`-level_skip <intValue>`	设置等值线标签的跳级。值为 0 表示每个级别都标注。
`-plot <stringValue>`	图的名称。如未指定，则使用当前选中的图。
`-precision <intValue>`	设置等值线标签的精度。
`-reset`	重置等值线标签属性。
`-show_bg \| -hide_bg`	显示或隐藏等值线标签的背景。
`-show_index \| -hide_index`	显示或隐藏等值线标签的索引。
`-spacing <intValue>`	设置等值线标签的间距。

set_curve_prop

设置曲线属性。

TIP

此命令仅适用于 XY 图。

语法

tcl

set_curve_prop <stringList>
[-axis left | right] [-color <#rrggbb>] [-deriv <intValue> | -integ]
[-function <stringValue>] [-label <stringValue>]
[-line_style solid | dot | dash | dashdot | dashdotdot]
[-line_width <intValue>]
[-markers_size <intValue>]
[-markers_type circle | circlef | square | squaref | diamond |
diamondf | cross | plus]
[-plot <stringValue>]
[-reset]
[-show | -hide] [-show_legend | -hide_legend]
[-show_line | -hide_line]
[-show_markers | -hide_markers]
[-xScale <doubleValue>] [-xShift <doubleValue>]
[-yScale <doubleValue>] [-yShift <doubleValue>]

返回值

无

示例

tcl

set_curve_prop Curve_1 -label "NetActive Field (Cut from structure_1 at x=0)"

参数	说明
`<stringList>`	要应用属性的曲线列表。
`-axis left \| right`	在左侧或右侧 y 轴上绘制值。
`-color <#rrggbb>`	设置曲线的颜色。不适用于离散陷阱。
`-deriv <intValue> \| -integ`	对曲线求导（指定一阶或二阶导数），或对曲线积分。
`-function <stringValue>`	对曲线应用函数。函数的详细信息参见第 424 页的附录 D。
`-label <stringValue>`	设置曲线的标签。
`-line_style solid \| dot \| dash \| dashdot \| dashdotdot`	设置曲线线条的样式。不适用于离散陷阱。
`-line_width <intValue>`	设置曲线线条的宽度。不适用于离散陷阱。
`-markers_size <intValue>`	设置标记的大小。
`-markers_type circle \| circlef \| square \| squaref \| diamond \| diamondf \| cross \| plus`	设置曲线的标记类型。
`-plot <stringValue>`	图的名称。如未指定，则使用当前选中的图。
`-reset`	重置曲线参数。
`-show \| -hide`	显示或隐藏指定的曲线。
`-show_legend \| -hide_legend`	显示或隐藏曲线在图例中的标题。
`-show_line \| -hide_line`	显示或隐藏曲线线条。不适用于离散陷阱。
`-show_markers \| -hide_markers`	显示或隐藏曲线标记。不适用于离散陷阱。
`-xScale <doubleValue>`	设置曲线的 x 比例。
`-xShift <doubleValue>`	设置曲线的 x 位移。
`-yScale <doubleValue>`	设置曲线的 y 比例。
`-yShift <doubleValue>`	设置曲线的 y 位移。

set_cutline_prop

更改切线属性。

TIP

此命令仅适用于 2D 和 3D 图。

语法

tcl

set_cutline_prop <stringValue> -plot <stringValue>
[-handles_color <#rrggbb>]
[-label_normal | -label_op] [-label_pos 0 | 1]
[-label_size <doubleValue>] [-line_color <#rrggbb>]
[-line_style solid | dot | dash | dashdot | dashdotdot]
[-line_width <intValue>]
[-pos1 {<x> <y> [<z>]}] [-pos2 {<x> <y> [<z>]}]
[-show_handles | -hide_handles] [-show_label | -hide_label]

返回值

整数

示例

tcl

set_cutline_prop C1 -plot Plot_2D -pos1 {0.1 2.7891 0}
#-> 0

参数	说明
`<stringValue>`	要返回其属性的切线名称。
`-plot <stringValue>`	切线所在图的名称。
`-handles_color <#rrggbb>`	设置手柄的颜色。
`-label_normal \| -label_op`	设置标签相对于切线端点的显示侧。
`-label_pos 0 \| 1`	设置标签位置。值 0 或 1 表示切线的边缘。
`-label_size <doubleValue>`	设置切线的标签大小。
`-line_color <#rrggbb>`	设置切线的颜色。
`-line_style solid \| dot \| dash \| dashdot \| dashdotdot`	设置切线的样式。
`-line_width <intValue>`	设置切线的宽度。
`-pos1 {<x> <y> [<z>]}`	设置切线第一个点的位置。
`-pos2 {<x> <y> [<z>]}`	设置切线第二个点的位置。
`-show_handles \| -hide_handles`	显示或隐藏切线的手柄。
`-show_label \| -hide_label`	显示或隐藏切线的标签。

set_cutplane_prop

更改切面属性。

TIP

此命令仅适用于 3D 图。

语法

tcl

set_cutplane_prop <stringValue> -plot <stringValue>
[-at <doubleValue> | -normal {<X> <Y> <Z>} -origin {<X> <Y> <Z>}]
[-label_position <intValue>]
[-label_size <doubleValue>]
[-show_label | -hide_label]

返回值

整数

示例

tcl

set_cutplane_prop C1 -plot Plot_3D -at 0.483
#-> 0

参数	说明
`<stringValue>`	要更改属性的切面名称。
`-plot <stringValue>`	切面所在图的名称。
`-at <doubleValue> \| -normal {<X> <Y> <Z>} -origin {<X> <Y> <Z>}`	设置切面位置的值。如果切面是 `-at` 类型，则可以使用 `-at` 属性。否则，可以更改 `normal` 和 `origin` 属性。
`-label_position <intValue>`	设置标签位置。值可以为 0、1 或 2，表示切面的不同角。
`-label_size <doubleValue>`	设置切面的标签大小。
`-show_label \| -hide_label`	显示或隐藏切面的标签。

set_deformation

设置结构的变形属性，或使用已变形的结构创建图。

TIP

此命令仅适用于 2D 和 3D 图。

语法

tcl

set_deformation <stringValue>
[-factor <doubleValue> | -reset] [-new_plot]
[-plot <stringValue>]

返回值

受影响的图名称（字符串）

示例

tcl

set_deformation -plot Plot_n60_des Displacement-V -factor 1e2
#-> Plot_n60_des

参数	说明
`<stringValue>`	用于变形结构的矢量场名称。
`-factor <doubleValue> \| -reset`	要应用于变形的因子。值必须大于零。如未指定，默认值为 1。或者重置当前变形。
`-new_plot`	创建一个新图。
`-plot <stringValue>`	用于变形结构的图的名称。如未指定，则使用当前选中的图。

set_ellipse_prop

设置椭圆的属性。

语法

tcl

set_ellipse_prop <stringValue>
[-fill_color <#rrggbb>] [-line_color <#rrggbb>]
[-line_style solid | dot | dash | dashdot | dashdotdot]
[-line_width <intValue>] [-p1 <doubleList>] [-p2 <doubleList>]
[-plot <stringValue>]

返回值

字符串

示例

tcl

set_ellipse_prop Ellipse_1 -fill_color red -line_style dash
#-> 0

参数	说明
`<stringValue>`	椭圆名称。
`-fill_color <#rrggbb>`	指定椭圆的填充颜色。默认值：透明。
`-line_color <#rrggbb>`	指定椭圆线条的颜色。
`-line_style solid \| dot \| dash \| dashdot \| dashdotdot`	指定椭圆线条的样式。
`-line_width <intValue>`	指定线条宽度。
`-p1 <doubleList>`	指定椭圆所在隐形矩形的左上角。
`-p2 <doubleList>`	指定椭圆所在隐形矩形的右下角。
`-plot <stringValue>`	命令搜索椭圆所在的图名称。如未指定，则使用当前选中的图。

set_field_prop

为指定场名称设置场属性。如果未指定场名称，则为当前选中场设置属性。

TIP

此命令仅适用于 2D 和 3D 图。

语法

tcl

set_field_prop <stringValue>
[-contour_labels_on | -contour_labels_off]
[-custom_levels <doubleList> |
-scale (linear | log | asinh | logabs) -levels <intValue>]
[-geom <stringValue>] [-interpolated_values | -primary_values]
[-label <stringValue>] [-line_color <stringValue>]
[-line_width <intValue>]
[-max <doubleValue>] [-max_auto | -max_fixed]
[-min <doubleValue>] [-min_auto | -min_fixed]
[-plot <stringValue>] [-range {<min> <max>} | -reset]
[-show | -hide] [-show_bands | -hide_bands]

返回值

整数

示例

tcl

set_field_prop -range {-1e20 1e20}
#-> 0

参数	说明
`<stringValue>`	场的名称。
`-contour_labels_on \| -contour_labels_off`	显示或隐藏选中场的等值线标签。
`-custom_levels <doubleList>`	指定自定义级别列表。
`-geom <stringValue>`	数据集（或几何体）的名称。如未指定，则使用当前活动图中的主数据集。
`-interpolated_values \| -primary_values`	指定是使用单元格的主值还是在顶点上的插值进行可视化（此属性仅对在单元格上定义的场有效）。
`-label <stringValue>`	指定选中场的标签。
`-line_color <color>`	设置等值线颜色。
`-line_width <intValue>`	设置等值线的宽度。
`-max <doubleValue>`	设置场的最大值。
`-max_auto \| -max_fixed`	自动设置场的最大值，或将场的最大值固定为用户定义的值。如果指定了 `-max_fixed`，例如当图链接时，对场值的更改不会更新范围。
`-min <doubleValue>`	设置场的最小值。
`-min_auto \| -min_fixed`	自动设置场的最小值，或将场的最小值固定为用户定义的值。如果指定了 `-min_fixed`，例如当图链接时，对场值的更改不会更新范围。
`-plot <stringValue>`	图的名称。如未指定，则使用当前选中的图。
`-range {<min> <max>} \| -reset`	设置场等值线图的范围，或重置为默认值。
`-scale linear \| log \| asinh \| logabs -levels <intValue>`	使用指定的级别数设置比例。默认是线性。不要与 `-custom_levels` 参数一起使用。
`-show \| -hide`	显示或隐藏等值线图。
`-show_bands \| -hide_bands`	显示或隐藏等值线带。

set_grid_prop

设置网格属性。

TIP

此命令仅适用于 XY 图和 2D 图。

语法

tcl

set_grid_prop
[-align left | right]
[-line1_color <#rrggbb>]
[-line1_style solid | dot | dash | dashdot | dashdotdot]
[-line1_width <intValue>]
[-line2_color <#rrggbb>]
[-line2_style solid | dot | dash | dashdot | dashdotdot]
[-line2_width <intValue>]
[-plot <stringValue>]
[-reset] [-show | -hide] [-show_minor_lines | -hide_minor_lines]

返回值

无

示例

tcl

set_grid_prop -show_minor_lines

参数	说明
`-align left \| right`	将网格对齐到左侧或右侧（仅适用于 XY 图）。
`-line1_color <#rrggbb>`	设置主网格线的颜色。
`-line1_style solid \| dot \| dash \| dashdot \| dashdotdot`	设置主网格线的样式（仅适用于 XY 图）。
`-line1_width <intValue>`	设置主网格线的宽度。
`-line2_color <#rrggbb>`	设置次网格线的颜色。
`-line2_style solid \| dot \| dash \| dashdot \| dashdotdot`	设置次网格线的样式（仅适用于 XY 图）。
`-line2_width <intValue>`	设置次网格线的宽度。
`-plot <stringValue>`	图的名称。如未指定，则使用当前选中的图。
`-reset`	重置图的网格属性（仅适用于 XY 图）。
`-show \| -hide`	显示或隐藏主网格线。
`-show_minor_lines \| -hide_minor_lines`	显示或隐藏次网格线。

set_legend_prop

设置图例属性。

以下属性仅适用于 XY 图：-color_bg、-color_fg、-label_font_size、-location 和 -margins。

以下属性适用于 2D 和 3D 图：label_format、nof_labels、-orientation 和 -precision。

语法

tcl

set_legend_prop
[-color_bg <#rrggbb>]
[-color_fg <#rrggbb>]
[-label_font_att normal | bold | italic | underline | strikeout]
[-label_font_color <#rrggbb>]
[-label_font_factor <doubleValue>]
[-label_font_family arial | courier | times]
[-label_font_size <intValue>]
[-label_format preferred | scientific | engineering | fixed]
[-location top_left | top_right | bottom_left | bottom_right]
[-margins <intList>] [-nof_labels <intValue>]
[-orientation vertical | horizontal]
[-plot <stringValue>]
[-position {<x> <y>}]
[-precision <intValue>] [-reset]
[-show_background | -hide_background] [-size {<x> <y>}]
[-title_font_att normal | bold | italic | underline | strikeout]
[-title_font_color <#rrggbb>]
[-title_font_factor <doubleValue>]
[-title_font_family arial | courier | times]

返回值

无

示例

tcl

set_legend_prop -nof_labels 4 -orientation horizontal

参数	说明
`-color_bg <#rrggbb>`	设置背景颜色（仅适用于 XY 图）。
`-color_fg <#rrggbb>`	设置前景颜色（仅适用于 XY 图）。
`-label_font_att normal \| bold \| italic \| underline \| strikeout`	设置标签字体的属性。
`-label_font_color <#rrggbb>`	设置标签的字体颜色。
`-label_font_factor <doubleValue>`	通过指定用于调整字体大小的因子来设置标签的字体大小（仅适用于 2D 和 3D 图）。
`-label_font_family arial \| courier \| times`	设置标签字体。
`-label_font_size <intValue>`	通过指定整数来设置标签的字体大小（仅适用于 XY 图）。
`-label_format <stringValue>`	设置标签格式（仅适用于 2D 和 3D 图）。
`-location top_left \| top_right \| bottom_left \| bottom_right`	设置图例位置（仅适用于 XY 图）。
`-margins <intList>`	设置图例边距（仅适用于 XY 图）。
`-nof_labels <intValue>`	设置标签数量（仅适用于 2D 和 3D 图）。
`-orientation vertical \| horizontal`	设置图例方向（仅适用于 2D 和 3D 图）。
`-plot <stringValue>`	图的名称。如未指定，则使用当前选中的图。
`-position {<x> <y>}`	设置归一化到窗口坐标（0 到 1 之间）的图例位置。
`-precision <intValue>`	设置标签的精度（仅适用于 2D 和 3D 图）。
`-reset`	重置图例属性。
`-show_background \| -hide_background`	将图例背景设置为实色或半透明。
`-size {<x> <y>}`	设置归一化到窗口坐标的图例大小。
`-title_font_att normal \| bold \| italic \| underline \| strikeout`	设置图例标题字体的属性。
`-title_font_color <#rrggbb>`	设置图例标题的字体颜色。
`-title_font_factor <doubleValue>`	使用用于调整字体大小的因子来设置图例标题的字体大小。
`-title_font_family arial \| courier \| times`	设置图例标题字体。

set_light_prop

设置光源配置属性。

TIP

此命令仅适用于 3D 图。

语法

tcl

set_light_prop
[-back_azimuth <doubleValue>] [-back_elevation <doubleValue>]
[-back_ratio <doubleValue>] [-back_warmth <doubleValue>]
[-fill_azimuth <doubleValue>] [-fill_elevation <doubleValue>]
[-fill_ratio <doubleValue>] [-fill_warmth <doubleValue>]
[-head_ratio <doubleValue>] [-head_warmth <doubleValue>]
[-key_azimuth <doubleValue>] [-key_elevation <doubleValue>]
[-key_intensity <doubleValue>] [-key_warmth <doubleValue>]
[-plot <stringValue>] [-reset]

返回值

整数

示例

tcl

set_light_prop -key_elevation 78.5
#-> 0

参数	说明
`-back_azimuth <doubleValue>`	设置背光方位角。
`-back_elevation <doubleValue>`	设置背光仰角。
`-back_ratio <doubleValue>`	设置主光源与背光的比率。
`-back_warmth <doubleValue>`	设置背光的暖度。
`-fill_azimuth <doubleValue>`	设置填充光方位角。
`-fill_elevation <doubleValue>`	设置填充光仰角。
`-fill_ratio <doubleValue>`	设置主光源与填充光的比率。
`-fill_warmth <doubleValue>`	设置填充光的暖度。
`-head_ratio <doubleValue>`	设置主光源与头光的比率。
`-head_warmth <doubleValue>`	设置头光的暖度。
`-key_azimuth <doubleValue>`	设置主光源方位角。
`-key_elevation <doubleValue>`	设置主光源仰角。
`-key_intensity <doubleValue>`	设置主光源强度。
`-key_warmth <doubleValue>`	设置主光源的暖度。
`-plot <stringValue>`	要设置属性的图名称。如未指定，则使用当前选中的图。
`-reset`	将光源属性重置为默认值。

set_line_prop

设置线条的属性。

语法

tcl

set_line_prop <stringValue>
[-line_color <#rrggbb>]
[-line_style solid | dot | dash | dashdot | dashdotdot]
[-line_width <intValue>] [-p1 <doubleList>] [-p2 <doubleList>]
[-plot <stringValue>]

返回值

字符串

示例

tcl

set_line_prop Line_1 -line_style dot -line_width 2
#-> 0

参数	说明
`<stringValue>`	线条名称。
`-line_color <#rrggbb>`	指定线条颜色。
`-line_style solid \| dot \| dash \| dashdot \| dashdotdot`	指定线条样式（仅适用于 XY 图）。
`-line_width <intValue>`	指定线条宽度。
`-p1 <doubleList>`	指定线条的起点。
`-p2 <doubleList>`	指定线条的终点。
`-plot <stringValue>`	命令搜索线条所在的图名称。如未指定，则使用当前选中的图。

set_material_prop

设置材料属性。

如未指定 -plot，则为当前选中的材料设置属性。

TIP

此命令仅适用于 2D 和 3D 图。

语法

tcl

set_material_prop <stringList>
[-border_color <#rrggbb>] [-border_width <intValue>]
[-color <#rrggbb>]
[-geom <stringValue>]
[-mesh_color <#rrggbb>] [-mesh_width <intValue>]
[-on | -off]
[-particles_size <doubleValue>]
[-plot <stringValue>]
[-show_all | -hide_all] [-show_border | -hide_border]
[-show_bulk | -hide_bulk] [-show_field | -hide_field]
[-show_mesh | -hide_mesh] [-show_vector | -hide_vector]
[-translucency_level <doubleValue>]
[-translucency_on | -translucency_off]

返回值

整数

示例

tcl

set_material_prop {Oxide Silicon} -show_field
#-> 0

参数	说明
`<stringList>`	要应用指定属性的材料列表。
`-border_color <#rrggbb>`	指定材料的边框颜色。颜色格式应为 RGB（参见第 221 页的"颜色"）。
`-border_width <intValue>`	指定所选材料的边框宽度（以像素为单位）。默认宽度为 1 像素，以下情况除外：耗尽区和叠加层的默认宽度为 2 像素；结线的默认宽度为 3 像素；接触线和界面的默认宽度为 2 像素（2D 几何体）或 3 像素（3D 几何体）。
`-color <#rrggbb>`	指定材料的体颜色。颜色格式应为 RGB（参见第 221 页的"颜色"）。
`-geom <stringValue>`	数据集（或几何体）的名称。如未指定，则使用当前活动图中的主几何体。
`-mesh_color <#rrggbb>`	指定材料的网格颜色。颜色格式应为 RGB（参见第 221 页的"颜色"）。
`-mesh_width <intValue>`	指定所选材料的网格宽度（以像素为单位）。默认宽度为 1 像素，以下情况除外：界面区域的默认宽度为 2 像素。
`-on \| -off`	显示或隐藏材料。
`-particles_size <doubleValue>`	设置粒子（动力学蒙特卡罗）材料的粒子大小。
`-plot <stringValue>`	图的名称。如未指定，则使用当前选中的图。
`-show_all \| -hide_all`	显示或隐藏材料的所有属性。
`-show_border \| -hide_border`	显示或隐藏材料的边框。
`-show_bulk \| -hide_bulk`	显示或隐藏材料的体。
`-show_field \| -hide_field`	显示或隐藏材料的标量场。
`-show_mesh \| -hide_mesh`	显示或隐藏材料的网格。
`-show_vector \| -hide_vector`	显示或隐藏材料的矢量场。
`-translucency_level <doubleValue>`	当指定 `-translucency_on` 时，指定半透明度级别。
`-translucency_on \| -translucency_off`	激活或停用材料的半透明度。

set_plot_prop

设置图的属性。

语法

tcl

set_plot_prop
[-axes_interchanged | -not_axes_interchanged]
[-bg_gradient | -bg_solid]
[-caption_font_size <intValue>]
[-caption_leader_on | -caption_leader_off]
[-caption_material | -caption_region]
[-color_bg <#rrggbb>] [-color_fg <#rrggbb>]
[-color_map default | grayscale | custom]
[-color_palette <doubleList>]
[-contacts_color constant | list | map]
[-e_path_limit | -disable_path_limit]
[-frame_width <intValue>] [-gradient_colors <stringValue>]
[-keep_aspect_ratio | -not_keep_aspect_ratio]
[-material_colors classic | vivid]
[-path_depth <intValue>]
[-plot <stringList>]
[-ratio_xtoy <doubleValue>] [-reset]
[-show | -hide] [-show_axes | -hide_axes]
[-show_axes_label | -hide_axes_label]
[-show_axes_title | -hide_axes_title]
[-show_cube_axes | -hide_cube_axes]
[-show_curve_lines | -hide_curve_lines]
[-show_curve_markers | -hide_curve_markers]
[-show_grid | -hide_grid] [-show_legend | -hide_legend]
[-show_major_ticks | -hide_major_ticks]
[-show_max_marker | -hide_max_marker]
[-show_min_marker | -hide_min_marker]
[-show_minor_ticks | -hide_minor_ticks] [-show_path | -hide_path]
[-show_regions_bg | -hide_regions_bg] [-show_title | -hide_title]
[-tdr_state <stringValue> | -tdr_state_index <intValue>]
[-title <stringValue>]
[-title_font_att normal | bold | italic | underline | strikeout]
[-title_font_color <#rrggbb>]
[-title_font_factor <doubleValue>]
[-title_font_family arial | courier | times]
[-title_font_size <intValue>]
[-transformation {<x> <y> <z>}]

返回值

无

示例

tcl

set_plot_prop -title "Example 3D Structure"

set_plot_prop -plot "Plot_n98_des Plot_n99_des" -color_bg #aa4534

参数	说明
`-axes_interchanged \| -not_axes_interchanged`	交换轴（仅适用于 XY 图）。
`-bg_gradient \| -bg_solid`	将图背景设置为渐变或纯色（仅适用于 2D 和 3D 图）。
`-caption_font_size <intValue>`	设置标题字体大小（仅适用于 3D 图）。
`-caption_leader_on \| -caption_leader_off`	设置标题引导线的可见性（仅适用于 3D 图）。
`-caption_material \| -caption_region`	指定是显示材料名称还是区域名称作为标题。
`-color_bg <#rrggbb>`	设置激活纯色背景时使用的背景颜色。
`-color_fg <#rrggbb>`	设置前景颜色。
`-color_map default \| grayscale \| custom`	设置图中使用的色图（仅适用于 2D 和 3D 图）。值说明：设为 `default` 时使用正常色图（完整调色板）；设为 `grayscale` 时仅使用灰度颜色；设为 `custom` 时使用 `-color_palette` 参数设置的自定义调色板。
`-color_palette <doubleList>`	设置自定义调色板的值。提供的列表必须为每个所需的 RGB 颜色包含三个 0.0 到 1.0 之间的值，例如 `{0.0 0.0 0.0 1.0 0.0 0.0}` 表示从黑色到红色的调色板。
`-contacts_color constant \| list \| map`	设置接触颜色的行为。`list` 和 `map` 选项需要首先在用户偏好中配置。
`-e_path_limit \| -disable_path_limit`	激活或停用图标题中显示路径时的路径限制。
`-frame_width <intValue>`	设置图框宽度，必须是正整数且小于 8（仅适用于 XY 图）。
`-gradient_colors <stringValue>`	选择渐变背景时设置要使用的背景颜色（仅适用于 2D 和 3D 图）。参数是两个颜色的列表，第一个用作顶部颜色，第二个用作底部颜色。
`-keep_aspect_ratio \| -not_keep_aspect_ratio`	配置纵横比（仅适用于 2D 和 3D 图）。
`-material_colors classic \| vivid`	设置用于材料的配色方案（仅适用于 2D 和 3D 图）。
`-path_depth <intValue>`	设置图标题中显示的路径目录名数量（当激活时）。此数字不计文件名。必须指定 0 到 99 之间的整数。
`-plot <stringList>`	指定图名称列表。如未指定，则使用当前选中的图。
`-ratio_xtoy <doubleValue>`	设置图的 x 与 y 的比率（仅适用于 2D 图）。
`-reset`	重置图属性。
`-show \| -hide`	显示或隐藏图。
`-show_axes \| -hide_axes`	显示或隐藏轴。
`-show_axes_label \| -hide_axes_label`	显示或隐藏轴标签。
`-show_axes_title \| -hide_axes_title`	显示或隐藏轴标题。
`-show_cube_axes \| -hide_cube_axes`	显示或隐藏立方体轴（仅适用于 3D 图）。
`-show_curve_lines \| -hide_curve_lines`	显示或隐藏曲线线条（仅适用于 XY 图）。
`-show_curve_markers \| -hide_curve_markers`	显示或隐藏曲线标记（仅适用于 XY 图）。
`-show_grid \| -hide_grid`	显示或隐藏网格（仅适用于 XY 图和 2D 图）。
`-show_legend \| -hide_legend`	显示或隐藏图的图例。
`-show_major_ticks \| -hide_major_ticks`	显示或隐藏主刻度（仅适用于 3D 图）。
`-show_max_marker \| -hide_max_marker`	显示或隐藏最大值标记（仅适用于 2D 和 3D 图）。
`-show_min_marker \| -hide_min_marker`	显示或隐藏最小值标记（仅适用于 2D 和 3D 图）。
`-show_minor_ticks \| -hide_minor_ticks`	显示或隐藏次刻度（仅适用于 3D 图）。
`-show_path \| -hide_path`	在图标题中显示或隐藏路径。
`-show_regions_bg \| -hide_regions_bg`	显示或隐藏区域的背景颜色。
`-show_title \| -hide_title`	显示或隐藏图的标题。
`-tdr_state <stringValue> \| -tdr_state_index <intValue>`	根据状态名称或状态索引设置当前的 TDR 状态（仅适用于 2D 和 3D 图）。要显示最后一个状态，请指定 `-tdr_state_index -1`。
`-title <stringValue>`	图的标题。
`-title_font_att normal \| bold \| italic \| underline \| strikeout`	设置标题字体的属性。
`-title_font_color <#rrggbb>`	设置标题字体颜色。
`-title_font_factor <doubleValue>`	将字体大小乘以一个因子（仅适用于 2D 和 3D 图）。
`-title_font_family arial \| courier \| times`	设置标题字体。
`-title_font_size <intValue>`	设置标题的字体大小（仅适用于 XY 图）。
`-transformation {<x> <y> <z>}`	设置线性坐标变换（仅适用于 3D 图）。

set_rectangle_prop

设置矩形的属性。

语法

tcl

set_rectangle_prop <stringValue>
[-fill_color <#rrggbb>] [-line_color <#rrggbb>]
[-line_style solid | dot | dash | dashdot | dashdotdot]
[-line_width <intValue>] [-p1 <doubleList>] [-p2 <doubleList>]
[-plot <stringValue>]

返回值

字符串

示例

tcl

set_rectangle_prop Rectangle_1 -line_width 5
#-> 0

参数	说明
`<stringValue>`	矩形名称。
`-fill_color <#rrggbb>`	指定矩形的填充颜色。默认是透明（仅适用于 XY 图）。
`-line_color <#rrggbb>`	指定矩形的线条颜色。
`-line_style solid \| dot \| dash \| dashdot \| dashdotdot`	指定矩形的线条样式（仅适用于 XY 图）。
`-line_width <intValue>`	指定矩形的线条宽度。
`-p1 <doubleList>`	指定矩形的左下角。
`-p2 <doubleList>`	指定矩形的右上角。
`-plot <stringValue>`	命令搜索矩形所在的图名称。如未指定，则使用当前选中的图。

set_region_prop

设置区域属性。

如未指定 -plot，则为当前选中的区域设置属性。

TIP

此命令仅适用于 2D 和 3D 图。

语法

tcl

set_region_prop <stringList>
[-border_color <#rrggbb>] [-border_width <intValue>]
[-color <#rrggbb>]
[-geom <stringValue>]
[-mesh_color <#rrggbb>] [-mesh_width <intValue>]
[-on | -off]
[-particles_size <doubleValue>]
[-plot <stringValue>]
[-show_all | -hide_all] [-show_border | -hide_border]
[-show_bulk | -hide_bulk] [-show_caption | -hide_caption]
[-show_field | -hide_field]
[-show_mesh | -hide_mesh] [-show_vector | -hide_vector]
[-translucency_level <doubleValue>]
[-translucency_on | -translucency_off]

返回值

整数

示例

tcl

set_region_prop {source gate drain} -show_mesh
#-> 0

参数	说明
`<stringList>`	要应用属性的图的区域列表。
`-plot <stringValue>`	图的名称。如未指定，则使用当前选中的图。
`-geom <stringValue>`	数据集（或几何体）的名称。如未指定，则使用当前活动图中的主数据集。
`-border_color <#rrggbb>`	指定区域的边框颜色。颜色格式应为 RGB（参见第 221 页的"颜色"）。
`-border_width <intValue>`	指定所选区域的边框宽度（以像素为单位）。默认宽度为 1 像素，以下情况除外：耗尽区和叠加层的默认宽度为 2 像素；结线的默认宽度为 3 像素；接触线和界面的默认宽度为 2 像素（2D 几何体）或 3 像素（3D 几何体）。
`-color <#rrggbb>`	指定区域的体颜色。颜色格式应为 RGB（参见第 221 页的"颜色"）。
`-mesh_color <#rrggbb>`	指定区域的网格颜色。颜色格式应为 RGB（参见"颜色"）。
`-mesh_width <intValue>`	指定所选区域的网格宽度（以像素为单位）。默认宽度为 1 像素，以下情况除外：界面区域的默认宽度为 2 像素。
`-on \| -off`	显示或隐藏区域。
`-particles_size <doubleValue>`	设置粒子（动力学蒙特卡罗）区域的粒子大小。
`-show_all \| -hide_all`	显示或隐藏区域的所有属性。
`-show_border \| -hide_border`	显示或隐藏区域的边框。
`-show_bulk \| -hide_bulk`	显示或隐藏区域的体。
`-show_caption \| -hide_caption`	显示或隐藏标题（仅适用于 3D 图）。
`-show_field \| -hide_field`	显示或隐藏区域的标量场。
`-show_mesh \| -hide_mesh`	显示或隐藏区域的网格。
`-show_vector \| -hide_vector`	显示或隐藏区域的矢量场。
`-translucency_level <doubleValue>`	当指定 `-translucency_on` 时，指定半透明度级别。
`-translucency_on \| -translucency_off`	激活或停用区域的半透明度。

set_ruler_prop

设置标尺属性。

TIP

此命令仅适用于 2D 和 3D 图。

语法

tcl

set_ruler_prop
[-color <#rrggbb>] [-id <intValue>]
[-plot <stringValue>]
[-pos1 <stringValue>] [-pos2 <stringValue>]
[-precision <intValue>]
[-show_label | -hide_label]
[-snap_on | -snap_off] [-snap_type none | both | corner | edge]
[-width <intValue>]

返回值

字符串

示例

tcl

set_ruler_prop -width 5 -precision 2
#-> 0

参数	说明
`-color <#rrggbb>`	设置标尺的颜色。
`-id <intValue>`	指定命令搜索属性的标尺 ID。如未指定，则使用最后选中的标尺。
`-plot <stringValue>`	命令应用属性的图名称。如未指定，则使用当前选中的图。
`-pos1 <stringValue>`	设置标尺第一个点的位置。
`-pos2 <stringValue>`	设置标尺第二个点的位置。
`-precision <intValue>`	设置测量的小数精度。
`-show_label \| -hide_label`	指定是否显示或隐藏标尺标签。
`-snap_on \| -snap_off`	指定是否激活网格吸附功能。
`-snap_type none \| both \| corner \| edge`	指定要应用于 Sentaurus Process Explorer 结构的吸附类型。`none` 和 `both` 选项分别是 `-snap_off` 和 `-snap_on` 的别名。`corner` 和 `edge` 选项控制是吸附到区域角点还是区域边缘。
`-width <intValue>`	设置标尺的宽度（以像素为单位）。

set_streamline_prop

设置流线的属性。

TIP

此命令仅适用于 2D 和 3D 图。

语法

tcl

set_streamline_prop <stringList> -plot <stringValue>
[-arrow_angle <intValue>] [-arrow_color <#rrggbb>]
[-arrow_size <doubleValue>] [-arrow_step <doubleValue>]
[-arrow_style solid | dash | dot | dashdot | dashdotdot]
[-arrow_width <intValue>] [-constant_arrow | -normal_arrow]
[-line_color <#rrggbb>] [-line_resolution <doubleValue>]
[-line_style solid | dash | dot | dashdot | dashdotdot]
[-line_width <intValue>]
[-positive_direction | -negative_direction]
[-show_arrows | -hide_arrows] [-show_line | -hide_line]

返回值

整数

示例

tcl

set_streamline_prop Streamline_1 -plot Plot_2D -arrow_angle 45
#-> 0

参数	说明
`<stringList>`	要修改的流线列表。
`-plot <stringValue>`	命令搜索流线的图名称。如未指定，则使用当前选中的图。
`-arrow_angle <intValue>`	指定箭头角度（以度为单位）。必须在 1 到 89 之间。
`-arrow_color <#rrggbb>`	指定箭头的颜色。
`-arrow_size <doubleValue>`	指定箭头的大小。
`-arrow_step <doubleValue>`	指定箭头之间的步长。此值必须大于线条分辨率。
`-arrow_style solid \| dash \| dot \| dashdot \| dashdotdot`	指定箭头线条样式。
`-arrow_width <intValue>`	指定箭头头的宽度。
`-constant_arrow \| -normal_arrow`	指定无论缩放级别如何，屏幕上箭头头的大小是否不变（`-constant_arrow`），还是屏幕上箭头头的大小随缩放级别变化（`-normal_arrow`）。
`-line_color <#rrggbb>`	指定线条的颜色。
`-line_resolution <doubleValue>`	指定构成线条的点之间的距离。较低的值意味着更好的线条质量但性能更低。
`-line_style solid \| dash \| dot \| dashdot \| dashdotdot`	指定线条样式。
`-line_width <intValue>`	指定线条的宽度。
`-positive_direction \| -negative_direction`	指定箭头是正常显示还是反转显示。默认值：`-positive_direction`。
`-show_arrows \| -hide_arrows`	显示或隐藏箭头。
`-show_line \| -hide_line`	显示或隐藏线条。

set_tag_prop

设置 TDR 标签的可见性或图中自定义文本框的文本。

TIP

此命令仅适用于 2D 和 3D 图。

语法

tcl

set_tag_prop [-key <stringList> | -custom_text <stringValue>]
[-plot <stringValue>]
[-show | -hide]

返回值

无

示例

tcl

set_tag_prop -key Name -show
#->

参数	说明
`-key <stringList>`	指定要显示或隐藏的 TDR 标签。标签指定为 `group1 group2 ... grouN tag_name`，定义组层次结构和标签名称。标签在图中显示为 `tag_name: tag_value`，按在 TDR 文件中定义的顺序排序。
`-custom_text <stringValue>`	指定自定义标签的文本。除非指定了 `-show`，否则不显示文本。
`-plot <stringValue>`	要显示标签的图名称。如未指定，则使用当前选中的图。
`-show \| -hide`	显示或隐藏文本。

set_textbox_prop

设置文本框的指定属性。

TIP

此命令仅适用于 XY 图和 2D 图。

语法

tcl

set_textbox_prop <stringValue>
[-anchor_pos {<x> <y>}] [-arrow_size <intValue>]
[-font_att normal | bold | italic | underline | strikeout]
[-font_color <#rrggbb>] [-font_factor <doubleValue>]
[-font_family arial | courier | times] [-font_size <intValue>]
[-line_color <#rrggbb>]
[-line_style solid | dot | dash | dashdot | dashdotdot]
[-line_width <intValue>]
[-plot <stringValue>]
[-pos {<x> <y>}] [-rotation <intValue>]
[-show_anchor | -hide_anchor] [-show_border | -hide_border]
[-text <stringValue>]

返回值

整数

示例

tcl

set_textbox_prop Textbox_1 -text "Label Text" -font_color #ff0000
#-> 0

参数	说明
`<stringValue>`	要修改的文本框名称。
`-anchor_pos {<x> <y>}`	使用世界坐标系指定锚点位置（仅适用于 2D 图）。
`-arrow_size <intValue>`	指定箭头大小（仅适用于 2D 图）。
`-font_att normal \| bold \| italic \| underline \| strikeout`	指定文本的字体属性。可以使用花括号组合多个属性，例如：`-font_att {bold italic}`。
`-font_color <#rrggbb>`	指定文本字体的颜色。
`-font_factor <doubleValue>`	指定文本字体的倍数（仅适用于 2D 图）。
`-font_family arial \| courier \| times`	指定文本字体系列。
`-font_size <intValue>`	指定字体大小（仅适用于 XY 图）。
`-line_color <#rrggbb>`	指定线条和箭头的颜色（仅适用于 2D 图）。
`-line_style solid \| dot \| dash \| dashdot \| dashdotdot`	指定文本框线条的表示样式（仅适用于 2D 图）。
`-line_width <intValue>`	指定文本框和锚点线条的宽度（仅适用于 2D 图）。
`-plot <stringValue>`	命令搜索文本框的图名称。如未指定，则使用当前选中的图。
`-pos {<x> <y>}`	指定文本框的左下角位置。对于 XY 图，这是世界坐标系 {x, y} 中的一个点。对于 2D 图，这是归一化屏幕坐标对（从 0.0 到 1.0）。
`-rotation <intValue>`	指定文本框的旋转角度（以度为单位，仅适用于 XY 图）。
`-show_anchor \| -hide_anchor`	显示或隐藏文本框锚点（仅适用于 2D 图）。
`-show_border \| -hide_border`	显示或隐藏文本框边框（仅适用于 2D 图）。
`-text <stringValue>`	指定文本框中的文本。

set_transformation

对特定几何体应用变换。可以缩放几何体、移动几何体，或同时进行缩放和移动。

TIP

此命令仅适用于 2D 和 3D 图。

语法

tcl

set_transformation
-scale {<scaleX> <scaleY> <scaleZ>} |
-shift {<shiftX> <shiftY> <shiftZ>} |
-scale {<scaleX> <scaleY> <scaleZ>} -shift {<shiftX> <shiftY> <shiftZ>}
[-geom <stringValue>] [-plot <stringValue>]

返回值

整数

示例

tcl

set_transformation -scale {0.5 1 1}
#-> 0

参数	说明
`-scale {<scaleX> <scaleY> <scaleZ>}`	设置或返回轴的缩放值。列表形式为 `{x y z}`，其中参数 x、y 和 z 是表示应用于每个轴的缩放值的正双精度数。
`-shift {<shiftX> <shiftY> <shiftZ>}`	设置或返回轴的移动值。列表形式为 `{x y z}`，其中参数 x、y 和 z 是表示应用于每个轴的移动值的双精度数。
`-geom <stringValue>`	要应用变换的几何体名称。
`-plot <stringValue>`	要获取几何体的图名称。

set_value_blanking

设置值空白。

如未指定 -field，则使用选中的场。

TIP

此命令仅适用于 2D 和 3D 图。

语法

tcl

set_value_blanking -field <stringValue>
-less <doubleValue> | -greater <doubleValue> | -reset
[-blank all | any | inter] [-cons <intValue>]
[-plot <stringValue>] [-union | -intersection]

返回值

整数

示例

tcl

set_value_blanking -field DopingConcentration -greater 0.0
#-> 0

参数	说明
`-field <stringValue>`	要设置空白参数的场的名称。
`-less <doubleValue> \| -greater <doubleValue> \| -reset`	如果指定 `-less`，则空白所有小于指定值的值。如果指定 `-greater`，则空白所有大于指定值的值。指定 `-reset` 以移除值空白规则。
`-blank all \| any \| inter`	选择值空白选项：`all` 为所有顶点；`any` 为任意顶点；`inter` 为插值顶点。如未指定，则使用 `all` 选项。
`-cons <intValue>`	值空白规则的编号。选项为 1 到 8 之间的值。默认值：1。
`-plot <stringValue>`	图的名称。如未指定，则使用当前选中的图。
`-union \| -intersection`	设置约束是合并还是相交。如未指定，则使用 `-union` 选项。

set_vector_prop

设置矢量场的属性。

TIP

此命令仅适用于 2D 和 3D 图。

语法

tcl

set_vector_prop <stringValue>
[-constant_heads | -normal_heads] [-fill_color <#rrggbb>]
[-geom <stringValue>]
[-head_angle <intValue>]
[-head_shape arrow | arrow_solid | head | head_closed | head_solid]
[-head_size <doubleValue>]
[-line_color <#rrggbb>]
[-line_pattern solid | dot | dash | dashdot | dashdotdot]
[-line_width <intValue>]
[-plot <stringValue>]
[-scale grid | uniform]
[-scale_factor_grid <doubleValue>]
[-scale_factor_uniform <doubleValue>] [-show | -hide]

返回值

整数

示例

tcl

set_vector_prop ElectricField-V -plot Plot_2D -geom 2D -scale grid
#-> 0

参数	说明
`<stringValue>`	要修改的矢量场名称。
`-constant_heads \| -normal_heads`	指定箭头是否与图的面积恒定（与矢量大小无关）还是与矢量大小成比例（正常）。
`-fill_color <#rrggbb>`	指定实心箭头头的颜色。否则此参数无效。
`-geom <stringValue>`	指定命令搜索矢量的几何体。
`-head_angle <intValue>`	指定箭头角度（以度为单位）。必须在 1 到 89 之间。
`-head_shape arrow \| arrow_solid \| head \| head_closed \| head_solid`	指定箭头的形状。
`-head_size <doubleValue>`	指定箭头长度。
`-line_color <#rrggbb>`	指定箭头的颜色。
`-line_pattern solid \| dot \| dash \| dashdot \| dashdotdot`	指定箭头的线条图案。
`-line_width <intValue>`	指定箭头的宽度。
`-plot <stringValue>`	命令搜索几何体的图名称。如未指定，则使用当前选中的图。
`-scale grid \| uniform`	指定显示箭头的比例：统一大小或网格显示。
`-scale_factor_grid <doubleValue>`	指定显示箭头的网格因子。

set_vertical_lines_prop

设置垂直线的属性。

TIP

此命令仅适用于 XY 图。

语法

tcl

set_vertical_lines_prop <stringValue>
[-line_color <#rrggbb>]
[-line_style solid | dot | dash | dashdot | dashdotdot]
[-line_width <intValue>] [-plot <stringValue>] [-show | -hide]

返回值

整数

示例

tcl

set_vertical_lines_prop VerticalLine_1 -line_style dot
#-> 0

参数	说明
`<stringValue>`	垂直线名称。
`-line_color <#rrggbb>`	指定垂直线的颜色。
`-line_style solid \| dot \| dash \| dashdot \| dashdotdot`	指定垂直线的样式。
`-line_width <intValue>`	指定垂直线的宽度（以像素为单位）。
`-plot <stringValue>`	命令搜索垂直线的图名称。如未指定，则使用当前选中的图。
`-show \| -hide`	显示或隐藏垂直线。

set_window_full

设置图的完整视图。

语法

tcl

set_window_full -on | -off

返回值

整数

示例

tcl

set_window_full -on
#-> 0

参数	说明
`-on \| -off`	激活或停用图的完整视图。

set_window_size

设置用户界面的主窗口大小。

语法

tcl

set_window_size <width>x<height>

返回值

整数

示例

tcl

set_window_size 1280x800
#-> 0

参数	说明
`<width>x<height>`	以像素为单位设置主窗口的宽度和高度（最小 200×200 像素）。

show_msg

在对话框中显示消息。

语法

tcl

show_msg <stringValue>
[-error | -info | -warning] [-title <stringValue>]

返回值

无

示例

tcl

show_msg -warning -title "Bad Value" "There was a problem extracting the threshold voltage"

参数	说明
`<stringValue>`	指定要显示的文本。
`-error \| -info \| -warning`	指定要显示的消息类型。默认值：`-info`。
`-title <stringValue>`	指定对话框的标题。

start_movie

开始录制新电影，创建新的帧缓冲区。

TIP

此命令仅开始电影的创建，因此必须使用 add_frame 和 export_movie 命令来完成操作。

语法

tcl

start_movie [-resolution <width>x<height>]

返回值

无

示例

tcl

start_movie

参数	说明
`-resolution <width>x<height>`	指定每个捕获帧的分辨率（以像素为单位）。如未指定，则使用当前屏幕分辨率。

stop_movie

停止录制电影。

TIP

此命令删除存储的帧缓冲区，不会将其保存到文件。

语法

tcl

stop_movie

返回值

无

示例

tcl

stop_movie

undo

撤消上一个实现的命令或指定的命令数。

语法

tcl

undo [<intValue>]

返回值

无

示例

tcl

undo 2

参数	说明
`<intValue>`	要撤销的命令数量。

unload_file

卸载指定文件所属的所有数据集。

语法

tcl

unload_file <stringValue>

返回值

整数

示例

tcl

unload_file structure2D.tdr
#-> 0

参数	说明
`<stringValue>`	文件名称。

version

返回 Sentaurus Visual 的版本。

语法

tcl

version

返回值

字符串

示例

tcl

version
#-> 31.0.7

windows_style

指定 Sentaurus Visual 用户界面使用的窗口样式类型。

语法

tcl

windows_style
[-aspect_ratio_on | -aspect_ratio_off]
[-direction right_down | down_right]
[-max <intValue>]
[-sort <stringList>]
[-style horizontal | vertical | grid | max | custom]

返回值

整数

示例

tcl

windows_style -style grid
#-> 0

参数	说明
`-aspect_ratio_on \| -aspect_ratio_off`	指定是否为所有显示的图保持纵横比。
`-direction right_down \| down_right`	指定图的观看方向以及它们将拉伸到的位置：使用 `right_down` 方向时，网格向右填充直到满，然后继续在新的一行中从第一行向下添加新图；使用 `down_right` 方向时，此顺序反转。
`-max <intValue>`	指定在自定义网格配置中显示图的最大列数。
`-sort <stringList>`	指定要显示的图。
`-style horizontal \| vertical \| grid \| max \| custom`	指定水平或垂直方向，或网格样式，或使用最大空间或自定义样式。

zoom_plot

放大图。

语法

tcl

zoom_plot
-axis (x | y | z) -range {<min> <max>} |
-box {<minX> <maxX> <minY> <maxY> <minZ> <maxZ>} |
-factor <doubleValue> |
-reset |
-window {<x1> <y1> [<z1>]<x2> <y2> [<z2>]}
[-plot <stringValue>]

返回值

无

示例

tcl

zoom_plot -reset

参数	说明
`-axis x \| y \| z -range {<min> <max>}`	指定应用范围的轴。`-range` 参数定义范围的最小值和最大值。
`-box {<minX> <maxX> <minY> <maxY> <minZ> <maxZ>}`	定义边界框的三个范围。
`-factor <doubleValue>`	设置缩放因子。如果值大于 1，则放大图；如果值小于 1，则缩小图。
`-reset`	重置图的缩放状态。
`-window {<x1> <y1> [<z1>]<x2> <y2> [<z2>]}`	设置缩放窗口。它放大到指定窗口之间的两个 x、y 对。对于 2D 和 3D 图，此参数仅接受四个值。对于 3D 图，这些值可以以图的帧像素（整数）形式输入，也可以归一化为屏幕值（0 到 1 之间的双精度数）。
`-plot <stringValue>`	图的名称。

附录 A：Tcl 命令参考（第 3 部分） ​

remove_datasets ​

remove_ellipses ​

remove_fields ​

remove_lines ​

remove_plots ​

remove_rectangles ​

remove_rulers ​

remove_streamlines ​

remove_textboxes ​

render_mode ​

reset_settings ​

rotate_plot ​

save_plot_to_script ​

select_plots ​

set_angle_prop ​

set_axis_prop ​

set_band_diagram ​

set_best_look ​

set_camera_prop ​

set_capacitance ​

set_contour_labels_prop ​

set_curve_prop ​

set_cutline_prop ​

set_cutplane_prop ​

set_deformation ​

set_ellipse_prop ​

set_field_prop ​

set_grid_prop ​

set_legend_prop ​

set_light_prop ​

set_line_prop ​

set_material_prop ​

set_plot_prop ​

set_rectangle_prop ​

set_region_prop ​

set_ruler_prop ​

set_streamline_prop ​

set_tag_prop ​

set_textbox_prop ​

set_transformation ​

set_value_blanking ​

set_vector_prop ​

set_vertical_lines_prop ​

set_window_full ​

set_window_size ​

show_msg ​

start_movie ​

stop_movie ​

undo ​

unload_file ​

version ​

windows_style ​

zoom_plot ​

附录 A：Tcl 命令参考（第 3 部分）

remove_datasets

remove_ellipses

remove_fields

remove_lines

remove_plots

remove_rectangles

remove_rulers

remove_streamlines

remove_textboxes

render_mode

reset_settings

rotate_plot

save_plot_to_script

select_plots

set_angle_prop

set_axis_prop

set_band_diagram

set_best_look

set_camera_prop

set_capacitance

set_contour_labels_prop

set_curve_prop

set_cutline_prop

set_cutplane_prop

set_deformation

set_ellipse_prop

set_field_prop

set_grid_prop

set_legend_prop

set_light_prop

set_line_prop

set_material_prop

set_plot_prop

set_rectangle_prop

set_region_prop

set_ruler_prop

set_streamline_prop

set_tag_prop

set_textbox_prop

set_transformation

set_value_blanking

set_vector_prop

set_vertical_lines_prop

set_window_full

set_window_size

show_msg

start_movie

stop_movie

undo

unload_file

version

windows_style

zoom_plot