OverlapParams

非推奨を表示

*このコンテンツは、ベータ版のAI(人工知能)を使用して翻訳されており、エラーが含まれている可能性があります。このページを英語で表示するには、 こちら をクリックしてください。

OverlapParams データ型は、特に WorldRootWorldRoot:GetPartBoundsInBox()WorldRoot:GetPartBoundsInRadius() および WorldRoot:GetPartsInPart() で使用するパラメータを保存します。境界クエリ機能。OverlapParams.FilterDescendantsInstances プロパティは、OverlapParams.FilterType 枚数列に基づいて、含まれるまたは除外リストとして使用するオブジェクトのアレイを保存し、OverlapParams.CollisionGroup プロパティは境界クエリ操作の衝突グループを指定できます。

Luau のほとんどのデータタイプとは異なり、新しいオブジェクトを作成せずに OverlapParams のメンバー全員を変更でき、同じオブジェクトを繰り返し再使用できます。

概要

コンストラクタ

プロパティ

方法

コンストラクタ

new

空の OverlapParams オブジェクトを返します。他のデータタイプのコンストラクターとは異なり、このコンストラクターにはパラメータがないので、適切にプロパティを設定する必要があります。

プロパティ

FilterDescendantsInstances

候補をフィルタリングするために使用されるオブジェクトの配列。

提供された OverlapParams.FilterDescendantsInstances 配列の使用方法を決定し、提供された Enum.RaycastFilterType によってデフォルトが決まります。デフォルトは Enum.RaycastFilterType.Exclude です。

MaxParts

クエリによって返されるパーツの最大量。デフォルト値のゼロ(0)は制限を表しません。

CollisionGroup

操作のための衝突グループを指定します。衝突グループに設定されたパーツが しない このグループと衝突するのは無視されます。このプロパティが省略されると、操作は デフォルト 衝突グループを仮定します。

RespectCanCollide

このプロパティは、 であれば、境界クエリ操作が、その境界の交差部分の 値を使用して、その部分が空間クエリ結果の配列に含まれるかどうかを判断するときに、その 値よりも、交差部分の 値を使用するようになります。

BruteForceAllSlow

有効にすると、クエリはすべてのパーツの衝突プロパティを無視し、すべてのパーツにブルートフォースチェックを実行します。これはパフォーマンスに悪影響を及ぼし、ライブエクスペリエンスで使用すべきではありません。

方法

AddToFilter

()
並列書き込み

効率とシンプルさのため、このメソッドはフィルターにインスタンスを追加するのに最適な方法です。パラレルコンテキストから更新できるという追加のメリットがありますFilterDescendantsInstances

パラメータ

instances: Instance | Array

追加するインスタンスまたは配列を含むインスタンスまたは配列。

戻り値

()