DUI e texturas runtime

DUI (Direct-rendered User Interface) é um navegador fora da tela. Em vez de ocupar a interface inteira como a NUI, a página vira uma textura: ela pode ser desenhada com as funções DX ou aplicada sobre uma textura do mundo.

Estas 14 funções existem somente no cliente. Cada DUI é atualizado a até 30 quadros por segundo. O cliente aceita no máximo 8 navegadores DUI simultâneos, ou 2 em máquinas classificadas como de baixo desempenho.

Limpeza automática

Ao parar o resource, o MTAX fecha os DUIs que ele criou e remove suas substituições e dicionários de textura runtime. Use destroyDui e removeReplaceTexture antes disso quando não precisar mais deles.

Fluxo completo

Este exemplo abre uma página local e usa sua imagem para substituir cj_tv_screen no mundo:

local tv = createDui("nui://meu-resource/ui/tv.html", 1024, 512)
if not tv then return end

local txd = createRuntimeTxd("telas_tv")
local textura = createRuntimeTextureFromDuiHandle(txd, "tv_ao_vivo", tv)
if not textura then
    destroyDui(tv)
    return
end

addReplaceTexture("cj_tv", "cj_tv_screen", txd, "tv_ao_vivo")

-- quando terminar:
-- removeReplaceTexture("cj_tv", "cj_tv_screen")
-- destroyDui(tv)

O arquivo local precisa pertencer ao mesmo resource da chamada. Para uma página em ui/tv.html do resource meu-resource, use nui://meu-resource/ui/tv.html.

Navegador DUI

createDui Cria um navegador fora da tela.

destroyDui Fecha o navegador e destrói seu elemento e material.

isDuiAvailable Verifica se o frame principal da página terminou de carregar e está disponível.

getDuiHandle Obtém o identificador textual de um DUI.

setDuiUrl Carrega outra página no navegador.

sendDuiMessage Envia dados da Lua para a página.

Entrada do mouse

As coordenadas são em pixels da superfície criada por createDui, não da tela do jogo.

sendDuiMouseMove Move o cursor virtual do navegador.

sendDuiMouseDown Pressiona um botão do mouse na última posição enviada.

sendDuiMouseUp Solta um botão do mouse na última posição enviada.

sendDuiMouseWheel Envia rolagem na última posição do mouse.

Texturas runtime

createRuntimeTxd Cria ou recupera um dicionário de texturas runtime do resource.

createRuntimeTextureFromDuiHandle Cria uma textura runtime que mostra a superfície viva do DUI.

addReplaceTexture Substitui uma textura do mundo por uma textura runtime.

removeReplaceTexture Remove uma substituição registrada por addReplaceTexture.