# Set Dialog Item Alpha Mask

Grammar — Set dialogItem Alpha Mask to image for players
FlagsAction

Sets the alpha mask that can be used to mask out any pixels in the specified texture with an alpha value. Currently supported for all dialog item types.

# Arguments

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

Returns — void

void libNtve_gf_SetDialogItemAlphaMask(
	int lp_dialogItem,
	string lp_image,
	playergroup lp_players,
);

Category: Dialog / Dialog Item Tools

# Examples

campaigns/swarmstory.sc2campaignbase.sc2data/TriggerLibs/SwarmCampaignLib.galaxy:2546

        if ((libSwaC_gv_zS_ObjectivePanel != c_invalidDialogControlId) && (libNtve_gf_PlayerInCinematicMode(1) == false) && (libSwaC_gv_zS_GameOver == false)) {
            if ((PortraitVisible(libNtve_gf_CinematicPortrait(libNtve_ge_CinematicPortraitPosition_CenterLeft), 1) == true) && (libSwaC_gv_zS_SwarmHeroUIPanel[1] != c_invalidDialogControlId) && (DialogControlIsVisible(libSwaC_gv_zS_SwarmHeroUIPanel[1], 1) == true) && (libSwaC_gv_zS_SwarmHeroUIPanel[2] != c_invalidDialogControlId) && (DialogControlIsVisible(libSwaC_gv_zS_SwarmHeroUIPanel[2], 1) == true)) {
                libNtve_gf_SetDialogItemAlphaMask(libSwaC_gv_zS_ObjectivePanel, "@UI/ObjectivePanelMaskTwoHeroes", PlayerGroupAll());
            }
            else if ((PortraitVisible(libNtve_gf_CinematicPortrait(libNtve_ge_CinematicPortraitPosition_CenterLeft), 1) == true) && (((libSwaC_gv_zS_SwarmHeroUIPanel[1] != c_invalidDialogControlId) && (DialogControlIsVisible(libSwaC_gv_zS_SwarmHeroUIPanel[1], 1) == true)) || ((libSwaC_gv_zS_SwarmHeroUIPanel[2] != c_invalidDialogControlId) && (DialogControlIsVisible(libSwaC_gv_zS_SwarmHeroUIPanel[2], 1) == true)))) {

campaigns/swarmstory.sc2campaignbase.sc2data/TriggerLibs/SwarmCampaignLib.galaxy:2549

            }
            else if ((PortraitVisible(libNtve_gf_CinematicPortrait(libNtve_ge_CinematicPortraitPosition_CenterLeft), 1) == true) && (((libSwaC_gv_zS_SwarmHeroUIPanel[1] != c_invalidDialogControlId) && (DialogControlIsVisible(libSwaC_gv_zS_SwarmHeroUIPanel[1], 1) == true)) || ((libSwaC_gv_zS_SwarmHeroUIPanel[2] != c_invalidDialogControlId) && (DialogControlIsVisible(libSwaC_gv_zS_SwarmHeroUIPanel[2], 1) == true)))) {
                libNtve_gf_SetDialogItemAlphaMask(libSwaC_gv_zS_ObjectivePanel, "@UI/ObjectivePanelMask", PlayerGroupAll());
            }
            else if (((PortraitVisible(libNtve_gf_CinematicPortrait(libNtve_ge_CinematicPortraitPosition_CenterLeft), 1) == false) || (((libSwaC_gv_zS_SwarmHeroUIPanel[1] == c_invalidDialogControlId) || (DialogControlIsVisible(libSwaC_gv_zS_SwarmHeroUIPanel[1], 1) == false)) && ((libSwaC_gv_zS_SwarmHeroUIPanel[2] == c_invalidDialogControlId) || (DialogControlIsVisible(libSwaC_gv_zS_SwarmHeroUIPanel[2], 1) == false))))) {

campaigns/swarmstory.sc2campaignbase.sc2data/TriggerLibs/SwarmCampaignLib.galaxy:2552

            }
            else if (((PortraitVisible(libNtve_gf_CinematicPortrait(libNtve_ge_CinematicPortraitPosition_CenterLeft), 1) == false) || (((libSwaC_gv_zS_SwarmHeroUIPanel[1] == c_invalidDialogControlId) || (DialogControlIsVisible(libSwaC_gv_zS_SwarmHeroUIPanel[1], 1) == false)) && ((libSwaC_gv_zS_SwarmHeroUIPanel[2] == c_invalidDialogControlId) || (DialogControlIsVisible(libSwaC_gv_zS_SwarmHeroUIPanel[2], 1) == false))))) {
                libNtve_gf_SetDialogItemAlphaMask(libSwaC_gv_zS_ObjectivePanel, "", PlayerGroupAll());
            }
        }

campaigns/swarmstory.sc2campaignbase.sc2data/TriggerLibs/SwarmCampaignLib.galaxy:2588

            if ((libSwaC_gv_zS_ErrorPanelMaskOn == false)) {
                libSwaC_gv_zS_ErrorPanelMaskOn = true;
                libNtve_gf_SetDialogItemAlphaMask(libSwaC_gv_zS_ErrorPanel, "@UI/InGame_ErrorDisplayMask", PlayerGroupAll());
            }

campaigns/swarmstory.sc2campaignbase.sc2data/TriggerLibs/SwarmCampaignLib.galaxy:2595

            if ((libSwaC_gv_zS_ErrorPanelMaskOn == true)) {
                libSwaC_gv_zS_ErrorPanelMaskOn = false;
                libNtve_gf_SetDialogItemAlphaMask(libSwaC_gv_zS_ErrorPanel, "", PlayerGroupAll());
            }

campaigns/voidstory.sc2campaignbase.sc2data/TriggerLibs/VoidCampaignUILib.galaxy:4153

        if ((libVCUI_gv_pU_ObjectivePanel != c_invalidDialogControlId) && (libNtve_gf_PlayerInCinematicMode(1) == false)) {
            if ((PortraitVisible(libNtve_gf_CinematicPortrait(libNtve_ge_CinematicPortraitPosition_CenterLeft), 1) == true) && (libVCUI_gv_pU_VoidHeroUIPanel[1] != c_invalidDialogControlId) && (DialogControlIsVisible(libVCUI_gv_pU_VoidHeroUIPanel[1], 1) == true) && (libVCUI_gv_pU_VoidHeroUIPanel[2] != c_invalidDialogControlId) && (DialogControlIsVisible(libVCUI_gv_pU_VoidHeroUIPanel[2], 1) == true)) {
                libNtve_gf_SetDialogItemAlphaMask(libVCUI_gv_pU_ObjectivePanel, "@UI/ObjectivePanelMaskTwoHeroes", PlayerGroupAll());
            }
            else if ((PortraitVisible(libNtve_gf_CinematicPortrait(libNtve_ge_CinematicPortraitPosition_CenterLeft), 1) == true) && (((libVCUI_gv_pU_VoidHeroUIPanel[1] != c_invalidDialogControlId) && (DialogControlIsVisible(libVCUI_gv_pU_VoidHeroUIPanel[1], 1) == true)) || ((libVCUI_gv_pU_VoidHeroUIPanel[2] != c_invalidDialogControlId) && (DialogControlIsVisible(libVCUI_gv_pU_VoidHeroUIPanel[2], 1) == true)))) {

campaigns/voidstory.sc2campaignbase.sc2data/TriggerLibs/VoidCampaignUILib.galaxy:4156

            }
            else if ((PortraitVisible(libNtve_gf_CinematicPortrait(libNtve_ge_CinematicPortraitPosition_CenterLeft), 1) == true) && (((libVCUI_gv_pU_VoidHeroUIPanel[1] != c_invalidDialogControlId) && (DialogControlIsVisible(libVCUI_gv_pU_VoidHeroUIPanel[1], 1) == true)) || ((libVCUI_gv_pU_VoidHeroUIPanel[2] != c_invalidDialogControlId) && (DialogControlIsVisible(libVCUI_gv_pU_VoidHeroUIPanel[2], 1) == true)))) {
                libNtve_gf_SetDialogItemAlphaMask(libVCUI_gv_pU_ObjectivePanel, "", PlayerGroupAll());
            }
            else if (((PortraitVisible(libNtve_gf_CinematicPortrait(libNtve_ge_CinematicPortraitPosition_CenterLeft), 1) == false) || (((libVCUI_gv_pU_VoidHeroUIPanel[1] == c_invalidDialogControlId) || (DialogControlIsVisible(libVCUI_gv_pU_VoidHeroUIPanel[1], 1) == false)) && ((libVCUI_gv_pU_VoidHeroUIPanel[2] == c_invalidDialogControlId) || (DialogControlIsVisible(libVCUI_gv_pU_VoidHeroUIPanel[2], 1) == false))))) {

campaigns/voidstory.sc2campaignbase.sc2data/TriggerLibs/VoidCampaignUILib.galaxy:4159

            }
            else if (((PortraitVisible(libNtve_gf_CinematicPortrait(libNtve_ge_CinematicPortraitPosition_CenterLeft), 1) == false) || (((libVCUI_gv_pU_VoidHeroUIPanel[1] == c_invalidDialogControlId) || (DialogControlIsVisible(libVCUI_gv_pU_VoidHeroUIPanel[1], 1) == false)) && ((libVCUI_gv_pU_VoidHeroUIPanel[2] == c_invalidDialogControlId) || (DialogControlIsVisible(libVCUI_gv_pU_VoidHeroUIPanel[2], 1) == false))))) {
                libNtve_gf_SetDialogItemAlphaMask(libVCUI_gv_pU_ObjectivePanel, "", PlayerGroupAll());
            }
        }

mods/missionpacks/novacampaign.sc2modbase.sc2data/LibNCUI.galaxy:3646

        if ((libNCUI_gv_NU_ObjectivePanel != c_invalidDialogControlId) && (libNtve_gf_PlayerInCinematicMode(1) == false)) {
            if ((PortraitVisible(libNtve_gf_CinematicPortrait(libNtve_ge_CinematicPortraitPosition_CenterLeft), 1) == true) && (libNCUI_gv_nU_HeroPanel[1] != c_invalidDialogControlId) && (DialogControlIsVisible(libNCUI_gv_nU_HeroPanel[1], 1) == true) && (libNCUI_gv_nU_HeroPanel[2] != c_invalidDialogControlId) && (DialogControlIsVisible(libNCUI_gv_nU_HeroPanel[2], 1) == true)) {
                libNtve_gf_SetDialogItemAlphaMask(libNCUI_gv_NU_ObjectivePanel, "@UI/ObjectivePanelMaskTwoHeroes", PlayerGroupAll());
            }
            else if ((PortraitVisible(libNtve_gf_CinematicPortrait(libNtve_ge_CinematicPortraitPosition_CenterLeft), 1) == true) && (((libNCUI_gv_nU_HeroPanel[1] != c_invalidDialogControlId) && (DialogControlIsVisible(libNCUI_gv_nU_HeroPanel[1], 1) == true)) || ((libNCUI_gv_nU_HeroPanel[2] != c_invalidDialogControlId) && (DialogControlIsVisible(libNCUI_gv_nU_HeroPanel[2], 1) == true)))) {

mods/missionpacks/novacampaign.sc2modbase.sc2data/LibNCUI.galaxy:3649

            }
            else if ((PortraitVisible(libNtve_gf_CinematicPortrait(libNtve_ge_CinematicPortraitPosition_CenterLeft), 1) == true) && (((libNCUI_gv_nU_HeroPanel[1] != c_invalidDialogControlId) && (DialogControlIsVisible(libNCUI_gv_nU_HeroPanel[1], 1) == true)) || ((libNCUI_gv_nU_HeroPanel[2] != c_invalidDialogControlId) && (DialogControlIsVisible(libNCUI_gv_nU_HeroPanel[2], 1) == true)))) {
                libNtve_gf_SetDialogItemAlphaMask(libNCUI_gv_NU_ObjectivePanel, "", PlayerGroupAll());
            }
            else if (((PortraitVisible(libNtve_gf_CinematicPortrait(libNtve_ge_CinematicPortraitPosition_CenterLeft), 1) == false) || (((libNCUI_gv_nU_HeroPanel[1] == c_invalidDialogControlId) || (DialogControlIsVisible(libNCUI_gv_nU_HeroPanel[1], 1) == false)) && ((libNCUI_gv_nU_HeroPanel[2] == c_invalidDialogControlId) || (DialogControlIsVisible(libNCUI_gv_nU_HeroPanel[2], 1) == false))))) {

mods/missionpacks/novacampaign.sc2modbase.sc2data/LibNCUI.galaxy:3652

            }
            else if (((PortraitVisible(libNtve_gf_CinematicPortrait(libNtve_ge_CinematicPortraitPosition_CenterLeft), 1) == false) || (((libNCUI_gv_nU_HeroPanel[1] == c_invalidDialogControlId) || (DialogControlIsVisible(libNCUI_gv_nU_HeroPanel[1], 1) == false)) && ((libNCUI_gv_nU_HeroPanel[2] == c_invalidDialogControlId) || (DialogControlIsVisible(libNCUI_gv_nU_HeroPanel[2], 1) == false))))) {
                libNtve_gf_SetDialogItemAlphaMask(libNCUI_gv_NU_ObjectivePanel, "", PlayerGroupAll());
            }
        }

mods/starcoop/starcoop.sc2modbase.sc2data/LibCOUI.galaxy:3227

        if ((libCOUI_gv_cU_ObjectivePanel != c_invalidDialogControlId) && (libNtve_gf_PlayerInCinematicMode(1) == false) && (libCOMI_gf_GameIsOver() == false)) {
            if ((PortraitVisible(libNtve_gf_CinematicPortrait(libNtve_ge_CinematicPortraitPosition_CenterLeft), 1) == true) && (libCOUI_gv_cU_HeroPanel[1] != c_invalidDialogControlId) && (DialogControlIsVisible(libCOUI_gv_cU_HeroPanel[1], 1) == true) && (libCOUI_gv_cU_HeroPanel[2] != c_invalidDialogControlId) && (DialogControlIsVisible(libCOUI_gv_cU_HeroPanel[2], 1) == true)) {
                libNtve_gf_SetDialogItemAlphaMask(libCOUI_gv_cU_ObjectivePanel, "@UI/ObjectivePanelMaskTwoHeroes", PlayerGroupAll());
            }
            else if ((PortraitVisible(libNtve_gf_CinematicPortrait(libNtve_ge_CinematicPortraitPosition_CenterLeft), 1) == true) && (((libCOUI_gv_cU_HeroPanel[1] != c_invalidDialogControlId) && (DialogControlIsVisible(libCOUI_gv_cU_HeroPanel[1], 1) == true)) || ((libCOUI_gv_cU_HeroPanel[2] != c_invalidDialogControlId) && (DialogControlIsVisible(libCOUI_gv_cU_HeroPanel[2], 1) == true)))) {

mods/starcoop/starcoop.sc2modbase.sc2data/LibCOUI.galaxy:3230

            }
            else if ((PortraitVisible(libNtve_gf_CinematicPortrait(libNtve_ge_CinematicPortraitPosition_CenterLeft), 1) == true) && (((libCOUI_gv_cU_HeroPanel[1] != c_invalidDialogControlId) && (DialogControlIsVisible(libCOUI_gv_cU_HeroPanel[1], 1) == true)) || ((libCOUI_gv_cU_HeroPanel[2] != c_invalidDialogControlId) && (DialogControlIsVisible(libCOUI_gv_cU_HeroPanel[2], 1) == true)))) {
                libNtve_gf_SetDialogItemAlphaMask(libCOUI_gv_cU_ObjectivePanel, "@UI/ObjectivePanelMask", PlayerGroupAll());
            }
            else if (((PortraitVisible(libNtve_gf_CinematicPortrait(libNtve_ge_CinematicPortraitPosition_CenterLeft), 1) == false) || (((libCOUI_gv_cU_HeroPanel[1] == c_invalidDialogControlId) || (DialogControlIsVisible(libCOUI_gv_cU_HeroPanel[1], 1) == false)) && ((libCOUI_gv_cU_HeroPanel[2] == c_invalidDialogControlId) || (DialogControlIsVisible(libCOUI_gv_cU_HeroPanel[2], 1) == false))))) {

mods/starcoop/starcoop.sc2modbase.sc2data/LibCOUI.galaxy:3233

            }
            else if (((PortraitVisible(libNtve_gf_CinematicPortrait(libNtve_ge_CinematicPortraitPosition_CenterLeft), 1) == false) || (((libCOUI_gv_cU_HeroPanel[1] == c_invalidDialogControlId) || (DialogControlIsVisible(libCOUI_gv_cU_HeroPanel[1], 1) == false)) && ((libCOUI_gv_cU_HeroPanel[2] == c_invalidDialogControlId) || (DialogControlIsVisible(libCOUI_gv_cU_HeroPanel[2], 1) == false))))) {
                libNtve_gf_SetDialogItemAlphaMask(libCOUI_gv_cU_ObjectivePanel, "", PlayerGroupAll());
            }
        }

mods/voidprologue.sc2modbase.sc2data/LibA3DDD02B.galaxy:1540

        if ((libA3DDD02B_gv_pP_ObjectivePanel != c_invalidDialogControlId) && (libNtve_gf_PlayerInCinematicMode(1) == false) && (libA3DDD02B_gv_pP_GameOver == false)) {
            if ((PortraitVisible(libNtve_gf_CinematicPortrait(libNtve_ge_CinematicPortraitPosition_CenterLeft), 1) == true) && (libA3DDD02B_gv_pP_HeroUIPanel[1] != c_invalidDialogControlId) && (DialogControlIsVisible(libA3DDD02B_gv_pP_HeroUIPanel[1], 1) == true) && (libA3DDD02B_gv_pP_HeroUIPanel[2] != c_invalidDialogControlId) && (DialogControlIsVisible(libA3DDD02B_gv_pP_HeroUIPanel[2], 1) == true)) {
                libNtve_gf_SetDialogItemAlphaMask(libA3DDD02B_gv_pP_ObjectivePanel, "@UI/ObjectivePanelMaskTwoHeroes", PlayerGroupAll());
            }
            else if ((PortraitVisible(libNtve_gf_CinematicPortrait(libNtve_ge_CinematicPortraitPosition_CenterLeft), 1) == true) && (((libA3DDD02B_gv_pP_HeroUIPanel[1] != c_invalidDialogControlId) && (DialogControlIsVisible(libA3DDD02B_gv_pP_HeroUIPanel[1], 1) == true)) || ((libA3DDD02B_gv_pP_HeroUIPanel[2] != c_invalidDialogControlId) && (DialogControlIsVisible(libA3DDD02B_gv_pP_HeroUIPanel[2], 1) == true)))) {

mods/voidprologue.sc2modbase.sc2data/LibA3DDD02B.galaxy:1543

            }
            else if ((PortraitVisible(libNtve_gf_CinematicPortrait(libNtve_ge_CinematicPortraitPosition_CenterLeft), 1) == true) && (((libA3DDD02B_gv_pP_HeroUIPanel[1] != c_invalidDialogControlId) && (DialogControlIsVisible(libA3DDD02B_gv_pP_HeroUIPanel[1], 1) == true)) || ((libA3DDD02B_gv_pP_HeroUIPanel[2] != c_invalidDialogControlId) && (DialogControlIsVisible(libA3DDD02B_gv_pP_HeroUIPanel[2], 1) == true)))) {
                libNtve_gf_SetDialogItemAlphaMask(libA3DDD02B_gv_pP_ObjectivePanel, "@UI/ObjectivePanelMask", PlayerGroupAll());
            }
            else if (((PortraitVisible(libNtve_gf_CinematicPortrait(libNtve_ge_CinematicPortraitPosition_CenterLeft), 1) == false) || (((libA3DDD02B_gv_pP_HeroUIPanel[1] == c_invalidDialogControlId) || (DialogControlIsVisible(libA3DDD02B_gv_pP_HeroUIPanel[1], 1) == false)) && ((libA3DDD02B_gv_pP_HeroUIPanel[2] == c_invalidDialogControlId) || (DialogControlIsVisible(libA3DDD02B_gv_pP_HeroUIPanel[2], 1) == false))))) {

mods/voidprologue.sc2modbase.sc2data/LibA3DDD02B.galaxy:1546

            }
            else if (((PortraitVisible(libNtve_gf_CinematicPortrait(libNtve_ge_CinematicPortraitPosition_CenterLeft), 1) == false) || (((libA3DDD02B_gv_pP_HeroUIPanel[1] == c_invalidDialogControlId) || (DialogControlIsVisible(libA3DDD02B_gv_pP_HeroUIPanel[1], 1) == false)) && ((libA3DDD02B_gv_pP_HeroUIPanel[2] == c_invalidDialogControlId) || (DialogControlIsVisible(libA3DDD02B_gv_pP_HeroUIPanel[2], 1) == false))))) {
                libNtve_gf_SetDialogItemAlphaMask(libA3DDD02B_gv_pP_ObjectivePanel, "", PlayerGroupAll());
            }
        }

mods/voidprologue.sc2modbase.sc2data/LibA3DDD02B.galaxy:1582

            if ((libA3DDD02B_gv_pP_ErrorPanelMaskOn == false)) {
                libA3DDD02B_gv_pP_ErrorPanelMaskOn = true;
                libNtve_gf_SetDialogItemAlphaMask(libA3DDD02B_gv_pP_ErrorPanel, "@UI/InGame_ErrorDisplayMask", PlayerGroupAll());
            }

mods/voidprologue.sc2modbase.sc2data/LibA3DDD02B.galaxy:1589

            if ((libA3DDD02B_gv_pP_ErrorPanelMaskOn == true)) {
                libA3DDD02B_gv_pP_ErrorPanelMaskOn = false;
                libNtve_gf_SetDialogItemAlphaMask(libA3DDD02B_gv_pP_ErrorPanel, "", PlayerGroupAll());
            }