رسم الشعاع

*This content is translated using AI (Beta) and may contain errors. To view this page in English, click here.

في أبسط مستوياته، رسم الشعاع هو الفعل الذي يتمثل في إرسال شعاع غير مرئي من نقطة Vector3 في اتجاه محدد مع طول محدد. بمجرد أن يتم إلقاءه، يمكنك كشف ما إذا كان الشعاع يصطدم بـ BasePart أو خلية Terrain.

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

يمكنك رسم شعاع باستخدام طريقة WorldRoot:Raycast() (Workspace:Raycast()) من أصل Vector3 في اتجاه Vector3.

رسم شعاع أساسي
local Workspace = game:GetService("Workspace")

local rayOrigin = Vector3.new(0, 0, 0)
local rayDirection = Vector3.new(0, -100, 0)

local raycastResult = Workspace:Raycast(rayOrigin, rayDirection)

عند رسم شعاع، يجب أن تحتوي معلمة الاتجاه على الطول المرغوب للشعاع. على سبيل المثال، إذا كانت شدة الاتجاه 10، فإن الشعاع الناتج سيكون أيضًا بطول 10. الحد الأقصى للطول هو 15,000 وحدة.

عند الحاجة، يمكنك حساب متجه اتجاه غير معروف (rayDirection) باستخدام الأصل والوجهة المعروفة. هذا مفيد عند رسم شعاع بين نقطتين قد تتغير، مثل من شخصية لاعب إلى أخرى.

يشير الأصل بالإضافة إلى متجه الاتجاه إلى وجهة الشعاع:

$\text{rayOrigin} + \text{rayDirection} = \text{rayDestination}$
اطرح $\text{rayOrigin}$ من كلا الجانبين من المعادلة:

$\text{rayOrigin} + \text{rayDirection} - \text{rayOrigin} = \text{rayDestination} - \text{rayOrigin}$
اتجاه الشعاع يساوي الوجهة مطروحًا منها الأصل:

$\text{rayDirection} = \text{rayDestination} - \text{rayOrigin}$


local Workspace = game:GetService("Workspace")

local rayOrigin = Workspace.TestOrigin.Position
local rayDestination = Workspace.TestDestination.Position

local rayDirection = rayDestination - rayOrigin

local raycastResult = Workspace:Raycast(rayOrigin, rayDirection)

خيارات التصفية

WorldRoot:Raycast() يقبل كائن RaycastParams اختياري الذي يخبر رسم الشعاع بتضمين أو استبعاد أجزاء معينة من BaseParts، تجاهل مادة الماء لـ Terrain، أو استخدام مجموعة التصادم.

المفتاح	الوصف
FilterDescendantsInstances	Array من الكائنات التي يتم استخدامها في تصفية مرشحات رسم الشعاع.
FilterType	تعداد Enum.RaycastFilterType الذي يحدد كيفية استخدام مصفوفة FilterDescendantsInstances في عملية رسم الشعاع. Exclude — يتم اعتبار كل BasePart باستثناء تلك التي هي أبناء كائنات في المصفوفة. Include — يتم اعتبار فقط BaseParts التي هي أبناء كائنات في المصفوفة.
IgnoreWater	Boolean الذي يحدد ما إذا كانت مادة الماء تعتبر عند رسم الشعاع ضد Terrain.
CollisionGroup	اسم سلسلة لـ مجموعة التصادم المستخدمة في عملية رسم الشعاع.

تصفية رسم الشعاع
local Workspace = game:GetService("Workspace")

local rayOrigin = Vector3.zero
local rayDirection = Vector3.new(0, -100, 0)

local raycastParams = RaycastParams.new()
raycastParams.FilterDescendantsInstances = {script.Parent}
raycastParams.FilterType = Enum.RaycastFilterType.Exclude
raycastParams.IgnoreWater = true

local raycastResult = Workspace:Raycast(rayOrigin, rayDirection, raycastParams)

إذا ضربت عملية رسم الشعاع جزءًا مؤهلاً من BasePart أو خلية Terrain، يتم إرجاع كائن RaycastResult يحتوي على النتائج. لاختبار ما إذا كان هناك اصطدام، تأكد من أن النتيجة ليست nil واستخدم الخصائص التالية حسب الحاجة.

الخاصية	الوصف
Instance	الجزء BasePart أو خلية Terrain التي التقيا بها الشعاع.
Position	موضع Vector3 للاصطدام بين الشعاع وInstance.
Distance	المسافة بين أصل الشعاع ونقطة الاصطدام.
Material	المادة Enum.Material لـ BasePart أو Terrain في نقطة الاصطدام.
Normal	المتجه Vector3 للمتجه العمودي للوجه الذي تم الاصطدام به.

عند استخدامه في مكان مع تدفق الكائنات مفعل، قد لا يكون لدى العميل تدفق في BaseParts البعيدة، لذلك قد لا تكشف عملية رسم الشعاع عن الاصطدام. بالإضافة إلى ذلك، فإن "الأكاذيب" المنخفضة التفصيل لـ Terrain و Models التي تم إنشاؤها بواسطة نظام التدفق هي بصرية فقط وليست أهدافًا مؤهلة لرسم الشعاع.

يمكنك استثناء أي BasePart من كشف الاصطدام من خلال تعيين خاصية BasePart.CanQuery الخاصة به إلى false.

كشف الاصطدام لرسم الشعاع
local Workspace = game:GetService("Workspace")

local rayOrigin = Vector3.zero
local rayDirection = Vector3.new(0, -100, 0)

local raycastResult = Workspace:Raycast(rayOrigin, rayDirection)

if raycastResult then
	print("الجزء:", raycastResult.Instance)
	print("الموقع:", raycastResult.Position)
	print("المسافة:", raycastResult.Distance)
	print("المادة:", raycastResult.Material)
	print("العمودي:", raycastResult.Normal)
else
	warn("لا توجد نتيجة لرسم الشعاع!")
end

العربية