4D Doc Center : SVG_New

4D v13

SVG_New_image


SVG_New_image ( parentSVGObject ; url {; x ; y {; width ; height}} ) -> Function result

Parameter	Type	Description
parentSVGObject	SVG_Ref	Reference of parent element
url	String	Address of picture
x	Longint	Coordinate on X axis of upper left corner
y	Longint	Coordinate on Y axis of upper left corner
width	Longint	Width of picture
height	Longint	Height of picture
Function result	SVG_Ref	SVG object reference

Description

The SVG_New_image command can be used to reference a picture at the url address in the SVG container designated by parentSVGObject and returns its reference. If parentSVGObject is not an SVG document, an error is generated.

The url parameter specifies the location of the picture and can take several forms:

A local URL (a pathname in the form: file://…): in this case, the picture will only be displayed if the file is actually accessible at the time the picture is rendered. This local URL can be relative (in the form: “#Pictures/myPicture.png”); in this case the command prefixes the pathname with that of the Resources folder of the host database. If the width and height parameters are omitted, they will be calculated by the command (to be avoided since this is slower than when the sizes are known). In the case of a relative path, if it is not valid, an error is generated.
A non-local URL (http://mySite.com/pictures/myPicture.jpeg ). In this case, no verification is carried out concerning the validity of the link and an error will be generated if the width and height parameters are omitted.

The optional x and y parameters can be used to specify the position of the upper left corner of the picture in the SVG containers (default value 0).

The width and height parameters specify the size of the rectangle in which the picture will be displayed and thus determine the size and aspect ratio of the picture. These parameter are only optional in the case of a picture referenced by a relative path in the Resources folder of the host database. If width and/or height equal 0 then the picture is not rendered.

Example 1

Place the ‘logo4D.png’ picture located in the ‘Pictures’ folder of the ‘Resources’ folder:

 svgRef:=SVG_New

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

Example 2

Place the ‘4dlogo.gif’ picture that can be accessed in the ’pictures’ directory of the ‘4d.com’ site:

 svgRef:=SVG_New

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