Element: graphic_window.bleed

Type

numeric

Description

A pixel increment for use when deciding whether instance entities should be procssed during a re-paint of the window.

An instance entity, which is a references to an entity file, has an inherent MBR (minimum bounding rectangle) encompassing the entities within it. Only when this MBR clashes with the window extents is the instance entity processed, i.e. drawn.

Sometimes an entity with pixel-height dimensions can overflow the MBR of its instance parent depending on the view scale. This can lead to an entity not being rendered because its parent instance does not get processed, so setting a bleed factor has the effect of extending instance MBRs for clash detection purposes.

A typical example involves node entities with pixel-height image file markerstyles. When they lie very close to the edge of their instance entity parent's MBR, they sometimes get omitted when the window is repainted. If such pixel-height markerstyles have a typical dimension of 32x32 pixels, then a bleed factor of 32 will ensure that they are always drawn. Similarly polylines with a thickness of 10 pixels, will sometimes get omitted when they run very close to the edge of the instance MBR. A bleed factor of 10 will certainly ensure their visibility at all scales.

The bleed factor is always a measurement in screen pixels, not in world units. For new windows, the .bleed value is 0.

See Also

Commands:

get