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)的特殊值為純黑色。您還可以使用微調器向上或向下更改數字。可以在顏色系統之間切換，以查看每個系統中顏色的值。在HSL系統中，0或240的色相為紅色，80為綠色，160為藍色。飽和度為0表示沒有顏色，240表示全色。亮度0為黑色，120為純色，240為白色。

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

3、填充編輯器

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

填充樣式是一個8*8的值網格，用于指示圖案。這些值存儲在一個數組中，每個數組包含8個字符的8個字符串。空白代表圖案的背景，非空白（通常是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源代碼文件中。工具箱底部的按鈕對于所有選項卡都可見：

按鈕	描述
應用	將線條樣式、寬度和顏色應用于當前圖層（針對線圖層或面圖層）。
加載	將編輯文本框中調用LineStyle()的文本加載到平行和垂直組件中。
清除	將線樣式清除為默認線樣式。
顯示	強制使用當前設置；鍵入數字后按Enter鍵或單擊另一個控件也會執行相同的操作。
關閉	關閉工具箱，單擊工具箱右上角的“關閉(X)”框。

單擊“加載”之前，可以從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	底色
0	黑色
1	白色
2	紅色
3	綠色
4	藍色
5	淺藍色
6	黃色

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

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

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

按鈕	描述
添加	基于默認的線樣式添加新組件：例如{1, -1, 0}表示平行線，而{0, -1, 12, 25, 0, 3.5, 0, -4}表示垂直線
復制	復制高亮顯示的組件
刪除	刪除高亮顯示的組件
上移	向上移動高亮顯示的組件
下移	向下移動高亮顯示的組件

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

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

[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示意圖

顏色碼對照表

顏色	英文代碼	形象描述	十六進制	RGB
	LightPink	淺粉紅	#FFB6C1	255,182,193
	Pink	粉紅	#FFC0CB	255,192,203
	Crimson	猩紅	#DC143C	220,20,60
	LavenderBlush	臉紅的淡紫色	#FFF0F5	255,240,245
	PaleVioletRed	蒼白的紫羅蘭紅色	#DB7093	219,112,147
	HotPink	熱情的粉紅	#FF69B4	255,105,180
	DeepPink	深粉色	#FF1493	255,20,147
	MediumVioletRed	適中的紫羅蘭紅色	#C71585	199,21,133
	Orchid	蘭花的紫色	#DA70D6	218,112,214
	Thistle	薊	#D8BFD8	216,191,216
	plum	李子	#DDA0DD	221,160,221
	Violet	紫羅蘭	#EE82EE	238,130,238
	Magenta	洋紅	#FF00FF	255,0,255
	Fuchsia	燈籠海棠(紫紅色)	#FF00FF	255,0,255
	DarkMagenta	深洋紅色	#8B008B	139,0,139
	Purple	紫色	#800080	128,0,128
	MediumOrchid	適中的蘭花紫	#BA55D3	186,85,211
	DarkVoilet	深紫羅蘭色	#9400D3	148,0,211
	DarkOrchid	深蘭花紫	#9932CC	153,50,204
	Indigo	靛青	#4B0082	75,0,130
	BlueViolet	深紫羅蘭的藍色	#8A2BE2	138,43,226
	MediumPurple	適中的紫色	#9370DB	147,112,219
	MediumSlateBlue	適中的板巖暗藍灰色	#7B68EE	123,104,238
	SlateBlue	板巖暗藍灰色	#6A5ACD	106,90,205
	DarkSlateBlue	深巖暗藍灰色	#483D8B	72,61,139
	Lavender	熏衣草花的淡紫色	#E6E6FA	230,230,250
	GhostWhite	幽靈的白色	#F8F8FF	248,248,255
	Blue	純藍	#0000FF	0,0,255
	MediumBlue	適中的藍色	#0000CD	0,0,205
	MidnightBlue	午夜的藍色	#191970	25,25,112
	DarkBlue	深藍色	#00008B	0,0,139
	Navy	海軍藍	#000080	0,0,128
	RoyalBlue	皇家藍	#4169E1	65,105,225
	CornflowerBlue	矢車菊的藍色	#6495ED	100,149,237
	LightSteelBlue	淡鋼藍	#B0C4DE	176,196,222
	LightSlateGray	淺石板灰	#778899	119,136,153
	SlateGray	石板灰	#708090	112,128,144
	DoderBlue	道奇藍	#1E90FF	30,144,255
	AliceBlue	愛麗絲藍	#F0F8FF	240,248,255
	SteelBlue	鋼藍	#4682B4	70,130,180
	LightSkyBlue	淡藍色	#87CEFA	135,206,250
	SkyBlue	天藍色	#87CEEB	135,206,235
	DeepSkyBlue	深天藍	#00BFFF	0,191,255
	LightBLue	淡藍	#ADD8E6	173,216,230
	PowDerBlue	火藥藍	#B0E0E6	176,224,230
	CadetBlue	軍校藍	#5F9EA0	95,158,160
	Azure	蔚藍色	#F0FFFF	240,255,255
	LightCyan	淡青色	#E1FFFF	225,255,255
	PaleTurquoise	蒼白的綠寶石	#AFEEEE	175,238,238
	Cyan	青色	#00FFFF	0,255,255
	Aqua	水綠色	#D4F2E7	212,242,231
	DarkTurquoise	深綠寶石	#00CED1	0,206,209
	DarkSlateGray	深石板灰	#2F4F4F	47,79,79
	DarkCyan	深青色	#008B8B	0,139,139
	Teal	水鴨色	#008080	0,128,128
	MediumTurquoise	適中的綠寶石	#48D1CC	72,209,204
	LightSeaGreen	淺海洋綠	#20B2AA	32,178,170
	Turquoise	綠寶石	#40E0D0	64,224,208
	Auqamarin	綠玉碧綠色	#7FFFAA	127,255,170
	MediumAquamarine	適中的碧綠色	#00FA9A	0,250,154
	MediumSpringGreen	適中的春天的綠色	#00FF7F	0,255,127
	MintCream	薄荷奶油	#F5FFFA	245,255,250
	SpringGreen	春天的綠色	#3CB371	60,179,113
	SeaGreen	海洋綠	#2E8B57	46,139,87
	Honeydew	蜂蜜	#F0FFF0	240,255,240
	LightGreen	淡綠色	#90EE90	144,238,144
	PaleGreen	蒼白的綠色	#98FB98	152,251,152
	DarkSeaGreen	深海洋綠	#8FBC8F	143,188,143
	LimeGreen	酸橙綠	#32CD32	50,205,50
	Lime	酸橙色	#00FF00	0,255,0
	ForestGreen	森林綠	#228B22	34,139,34
	Green	純綠	#008000	0,128,0
	DarkGreen	深綠色	#006400	0,100,0
	Chartreuse	查特酒綠	#7FFF00	127,255,0
	LawnGreen	草坪綠	#7CFC00	124,252,0
	GreenYellow	綠黃色	#ADFF2F	173,255,47
	OliveDrab	橄欖土褐色	#556B2F	85,107,47
	Beige	米色(淺褐色)	#F5F5DC	245,245,220
	LightGoldenrodYellow	淺秋麒麟黃	#FAFAD2	250,250,210
	Ivory	象牙	#FFFFF0	255,255,240
	LightYellow	淺黃色	#FFFFE0	255,255,224
	Yellow	純黃	#FFFF00	255,255,0
	Olive	橄欖	#808000	128,128,0
	DarkKhaki	深卡其布	#BDB76B	189,183,107
	LemonChiffon	檸檬薄紗	#FFFACD	255,250,205
	PaleGodenrod	灰秋麒麟	#EEE8AA	238,232,170
	Khaki	卡其布	#F0E68C	240,230,140
	Gold	金	#FFD700	255,215,0
	Cornislk	玉米色	#FFF8DC	255,248,220
	GoldEnrod	秋麒麟	#DAA520	218,165,32
	FloralWhite	花的白色	#FFFAF0	255,250,240
	OldLace	老飾帶	#FDF5E6	253,245,230
	Wheat	小麥色	#F5DEB3	245,222,179
	Moccasin	鹿皮鞋	#FFE4B5	255,228,181
	Orange	橙色	#FFA500	255,165,0
	PapayaWhip	番木瓜	#FFEFD5	255,239,213
	BlanchedAlmond	漂白的杏仁	#FFEBCD	255,235,205
	NavajoWhite	納瓦霍白	#FFDEAD	255,222,173
	AntiqueWhite	古代的白色	#FAEBD7	250,235,215
	Tan	曬黑	#D2B48C	210,180,140
	BrulyWood	結實的樹	#DEB887	222,184,135
	Bisque	(濃湯)乳脂,番茄等	#FFE4C4	255,228,196
	DarkOrange	深橙色	#FF8C00	255,140,0
	Linen	亞麻布	#FAF0E6	250,240,230
	Peru	秘魯	#CD853F	205,133,63
	PeachPuff	桃色	#FFDAB9	255,218,185
	SandyBrown	沙棕色	#F4A460	244,164,96
	Chocolate	巧克力	#D2691E	210,105,30
	SaddleBrown	馬鞍棕色	#8B4513	139,69,19
	SeaShell	海貝殼	#FFF5EE	255,245,238
	Sienna	黃土赭色	#A0522D	160,82,45
	LightSalmon	淺鮮肉(鮭魚)色	#FFA07A	255,160,122
	Coral	珊瑚	#FF7F50	255,127,80
	OrangeRed	橙紅色	#FF4500	255,69,0
	DarkSalmon	深鮮肉(鮭魚)色	#E9967A	233,150,122
	Tomato	番茄	#FF6347	255,99,71
	MistyRose	薄霧玫瑰	#FFE4E1	255,228,225
	Salmon	鮮肉(鮭魚)色	#FA8072	250,128,114
	Snow	雪	#FFFAFA	255,250,250
	LightCoral	淡珊瑚色	#F08080	240,128,128
	RosyBrown	玫瑰棕色	#BC8F8F	188,143,143
	IndianRed	印度紅	#CD5C5C	205,92,92
	Red	純紅	#FF0000	255,0,0
	Brown	棕色	#A52A2A	165,42,42
	FireBrick	耐火磚	#B22222	178,34,34
	DarkRed	深紅色	#8B0000	139,0,0
	Maroon	栗色	#800000	128,0,0
	White	純白	#FFFFFF	255,255,255
	WhiteSmoke	白煙	#F5F5F5	245,245,245
	Gainsboro	亮灰色	#DCDCDC	220,220,220
	LightGrey	淺灰色	#D3D3D3	211,211,211
	Silver	銀白色	#C0C0C0	192,192,192
	DarkGray	深灰色	#A9A9A9	169,169,169
	Gray	灰色	#808080	128,128,128
	DimGray	暗淡的灰色	#696969	105,105,105
	Black	純黑	#000000	0,0,0

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

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

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

審核編輯 ：李倩