Appearance
来源: Sentaurus Visual User Guide W-2024.09 PDF 第407-410页
附录 B：Python 命令
本附录描述了 Sentaurus Visual 中使用的 Python 命令。 Python 命令适用于与附录 A（第 220 页）Tcl 命令中定义的相同的绘图和结构。
概述
Sentaurus Visual Python 模式在应用程序启动时自动导入 svisual_desktop 包并命名为 sv。 该包包含本附录中介绍的所有命令。
与 Tcl 模式相同，sv.echo() 会输出到日志文件 SVisualPy.log，而 print() 函数则充当 Tcl 的 puts 命令，向标准输出打印内容。
访问 Python 命令文档
要访问 Python 命令的文档，请从 Sentaurus Visual GUI 中选择 Help > Python API Reference。
或者，可以使用 help() 函数获取命令信息：
python
help(sv.<command_name>)语法约定
每个 Python 命令都实现为一个 Python 函数，因此必须符合 Python 语法约定。
通用属性
获取属性命令
这些命令具有统一语法 get_<object>_prop()。所有这些命令都有一个名为 property 的位置参数，用于接收所请求属性的名称字符串。 有关可查询的属性列表，请参阅相应的 Tcl 命令。
设置属性命令
这些命令具有统一语法 set_<object>_prop()，并包含多个关键字参数，每个属性对应一个关键字参数。
通用属性
以下属性在多个 Python 命令中使用。
颜色
在允许指定颜色属性的命令中（如 color 参数），需要提供一个字符串来指定 RGB 系统的红、绿、蓝分量。 字符串以井号（#）开头，每个值以十六进制形式提供。 常用颜色也有别名。
TIP
颜色格式：#RRGGBB，其中每两位十六进制数表示一个颜色分量的强度（00-FF）。
表 15 常用颜色
| 别名 | 颜色预览 | 通用格式 | 别名 | 颜色预览 | 通用格式 |
|---|---|---|---|---|---|
| white | #ffffff | darkMagenta | #800080 | ||
| black | #000000 | yellow | #ffff00 | ||
| red | #ff0000 | olive | #808000 | ||
| darkRed | #800000 | orange | #ffa500 | ||
| lime | #00ff00 | darkOrange | #ff8c00 | ||
| green | #008000 | gray | #a0a0a4 | ||
| darkGreen | #006400 | darkGray | #808080 | ||
| blue | #0000ff | lightGray | #c0c0c0 | ||
| darkBlue | #000080 | skyblue | #87ceeb | ||
| cyan | #00ffff | slategray | #708090 | ||
| darkCyan | #008080 | chocolate | #d2691e | ||
| magenta | #ff00ff |
字体
对于允许调整字体属性的命令，Sentaurus Visual 定义了特定的字体系列和属性列表。
NOTE
在 XY 图中，绘图不同元素的字体大小通过 font_size 参数设置； 而在 2D 和 3D 图中，字体大小无法直接设置，而是作为绘图框架的一个因子（默认值为 1.0）通过 font_factor 参数来设置。
表 16 字体系列及其属性
| 字体系列 | 属性 |
|---|---|
| Arial | Bold（粗体） |
| Courier | Italic（斜体） |
| Times | Normal（常规） |
| Strikeout（删除线） | |
| Underline（下划线） |
线型
对于允许调整线属性的命令（如 line_style 选项），Sentaurus Visual 定义了特定的线型列表。 可以直接使用样式的名称或其短形式。
表 17 线型
| 线型名称 | 短形式 | 描述 |
|---|---|---|
| solid | _ | 实线：________ |
| dot | . | 点线：............ |
| dash | - | 虚线：------------ |
| dashdot | -. | 点划线：-.-.-.-.-.- |
| dashdotdot | -.. | 双点划线：-..-..-..-.. |
标记点
Sentaurus Visual 的 XY 图中提供了多种标记点类型。可以使用标记点的名称或其短形式。
表 18 标记点类型
| 标记点名称 | 短形式 | 描述 |
|---|---|---|
| circle | o | 圆形 |
| circlef | of | 填充圆形 |
| diamond | d | 菱形 |
| diamondf | df | 填充菱形 |
| square | s | 正方形 |
| squaref | sf | 填充正方形 |
| plus | + | 加号 |
| cross | x | 交叉号 |