# Add Cutscene Filter

Grammar — Add the filter inFilter to inCutscene.
Flags — Native | Action

Adds a new filter for a cutscene. Any nodes with a non-empty filter property that does not match any filter value will be filtered out of your cutscene.

# Arguments

• int [ preset::Cutscene ] — Cutscene
• string — Filter

Returns — void

native void CutsceneAddFilter(
	int inCutscene,
	string inFilter,
);

# Related

Category: Cutscene / Cutscenes / Filters

• [F] — void — Set Global Cutscene Filter — ( CutsceneSetGlobalFilter )
• [F] — void — Set Cutscene Filter — ( CutsceneSetFilter )
• [F] — void — Add Global Cutscene Filter — ( CutsceneAddGlobalFilter )
• [F] — void — Add Cutscene Filter — ( CutsceneAddFilter )
• [F] — void — Remove Global Cutscene Filter — ( CutsceneRemoveGlobalFilter )
• [F] — void — Remove Cutscene Filter — ( CutsceneRemoveFilter )
• [F] — void — Clear Global Cutscene Filters — ( CutsceneClearGlobalFilters )
• [F] — void — Clear Cutscene Filter — ( CutsceneClearFilters )

# Examples

# campaigns/voidstory.sc2campaign

— VoidCampaignStoryLib.galaxy

// L2409
CutsceneAddFilter(libVCST_gv_pS_RoomUICutscene, "DTLeaderSpecial")

// L2412
CutsceneAddFilter(libVCST_gv_pS_RoomUICutscene, libVCST_gf_PS_ClickableSceneNameToken(lv_indexClickable))

// L2605
CutsceneAddFilter(libVCST_gv_pS_ActiveBackground, "UIView")

// L2619
CutsceneAddFilter(libVCST_gv_pS_ActiveBackground, "ConversationView")

# campaigns/voidstory.sc2campaign

— VoidCampaignUILib.galaxy

// L836
CutsceneAddFilter(libVCUI_gv_pU_ArmyCutscene, "Noselect")

// L903
CutsceneAddFilter(libVCUI_gv_pU_ArmyCutscene, libVoiC_gf_PC_ArmyCategoryCutsceneFilter(libVCUI_gv_pU_ArmyCategories[libVCUI_gv_pU_ArmyCategorySelectedIndex]))

// L904
CutsceneAddFilter(libVCUI_gv_pU_ArmyCutscene, "Noselect")

// L911
CutsceneAddFilter(libVCUI_gv_pU_ArmyCutscene, libVoiC_gf_PC_ArmyUnitCutsceneFilter(libVCUI_gv_pU_ArmyUnits[libVCUI_gv_pU_ArmyCategorySelectedIndex][libVCUI_gv_pU_ArmyUnitSelectedIndex[libVCUI_gv_pU_ArmyCategorySelectedIndex]]))

// L912
CutsceneAddFilter(libVCUI_gv_pU_ArmyCutscene, libVoiC_gf_PC_ArmyCategoryCutsceneFilter(libVCUI_gv_pU_ArmyCategories[libVCUI_gv_pU_ArmyCategorySelectedIndex]))

// L1797
CutsceneAddFilter(libVCUI_gv_pU_MissionCutscene, "Vorazun")

// L1800
CutsceneAddFilter(libVCUI_gv_pU_MissionCutscene, "Karax")

// L1803
CutsceneAddFilter(libVCUI_gv_pU_MissionCutscene, "Artanis")

// L1806
CutsceneAddFilter(libVCUI_gv_pU_MissionCutscene, libVCUI_gf_PU_MissionUIFilter(lp_mission))

// L2890
CutsceneAddFilter(libVCUI_gv_pU_StarmapCutscene, ("Starmap" + libVoiC_gf_PC_LocationCutsceneFilter(libVCUI_gv_pU_StarmapLocations[1])))

# mods/heroesdata.stormmod

— MapMechanicsLib.galaxy

// L2309
CutsceneAddFilter(CutsceneLastCreated(), lp_filter)

# mods/missionpacks/novacampaign.sc2mod

— LibNCST.galaxy

// L2082
CutsceneAddFilter(libNCST_gv_nS_RoomUICutscene, libNCST_gf_NS_ClickableSceneNameToken(lv_indexClickable))

// L2242
CutsceneAddFilter(libNCST_gv_NS_ActiveBackground, "UIView")

// L2255
CutsceneAddFilter(libNCST_gv_NS_ActiveBackground, "ConversationView")

# mods/starcoop/starcoop.sc2mod

— LibCOUI.galaxy

// L4838
CutsceneAddFilter(CutsceneGetTriggerControl(libCOUI_gv_cU_GPCutscene[lp_player]), libCOUI_gv_cU_GPCutsceneFilter[lp_player])