SVG_New_image

4D v20

SVG_New_image


SVG_New_image ( objetoSVGPai ; url {; x ; y {; largo ; alto}} ) -> Resultado

Parâmetro	Tipo	Descrição
objetoSVGPai	Ref_SVG	Referencia do elemento pai
url	String	Endereço da imagem
x	Inteiro longo	Coordenada da esquina superior esquerda no eixo X
y	Inteiro longo	Coordenada da esquina superior esquerda no eixo Y
largo	Inteiro longo	Largura da imagem
alto	Inteiro longo	Altura da imagem
Resultado	Ref_SVG	Referencia da imagem

Descrição

O comando SVG_New_image permite referenciar uma imagem no endereço url no recipiente SVG designado por objetoSVGPai e devolve sua referencia. Se objetoSVGPai não é um documento SVG, é gerado um erro.

O parâmetro url especifica a localização da imagem e pode tomar várias formas:

Um URL local (via de acesso da forma: file://…): neste caso, a imagem somente será mostrada se o arquivo é realmente acessível no momento da renderização do objeto. Esta URL local pode ser relativa (da forma: "#Imagens/minhaImagem.png"), neste caso o comando prefixa a via de acesso com a da pasta Resources da base local. Se os parâmetros largo e alto se omitem, serão calculados pelo comando (o qual deve ser evitado já que isto faz que a execução do comando seja mais lenta). No caso de uma via relativa, se não é válida, é gerado um erro.
Uma URL não local (http://meuSite.com/imagens/minhaImagem.jpeg ). Neste caso, não é executada a verificação da valides do link e um erro é gerado se omitidos os parâmetros largo e alto.
Uma URL relativa ("../picture.png"). É particularmente importante em modo cliente/servidor quando os arquivos estão na pasta resources. URLs relativos podem começar por:
- "/", para indicar a rota "~/Resources/SVG/"
- "./", para indicar a rota "~/Resources/"
- "../", para indicar a pasta da base.

Os parâmetros opcionais x e y permitem precisar a posição da esquina superior direita da imagem no recipiente SVG (valor por padrão: 0).

Os parâmetros largo e alto especificam o tamanho do retângulo no qual será mostrada a imagem e assim determinar o tamanho e o rádio de aspecto da imagem. Estes parâmetros só são opcionais no caso de uma imagem referenciada por uma via relativa na pasta Resources da base local. Se largo e/ou alto é igual a 0, a imagem não é renderizada.

Exemplo 1

Localizar a imagem ‘logo4D.png’ localizado na pasta 'Pictures’ da pasta ‘Resources’:

 svgRef:=SVG_New

 objectRef:=SVG_New_image(svgRef;"#Pictures/logo4D.png")

Exemplo 2

Localizar a imagem ‘4dlogo.gif’ acessível no diretório ’pictures’ do site ‘4d.com’:

 svgRef:=SVG_New

 objectRef:=SVG_New_image(svgRef;"http://www.4d.com/pictures/4dlogo.gif";20;20;39;53)

Exemplo 3

Estes são alguns exemplos para acessar a imagens utilizando as URLs relativas:

 SVG_New_image($Dom_svg;"./images/picture.png";10;10)

  // base é a pasta "Resources"

  // o código XML será xlink:href="../images/picture.png"

 SVG_New_image($Dom_svg;"../picture.png";70;180)

  // base é a pasta da base

  // XML code will be xlink:href="../../picture.png"

 SVG_New_image($Dom_svg;"/sample pictures/picture.png";110;90;100;100)

  // base é a pasta "SVG" na pasta "Resources"

  // o código XML será xlink:href="sample%20pictures/picture.gif"

Ver também

SVG_New_embedded_image
SVG_Open_picture