TransCAD提供了點(diǎn)、線(xiàn)和面圖層豐富的樣式庫(kù)，能很好地滿(mǎn)足用戶(hù)制圖可視化的需要。其中，點(diǎn)的樣式可以使用字體字符和圖像，線(xiàn)和面的樣式，則更為復(fù)雜。例如，表示鐵路線(xiàn)路的線(xiàn)樣式，一般可以是中間粗的虛線(xiàn)加上兩邊細(xì)的實(shí)線(xiàn)組成，這些常用的線(xiàn)條樣式在TransCAD中都包含了。本文向用戶(hù)介紹一個(gè)TransCAD樣式編輯器插件，它的作用是：

（1）自定義您需要的樣式，例如線(xiàn)型，應(yīng)用到圖層或選擇集。

（2）編寫(xiě)GISDK程序時(shí)，如果涉及樣式，可以作為調(diào)試樣式的工具，方便編程，以便您更好地理解樣式設(shè)置參數(shù)。

?

TransCAD軟件點(diǎn)樣式設(shè)置對(duì)話(huà)框

TransCAD軟件線(xiàn)樣式設(shè)置對(duì)話(huà)框

TransCAD軟件面樣式設(shè)置對(duì)話(huà)框

1、樣式編輯器簡(jiǎn)介及安裝使用

樣式編輯器是用于處理顏色、填充樣式和線(xiàn)條樣式的工具箱。它們可以直接打開(kāi)，也可以使用樣式編輯器工具箱打開(kāi)，該工具箱有一個(gè)按鈕來(lái)打開(kāi)每個(gè)工具箱。每個(gè)工具箱返回一個(gè)復(fù)合變量，該變量是使用該編輯器的結(jié)果：分別是顏色、填充樣式或線(xiàn)條樣式。每個(gè)工具箱還顯示調(diào)用相應(yīng)GISDK函數(shù)的文本，該函數(shù)將創(chuàng)建顏色、填充樣式或線(xiàn)條樣式。您可以復(fù)制文本并將其粘貼到資源文件(GISDK源代碼)中。在“填充編輯器”（Fill Editor）和“線(xiàn)編輯器”（Line Editor）工具箱中，您還可以粘貼文本并將其加載，以查看該樣式的外觀。

要使用樣式編輯器，可以使用GIS開(kāi)發(fā)人員工具包(GISDK)外接程序編譯Style Editors.rsc到程序文件夾中名為"StyleEditors.dbd"的UI數(shù)據(jù)庫(kù)，然后設(shè)置一個(gè)新的對(duì)話(huà)框加載項(xiàng)，其中"Style Editors"作為名稱(chēng)（對(duì)話(huà)框的名稱(chēng)），描述可以自己定義(可用中文)、以及對(duì)應(yīng)的UI數(shù)據(jù)庫(kù)設(shè)定。

啟動(dòng)此加載項(xiàng)將顯示“樣式編輯器”工具箱，單擊相應(yīng)的按鈕打開(kāi)該編輯器：

如果要直接打開(kāi)顏色編輯器、填充編輯器、線(xiàn)編輯器，則只要調(diào)用對(duì)應(yīng)的對(duì)話(huà)框資源，分別為："ColorEditor"、"Fill Editor"和"Line Editor"。例如線(xiàn)樣式編輯器為："LineEditor"。

2、顏色編輯器

顏色編輯器是一個(gè)工具箱，它允許您以多種不同的方式創(chuàng)建顏色，并保存文本以供對(duì)GISDK函數(shù)ColorRGB()的最終調(diào)用。您可以使用紅/綠/藍(lán)系統(tǒng)（RGB）定義顏色，這是通常的方式。您還可以使用色相/飽和度/亮度系統(tǒng)（HSL），該系統(tǒng)在Windows顏色對(duì)話(huà)框中用于定義自定義顏色。您可以使用顏色系統(tǒng)單選按鈕進(jìn)行選擇：

使用RGB系統(tǒng)時(shí)，可以將每個(gè)色帶的值鍵入0到65535之間的數(shù)字。數(shù)字越大，增加的顏色越多。您還可以為十六進(jìn)制（hex）數(shù)字或Windows顏色對(duì)話(huà)框中使用的RGB數(shù)字使用特殊符號(hào)。如果在數(shù)字之前鍵入“0x”或“x”，它將被解釋為從0到ffff的十六進(jìn)制值。如果在數(shù)字之前鍵入“w”，則會(huì)將其解釋為Windows RGB值，范圍為0到255（將Windows RGB值乘以257，就是TransCAD中的RGB值）。使用微調(diào)器向上或向下更改數(shù)字后，它將轉(zhuǎn)換為常規(guī)RGB數(shù)字。

使用HSL系統(tǒng)時(shí)，可以將每個(gè)值鍵入0到240之間的數(shù)字。(-1, 0, 0)的特殊值為純黑色。您還可以使用微調(diào)器向上或向下更改數(shù)字?？梢栽陬伾到y(tǒng)之間切換，以查看每個(gè)系統(tǒng)中顏色的值。在HSL系統(tǒng)中，0或240的色相為紅色，80為綠色，160為藍(lán)色。飽和度為0表示沒(méi)有顏色，240表示全色。亮度0為黑色，120為純色，240為白色。

您可以復(fù)制調(diào)用ColorRGB()的文本，并將其粘貼到GISDK源代碼文件中。清除按鈕將顏色恢復(fù)為黑色。顯示按鈕強(qiáng)制使用當(dāng)前數(shù)字；鍵入數(shù)字后按Enter鍵或單擊另一個(gè)控件也會(huì)執(zhí)行相同的操作。關(guān)閉按鈕關(guān)閉工具箱，單擊工具箱右上角的關(guān)閉(X)框也會(huì)關(guān)閉工具箱。

3、填充編輯器

填充編輯器是一個(gè)工具箱，用于創(chuàng)建填充樣式、保存對(duì)GISDK函數(shù)FillStyle()的最終調(diào)用的文本，以及加載對(duì)FillStyle()的現(xiàn)有調(diào)用。

填充樣式是一個(gè)8*8的值網(wǎng)格，用于指示圖案。這些值存儲(chǔ)在一個(gè)數(shù)組中，每個(gè)數(shù)組包含8個(gè)字符的8個(gè)字符串?？瞻状韴D案的背景，非空白（通常是x）代表前景。可以使用GISDK函數(shù)SetFillStyleTransparency()將背景更改為透明；否則它是白色的。前景是通過(guò)調(diào)用適當(dāng)?shù)腉ISDK函數(shù)（例如SetFillColor()）來(lái)設(shè)置顏色集，以設(shè)置圖層或選擇集的填充顏色。

單擊按鈕可以更改網(wǎng)格中的單元格，并更新模式樣本和調(diào)用FillStyle()的文本。

您可以復(fù)制調(diào)用FillStyle()的文本，并將其粘貼到GISDK源代碼文件中。在單擊加載之前，可以從GISDK源代碼復(fù)制對(duì)FillStyle()的調(diào)用，并將其粘貼到編輯文本框中，也可以對(duì)文本進(jìn)行更改。加載按鈕將加載該文本；如果FillStyle()調(diào)用無(wú)效，則會(huì)顯示一條警告消息，并恢復(fù)以前的填充樣式。清除按鈕將填充樣式返回為空（全部背景，無(wú)前景）。關(guān)閉按鈕關(guān)閉工具箱，單擊工具箱右上角的關(guān)閉(X)框也會(huì)關(guān)閉工具箱。

關(guān)于填充編輯器工具箱工作原理的說(shuō)明

圖案由示例按鈕網(wǎng)格控制。每個(gè)采樣按鈕的采樣區(qū)域由一個(gè)名為rowcol的數(shù)組中的元素控制，該數(shù)組有8個(gè)子數(shù)組，每個(gè)子數(shù)組包含八個(gè)整數(shù)元素。例如，單擊第一行第五列將元素rowcol[1][5]更改為1（采樣區(qū)域設(shè)置為黑色）和0（采樣區(qū)域設(shè)置為白色）。然后調(diào)用一個(gè)對(duì)話(huà)框宏，使用該數(shù)組創(chuàng)建由8個(gè)字符串組成的數(shù)組，以傳遞給FillStyle()，并創(chuàng)建顯示對(duì)FillStyle()調(diào)用的文本。雖然dBox源代碼看起來(lái)很復(fù)雜，但由于有64個(gè)示例按鈕項(xiàng)，它實(shí)際上相當(dāng)簡(jiǎn)單。此外，能夠定位具有after和same關(guān)鍵字的對(duì)話(huà)框項(xiàng)，使復(fù)選框的布局更容易。

加載FillStyle()調(diào)用的文本是通過(guò)編寫(xiě)GISDK源代碼文件、編譯它并執(zhí)行宏將數(shù)組的文本轉(zhuǎn)換為實(shí)際數(shù)組來(lái)完成的。該方法與在GIS開(kāi)發(fā)者工具包工具箱中用于立即執(zhí)行的方法相同。宏編譯后，GISDK源代碼文件將被刪除，UI數(shù)據(jù)庫(kù)與即時(shí)執(zhí)行使用的相同；下一次使用即時(shí)執(zhí)行將重新創(chuàng)建UI數(shù)據(jù)庫(kù)。

4、線(xiàn)編輯器

線(xiàn)編輯器可以用于線(xiàn)圖層，也可以用于面圖層的邊界線(xiàn)。線(xiàn)編輯器是一個(gè)工具箱，用于創(chuàng)建線(xiàn)條樣式、保存對(duì)GISDK函數(shù)LineStyle()的最終調(diào)用的文本，以及加載對(duì)LineStyle()的現(xiàn)有調(diào)用。線(xiàn)型有平行和垂直組件，要顯示線(xiàn)型，需要線(xiàn)寬和基礎(chǔ)顏色。工具箱從4個(gè)點(diǎn)的寬度開(kāi)始，基礎(chǔ)顏色與Maptitude和TransCAD使用的顏色相同，默認(rèn)線(xiàn)樣式具有一個(gè)平行組件和一個(gè)垂直組件，看起來(lái)像鐵路軌道符號(hào)。工具箱有四個(gè)選項(xiàng)卡，分別稱(chēng)為“線(xiàn)型”、“平行”、“垂直”和“應(yīng)用對(duì)象”。其中應(yīng)用對(duì)象選項(xiàng)卡是額外添加的，可以對(duì)圖層中全部的對(duì)象或者選擇集對(duì)象設(shè)置線(xiàn)型。

您可以復(fù)制調(diào)用LineStyle()的文本，并將其粘貼到GISDK源代碼文件中。工具箱底部的按鈕對(duì)于所有選項(xiàng)卡都可見(jiàn)：

單擊“加載”之前，可以從GISDK源代碼文件復(fù)制對(duì)LineStyle()的調(diào)用，并將其粘貼到編輯文本框中，也可以對(duì)文本進(jìn)行更改。如果LineStyle()調(diào)用無(wú)效，將顯示一條警告消息，并恢復(fù)以前的線(xiàn)型。

LineStyle()接受一個(gè)參數(shù)，一個(gè)通常有兩個(gè)子數(shù)組的數(shù)組，一個(gè)用于平行組件，一個(gè)用于垂直組件。如果只有一個(gè)子數(shù)組，則用于平行組件。對(duì)于僅包含垂直組件的線(xiàn)樣式，第一個(gè)元素可以為null。如果數(shù)組為null，則線(xiàn)條樣式為null。子數(shù)組中是每個(gè)組件的子數(shù)組。例如，LineStyle({{{1, -1,0}}})是一種簡(jiǎn)單的線(xiàn)型，具有一個(gè)平行組件。

“線(xiàn)型”選項(xiàng)卡

在“線(xiàn)形”選項(xiàng)卡上，可以設(shè)置采樣線(xiàn)的寬度和顏色，如選項(xiàng)卡框架下方所示。所有寬度都以點(diǎn)為單位，可以是十進(jìn)制數(shù)。工具中寬度限制為24(可以修改)，因此不會(huì)比示例中顯示的寬度更寬。

顏色下拉列表顯示默認(rèn)顏色。選擇顏色時(shí)，它將加載到顏色編輯器框架中，這是顏色編輯器工具箱的一個(gè)更簡(jiǎn)單版本。只有RGB系統(tǒng)用于修改顏色，但支持十六進(jìn)制和Windows數(shù)字。有關(guān)使用顏色編輯器的詳細(xì)信息，請(qǐng)參閱上面的“顏色編輯器”。

顏色樣本中顯示的顏色是基礎(chǔ)顏色（底色）。平行和垂直組件可以使用該顏色繪制，也可以使用特定顏色繪制。

開(kāi)始使用時(shí)，默認(rèn)的線(xiàn)樣式有一個(gè)平行組件(1, -1, 0)和一個(gè)垂直組件(0, -1, 12, 25, 0, 3.5, 0, -4)，看起來(lái)像鐵路軌道符號(hào)。

“平行”選項(xiàng)卡

線(xiàn)樣式可以有零個(gè)或多個(gè)平行組件。必須指定組件寬度、顏色索引和偏移，并且可以指定虛線(xiàn)。平行組件是從頭到尾繪制的，因此您可能需要對(duì)組件重新排序以獲得所需的結(jié)果。

組件寬度為0表示細(xì)線(xiàn)不會(huì)隨著線(xiàn)寬的變化而變化。較大的組件寬度（以點(diǎn)為單位）隨線(xiàn)寬縮放。組件寬度可以是十進(jìn)制數(shù)。

組件顏色索引可以是基礎(chǔ)顏色（底色，即和“線(xiàn)型”選項(xiàng)卡選擇的顏色一致）或特定顏色。索引包括：

組件距線(xiàn)樣式中心線(xiàn)的距離（以點(diǎn)為單位）稱(chēng)為組件偏移。組件偏移可以是十進(jìn)制數(shù)。正偏移位于上部，負(fù)偏移位于下部。

虛線(xiàn)組件是可選的。它的值必須成對(duì)出現(xiàn)，首先是虛線(xiàn)本身，然后是虛線(xiàn)之間的空白。虛線(xiàn)組件可以是十進(jìn)制數(shù)。您可以有任意數(shù)量的對(duì)，以具有不同虛線(xiàn)和空格的圖案。警告消息將指示這些值是否成對(duì)。

一組按鈕用于管理平行組件。同樣，也有一組等效的按鈕管理垂直組件：

除“添加”按鈕外，其他所有按鈕都會(huì)根據(jù)需要禁用，例如當(dāng)沒(méi)有組件或沒(méi)有高亮顯示組件時(shí)。

使用多個(gè)平行組件，您可以創(chuàng)建多種線(xiàn)樣式。例如：

[1]兩個(gè)平行組件正向和反向偏移相同的距離，將形成空心線(xiàn)樣式。

[2]繪制的另一個(gè)平行組件，沒(méi)有偏移，寬度為其他偏移絕對(duì)值的總和，將填充空心。

[3]如果偏移平行組件具有特定顏色，而其他平行組件使用基礎(chǔ)顏色（底色），則可以更改填充顏色。

[4]如果在實(shí)心平行組件的頂部有一個(gè)虛線(xiàn)平行組件，則可以創(chuàng)建多色填充圖案。

使用工具箱很容易對(duì)不同的平行組件集進(jìn)行實(shí)驗(yàn)。

“垂直”選項(xiàng)卡

線(xiàn)樣式可以有零個(gè)或多個(gè)垂直組件。必須指定所有組件值：寬度、顏色索引、距離和頻率，以及作為兩個(gè)坐標(biāo)的起點(diǎn)和終點(diǎn)。除顏色索引外的所有組件值都可以是十進(jìn)制數(shù)。在繪制平行組件之后，從第一個(gè)到最后一個(gè)繪制垂直組件，因此您可能需要對(duì)組件重新排序以獲得所需的結(jié)果。

組件寬度和顏色索引與平行組件相同。組件距離是指在開(kāi)始垂直組件之前，從線(xiàn)起點(diǎn)計(jì)算的距離（以點(diǎn)為單位）。組件頻率是垂直組件中心之間的間距（以點(diǎn)為單位）。

XYs是兩個(gè)坐標(biāo)，以點(diǎn)為單位，表示垂直組件的起點(diǎn)和終點(diǎn)。如果沒(méi)有兩個(gè)XY對(duì)，將顯示一條警告消息。正X值位于垂直組件的中心之后（右側(cè)），負(fù)X值位于中心之前（左側(cè)）。正Y值位于中心的上部，負(fù)Y值位于中心的下部。

使用多個(gè)垂直組件可以創(chuàng)建非常復(fù)雜的線(xiàn)樣式。例如：

[1]如果X值相同，Y值為正和負(fù)，垂直組件將筆直穿過(guò)線(xiàn)型。

[2]如果X值不同，Y值為正和負(fù)，垂直組件將與線(xiàn)條樣式成角度。

[3]如果第二個(gè)垂直組件反轉(zhuǎn)Y值，則兩個(gè)垂直組件將相交。

[4]如果兩個(gè)垂直組件開(kāi)始或結(jié)束于同一個(gè)XY對(duì)，但另一個(gè)XY對(duì)具有相反的Y值和相同的X值，則兩個(gè)垂直組件將彼此成角度。

觀察這些樣式組合的最好方法是實(shí)驗(yàn)。

“應(yīng)用對(duì)象”選項(xiàng)卡

當(dāng)把當(dāng)前樣式應(yīng)用于當(dāng)前圖層時(shí)，可以選擇應(yīng)用對(duì)象，所有對(duì)象即為當(dāng)前圖層的全部對(duì)象，也可以選擇對(duì)應(yīng)的選擇集，樣式只對(duì)選擇集的要素對(duì)象起作用，在制圖中可以靈活使用。

關(guān)于線(xiàn)編輯器工具箱工作原理的說(shuō)明

加載LineStyle()調(diào)用的文本是通過(guò)編寫(xiě)GISDK源代碼文件、編譯它，并執(zhí)行宏將數(shù)組的文本轉(zhuǎn)換為實(shí)際數(shù)組來(lái)完成的。該方法與GIS開(kāi)發(fā)者工具包中用于立即執(zhí)行的方法相同。宏編譯后刪除資源文件，UI數(shù)據(jù)庫(kù)與即時(shí)執(zhí)行使用的相同；下一次使用即時(shí)執(zhí)行將重新創(chuàng)建UI數(shù)據(jù)庫(kù)。

此編輯器使用dBox資源之外的其他幾個(gè)宏資源。其中大多數(shù)用于在列表和數(shù)組的數(shù)組和文本版本之間進(jìn)行轉(zhuǎn)換，以提供組件之間的同步，這些組件存儲(chǔ)為數(shù)字、滾動(dòng)列表的文本以及調(diào)用LineStyle()的文本。dBox資源的許多復(fù)雜性在于維護(hù)這些組件的不同版本，以及用于控件的變量。

另一個(gè)宏資源用于構(gòu)建微調(diào)器列表，即文本數(shù)組。微調(diào)器列表只有三個(gè)元素，即當(dāng)前值之前的值和當(dāng)前值之后的值。如果該值處于下限或上限，則只有兩個(gè)元素，即當(dāng)前值和下一個(gè)更高或更低的值。

5、延伸閱讀：關(guān)于顏色

RGB 是對(duì)機(jī)器很友好的色彩模式，但并不夠人性化。因?yàn)?RGB 色彩模型是通過(guò)不同量的紅綠藍(lán)來(lái)描述一個(gè)顏色的，對(duì)人類(lèi)來(lái)說(shuō)很不直觀，難以理解。人類(lèi)更習(xí)慣這樣去描述一個(gè)顏色：它是什么顏色？是鮮艷還是灰暗？HSB 和 HSL 都是基于此被創(chuàng)造出來(lái)的。

HSL 模式和 HSV(HSB) 都是基于 RGB 的，是作為一個(gè)更方便友好的方法創(chuàng)建出來(lái)的。HSB 為 色相，飽和度，明度；HSL 為 色相，飽和度，亮度，HSV 為色相，飽和度，明度。HSB 和 HSV 是一樣的，只是叫法不同，HSL 則還有一些細(xì)微的區(qū)別：在所有的情況下，H(Hue) 代表色相，S(Saturation) 代表飽和度。Hue（色相）是指取值范圍在0-360°的圓心角，每個(gè)角度可以代表一種顏色。B 在 HSB 模式中是 Brightness 的意思, V 在 HSV 中是值，但是所表述的是一個(gè)東西：對(duì)光的量或光源的功率的感知。色相(H)和明度（值）(V/B)可以在0-1或者0 -100%間取值。HSL 稍微有一些不同，Hue（色相）和 HSB/HSV 模式中一樣用數(shù)值表示，但是， S，同樣代表“飽和度”，定義不一樣，且需要轉(zhuǎn)換。L 代表亮度，和 Brightness/Value 不一樣。Brightness（明度）是被認(rèn)為是”光的量“，可以是任何顏色。而 Lightness（亮度）是作為”白的量“來(lái)理解的。

HSV示意圖

HSL，這里Chroma就是Saturation飽和度

HSL示意圖

顏色碼對(duì)照表

注意TransCAD的RGB()函數(shù)中的值，可從上面RGB的值乘以257得到。點(diǎn)擊鏈接可以下載本文介紹的插件工具源代碼：

https://www.caliper.com/maptitude/gisdk/GISDK_Style%20Editors.zip

鏈接可下載Caliper的原始英文版本，我們對(duì)其進(jìn)行了漢化和改進(jìn)（如應(yīng)用對(duì)象選擇）。

審核編輯 ：李倩