OverlapParams
*このコンテンツは、ベータ版のAI(人工知能)を使用して翻訳されており、エラーが含まれている可能性があります。このページを英語で表示するには、 こちら をクリックしてください。
OverlapParams データ型は、特に WorldRoot、WorldRoot:GetPartBoundsInBox()、WorldRoot:GetPartBoundsInRadius() および WorldRoot:GetPartsInPart() で使用するパラメータを保存します。境界クエリ機能。OverlapParams.FilterDescendantsInstances プロパティは、OverlapParams.FilterType 枚数列に基づいて、含まれるまたは除外リストとして使用するオブジェクトのアレイを保存し、OverlapParams.CollisionGroup プロパティは境界クエリ操作の衝突グループを指定できます。
Luau のほとんどのデータタイプとは異なり、新しいオブジェクトを作成せずに OverlapParams のメンバー全員を変更でき、同じオブジェクトを繰り返し再使用できます。
概要
コンストラクタ
- new()
空の OverlapParams オブジェクトを返します。
プロパティ
候補をフィルタリングするために使用されるオブジェクトの配列。
OverlapParams.FilterDescendantsInstances リストの使用方法を決定します。
クエリによって返されるパーツの最大量。
操作に使用される衝突グループ。
境界クエリ操作がパーツの BasePart.CanCollide プロパティ値をその BasePart.CanQuery 値に対して考慮するかどうかを決定します。
有効にすると、クエリはすべてのパーツの衝突プロパティを無視し、すべてのパーツにブルートフォースチェックを実行します。
方法
提供されたインスタンスを FilterDescendantsInstances に追加します。
コンストラクタ
プロパティ
FilterType
提供された OverlapParams.FilterDescendantsInstances 配列の使用方法を決定し、提供された Enum.RaycastFilterType によってデフォルトが決まります。デフォルトは Enum.RaycastFilterType.Exclude です。
CollisionGroup
操作のための衝突グループを指定します。衝突グループに設定されたパーツが しない このグループと衝突するのは無視されます。このプロパティが省略されると、操作は デフォルト 衝突グループを仮定します。
RespectCanCollide
このプロパティは、 であれば、境界クエリ操作が、その境界の交差部分の 値を使用して、その部分が空間クエリ結果の配列に含まれるかどうかを判断するときに、その 値よりも、交差部分の 値を使用するようになります。
BruteForceAllSlow
有効にすると、クエリはすべてのパーツの衝突プロパティを無視し、すべてのパーツにブルートフォースチェックを実行します。これはパフォーマンスに悪影響を及ぼし、ライブエクスペリエンスで使用すべきではありません。
方法
AddToFilter
効率とシンプルさのため、このメソッドはフィルターにインスタンスを追加するのに最適な方法です。パラレルコンテキストから更新できるという追加のメリットがありますFilterDescendantsInstances。