referenceElement for getEnclosureList()

[Previously asked on the svg-dev mailing list, but no answers. Figure 
it's time to go straight to the horses' mouths.]

SUMMARY
For getEnclosureList and getIntersectionList, are the returned elements 
'below' the reference element in terms of source code (drawn on top of) 
or 'below' the reference element in terms of z-index (appearing earlier 
in source code, drawn underneath the reference element)?


DETAILS
 From the SVG1.1 DOM Interface for SVGSVGElement[1], the
getEnclosureList(...) method takes two arguments:
	rect - "The test rectangle. The values are in the initial coordinate 
system for the current 'svg' element."
	referenceElement - "If not null, then only return elements whose 
drawing order has them below the given reference element."

What does the word 'below' mean in the description above? Does it mean 
'drawn below' (as in lower "z-index"; the elements would be occluded by 
the reference element if it had an opaque fill) or does it mean 
'appears lower in the source code' (i.e. higher z-index, drawn over top 
of the reference element)?

Put another way, is it:
returnedElements.zIndex < referenceElement.zIndex
or
returnedElements.zIndex > referenceElement.zIndex
?


[1] http://www.w3.org/TR/SVG11/struct.html#InterfaceSVGSVGElement
--
Gavin Kistner @ Refinery, Inc.
gavin@refinery.com
work: +1.303.444.1777

Received on Wednesday, 12 November 2003 15:10:36 UTC