[page:Object3D] → [page:Line] → [page:LineSegments] →

# [name]

كائن مساعد لإظهار الحدود المحيطة المتوازية مع محور العالم بشكل بصري حول كائن. يتم التعامل مع الحدود المحيطة الفعلية باستخدام [page:Box3]، هذا مجرد مساعد بصري للتصحيح. يمكن تغيير حجمه تلقائيًا باستخدام طريقة [page:BoxHelper.update] عندما يتم تحويل الكائن الذي تم إنشاؤه منه. لاحظ أن يجب أن يكون للكائن [page:BufferGeometry] لكي يعمل هذا، لذلك لن يعمل مع [page:Sprite Sprites].

## مثال الكود

`const sphere = new THREE.SphereGeometry(); const object = new THREE.Mesh( sphere, new THREE.MeshBasicMaterial( 0xff0000 ) ); const box = new THREE.BoxHelper( object, 0xffff00 ); scene.add( box );`

## أمثلة (Examples)

[example:webgl_helpers WebGL / helpers]
[example:webgl_loader_nrrd WebGL / loader / nrrd]
[example:webgl_buffergeometry_drawrange WebGL / buffergeometry / drawrange]

## المنشئ (Constructor)

### [name]( [param:Object3D object], [param:Color color] )

[page:Object3D object] -- (اختياري) الـ object3D المراد عرض الحدود المحيطة المتوازية مع محور العالم.
[page:Color color] -- (اختياري) قيمة ست عشرية تحدد لون الصندوق. الافتراضي هو 0xffff00.
ينشئ صندوقًا جديدًا بإطار سلكي يحد الكائن المُمرَّر. يستخدم هذا داخليًا [page:Box3.setFromObject] لحساب الأبعاد. لاحظ أن هذا يشمل أي أطفال.

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

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

## الطرق (Methods)

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

### [method:undefined update]()

يُحدِّث هندسة المساعد لتطابق أبعاد الكائن، بما في ذلك أي أطفال. انظر [page:Box3.setFromObject].

### [method:this setFromObject]( [param:Object3D object] )

[page:Object3D object] - [page:Object3D] لإنشاء المساعد منه.
يُحدِّث صندوق الإطار السلكي للكائن المُمرَّر.

### [method:undefined dispose]()

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

## المصدر (Source)

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