2007年1月27日星期六

关于DOSLIB 7.5的读书笔记

关于DOSLIB 7.5的读书笔记

很早就听说和下载了DOSLIB了,也在明经看到了其早期版本的翻译-http://www.mjtd.com/Manual/ShowClass.asp?ClassID=87。今天为了学习汉化CHM,做了一点尝试,顺便把DOSLIB7.5的所有函数简介和一些更新做了翻译。

做法:采用TOTALCMD解压CHM文件,用雅信+星际译王两个软件配合GVIM进行HTML编辑。其中采用老马大侠的finstr软件批量替换。之后再压缩回去。感觉颇好。

此处,先上传一个汉化了第一级菜单的CHM文件(2006.1.27),由于后面工作比较忙,只能等后续有空再汉化了,会在这里提示时间说明的。
现在好像传不了图片,可见这里
http://structure.cn.googlepages.com/doslib75chm.png (chm示意图)


下载地址:http://structure.cn.googlepages.com/doslib17.chm(2007.1.27版本,第一级菜单汉化)

等以后慢慢有时间了就把整个CHM给汉化了也好。下面是一些心得(翻译的,没有个人见解),由于有一部分意思不是很懂,水平也比较烂,大家将就看看,有错误请指出,谢谢。

DOSLib
应用参考
(翻译,华南理工大学建筑学院 qjchen)
Version 7.5
--------------------------------------------------------------------------------
版权
版权1992-2007 Robert McNeel & Associates. 保持所有权.
Robert McNeel & Associates
3670 Woodland Park Avenue North
Seattle, WA 98103
电话: (206) 545-7000
传真: (206) 545-7321
Internet: http://www.mcneel.com
技术支持: dale@mcneel.com
DOSLib 是Robert McNeel & Associates的商标.
--------------------------------------------------------------------------------


新的函数
--------------------------------------------------------------------------------
DOSLib 7.5
dos_strformat
把一个字符串的格式改成类似C语言中 sprintf 函数的格式. .
dos_strformatcurrency
把一个数字变成货币格式的字符串.
dos_strformatnumber
把数字变成字符串.
DOSLib 7.4
dos_hatcharea
返回值:填充对象的面积.
dos_isinsidecurve
检验一点是否位于一封闭平面曲线内.
dos_plinecentroid
返回值: 一封闭平面多义线的质心.
DOSLib 7.3
dos_hlstorgb
转换HLS颜色到RGB格式.
dos_msgboxchk
显示 "不再显示这个对话框" 的消息框.
dos_rgbtohls
转换RGB颜色到HLS格式.
DOSLib 7.2
dos_hideobjects
隐藏一个或多个AutoCAD实体.
dos_merge文件
将两个或者多个文件合成一个文件.
dos_showobjects
显示或者取消隐藏一个或多个AutoCAD实体.
dos_traywnd
显示弹出托盘窗口.
DOSLib 7.1
dos_linetypebox
显示AutoCAD线型选择对话框.
DOSLib 7.0
dos_absolute路径
转换相对路径到绝对路径.
dos_acadmem
返回值: AutoCAD内存统计.
dos_arxlist
返回值: 已加载ARX应用程序.
dos_extractpreview
Extracts the preview image from the active document.
dos_get文件nav
显示一个AutoCAD风格的文件对话框.
dos_htmlhelp
显示一个HTML帮助文件内容.
dos_ispoweruser
检查当前用户的权力状态.
dos_pathbackslash
Adds or re移动s a trailing backslash to a 路径 字符串.
dos_pathextension
在一个路径字符串中加入或者删除一个反斜杆.
dos_pathquotes
在一个路径字符串中加入或者删除一个双引号.
dos_popupmenu
显示一个上下文或弹出菜单.
dos_regaddkey
添加一新的键到Windows注册表..
dos_regdelkey
从Windows注册表移除一个键或键值.
dos_regdelval
从Windows注册表移除一个键值.
dos_regenumkeys
从Windows注册表中枚举键.
dos_regenumnames
从Windows注册表中枚举键名.
dos_reggetint
返回值: 一个windows注册表的整数值.
dos_reggetstr
返回值: 返回值: 一个windows注册表的字符串值.
dos_reggettype
返回值: 一个windows注册表输入的数值类型.
dos_regsetint
修改一个windows注册表的整数值.
dos_regsetstr
修改一个windows注册表的字符串数值.
dos_strtrim
从一个字符串中切掉开头和末尾部分.
--------------------------------------------------------------------------------


变动
--------------------------------------------------------------------------------
DOSLib 7.5
dos_processes
函数没有返回全路径. 已经改正.
DOSLib 7.3
dos_rgbtoaci
函数需要三个参数值而非一个表.
dos_ver
更新至支持Windows Vista.
DOSLib 7.2.2
dos_getfilenav
修正小错误.
DOSLib 7.1.1
dos_dwgver
修正至支持AutoCAD 2007.
DOSLib 7.1
dos_exewait
修正小错误.
DOSLib 7.0
dos_date
修改了参数及返回值.
dos_demandload
函数功能变化.
dos_file
返回表变化了.
dos_help
对DOSLib函数显示HTML帮助.
dos_ipaddress
支持多网络系统.
dos_macaddress
支持多网络系统.
dos_regdel *
删除此函数,代替为 dos_regdelkey 和 dos_regdelval.
dos_regget *
删除此函数, 代替为 dos_reggetint 和 dos_reggetstr.
dos_regkey *
删除此函数,代替为 dos_regenumkeys 和 dos_regenumnames.
dos_regset *
删除此函数,代替为 dos_regsetint 和 dos_regsetstr.
dos_time
函数功能变化.
dos_touch
修改了参数及返回值.
dos_version
返回值变化了.
* 已经删除了的函数将不会在以后的版本中出现不应该再被使用。
--------------------------------------------------------------------------------


DOSLib历史
--------------------------------------------------------------------------------
Version 7.0 - 2006.3
支持AutoCAD 2007.
Version 6.1.5 - 2004.6
支持AutoCAD 2004和2005.
支持AutoCAD 2000, 2000i,和2002.
Version 6.1 - 2003.3
支持AutoCAD 2004.
支持AutoCAD 2000, 2000i,和2002.
Version 6.0 - 2002.2
支持AutoCAD 2000, 2000i,和2002.
Version 5.1 - 2000.7
支持AutoCAD 2000和2000i.
支持AutoCAD Release 14.
Version 5.0 - 2000.4
支持AutoCAD 2000和2000i.
支持AutoCAD Release 14.
Version 4.4 - 1999.5
支持for AutoCAD 2000.
支持AutoCAD Release 14.
支持AutoCAD Release 13 for Windows.
支持Visio's IntelliCAD 98.
Version 4.3 - 1998.11
支持AutoCAD Release 14.
支持AutoCAD Release 13 for Windows.
支持Visio's IntelliCAD 98.
支持IMSI's TurboCAD Professional v5.
Version 4.2 - 1998.8
支持AutoCAD Release 14.
支持AutoCAD Release 13 for Windows.
支持Visio's IntelliCAD 98.
Version 4.1 - 1997.11
支持AutoCAD Release 14.
支持AutoCAD Release 13 for Windows.
Version 4.0001 - 1997.5
Shipped as a Bonus Tool with AutoCAD Release 14.
Version 3.0 - 1996.2
支持AutoCAD Release 13 for DOS和Windows.
支持AutoCAD Release 12 for DOS和Windows.
Version 2.0 - 1994.4
支持AutoCAD Release 12 for DOS和Windows.
Version 1.0 - 1993.5
第一个官方版本的DOSLib.
支持AutoCAD Release 12 for DOS和Windows.
Version 0.6 - 1992.9
原始的DOSLib版本,发布在Compuserve.
支持AutoCAD Release 12 for DOS.
--------------------------------------------------------------------------------

所有函数:

驱动器函数
--------------------------------------------------------------------------------
dos_chkdsk
返回值: 驱动器空间统计.
dos_driver
返回值或改变当前驱动器.
dos_driverp
检查驱动器是否存在.
dos_drivers
返回值: 可用驱动器列表.
dos_drivertype
返回值: 驱动器类型.
dos_文件ys
返回值: 驱动器文件系统.
dos_format
初始化磁盘或磁盘列阵.
dos_label
返回值或设置驱动器卷标.
dos_serialno
返回值: 驱动器系列号.
--------------------------------------------------------------------------------

路径函数
--------------------------------------------------------------------------------
dos_absolutepath
转换绝对路径到相对路径径.
dos_compactpath
把一个路径切短到一定的字符数.
dos_fullpath
将一个部分的路径转换为一个全的有效的路径.
dos_ispathrelative
检查路径是否是相对的.
dos_ispathroot
检查一个路径是否是根目录.
dos_ispathsameroot
检查 两个路径是否在同一个目录.
dos_ispathunc
检查一个路径是否是一个有效的可以用于服务器或者共享路径的UNC.
dos_ispathurl
检查一个路径是否是一个有效的可以用于服务器或者共享路径的UNC.
dos_longpath
转换一个短路径名到一个长路径名.
dos_makepath
根据组件创建一个路径.
dos_path
返回值: 当前搜索路径.
dos_pathbackslash
在一个路径字符串中加入或者删除一个反斜杆.
dos_pathextension
添加,修改或者删除路径字符串的扩展名.
dos_pathquotes
在一个路径字符串中加入或者删除一个双引号.
dos_relativepath
创建一个文件或者文件夹相对其他文件或者文件夹的相对路径.
dos_shortpath
转换一个长路径名到一个短路径名.
dos_splitpath
把一个全路径名打断为四个组件.
dos_uncpath
把路径或文件名转变为UNC路径或文件名.
--------------------------------------------------------------------------------

目录函数
--------------------------------------------------------------------------------
dos_chdir
改变当前工作目录.
dos_deltree
删除一个目录和其所有子目录.
dos_dirattrib
返回值或设置目录属性.
dos_dirp
检查目录是否存在.
dos_dirtree
返回值: 一个目录和其子目录的列表.
dos_getdir
显示一个Windows的 "浏览文件夹" 对话框.
dos_mkdir
创建新的目录.
dos_pwdir
返回值: 当前工作目录.
dos_rendir
重命名一个存在的目录.
dos_rmdir
移动目录.
dos_specialdir
得到一个特定目录的路径.
dos_subdir
返回值: 子目录列表.
dos_sysdir
得到Windows的系统目录的路径.
dos_tempdir
得到Windows的temporary目录的路径.
dos_windir
得到Windows的系统目录的路径.
--------------------------------------------------------------------------------

文件函数
--------------------------------------------------------------------------------
dos_attrib
返回值: 文件属性.
dos_copy
文件拷贝.
dos_delete
文件删除.
dos_dir
返回值: 文件列表.
dos_dos2unix
把一个DOS格式的文件转变为UNIX格式.
dos_encrypt
用密码加密文件.
dos_file
返回值: 文件详细信息.
dos_filesdate
返回值: 文件和日期的列表.
dos_filep
检查文件是否存在.
dos_filesize
返回值: 文件和大小的列表.
dos_find
文件递归查找.
dos_getfiled
显示一个单选的文件对话框.
dos_getfilem
显示一个多选的文件对话框.
dos_getfilenav
显示一个AutoCAD风格的文件选择对话框.
dos_mergefile
将两个或者多个文件合成一个文件.
dos_move
移动一个文件.
dos_openp
检查所打开文件的状态.
dos_recent
加入或者清除Windows最近使用的文档列表.
dos_rename
重命名一个文件.
dos_search
沿某路径查找一个文件.
dos_tempfile
产生一个针对临时文件的名字.
dos_touch
设置文件的日期和时间.
dos_unix2dos
转换一个Unix格式的文件到DOS格式.
--------------------------------------------------------------------------------

打印机函数
--------------------------------------------------------------------------------
dos_getprn
返回值: 当前的Windows打印机.
dos_printers
返回值: Windows打印机列表.
dos_setprn
设置当前的Windows打印机.
dos_spool
输送一个文件到Windows打印机.
--------------------------------------------------------------------------------

配置函数
--------------------------------------------------------------------------------
dos_getini
返回值: 一个从Windows INI类型文件的得到的值.
dos_regaddkey
添加一新的键值到Windows注册表.
dos_regdel *
从Windows注册表移除一个键或键值.
dos_regdelkey
从Windows注册表移除一个键.
dos_regdelval
从Windows注册表移除一个键值.
dos_regenumkeys
从Windows注册表中枚举键.
dos_regenumnames
从Windows注册表中枚举值名.
dos_regget *
返回值: 一个字符串或是从注册表中枚举值名.
dos_reggetint
返回值: 一个windows注册表的整数值.
dos_reggetstr
返回值: 一个windows注册表的字符串值.
dos_reggettype
返回值: 一个windows注册表输入的数值类型.
dos_regkey
从Windows注册表中枚举值名.
dos_regset *
修改一个windows注册表的字符串数值.
dos_regsetint
修改一个windows注册表的整数值.
dos_regsetstr
修改一个windows注册表的字符串数值.
dos_setini
在Windows INI类型文件中设置一个数值.
* 未来版本将不再支持不再使用Deprecated函数.
--------------------------------------------------------------------------------

进程函数
--------------------------------------------------------------------------------
dos_command
返回值: 一个内部命令.
dos_execute
运行一个外部程序.
dos_exewait
运行一个程序并等候其完成.
dos_processes
返回值: 运行进程的列表.
dos_shellexe
打开或者打印一个程序或文件.
--------------------------------------------------------------------------------

使用界面函数
--------------------------------------------------------------------------------
dos_checklist
显示一个带有可检查列表框的对话框.
dos_combolist
显示一个带有组合列表框的对话框.
dos_editbox
显示一个多行编辑的控制对话框.
dos_editlist
显示一个可编辑列表框的对话框.
dos_get取消
显示一个带有取消按钮的无模式对话框.
dos_get颜色
显示一个颜色选择对话框.
dos_getint
一个和getint等效的对话框.
dos_getpassword
显示一个密码输入对话框.
dos_getprogress
显示一个带有进度条的无模式对话框.
dos_getreal
一个和getreal等效的对话框.
dos_get字符串
一个和getstring等效的对话框..
dos_htmlbox
显示一个网页(在一个对话框中).
dos_列表框
显示一个带有列表框的对话框.
dos_msgbox
显示一个信息框.
dos_msgboxchk
显示一个"不要显示这个对话框" 的消息框.
dos_msgboxex
显示一个扩展信息框.
dos_multilist
显示一个带有多选列表框的对话框.
dos_popupmenu
显示一个上下文或者弹出菜单.
dos_proplist
显示一个带有属性列表框的对话框.
dos_splash
显示无模式的splash屏幕图像.
dos_traywnd
显示一个弹出托盘窗口.
dos_waitcursor
操控沙漏光标.
--------------------------------------------------------------------------------

字符串函数
--------------------------------------------------------------------------------
dos_strcase
将一个字符串里的所有字符转换大小写.
dos_strcat
连接多个字符串.
dos_strchar
返回或设置一个给定位置的字符.
dos_strcompare
比较两个字符串.
dos_strdelete
从一个字符串中删除一个或者几个字符.
dos_strexcluding
获取不包含在charset中的字符的第一段字符串.
dos_strfind
在一个大字符串中查找一个字符或子字符串.
dos_strfindoneof
查找字符串中符合charset的第一个字符位置.
dos_strformat
把一个字符串的格式改成类似C语言中 sprintf 函数的格式.
dos_strformatcurrency
把一个数字变成货币格式的字符串.
dos_strformatnumber
把数字变成字符串.
dos_strincluding
获取包含在charset中的字符的第一段字符串..
dos_strinsert
在字符串的给定位置插入子字符串.
dos_strischar
根据一定的条件检验一个字符的类型(比如是数字,或者字母,或者标点符号).
dos_strleft
得到字符串的某位置以左的子字符串.
dos_strlength
返回值: 字符串中的字符数目.
dos_strmatch
按照通配符匹配字符串.
dos_strmid
根据个数和位数截取字符串中的一段.
dos_strre移动
在字符串中移去指定字符.
dos_strreplace
把指定字符用其他字符替代.
dos_strreverse
将字符串反向.
dos_strreversefind
在一个字符串中找特定字符;从末尾开始.
dos_strright
得到字符串的某位置以右的子字符串.
dos_strtokens
按照某些符号标记把字符串转变为表.
dos_strtrim
从一个字符串中切掉开头和末尾部分.
dos_strtrimleft
切掉字符串的开头部分.
dos_strtrimright
切掉字符串的末尾部分.
--------------------------------------------------------------------------------

AutoCAD函数
--------------------------------------------------------------------------------
dos_acadmem
返回AutoCAD内存使用信息.
dos_acitorgb
转换AutoCAD软件颜色到RGB颜色.
dos_arxlist
返回值: 加载的arx应用程序列表.
dos_closeall
返回值: 关闭全部打开的AutoCAD图形文件.
dos_cmdline
返回值: AutoCAD命令行或历史窗口的文本.
dos_curvearea
返回值: 闭合曲线实体的面积.
dos_dwgpreview
显示 图形和他们的略图预览图像的列表.
dos_dwgver
返回值: AutoCAD图形文件的版本.
dos_extractpreview
提取活动文档的预览位图到一文件.
dos_hatcharea
返回值: 填充对象的面积.
dos_hideobjects
隐藏一个或多个AutoCAD实体.
dos_hlstorgb
转换HLS颜色到RGB格式.
dos_isbreak
检查控制台中断.
dos_isinsidecurve
检验一点是否位于一封闭平面曲线内.
dos_istextscr
检验AutoCAD文本屏幕是否可见.
dos_isvlide
检验Visual LISP IDE是否打开.
dos_layerlistbox
在一窗口对话框显示AutoCAD图层.
dos_linetypebox
显示AutoCAD的线型选择对话框。.
dos_lisplist
返回值: 加载Lisp文件的列表.
dos_massprops
返回值: 3D实体的质量属性.
dos_plinecentroid
返回值: 一封闭平面多义线的质心.
dos_progbar
操纵AutoCAD状态栏的进度条.
dos_rgbtoaci
转换RGB颜色到AutoCAD颜色.
dos_rgbtohls
转换RGB颜色到HLS格式.
dos_saveall
保存所有AutoCAD图形文件.
dos_show
控制AutoCAD的显示窗口.
dos_showobjects
显示或取消隐藏一个或多个AutoCAD软件实体.
dos_xreflist
返回值: 外部参考文件的列表.
--------------------------------------------------------------------------------

DOSLib 函数
--------------------------------------------------------------------------------
dos_about
显示版本和拷贝版权信息.
dos_demandload
改变DOSLIB使用的加载方法.
dos_help
返回值: DOSLib函数列表.
dos_version
返回值: DOSLib版本号.
--------------------------------------------------------------------------------

系统和其他函数
--------------------------------------------------------------------------------
dos_adminp
检查当前用户的管理者状态.
dos_beep
播放Windows声音.
dos_capslock
操控 按键.
dos_cdate
返回值: 一个格式化的日期/时间字符串.
dos_clipboard
返回或者设置Windows粘贴板文本.
dos_computer
返回或者设置计算机名.
dos_date
返回或者设置系统时间.
dos_guidgen
创建一个GUID,一个随机的独一无二的128位整数.
dos_hostname
返回值: 系统的主机名.
dos_htmlhelp
显示HTML帮助文件内容.
dos_ipaddress
返回值: 系统IP地址.
dos_ispoweruser
检查当前用户的权力状态.
dos_macaddress
返回值: 系统的网卡MAC地址.
dos_mem
返回值: 系统内存信息.
dos_numlock
操控 按键.
dos_pause
停止程序执行.
dos_random
返回值: 一个伪随机数.
dos_scrolllock
操控 按键.
dos_sortlist
对表进行排序.
dos_speaker
通过PC喇叭播放声音.
dos_time
返回或者设置系统时间.
dos_username
返回值: 当前用户.
dos_ver
返回值: 操作系统版本.
dos_wav
播放wav声音文件.
dos_winhelp
显示Windows帮助文件.