[page:Material] →

[name]

A material for a use with a [page:Sprite].

مثال للكود

const map = new THREE.TextureLoader().load( 'textures/sprite.png' ); const material = new THREE.SpriteMaterial( { map: map, color: 0xffffff } ); const sprite = new THREE.Sprite( material ); sprite.scale.set(200, 200, 1) scene.add( sprite );

Examples

[example:webgl_raycaster_sprite WebGL / raycast / sprite]
[example:webgl_sprites WebGL / sprites]
[example:svg_sandbox SVG / sandbox]

المنشئ (Constructor)

[name]( [param:Object parameters] )

[page:Object parameters] - (اختياري) كائن يحتوي على واحد أو أكثر خصائص تحدد مظهر المادة. يمكن تمرير أي خاصية من المادة (بما في ذلك أي خاصية موروثة من [page:Material]) هنا.

الاستثناء هو خاصية [page:Hexadecimal color]، التي يمكن تمريرها كسلسلة ست عشرية وهي `0xffffff` (أبيض) افتراضيًا. يتم استدعاء [page:Color.set]( color ) داخليًا. لا يتم قطع SpriteMaterials باستخدام [page:Material.clippingPlanes].

الخصائص (Properties)

انظر إلى الفئة الأساسية [page:Material] للخصائص المشتركة.

[property:Texture alphaMap]

الخريطة الألفية هي نسيج رمادي يتحكم في التعتيم عبر السطح (أسود: شفاف تمامًا؛ أبيض: غير شفاف تمامًا). الافتراضي هو null.

يتم استخدام لون النسيج فقط، متجاهلاً قناة الألفا إذا كانت موجودة. بالنسبة للقوام RGB و RGBA، سيستخدم [page:WebGLRenderer WebGL] renderer قناة الأخضر عند عينة هذا النسيج بسبب البت الإضافي من الدقة المقدمة للأخضر في تنسيقات DXT المضغوطة و RGB 565 غير المضغوطة. ستعمل القوام المُضِئَة فقط والقوام المُضِئَة / الألفية أيضًا كما هو متوقع.

[property:Color color]

[page:Color] المادة، بشكل افتراضي مضبوط على الأبيض (0xffffff). The [page:.map] مضروب باللون.

[property:Boolean fog]

ما إذا كانت المادة متأثرة بالضباب. الافتراضي هو `true`.

[property:Boolean isSpriteMaterial]

علامة للقراءة فقط للتحقق مما إذا كان كائنًا معطىً من نوع [name].

[property:Texture map]

خريطة اللون. قد تشمل اختيارًا قناة ألفا، عادةً مُجَمَّعَةً مع [page:Material.transparent .transparent] أو [page:Material.alphaTest .alphaTest]. الافتراضي هو null.

[property:Radians rotation]

دوران الرذاذ بالراديان. الافتراضي هو 0.

[property:Boolean sizeAttenuation]

ما إذا كان حجم الرذاذ يُخَفَّف بعمق الكاميرات. (كاميرات المنظور فقط.) الافتراضي هو `true`.

[property:Boolean transparent]

يحدد ما إذا كانت هذه المادة شفافة. الافتراضي هو `true`.

الطرق (Methods)

انظر إلى الفئة الأساسية [page:Material] للطرق المشتركة.

المصدر (Source)

[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]