4D v14

SVG_New_image

Página Inicial

 
4D v14
SVG_New_image

SVG_New_image 


 

SVG_New_image ( objetoSVGPai ; url {; x ; y {; largo ; alto}} ) -> Resultado 
Parâmetro Tipo   Descrição
objetoSVGPai  SVG_Ref in Referencia do elemento pai
url  cadeia in Endereço da imagem
Inteiro longo in Coordenada da esquina superior esquerda no eixo X
Inteiro longo in Coordenada da esquina superior esquerda no eixo Y
largo  Inteiro longo in Largura da imagem
alto  Inteiro longo in Altura da imagem
Resultado  SVG_Ref in Referencia da imagem

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.

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

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

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)

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"

 
PROPRIEDADES 

Produto: 4D
Tema: Desenho
Número 65969

 
HISTÓRIA 

New
Criado por: Composant 4D SVG v11.3
Modificado: 4D v14

 
VER TAMBÉM 

SVG_New_embedded_image
SVG_Open_picture

 
ARTICLE USAGE

4D SVG ( 4D v14)

Inherited from : SVG_New_image ( 4D v13)