請在調用 lineShaderStyle() 方法之前調用 lineStyle() 方法以啟用筆觸,否則線條樣式的值將為 undefined。

調用 clear() 方法會將線條樣式設置回 undefined。

參數:

shader:Shader——用於線條筆觸的著色器。

matrix:Matrix (default = null)——一個由 flash.geom.Matrix 類定義的可選轉換矩陣。該矩陣可用於在將位圖應用於線條樣式之前縮放位圖,或以其他方式處理位圖。

19. lineStyle()方法

public function lineStyle(thickness:Number = NaN, color:uint = 0, alpha:Number = 1.0, pixelHinting:Boolean = false, scaleMode:String = "normal", caps:String = null, joints:String = null, miterLimit:Number = 3):void

語言版本: ActionScript 3.0。

運行時版本: AIR 1.0、Flash Player 9、Flash Lite 4。

指定一種線條樣式以用於隨後對 lineTo() 或 drawCircle() 等 Graphics 方法的調用。線條樣式仍然有效,直到用戶使用不同的參數調用 lineGradientStyle()、lineBitmapStyle()或 lineStyle() 方法。

可以在繪製路徑的中間調用 lineStyle() 方法為路徑中的不同線段指定不同的樣式。

調用 clear() 方法會將線條樣式設置回 undefined。

Flash Lite 4 僅支持前 3 個參數(thickness、color 和 alpha)。

參數:

thickness:Number (default = NaN)——一個整數,以點為單位表示線條的粗細;有效值為 0 到 255。如果未指定數字,或者未定義該參數,則不繪製線條。如果傳遞的值小於 0,則默認值為 0。值 0 表示極細的粗細,最大粗細為 255。如果傳遞的值大於 255,則默認值為 255。

color:uint (default = 0)——線條的十六進製顏色值(例如,紅色為 0xFF0000,藍色為 0x0000FF 等)。如果未指明值,則默認值為 0x000000(黑色)。可選。

alpha:Number (default = 1.0)——表示線條顏色的 alpha 值的數字,有效值為 0 到 1。如果未指明值,則默認值為 1(純色)。如果值小於 0,則默認值為 0。如果值大於 1,則默認值為 1。

pixelHinting:Boolean (default = false)——(在 Flash Lite 4 中不受支持)布爾型值,指定是否提示筆觸采用完整像素。它同時影響曲線錨點的位置以及線條筆觸大小本身。在 pixelHinting 設置為 true 的情況下,線條寬度會調整到完整像素寬度。在 pixelHinting 設置為 false 的情況下,對於曲線和直線可能會出現脫節。例如,下麵的插圖顯示了 Flash Player 或 Adobe AIR 如何呈現兩個相同的圓角矩形,不同之處是 lineStyle() 方法中使用的 pixelHinting 參數的設置不同(圖像已放大 200% 以強調差異),如圖8-3所示。

圖8-3

如果未提供值,則線條不使用像素提示。

scaleMode:String (default = "normal")——(在 Flash Lite 4 中不支持)LineScaleMode 類的值,用於指定要使用的比例模式:

? LineScaleMode.NORMAL—在縮放對象時總是縮放線條的粗細(默認值)。

? LineScaleMode.NONE—從不縮放線條粗細。

? LineScaleMode.VERTICAL—如果僅垂直縮放對象,則不縮放線條粗細。例如,考慮下麵的圓形,它們是用一個像素的線條繪製的,每個圓的 scaleMode 參數都被設置為 LineScaleMode.VERTICAL。左邊的圓僅在垂直方向上縮放,而右邊的圓則同時在垂直和水平方向上縮放,如圖8-4所示。

圖8-4

? LineScaleMode.HORIZONTAL—如果僅水平縮放對象,則不縮放線條粗細。例如,考慮下麵的圓形,它們是用一個像素的線條繪製的,每個圓的 scaleMode 參數都被設置為 LineScaleMode.HORIZONTAL。左邊的圓僅在水平方向上縮放,而右邊的圓則同時在垂直和水平方向上縮放,如圖8-5所示。

圖8-5

caps:String (default = null)——(在 Flash Lite 4 中不支持)用於指定線條末端處端點類型的CapsStyle 類的值。有效值為:CapsStyle.NONE、CapsStyle.ROUND和CapsStyle.SQUARE。如果未表示值,則 Flash 使用圓頭端點。

例如,以下圖示顯示了不同的 capsStyle 設置。對於每種設置,插圖顯示了一條粗細為 30 的藍色線條(應用 capsStyle 的線條),以及重疊於其上的粗細為 1 的黑色線條(未應用 capsStyle 的線條),如圖8-6所示。