PT-BR/SvgSetDocumentXML - Revision history

Fernando187: Remove obsolete Requirements section

2024-11-07T17:30:43Z

Remove obsolete Requirements section

← Older revision		Revision as of 17:30, 7 November 2024
Line 87:		Line 87:
	end		end
	</syntaxhighlight>		</syntaxhighlight>

	~~==Requisitos==~~
	~~{{Requirements\|n/a\|1.5.8-9.20979\|}}~~

	==Veja também==		==Veja também==

LordHenry at 20:15, 1 April 2023

2023-04-01T20:15:06Z

← Older revision		Revision as of 20:15, 1 April 2023
Line 1:		Line 1:
	__NOTOC__		__NOTOC__
	{{BR/~~Funcao cliente~~}}		{{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==

LODS at 01:36, 9 April 2022

2022-04-09T01:36:47Z

← Older revision		Revision as of 01:36, 9 April 2022
Line 17:		Line 17:

	==Exemplo==		==Exemplo==
	~~Esse~~ exemplo ~~mostra como carregar~~ um ~~SVG por dados brutos (ou arquivo), manipulando um documento subjacente e desenhá-lo com~~ [[~~dxDrawImage~~]] ~~via [[onClientRender]]~~		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.

	~~'''IMPORTANTE''': Dependendo da sua implementação~~, o uso de uma função de callback ~~será necessário~~ para ~~garantir que a textura~~ SVG ~~e o documento XML estejam carregados~~.

	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">

LODS at 01:34, 9 April 2022

2022-04-09T01:34:52Z

← Older revision		Revision as of 01:34, 9 April 2022
Line 11:		Line 11:
	===Argumentos Opcionais===		===Argumentos Opcionais===
	{{OptionalArg}}		{{OptionalArg}}
	*'''callback:''' Uma função de ~~callback~~ chamada ~~na criação do documento~~ SVG e ~~na criação da~~ textura, ~~útil para saber~~ se o ~~elemento SVG está carregado.~~		*'''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 ~~dê errado~~.		* Retorna'''true''' se for bem sucedido, '''false''' caso contrário.

	==Exemplo==		==Exemplo==

LODS: Example update

2022-04-09T01:32:34Z

Example update

← Older revision		Revision as of 01:32, 9 April 2022
Line 22:		Line 22:

	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	-- Isso também pode ser um arquivo, com o ~~diretório do arquivo~~ fornecido no svgCreate		-- 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 29:
	]]		]]

	local ~~svg~~		local svgs = {}

	function ~~init~~()		local function render(svg)
	~~-- Cria um círculo em SVG, usando os dados, usando os dados brutos XML acima.~~		if (not isElement(svg)) or (getElementType(svg) ~= "svg") then
	svg ~~= svgCreate~~(~~500, 500, rawSvgData, function~~(~~didLoad~~)		removeEventHandler("onClientRender", root, svgs[svg].handler)
	if (~~not didLoad) then -- Se o SVG falhou em carregar~~, ~~essa função não continuará~~.		svgs[svg] = nil
	~~return~~		end
	end

	~~onSvgLoad~~(svg)		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
	-- ~~Implementando a função de callback para carregar o~~ SVG, ~~em seguida para manipular o documento XML subjacente.~~		function addSVGRectNode(svg)
	function ~~onSvgLoad~~(svg)
	-- Obter o documento XML do nosso SVG		-- Obter o documento XML do nosso SVG
	local svgXML = svgGetDocumentXML(svg)		local svgXML = svgGetDocumentXML(svg)

	-- ~~Adicionar~~ um ~~retangulo~~, ~~posicionando~~ no centro do documento		-- Adicione um nó SVG reto, posicionado no centro do documento
	local rect = xmlCreateChild(svgXML, "rect")		local rect = xmlCreateChild(svgXML, "rect")
	xmlNodeSetAttribute(rect, "cx", "25%")
	xmlNodeSetAttribute(rect, "cy", "25%")		local size = math.random(0, 50)
	xmlNodeSetAttribute(rect, "width", "50%")		local r, g, b = math.random(10, 99), math.random(10, 99), math.random(10, 99)
	xmlNodeSetAttribute(rect, "height", "50%")
	xmlNodeSetAttribute(rect, "fill", "#~~00749b~~")		xmlNodeSetAttribute(rect, "x", (size / 2) .. "%")
			xmlNodeSetAttribute(rect, "y", (size / 2) .. "%")
			xmlNodeSetAttribute(rect, "width", size .. "%")
			xmlNodeSetAttribute(rect, "height", size .. "%")
			xmlNodeSetAttribute(rect, "fill", "#" .. r .. g .. b)

	-- ~~Aplicar o~~ XML ~~para o~~ SVG, e ~~começar~~ a desenhar ~~usando a função de~~ callback		-- Aplique nosso XML ao SVG e comece a desenhar via callback
	~~return~~ svgSetDocumentXML(svg, svgXML~~, function()~~		svgSetDocumentXML(svg, svgXML)
	~~addEventHandler("onClientRender", root, render)~~
	~~end)~~
	~~end~~

	~~function render()~~
	~~local width, height = svgGetSize(svg)~~
	~~dxDrawImage(0, 0, width, height, svg, 0, 0, 0, tocolor(255, 255, 255), false~~)
	end		end
	</syntaxhighlight>		</syntaxhighlight>

LODS at 02:08, 30 March 2022

2022-03-30T02:08:54Z

← Older revision		Revision as of 02:08, 30 March 2022
Line 51:		Line 51:
	-- Adicionar um retangulo, posicionando no centro do documento		-- Adicionar um retangulo, posicionando no centro do documento
	local rect = xmlCreateChild(svgXML, "rect")		local rect = xmlCreateChild(svgXML, "rect")
	xmlNodeSetAttribute(rect, "x", "25%")		xmlNodeSetAttribute(rect, "cx", "25%")
	xmlNodeSetAttribute(rect, "y", "25%")		xmlNodeSetAttribute(rect, "cy", "25%")
	xmlNodeSetAttribute(rect, "width", "50%")		xmlNodeSetAttribute(rect, "width", "50%")
	xmlNodeSetAttribute(rect, "height", "50%")		xmlNodeSetAttribute(rect, "height", "50%")

LODS at 01:42, 30 March 2022

2022-03-30T01:42:09Z

← Older revision		Revision as of 01:42, 30 March 2022
Line 44:		Line 44:


	-- Implementando a função de callback para carregar o SVG, para manipular o documento XML subjacente.		-- Implementando a função de callback para carregar o SVG, em seguida para manipular o documento XML subjacente.
	function onSvgLoad(svg)		function onSvgLoad(svg)
	-- Obter o documento XML do nosso SVG		-- Obter o documento XML do nosso SVG

LODS: /* Veja também */

2022-02-21T17:59:54Z

Veja também

← Older revision		Revision as of 17:59, 21 February 2022
Line 73:		Line 73:

	==Veja também==		==Veja também==
	{{~~SVG_functions~~}}		{{PT-BR/SVG functions}}

	[[en:svgSetDocumentXML]]		[[en:svgSetDocumentXML]]

LODS: Created page with "NOTOC {{BR/Funcao cliente}} {{Added feature/item|1.5.9|1.5.8|20979|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..."

2022-02-20T03:36:13Z

Created page with "__NOTOC__ {{BR/Funcao cliente}} {{Added feature/item|1.5.9|1.5.8|20979|Define o documento XML subjacente de um elemento SVG.}} ==Sintaxe== <syntaxhighlight lang="lua">bool svgSetDocumentXML ( svg svgElement, xmlnode xmlDocument [, function callback ( bool didLoad ) ] )</syntaxhighlight> ===Argumentos Necessários=== *'''svgElement:''' Um elemento svg que você deseja definir o documento XML. *'''xmlDocument:''' Um xmlnode contendo os dados para serem definidos..."

New page

__NOTOC__
{{BR/Funcao cliente}}
{{Added feature/item|1.5.9|1.5.8|20979|Define o documento XML subjacente de um elemento SVG.}}
==Sintaxe==
<syntaxhighlight lang="lua">bool svgSetDocumentXML ( svg svgElement, xmlnode xmlDocument [, function callback ( bool didLoad ) ] )</syntaxhighlight>

===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===
{{OptionalArg}}
*'''callback:''' Uma função de callback chamada na criação do documento SVG e na criação da textura, útil para saber se o elemento SVG está carregado.

===Retornos===
* Retorna'''true''' se for bem sucedido, '''false''' caso dê errado.

==Exemplo==
Esse exemplo mostra como carregar um SVG por dados brutos (ou arquivo), manipulando um documento subjacente e desenhá-lo com [[dxDrawImage]] via [[onClientRender]]

'''IMPORTANTE''': Dependendo da sua implementação, o uso de uma função de callback será necessário para garantir que a textura SVG e o documento XML estejam carregados.

<syntaxhighlight lang="lua">
-- Isso também pode ser um arquivo, com o diretório do arquivo fornecido no 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 svg

function init()
-- Cria um círculo em SVG, usando os dados, usando os dados brutos XML acima.
svg = svgCreate(500, 500, rawSvgData, function(didLoad)
if (not didLoad) then -- Se o SVG falhou em carregar, essa função não continuará.
return
end

onSvgLoad(svg)
end)
end
addEventHandler("onClientResourceStart", resourceRoot, init)

-- Implementando a função de callback para carregar o SVG, para manipular o documento XML subjacente.
function onSvgLoad(svg)
-- Obter o documento XML do nosso SVG
local svgXML = svgGetDocumentXML(svg)

-- Adicionar um retangulo, posicionando no centro do documento
local rect = xmlCreateChild(svgXML, "rect")
xmlNodeSetAttribute(rect, "x", "25%")
xmlNodeSetAttribute(rect, "y", "25%")
xmlNodeSetAttribute(rect, "width", "50%")
xmlNodeSetAttribute(rect, "height", "50%")
xmlNodeSetAttribute(rect, "fill", "#00749b")

-- Aplicar o XML para o SVG, e começar a desenhar usando a função de callback
return svgSetDocumentXML(svg, svgXML, function()
addEventHandler("onClientRender", root, render)
end)
end

function render()
local width, height = svgGetSize(svg)
dxDrawImage(0, 0, width, height, svg, 0, 0, 0, tocolor(255, 255, 255), false)
end
</syntaxhighlight>

==Requisitos==
{{Requirements|n/a|1.5.8-9.20979|}}

==Veja também==
{{SVG_functions}}

[[en:svgSetDocumentXML]]