Pakket | flash.display |
Klasse | public final dynamic class ShaderParameter |
Overerving | ShaderParameter Object |
Taalversie: | ActionScript 3.0 |
Runtimeversies: | Flash Player 10, AIR 1.5 |
value
.
Een ShaderParameter-instantie die een parameter voor een Shader-instantie vertegenwoordigt, wordt benaderd als een eigenschap van de eigenschap data
van de Shader-instantie. De ShaderParameter-eigenschap heeft dezelfde naam als de naam van de parameter in de arceringscode. Als een arcering bijvoorbeeld een parameter met de naam radius
definieert, is de ShaderParameter-instantie die de parameter radius
vertegenwoordigt, beschikbaar als de eigenschap radius
, zoals u in dit voorbeeld kunt zien:
var radiusParam:ShaderParameter = myShader.data.radius;
Naast de gedefinieerde eigenschappen van de klasse ShaderParameter, heeft elke ShaderParameter-instantie aanvullende eigenschappen die overeenkomen met metagegevens die zijn gedefinieerd voor de parameter. Deze eigenschappen worden toegevoegd aan het ShaderParameter-object als dit wordt gemaakt. De namen van de eigenschappen komen overeen met de metagegevensnamen die zijn opgegeven in de broncode van de arcering. Het gegevenstype van elke eigenschap varieert afhankelijk van het gegevenstype van de overeenkomstige metagegevens. Een tekstmetagegevenswaarde als "beschrijving" is een String-instantie. Een metagegevenseigenschap met een niet-string-waarde (zoals minValue
of defaultValue
) wordt vertegenwoordigd als een Array-instantie. Het aantal elementen en elementgegevenstypen komt overeen met de metagegevenswaarden.
Stel bijvoorbeeld dat een arcering de volgende twee parameterdeclaraties bevat:
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; >;
De ShaderParameter-instantie die overeenkomt met de parameter size
heeft de volgende metagegevenseigenschappen naast de ingebouwde eigenschappen:
Eigenschapnaam | Gegevenstype | Waarde |
---|---|---|
name
| String |
"size"
|
beschrijving
| String |
"Het formaat van de afbeelding waarop de kernel wordt toegepast"
|
minValue
| Array |
[0, 0]
|
maxValue
| Array |
[100, 100]
|
defaultValue
| Array |
[50, 50]
|
De ShaderParameter die overeenkomt met de parameter radius
heeft de volgende aanvullende eigenschappen:
Eigenschapnaam | Gegevenstype | Waarde |
---|---|---|
name
| String |
"radius"
|
beschrijving
| String |
"De radius van het effect"
|
minValue
| Array |
[0]
|
maxValue
| Array |
[50]
|
defaultValue
| Array |
[25]
|
ShaderParameter-instanties worden gewoonlijk niet rechtstreeks in de ontwikkelcode gemaakt. Bij het maken van de Shader-instantie wordt een ShaderParameter-instantie gemaakt voor elk van de parameters van de arcering.
Verwante API-elementen
Eigenschap | Gedefinieerd door | ||
---|---|---|---|
constructor : Object
Verwijzing naar het klasseobject of de constructorfunctie van een bepaalde objectinstantie. | Object | ||
index : int [alleen-lezen]
De op nul gebaseerde index van de parameter. | ShaderParameter | ||
type : String [alleen-lezen]
Het gegevenstype van de parameter zoals dat is gedefinieerd in de arcering. | ShaderParameter | ||
value : Array
De waarde(n) die als de parameterwaarde worden doorgegeven naar de arcering. | ShaderParameter |
Methode | Gedefinieerd door | ||
---|---|---|---|
Maakt een ShaderParameter-instantie. | ShaderParameter | ||
Geeft aan of voor een object een opgegeven eigenschap is gedefinieerd. | Object | ||
Geeft aan of een instantie van de klasse Object zich in de prototypeketen van het object bevindt dat als parameter is opgegeven. | Object | ||
Geeft aan of de opgegeven eigenschap bestaat en kan worden opgesomd. | Object | ||
Stelt de beschikbaarheid van een dynamische eigenschap voor lusbewerkingen in. | Object | ||
Geeft de tekenreeksweergave van dit object weer, geformatteerd volgens de locatiespecifieke conventies. | Object | ||
Retourneert een tekenreeksrepresentatie van het opgegeven object. | Object | ||
Retourneert de primitieve waarde van het opgegeven object. | Object |
index | eigenschap |
type | eigenschap |
type:String
[alleen-lezen] Taalversie: | ActionScript 3.0 |
Runtimeversies: | Flash Player 10, AIR 1.5 |
Het gegevenstype van de parameter zoals dat is gedefinieerd in de arcering. De set met mogelijke waarden voor de eigenschap type
wordt gedefinieerd door de constanten in de klasse ShaderParameterType.
Implementatie
public function get type():String
Verwante API-elementen
value | eigenschap |
value:Array
Taalversie: | ActionScript 3.0 |
Runtimeversies: | Flash Player 10, AIR 1.5 |
De waarde(n) die als de parameterwaarde worden doorgegeven naar de arcering. De eigenschap value
is een geïndexeerde Array. Het aantal en type elementen van de Array komt overeen met het gegevenstype van de parameter, dat kan worden bepaald met de eigenschap type
.
De volgende tabel bevat het parametertype en het overeenkomstige aantal en gegevenstype van de elementen van de value
-Array:
Type parameter | Aantal elementen | Gegevenstype Element |
---|---|---|
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 of uint |
int2 (ShaderParameterType.INT2 ) | 2 | int of uint |
int3 (ShaderParameterType.INT3 ) | 3 | int of uint |
int4 (ShaderParameterType.INT4 ) | 4 | int of 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 |
Voor de matrixparametertypen vullen de matrixelementen eerst de rijen van de matrix en daarna de kolommen. Stel bijvoorbeeld dat met de volgende regel ActionScript een parameter float2x2
met de naam myMatrix
wordt gevuld:
myShader.data.myMatrix.value = [.1, .2, .3, .4];
Binnen de arcering hebben de matrixelementen de volgende waarden:
myMatrix[0][0]
: .1myMatrix[0][1]
: .2myMatrix[1][0]
: .3myMatrix[1][1]
: .4
Implementatie
public function get value():Array
public function set value(value:Array):void
ShaderParameter | () | Constructor |
public function ShaderParameter()
Taalversie: | ActionScript 3.0 |
Runtimeversies: | Flash Player 10, AIR 1.5 |
Maakt een ShaderParameter-instantie. De constructor ShaderParameter wordt niet rechtstreeks aangeroepen in de ontwikkelcode. Bij het maken van de Shader-instantie wordt een ShaderParameter-instantie gemaakt voor elk van de parameters van de arcering.
Wed Jun 13 2018, 11:42 AM Z