ShaderParameter  - AS3

套件	flash.display
類別	public final dynamic class ShaderParameter
繼承	ShaderParameter Object

代表 Shader 實體參數的 ShaderParameter 實體可以當作 Shader 實體之 data 屬性來存取。ShaderParameter 屬性的名稱與著色器程式碼中的參數名稱一樣。例如，如果著色器定義了名為 radius 的參數，則會將代表 radius 參數的 ShaderParameter 實體當成 radius 屬性來提供，如以下範例所示：

var radiusParam:ShaderParameter = myShader.data.radius;

除了 ShaderParameter 類別的定義屬性之外，每個 ShaderParameter 實體還包含其他屬性 (對應至針對參數定義的任何中繼資料)。這些屬性都會在建立時新增到 ShaderParameter 物件。屬性的名稱符合著色器原始碼中指定的中繼資料名稱。每個屬性的資料類型會依據對應的中繼資料之資料類型而有所不同。例如「description」之類的文字中繼資料是一個 String 實體。內含非字串值 (例如 minValue 或 defaultValue) 的中繼資料屬性會以 Array 實體來代表。元素的數目與元素資料類型會對應至中繼資料值。

例如，假設著色器內含下列兩個參數宣告：

     parameter float2 size
     <
         description: "The size of the image to which the kernel is applied";
         minValue: float2(0.0, 0.0);
         maxValue: float2(100.0, 100.0);
         defaultValue: float2(50.0, 50.0);
     >;
     
     parameter float radius
     <
         description: "The radius of the effect";
         minValue: 0.0;
         maxValue: 50.0;
         defaultValue: 25.0;
     >;
     

對應至 size 參數的 ShaderParameter 實體除了自身內建的屬性之外，還有下列中繼資料屬性：

對應至 radius 參數的 ShaderParameter 內含下列額外的屬性：

一般而言，開發人員程式碼不會直接建立 ShaderParameter 實體。ShaderParameter 實體會在建立 Shader 實體時針對每一個著色器的參數建立。

相關 API 元素