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

（1）自定義您需要的樣式，例如線型，應用到圖層或選擇集。

（2）編寫GISDK程序時，如果涉及樣式，可以作為調試樣式的工具，方便編程，以便您更好地理解樣式設置參數。

?

TransCAD軟件點樣式設置對話框

TransCAD軟件線樣式設置對話框

TransCAD軟件面樣式設置對話框

1、樣式編輯器簡介及安裝使用

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

要使用樣式編輯器，可以使用GIS開發人員工具包(GISDK)外接程序編譯Style Editors.rsc到程序文件夾中名為"StyleEditors.dbd"的UI數據庫，然后設置一個新的對話框加載項，其中"Style Editors"作為名稱（對話框的名稱），描述可以自己定義(可用中文)、以及對應的UI數據庫設定。

啟動此加載項將顯示“樣式編輯器”工具箱，單擊相應的按鈕打開該編輯器：

如果要直接打開顏色編輯器、填充編輯器、線編輯器，則只要調用對應的對話框資源，分別為："ColorEditor"、"Fill Editor"和"Line Editor"。例如線樣式編輯器為："LineEditor"。

2、顏色編輯器

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

使用RGB系統時，可以將每個色帶的值鍵入0到65535之間的數字。數字越大，增加的顏色越多。您還可以為十六進制（hex）數字或Windows顏色對話框中使用的RGB數字使用特殊符號。如果在數字之前鍵入“0x”或“x”，它將被解釋為從0到ffff的十六進制值。如果在數字之前鍵入“w”，則會將其解釋為Windows RGB值，范圍為0到255（將Windows RGB值乘以257，就是TransCAD中的RGB值）。使用微調器向上或向下更改數字后，它將轉換為常規RGB數字。

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

您可以復制調用ColorRGB()的文本，并將其粘貼到GISDK源代碼文件中。清除按鈕將顏色恢復為黑色。顯示按鈕強制使用當前數字；鍵入數字后按Enter鍵或單擊另一個控件也會執行相同的操作。關閉按鈕關閉工具箱，單擊工具箱右上角的關閉(X)框也會關閉工具箱。

3、填充編輯器

填充編輯器是一個工具箱，用于創建填充樣式、保存對GISDK函數FillStyle()的最終調用的文本，以及加載對FillStyle()的現有調用。

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

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

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

關于填充編輯器工具箱工作原理的說明

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

加載FillStyle()調用的文本是通過編寫GISDK源代碼文件、編譯它并執行宏將數組的文本轉換為實際數組來完成的。該方法與在GIS開發者工具包工具箱中用于立即執行的方法相同。宏編譯后，GISDK源代碼文件將被刪除，UI數據庫與即時執行使用的相同；下一次使用即時執行將重新創建UI數據庫。

4、線編輯器

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

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

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

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

“線型”選項卡

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

顏色下拉列表顯示默認顏色。選擇顏色時，它將加載到顏色編輯器框架中，這是顏色編輯器工具箱的一個更簡單版本。只有RGB系統用于修改顏色，但支持十六進制和Windows數字。有關使用顏色編輯器的詳細信息，請參閱上面的“顏色編輯器”。

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

開始使用時，默認的線樣式有一個平行組件(1, -1, 0)和一個垂直組件(0, -1, 12, 25, 0, 3.5, 0, -4)，看起來像鐵路軌道符號。

“平行”選項卡

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

組件寬度為0表示細線不會隨著線寬的變化而變化。較大的組件寬度（以點為單位）隨線寬縮放。組件寬度可以是十進制數。

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

組件距線樣式中心線的距離（以點為單位）稱為組件偏移。組件偏移可以是十進制數。正偏移位于上部，負偏移位于下部。

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

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

除“添加”按鈕外，其他所有按鈕都會根據需要禁用，例如當沒有組件或沒有高亮顯示組件時。

使用多個平行組件，您可以創建多種線樣式。例如：

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

[2]繪制的另一個平行組件，沒有偏移，寬度為其他偏移絕對值的總和，將填充空心。

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

[4]如果在實心平行組件的頂部有一個虛線平行組件，則可以創建多色填充圖案。

使用工具箱很容易對不同的平行組件集進行實驗。

“垂直”選項卡

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

組件寬度和顏色索引與平行組件相同。組件距離是指在開始垂直組件之前，從線起點計算的距離（以點為單位）。組件頻率是垂直組件中心之間的間距（以點為單位）。

XYs是兩個坐標，以點為單位，表示垂直組件的起點和終點。如果沒有兩個XY對，將顯示一條警告消息。正X值位于垂直組件的中心之后（右側），負X值位于中心之前（左側）。正Y值位于中心的上部，負Y值位于中心的下部。

使用多個垂直組件可以創建非常復雜的線樣式。例如：

[1]如果X值相同，Y值為正和負，垂直組件將筆直穿過線型。

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

[3]如果第二個垂直組件反轉Y值，則兩個垂直組件將相交。

[4]如果兩個垂直組件開始或結束于同一個XY對，但另一個XY對具有相反的Y值和相同的X值，則兩個垂直組件將彼此成角度。

觀察這些樣式組合的最好方法是實驗。

“應用對象”選項卡

當把當前樣式應用于當前圖層時，可以選擇應用對象，所有對象即為當前圖層的全部對象，也可以選擇對應的選擇集，樣式只對選擇集的要素對象起作用，在制圖中可以靈活使用。

關于線編輯器工具箱工作原理的說明

加載LineStyle()調用的文本是通過編寫GISDK源代碼文件、編譯它，并執行宏將數組的文本轉換為實際數組來完成的。該方法與GIS開發者工具包中用于立即執行的方法相同。宏編譯后刪除資源文件，UI數據庫與即時執行使用的相同；下一次使用即時執行將重新創建UI數據庫。

此編輯器使用dBox資源之外的其他幾個宏資源。其中大多數用于在列表和數組的數組和文本版本之間進行轉換，以提供組件之間的同步，這些組件存儲為數字、滾動列表的文本以及調用LineStyle()的文本。dBox資源的許多復雜性在于維護這些組件的不同版本，以及用于控件的變量。

另一個宏資源用于構建微調器列表，即文本數組。微調器列表只有三個元素，即當前值之前的值和當前值之后的值。如果該值處于下限或上限，則只有兩個元素，即當前值和下一個更高或更低的值。

5、延伸閱讀：關于顏色

RGB 是對機器很友好的色彩模式，但并不夠人性化。因為 RGB 色彩模型是通過不同量的紅綠藍來描述一個顏色的，對人類來說很不直觀，難以理解。人類更習慣這樣去描述一個顏色：它是什么顏色？是鮮艷還是灰暗？HSB 和 HSL 都是基于此被創造出來的。

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

HSV示意圖

HSL，這里Chroma就是Saturation飽和度

HSL示意圖

顏色碼對照表

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

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

鏈接可下載Caliper的原始英文版本，我們對其進行了漢化和改進（如應用對象選擇）。

審核編輯 ：李倩