ShaderParameter

Paket	flash.display
Sınıf	public final dynamic class ShaderParameter
Miras Alma	ShaderParameter Object

Dil Sürümü:

ActionScript 3.0

Çalışma Zamanı Sürümleri:

Flash Player 10, AIR 1.5

ShaderParameter örneği, gölgelendirici çekirdeğinin tek bir input parametresini temsil eder. Bir çekirdek, çekirdek çalıştırmasında kullanılan sıfır, bir veya daha fazla parametreyi kabul etmek için tanımlanabilir. Bir ShaderParameter, parametrenin beklediği veri türü gibi parametre hakkında bilgiler sağlar. Bu ayrıca gölgelendirici çalıştırıldığında kullanılan parametre değerinin ayarlanmasına yönelik bir mekanizma sağlar. shader parametresi için bir değer veya değerler belirtmek için, değer ya da değerler içeren bir Array oluşturun ve bunu value özelliğine atayın.

Shader örneğinin bir parametresini temsil eden ShaderParameter örneğine, Shader örneğinin data özelliğinin bir özelliği olarak erişilir. ShaderParameter özelliği, gölgelendirici kodunda parametrenin adıyla aynı ada sahiptir. Örneğin, gölgelendirici radius adında bir parametre tanımlarsa, radius parametresini temsil eden ShaderParameter örneği burada gösterildiği gibi radius özelliği olarak kullanılabilir:

var radiusParam:ShaderParameter = myShader.data.radius;

ShaderParameter sınıfının tanımlı özelliklerine ek olarak, her ShaderParameter örneği, parametre için tanımlanan meta veriye karşılık gelen ek özelliklere sahiptir. Bu özellikler, ShaderParameter nesnesi oluşturulurken bu nesneye eklenir. Özeliklerin adları, gölgelendiricinin kaynak kodunda belirtilen meta veri adlarıyla eşleşir. Her özelliğin veri türü, karşılık gelen meta verinin veri türüne göre değişiklik gösterir. "description" gibi metin meta verisi değeri bir String örneğidir. Dize olmayan bir değere sahip metadata özelliği (örn. minValue veya defaultValue) bir Array örneği olarak temsil edilir. Öğe ve öğe veri türlerinin sayısı, meta veri değerlerine karşılık gelir.

Örneğin, bir gölgelendiricinin şu iki parametre bildirimini içerdiğini varsayın:

     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 parametresine karşılık gelen ShaderParameter örneği, yerleşik özelliklerinin yanı sıra şu meta veri özelliklerine de sahiptir:

Özellik adı	Veri türü	Değer
`name`	String	`"size"`
`description`	String	`"The size of the image to which the kernel is applied"`
`minValue`	Array	`[0, 0]`
`maxValue`	Array	`[100, 100]`
`defaultValue`	Array	`[50, 50]`

radius parametresine karşılık gelen ShaderParameter öğesi şu ek özelliklere sahiptir:

Özellik adı	Veri türü	Değer
`name`	String	`"radius"`
`description`	String	`"The radius of the effect"`
`minValue`	Array	`[0]`
`maxValue`	Array	`[50]`
`defaultValue`	Array	`[25]`

Genellikle geliştirici kodu doğrudan bir ShaderParameter örneği oluşturmaz. Shader örneği oluşturulduğunda, gölgelendiricinin her parametresi için bir ShaderParameter örneği oluşturulur.

İlgili API Öğeleri

flash.display.ShaderData
flash.display.Shader.data

Genel Özellikler

Miras Alınan Genel Özellikleri Gizle

Miras Alınan Genel Özellikleri Göster

	Özellik		Tanımlayan:
		constructor : Object Belirli bir nesne örneği için sınıf nesnesine veya yapıcı işlevine bir başvuru.	Object
		index : int [salt okunur] Parametrenin sıfır temelli dizini.	ShaderParameter
		type : String [salt okunur] Gölgelendiricide tanımlandığı haliyle parametrenin veri türü.	ShaderParameter
		value : Array Gölgelendiriciye parametre değeri olarak iletilen değer veya değerler.	ShaderParameter

Genel Yöntemler

Miras Alınan Genel Yöntemleri Gizle

Miras Alınan Genel Yöntemleri Göster

	Yöntem		Tanımlayan:
		ShaderParameter() Bir ShaderParameter örneği oluşturur.	ShaderParameter
		hasOwnProperty(name:String):Boolean Bir nesnenin belirli bir özelliğinin tanımlı olup olmadığını gösterir.	Object
		isPrototypeOf(theClass:Object):Boolean Object sınıfının bir örneğinin parametre olarak belirtilen nesnenin prototip zincirinde olup olmadığını gösterir.	Object
		propertyIsEnumerable(name:String):Boolean Belirtilen özelliğin bulunup bulunmadığını ve numaralandırılabilir olup olmadığını gösterir.	Object
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Dinamik bir özelliğin döngü işlemlerinde kullanılabilirliğini ayarlar.	Object
		toLocaleString():String Bu nesnenin, yerel ayara özel kurallara göre biçimlendirilmiş dize temsilini döndürür.	Object
		toString():String Belirtilen nesnenin dize olarak temsil edilen halini döndürür.	Object
		valueOf():Object Belirtilen nesnenin temel değerini döndürür.	Object

Özellik Ayrıntısı

index

özellik

index:int [salt okunur]

Dil Sürümü:

ActionScript 3.0

Çalışma Zamanı Sürümleri:

Flash Player 10, AIR 1.5

Parametrenin sıfır temelli dizini.

Uygulama
public function get index():int

type

özellik

type:String [salt okunur]

Dil Sürümü:

ActionScript 3.0

Çalışma Zamanı Sürümleri:

Flash Player 10, AIR 1.5

Gölgelendiricide tanımlandığı haliyle parametrenin veri türü. type özelliğinin olası değerleri kümesi, ShaderParameterType sınıfındaki sabitler tarafından tanımlanır.

Uygulama
public function get type():String

İlgili API Öğeleri

flash.display.ShaderParameterType

value

özellik

value:Array

Dil Sürümü:

ActionScript 3.0

Çalışma Zamanı Sürümleri:

Flash Player 10, AIR 1.5

Gölgelendiriciye parametre değeri olarak iletilen değer veya değerler. value özelliği dizinli bir Array öğesidir. Array öğelerinin sayısı ve türü, parametrenin, type özelliği kullanılarak belirlenebilen veri türüne karşılık gelir.

Şu tablo, parametre türünü ve value Array öğelerinin karşılık gelen sayı ve veri türünü belirtir:

Parametre türü	# Öğe	Element veri türü
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 veya uint
int2 (`ShaderParameterType.INT2`)	2	int veya uint
int3 (`ShaderParameterType.INT3`)	3	int veya uint
int4 (`ShaderParameterType.INT4`)	4	int veya 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

matrix parametre türleri için, dizi öğeleri önce matrisin satırlarını ve sonra sütunları doldurur. Örneğin, myMatrix adında bir float2x2 parametresini doldurmak için ActionScript'in şu satırının kullanıldığını varsayın:

myShader.data.myMatrix.value = [.1, .2, .3, .4];

Gölgelendirici içinde, matris öğeleri şu değerlere sahiptir:

myMatrix[0][0]: .1
myMatrix[0][1]: .2
myMatrix[1][0]: .3
myMatrix[1][1]: .4

Uygulama
public function get value():Array
public function set value(value:Array):void

Yapıcı Ayrıntı

()

Yapıcı

public function ShaderParameter()

Dil Sürümü:

ActionScript 3.0

Çalışma Zamanı Sürümleri:

Flash Player 10, AIR 1.5

Bir ShaderParameter örneği oluşturur. Geliştirici kodu ShaderParameter yapıcısını doğrudan çağırmaz. Shader örneği oluşturulduğunda, gölgelendiricinin her parametresi için bir ShaderParameter örneği oluşturulur.

Yasal Uyarılar | Çevrimiçi Gizlilik İlkesi

ShaderParameter - AS3

Sınıflar x

index

type

value

ShaderParameter