# [name]

سطح ثنائي الأبعاد يمتد إلى ما لا نهاية في الفضاء ثلاثي الأبعاد ، ممثلًا في [link:http://mathworld.wolfram.com/HessianNormalForm.html Hessian normal form] بواسطة متجه طبيعي ذو طول وحدة وثابت.

## المنشئ (Constructor)

### [name]( [param:Vector3 normal], [param:Float constant] )

[page:Vector3 normal] - (اختياري) وحدة طول[page:Vector3] تحدد الطبيعي للطائرة. الافتراضي هو `(1، 0، 0)`.
[page:Float constant] - (اختياري) المسافة الموقعة من المنشأ إلى الطائرة. الافتراضي هو `0`.

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

### [property:Boolean isPlane]

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

### [property:Vector3 normal]

### [property:Float constant]

## الطرق (Methods)

### [method:this applyMatrix4]( [param:Matrix4 matrix], [param:Matrix3 optionalNormalMatrix] )

[page:Matrix4 matrix] - الـ[Page:Matrix4] للتطبيق.
[page:Matrix3 optionalNormalMatrix] - (اختياري) محسوب مسبقًا عادي [Page:Matrix3] من Matrix4 قيد التطبيق.
تطبيق Matrix4 على الطائرة. يجب أن تكون المصفوفة تحولًا متجانسًا ومتجانسًا.
إذا كنت تزود بـ[page:Matrix3 optionalNormalMatrix] ، فيمكن إنشاؤه هكذا: `const optionalNormalMatrix = new THREE.Matrix3().getNormalMatrix( matrix );`

### [method:Plane clone]()

يعيد طائرة جديدة بنفس [page:.normal normal] و [page:.constant constant] كهذا.

### [method:Vector3 coplanarPoint]( [param:Vector3 target] )

[page:Vector3 target] - سيتم نسخ النتيجة في هذا Vector3.
يعيد[page:Vector3] متعامدًا على الطائرة ، عن طريق حساب إسقاط المتجه الطبيعي في المنشأ على الطائرة.

### [method:this copy]( [param:Plane plane] )

ينسخ قيم خصائص [page:.normal normal] و[page:.constant constant] للطائرة الممر إلى هذه الطائرة.

### [method:Float distanceToPoint]( [param:Vector3 point] )

يعود بالمسافة الموقعة من[page:Vector3 point] إلى الطائرة.

### [method:Float distanceToSphere]( [param:Sphere sphere] )

يعود بالمسافة الموقعة من[page:Sphere sphere] إلى الطائرة.

### [method:Boolean equals]( [param:Plane plane] )

يتحقق لمعرفة ما إذا كانت طائرتان متساويتين (خصائصهما [page:.normal normal] و [page:.constant constant] تتطابق).

### [method:Vector3 intersectLine]( [param:Line3 line], [param:Vector3 target] )

[page:Line3 line] - الـ[page:Line3] للتحقق من التقاطع.
[page:Vector3 target] - سيتم نسخ النتيجة في هذا Vector3.
يعيد نقطة التقاطع للخط الممر والطائرة. يعود فارغ إذا لم يتقاطع الخط. يعود نقطة البداية للخط إذا كان الخط متعامد مع الطائرة.

### [method:Boolean intersectsBox]( [param:Box3 box] )

[page:Box3 box] - الـ[page:Box3] للتحقق من التقاطع.
يحدد ما إذا كانت هذه الطائرة تتقاطع مع[page:Box3 box].

### [method:Boolean intersectsLine]( [param:Line3 line] )

[page:Line3 line] - الـ[page:Line3] للتحقق من التقاطع.
يختبر ما إذا كان قطع الخط يتقاطع مع (يمر عبر) الطائرة.

### [method:Boolean intersectsSphere]( [param:Sphere sphere] )

[page:Sphere sphere] - الـ[page:Sphere] للتحقق من التقاطع.
يحدد ما إذا كانت هذه الطائرة تتقاطع مع[page:Sphere sphere].

### [method:this negate]()

ينفي كلاً من المتجه الطبيعي والثابت.

### [method:this normalize]()

يسوي المتجه[page:.normal normal] ، ويضبط قيمة[page:.constant constant] بشكل ملائم.

### [method:Vector3 projectPoint]( [param:Vector3 point], [param:Vector3 target] )

[page:Vector3 point] - الـ[page:Vector3] للإسقاط على الطائرة.
[page:Vector3 target] - سيتم نسخ النتيجة في هذا Vector3.
يسقط نقطة[page:Vector3 point] على الطائرة.

### [method:this set]( [param:Vector3 normal], [param:Float constant] )

[page:Vector3 normal] - وحدة طول [page:Vector3] تحدد الطبيعي من الطائرة.
[page:Float constant] - المسافة الموقعة من المنشأ إلى الطائرة. الافتراضي هو `0`.
يضع خصائص [page:.normal normal] و[page:.constant constant] لهذه الطائرة عن طريق نسخ القيم من الطبيعي المعطى.

### [method:this setComponents]( [param:Float x], [param:Float y], [param:Float z], [param:Float w] )

[page:Float x] - قيمة x للمتجه الطبيعي ذو الطول الوحدة.
[page:Float y] - قيمة y للمتجه الطبيعي ذو الطول الوحدة.
[page:Float z] - قيمة z للمتجه الطبيعي ذو الطول الوحدة.
[page:Float w] - قيمة خاصية [page:.constant constant] للطائرة.
قم بتعيين المكونات الفردية التي تحدد الطائرة.

### [method:this setFromCoplanarPoints]( [param:Vector3 a], [param:Vector3 b], [param:Vector3 c] )

[page:Vector3 a] - أول نقطة على الطائرة.
[page:Vector3 b] - نقطة ثانية على الطائرة.
[page:Vector3 c] - نقطة ثالثة على الطائرة.
يحدد الطائرة بناءً على 3 نقاط مقدمة. يفترض أن تكون ترتيب التغليف عكس عقارب الساعة ، وتحدد اتجاه [page:.normal normal].

### [method:this setFromNormalAndCoplanarPoint]( [param:Vector3 normal], [param:Vector3 point] )

[page:Vector3 normal] - وحدة طول[page:Vector3] تحدد الطبيعي من الطائرة.
[page:Vector3 point] -[page:Vector3]
يضع خصائص الطائرة كما هو محدد بـ[page:Vector3 normal] و نقطة متعامدية عشوائية[page:Vector3 point].

### [method:this translate]( [param:Vector3 offset] )

[page:Vector3 offset] - المسافة التي يجب تحريك الطائرة بها.
يترجم الطائرة بالمسافة التي يحددها متجه[page:Vector3 offset] . لاحظ أن هذا يؤثر فقط على ثابت الطائرة ولن يؤثر المتجه الطبيعي.

## المصدر (Source)

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