Pakiet | flash.display |
Klasa | public final dynamic class ShaderParameter |
Dziedziczenie | ShaderParameter Object |
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5 |
value
.
Dostęp do instancji ShaderParameter reprezentującej parametr dla instancji modułu cieniującego jest uzyskiwany w taki sam sposób, jak do właściwości należącej do właściwości data
instancji modułu cieniującego. Właściwość ShaderParameter ma taką samą nazwę, co nazwa parametru w kodzie modułu cieniującego. Na przykład: jeśli moduł cieniujący definiuje parametr o nazwie radius
, instancja ShaderParameter reprezentująca parametr radius
będzie dostępna jako właściwość radius
, co przedstawiono poniżej:
var radiusParam:ShaderParameter = myShader.data.radius;
Oprócz zdefiniowanych właściwości klasy ShaderParameter, każda instancja ShaderParameter zawiera dodatkowe właściwości odpowiadające dowolnym metadanym zdefiniowanym dla parametru. Te właściwości są dodawane do obiektu ShaderParameter podczas jego tworzenia. Nazwy właściwości są zgodne z nazwami metadanych określonymi w kodzie źródłowym modułu cieniującego. Typ danych każdej właściwości może być różny w zależności od typu danych odpowiadających metadanych. Wartość tekstowa metadanych, na przykład taka jak "description", jest instancją String. Właściwość metadanych o wartości innej niż ciąg znaków (np. minValue
lub defaultValue
) jest reprezentowana jako instancja Array. Liczba elementów i typy danych elementów odpowiadają wartościom metadanych.
Na przykład: załóżmy, że moduł cieniujący zawiera następujące dwie deklaracje parametrów:
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; >;
Instancja ShaderParameter odpowiadająca parametrowi size
zawiera następujące właściwości metadanych, a także właściwości wbudowane:
Nazwa właściwości | Typ danych | Wartość |
---|---|---|
name
| String |
"size"
|
description
| Ciąg znaków |
"The size of the image to which the kernel is applied"
|
minValue
| Array |
[0, 0]
|
maxValue
| Array |
[100, 100]
|
defaultValue
| Array |
[50, 50]
|
Obiekt ShaderParameter odpowiadający parametrowi radius
zawiera następujące dodatkowe właściwości:
Nazwa właściwości | Typ danych | Wartość |
---|---|---|
name
| String |
"radius"
|
description
| Ciąg znaków |
"The radius of the effect"
|
minValue
| Array |
[0]
|
maxValue
| Array |
[50]
|
defaultValue
| Array |
[25]
|
Zazwyczaj kod programisty nie tworzy bezpośrednio instancji ShaderParameter. Instancja ShaderParameter jest tworzona dla każdego parametru modułu cieniującego po utworzeniu instancji modułu.
Powiązane elementy interfejsu API
Właściwość | Zdefiniowane przez | ||
---|---|---|---|
constructor : Object
Odwołanie do obiektu klasy lub funkcji konstruktora, dotyczące danej instancji obiektu. | Object | ||
index : int [tylko do odczytu]
Indeks parametru (licząc od zera). | ShaderParameter | ||
type : String [tylko do odczytu]
Typ danych parametru zdefiniowany w module cieniującym. | ShaderParameter | ||
value : Array
Wartość lub wartości, które są przekazywane jako wartość parametru do modułu cieniującego. | ShaderParameter |
Metoda | Zdefiniowane przez | ||
---|---|---|---|
Tworzy instancję ShaderParameter. | ShaderParameter | ||
Wskazuje, czy dla obiektu zdefiniowano określoną właściwość. | Object | ||
Wskazuje, czy instancja klasy Object należy do łańcucha prototypów obiektu określonego jako parametr. | Object | ||
Wskazuje, czy określona właściwość istnieje i jest przeliczalna. | Object | ||
Ustawia dostępność właściwości dynamicznej używanej w pętlach. | Object | ||
Zwraca ciąg reprezentujący obiekt — sformatowany zgodnie z konwencjami właściwymi dla ustawień regionalnych. | Object | ||
Zwraca ciąg reprezentujący określony obiekt. | Object | ||
Zwraca pierwotną wartość dla określonego obiektu. | Object |
index | właściwość |
type | właściwość |
type:String
[tylko do odczytu] Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5 |
Typ danych parametru zdefiniowany w module cieniującym. Zestaw możliwych wartości dla właściwości type
jest zdefiniowany przez stałe w klasie ShaderParameterType.
Implementacja
public function get type():String
Powiązane elementy interfejsu API
value | właściwość |
value:Array
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5 |
Wartość lub wartości, które są przekazywane jako wartość parametru do modułu cieniującego. Właściwość value
jest tablicą indeksowaną. Liczba i typ elementów tablicy odpowiada typowi danych parametru, który można określić za pomocą właściwości type
.
W poniższej tabeli przedstawiono typ parametru oraz odpowiadającą liczbę i typ danych elementów value
tablicy:
Typ parametru | Liczba elementów | Typ danych elementu |
---|---|---|
float (ShaderParameterType.FLOAT ) | 1 | Number |
float2 (ShaderParameterType.FLOAT2 ) | 2 | Number |
float3 (ShaderParameterType.FLOAT3 ) | 3 | Number |
float4 (ShaderParameterType.FLOAT4 ) | 4 | Number |
int (ShaderParameterType.INT ) | 1 | int lub uint |
int2 (ShaderParameterType.INT2 ) | 2 | int lub uint |
int3 (ShaderParameterType.INT3 ) | 3 | int lub uint |
int4 (ShaderParameterType.INT4 ) | 4 | int lub uint |
bool (ShaderParameterType.BOOL ) | 1 | Boolean |
bool2 (ShaderParameterType.BOOL2 ) | 2 | Boolean |
bool3 (ShaderParameterType.BOOL3 ) | 3 | Boolean |
bool4 (ShaderParameterType.BOOL4 ) | 4 | Boolean |
float2x2 (ShaderParameterType.MATRIX2X2 ) | 4 | Number |
float3x3 (ShaderParameterType.MATRIX3X3 ) | 9 | Number |
float4x4 (ShaderParameterType.MATRIX4X4 ) | 16 | Number |
W przypadku parametrów typu macierz elementy tablicy wypełniają wiersze, a następnie kolumny macierzy. Na przykład: załóżmy, że następujący wiersz ActionScript służy do wypełniania parametru float2x2
o nazwie myMatrix
:
myShader.data.myMatrix.value = [.1, .2, .3, .4];
W module cieniującym elementy macierzy mają następujące wartości:
myMatrix[0][0]
: .1myMatrix[0][1]
: .2myMatrix[1][0]
: .3myMatrix[1][1]
: .4
Implementacja
public function get value():Array
public function set value(value:Array):void
ShaderParameter | () | Konstruktor |
public function ShaderParameter()
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5 |
Tworzy instancję ShaderParameter. Kod programisty nie wywołuje konstruktora ShaderParameter bezpośrednio. Wystąpienie klasy ShaderParameter jest tworzone dla każdego parametru modułu cieniującego po utworzeniu wystąpienia klasy Shader.
Tue Jun 12 2018, 12:06 PM Z