f:mediaobject-amend-uri
f:mediaobject-amend-uri — Amend the URI for media objects.
Synopsis
f:mediaobject-amend-uri( | $uri as xs:string) as xs:string |
Description
After the media object URI has been calculated,
f:mediaobject-amend-uri()
is called. This is an opportunity
to update the URI so that the media object will be found.
The default version of this function returns the URI unchanged unless
$mediaobject-grouped-by-type
is true.
If media objects are grouped by type, the media object type is added to the
URI. The media object type is determined by calling
f:mediaobject-type()
.
Suppose, for example, that the calculated URI is
file:///path/to/image.jpg
and the
f:mediaobject-type()
returns “jpeg
”. In that
case, the URI returned will be
file:///path/to/jpeg/image.jpg
.
Consider how this function interacts with
the m:mediaobject-output-adjust
mode. In particular, beware that
the value processed in the
m:mediaobject-output-adjust
mode will already
have been updated by f:mediaobject-amend-uri()
.