XDrxAPI 9 个 SLIDE 函数帮助手册
1函数名称: xdrx-slide->bmp
描述:
将AutoCAD幻灯片文件(.sld)转换为位图文件(.bmp)
调用格式:
(xdrx-slide->bmp <幻灯片文件> [宽度 高度 [背景色]])
参数说明:
<幻灯片文件> - 幻灯片文件路径(.sld)
[宽度] - 可选，输出位图宽度(默认80，最大100)
[高度] - 可选，输出位图高度(默认60，最大100)
[背景色] - 可选，RGB背景色(如'(255 255 255)表示白色)
返回值:
- 字符串: 成功返回生成的bmp文件路径
- nil: 转换失败
示例用法:
(xdrx-slide->bmp "C:\\slides\\test.sld")
(xdrx-slide->bmp "C:\\slides\\test.sld" 100 100 '(0 0 0))
注意事项:
1. 幻灯片文件必须存在
2. 宽度和高度最大限制为100
3. 背景色为RGB格式的三个整数
4. 输出bmp文件与输入sld文件同目录
5. 需要管理员权限
------------------------------------------------------------
2
函数名称: xdrx-slide->dwg
描述:
将AutoCAD幻灯片文件(.sld/.slb)转换为DWG图元
调用格式:
(xdrx-slide->dwg <幻灯片文件> [模式 [填充标志]])
参数说明:
<幻灯片文件> - 幻灯片文件路径(.sld)或库文件(.slb)
[模式] - 可选转换模式：
"p" - 转换为多段线(默认)
"L" - 转换为直线
[填充标志] - 可选，t表示填充图形
返回值:
- 图元列表: 成功返回转换后的图元列表
- nil: 转换失败
示例用法:
(xdrx-slide->dwg "C:\\slides\\test.sld")
(xdrx-slide->dwg "C:\\slides\\lib.slb" "test" "p" t)
注意事项:
1. 幻灯片文件必须存在
2. 对于.slb库文件，需指定幻灯片名称
3. 默认转换为多段线
4. 需要管理员权限
5. 转换结果可直接用于绘图
------------------------------------------------------------
3
函数名称: xdrx-slide->slb
描述:
将一个幻灯片库(.slb)中的指定幻灯片复制到另一个幻灯片库
调用格式:
(xdrx-slide->slb <源库文件> <幻灯片名称> <目标库文件>)
参数说明:
<源库文件> - 源幻灯片库路径(.slb)
<幻灯片名称> - 要复制的幻灯片名称(支持通配符)
<目标库文件> - 目标幻灯片库路径(.slb)
返回值:
- 字符串列表: 成功返回复制的幻灯片名称列表
- nil: 复制失败
示例用法:
(xdrx-slide->slb "C:\\lib1.slb" "test*" "D:\\lib2.slb")
(xdrx-slide->slb "source.slb" "slide1" "target.slb")
注意事项:
1. 源幻灯片库必须存在
2. 目标库不存在时会自动创建
3. 幻灯片名称支持通配符匹配
4. 需要管理员权限
5. 操作后自动关闭幻灯片库文件
------------------------------------------------------------
4
函数名称: xdrx-slide->sld
描述:
从幻灯片库(.slb)中提取幻灯片到单独的.sld文件，支持指定输出目录
调用格式:
(xdrx-slide->sld <幻灯片库> <幻灯片名称> [输出目录])
参数说明:
<幻灯片库> - 幻灯片库文件路径(.slb)
<幻灯片名称> - 要提取的幻灯片名称(支持通配符，"*"表示提取所有)
[输出目录] - 可选，指定.sld文件输出目录(默认与库文件同目录)
返回值:
- 字符串列表: 成功返回提取的.sld文件完整路径列表
- nil: 提取失败
示例用法:
(xdrx-slide->sld "C:\\lib.slb" "*") ; 提取所有幻灯片
(xdrx-slide->sld "C:\\lib.slb" "test*") ; 提取test开头的幻灯片
(xdrx-slide->sld "library.slb" "slide*" "D:\\output") ; 指定输出目录
注意事项:
1. 幻灯片库必须存在
2. 幻灯片名称支持通配符匹配，"*"表示提取所有
3. 输出目录不存在时会自动创建
4. 需要管理员权限
5. 返回完整路径列表
------------------------------------------------------------
4
函数名称: xdrx-slide-add
描述:
向幻灯片库(.slb)中添加幻灯片(.sld)
调用格式:
(xdrx-slide-add <幻灯片库名> <幻灯片名> [覆盖标志])
参数说明:
* <幻灯片库名>: 目标幻灯片库文件名(可带或不带.slb扩展名)
* <幻灯片名>: 要添加的幻灯片文件名(可带或不带.sld扩展名)
* [覆盖标志]: 可选参数，T表示覆盖同名幻灯片(默认)，nil表示不覆盖
返回值:
T: 添加成功
nil: 添加失败
示例用法1:
(xdrx-slide-add "mylib" "myslide")
; 将myslide.sld添加到mylib.slb中
示例用法2:
(xdrx-slide-add "mylib.slb" "myslide.sld" nil)
; 添加幻灯片且不覆盖同名文件
实现特点:
1. 自动处理文件扩展名
2. 支持覆盖控制
3. 自动创建不存在的库文件
4. 严格的参数类型检查
注意事项:
1. 文件路径需有效
2. 幻灯片需符合AutoCAD格式
3. 默认覆盖同名幻灯片
4. 需有写入权限
5. 不检查幻灯片内容有效性
------------------------------------------------------------
5
函数名称: xdrx-slide-del
描述:
从幻灯片库中删除匹配指定模式的幻灯片(支持通配符)
调用格式:
(xdrx-slide-del <幻灯片库名> <幻灯片模式>)
参数说明:
* <幻灯片库名>: 目标幻灯片库文件名(可带或不带.slb扩展名)
* <幻灯片模式>: 要删除的幻灯片名称模式(支持*和?通配符)
返回值:
- 整数: 成功删除的幻灯片数量
- nil: 操作失败
示例用法1:
(xdrx-slide-del "mylib" "temp*")
; 删除mylib.slb中所有以temp开头的幻灯片
示例用法2:
(xdrx-slide-del "mylib.slb" "slide??")
; 删除名称类似slide01、slideAB等的幻灯片
实现特点:
1. 支持通配符模式匹配
2. 自动处理文件扩展名
3. 返回实际删除数量
4. 批量删除高效安全
注意事项:
1. 模式匹配区分大小写
2. 需有写入权限
3. 不存在的库文件返回nil
4. 空模式返回nil
------------------------------------------------------------
6
函数名称: xdrx-slide-list
描述:
列出幻灯片库中的幻灯片名称(支持前缀筛选)
调用格式:
(xdrx-slide-list <幻灯片库名> [前缀])
参数说明:
* <幻灯片库名>: 目标幻灯片库文件名(可带或不带.slb扩展名)
* [前缀]: 可选参数，筛选指定前缀的幻灯片名称
返回值:
- 列表: 匹配的幻灯片名称字符串列表
- nil: 操作失败
示例用法1:
(xdrx-slide-list "mylib")
; 返回("slide1" "slide2" "temp1")
示例用法2:
(xdrx-slide-list "mylib.slb" "temp")
; 返回("temp1" "temp2")
实现特点:
1. 支持前缀筛选
2. 自动处理文件扩展名
3. 返回LISP列表格式
4. 不区分大小写匹配
注意事项:
1. 空前缀返回全部幻灯片
2. 需有读取权限
3. 不存在的库文件返回nil
4. 单结果时自动解包
5. 返回纯名称不带扩展名
------------------------------------------------------------
7
函数名称: xdrx-slide-magic
描述:
幻灯片库高级操作(重命名/添加/删除/特殊添加)
调用格式:
(xdrx-slide-magic <操作类型> <幻灯片库名> <幻灯片名> [参数])
参数说明:
* <操作类型>: 整数(0-3)
0-重命名 1-添加 2-删除 3-特殊添加
* <幻灯片库名>: 目标幻灯片库文件
* <幻灯片名>: 操作的目标幻灯片
* [参数]: 根据操作类型可选:
- 类型0: 新幻灯片名
- 类型3: 特殊参数
返回值:
- 字符串: 操作结果信息
- nil: 操作失败
示例用法1: 重命名
(xdrx-slide-magic 0 "mylib" "old" "new")
示例用法2: 删除
(xdrx-slide-magic 2 "mylib" "temp")
实现特点:
1. 多功能集成操作
2. 自动处理文件扩展名
3. 严格参数类型检查
4. 返回详细操作结果
注意事项:
1. 类型3为特殊功能需谨慎使用
2. 需有读写权限
3. 不存在的库文件返回nil
4. 严格遵循参数顺序
5. 大小写不敏感匹配
------------------------------------------------------------
8
函数名称: xdrx-slide-make
描述:
从选择集创建幻灯片(.sld)文件
调用格式:
(xdrx-slide-make <选择集> <幻灯片名> [比例] [基点] [颜色])
参数说明:
* <选择集>: 要创建为幻灯片的实体选择集(RTPICKS)
* <幻灯片名>: 输出的幻灯片文件名(可带或不带.sld扩展名)
* [比例]: 可选缩放比例(实数)
* [基点]: 可选中心基点(三维点)
* [颜色]: 可选十字标记颜色(1-255)
返回值:
T: 创建成功
nil: 创建失败
示例用法1:
(xdrx-slide-make (ssget) "myslide")
示例用法2:
(xdrx-slide-make (ssget) "myslide" 2.0 '(0 0 0) 1)
实现特点:
1. 自动处理文件扩展名
2. 支持视图比例控制
3. 可添加定位十字标记
4. 自动视图优化
注意事项:
1. 临时关闭命令回显
2. 需要写文件权限
3. 比例参数影响显示范围
4. 颜色参数仅影响标记
5. 自动处理隐藏线
------------------------------------------------------------
9
函数名称: xdrx-slide-rename
描述:
重命名幻灯片库中的幻灯片(支持前缀匹配)
调用格式:
(xdrx-slide-rename <幻灯片库名> <旧名称> <新名称> )
参数说明:
* <幻灯片库名>: 目标幻灯片库文件名(可带或不带.slb扩展名)
* <旧名称>: 要重命名的幻灯片原名称
* <新名称>: 重命名后的新名称
* : 可选参数，启用前缀匹配模式
返回值:
- 字符串: 被替换的部分名称(前缀模式时)
- T: 重命名成功(精确模式时)
- nil: 操作失败
示例用法1: 精确重命名
(xdrx-slide-rename "mylib" "old" "new")
示例用法2: 前缀重命名
(xdrx-slide-rename "mylib" "temp" "new_" T)
实现特点:
1. 支持精确和前缀两种模式
2. 自动处理文件扩展名
3. 不区分大小写匹配
4. 返回操作详细信息
注意事项:
1. T参数启用前缀匹配模式
2. 需有写入权限
3. 不存在的库文件返回nil
4. 严格遵循参数顺序
5. 名称不含扩展名
------------------------------------------------------------
页:
[1]