GISDK培训教材

1、gisdk培训教材北京友好创达科技有限公司一、 前言 gisdk全称为geographic information system developers kit。gisdk包含caliper script，一种功能强大的宏编程语言，用于增强和定制caliper的gis产品。1频繁使用maptitude、gis+或transcad的用户 熟悉其中的概念及用法，理解其中的（map，layer）、（dvw, dbf）、（layout）专题图的概念及关系，大大有助于二次开发。2编程基础basic，vb，c，或其他语言. 3想自动化或定制maptitude、gis+或transcad二、 介绍（共有600

2、多个函数） 1、三类程序：add-ins, custom application, server application、 add-ins 在其中编写macros或dialog boxes等，在其他程序中使用，通过加入tools-add ins菜单中。 add-ins可简可繁 简：无任何交互界面 繁：加入custom toolboxes、 custom applications包含自己的界面：菜单、工具条、工具盒及对话框启动方式 ：加入add-ins.txt中或 u。ca同样可简可繁：如mapt、gis+、transcad就是最复杂的。、 server applications是为你的程序提供

3、数据、地图、分析函数的定制的应用。client可是vb、c、c+或其他、甚至是宏语言（eg.、execl）.server app无界面，后台运行，通过宏提供功能。使用一个启动宏来初始化服务器后等待client请求。通过dde同步或异步方式发送请求。另外server app通过clipboard、dde或文件方式向client端传送结果数据。 2、系统要求 maptitude、gis+、transcad平台。 maptitude不包含编辑器，可使用任何文本编辑器。 3、安装 安装 启动，tools-add ins 选择gis developers kit面版会出现。三、 快速练习1. lesso

4、n 1. addin1.rsc*大小写对宏名敏感。 开始 编辑 运行 2lesson 2. addin2.rsc 3. lesson 3. 安装add-in gisdk将编译后的资源文件存入一个特别的库叫user interface database，ui database。包含 * .1，2，3，4，5，6，.dbd 7个文件中。要发布定制的要编译为独立的ui 别名 database，再用set up 选项来设置。 创建一个ui database 名为test0001 4lesson 4 创建一个定制应用。 xfac1.rsc 含启动宏和菜单。 xfac2.rcs 含其他宏和对话框。 编译可

5、使用一个list file，文本文件。xfac.lst 名为testxface的ui库。 创建启动图标 -u testxfac 另一种安装方法四、 gisdk 结构1平台和ui库platform 是gis和 dbms核心集，用于创建地图和分析ui是菜单、对话框和其他工具 平台包含exe程序文件（mapt.exe，gisw.exe or tcw.exe）和dlls和其他支持文件。 ui含gis_ui.dbs,1,2,3,4,5,6(中文版为gis_ch.dbd，1，2，3，4，5，6) 两种方式。ui databaseresource compiler 2编译资源resource filethe

6、 platform mapt.exe gisw.exe tcw.execompleted application lst / rsc 文件 错误：error file(.err) 编译方法：agisdk toolbox brscc.exe 命令行 cloadresourcefile() 用gisdk toolbox 4种（p23）.编译到test_ui库中，先清空。执行test_ui中的宏或dbox编译为指定的ui库中直接执行gisdk中的函数或语句 rscca rscc -c u uidbname fname1.rsc 不含 c 只替换同名资源。含 c 清空b rscc -c u uidbn

7、ame listfile1 listfile2c rscc -c u uidbname menu.rsc macro.rsc rsc_list.txt 用函数leadresourcefile()在自己定制的应用中可以使用leadresourcefile()函数来编译资源文件，但不能使用listfile文件来指定资源文件，可以非常容易地编写一个循环来调入多个资源文件。可以用如下的两个宏，直接挂在两个菜单项上来编译资源文件。 macro load a resource file (filename) shared rsc_file_name if filename = null then do/

8、ask the user which file to compile.on escape do return() endrsc_file_name = choosefile(resource,*.rsc, compile resource, readonly box, no)on escape default end else rsc_file_name=filename setcursor(hourglass) / do some basic error trapping. on notfound doresetcursor()return() end on error doresetcur

9、sor()showmessage(compilation failed.)return()end / compile the resource file into the current ui database loadresourcefile(,rsc_file_name,) resetcursor()endmacromacro reload a resource fileshared rsc_file_name/ see if something has already been compiled.if rsc_file_name = null then showmessage(no re

10、source file was previously loaded.)else / compile it again.runmacro(load a resource file, rsc_file_name)endmacro 用户定义的标志。（26个） noneab 可编译出不同的版本ab3安装gisdk应用 安装gisdk应用实际实在add-ins.txt文件中加入不同的行来表示。每一行由四项，每一项的意义如下： a表明是什麽: dbox，macro或interface. bui库名 c宏或对话框的实际名，用于启动 d描述 下面是一个简单的例子：macro,test_ui,my first

11、macro,try this add-indbox, test_ui, my first dbox,try it! youll like it!interface, myapp1,go,sales information centerm, testui, my second macro,heres another add-in macrod, testui, my first dbox,heres another add-in dialog boxi, myapp1,go,sales information center 安装运行 add-ins。 安装运行 custon app所有的定制应用

12、都有一个启动宏。一般情况他们执行以下一至四种工作： 显示程序标题：showbitmap()，showsnapshot()初始化全程或共享变量：设置状态条：setstatusbar()，setstatus()设置缺省菜单和工具条：setdefaults()mapt -u uidbname-i xfacmacroname n 窗口名称 4gisdk toolbox介绍 立即运行showmessage()setlayer()destroyprogressbar()setmapscale()runmacro() *exit() 退出mapt *赋值仅对全程变量有效 *return() 无效仅是从运行宏

13、退出。五、 资源可含多个资源可一起编译为add-lis 或应用/为注释1 宏macros类似子过程，包含一系列描述语言，宏的运行。菜单按钮runmacro()函数 macro“name”(arg1,) 大小写敏感 a最多8个参数 b参数只有是数组或&前导才可改变，其他为传值。d 用return返回值无则为null。2 dialog boxes选menu点击button调用rundbox函数 当对话框出现时，其它操作无法进行。 dbox“name”(arg1) hpos,vpos,width,height option enddbox 参数 8个以下，不足为null。含初始化 init do e

14、nditem return() 返回，可有一任意类型的单值。 position hpos (x，left，right，center) vpos (x，top，bottom，center)以字符为单位 width height optionstitle 标题help f1的帮助 对话框条目push button,edit item,check box,radio list,frame,text item,scroll list,popdown menu,sample.type“item name” position-info optionsdo enditem名称不必需，除非用 disablei

15、tem()，enableitem()，hideitem()，showitem. 相关函数 3工具盒 toolboxes dbox “dbox name” tool box end dbox * 含no keyboard 不保持键盘集点。 tool itemstool “item name” hpos , vpos options icons: list-of-icons do enditem交互调用有 clickcood() , clickline() update item 当updatedbox() 被调用时使用。 close item 无此项 toolbox 无法关闭4 toolbars

16、一次只能显示一个，但可有多个用 showdbox() hidedbox() 操作，与toolbox不同的只是没有位置。5 menusmenu“menu name”options endmenu* options windows 窗口列表* separator * 四种方式定义l caliper 菜单名后有 表明有对话框六、语言要素常量 数字, 字符, null 变量 不需先定义，大小写敏感，随赋值类型可变*保留字 do, if, return, null, runmacro, rundbox,大小写无关类型 integer: -2147482648-2147482647 real : +-3.

17、4e-38-3.4e+38 string : 512长度 array : compound: 组合，复合 boolean null 数组 dim定义 x=“boston”, 元素类型可不同 多维数组 号相加 函数 compound, variables复合变量 coord, color, circle, scope, fillstyle, linestyle, file handle, sample point, sample line, sample area 变量作用范围（三种）local, global, shared global 定义全程变量 shared 共享5. 函数调用 参数

18、一个数略即为null或缺省 redrawmap() (null) ( “my map”) 多个，分隔“ ,”号不能省，最好一定是空时使用null.6.表达式 数值. 关系.， 逻辑.1. string, array 时合并语句行 分行，多行， / 赋值 含数调用 goto if then else其中多行要加doend. for to step do end. while do endreturn(expression)或return( ).8.错误控制（p73） 4种语句 种错误七管理窗口 类型：map, editor, figure, layout 格式：“window type | wi

19、ndow name”.1. 创建窗口 函数：createmap(string map_name, array options) 选项：menu, toolbar, position, size, active macro, close macro, createmap()creates a new, empty map window createeditor()creates a new editor window createeditorbyquery()creates an editor displaying the results of an sql query createfigure

20、()creates a new figure window createlayout()creates a new layout window openmap()opens a map file and displays it in a map window openmapfromannotation()creates a new map window from a map that appears in a layout openeditor()creates an editor from a file openeditorfromannotation()creates a new edit

21、or window from an editor that appears in a layout openfigure()creates a figure from a file openfigurefromannotation()creates a new figure window from a figure that appears in a layout openlayout()creates a layout from a file2.windows相关操作函数.3.关闭窗口4.控制窗口大小和位置5.关联菜单和工具条 setdefaults( )6.窗口宏 active macro

22、s close macros scale-change macros hightlight macros7.保存和打开窗口八地图和图层1. 创建地图 使用函数createmap() 可以创建新的,空图. 创建时需要给出scope地图范围. 地图重名时将在新建的地图名称后加:1,:2, 创建新的地图后, 可以在其中加入地理图层, 图像层或各种装饰对象. 地图的比例尺scale,范围scope,单位unit,投影projection. 它们都有函数获取和设置. 其中scope是一个复合变量, 包含center,width,height,projection.2. 地图和图层 gisdk支持不同类型

23、的图层,包括标准格式,压缩格式和一些图像层.主要的函数有addlayer(),addcdflayer(),addimagelayer(),droplayer().有时需要一些图层而又不想在任何地图窗中出现, 可以将它放入一个虚拟的工作空间,函数是addlayertoworkspace(),droplayerfromworkspace().在maptitude和gisdk中, 和当前view一样, 要有当前图层的概念, 有很多的操作都是针对当前图层进行的.3. 图层显示风格和设置gisdk提供了很多的函数来控制地图的显示. 可以控制图层的可视,不可视, 显示的风格, 以及自动比例尺等.在地图中加

24、入图层后,必须设置图层的现实风格style, 不同种的图层有不同的设置参数,如下:layer typestyle elementto set the styleto get the styleareaborder stylesetborderstyle()getborderstyle()areaborder widthsetborderwidth()getborderwidth()areaborder colorsetbordercolor()getbordercolor()areafill colorsetfillcolor()getfillcolor()areafill stylesetf

25、illstyle()getfillstyle()areatransparencysetfillstyletransparency() getfillstyletransparency()linestyle setlinestyle()getlinestyle()linewidth setlinewidth()getlinewidth()linecolorsetlinecolor()getlinecolor()pointicon seticon()geticon()pointicon colorseticoncolor()geticoncolor()maptitude使用的点的符号类型是wind

26、ows的系统turetype的字体. 可以用专用软件制作.maptitude使用的线形可以用函数linestyle() 定义.maptitude 使用的填充类型用函数fillstyle() 定义, 要先定义一个8*8的类型.选择集可以有自己的显示风格style, 和设置图层一样. 也可以设置为null, 表示继承图层的显示风格.4. 用户交互函数clickcircle(),clickcoord(),clickdragandshow(),clickellipse(),lickellipsescope(),clicklayout(),clickanddraglayout(),clickline()

27、,clickpolyline(),clickcurve(),clickrect(),clickrectscope(),clickscope(),clickshape(),clicktext(),getclickshift(),getclickcontrol() 5.专题图 6.手绘条目 7.选择集2. 图例 九表、视图和数据1. 表table和视图view table是包含一些被按行列组织的信息的一个磁盘文件. view 是一个虚拟表,有行列信息. 来自单独的表, 一个地理文件或不同来源并联的. 用view来read,write,display表或地理文件中的信息. 作为一个程序员可以将vie

28、w看作一个表,地理文件或并联视图的句柄”handle”. view如同名,则在名称后加:1,:2 view有些类似数据库中的记录集recordset2. 编辑器editormaptitude中的数据窗dataview, 实际上包含了view和editor两个部分.editor是用来显示view的, 当保存一个editor时, 不存储实际数据, 而是保存了怎样显示view的信息. 显示的数据还是取自view.3. 视图、层和join视图每个地图图层都有一个相应的包含表格信息的view.每个view不一定有相关的地图图层.一个地理图层可能有几个相关的view. 主要是来自join.平台将drop

29、a view,当它不在任何窗口中显示. 如当关闭一个editor时, 此editor关联的view即不在任一个editor中, 也没有和任何其他地图图层关联, 此view将被关闭.当撤销一个图层时, 与图层关联的每个view都将关闭.4. 读，写数据访问表格数据是通过view, 表达方式简单灵活. gisdk用record handle表示一个view中的一条记录取值表达式:x = view_name.field_name, view_name必须是一个字符串变量, 如:/ neither will = states.name/ this, on the other han

30、d, works just fine.vw = states name = vw.name字段名如要使用变量要如下表达:/ here are two ways to read the state name.vw = statesfld = name/ these two statements do the same = vw.namename = vw.(fld)/ i am going to read the values of three fields.fld_names = name, population, incomevw = states/ read the

31、three field = vw.(fld_names1)pop = vw.(fld_names2)inc = vw.(fld_names3) 5.增加，删除记录 6.编辑，创建表结构3. odbc表十其它geographic data and geographic filesuser interface programmingmath, string, and array manipulationtimers and stopwatchesslide shows & snapshotsprinting & layouts interprocess communicat

32、ion十一server applicatiens.嵌入地图使用地理或空间查询结果提供空间分析1. 概述包括startup macro dde service macros 启动2. 要求服务格式3. 传递结果 保存到文件 保存到clipboard dde(a single string)4. 使用结果在client程序中bitmapmetafileole object十二gis二次开发和ole automation 1、 四种：二次开发工具 （gisdk、mapbasic） 底层dll调用开发 （mapgis、泰坦） dde、ole automation activex控件开发2、 the m

33、aptitude object maptitude.automationserver，如vb中： dim mapt as object set mapt = createobject(maptitude.automationserver)方法methods： runmacro() calls a gisdk function. runuimacro() calls a macro in a compiled gisdk ui database. coord(long longitude, long latitude) scope(macroval center, double width, d

34、ouble height, double angle) circle(macroval center, double radius) 注：coord、scope、circle返回macroval类型的对象例如： map_name=mapt.runmacro(openmap, c:maptitudemymap.map, null)3、 the macroval objectmethods： copy() isequal(macroval compare)properties： propertytyperelevant caliper script compound types lat longc

35、oord lon longcoord center coordscope, circle width doublescope height doublescope angle doublescope projection arrayscope radius doublecircle red longcolor green longcolor blue longcolor十三函数参考 公共调用约定：1、 传递null表示一个默认值。 例如，很多函数都使用一个地图名称作为一个参数，null代表当前地图。类似的有editor数据窗名称、layout布局名称、layer图层名称等。对于用于定义地图显示

36、的函数用null表示“没有改变”，如函数seticoncolor()在设置一个选择集的颜色时，表示没有变化仍使用图层的颜色。2、 确定地图、图层和选择集a、改变图层显示风格的函数用几种类型的字符串来确定被改变的是地图、图层或选择集：mapname|layername|setname 指定地图的指定图层的指定选择集layername|setname 当前地图的指定图层的指定选择集setname 当前地图的当前图层的指定选择集layername| 当前地图的指定层null 当前地图的当前图层 b、类似的情况是设置专题地图： layername|themename|class_id 修改指定图层、专

37、题图和类id themename|class_id 修改当前图层、专题图和类id c、有一些函数只能影响整个图层，而对选择集无效： mapname|layername layername null3、 确定view和sets很多函数是用于views和sets的，如getfirstrecord()在特定的view中的特定set获取第一条记录。views和sets有四种格式：viewname|setname 特定名称的view中特定名称的setsetname 当前view中指定setviewname| 指定名称的view中的所有记录null 当前view中的所有记录4、 确定字体对字体的指定有4种

38、格式：font_family|font_sizefont_family|bold|font_sizefont_family|italic|font_sizefont_family| bold| italic|font_size字体的大小以点数表示，可以是实数，如：”times new roman|bold|17.5”5、 确定窗口当你使用一些可以对所有窗口可用的函数时（minimizewindow()），必须指定窗口类型和窗口名称，如：”map|my first map” 或 “editor|sales data”。一个特别的类型”frame|”特指maptitude主窗口。6、 确定表的字段

39、有时使用字段名称（getfirstrecord()），有时使用字段表达式（createtheme()）。7、 使用布尔值caliper script 使用字符串”true”和”false”来表示布尔值，但有时也会返回象”on”和”off”这样的值，请参考文档。8、 使用选项数组很多函数使用可选的数组作为参数，其中的每一个元素都是由两个或更多的元素构成，第一个是选项的名称，第二个是它的值，如下：options_array=“layer name”, ”counties”“label”, “counties of the northeast” 如不需要一些选项，可用null。 下述的两个函数用于查

40、找特定选项和选项的值： findoption() findoptionvalue() gisdk全称为geographic information system developers kit，是一种强大的宏编程语言，用于增强和定制caliper公司的gis产品。gis大家庭的后起之秀maptitude具有迄今为止最好的性能价格比，而其增值开发语言gisdk 更使其如虎添翼。gisdk由三部分组成：caliper script程序开发语言，用于应用程序编译和测试的交互开发工具以及客户服务器功能。 caliper script 程序语言是开发基于maptitude应用程序的关键。由于其一组由命令组

41、成的程序流，隐含变量说明，灵活的数组处理，结构化的函数调用等等而使得类似basic语言的 gisdk别有特色。caliper script可以建立和管理诸如表、地图、地图要素、窗口、选择集以及工具、对话框、工具条等用户界面。此外， caliper script还包含多达 600个函数的函数库。高级函数调用充分调用maptitude的功能 。1、 gisdk功能强大使用简单。即使具有很少程序经验的人都能很快掌握。2、 gisdk共有600多个函数和200多条语句。高级函数的应用可充分调用maptitude的功能。3、 gisdk提供灵活的add-ins的方式。add-ins可以使用户很方便地获取

42、现有软件的功能，增强新的功能，add-ins可繁可简，简单的是一个当被点中即可运行的宏，而复杂的则可显示对话框，并能通过宏的运行选择系统配置。4、 gisdk可开发自己所需要的用户界面。象菜单、工具条、对话框等，用户还可以开发出满足特殊需要的应用程序以增强gisdk的功能，自行开发的程序的执行与在其它windows上运行的程序无异，设定自己的图标双击之即可运行。5、 用户还可用gisdk开发基于服务器上的应用程序。即该程序可将服务器上的数据，地理分析功能等传给网上终端或客户，而客户端上的程序可以有vb、vc、c+或其它任何程序组成，由于服务器在后台运行因此不存在用户界面，它只对客户端的要求作出

43、应答。6、 gisdk开发后的产品可含有多个资源。这样可方便用户编写程序，用户可单个编写资源文件，编译时，可编译到同一资源库中。7、 语言要素使用比较方便，隐含变量说明，灵活的数组处理使gisdk别具特色。gisdk变量不需要先定义，随赋值类型可变，这就避免了用户对多个变量的混淆。 应用举例 菜单的制作。 用户只要把自己的菜单如下面的例子一样编写即可，若有分级菜单，还是象写主菜单一样，当菜单完成后，在菜单中就可编写自己的功能了。例： / the interface macro is the one that bootstraps the application. macro interface

44、 / the follwing statement identifies the main system menu to load when the application starts setdefaults(menu, main menu) endmacro/ there are two main menus in our application: file and mapmenu main menumenuitem file menutext: filemenu file menumenuitem map menu text: mapmenu map menuendmenu/ the file menu has thr