NewRGBRadialShader

向量圖形與色彩

描述

此頁面描述 PDF Library for Delphi 在「向量圖形與色彩」主題下的 NewRGBRadialShader。API 名稱、參數、類別名稱、檔案名稱與字面量（literals）皆完全保留其在 Delphi 程式庫與 DLL 進入點中的原始樣貌。

NewRGBRadialShader 註冊一個命名的雙圓徑向漸層（ShadingType 3，ISO 32000-1 §8.7.4.5.3），在起始圓的起始顏色與結束圓的結束顏色間融合。它是 NewRGBAxialShader 的徑向對應功能；請透過 SetFillShader、SetLineShader 或 SetTextShader 選取已註冊的著色器（shader），接著如常進行繪製。

語法

Delphi

Function TPDFlib.NewRGBRadialShader(Const ShaderName: WideString; StartX, StartY, StartRadius, StartRed, StartGreen, StartBlue, EndX, EndY, EndRadius, EndRed, EndGreen, EndBlue: Double; Extend: Integer): Integer;

參數

ShaderName 是呼叫端選擇的名稱，用於稍後選取該著色器。StartX/StartY/StartRadius 定義了起始圓，而 StartRed/StartGreen/StartBlue (0..1) 定義了其顏色；EndX/EndY/EndRadius 與 EndRed/EndGreen/EndBlue 定義了結束圓。一對同心圓加上 StartRadius 0 會產生經典的圓形「發光」漸層。Extend 傳入 1 會使兩端顏色延伸至圓形範圍外，傳入 0 則在圓形處停止繪製。

傳回值

著色器註冊成功時傳回 1；若名稱已被使用或半徑為負值，則傳回 0。

備註

座標與半徑採用頁面單位，並遵循透過 SetOrigin 選取的原點。著色器帶有 DeviceRGB 的指數型漸層（exponential colour ramp）；產生的漸層圖案可在任何相容的檢視器中，以及透過 PDF Library for Delphi 頁面渲染器進行渲染。