Data/Attach Methods/Filter

## Filter

### Description

Choose attach points based on a keyword matching with the desired attach point. Can combine with most of all attach methods, as this one is the most important one to have in most cases.

### How to use

At basis, this attach method is similar to direct attachement (attachement query fields on actors). You can select a single attachement point and designate it as the one to be used. The idea about using this is to include/exclude points, it can sort them. Also, you can set more than 1 at the time, thing that direct attachement cannot do.

**Those attachement points can be found in the cutscene module:**

* Open cutscene module from the top bar menu (Shift + F7), find the desired model on the search box found on the left side.
* Or head into the data module and directly open the cutscene editor from the concerned model.

Press A to view attachement points, press Shift + D to open the model data and, collapse the Attachement Points folder. Notice that each attachement can be clicked and will reveal their position on the actual model by varying size (blinking). Words found at the \* part in ["e\_attachRef\_\*\*\*\*\*\*\*\*\*\*\*\*\*]" are the words and numbers are to be used into the Key section here.

* Add another attach method if needed, to modify the result. Example: if this attach method is set to Logic "Or", one can use a Random attach method to make each possible point used as a random set.

## Field Categories

### Attach Type

Selects what type of attachement name we're looking for. Is it the volume, or a point or any (both of them).

* It is best left at "any", as it is rare that this field matters.

### Filter Type

* Absolute: This filter has to return true or it will fail.
* Preference: This filter has to return true, and if it does not, it will select the first availlable attachement point on the model, starting from the top of the list (will take any if combined with a Random Method).

### Keys

The most important field of this attach method: lists the words and their index.

* Key: The case number of the attach point. Think of it as the importance level, 0 being the first to be checked.
* Index: The associated number that can be found with the attachement point's name from the model. Names without numbers are considred as index 0.
* Keyword: The matching name/word of the attachement point from the model.

#### Example use:

* Weapon -1 means that any "Weapon" name will match, whether there are numbers or not.
* Weapon 0 means that ONLY "Weapon" without numbers will match.
* Weapon 1 means that ONLY "Weapon 01" will match
* Weapon 2 means that ONLY "Weapon 02" will match

### Logic

Choose the filtering method. For starters, it is recommanded to use "And," or "Or".

* And: Means that each case in the **Keys,** starting from the top, will have to match their words/numbers togheter. Faillure to match will rend this attach method null.
* Exclusive Or: (Unknown) Yes it is observed to work exactly like the "Or" logic, but no tests has given any result that draws the line of what is different between each both.
* Full Match: Requires the index(es) to match perfectly the same way "And" does (which will be the only one used), in which faillure case, the filter will select the first availlable attachement point on the model, starting from the top of the list. This faillure happened after testing a marine. Testing a marauder ended up using the Fallback location on the launch Attachement Query, so the exact extent use of this Logic is still uncertain.
* Not And: (Unsure) Works like an exclusion system ? This would imply that there's at least another attach method that indicates points to use, for the least.
* Or: Means that each case in the **Keys**, starting from the top, can be used. If this attach method is not combined, then the first matching point will always be used.