[page:Object3D] → [page:Light] →

# [name]

مسابير الضوء هي طريقة بديلة لإضافة الضوء إلى مشهد ثلاثي الأبعاد. على عكس مصادر الضوء الكلاسيكية (على سبيل المثال الاتجاهية ، النقطية أو الأضواء الموجهة) ، الضوء لا تنبعث المسابير. بدلاً من ذلك ، يخزنون معلومات حول الضوء يمر عبر المساحة ثلاثية الأبعاد. أثناء التقديم ، يتم تقريب الضوء الذي يضرب 3D الكائن باستخدام بيانات من مسبار الضوء.

عادةً ما يتم إنشاء مسابير الضوء من خرائط البيئة (الإشعاع). جناح [page:LightProbeGenerator] يمكن استخدامه لإنشاء مسابير ضوء من مثيلات [page:CubeTexture] أو [page:WebGLCubeRenderTarget]. ومع ذلك، يمكن توفير بيانات تقدير الضوء أيضًا في أشكال أخرى على سبيل المثال من قبل WebXR. هذا يتيح تقديم محتوى الواقع المعزز الذي يتفاعل مع إضاءة العالم الحقيقي.

تدعم تطبيق المسبار الحالي في three.js ما يسمى بـ مسابير ضوء ناعمة. هذا النوع من مسبار الضوء هو وظيفيًا مكافئ لـ خريطة بيئة إشعاعية.

## أمثلة (Examples)

[example:webgl_lightprobe WebGL / light probe ]
[example:webgl_lightprobe_cubecamera WebGL / light probe / cube camera ]

## المنشئ (Constructor)

### [name]( [param:SphericalHarmonics3 sh], [param:Float intensity] )

[page:SphericalHarmonics3 sh] - (اختياري) مثيل من [page:SphericalHarmonics3].
[page:Float intensity] - (اختياري) قيمة رقمية لـ شدة مسبار الضوء. الافتراضي هو 1.
يخلق جديد [name].

## الخصائص (Properties)

انظر قائمة [page:Light Light] الأساسية للخصائص المشتركة. جناح خاصية [page:Light.color color] لا يتم تقديرها حاليًا وبالتالي لديها لا تأثير.

### [property:Boolean isLightProbe]

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

### [property:SphericalHarmonics3 sh]

يستخدم مسبار الضوء التجانسات المجالية لتشفير معلومات التحديد.

## الطرق (Methods)

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

## المصدر (Source)

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