# Set Dialog Item Movie

Grammar — Set dialogItem Movie to movie for players
Flags — Action

Sets a Dialog Item to play the specified Movie. Passing in an empty or invalid movie will cause the currently playing movie to stop.

# Arguments

• int<control> — Dialog Item
• string<filepath> — Movie
• playergroup — Players

Returns — void

void libNtve_gf_SetDialogItemMovie(
	int lp_dialogItem,
	string lp_movie,
	playergroup lp_players,
);

# Related

Category: Dialog / Dialog Item Tools

• Dialog Item Send Animation Event 2 — void — DialogControlSetAnimationState
• Position Subtitle to Dialog Item — void — DialogSetSubtitlePositionOverrideControl
• Clear Subtitle Position Dialog Item — void — DialogClearSubtitlePositionOverrideControl
• Destroy All Dialog Items — void — DialogControlDestroyAll
• Dialog Containing Dialog Item — int<dialog> — DialogControlGetDialog
• Dialog Item Type — int<preset::ControlType> — DialogControlGetType
• Set Dialog Item Color — void — libNtve_gf_SetDialogItemColor
• Set Dialog Item Style — void — libNtve_gf_SetDialogItemStyle
• Set Dialog Item Text Writeout — void — libNtve_gf_SetDialogItemTextWriteout
• Set Dialog Item Text Writeout Duration — void — libNtve_gf_SetDialogItemTextWriteoutDuration
• Set Dialog Item Tooltip — void — libNtve_gf_SetDialogItemTooltip
• Dialog Item Color — color — libNtve_gf_DialogItemColor
• Dialog Item Style — string<fontstyle> — libNtve_gf_DialogItemStyle
• Dialog Item Tooltip — text — libNtve_gf_DialogItemTooltip
• Destroy Dialog Item — void — DialogControlDestroy
• Set Dialog Item Image — void — libNtve_gf_SetDialogItemImage
• Set Dialog Item Hover Image — void — libNtve_gf_SetDialogItemImage2
• Set Dialog Item Image Type — void — libNtve_gf_SetDialogItemImageType
• Set Dialog Item Blend Mode — void — libNtve_gf_SetDialogItemBlendMode
• Set Dialog Item Tiled — void — libNtve_gf_SetDialogItemImageType2
• Set Dialog Background — void — DialogSetImage
• Dialog Item Image — string — libNtve_gf_DialogItemImage
• Dialog Item Image Type — int<preset::ImageType> — libNtve_gf_DialogItemImageType
• Fade Dialog Item Transparency — void — DialogControlFadeTransparency
• Set Dialog Item Flash — void — libNtve_gf_SetDialogItemFlash
• Set Dialog Item Cutscene — void — libNtve_gf_SetDialogItemCutscene
• Dialog Item Invoke As Text — void — DialogControlInvokeAsText
• Dialog Item Invoke As String — void — DialogControlInvokeAsString
• Dialog Item Send Animation Event — void — DialogControlSendAnimationEvent
• Dialog Item Set Animation Speed — void — DialogControlSetAnimationSpeed
• Dialog Item Set Animation Time — void — DialogControlSetAnimationTime
• Dialog Item Advance Animation — void — DialogControlAdvanceAnimation
• Dialog Item Force Transition — void — DialogControlForceTransition
• Dialog Item Request Focus — void — DialogControlRequestFocus
• Set Dialog Item Achievement — void — libNtve_gf_SetDialogItemAchievement
• Set Dialog Item Render Priority — void — libNtve_gf_SetDialogItemRenderPriority
• Set Dialog Item Click On Down — void — libNtve_gf_SetDialogItemClickOnDown
• Set Dialog Item Toggled — void — libNtve_gf_SetDialogItemToggled
• Set Dialog Item Movie — void — libNtve_gf_SetDialogItemMovie
• Set Dialog Item Desaturated — void — libNtve_gf_SetDialogItemDesaturated
• Set Dialog Item Desaturation Color — void — libNtve_gf_SetDialogItemDesaturationColor
• Set Dialog Item Custom Tooltip — void — libNtve_gf_SetDialogItemCustomTooltip
• Set Dialog Item Unit — void — libNtve_gf_SetDialogItemUnit
• Set Dialog Item Model — void — libNtve_gf_SetDialogItemModel
• Set Dialog Item Animation — void — libNtve_gf_SetDialogItemAnimation
• Set Dialog Item Camera — void — libNtve_gf_SetDialogItemCamera
• Set Dialog Item Border Visible — void — libNtve_gf_SetDialogItemBorderVisible
• Set Dialog Item Border Image — void — libNtve_gf_SetDialogItemBorderImage
• Set Dialog Item Background Visible — void — libNtve_gf_SetDialogItemBackgroundVisible
• Set Dialog Item Use Transition — void — libNtve_gf_SetDialogItemUseTransition
• Set Dialog Item Muted — void — libNtve_gf_SetDialogItemMuted
• Set Dialog Item Paused — void — libNtve_gf_SetDialogItemPaused
• Set Dialog Item Accept Mouse — void — libNtve_gf_SetDialogItemAcceptMouse
• Set Dialog Item Tint Color — void — libNtve_gf_SetDialogItemTintColor
• Set Dialog Item Team Color — void — libNtve_gf_SetDialogItemTeamColor
• Set Dialog Item Light — void — libNtve_gf_SetDialogItemLight
• Set Dialog Item Transition Model — void — libNtve_gf_SetDialogItemTransitionModel
• Set Dialog Item Force Visible — void — libNtve_gf_SetDialogItemForceVisible
• Set Dialog Item Render Type — void — libNtve_gf_SetDialogItemRenderType
• Set Dialog Item Unit Link — void — libNtve_gf_SetDialogItemUnitLink
• Set Dialog Item Team Color Index — void — libNtve_gf_SetDialogItemTeamColorIndex
• Set Dialog Item Animation Duration — void — libNtve_gf_SetDialogItemAnimationDuration
• Set Dialog Item Animation Time — void — libNtve_gf_SetDialogItemAnimationTime
• Set Dialog Item Actor — void — libNtve_gf_SetDialogItemActor
• Set Dialog Item Behavior — void — libNtve_gf_SetDialogItemBehavior
• Set Dialog Item Hotkey — void — libNtve_gf_SetDialogItemHotkey
• Set Dialog Item Allowed Mouse Buttons — void — libNtve_gf_SetDialogItemAllowedMouseButtons
• Set Dialog Item Alpha Mask — void — libNtve_gf_SetDialogItemAlphaMask
• Set Dialog Item Animation Index — void — libNtve_gf_SetDialogItemAnimationIndex
• Set Dialog Item Handle — void — libNtve_gf_SetDialogItemHandle
• Set Dialog Item Border Color — void — libNtve_gf_SetDialogItemBorderColor
• Set Dialog Item Fill Color — void — libNtve_gf_SetDialogItemFillColor
• Set Dialog Item Submenu — void — libNtve_gf_SetDialogItemSubmenu
• Set Dialog Item Unit Group — void — libNtve_gf_SetDialogItemUnitGroup
• Set Dialog Item PlayerId — void — libNtve_gf_SetDialogItemPlayerId
• Set Dialog Item Score Value Link — void — libNtve_gf_SetDialogItemScoreValueLink
• Set Dialog Item State Index — void — libNtve_gf_SetDialogItemStateIndex

# Examples

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

    libSwaC_gv_zS_ArmyCustomUpgradeRoomOpened = false;
    libNtve_gf_SetDialogItemMovie(libSwaC_gv_zS_ArmyCustomSelectedUpgradeMovie, "", PlayerGroupAll());
    SoundChannelSetVolume(PlayerGroupAll(), c_soundCategoryMovie, 100.0, 0.0);
    ConversationDataStop();

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

        DialogControlSetVisible(libSwaC_gv_zS_ArmyCustomUpgradeTitlePanel3, PlayerGroupAll(), false);
        DialogControlSetVisible(libSwaC_gv_zS_ArmyCustomUpgradeSelectUpgradeLabel, PlayerGroupAll(), false);
        libNtve_gf_SetDialogItemMovie(libSwaC_gv_zS_ArmyCustomSelectedUpgradeMovie, libSwaC_gf_ZS_StoryArmyUpgradeMovie(libSwaC_gv_zS_ArmyCustomUpgradeCurrent), PlayerGroupAll());
        libNtve_gf_SetDialogItemText(libSwaC_gv_zS_ArmyCustomSelectedUpgradeNameLabel, TextCase(libSwaC_gf_ZS_StoryArmyUpgradeName(libSwaC_gv_zS_ArmyCustomUpgradeCurrent), true), PlayerGroupAll());
        libNtve_gf_SetDialogItemText(libSwaC_gv_zS_ArmyCustomSelectedUpgradeDescriptionLabel, libSwaC_gf_ZS_StoryArmyUpgradeDescription(libSwaC_gv_zS_ArmyCustomUpgradeCurrent), PlayerGroupAll());

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

    TriggerEnable(libSwaC_gt_ZS_ArmyCustomEvolutionUnitUnhighlight, false);
    libSwaC_gf_ZS_ArmyCustomEvolutionUIHide();
    libNtve_gf_SetDialogItemMovie(libSwaC_gv_zS_ArmyCustomEvolutionSelectedUnitMovie, "", PlayerGroupAll());
    SoundChannelSetVolume(PlayerGroupAll(), c_soundCategoryMovie, 100.0, 0.0);
    CinematicFade(true, 0.0, c_fadeStyleNormal, Color(0.00, 0.00, 0.00), 0.0, true);

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

        DialogControlSetVisible(libSwaC_gv_zS_ArmyCustomEvolutionTitleLabel3, PlayerGroupAll(), true);
        DialogControlSetVisible(libSwaC_gv_zS_ArmyCustomEvolutionTitleLabel2, PlayerGroupAll(), true);
        libNtve_gf_SetDialogItemMovie(libSwaC_gv_zS_ArmyCustomEvolutionSelectedUnitMovie, "", PlayerGroupAll());
        DialogControlSetVisible(libSwaC_gv_zS_ArmyCustomEvolutionSelectedUnitNameLabel, PlayerGroupAll(), false);
        DialogControlSetVisible(libSwaC_gv_zS_ArmyCustomEvolutionSelectedUnitDescriptionLabel, PlayerGroupAll(), false);

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

        DialogControlSetVisible(libSwaC_gv_zS_ArmyCustomEvolutionTitleLabel3, PlayerGroupAll(), false);
        DialogControlSetVisible(libSwaC_gv_zS_ArmyCustomEvolutionTitleLabel2, PlayerGroupAll(), false);
        libNtve_gf_SetDialogItemMovie(libSwaC_gv_zS_ArmyCustomEvolutionSelectedUnitMovie, libSwaC_gf_ZS_StoryArmyUnitMovie(libSwaC_gv_zS_ArmyCustomUnitCurrent), PlayerGroupAll());
        libNtve_gf_SetDialogItemText(libSwaC_gv_zS_ArmyCustomEvolutionSelectedUnitNameLabel, libSwaC_gf_ZS_ArmyUnitTitle(libSwaC_gv_zS_ArmyCustomUnitCurrent), PlayerGroupAll());
        libNtve_gf_SetDialogItemText(libSwaC_gv_zS_ArmyCustomEvolutionSelectedUnitDescriptionLabel, libSwaC_gf_ZS_ArmyUnitDescription(lv_indexArmyUnit), PlayerGroupAll());

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

    DialogSetVisible(libSwaC_gv_zS_ArmyCustomEvolutionDialog, PlayerGroupAll(), false);
    ConversationDataStop();
    libNtve_gf_SetDialogItemMovie(libSwaC_gv_zS_ArmyCustomEvolutionSelectedUnitMovie, "", PlayerGroupAll());
    TriggerEnable(libSwaC_gt_ZS_ArmyCustomEvolutionFanfareOver, true);
    TriggerEnable(libSwaC_gt_ZS_ArmyCustomEvolutionFanfareFade, true);

campaigns/voidstory.sc2campaign — base.sc2data/TriggerLibs/VoidCampaignUILib.galaxy:900

    CutsceneClearFilters(libVCUI_gv_pU_ArmyCutscene);
    if ((libVCUI_gv_pU_ArmyUnitSelectedIndex[libVCUI_gv_pU_ArmyCategorySelectedIndex] == 0)) {
        libNtve_gf_SetDialogItemMovie(libVCUI_gv_pU_ArmyInfoMovie, (""), PlayerGroupAll());
        DialogControlSetVisible(libVCUI_gv_pU_ArmyInfoPanel, PlayerGroupAll(), false);
        DialogControlSetVisible(libVCUI_gv_pU_ArmyFactionPrompt, PlayerGroupAll(), true);

campaigns/voidstory.sc2campaign — base.sc2data/TriggerLibs/VoidCampaignUILib.galaxy:917

        libNtve_gf_SetDialogItemText(libVCUI_gv_pU_ArmyInfoDescriptionLabel, libVoiC_gf_PC_ArmyUnitDescription(libVCUI_gv_pU_ArmyUnits[libVCUI_gv_pU_ArmyCategorySelectedIndex][libVCUI_gv_pU_ArmyUnitSelectedIndex[libVCUI_gv_pU_ArmyCategorySelectedIndex]]), PlayerGroupAll());
        libNtve_gf_SetDialogItemText(libVCUI_gv_pU_ArmyInfoLoreLabel, UserDataGetText("TechUnit", libVoiC_gf_PC_TechUnitOfArmyUnit(libVCUI_gv_pU_ArmyUnits[libVCUI_gv_pU_ArmyCategorySelectedIndex][libVCUI_gv_pU_ArmyUnitSelectedIndex[libVCUI_gv_pU_ArmyCategorySelectedIndex]]), "ArmyInfoFluffText", 1), PlayerGroupAll());
        libNtve_gf_SetDialogItemMovie(libVCUI_gv_pU_ArmyInfoMovie, libVoiC_gf_PC_ArmyUnitMovie(libVCUI_gv_pU_ArmyUnits[libVCUI_gv_pU_ArmyCategorySelectedIndex][libVCUI_gv_pU_ArmyUnitSelectedIndex[libVCUI_gv_pU_ArmyCategorySelectedIndex]]), PlayerGroupAll());
        libVCUI_gf_PU_ArmyUpdateStatsAbilityTooltips(libVoiC_gf_PC_TechUnitOfArmyUnit(libVCUI_gv_pU_ArmyUnits[libVCUI_gv_pU_ArmyCategorySelectedIndex][libVCUI_gv_pU_ArmyUnitSelectedIndex[libVCUI_gv_pU_ArmyCategorySelectedIndex]]));
    }

mods/missionpacks/novacampaign.sc2mod — base.sc2data/LibNCUI.galaxy:1415

    DialogControlSetEnabled(libNCUI_gv_nU_MissionManagementEquipmentButton, PlayerGroupAll(), true);
    libNCUI_gf_NU_MissionEnableDisableUpgradesButton(true);
    libNtve_gf_SetDialogItemMovie(libNCUI_gv_nU_MissionBriefingMovieFrame, (""), PlayerGroupAll());
    libNtve_gf_SetDialogItemModel(libNCUI_gv_nU_MissionPortrait, libComC_gf_CC_MapContactPortrait(libNCUI_gf_NU_NextAvailableMission()), PlayerGroupAll());
    if ((libComC_gf_CC_MapContactActor(libNCUI_gf_NU_NextAvailableMission()) == null)) {

mods/missionpacks/novacampaign.sc2mod — base.sc2data/LibNCUI.galaxy:1470

    DialogControlSendAnimationEvent(libNCUI_gv_nU_MissionNewsScreenContainer, PlayerGroupAll(), "NewsExit");
    DialogControlSendAnimationEvent(libNCUI_gv_nU_MissionNewsButton, PlayerGroupAll(), "NewsStandardDisplay");
    libNtve_gf_SetDialogItemMovie(libNCUI_gv_nU_MissionNewsScreen, (""), PlayerGroupAll());
    DialogControlSetEnabled(libNCUI_gv_nU_MissionLaunchButton, PlayerGroupAll(), true);
    DialogControlSetEnabled(libNCUI_gv_nU_MissionDifficultyDropdown, PlayerGroupAll(), true);

mods/missionpacks/novacampaign.sc2mod — base.sc2data/LibNCUI.galaxy:1990

void libNCUI_gf_NU_UpgradesUpdateMovie (int lp_unitSlot, int lp_upgradeItemIndex) {
    // Implementation
    libNtve_gf_SetDialogItemMovie(libNCUI_gv_nU_UpgradesSubselectionMovie, libNovC_gf_NC_ArmyTechItemMovieFromIndex(libNCUI_gf_NU_UpgradesTechItemInSlot(lp_unitSlot, lp_upgradeItemIndex), libNCUI_gv_nU_UpgradesTechItemUnitListIndex[lp_unitSlot][lp_upgradeItemIndex]), PlayerGroupAll());
}

mods/missionpacks/novacampaign.sc2mod — base.sc2data/LibNCUI.galaxy:4434

    Wait(2.0, c_timeReal);
    libNCUI_gf_NU_MissionBriefingNewPhase(lv_eventFrame, lv_mission, 4);
    libNtve_gf_SetDialogItemMovie(libNCUI_gv_nU_MissionBriefingMovieFrame, "Assets\\Textures\\briefing_video_nova02_00.ogv", PlayerGroupAll());
    Wait(0.8, c_timeReal);
    libNCUI_gf_NU_MissionBriefingNewPhase(lv_eventFrame, lv_mission, 5);

mods/missionpacks/novacampaign.sc2mod — base.sc2data/LibNCUI.galaxy:4449

    Wait(2.0, c_timeReal);
    libNCUI_gf_NU_MissionBriefingNewPhase(lv_eventFrame, lv_mission, 11);
    libNtve_gf_SetDialogItemMovie(libNCUI_gv_nU_MissionBriefingMovieFrame, "Assets\\Textures\\briefing_video_nova02_01.ogv", PlayerGroupAll());
    Wait(0.8, c_timeReal);
    libNCUI_gf_NU_MissionBriefingNewPhase(lv_eventFrame, lv_mission, 12);

mods/missionpacks/novacampaign.sc2mod — base.sc2data/LibNCUI.galaxy:4531

    TriggerExecute(libNCUI_gt_NU_Nova03BriefingTransmissions, true, false);
    libNCUI_gf_NU_MissionBriefingNewPhase(lv_eventFrame, lv_mission, 1);
    libNtve_gf_SetDialogItemMovie(libNCUI_gv_nU_MissionBriefingMovieFrame, "Assets\\Textures\\briefing_video_nova03_00.ogv", PlayerGroupAll());
    Wait(2.0, c_timeReal);
    libNCUI_gf_NU_MissionBriefingNewPhase(lv_eventFrame, lv_mission, 2);

mods/missionpacks/novacampaign.sc2mod — base.sc2data/LibNCUI.galaxy:4537

    libNCUI_gf_NU_MissionBriefingNewPhase(lv_eventFrame, lv_mission, 3);
    Wait(8.5, c_timeReal);
    libNtve_gf_SetDialogItemMovie(libNCUI_gv_nU_MissionBriefingMovieFrame, "Assets\\Textures\\briefing_video_nova03_01.ogv", PlayerGroupAll());
    Wait(9.0, c_timeReal);
    libNCUI_gf_NU_MissionBriefingNewPhase(lv_eventFrame, lv_mission, 4);

mods/missionpacks/novacampaign.sc2mod — base.sc2data/LibNCUI.galaxy:4547

    libNCUI_gf_NU_MissionBriefingNewPhase(lv_eventFrame, lv_mission, 7);
    Wait(3.0, c_timeReal);
    libNtve_gf_SetDialogItemMovie(libNCUI_gv_nU_MissionBriefingMovieFrame, "Assets\\Textures\\briefing_video_nova03_02.ogv", PlayerGroupAll());
    libNCUI_gf_NU_MissionBriefingNewPhase(lv_eventFrame, lv_mission, 8);
    Wait(0.8, c_timeReal);

mods/missionpacks/novacampaign.sc2mod — base.sc2data/LibNCUI.galaxy:4557

    Wait(1.5, c_timeReal);
    libNCUI_gf_NU_MissionBriefingNewPhase(lv_eventFrame, lv_mission, 12);
    libNtve_gf_SetDialogItemMovie(libNCUI_gv_nU_MissionBriefingMovieFrame, "Assets\\Textures\\briefing_video_nova03_03.ogv", PlayerGroupAll());
    Wait(0.8, c_timeReal);
    libNCUI_gf_NU_MissionBriefingNewPhase(lv_eventFrame, lv_mission, 13);

mods/missionpacks/novacampaign.sc2mod — base.sc2data/LibNCUI.galaxy:4566

    Wait(0.8, c_timeReal);
    libNCUI_gf_NU_MissionBriefingNewPhase(lv_eventFrame, lv_mission, 16);
    libNtve_gf_SetDialogItemMovie(libNCUI_gv_nU_MissionBriefingMovieFrame, "Assets\\Textures\\briefing_video_nova03_04.ogv", PlayerGroupAll());
    Wait(0.8, c_timeReal);
    libNCUI_gf_NU_MissionBriefingNewPhase(lv_eventFrame, lv_mission, 17);