Starling Spatial Deactivator

AS3 / starling - إلغاء إلغاء الاطلاع المكاني

هذا الامتداد starling هو نهج لحل التنشيط المكاني 2D / إلغاء تنشيط كائنات اللعبة. من المفترض أن تعتني بعناصر الألعاب / إخفاءها خارج الشاشة على سبيل المثال ، ولكن ليس فقط ... ستتمكن من القيام بكل ما تريد بشكل أساسي مع كائن اللعبة عندما يُعتبر نشطًا أو غير نشط.

يمكن أن تكون هذه المكتبة مفيدة لك إذا:

• يمكن أن تترك كائنات اللعبة منطقة نشطة محددة (عرض الكاميرا على سبيل المثال) وبالتالي تحتاج إلى إلغاء تنشيطها.
• يمكن أن تتفاعل كائنات اللعبة مع بعضها البعض وتحتاج إلى التأكد من إلغاء تنشيط كائنات اللعبة "بأمان".

لمزيد من التفاصيل حول التنفيذ ، يرجى إلقاء نظرة على الصفحة التجريبية.

▶ عرض مباشر

جربه هنا!

كيف تستخدمه؟

في GameManager الخاص بك:

 private var _deactivator : SpatialDeactivator ;
private var _activeAreaAABB : Rectangle = new Rectangle ( 0 , 0 , 120 , 80 ) ;

public function MyGameManager()
{
	// Create the spatial deactivator
	_deactivator = new SpatialDeactivator(_activeAreaAABB.width * 0.25, _activeAreaAABB.height * 0.25);
	Starling.current.juggler.add(_deactivator);
}

// Called at each frame...
public function update () : void
{
	// Update active area when needed
	_activeAreaAABB.x = ...; // Your complex stuff here
	_activeAreaAABB.y = ...; // Your complex stuff here
	_activeAreaAABB.width = ...; // Your complex stuff here
	_activeAreaAABB.height = ...; // Your complex stuff here

	// IMPORTANT TIP: Update only if AABB has changed!
	_deactivator.updateActiveArea(_activeAreaAABB);
}

public function get deactivator() : SpatialDeactivator
{
	return _deactivator;
}

في GameObject :

 private var _spatialElement : SpatialElement ;

public function MyGameObject(gameManager : MyGameManager)
{
	// Setup game object core components
	_mySprite = ...;
	_myPhysicalBody = ...;

	// IMPORTANT: Make sure that the object starts inactive!
	// The deactivator will take care of activating it right away if needed.
	onSpatialElementActivityChanged(false);

	// Create spatial element
	_spatialElement = new SpatialElement(gameManager.deactivator);
	_spatialElement.activityChangedCallback = onSpatialElementActivityChanged;

	// Initial position update
	updatePosition();
}

// Called during frame update...
public function updatePosition() : void
{
	// Update game object position & size
	x = ...; // Your complex stuff here
	y = ...; // Your complex stuff here
	width = ...; // Your complex stuff here
	height = ...; // Your complex stuff here

	// IMPORTANT TIP: Update only if AABB has changed!
	_spatialElement.updateAABB(x, y, width, height);
}

private function onSpatialElementActivityChanged( active : Boolean ) : void
{
	// Activate / deactivate your object as you want.
	_mySprite.visible = active;
	_myPhysicalBody.enable = active;
	...
}

ملاحظات مهمة:

• يجب أن تبدأ كائنات اللعبة غير نشطة.
• تحديث العناصر المكانية فقط عندما يتغير AABB.

تمكين وضع التصحيح

سيساعدك وضع التصحيح على معرفة ما إذا كنت قد اخترت التكوين الصحيح (انظر الجوانب المهمة أدناه).

يمكنك تمكينها ببساطة مثل هذا:

 _deactivator = new SpatialDeactivator( 32 , 32 , true ) ;

if ( _deactivator . debugSprite)
	addChild ( _deactivator . debugSprite) ; 

⌨ كيفية التثبيت؟

ما عليك سوى استنساخ أو تنزيل المستودع ونسخ/لصق مجلد src/ch في دليل src الخاص بك أو إضافة المجلد src/ إلى مسار الفصل الخاص بك.

جوانب مهمة

1. ابحث عن حجم القطع الصحيحة

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

• ستغطي قطع كبيرة جدًا كائنات اللعبة ، وبالتالي تنشيط الكثير منها في نفس الوقت.
• تتطلب قطع صغيرة جدًا الكثير من القطع معالجة لا شيء.

يمكنك اختبار ومعرفة ما هو الأفضل لك من خلال تمكين وضع التصحيح (انظر القسم).

أنا شخصياً أستخدم نسبة 0.25 مقارنة بحجم المنطقة النشطة.

 new SpatialDeactivator( _activeAreaAABB . width * 0.25 , _activeAreaAABB . height * 0.25 ) ;

2. ابحث عن حجم المنطقة النشطة الصحيح

إذا كانت منطقتك النشطة تتوافق مع عرض الكاميرا ، فقد يكون استخدام الهامش مفيدًا لتنشيط كائنات اللعبة القادمة.

 private var _margin : Number = 20 ;
private var _activeAreaAABB : Rectangle = new Rectangle ( 0 , 0 , 120 + _margin , 80 + _margin ) ;
...
_activeAreaAABB . x = x - _margin * 0.5 ;
_activeAreaAABB . y = y - _margin * 0.5 ;
deactivator . updateActiveArea( _activeAreaAABB ) ;

3. ابحث عن حجم العنصر المكاني الصحيح

يجب أن يغطي حجم العنصر المكاني حجم كائن اللعبة الخاص بك للتأكد من أن كائن اللعبة لا يصبح غير نشط مبكرًا جدًا أو نشطًا مؤخرًا. إذا لزم الأمر ، يمكن أن يكون حجم عناصرك المكانية أكبر قليلاً من حدود كائنات اللعبة أيضًا:

 _spatialElement . updateAABB( x - margin * 0.5 , y - margin * 0.5 , width + margin, height + margin) ;