# Add Global Cutscene Filter

Grammar — Add the global cutscene filter inFilter.
Flags — Native | Action

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

# Arguments

string — Filter

Returns — void

native void CutsceneAddGlobalFilter(string inFilter);

Category: Cutscene / Cutscenes / Filters

Set Global Cutscene Filter — void — CutsceneSetGlobalFilter
Set Cutscene Filter — void — CutsceneSetFilter
Add Global Cutscene Filter — void — CutsceneAddGlobalFilter
Add Cutscene Filter — void — CutsceneAddFilter
Remove Global Cutscene Filter — void — CutsceneRemoveGlobalFilter
Remove Cutscene Filter — void — CutsceneRemoveFilter
Clear Global Cutscene Filters — void — CutsceneClearGlobalFilters
Clear Cutscene Filter — void — CutsceneClearFilters

# Examples

campaigns/swarm.sc2campaign — base.sc2maps/maps/campaign/swarm/zstorychar.sc2map/MapScript.galaxy:690

    lib281DEC45_gf_ChangeRoom(lib281DEC45_ge_Rooms_StoryRoomVoid);
    if ((libSwaC_gf_MissionStatusCheck("ZExpedition3", libSwaC_ge_MissionStatus_Completed) == false)) {
        CutsceneAddGlobalFilter("Zeratul");
    }
    else {

campaigns/swarm.sc2campaign — base.sc2maps/maps/campaign/swarm/zstoryexpedition.sc2map/MapScript.galaxy:696

    lib281DEC45_gf_ChangeRoom(lib281DEC45_ge_Rooms_StoryRoomVoid);
    if ((libSwaC_gf_MissionStatusCheck("ZChar3", libSwaC_ge_MissionStatus_Completed) == false)) {
        CutsceneAddGlobalFilter("Zeratul");
    }
    else {

campaigns/swarm.sc2campaign/base.sc2maps/maps/campaign/swarm/zstorychar.sc2map — MapScript.galaxy:690

    lib281DEC45_gf_ChangeRoom(lib281DEC45_ge_Rooms_StoryRoomVoid);
    if ((libSwaC_gf_MissionStatusCheck("ZExpedition3", libSwaC_ge_MissionStatus_Completed) == false)) {
        CutsceneAddGlobalFilter("Zeratul");
    }
    else {

campaigns/swarm.sc2campaign/base.sc2maps/maps/campaign/swarm/zstoryexpedition.sc2map — MapScript.galaxy:696

    lib281DEC45_gf_ChangeRoom(lib281DEC45_ge_Rooms_StoryRoomVoid);
    if ((libSwaC_gf_MissionStatusCheck("ZChar3", libSwaC_ge_MissionStatus_Completed) == false)) {
        CutsceneAddGlobalFilter("Zeratul");
    }
    else {

campaigns/swarmstoryutil.sc2mod — base.sc2data/Lib281DEC45.galaxy:372

    // Implementation
    if ((libSwaC_gf_MissionStatusCheck("ZZerus2", libSwaC_ge_MissionStatus_Completed) == true)) {
        CutsceneAddGlobalFilter("Primal");
    }
    else {

campaigns/swarmstoryutil.sc2mod — base.sc2data/Lib281DEC45.galaxy:375

    }
    else {
        CutsceneAddGlobalFilter("Ghost");
    }
    if (((libSwaC_gf_MissionStatusCheck("ZChar1", libSwaC_ge_MissionStatus_Completed) == true) || (libSwaC_gf_MissionStatusCheck("ZExpedition1", libSwaC_ge_MissionStatus_Completed) == true))) {

campaigns/void.sc2campaign — base.sc2maps/maps/campaign/void/pkorhal01.sc2map/MapScript.galaxy:5560

    SoundtrackPause(PlayerGroupAll(), c_soundtrackCategoryMusic, true, true);
    SoundChannelMute(PlayerGroupAll(), c_soundCategoryDoodad, true);
    CutsceneAddGlobalFilter("Korhal");
    libVoiC_gf_CampaignPlayCutscene2(lv_cutsceneFile, true, true);
    CutsceneRemoveGlobalFilter("Korhal");

campaigns/void.sc2campaign — base.sc2maps/maps/campaign/void/pshakuras01.sc2map/MapScript.galaxy:6248

    libNtve_gf_StoryMode(PlayerGroupAll(), true);
    SoundtrackPause(PlayerGroupAll(), c_soundtrackCategoryAmbience, true, true);
    CutsceneAddGlobalFilter("Shakuras");
    libVoiC_gf_CampaignPlayCutscene2("Cutscenes\\Mission_SoACalldown_OrbitalStrike.SC2Cutscene", true, true);
    CutsceneRemoveGlobalFilter("Shakuras");

campaigns/void.sc2campaign — base.sc2maps/maps/campaign/void/pstory01.sc2map/MapScript.galaxy:552


    if ((libVoiC_gf_LastSuccessfulMission() == "PUlnar02")) {
        CutsceneAddGlobalFilter("Ulnar02");
    }
    else {

campaigns/void.sc2campaign — base.sc2maps/maps/campaign/void/pstory01.sc2map/MapScript.galaxy:555

    }
    else {
        CutsceneAddGlobalFilter("Std");
    }
    libVCST_gf_RegisterRoom(libVCST_ge_Rooms_StoryRoomVoid, gt_RoomPrepareVoid, gt_RoomViewVoid, gt_RoomViewStopVoid, null, null);

campaigns/void.sc2campaign — base.sc2maps/maps/campaign/void/pstory01.sc2map/MapScript.galaxy:1016

        libVCST_gf_ShowHideUnitAbs(false, gv_uNITWarCouncilSet02);
        CutsceneRemoveGlobalFilter("Capsule");
        CutsceneAddGlobalFilter("CapsuleOff");
        libVCST_gf_StorySetUnitLocation(libVCST_gf_ClickableUnit("Preserver"), UnitGetAttachmentPoint(gv_uNITWarCouncilSet00, "Pos_Firebat"));
    }

campaigns/void.sc2campaign — base.sc2maps/maps/campaign/void/pstory01.sc2map/MapScript.galaxy:1022

        libVCST_gf_ShowHideUnitAbs(true, gv_uNITWarCouncilSet02);
        CutsceneRemoveGlobalFilter("CapsuleOff");
        CutsceneAddGlobalFilter("Capsule");
        if ((libVoiC_gf_MissionStatusCheck("PUlnar03", libVoiC_ge_MissionStatus_Available) == true)) {
            libVCST_gf_StorySetUnitLocation(libVCST_gf_ClickableUnit("AmonPreserver"), UnitGetAttachmentPoint(gv_uNITWarCouncilSet00, "Pos_EvolutionMaster"));

campaigns/void.sc2campaign — base.sc2maps/maps/campaign/void/pstory01.sc2map/MapScript.galaxy:1130

        CutsceneRemoveGlobalFilter("CoreStage1");
        CutsceneRemoveGlobalFilter("CoreStage2");
        CutsceneAddGlobalFilter("CoreStage3");
    }
    else if ((libVoiC_gf_MissionStatusCheck("PUlnar02", libVoiC_ge_MissionStatus_Completed) == true)) {

campaigns/void.sc2campaign — base.sc2maps/maps/campaign/void/pstory01.sc2map/MapScript.galaxy:1136

        CutsceneRemoveGlobalFilter("CoreStage1");
        CutsceneRemoveGlobalFilter("CoreStage3");
        CutsceneAddGlobalFilter("CoreStage2");
    }
    else if (true) {

campaigns/void.sc2campaign — base.sc2maps/maps/campaign/void/pstory01.sc2map/MapScript.galaxy:1142

        CutsceneRemoveGlobalFilter("CoreStage2");
        CutsceneRemoveGlobalFilter("CoreStage3");
        CutsceneAddGlobalFilter("CoreStage1");
    }
    return true;

campaigns/void.sc2campaign — base.sc2maps/maps/campaign/void/pstory01.sc2map/MapScript.galaxy:1650

        gv_pylonClicks += 1;
        gv_pylonActivated = true;
        CutsceneAddGlobalFilter("Pylon");
        if ((gv_pylonClicks > 1) && (RandomInt(gv_pylonClicks, 20) == 20)) {
            gv_pylonClicks = 1;

campaigns/void.sc2campaign — base.sc2maps/maps/campaign/void/pstory01.sc2map/MapScript.galaxy:1653

        if ((gv_pylonClicks > 1) && (RandomInt(gv_pylonClicks, 20) == 20)) {
            gv_pylonClicks = 1;
            CutsceneAddGlobalFilter("Special");
            SoundPlayForPlayer(SoundLink("VoidSMPylonActivate2", -1), c_maxPlayers, PlayerGroupAll(), 100.0, 0.0);
            TextExpressionSetToken("Param/Expression/35E7C92D", "A", ConversationDataStateText("StoryModeText|SpecialText2", "Description"));

campaigns/void.sc2campaign — base.sc2maps/maps/campaign/void/pstory01.sc2map/MapScript.galaxy:2740

    libVCST_gf_ChangeRoom(libVCST_ge_Rooms_StoryRoomVoid);
    if ((libVoiC_gf_MissionStatusCheck("PKorhal02", libVoiC_ge_MissionStatus_Completed) == true)) {
        CutsceneAddGlobalFilter("Capsule");
    }
    else {

campaigns/void.sc2campaign/base.sc2maps/maps/campaign/void/pkorhal01.sc2map — MapScript.galaxy:5560

    SoundtrackPause(PlayerGroupAll(), c_soundtrackCategoryMusic, true, true);
    SoundChannelMute(PlayerGroupAll(), c_soundCategoryDoodad, true);
    CutsceneAddGlobalFilter("Korhal");
    libVoiC_gf_CampaignPlayCutscene2(lv_cutsceneFile, true, true);
    CutsceneRemoveGlobalFilter("Korhal");

campaigns/void.sc2campaign/base.sc2maps/maps/campaign/void/pshakuras01.sc2map — MapScript.galaxy:6248

    libNtve_gf_StoryMode(PlayerGroupAll(), true);
    SoundtrackPause(PlayerGroupAll(), c_soundtrackCategoryAmbience, true, true);
    CutsceneAddGlobalFilter("Shakuras");
    libVoiC_gf_CampaignPlayCutscene2("Cutscenes\\Mission_SoACalldown_OrbitalStrike.SC2Cutscene", true, true);
    CutsceneRemoveGlobalFilter("Shakuras");

campaigns/void.sc2campaign/base.sc2maps/maps/campaign/void/pstory01.sc2map — MapScript.galaxy:552


    if ((libVoiC_gf_LastSuccessfulMission() == "PUlnar02")) {
        CutsceneAddGlobalFilter("Ulnar02");
    }
    else {

campaigns/void.sc2campaign/base.sc2maps/maps/campaign/void/pstory01.sc2map — MapScript.galaxy:555

    }
    else {
        CutsceneAddGlobalFilter("Std");
    }
    libVCST_gf_RegisterRoom(libVCST_ge_Rooms_StoryRoomVoid, gt_RoomPrepareVoid, gt_RoomViewVoid, gt_RoomViewStopVoid, null, null);

campaigns/void.sc2campaign/base.sc2maps/maps/campaign/void/pstory01.sc2map — MapScript.galaxy:1016

        libVCST_gf_ShowHideUnitAbs(false, gv_uNITWarCouncilSet02);
        CutsceneRemoveGlobalFilter("Capsule");
        CutsceneAddGlobalFilter("CapsuleOff");
        libVCST_gf_StorySetUnitLocation(libVCST_gf_ClickableUnit("Preserver"), UnitGetAttachmentPoint(gv_uNITWarCouncilSet00, "Pos_Firebat"));
    }

campaigns/void.sc2campaign/base.sc2maps/maps/campaign/void/pstory01.sc2map — MapScript.galaxy:1022

        libVCST_gf_ShowHideUnitAbs(true, gv_uNITWarCouncilSet02);
        CutsceneRemoveGlobalFilter("CapsuleOff");
        CutsceneAddGlobalFilter("Capsule");
        if ((libVoiC_gf_MissionStatusCheck("PUlnar03", libVoiC_ge_MissionStatus_Available) == true)) {
            libVCST_gf_StorySetUnitLocation(libVCST_gf_ClickableUnit("AmonPreserver"), UnitGetAttachmentPoint(gv_uNITWarCouncilSet00, "Pos_EvolutionMaster"));

campaigns/void.sc2campaign/base.sc2maps/maps/campaign/void/pstory01.sc2map — MapScript.galaxy:1130

        CutsceneRemoveGlobalFilter("CoreStage1");
        CutsceneRemoveGlobalFilter("CoreStage2");
        CutsceneAddGlobalFilter("CoreStage3");
    }
    else if ((libVoiC_gf_MissionStatusCheck("PUlnar02", libVoiC_ge_MissionStatus_Completed) == true)) {

campaigns/void.sc2campaign/base.sc2maps/maps/campaign/void/pstory01.sc2map — MapScript.galaxy:1136

        CutsceneRemoveGlobalFilter("CoreStage1");
        CutsceneRemoveGlobalFilter("CoreStage3");
        CutsceneAddGlobalFilter("CoreStage2");
    }
    else if (true) {

campaigns/void.sc2campaign/base.sc2maps/maps/campaign/void/pstory01.sc2map — MapScript.galaxy:1142

        CutsceneRemoveGlobalFilter("CoreStage2");
        CutsceneRemoveGlobalFilter("CoreStage3");
        CutsceneAddGlobalFilter("CoreStage1");
    }
    return true;

campaigns/void.sc2campaign/base.sc2maps/maps/campaign/void/pstory01.sc2map — MapScript.galaxy:1650

        gv_pylonClicks += 1;
        gv_pylonActivated = true;
        CutsceneAddGlobalFilter("Pylon");
        if ((gv_pylonClicks > 1) && (RandomInt(gv_pylonClicks, 20) == 20)) {
            gv_pylonClicks = 1;

campaigns/void.sc2campaign/base.sc2maps/maps/campaign/void/pstory01.sc2map — MapScript.galaxy:1653

        if ((gv_pylonClicks > 1) && (RandomInt(gv_pylonClicks, 20) == 20)) {
            gv_pylonClicks = 1;
            CutsceneAddGlobalFilter("Special");
            SoundPlayForPlayer(SoundLink("VoidSMPylonActivate2", -1), c_maxPlayers, PlayerGroupAll(), 100.0, 0.0);
            TextExpressionSetToken("Param/Expression/35E7C92D", "A", ConversationDataStateText("StoryModeText|SpecialText2", "Description"));

campaigns/void.sc2campaign/base.sc2maps/maps/campaign/void/pstory01.sc2map — MapScript.galaxy:2740

    libVCST_gf_ChangeRoom(libVCST_ge_Rooms_StoryRoomVoid);
    if ((libVoiC_gf_MissionStatusCheck("PKorhal02", libVoiC_ge_MissionStatus_Completed) == true)) {
        CutsceneAddGlobalFilter("Capsule");
    }
    else {

campaigns/voidstory.sc2campaign — base.sc2data/TriggerLibs/VoidCampaignMissionLib.galaxy:1955

    else {
    }
    CutsceneAddGlobalFilter(lv_locationFilter);
    libVoiC_gf_CampaignPlayCutscene2(lv_spaceScene, true, true);
    CutsceneRemoveGlobalFilter(lv_locationFilter);

campaigns/voidstory.sc2campaign — base.sc2data/TriggerLibs/VoidCampaignStoryLib.galaxy:646

    SoundtrackPause(PlayerGroupAll(), c_soundtrackCategoryMusic, true, false);
    if ((libVoiC_gf_PC_LocationCutsceneFilter(libVoiC_gf_CurrentLocation()) != null) && (libVCST_gf_PS_CampaignCompleted() == false)) {
        CutsceneAddGlobalFilter(libVoiC_gf_PC_LocationCutsceneFilter(libVoiC_gf_CurrentLocation()));
    }

campaigns/voidstory.sc2campaign — base.sc2data/TriggerLibs/VoidCampaignStoryLib.galaxy:1394

    }
    if ((libVoiC_gf_PC_LocationCutsceneFilter(lp_newLocation) != null)) {
        CutsceneAddGlobalFilter(libVoiC_gf_PC_LocationCutsceneFilter(lp_newLocation));
    }

campaigns/voidstory.sc2campaign — base.sc2data/TriggerLibs/VoidCampaignStoryLib.galaxy:1443

        auto44D60EBD_ai = auto44D60EBD_ai + 1;
    }
    CutsceneAddGlobalFilter(("Episode" + IntToString(lv_episodeNumber)));
}

mods/missionpacks/novacampaign.sc2mod — base.sc2data/LibNCST.galaxy:1274

    }
    if ((libNovC_gf_NC_LocationCutsceneFilter(lp_newLocation) != null)) {
        CutsceneAddGlobalFilter(libNovC_gf_NC_LocationCutsceneFilter(lp_newLocation));
    }

# Add Global Cutscene Filter

# Arguments

# Related

# Examples