69. setImage

Parameter syntax:

[attribute_name|'-']? ['anyURI'|'hexBinary'|'base64Binary'|'XML'|'-']?
    ['gzip'|'-']? [URL_or_file]?

Changes the image represented by explicitly selected element. See also setObject.

attribute_name

This parameter specifies the name of the attribute containing the URL of the image file or directly containing the image data encoded in 'hexBinary' or in 'base64Binary'.

If this parameter is absent (or is '-'), it is the selected element itself which contains the image URL or which directly contains the image data in 'hexBinary', in 'base64Binary' or in XML formats.

anyURI, hexBinary, base64Binary, XML

Specifies how the image is to be ``stored'' in the element or in the attribute. Data type 'XML' is only allowed for elements (typically an svg:svg element).

If this parameter is absent (or is '-'), the data type is found using the grammar of the document. Of course, this cannot be guessed for documents conforming to a DTD (too weakly typed) and for invalid documents conforming to a W3C XML Schema.

gzip

If this parameter is specified, image data is compressed with gzip before being encoded in 'hexBinary' or in 'base64Binary'.

This parameter is ignored for 'anyURI' and 'XML' data types.

If this parameter is absent (or is '-'), data is not compressed before being encoded.

URL_or_file

Specifies the source of image data.

If this parameter is absent, a chooser dialog box is displayed to let the user specify which image file to use.

Examples:

setImage
setImage fileref anyURI
setImage - hexBinary gzip
setImage location - - file://localhost/icons/apache_pb.gif
setImage - XML - C:\graphics\logo.svgz