NewRGBRadialShader

矢量图形、颜色

描述

本页在“Vector graphics, Color”主题下描述 Delphi PDF 库中的 NewRGBRadialShader。API 名称、参数、类名、文件名和字面量均与 Delphi 库和 DLL 入口点中的原样保持一致

NewRGBRadialShader 注册一个命名的双圆径向渐变（ShadingType 3，ISO 32000-1 §8.7.4.5.3），在起始圆上的起始颜色和结束圆上的结束颜色之间进行混合。它是 NewRGBAxialShader 的径向对应版本；使用 SetFillShader、SetLineShader 或 SetTextShader 选择已注册的着色器，然后照常绘制即可

语法

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 指数颜色渐变；生成的着色图案可在任何符合规范的查看器中以及通过 PDF Library for Delphi 页面渲染器呈现