filterEffect: Creating Filter Effects

View source: R/filters.R

filterEffectR Documentation

Creating Filter Effects

Description

Create objects which describe filter effects. These objects can be used to add filter effect primitives. They can be used to apply a filter effect to grobs and also to define a filter effect so that it may be used multiple times.

Usage

filterEffect(feList = NULL, filterUnits = c("coords", "bbox"),
             x = unit(0.5, "npc"), y = unit(0.5, "npc"),
             width = unit(1, "npc"), height = unit(1, "npc"),
             just = "centre", hjust = NULL, vjust = NULL,
             default.units = "npc",
             primitiveUnits = c("coords", "bbox"))
addFilterEffect(filter, filterEffect, after = NA)

Arguments

feList

A list of filter effect primitives. For example a list containing a gaussian blur primitive created by feGaussianBlur.

filterUnits

If "bbox", the filter effect itself is positioned relative to the bounding box of the referring grob. All units attempt to be converted to equivalent "npc" coordinates as a reulst.

If "coords", uses grid coordinates to determine positioning.

x

A numeric vector or unit object specifying x-location.

y

A numeric vector or unit object specifying y-location.

width

A numeric vector or unit object specifying width.

height

A numeric vector or unit object specifying height.

just

The justification of the pattern relative to its (x, y) location. If there are two values, the first value specifies horizontal justification and the second value specifies vertical justification. Possible string values are: "left", "right", "centre", "center", "bottom", and "top". For numeric values, 0 means left alignment and 1 means right alignment.

hjust

A numeric vector specifying horizontal justification. If specified, overrides the just setting.

vjust

A numeric vector specifying vertical justification. If specified, overrides the just setting.

default.units

A string indicating the default units to use if x, y, width, or height are only given as numeric vectors.

primitiveUnits

If "bbox", all filter effect primitives will be positioned relative to the bounding box of the filter effect region (determined by x, y, width, height and filterUnits). All units attempt to be converted to equivalent "npc" coordinates.

If "coords", uses grid coordinates to determine positioning.

filter

A filter effect container object, as created by filterEffect.

filterEffect

A filter effect primitive object.

after

Numeric. Determines where amongst the children of filter that filterEffect should be added. NA indicates that filterEffect should be appended to the end of the list of children.

Details

This is primarily a container object to hold filter effect primitives.

Value

A filter object.

Author(s)

Simon Potter

References

https://www.w3.org/TR/SVG/filters.html#FilterElement

See Also

Any of the filter effect primitives (named fe*), e.g. feGaussianBlur.


gridSVG documentation built on March 31, 2023, 11:17 p.m.