PT-BR/SvgSetDocumentXML: Difference between revisions
Jump to navigation
Jump to search
No edit summary |
Fernando187 (talk | contribs) (Remove obsolete Requirements section) |
||
(5 intermediate revisions by 2 users not shown) | |||
Line 1: | Line 1: | ||
__NOTOC__ | __NOTOC__ | ||
{{BR/ | {{PT-BR/Client_function}} | ||
{{Added feature/item|1.5.9|1.5.8|20979|Define o documento XML subjacente de um elemento SVG.}} | {{Added feature/item|1.5.9|1.5.8|20979|Define o documento XML subjacente de um elemento SVG.}} | ||
==Sintaxe== | ==Sintaxe== | ||
Line 11: | Line 11: | ||
===Argumentos Opcionais=== | ===Argumentos Opcionais=== | ||
{{OptionalArg}} | {{OptionalArg}} | ||
*'''callback:''' Uma função de | *'''callback:''' Uma função de retorno de chamada que é armazenada no SVG e disparada toda vez que a textura do SVG é atualizada (por exemplo, via [[svgSetSize]]). Nota: se presente, isso substituirá o retorno de chamada atual armazenado no [[svg]] | ||
===Retornos=== | ===Retornos=== | ||
* Retorna'''true''' se for bem sucedido, '''false''' caso | * Retorna'''true''' se for bem sucedido, '''false''' caso contrário. | ||
==Exemplo== | ==Exemplo== | ||
Este exemplo cria um elemento [[svg]] incluindo um keybind (F2) para adicionar um nó rect filho, com o uso de uma função de callback para notificar no debugscript quando o SVG foi atualizado. | |||
<syntaxhighlight lang="lua"> | <syntaxhighlight lang="lua"> | ||
-- Isso também pode ser um arquivo, com o | -- Isso também pode ser um arquivo, com o caminho fornecido para svgCreate | ||
local rawSvgData = [[ | local rawSvgData = [[ | ||
<svg viewBox="0 0 500 500" xmlns="http://www.w3.org/2000/svg"> | <svg viewBox="0 0 500 500" xmlns="http://www.w3.org/2000/svg"> | ||
Line 29: | Line 27: | ||
]] | ]] | ||
local svg | local svgs = {} | ||
local function render(svg) | |||
if (not isElement(svg)) or (getElementType(svg) ~= "svg") then | |||
removeEventHandler("onClientRender", root, svgs[svg].handler) | |||
svgs[svg] = nil | |||
end | |||
local width, height = svgGetSize(svg) | |||
dxDrawImage(0, 0, width, height, svg, 0, 0, 0, tocolor(255, 255, 255), false) | |||
end | |||
local function onUpdate(svg) | |||
-- Se esta for a primeira atualização, adicione svg à nossa tabela e comece a desenhá-la | |||
if (not svgs[svg]) then | |||
svgs[svg] = { | |||
state = true, | |||
handler = function() | |||
render(svg) | |||
end | |||
} | |||
addEventHandler("onClientRender", root, svgs[svg].handler) | |||
end | |||
iprint("Textura SVG atualizada.", svg, getTickCount()) | |||
end | |||
local function init() | |||
-- Cria um SVG contendo um círculo, usando os dados XML brutos acima | |||
local mySvg = svgCreate(500, 500, rawSvgData, onUpdate) | |||
-- Vincule uma chave para criar um nó filho SVG rect, que acionará o retorno de chamada onUpdate | |||
bindKey("F2", "down", function() | |||
addSVGRectNode(mySvg) | |||
end) | end) | ||
end | end | ||
addEventHandler("onClientResourceStart", resourceRoot, init) | addEventHandler("onClientResourceStart", resourceRoot, init) | ||
-- Adiciona um nó reto ao SVG com cor, tamanho e posição aleatórios | |||
-- | function addSVGRectNode(svg) | ||
function | |||
-- Obter o documento XML do nosso SVG | -- Obter o documento XML do nosso SVG | ||
local svgXML = svgGetDocumentXML(svg) | local svgXML = svgGetDocumentXML(svg) | ||
-- | -- Adicione um nó SVG reto, posicionado no centro do documento | ||
local rect = xmlCreateChild(svgXML, "rect") | local rect = xmlCreateChild(svgXML, "rect") | ||
xmlNodeSetAttribute(rect, "x", " | |||
xmlNodeSetAttribute(rect, "y", " | local size = math.random(0, 50) | ||
xmlNodeSetAttribute(rect, "width", " | local r, g, b = math.random(10, 99), math.random(10, 99), math.random(10, 99) | ||
xmlNodeSetAttribute(rect, "height", " | |||
xmlNodeSetAttribute(rect, "fill", "# | xmlNodeSetAttribute(rect, "x", (size / 2) .. "%") | ||
xmlNodeSetAttribute(rect, "y", (size / 2) .. "%") | |||
xmlNodeSetAttribute(rect, "width", size .. "%") | |||
xmlNodeSetAttribute(rect, "height", size .. "%") | |||
xmlNodeSetAttribute(rect, "fill", "#" .. r .. g .. b) | |||
-- | -- Aplique nosso XML ao SVG e comece a desenhar via callback | ||
svgSetDocumentXML(svg, svgXML) | |||
end | end | ||
</syntaxhighlight> | </syntaxhighlight> | ||
==Veja também== | ==Veja também== |
Latest revision as of 17:30, 7 November 2024
Define o documento XML subjacente de um elemento SVG.
Sintaxe
bool svgSetDocumentXML ( svg svgElement, xmlnode xmlDocument [, function callback ( bool didLoad ) ] )
Argumentos Necessários
- svgElement: Um elemento svg que você deseja definir o documento XML.
- xmlDocument: Um xmlnode contendo os dados para serem definidos no documento SVG.
Argumentos Opcionais
NOTE: When using optional arguments, you might need to supply all arguments before the one you wish to use. For more information on optional arguments, see optional arguments.
- callback: Uma função de retorno de chamada que é armazenada no SVG e disparada toda vez que a textura do SVG é atualizada (por exemplo, via svgSetSize). Nota: se presente, isso substituirá o retorno de chamada atual armazenado no svg
Retornos
- Retornatrue se for bem sucedido, false caso contrário.
Exemplo
Este exemplo cria um elemento svg incluindo um keybind (F2) para adicionar um nó rect filho, com o uso de uma função de callback para notificar no debugscript quando o SVG foi atualizado.
-- Isso também pode ser um arquivo, com o caminho fornecido para svgCreate local rawSvgData = [[ <svg viewBox="0 0 500 500" xmlns="http://www.w3.org/2000/svg"> <circle cx="250" cy="250" r="250" fill="#0fc0fc" /> </svg> ]] local svgs = {} local function render(svg) if (not isElement(svg)) or (getElementType(svg) ~= "svg") then removeEventHandler("onClientRender", root, svgs[svg].handler) svgs[svg] = nil end local width, height = svgGetSize(svg) dxDrawImage(0, 0, width, height, svg, 0, 0, 0, tocolor(255, 255, 255), false) end local function onUpdate(svg) -- Se esta for a primeira atualização, adicione svg à nossa tabela e comece a desenhá-la if (not svgs[svg]) then svgs[svg] = { state = true, handler = function() render(svg) end } addEventHandler("onClientRender", root, svgs[svg].handler) end iprint("Textura SVG atualizada.", svg, getTickCount()) end local function init() -- Cria um SVG contendo um círculo, usando os dados XML brutos acima local mySvg = svgCreate(500, 500, rawSvgData, onUpdate) -- Vincule uma chave para criar um nó filho SVG rect, que acionará o retorno de chamada onUpdate bindKey("F2", "down", function() addSVGRectNode(mySvg) end) end addEventHandler("onClientResourceStart", resourceRoot, init) -- Adiciona um nó reto ao SVG com cor, tamanho e posição aleatórios function addSVGRectNode(svg) -- Obter o documento XML do nosso SVG local svgXML = svgGetDocumentXML(svg) -- Adicione um nó SVG reto, posicionado no centro do documento local rect = xmlCreateChild(svgXML, "rect") local size = math.random(0, 50) local r, g, b = math.random(10, 99), math.random(10, 99), math.random(10, 99) xmlNodeSetAttribute(rect, "x", (size / 2) .. "%") xmlNodeSetAttribute(rect, "y", (size / 2) .. "%") xmlNodeSetAttribute(rect, "width", size .. "%") xmlNodeSetAttribute(rect, "height", size .. "%") xmlNodeSetAttribute(rect, "fill", "#" .. r .. g .. b) -- Aplique nosso XML ao SVG e comece a desenhar via callback svgSetDocumentXML(svg, svgXML) end
Veja também