# Wait For Cutscene To End

Grammar — Wait for cutscene cutsceneId to complete.
Flags — Native | Action

Pauses a trigger until the specified cutscene has completed.

# Arguments

int<preset::Cutscene> — Cutscene

Returns — void

native void WaitForCutsceneToEnd(int inCutscene);

Category: Cutscene / Cutscenes

Create Cutscene — int<preset::Cutscene> — CutsceneCreateNoPosition
Create Cutscene at Position — int<preset::Cutscene> — CutsceneCreateNew
Go To Next Cutscene Bookmark — void — CutsceneGoToNextBookmark
Cutscene EndScene Fired — void — TriggerAddEventCutsceneEndSceneFired
Create Cutscene — int<preset::Cutscene> — CutsceneCreate
Last Created Cutscene — int<preset::Cutscene> — CutsceneLastCreated
Play Cutscene — void — CutscenePlay
Pause Cutscene — void — CutscenePause
Stop Cutscene — void — CutsceneStop
Set Cutscene Time — void — CutsceneSetTime
Go To Cutscene Bookmark — void — CutsceneGoToBookmark
Show/Hide Cutscene — void — CutsceneShow
Play Cutscene Range Over Time — void — CutscenePlayCutsceneRangeOverTime
Cutscene Fade — void — CutsceneFade
Dialog Item Cutscene — int<preset::Cutscene> — CutsceneGetTriggerControl
Cutscene Bookmark Fired — void — TriggerAddEventCutsceneBookmarkFired
Triggering Cutscene — int<preset::Cutscene> — EventCutsceneId
Triggering Cutscene Bookmark — string — EventCutsceneBookmark
Wait For Cutscene To End — void — WaitForCutsceneToEnd

# Examples

campaigns/swarm.sc2campaign — base.sc2maps/maps/campaign/swarm/zspace01.sc2map/MapScript.galaxy:6921

    CinematicFade(true, 2.0, c_fadeStyleNormal, Color(0.00, 0.00, 0.00), 0.0, false);
    libSwaC_gf_CampaignPlayCutscene("Cutscenes\\ZMissionSpace01Victory.SC2Cutscene", Point(30.0, 100.0), false, true);
    WaitForCutsceneToEnd(CutsceneLastCreated());
    libNtve_gf_StoryMode(PlayerGroupAll(), false);
    gv_cinematicCompleted = true;

campaigns/swarm.sc2campaign/base.sc2maps/maps/campaign/swarm/zspace01.sc2map — MapScript.galaxy:6921

    CinematicFade(true, 2.0, c_fadeStyleNormal, Color(0.00, 0.00, 0.00), 0.0, false);
    libSwaC_gf_CampaignPlayCutscene("Cutscenes\\ZMissionSpace01Victory.SC2Cutscene", Point(30.0, 100.0), false, true);
    WaitForCutsceneToEnd(CutsceneLastCreated());
    libNtve_gf_StoryMode(PlayerGroupAll(), false);
    gv_cinematicCompleted = true;

campaigns/swarmstory.sc2campaign — base.sc2data/TriggerLibs/SwarmCampaignLib.galaxy:19857

    }

    WaitForCutsceneToEnd(libSwaC_gv_zS_CurrentCampaignCutscene);
    return true;
}

campaigns/swarmstory.sc2campaign — base.sc2data/TriggerLibs/SwarmCampaignLib.galaxy:19880

    }

    WaitForCutsceneToEnd(libSwaC_gv_zS_CurrentCampaignCutscene);
    return true;
}

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

    lib281DEC45_gv_zSS_Cutscene = CutsceneLastCreated();
    TriggerExecute(lib281DEC45_gt_ZSS_CutsceneDetectSkipping, true, false);
    WaitForCutsceneToEnd(lib281DEC45_gv_zSS_Cutscene);
    lib281DEC45_gf_StoryCutsceneFade(true, 0.0, false);
    TriggerStop(lib281DEC45_gt_ZSS_CutsceneDetectSkipping);

campaigns/void.sc2campaign — base.sc2maps/maps/campaign/sc2tutorial.sc2map/MapScript.galaxy:9577

    Wait(3.0, c_timeGame);
    libVCMI_gf_SendTransmissionCampaign(null, "Tutorial_SC2Core|Line00045", c_transmissionDurationAdd, 0.0, true, libVCMI_ge_MissionTransmissionPortraitOptioins_HidePortraitAfter, libVCMI_ge_MissionTransmissionCueSoundOptions_DefaultCueSoundBehavior);
    WaitForCutsceneToEnd(CutsceneLastCreated());
    gv_cinematicCompleted2 = true;
    return true;

campaigns/void.sc2campaign — base.sc2maps/maps/campaign/sc2tutorial.sc2map/MapScript.galaxy:19223

    UnitIssueOrder(gv_protossWarpPrism, OrderTargetingPoint(AbilityCommand("move", 0), PointFromId(67)), c_orderQueueReplace);
    UnitIssueOrder(gv_protossWarpPrism, Order(AbilityCommand("PhasingMode", 0)), c_orderQueueAddToEnd);
    WaitForCutsceneToEnd(CutsceneLastCreated());
    FogSetEnabled(true);
    GameSetLighting("AiurTempleJungle", 0.0);

campaigns/void.sc2campaign — base.sc2maps/maps/campaign/sc2tutorial.sc2map/MapScript.galaxy:19435

    FogSetEnabled(false);
    CutsceneCreateNoPosition("Cutscenes\\Cutscene_TutorialProtossOutro.SC2Cutscene", PlayerGroupAll(), true);
    WaitForCutsceneToEnd(CutsceneLastCreated());
    FogSetEnabled(true);
    GameSetLighting("AiurTempleJungle", 0.0);

campaigns/void.sc2campaign/base.sc2maps/maps/campaign/sc2tutorial.sc2map — MapScript.galaxy:9577

    Wait(3.0, c_timeGame);
    libVCMI_gf_SendTransmissionCampaign(null, "Tutorial_SC2Core|Line00045", c_transmissionDurationAdd, 0.0, true, libVCMI_ge_MissionTransmissionPortraitOptioins_HidePortraitAfter, libVCMI_ge_MissionTransmissionCueSoundOptions_DefaultCueSoundBehavior);
    WaitForCutsceneToEnd(CutsceneLastCreated());
    gv_cinematicCompleted2 = true;
    return true;

campaigns/void.sc2campaign/base.sc2maps/maps/campaign/sc2tutorial.sc2map — MapScript.galaxy:19223

    UnitIssueOrder(gv_protossWarpPrism, OrderTargetingPoint(AbilityCommand("move", 0), PointFromId(67)), c_orderQueueReplace);
    UnitIssueOrder(gv_protossWarpPrism, Order(AbilityCommand("PhasingMode", 0)), c_orderQueueAddToEnd);
    WaitForCutsceneToEnd(CutsceneLastCreated());
    FogSetEnabled(true);
    GameSetLighting("AiurTempleJungle", 0.0);

campaigns/void.sc2campaign/base.sc2maps/maps/campaign/sc2tutorial.sc2map — MapScript.galaxy:19435

    FogSetEnabled(false);
    CutsceneCreateNoPosition("Cutscenes\\Cutscene_TutorialProtossOutro.SC2Cutscene", PlayerGroupAll(), true);
    WaitForCutsceneToEnd(CutsceneLastCreated());
    FogSetEnabled(true);
    GameSetLighting("AiurTempleJungle", 0.0);

campaigns/voidstory.sc2campaign — base.sc2data/TriggerLibs/VoidCampaignLib.galaxy:10394

    }

    WaitForCutsceneToEnd(libVoiC_gv_pC_CurrentCampaignCutscene);
    libVoiC_gf_PC_StatEventAddInt("Completed", 1, libVoiC_gv_pC_SceneStatEvent);
    DialogDestroy(libVoiC_gv_pC_CampaignCutsceneDialog);

campaigns/voidstory.sc2campaign — base.sc2data/TriggerLibs/VoidCampaignLib.galaxy:10419

    }

    WaitForCutsceneToEnd(libVoiC_gv_pC_CurrentCampaignCutscene);
    return true;
}

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

    libVCST_gv_pS_Cutscene = CutsceneLastCreated();
    TriggerExecute(libVCST_gt_PS_CutsceneDetectSkipping, true, false);
    WaitForCutsceneToEnd(libVCST_gv_pS_Cutscene);
    libVCST_gf_StoryCutsceneFade(true, 0.0, false);
    TriggerStop(libVCST_gt_PS_CutsceneDetectSkipping);

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

    lv_selectedDifficulty = libVCUI_gf_PU_MissionSelectedDifficulty();
    CutsceneGoToBookmark(libVCUI_gv_pU_MissionCutscene, "Aiur05");
    WaitForCutsceneToEnd(libVCUI_gv_pU_MissionCutscene);
    libVoiC_gf_DispatchCampaignEvent(libVoiC_ge_PC_Event_StoryMissionLaunch, "", "", true);
    libVCST_gf_EnterRoom(libVCST_ge_Rooms_StoryRoomVoid);

mods/heroesdata.stormmod — base.stormdata/TriggerLibs/MapMechanicsLib.galaxy:5790

    TriggerSkippableBegin(libCore_gv_playerGroupFromPlayer[lv_player], 0, null, true, false);
    libMapM_gv_mMIntroCutsceneCompleted[lv_player] = false;
    WaitForCutsceneToEnd(lv_cutscene);
    libMapM_gv_mMIntroCutsceneCompleted[lv_player] = true;
    return true;

mods/missionpacks/campaigncommon.sc2mod — base.sc2data/LibComC.galaxy:4507

    }

    WaitForCutsceneToEnd(libComC_gv_cC_CutsceneCurrent);
    DialogDestroy(libComC_gv_cC_CutsceneDialog);
    return true;

mods/missionpacks/campaigncommon.sc2mod — base.sc2data/LibComC.galaxy:4530

    }

    WaitForCutsceneToEnd(libComC_gv_cC_CutsceneCurrent);
    return true;
}

mods/missionpacks/novacampaign.sc2mod — base.sc2data/LibNCMI.galaxy:1899

    libComC_gf_CampaignPlayCutscene("Cutscenes\\SMX3_Cutscene_MP03_040.SC2Cutscene", Point(64.0, 64.0), false, true);
    libNCMI_gv_nM_CreditsCutscene = CutsceneLastCreated();
    WaitForCutsceneToEnd(libNCMI_gv_nM_CreditsCutscene);
    ActorSend(libNCMI_gv_nM_CreditsCutsceneNewsScreen, libNtve_gf_TextureVideoStopAll());
    libNtve_gf_KillModel(libNCMI_gv_nM_CreditsCutsceneNewsScreen);

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

    libNCST_gv_nS_Cutscene = CutsceneLastCreated();
    TriggerExecute(libNCST_gt_NS_CutsceneDetectSkipping, true, false);
    WaitForCutsceneToEnd(libNCST_gv_nS_Cutscene);
    libNCST_gf_StoryCutsceneFade(true, 0.0, false);
    TriggerStop(libNCST_gt_NS_CutsceneDetectSkipping);

mods/voidprologue.sc2mod — base.sc2data/LibA3DDD02B.galaxy:8919

    }

    WaitForCutsceneToEnd(libA3DDD02B_gv_pP_CurrentCampaignCutscene);
    return true;
}

mods/voidprologue.sc2mod — base.sc2data/LibA3DDD02B.galaxy:8942

    }

    WaitForCutsceneToEnd(libA3DDD02B_gv_pP_CurrentCampaignCutscene);
    return true;
}

# Wait For Cutscene To End

# Arguments

# Related

# Examples