[page:Object3D] →

# [name]

كائن مساعد للمساعدة في تصور تأثير [page:DirectionalLight] على المشهد. يتكون هذا من مستوى وخط يمثلان موقع الضوء واتجاهه.

## مثال الكود

`const light = new THREE.DirectionalLight( 0xFFFFFF ); scene.add( light ); const helper = new THREE.DirectionalLightHelper( light, 5 ); scene.add( helper );`

## المنشئ (Constructor)

### [name]( [param:DirectionalLight light], [param:Number size], [param:Hex color] )

[page:DirectionalLight light]-- الضوء المراد تصويره.
[page:Number size] -- (اختياري) أبعاد المستوى. الافتراضي هو `1`.
[page:Hex color] -- (اختياري) إذا لم يتم تعيين هذا، فسيأخذ المساعد لون الضوء.

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

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

### [property:Line lightPlane]

يحتوي على شبكة الخط التي تظهر موقع الضوء الاتجاهي.

### [property:DirectionalLight light]

إشارة إلى [page:DirectionalLight directionalLight] المُعروض.

### [property:Object matrix]

إشارة إلى [page:Object3D.matrixWorld matrixWorld] الخاص بالضوء.

### [property:Object matrixAutoUpdate]

انظر [page:Object3D.matrixAutoUpdate]. تعيين إلى `false` هنا كما يستخدم المساعد [page:Object3D.matrixWorld matrixWorld] الخاص بالضوء.

### [property:hex color]

معلمة اللون التي تم تمريرها في المُنشئ. الافتراضي هو `undefined`. إذا تغير هذا، سيُحدِّث لون المساعد في المرة التالية التي يتم فيها استدعاء [page:.update update].

## الطرق (Methods)

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

### [method:undefined dispose]()

يُطلِق الموارد المتعلقة بوحدة معالجة الرسومات التي تم تخصيصها من قبل هذه العيّنة. اتصل بهذه الطريقة كلما لم يعد هذه العيّنة مستخدمة في تطبيقك.

### [method:undefined update]()

يُحدِّث المساعد ليطابق موقع واتجاه [page:.light directionalLight] المُعروض.

## المصدر (Source)

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