PT-BR/svgSetSize: Difference between revisions
Jump to navigation
Jump to search
(Update usage & examples as per GitHub PR #2589) |
|||
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=== | ||
Line 17: | Line 17: | ||
==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 | local svgs = {} | ||
function | 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 | 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 | end | ||
function | 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 | ||
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) .. "%") | |||
end | 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 | |||
</syntaxhighlight> | </syntaxhighlight> | ||
Revision as of 01:39, 9 April 2022
Template:BR/Funcao cliente Define o documento XML subjacente de um elemento SVG.
Sintaxe
bool svgSetSize( svg svgElement, int width, int height [, function callback ( bool didLoad ) ] )
Argumentos Necessários
- svgElement: O elemento svg que você deseja definir o tamanho.
- width: Largura, de preferência em potência de dois (16, 32, 64 etc.), o máximo é 4096
- height : Altura, de preferência em potência de dois (16, 32, 64 etc.), o máximo é 4096
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
- Retorna true se for bem sucedido, false caso dê errado.
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
Requisitos
This template will be deleted.
Veja também