# [name]

يعمل كفئة أساسية لفئات الظلال الأخرى.

## المنشئ (Constructor)

### [name]( [param:Camera camera] )

[page:Camera camera] - رؤية الضوء للعالم.
إنشاء [name] جديد. لا يُقصد من هذا الاتصال مباشرة - هو يستخدم كفئة أساسية من قبل ظلال الضوء الأخرى.

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

### [property:Boolean autoUpdate]

يتيح التحديثات التلقائية لظل الضوء. الافتراضي هو `true`. إذا كنت لا تتطلب إضاءة / ظلال ديناميكية ، يمكنك تعيين هذا على `false`.

### [property:Camera camera]

رؤية الضوء للعالم. يتم استخدام هذا لإنشاء خريطة عمق لـ المشهد ؛ الأشياء خلف الأشياء الأخرى من منظور الضوء ستكون في الظل.

### [property:Float bias]

انحياز خريطة الظل ، كم يجب إضافة أو طرح من العمق المعاد تدويره عند تحديد ما إذا كانت سطحًا في الظل.
الافتراضي هو 0. قد تساعد التعديلات الصغيرة جدًا هنا (بترتيب 0.0001) تقليل التحف في الظلال

### [property:Integer blurSamples]

عدد العينات المستخدمة عند طمس خريطة ظل VSM.

### [property:WebGLRenderTarget map]

خريطة العمق التي تم إنشاؤها باستخدام الكاميرا الداخلية ؛ موقع خارج عمق بكسل في الظل. يتم حسابه داخليًا أثناء التقديم.

### [property:WebGLRenderTarget mapPass]

خريطة التوزيع التي تم إنشاؤها باستخدام الكاميرا الداخلية ؛ يتم حساب احتجاب بناءً على توزيع الأعماق. يتم حسابه داخليًا أثناء التقديم.

### [property:Vector2 mapSize]

[Page:Vector2] يحدد عرض وارتفاع خريطة الظل.
تعطي قيم أعلى جودة أفضل للظلال بتكلفة وقت الحساب. يجب أن تكون قيم قوى 2 ، حتى [page:WebGLRenderer.capabilities].maxTextureSize لجهاز معين, على الرغم من أنه لا يجب أن يكون نفسه (ولذلك ، على سبيل المثال ، (512، 1024) صالح). الافتراضي هو * (512، 512) *.

### [property:Matrix4 matrix]

نموذج لمساحة الكاميرا الظلية ، لحساب الموقع والعمق في خريطة الظل. تخزين في [page:Matrix4 Matrix4]. يتم حساب هذا داخليًا أثناء التقديم.

### [property:Boolean needsUpdate]

عند تعيينه على `true` ، سيتم تحديث خرائط الظل في الاتصال التالي `render`. الافتراضي هو `false`. إذا قمت بتعيين [page:.autoUpdate] على `false` ، فأنت سوف تحتاج إلى تعيين هذه الخاصية على `true` ثم إجراء مكالمة تقديم لـ تحديث ظل الضوء.

### [property:Float normalBias]

يحدد كمية الموضع المستخدم للاستعلام عن خريطة الظل معوضًا عن الكائن الطبيعي. الافتراضي هو 0. يمكن استخدام زيادة هذه القيمة لـ تقليل حب الشباب في الظلال خاصة في المشاهد الكبيرة التي يضيء فيها الضوء الهندسة بزاوية ضحلة. التكلفة هي أن الظلال قد تبدو مشوه.

### [property:Float radius]

إعداد هذه القيم إلى قيم أكبر من 1 ستطمس حواف الظل.
ستسبب قيم عالية تأثيرات تجزئة غير مرغوب فيها في الظلال - أكبر [page:.mapSize mapSize] ستسمح بقيمة أعلى للاستخدام هنا قبل أن تصبح هذه التأثيرات مرئية.
إذا تم تعيين [page:WebGLRenderer.shadowMap.type] على [page:Renderer PCFSoftShadowMap]، لا يوجد لـ radius أثر و يُفضل زيادة النعومة عن طريق تقليل [page:.mapSize mapSize] بدلاً من ذلك.
لاحظ أن هذا لا يؤثر إذا كان [page:WebGLRenderer.shadowMap.type] هو تعيين إلى [page:Renderer BasicShadowMap].

## الطرق (Methods)

### [method:Vector2 getFrameExtents]()

تستخدم داخليًا من قبل المصور لتوسيع خريطة الظل لتحتوى على جميع viewports

### [method:undefined updateMatrices]( [param:Light light] )

تحديث المصفوفات للكاميرا والظل ، يستخدم داخليًا من قبل المصور.
light -- الضوء الذي يتم تقديم الظل له.

### [method:Frustum getFrustum]()

تحصل على فروستوم كاميرات الظل. يستخدم داخليًا من قبل المصور لإزالة الأشياء.

### [method:number getViewportCount]()

تستخدم داخليًا من قبل المصور للحصول على عدد viewports التى تحتاج إلى التقديم لهذا الظل.

### [method:undefined dispose]()

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

### [method:this copy]( [param:LightShadow source] )

ينسخ قيمة جميع الخصائص من [page:LightShadow source] إلى هذا الضوء.

### [method:LightShadow clone]()

ينشئ LightShadow جديد بنفس خصائص هذا.

### [method:Object toJSON]()

سيريالايز هذا LightShadow.

## المصدر (Source)

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