Filter Effects Module Level 1

`省略-時の既定~値$は `0px^v とする。 ◎ Default value when omitted is 0px. ◎ The initial value for interpolation is 0px.

注記：標準偏差は、 `box-shadow$p のボカシ半径とは異なる。 ◎ Note: Standard deviation is different to box-shadow s blur radius.

~Gaussianボカシ用の`~ink~overflow区画$は、実装が描くボカシが占める領域になるとする（`~ink~overflow矩形$は、それに基づく）。 ◎ The ink overflow rectangle for a Gaussian blur is the axis-aligned boundary of the area in which the implementation draws the blur.

注記：本当の~Gaussianボカシは，理論~的には無限な拡がりであるが、実施においては，すべての実装は，有限な区画による近似を利用する。これを書いた時点（ 2024年 1 月）では、主要なすべての実装は，馴染みな `three-pass^en 【 “3 階” 】 ~boxボカシによる近似を利用する — その拡がりは ⇒ ( ( 3 ~MUL `sqrt^op( 2 ~MUL π ) ~DIV 4 ) ~MUL σ【標準偏差】 ) ◎ Note: A true Gaussian blur has theoretically infinite extent, but in practice all implementations use a finite-area approximation of a Gaussian blur. At the time of writing (January 2024) all major implementations use the familiar three-pass box blur approximation, which has extent: ((3 * sqrt(2 * π) / 4) * σ).

`brightness@f = brightness( [ `number$t | `percentage$t ]? )

入力~画像の明るさ（ `brightness^en ）を変える。値 `0%^v は完全に黒の画像を作成させる。値 `100%^v は入力を変更しない。他の値による効果は線型になる。 100% を超える値も許容され、より明るくする。 ◎ Applies a linear multiplier to input image, making it appear more or less bright. A value of 0% will create an image that is completely black. A value of 100% leaves the input unchanged. Other values are linear multipliers on the effect. Values of amount over 100% are allowed, providing brighter results.＼

この関数に等価な~markupは、 `§ 原始filter表現の中で与えられる＠#brightnessEquivalent$。【したがって、~alpha成分は変わらないことになる。】 ◎ The markup equivalent of this function is given below.

`省略-時の既定~値$は `1^v とする。 ◎ Default value when omitted is 1. ◎ The initial value for interpolation is 1.

`contrast@f = contrast( [ `number$t | `percentage$t ]? )

入力の~contrastを調整する。値 `0%^v は完全に~grayな画像を作成することになる。値 `100%^v は入力を変更しない。 100% を超える値も許容され、より~contrastが~~高い結果を供する。 ◎ Adjusts the contrast of the input. A value of 0% will create an image that is completely gray. A value of 100% leaves the input unchanged. Values of amount over 100% are allowed, providing results with more contrast.＼

この関数に等価な~markupは、 `§ 原始filter表現の中で与えられる＠#contrastEquivalent$。 ◎ The markup equivalent of this function is given below.

`省略-時の既定~値$は `1^v とする。 ◎ Default value when omitted is 1. ◎ The initial value for interpolation is 1.

`drop-shadow@f = drop-shadow( [ `color$t? && `length$t{2,3} ] )

入力~画像に落影~効果を適用する。落影は、実質的に，［入力~画像の~alpha~maskを，特定0の色で描いて, ボカして, ~offsetしたもの］であって，当の画像の下に組成されるものである。値は `box-shadow$p `CSS3BG$r に対するときと同じに解釈されるが、省略可能な 3 個目の `length$t 値は、 `ボカシ半径$に代えて標準偏差を与える。 ◎ Applies a drop shadow effect to the input image. A drop shadow is effectively a blurred, offset version of the input image’s alpha mask drawn in a particular color, composited below the image. Values are interpreted as for box-shadow [CSS3BG] but with the optional 3rd <length> value being the standard deviation instead of blur radius.＼

この関数に等価な~markupは、 `§ 原始filter表現の中で与えられる＠#dropshadowEquivalent$。 ◎ The markup equivalent of this function is given below.

`省略-時の既定~値$は［ `length^t はすべて `0^v ／ `color^t は `color$p ~propからとる］とする。 ◎ The default value for omitted values is missing length values set to 0 and the missing used color is taken from the color property.

`補間~用の初期~値$は［ `length^t はすべて `0^v ／ `color^t は `transparent^v ］とする。 ◎ The initial value for interpolation is all length values set to 0 and the used color set to transparent.

この~levelの仕様では、［ `拡幅~距離$／複数の影］は受容されないことに注意。 ◎ Note: Spread values or multiple shadows are not accepted for this level of the specification.

注記：標準偏差は、 `box-shadow$p のボカシ半径とは異なる。 ◎ Note: Standard deviation is different to box-shadow s blur radius.

落影~用の`~ink~overflow矩形$は、 `blur$f 用に述べたとおり， ~offsetが成す拡がりにボカシ（もしあれば）が成す拡がりを加えたものになる。 ◎ The ink overflow rectangle for a drop shadow is the extent of the offsets, plus the extent of the blur (if any) as described for <blur()>.

`grayscale@f = grayscale( [ `number$t | `percentage$t ]? )

入力~画像を~grayscaleに変換する。 ~parameterは、変換の比率を定義する。値 `100%^v は、完全に~grayscaleになる。値 `0%^v は入力を変更しない。他の値による効果は線型になる。 `100%^v を超える値も許容されるが、 ~UAは値を `1^v に切詰めるモノトスル。 ◎ Converts the input image to grayscale. The passed parameter defines the proportion of the conversion. A value of 100% is completely grayscale. A value of 0% leaves the input unchanged. Values between 0% and 100% are linear multipliers on the effect. Values of amount over 100% are allowed but UAs must clamp the values to 1.＼

この関数に等価な~markupは、 `§ 原始filter表現の中で与えられる＠#grayscaleEquivalent$。 ◎ The markup equivalent of this function is given below.

`省略-時の既定~値$は `1^v とする。 ◎ Default value when omitted is 1.

`補間~用の初期~値$は `0^v とする。 ◎ The initial value for interpolation is 0.

`hue-rotate@f = hue-rotate( [ `angle$t | `zero$t ]? )

入力~画像に色相~回転を適用する。 ~parameterは、色環の周における，入力~sampleを調整する度数を定義する。値 `0deg^v は入力を変更しない。 `360deg^v を超える~animationを許容するため、実装は，この値を【例えば 0 以上〜 360 未満に】正規化しないモノトスル。 ◎ Applies a hue rotation on the input image. The passed parameter defines the number of degrees around the color circle the input samples will be adjusted. A value of 0deg leaves the input unchanged. Implementations must not normalize this value in order to allow animations beyond 360deg.＼

この関数に等価な~markupは、 `§ 原始filter表現の中で与えられる＠#huerotateEquivalent$。 ◎ The markup equivalent of this function is given below.

`angle$t が 0 の場合、単位~識別子は省略されてもヨイ。 ◎ The unit identifier may be omitted if the <angle> is zero.

`省略-時の既定~値$は `0deg^v とする。 ◎ Default value when omitted is 0deg. ◎ The initial value for interpolation is 0deg.

`invert@f = invert( [ `number$t | `percentage$t ]? )

入力~画像~内の~sampleを反転する。 ~parameterは変換の比率を定義する。値 100% は完全に反転する。値 `0%^v は入力を変更しない。他の値による効果は線型になる。 `100%^v を超える値も許容されるが、 ~UAは値を `1^v に切詰めるモノトスル。 ◎ Inverts the samples in the input image. The passed parameter defines the proportion of the conversion. A value of 100% is completely inverted. A value of 0% leaves the input unchanged. Values between 0% and 100% are linear multipliers on the effect. Values of amount over 100% are allowed but UAs must clamp the values to 1.＼

この関数に等価な~markupは、 `§ 原始filter表現の中で与えられる＠#invertEquivalent$。 ◎ The markup equivalent of this function is given below.

`省略-時の既定~値$は `1^v とする。 ◎ Default value when omitted is 1.

`補間~用の初期~値$は `0^v とする。 ◎ The initial value for interpolation is 0.

`opacity@f = opacity( [ `number$t | `percentage$t ]? )

入力~画像~内の~sampleに透明度を適用する。 ~parameterは、変換の比率を定義する。値 `0%^v は完全に透明になる。値 `100%^v は入力を変更しない。他の値による効果は線型になる。これは、入力~画像の~sampleをその量で乗算することと等価になる。 `100%^v を超える値も許容されるが、 ~UAは値を `1^v に切詰めるモノトスル。 ◎ Applies transparency to the samples in the input image. The passed parameter defines the proportion of the conversion. A value of 0% is completely transparent. A value of 100% leaves the input unchanged. Values between 0% and 100% are linear multipliers on the effect. This is equivalent to multiplying the input image samples by amount. Values of amount over 100% are allowed but UAs must clamp the values to 1.＼

この関数に等価な~markupは、 `§ 原始filter表現の中で与えられる＠#opacityEquivalent$。 ◎ The markup equivalent of this function is given below.

`省略-時の既定~値$は `1^v とする。 ◎ Default value when omitted is 1. ◎ The initial value for interpolation is 1.

注記：不透明度~filter関数は、 `opacity$p ~propの略式になるものと意味されていない。さらには、次の原始filterに渡す前に，中間~原始filter結果の透明度を設定できるようにする。不透明度~filter関数が最後の原始filterとして設定された場合、 `opacity$p ~propの値はその最後の結果に乗算され，より透明な内容になり得る。 ◎ Note: The opacity filter function is not meant to be a shorthand of the opacity property. Furthermore, it allows setting the transparency of intermediate filter primitive results before passing to the next filter primitive. If the opacity filter function is set as last filter primitive, the value of the opacity property is multiplied on top of the value of the filter function, which may result in a more transparent content.

`saturate@f = saturate( [ `number$t | `percentage$t ]? )

入力~画像の彩度を変える。 ~parameterは、変換の比率を定義する。値 `0%^v は彩度なしにする。値 `100%^v は入力を変更しない。他の値による効果は線型になる。 `100%^v を超える値も許容され、彩度をさらに上げる。 ◎ Saturates the input image. The passed parameter defines the proportion of the conversion. A value of 0% is completely un-saturated. A value of 100% leaves the input unchanged. Other values are linear multipliers on the effect. Values of amount over 100% are allowed, providing super-saturated results.＼

この関数に等価な~markupは、 `§ 原始filter表現の中で与えられる＠#saturateEquivalent$。 ◎ The markup equivalent of this function is given below.

`省略-時の既定~値$は `1^v とする。 ◎ Default value when omitted is 1. ◎ The initial value for interpolation is 1.

`sepia@f = sepia( [ `number$t | `percentage$t ]? )

入力~画像を~sepiaに変換する。 ~parameterは、変換の比率を定義する。値 `100%^v は完全に~sepiaにする。値 `0%^v は入力を変更しない。他の値による効果は線型になる。 `100%^v を超える値も許容されるが、 ~UAは値を `1^v に切詰めるモノトスル。 ◎ Converts the input image to sepia. The passed parameter defines the proportion of the conversion. A value of 100% is completely sepia. A value of 0% leaves the input unchanged. Values between 0% and 100% are linear multipliers on the effect. Values of amount over 100% are allowed but UAs must clamp the values to 1.＼

この関数に等価な~markupは、 `§ 原始filter表現の中で与えられる＠#sepiaEquivalent$。 ◎ The markup equivalent of this function is given below.

`省略-時の既定~値$は `1^v とする。 ◎ Default value when omitted is 1.

`補間~用の初期~値$は `0^v とする。 ◎ The initial value for interpolation is 0.

6.2. ~filter関数の算出d値

`filter-function$t 内の値は、次の例外を除き，指定d値に算出される： ◎ The values in a <filter-function> are computed as specified, with these exceptions:

値が省略された場合、 `省略-時の既定~値$に算出された上で含められる。 ◎ Omitted values are included and compute to their defaults.
`drop-shadow$f は、次の順の並びになる ⇒ `color$t の算出d値, `length$t の算出d値 ◎ <drop-shadow()> starts with the computed value of <color> followed by the computed value of the <length> values.

6.3. ~filter関数の直列化

`filter-function$t を直列化するときは、個々の文法にしたがって，次のように直列化する ⇒＃文法に書かれた順序で, 引数は指定されたままに, アリな所では `calc$f 式を避けて, アリな所では `calc$f 変形nを避けて, ~space等で分離された~tokenは 1 個の~spaceで連結して, 直列化された各~commaには 1 個の~spaceを後続させる ◎ To serialize the <filter-function>, serialize as per their individual grammars,＼ in the order the grammars are written in,＼ avoiding <calc()> expressions where possible,＼ serialize filter arguments as specified, avoiding <calc()> transformations,＼ joining space-separated tokens with a single space,＼ and following each serialized comma with a single space.

6.4. ~filter関数の補間

`filter-function$t どうし補間では、その種別に応じて［次に従って，互いの引数を補間する］モノトスル： ◎ For interpolation of values in <filter-function>s, the steps corresponding to the first matching condition in the following list must be run:

`blur$ft: `長さ$aTとして補間する†。 ◎ Interpolate values as length.
`brightness$ft
`contrast$ft
`grayscale$ft
`invert$ft
`opacity$ft
`saturate$ft
`sepia$ft: 先ず，百分率~値は 0% 〜 100% を 0 〜 1 に線型に変換した上で、 `実数$aTとして補間する†。 ◎ Convert percentage values to numbers with 0% being relative to 0 and 100% relative to 1. Interpolate values number.
`hue-rotate$ft: `実数$aTとして補間する†。 ◎ Interpolate values as number.
`drop-shadow$ft: `影~list$aTとして補間する†。 ◎ Interpolate values as shadow list.

【† 原文による参照は［別の仕様（ CSS Transition ）の過去~versionに定義されていたが、現在は廃され，存在しない定義］を指しているので、この訳では新たな定義を指すように修正している。】

7. ~SVG~filter~source： `filter^e 要素

◎要素名 `filter@e ◎分類なし。 ◎内容任意個数, 任意順序の，次に挙げる要素 ⇒＃ `記述的~要素$, `原始filter要素$, `animate$e, `script$e, `set$e ◎属性 `中核~属性$, `呈示~属性$, `class$a, `style$a, `externalResourcesRequired$a, `x$aF, `y$aF, `width$aF, `height$aF, `filterUnits$aF, `primitiveUnits$aF ◎界面 `SVGFilterElement$I ◎表終

`filter$e 要素の記述は、次に従う： ◎ The description of the filter element follows:

`~filter領域$を見よ。 ◎ See filter region.

`filterUnits@aF = "`userSpaceOnUse@v | `objectBoundingBox@v"

`primitiveUnits@aF = "`userSpaceOnUse@vPU | `objectBoundingBox@vPU"

`原始filter$の中の種々の長さ値, および `原始filter下位領域$を定義する属性用の座標系を指定する — `filter$p ~propを介して `filter$e 要素を参照している要素を %E で表すとするとき： ◎ Specifies the coordinate system for the various length values within the filter primitives and for the attributes that define the filter primitive subregion.

値 `userSpaceOnUse$vPU にされた場合 ⇒ ~filter定義の中のどの長さ値も， `filter$e 要素が参照された［とき, 所］における現在の`局所~座標系$ — すなわち、 %E 用の利用元~座標系 — における値を表現する。 ◎ If primitiveUnits is equal to userSpaceOnUse, any length values within the filter definitions represent values in the current local coordinate system in place at the time when the filter element is referenced (i.e., the user coordinate system for the element referencing the filter element via a filter property).
値 `objectBoundingBox$vPU にされた場合 ⇒ ~filter定義の中のどの長さ値も %E の限界~boxに対する［割合分／百分率］を表現する（`~obj限界~box単位$を見よ）。 ~~対象になる長さ値が `number-optional-number$t 値から与えられていて，値に `number$t が 1 個だけ指定されていた場合、 2 個目の値は， `primitiveUnits$aF が算出される前に~~補填されることに注意。 ◎ If primitiveUnits is equal to objectBoundingBox, then any length values within the filter definitions represent fractions or percentages of the bounding box on the referencing element (see object bounding box units). Note that if only one number was specified in a <number-optional-number> value this number is expanded out before the primitiveUnits computation takes place.

以下では、この座標系 — すなわち、 `filter$e 要素の `primitiveUnits$aF 属性により確立される座標系 — を指して， `~filter座標系@ と~~略記する。【この用語は、他所を簡潔に述べるため，この訳にて導入している。】

`初期~値$は `userSpaceOnUse$vPU とする。 ◎ The initial value for primitiveUnits is userSpaceOnUse.

これらについては、 `~filter領域$を見よ。 ◎ See filter region.

`x@aF = "`length-percentage$t"

`y@aF = "`length-percentage$t"

`width@aF = "`length-percentage$t"

`height@aF = "`length-percentage$t"

`filterRes@aF = "`number-optional-number$t"

この属性は、この仕様から除去された。その定義は `SVG11$r を見よ。 ◎ The filterRes attribute was removed from the specification. See SVG 1.1 specification for the defintion [SVG11].

`filter$e 要素は、先祖から~propを継承するが， `filter$e 要素を参照している要素からは継承しない。 ◎ Properties inherit into the filter element from its ancestors; properties do not inherit from the element referencing the filter element.

`filter$e 要素は、直に描画されることは決してない。その用途は `filter$p ~propを利用して参照できる何かとしてに限られる。 `display$p ~propは `filter$e 要素には適用されないので、［ `filter$e 要素, およびその先祖］の `display$p ~propの値が何であれ、 `filter$e 要素は，直に描画されることはなく, また参照~用に可用になる。 ◎ filter elements are never rendered directly; their only usage is as something that can be referenced using the filter property. The display property does not apply to the filter element; thus, filter elements are not directly rendered even if the display property is set to a value other than none, and filter elements are available for referencing even when the display property on the filter element or any of its ancestors is set to none.

8. ~filter領域

`filter$e 要素は、所与の~filterによる効果を適用する `~filter領域@ を，~canvas上に定義することもある。また、階調が連続的な中間~画像~用に，解像度を供することもある — それは、 ~rasterに基づく`原始filter$を処理するときに利用される。 `filter$e 要素は、次に挙げる属性を有する — それらは、共に働いて~filter領域を定義する： ◎ A filter element can define a filter region on the canvas to which a given filter effect applies and can provide a resolution for any intermediate continuous tone images used to process any raster-based filter primitives. The filter element has the following attributes which work together to define the filter region:

`filterUnits$aF: `x$aF, `y$aF, `width$aF, `height$aF 属性~用の座標系を定義する。この座標系は、属性の値［ `userSpaceOnUse$v ／ `objectBoundingBox$v ］に応じて，`~filter座標系$と同様に — すなわち `primitiveUnits$aF 属性の同じ名前の値［ `userSpaceOnUse$vPU ／ `objectBoundingBox$vPU ］と同様 — に定義される。 ◎ Defines the coordinate system for attributes x, y, width, height. ◎ If filterUnits is equal to userSpaceOnUse, x, y, width, height represent values in the current user coordinate system in place at the time when the filter element is referenced (i.e., the user coordinate system for the element referencing the filter element via a filter property). ◎ If filterUnits is equal to objectBoundingBox, then x, y, width, height represent fractions or percentages of the bounding box on the referencing element (see object bounding box units).; `初期~値$は `objectBoundingBox$v とする。 ◎ The initial value for filterUnits is objectBoundingBox.; ~animate可能。 ◎ Animatable: yes.
`x$aF, `y$aF, `width$aF, `height$aF: これらの属性は、この~filterを適用する~canvas上の矩形な領域を定義する。 ◎ These attributes define a rectangular region on the canvas to which this filter applies.; これらの属性~用の座標系は、属性 `filterUnits$aF 値から与えられる。 ◎ The coordinate system for these attributes depends on the value for attribute filterUnits.; この矩形な限界域は、当の `filter$e 要素に含まれる`原始filter$すべてに対する切抜き領域として動作する — すなわち、原始filterの効果がこの限界域を超えて拡がる場合（これは、大きい `stdDeviation$aGB を伴う `feGaussianBlur$e 原始filterを利用したときに起こり得る）、超えた部位は切取られることになる。 ◎ The bounds of this rectangle act as a hard clipping region for each filter primitive included with a given filter element; thus, if the effect of a given filter primitive would extend beyond the bounds of the rectangle (this sometimes happens when using a feGaussianBlur filter primitive with a very large stdDeviation), parts of the effect will get clipped.; `x$aF, `y$aF 用の`初期~値$は `-10%^v とする。 ◎ The initial value for x and y is -10%.; `width$aF, `height$aF 用の`初期~値$は `120%^v とする。 ◎ The initial value for width and height is 120%. ◎ ＊誤記？ ng of the element which referenced the filter.; ~animate可能。 ◎ Animatable: yes.

注記： `filterUnits$aF の値がどちらであれ、結果の`~filter領域$の座標系の［ ~X ／ ~Y ］軸は，［ ~filterの適用-先になる要素~用の`局所~座標系$ ］の［ ~X ／ ~Y ］軸に平行になる。 ◎ Note: Both of the two possible value for filterUnits (i.e., objectBoundingBox and userSpaceOnUse) result in a filter region whose coordinate system has its X-axis and Y-axis each parallel to the X-axis and Y-axis, respectively, of the local coordinate system for the element to which the filter will be applied.

注記： ~filter領域を機器~画素に直に対応付けれる場合、実装者は，より高速な処理能を達成できることもある。したがって作者には、表示-機器に最良な処理能を得るためには［ ~UAが`~filter領域$の画素~格子が背景のそれに整列できるよう，それらの領域を定義する］ことが示唆される。特に，最良な~filter効果~処理能を得るためには、利用元~座標系を［回転する／斜傾する］のは避けるように。 ◎ Note: Sometimes implementers can achieve faster performance when the filter region can be mapped directly to device pixels; thus, for best performance on display devices, it is suggested that authors define their region such that the user agent can align the filter region pixel-for-pixel with the background. In particular, for best filter effects performance, avoid rotating or skewing the user coordinate system.

注記： ~filter効果は，所与の~objが緊密に収まる`限界~box$よりほんの少し外側に影響iすることもあるので、その分の追加空間が必要yなことも多い。この目的で、 ~filter領域の［ `x$aF, `y$aF ／ `width$aF, `height$aF ］用に［ `0%^v 未満の／ `100%^v を超える］百分率~値を供することもアリである — それが、これらに対する既定が［ `-10%^v ／ `120%^v ］にされている~~理由でもある。 ◎ Note: It is often necessary to provide padding space because the filter effect might impact bits slightly outside the tight-fitting bounding box on a given object. For these purposes, it is possible to provide negative percentage values for x, y and percentages values greater than 100% for width, height. This, for example, is why the defaults for the filter region are x="-10%" y="-10%" width="120%" height="120%".

9. 原始filter

9.1. 概観

この節では、特定0の~filter効果を達成するために組立てれる，種々の原始filterを述べる。 ◎ This section describes the various filter primitives that can be assembled to achieve a particular filter effect.

他が言明されない限り、すべての画像~filterは，乗算済み~RGBA~sample上で演算する。［ `feColorMatrix$e, `feComponentTransfer$e ］の様な一部の~filterは、乗算済みでない~data上でより自然に働く。各~filter演算の時点では、すべての色~値は，現在の~filterに要求される色~乗算に一時的に変形するモノトスル。 ◎ Unless otherwise stated, all image filters operate on premultiplied RGBA samples. Some filters like feColorMatrix and feComponentTransfer work more naturally on non-premultiplied data. For the time of the filter operation, all color values must temporarily be transformed to the required color multiplication of the current filter.

注記：すべての入力~画像は、乗算済み~RGBA内にあると見做される。 ~UAは、乗算済みでない~dataを~bufferして，処理能を最適化してもヨイ。 ◎ Note: All input images are assumed to be in premultiplied RGBA. User agents may optimize performance by using non-premultiplied data buffering.

~filterを施す演算のうち，~raster効果を成すものは、 1 個~以上の入力~RGBA画像, および ~parameterとして追加的な属性をとり，単独の出力~RGBA画像を生産する。 ◎ All raster effect filtering operations take 1 to N input RGBA images, additional attributes as parameters, and produce a single output RGBA image.

各~原始filterからの~RGBA結果は、［色／不透明度］値~用に許容-可能な範囲~内に切詰められることになる。したがって例えば、［所与の`原始filter$からの結果］における負な［色／不透明度］値は， 0 に調整されることになる。 ◎ The RGBA result from each filter primitive will be clamped into the allowable ranges for colors and opacity values. Thus, for example, the result from a given filter primitive will have any negative color values or opacity values adjusted up to color/opacity of zero.

各`原始filter$の演算は、それぞれの `color-interpolation-filters$p ~propの値から決定される色~空間において遂行される。それとは異なる `color-interpolation$p ~propは、他の色~演算~用の色~空間を決定する。これら 2 つの~propの初期~値は異なるので（前者は `linearRGB$v, 後者は `sRGB^v ）、事例によっては，一定の結果を達成するためには（例：~gradient補間と~filterを施す演算とを協調させるとき）、明示的に，前者を `sRGB$v に, あるいは後者を `linearRGB^v に設定することも必要yである。下の例では、この両~propとも明示的に設定していないので，それぞれの初期~値が適用されることに注意。 ◎ The color space in which a particular filter primitive performs its operations is determined by the value of the property color-interpolation-filters on the given filter primitive. A different property, color-interpolation determines the color space for other color operations. Because these two properties have different initial values (color-interpolation-filters has an initial value of linearRGB whereas color-interpolation has an initial value of sRGB), in some cases to achieve certain results (e.g., when coordinating gradient interpolation with a filtering operation) it will be necessary to explicitly set color-interpolation to linearRGB or color-interpolation-filters to sRGB on particular elements. Note that the examples below do not explicitly set either color-interpolation or color-interpolation-filters, so the initial values for these properties apply to the examples.

`原始filter$による結果の画素は未定義になることもある。例えば原始filter `feOffset$e は、画像を右下へズラすので，［上端／左端］にある画素は未定義なままにされ得る。これらの事例における未定義な画素は、 `透明な黒$に設定される。 ◎ Sometimes filter primitives result in undefined pixels. For example, filter primitive feOffset can shift an image down and to the right, leaving undefined pixels at the top and left. In these cases, the undefined pixels are set to transparent black.

高品質な描画を供するためには、すべての原始filterは，機器に依存する座標~空間~内で［機器~画素~密度, 利用者~空間の変形n, 拡縮表示］を織り込んだ上で，演算するべきである — この空間は、 `演算-時の座標~空間@ と称される。 ~platformに依存しない整列を供するためとして、［属性／~prop ］の値は，`~filter座標系$に相対的になることが多い。 ~UAは、そのような相対的な値を`演算-時の座標~空間$に拡縮するモノトスル。 ◎ To provide high quality rendering, all filter primitives should operate in a device dependent coordinate space, the operating coordinate space, taking device pixel density, user space transformations and zooming into account. To provide a platform independent alignment, attribute and property values are often relative to a coordinate system described by the primitiveUnits attribute. User agents must scale these relative attributes and properties to the operating coordinate space.

注記：解像度が高い機器~上では、 `~filter座標系$による［属性／~prop ］値は，通例的に拡大される必要がある。 ~UAは、 ~platform資源が制限されている下では，原始filterの解像度を抑制してもヨイ。 ◎ Note: On high resolution devices, attribute and property values that are relative to the primitiveUnits usually need to be scaled up. User agents may reduce the resolution of filter primitives on limited platform resources.

注記：［原始filter `feConvolveMatrix$e ／ `光源~要素$ ］の一部の［属性や~prop ］の値は、 `~filter座標系$から`演算-時の座標~空間$に対応付けれない。 ◎ Note: Some attribute or property values from the filter primitives feConvolveMatrix and light sources can not be mapped from the coordinate space defined by the primitiveUnits attribute to the operating coordinate space.

9.2. 共通な原始filter属性

次に挙げる `原始filter属性@ は、すべての原始filterに可用である： ◎ The following filter primitive attributes are available for all filter primitives:

`x@aP = "`length-percentage$t"
`y@aP = "`length-percentage$t": 下位領域の［ ~X, ~Y ］座標の最小を与えて、当の`原始filter$の計算と描画を制約する。 `原始filter下位領域$を見よ。 ◎ The minimum x coordinate for the subregion which restricts calculation and rendering of the given filter primitive. See filter primitive subregion.; 両~属性とも，`初期~値$は `0%^v とする。 ◎ The initial value for x is 0%.; ~animate可能。 ◎ Animatable: yes. ◎ y = "<length-percentage>" ◎ The minimum y coordinate for the subregion which restricts calculation and rendering of the given filter primitive. See filter primitive subregion. ◎ The initial value for y is 0%. ◎ Animatable: yes.
`width@aP = "`length-percentage$t"
`height@aP = "`length-percentage$t": 下位領域の［横幅, 縦幅］を与えて、当の`原始filter$の計算と描画を制約する。 `原始filter下位領域$を見よ。 ◎ The width of the subregion which restricts calculation and rendering of the given filter primitive. See filter primitive subregion.; 0 以下の値は、当の原始filterの効果を不能化する（すなわち、結果は`透明な黒$にされた画像になる）。 ◎ A negative or zero value disables the effect of the given filter primitive (i.e., the result is a transparent black image).; 両~属性とも，`初期~値$は `100%^v とする。 ◎ The initial value for width is 100%.; ~animate可能。 ◎ Animatable: yes. ◎ height = "<length-percentage>" ◎ The height of the subregion which restricts calculation and rendering of the given filter primitive. See filter primitive subregion. ◎ A negative or zero value must disable the effect of the given filter primitive (i.e., the result is a transparent black image). ◎ The initial value for height is 100%. ◎ Animatable: yes.
`result@aP = "`filter-primitive-reference@t": `filter-primitive-reference$t は `custom-ident$t `CSS3VAL$r であり、この`原始filter$に名前をアテガう。給された場合、この`原始filter$を処理した結果の~graphicsを，同じ `filter$e 要素の中で後続な原始filter上の `in$aP 属性から参照できるようになる。値が供されない場合、出力は，次の`原始filter$の中への暗黙的な入力として再利用するために限り可用になる — 次の`原始filter$が，その `in$aP 属性に値を供さないならば。 ◎ <filter-primitive-reference> is an <custom-ident> [CSS3VAL] and an assigned name for this filter primitive. If supplied, then graphics that result from processing this filter primitive can be referenced by an in attribute on a subsequent filter primitive within the same filter element. If no value is provided, the output will only be available for re-use as the implicit input into the next filter primitive if that filter primitive provides no value for its in attribute.

ほとんどの原始filterは、他の原始filterの出力を入力にとる。他の原始filterを参照する各種入力~属性を代表して，次の属性が定義される【したがって `in2^a 属性なども，同様に定義される】： ◎ Most filter primitives take other filter primitives as input. The following attribute is representative for all input attributes to reference other filter primitives:

所与の原始filter用の入力を与える。とり得る値は、 6 種の~keywordのいずれか, または［ `filter$e 要素の中で先行する，ある同胞~原始filter ］の `result$aP 属性~値に合致する文字列。値が供されていない場合、［最初の`原始filter$に対しては `SourceGraphic$v ／ ~ELSE_ 前の`原始filter$からの結果］を入力に利用することになる。 ◎ Identifies input for the given filter primitive. The value can be either one of six keywords or can be a string which matches a previous result attribute value within the same filter element. If no value is provided and this is the first filter primitive, then this filter primitive will use SourceGraphic as its input. If no value is provided and this is a subsequent filter primitive, then this filter primitive will use the result from the previous filter primitive as its input.

所与の `filter$e 要素の中で，同じ `result$aP 値が複数~回~現れる場合、その結果への参照は，［先行する`原始filter$のうち，その値を `result$aP 属性にとる, かつ最も近いもの］を利用することになる。 ◎ If the value for result appears multiple times within a given filter element, then a reference to that result will use the closest preceding filter primitive with the given value for attribute result.

結果への前方-参照は許容されない — そのようにした場合、結果は指定されなかった【すなわち、`in^aP 値は供されなかった】かのように扱われることになる。存在しない結果への参照も、同様に扱われることになる。 ◎ Forward references to results are not allowed, and will be treated as if no result was specified. ◎ References to non-existent results will be treated as if no result was specified.

6 種の~keywordの定義は： ◎ Definitions for the six keywords:

`SourceGraphic@v: `filter$e 要素の中への元の入力であった~graphics要素を表現する。 ~raster効果`原始filter$に対しては、 ~graphics要素は，画像~空間において`透明な黒$にされた~rasterの中に~raster化されることになる。元の~graphicにより触れられなかった画素は、 `透明な黒$のままになる。画像は、線型~RGBA画素~内に描画されるように指定される。この画像の~alpha~channelは，~SVGにより指定される~anti-aliasingがあればそれを捕捉する。（~rasterは線型なので、この画像の~alpha~channelは，各~画素の正確な被覆率を表現することになる。） ◎ This keyword represents the graphics elements that were the original input into the filter element. For raster effects filter primitives, the graphics elements will be rasterized into an initially clear RGBA raster in image space. Pixels left untouched by the original graphic will be left clear. The image is specified to be rendered in linear RGBA pixels. The alpha channel of this image captures any anti-aliasing specified by SVG. (Since the raster is linear, the alpha channel of this image will represent the exact percent coverage of each pixel.)
`SourceAlpha@v: ~alpha~channelのみが利用されることを除き， `SourceGraphic$v と同じになる。入力~画像は［ ~RGB~channelには暗黙的な黒~色~値, ~alpha~channelは `SourceGraphic$v と同じ］にされた~RGBA画像になる。 ◎ This keyword represents the graphics elements that were the original input into the filter element. SourceAlpha has all of the same rules as SourceGraphic except that only the alpha channel is used. The input image is an RGBA image consisting of implicitly black color values for the RGB channels, but whose alpha channel is the same as SourceGraphic.; 注記：この値が利用された場合、実装によっては，~alpha~channelを抽出するために ~graphics要素を~raster化する必要が生じるかもしれない。 ◎ Note: If this option is used, then some implementations might need to rasterize the graphics elements in order to extract the alpha channel.
`BackgroundImage@v: 現在の`隔離~group$により定義される［ `filter$e 要素が呼出された時点での，`~filter領域$の背後にある`後景$ ］を表現する。 `isolation$p ~propを見よ。 `COMPOSITING-1$r ◎ This keyword represents the back drop defined by the current isolation group behind the filter region at the time that the filter element was invoked. See isolation property [COMPOSITING-1].
`BackgroundAlpha@v: ~alpha~channelのみが利用されることを除き， `BackgroundImage$v と同じになる。［ `SourceAlpha$v 値, `isolation$p ~prop ］については、 `COMPOSITING-1$r を見よ。 ◎ Same as BackgroundImage except only the alpha channel is used. See SourceAlpha and the isolation property [COMPOSITING-1].
`FillPaint@v: ~filter効果が適用される要素の `fill$p ~propの値を表現する。 `FillPaint$v 画像は、概念的に無限な拡がりである。この画像はどこでも不透明にされることが多いが、 “塗り” 自体に~alphaがある場合には，そうならない — それ自体に不透明ではない部位が含まれる~gradientや~patternの事例など。 `fill$p が塗り~serverを参照する場合、その塗り~serverの座標~空間は，~filterされる~obj用に定義された座標~空間になる。例：塗り~serverが~objの `objectBoundingBox$vPU を利用するよう要求する場合、 ~filterされる~objの`限界~box$が，塗り~server用の基準~sizeを定義する。塗り~serverが `userSpaceOnUse$vPU を利用するよう要求する場合、 ~filterされる~objの`局所~座標系$に最も近い~viewportが，塗り~server用の基準~sizeを定義する。 ◎ This keyword represents the value of the fill property on the target element for the filter effect. The FillPaint image has conceptually infinite extent. Frequently this image is opaque everywhere, but it might not be if the "paint" itself has alpha, as in the case of a gradient or pattern which itself includes transparent or semi-transparent parts. If fill references a paint server, then the coordinate space of the paint server is the coordinate space defined for the filtered object. E.g if the paint server requires to use the objectBoundingBox of the object, the object bounding box of the filtered object defines the reference size of the paint server. If the paint server requires to use the userSpaceOnUse, the nearest viewport in the local coordinate system of the filtered object defines the reference size of the paint server.
`StrokePaint@v: ~filter効果が適用される要素の `stroke$p ~propの値を表現する。 `StrokePaint$v 画像は、概念的に無限な拡がりである。詳細は上の `FillPaint$v を見よ。 ◎ This keyword represents the value of the stroke property on the target element for the filter effect. The StrokePaint image has conceptually infinite extent. See FillPaint above for more details.

下位領域の例 ◎ Example for subregions

9.3. 原始filter~tree

0 個~以上の原始filter入力を伴う原始filterたちは、共に，ある~filter連鎖に~linkできる。 ~filter連鎖の例として、複数の `filter-function$t を伴う `filter-value-list$t が成す原始filter表現が挙げられる。どの原始filterも，より前に現れる原始filterの結果を入力にとる。 ◎ Filter primitives with no or one filter primitive input can be linked together to a filter chain. E.g. the filter primitive representation of a <filter-value-list> with two or more <filter-function>s is an example of a filter chain. Every filter primitive takes the result of the previous filter primitive as input.

単純な、一連の原始filterを子に持つ `filter$e 要素の例： ◎ A simple example of a filter element with its filter primitive children.

<filter id="filter">
  <feColorMatrix type="hueRotate" values="45"/>
  <feOffset dx="10" dy="10"/>
  <feGaussianBlur stdDeviation="3"/>
</filter>

［ `feColorMatrix$e, `feOffset$e, `feGaussianBlur$e ］は、 ~filter連鎖を作成する。 ◎ feColorMatrix, feOffset and feGaussianBlur create a filter chain.

`feColorMatrix$e は、 `SourceGraphic$v を入力にとる。その結果は `feOffset$e の入力になり，その結果は `feGaussianBlur$e の入力になる。 ◎ feColorMatrix takes SourceGraphic as input. The result is the input of feOffset with its result being the input of feGaussianBlur.

一部の原始filterは、 `in$aP, `result$aP 属性の利用により，複数の原始filterを入力にとり得る。複階的な~filter構造を成すように，複数の原始filterを組合せることもアリである。原始filterは前方-参照できない制約があることに因り，どの~filter構造も `原始filter~tree@ と呼ばれる~treeとして表現できる。原始filter~treeの根~原始filterは、その原始filter~treeを成している原始filterのうち，最後に現れるものになる。 ◎ Some filter primitives may have more than one filter primitive inputs. With the use of the in and result attributes it is possible to combine multiple filter primitives to a complex filter structure. Due to the non-forward reference restriction of filter primitives, every filter structure can be represented as a tree, the filter primitive tree. The root filter primitive of the filter primitive tree is the most subsequential primitive of filter elements filter primitive children.

~filter連鎖は、原始filter~treeでも表現できる~filter構造なので，原始filter~treeとも称される。 ◎ A filter chain is one possible filter structure that can also be represented in a filter primitive tree. Therefore, filter chains are referred to as filter primitive trees onwards as well.

`filter$e 要素は、複数の原始filter~treeからなることもある。原始filter~treeのうち，その根~原始filterは `filter$e 要素の最後の子~原始filterになるものは、 `首~原始filter~tree@ と呼ばれる。 ◎ A filter element may have one or more filter primitive trees. The filter primitive tree whose subsequent filter primitive is the last filter primitive child of the filter elements is the primary filter primitive tree.

首~原始filter~treeのみが~filter処理-に寄与する。実装は、他の原始filter~treeをすべて無視することにしてもヨイ。 ◎ Only the primary filter primitive tree contributes to the filter process. Implementations may chose to ignore all other possible filter primitive trees.

原始filter~treeを有さない `filter$e 要素に対しては、その~filterの適用-先の要素は，描画されなくなる。【~filterが適用されなくなるのみならず。】 ◎ If a filter element has no filter primitive tree then the element the filter applies to does not get rendered.

複数の原始filter~treeを有する例：

<filter id="filter">
  <-- 
最初の原始filter~tree。
~filter処理-においては無視される。
◎
The first filter primitive tree. Ignored for filter process.
 -->
  <feColorMatrix type="hueRotate" values="45"/>
  <feOffset dx="10" dy="10"/>
  <feGaussianBlur stdDeviation="3"/>
  <-- 
首~原始filter~tree。
◎
The primary filter primitive tree.
 -->
  <feFlood flood-color="green" result="flood"/>
  <feComposite operator="in" in="SourceAlpha" in2="flood"/>
</filter>

上の~filterには、 2 つの原始filter~treeがある： ◎ The above filter has 2 filter primitive trees with the filter primitives:

次の原始filterを伴うもの ⇒＃ `feColorMatrix$e, `feOffset$e, `feGaussianBlur$e （根~原始filter） ◎ feColorMatrix, feOffset and feGaussianBlur (with feGaussianBlur being the root filter primitive of the tree) as well as
次の原始filterを伴うもの ⇒＃ `feFlood$e, `feComposite$e （根~原始filter） ◎ feFlood and feComposite (with feComposite as the root filter primitive of the tree).

2 つの原始filter~treeは、接続されていない。 2 個目の首~原始filter~treeのみが~filter処理-に寄与する。実装は、 1 個目の~treeを無視できる。 ◎ Both filter primitive trees are not connected. Only the 2nd, the primary filter primitive tree contributes to the filter process. The first tree can get ignored by implementations.

9.4. 原始filter下位領域

どの`原始filter$にも、その計算と描画を制約する `原始filter下位領域@ が定義される： ◎ All filter primitives have attributes x, y, width and height which together identify a filter primitive subregion which restricts calculation and rendering of the given filter primitive.＼

それは、 `原始filter$の［ `x$aP, `y$aP, `width$aP, `height$aP ］属性から定められる。これらの属性は、他の`原始filter$の［座標, 長さ］属性と同じく，`~filter座標系$における値を表現する。 ◎ The x, y, width and height attributes are defined according to the same rules as other filter primitives coordinate and length attributes and thus represent values in the coordinate system established by attribute primitiveUnits on the filter element.
属性が指定されなかった場合の既定の下位領域は、次項に該当するものを除き，参照~先~node【当の原始filterの入力を与える他の原始filter】用に定義された下位領域すべてが最も緊密に収まる限界~boxから定まる。【一部の属性だけ指定された場合、指定された属性とこの限界~boxの混成になる。】 ◎ x, y, width and height default to the union (i.e., tightest fitting bounding box) of the subregions defined for all referenced nodes.＼
次に該当する`原始filter$に対しては、既定の下位領域は `0%^v, `0%^v, `100%^v, `100%^v になる：
- 参照~先~nodeが無いもの（例： `feImage$e ／ `feTurbulence$e 用）
- いずれかの参照~先~nodeが，標準の入力（ `SourceGraphic$v ／ `SourceAlpha$v ／ `BackgroundImage$v ／ `BackgroundAlpha$v ／ `FillPaint$v ／ `StrokePaint$v ）をとるもの
- `feTile$e （これは、参照~先~nodeを［ ~X, ~Y ］両方向に反復的に複写して，通例的により大きい結果を生産するので、特別である）。
これらに対する百分率は、特例として `~filter領域$の寸法に相対的になり，既定の`原始filter下位領域$は`~filter領域$に等しくなる。
◎ If there are no referenced nodes (e.g., for feImage or feTurbulence), or one or more of the referenced nodes is a standard input (one of SourceGraphic, SourceAlpha, BackgroundImage, BackgroundAlpha, FillPaint or StrokePaint), or for feTile (which is special because its principal function is to replicate the referenced node in X and Y and thereby produce a usually larger result), the default subregion is 0%, 0%, 100%, 100%, where as a special-case the percentages are relative to the dimensions of the filter region, thus making the default filter primitive subregion equal to the filter region.

`原始filter下位領域$の［横幅／縦幅］が 0 以下の場合、当の原始filterによる効果は不能化される。【不能化-の意味は `width$aP に述べられている。】 ◎ If the filter primitive subregion has a negative or zero width or height, the effect of the filter primitive is disabled.

原始filterの入力~画像に対しては、 `~filter領域$を超える部分は切取られる。 ◎ The filter region acts as a hard clip clipping rectangle on the filter primitive’s input image(s).

原始filterの結果に対しては、 `原始filter下位領域$を超える部分は切取られる。 ◎ The filter primitive subregion acts as a hard clip clipping rectangle on the filter primitive result.

すべての中間~画像は、 `原始filter下位領域$と`~filter領域$の交差域を超過しないように定義される。［ `~filter領域$ ／原始filter下位領域］ %R は、［【 %R に関与する】どの中間~画像も， %R に一部でも交差する画素すべてを収容するに十分な大きさになる］ように設定しておかれる。 ◎ All intermediate offscreens are defined to not exceed the intersection of the filter primitive subregion with the filter region. The filter region and any of the filter primitive subregions are to be set up such that all offscreens are made big enough to accommodate any pixels which even partly intersect with either the filter region or the filter primitive subregions.

`feTile$e は、参照~先の原始filterの`原始filter下位領域$に基づいて ~tileたちを縫合して，自前の`原始filter下位領域$を埋める。 ◎ feTile references a previous filter primitive and then stitches the tiles together based on the filter primitive subregion of the referenced filter primitive in order to fill its own filter primitive subregion.

<svg
  width="400" height="400"
  xmlns="http://www.w3.org/2000/svg"
>
  <defs>
    <filter
      id="flood"
      x="0" y="0" width="100%" height="100%"
      primitiveUnits="objectBoundingBox"
    >
       <feFlood
          x="25%" y="25%" width="50%" height="50%"
          flood-color="green" 
          flood-opacity="0.75"
       />
    </filter>
    <filter
       id="blend"
       primitiveUnits="objectBoundingBox"
     >
       <feBlend
          x="25%" y="25%" width="50%" height="50%"
          in2="SourceGraphic"
          mode="multiply"
       />
    </filter>
    <filter
       id="merge"
       primitiveUnits="objectBoundingBox"
     >
       <feMerge
         x="25%" y="25%" width="50%" height="50%"
       >
        <feMergeNode in="SourceGraphic"/>
        <feMergeNode in="FillPaint"/>
       </feMerge>
    </filter>
  </defs>

    <g fill="none" stroke="blue" stroke-width="4">
       <rect width="200" height="200"/>
       <line x2="200" y2="200"/>
       <line x1="200" y2="200"/>
    </g>
    <circle
      fill="green"
      filter="url(#flood)"
      cx="100" cy="100" r="90"
    />

  <g transform="translate(200 0)">
    <g fill="none" stroke="blue" stroke-width="4">
       <rect width="200" height="200"/>
       <line x2="200" y2="200"/>
       <line x1="200" y2="200"/>
    </g>
    <circle
      fill="green"
      filter="url(#blend)"
      cx="100" cy="100" r="90"
    />
  </g>

  <g transform="translate(0 200)">
    <g fill="none" stroke="blue" stroke-width="4">
       <rect width="200" height="200"/>
       <line x2="200" y2="200"/>
       <line x1="200" y2="200"/>
    </g>
    <circle
      fill="green" fill-opacity="0.5"
      filter="url(#merge)"
      cx="100" cy="100" r="90"
    />
  </g>
</svg>

`filtersubregion00.svg$ex

上の例を成す 3 個の矩形~それぞれには、斜め十字（ 2 本の `line^e 要素）と真円（ `circle^e 要素）がある。各真円には，互いに異なる~filterが適用されるが、 `原始filter下位領域$はどれも同じになる。各~filterの出力は，`原始filter下位領域$に制限されるべきなので、 `原始filter下位領域$を成す矩形だけが見え, 真円には見えなくなるべきである。 ◎ In the example above there are three rectangles that each have a cross and a circle in them. The circle element in each one has a different filter applied, but with the same filter primitive subregion. The filter output should be limited to the filter primitive subregion so you should never see the circles themselves, just the rectangles that make up the filter primitive subregion.

左上の矩形は `feFlood$e を示す。その `flood-opacity$p `75%^v にされているので、斜め十字は，緑色~矩形を透かして可視になるべきである。 ◎ The upper left rectangle shows an feFlood with flood-opacity: 75% so the cross should be visible through the green rect in the middle.
左下の矩形は［ `SourceGraphic$v と `FillPaint$v ］を併合する `feMerge$e を示す。真円の `fill-opacity^p は `0.5^v であり，半~透明なので、この斜め十字も，緑色~矩形を透かして可視になる。 ◎ The lower left rectangle shows an feMerge that merges SourceGraphic with FillPaint. Since the circle has fill-opacity="0.5" it will also be transparent so that the cross is visible through the green rect in the middle.
右上の矩形は［ `mode="multiply"^c にされた `feBlend$e ］を示す。この事例における真円は全~不透明になるので、矩形は暗い緑色になり，斜め十字は可視にならないべきである。 ◎ The upper right rectangle shows an feBlend that has mode="multiply". Since the circle in this case isn’t transparent the result is totally opaque. The rect should be dark green and the cross should not be visible through it.

9.5. 原始filter `feBlend^e

◎要素名 `feBlend@e ◎分類 `原始filter$ ◎内容任意個数, 任意順序の，次に挙げる要素 ⇒＃ `記述的~要素$, `animate$e, `script$e, `set$e ◎属性 `中核~属性$, `呈示~属性$, `原始filter属性$, `class$a, `style$a, `in$aP, `in2$aB, `mode$aB ◎界面 `SVGFEBlendElement$I ◎表終

この~filterは、共通的に利用される画像処理~software混色~modeを利用して， 2 つの~objを共に混色する。それは、 2 個の入力~画像に対する画素ごとに組合nを遂行する（ `COMPOSITING-1$r を見よ。） ◎ This filter blends two objects together using commonly used imaging software blending modes. It performs a pixel-wise combination of two input images. (See [COMPOSITING-1].)

`feBlend^e の例 ◎ Example of feBlend

`mode@aB = "`blend-mode$t": `COMPOSITING-1$r にて定義されるいずれかの混色-~modeを与える：入力 `in$aP が ~source %C/s を表現し，入力 `in2$aB が `後景$ %C/b を表現する。［ %C/s と %C/b ］を混色した結果が、この原始filterの出力になる。 ◎ One of the blend modes defined by “Compositing and Blending Level 1” [COMPOSITING-1] with the input in representing the source Cs and the second input in2 representing the backdrop Cb. The output of this filter primitive Cm is the result of blending Cs with Cb.; `初期~値$は `normal$v とする。 ◎ The initial value for mode is normal.; ~animate可能。 ◎ Animatable: yes.
`no-composite@aB = "`no-composite@v": 要素がこの属性を有さない場合、実装は，要素の `mode$aB に指定された混色-~modeに~alpha組成-法 — すなわち， `source-over$v 組成-演算子を組合せる — を適用するモノトスル。有する場合、この~alpha組成-法は適用しないモノトスル。これらの “混合” 公式については `混色＠~COMPOSITING#blending$ `COMPOSITING-1$r を見よ。 ◎ If the no-composite attribute is present, the specified blend mode must not apply alpha compositing. See Blending [COMPOSITING-1] for the "mixing" formula without compositing. Otherwise, implementations must combine the blend mode specified by mode with the Source Over composite operator. See Blending [COMPOSITING-1] for the "mixing" formula with compositing.; 注記：この属性は、 ~SVG 1.1 における `feBlend$e 要素~定義への追加である。 `no-composite$aB に意味されているのは、指定されたなら，入力~sourceを［ ~filterされる~objの`後景$ ］に混色するときに（例えば `BackgroundImage$v 原始filterを利用して） “二重に組成される” 効果を避けることである。大多数の利用事例では、作者が `no-composite$aB 属性を指定する必要はないであろう。 ◎ Note: This attribute is an addition to the feBlend element defintion in SVG 1.1. no-composite, when specified, is meant to avoid "double-compositing" effects when blending an input source with the backdrop of the filtered object (E.g. using the BackgroundImage filter primitive). For the majority of use cases authors will not need to specify the no-composite attribute.; ~animate不可。 ◎ Animatable: no.
`in2@aB: とり得る値は `in$aP 属性を見よ。混色~演算に対する 2 個目の入力~画像を与える。 ◎ in2 = "(see in attribute)" ◎ The second input image to the blending operation.; ~animate可能。 ◎ Animatable: yes.

~alpha組成-法を伴う `normal$v 混色-~modeは、 `feComposite$e 原始filter上の `operator="over"^c と等価になる。それは、 `feMerge$e により利用される混色~methodに合致する。それはまた、 `単純~alpha組成-法$（~SVGにおいては，~filter効果の外側にあるどの組成-法にも利用される）に合致する。 ◎ The normal blend mode with alpha compositing is equivalent to operator="over" on the feComposite filter primitive, matches the blending method used by feMerge and matches the simple alpha compositing technique used in SVG for all compositing outside of filter effects.

<svg
  width="5cm" height="5cm"
  viewBox="0 0 500 500"
  xmlns="http://www.w3.org/2000/svg"
>
  <title>
各種 `feBlend^e ~modeの例
◎
Example feBlend - Examples of feBlend modes
</title>
  <desc>
~gradientに混色される 5 種の~text文字列
— それぞれが 5 種の混色~modeに対応する
◎
Five text strings blended into a gradient, with one text string for each of the five feBlend modes.
</desc>
  <defs>
    <linearGradient
      id="MyGradient"
      gradientUnits="userSpaceOnUse"
      x1="100" y1="0" x2="300" y2="0"
    >
      <stop offset="0" stop-color="#000000" />
      <stop offset=".33" stop-color="#ffffff" />
      <stop offset=".67" stop-color="#ff0000" />
      <stop offset="1" stop-color="#808080" />
    </linearGradient>
    <filter id="Normal">
      <feBlend mode="normal" in2="BackgroundImage" in="SourceGraphic"/>
    </filter>
    <filter id="Multiply">
      <feBlend mode="multiply" in2="BackgroundImage" in="SourceGraphic"/>
    </filter>
    <filter id="Screen">
      <feBlend mode="screen" in2="BackgroundImage" in="SourceGraphic"/>
    </filter>
    <filter id="Darken">
      <feBlend mode="darken" in2="BackgroundImage" in="SourceGraphic"/>
    </filter>
    <filter id="Lighten">
      <feBlend mode="lighten" in2="BackgroundImage" in="SourceGraphic"/>
    </filter>
  </defs>

  <rect fill="none" stroke="blue"
        x="1" y="1" width="498" height="498"/>
  <g isolation="isolate" >
    <rect x="100" y="20" width="300" height="460" fill="url(#MyGradient)" />
    <g font-family="Verdana" font-size="75" fill="#888888" fill-opacity=".6" >
      <text x="50" y="90" filter="url(#Normal)" >Normal</text>
      <text x="50" y="180" filter="url(#Multiply)" >Multiply</text>
      <text x="50" y="270" filter="url(#Screen)" >Screen</text>
      <text x="50" y="360" filter="url(#Darken)" >Darken</text>
      <text x="50" y="450" filter="url(#Lighten)" >Lighten</text>
    </g>
  </g>
</svg>

`feBlend.svg$ex

9.6. 原始filter `feColorMatrix^e

◎要素名 `feColorMatrix@e ◎分類 `原始filter$ ◎内容任意個数, 任意順序の，次に挙げる要素 ⇒＃ `記述的~要素$, `animate$e, `script$e, `set$e ◎属性 `中核~属性$, `呈示~属性$, `原始filter属性$, `class$a, `style$a, `in$aP, `type$aCM, `values$aCM ◎界面 `SVGFEColorMatrixElement$I ◎表終

この~filterは、入力~graphics上の各~画素に対し，その［色, ~alphaを成す~RGBA値 %S ］に，次のような行列を適用して、新たな［色, ~alphaを成す~RGBA値 %D ］を生産する： ◎ This filter applies a matrix transformation: ◎ on the RGBA color and alpha values of every pixel on the input graphics to produce a result with a new set of RGBA color and alpha values.

`feColorMatrix-1a^dgm ~EQ `feColorMatrix-1b^dgm `feColorMatrix-1c^dgm

計算は、乗算済みでない色~値~上で遂行される。 ◎ The calculations are performed on non-premultiplied color values.

行列~演算の種別を指示する。 ~keyword `matrix$v は、 5×4 行列を成す値が全部的に供されることを指示する。他の~keywordは、［共通的に利用される色~演算を，完全な行列を指定せずに遂行-可能にする］ための，便利な略記を表現する。 ◎ Indicates the type of matrix operation. The keyword matrix indicates that a full 5x4 matrix of values will be provided. The other keywords represent convenience shortcuts to allow commonly used color operations to be performed without specifying a complete matrix.

`type@aCM = "`matrix$v | `saturate$v | `hueRotate$v | `luminanceToAlpha$v"

`初期~値$は `matrix$v とする。 ◎ The initial value for type is matrix.

`feColorMatrix-saturate^dgm

`values@aCM = `list-of-numbers$t

`values$aCM の内容は `type$aCM 属性の値に依存する： ◎ The contents of values depends on the value of attribute type:

`type$aCM="`matrix@v"

`values$aCM は、 5×4 行列を成す 20 個の値をとる。例えば単位行列は、次でも表出できる： ◎ For type="matrix", values is a list of 20 matrix values (a00 a01 a02 a03 a04 a10 a11 ... a34), separated by whitespace and/or a comma. For example, the identity matrix could be expressed as:

type="matrix"
values="1 0 0 0 0  0 1 0 0 0  0 0 1 0 0  0 0 0 1 0"

`type$aCM="`saturate@v"

`values$aCM は， 1 個の実数~値をとる。 %s をその値, %t ~EQ ( 1 − %s ) とするとき、次の行列による演算と等価になる： ◎ For type="saturate", values is a single real number value. A saturate operation is equivalent to the following matrix operation:

注記：値 `0^v により生産される~filter結果は、彩度なし（~grayscale）になる一方で、値 `1^v は~filter入力~画像を変更せずに通過させる。 0 〜 1 の範囲~外の値は、 ~filter入力~画像を `under- or oversaturate^en する†。【† 意味的には“彩度を下げ過ぎる／上げ過ぎる” になるが、範囲~外の値でも，そのまま数式に渡されることを述べていると見受けられる（その結果、0 未満の値に対しては，彩度なしでなくなる）。】 ◎ Note: A value of 0 produces a fully desaturated (grayscale) filter result, while a value of 1 passes the filter input image through unchanged. Values outside the 0..1 range under- or oversaturates the filter input image respectively.

注記：輝度（ `luminance^en ）係数の精度は、以前の仕様~text `Cmam$r から増やされた。 ◎ Note: The precision of the luminance coefficients increased in comparison to previous specification texts [Cmam].

`type$aCM="`hueRotate@v"

`values$aCM は 1 個の実数~値（度数）。その値を %hueRotate とするとき、次の行列による演算と等価になる： ◎ For type="hueRotate", values is a single one real number value (degrees). A hueRotate operation is equivalent to the following matrix operation:

`feColorMatrix-hueRotate-1^dgm

ここで、行列を成す各~項 — 左上部分を占める 3×3 行列 — は、次の式で計算される： ◎ where the terms a00, a01, etc. are calculated as follows:

%M1 ~PLUS `cos^op( %hueRotate ) ~MUL %M2 ~PLUS `sin^op( %hueRotate ) ~MUL %M3

%M1 ~EQ `feColorMatrix-hueRotate-2b^dgm

%M2 ~EQ `feColorMatrix-hueRotate-2c^dgm

%M3 ~EQ `feColorMatrix-hueRotate-2d^dgm

例えば，この色相~行列の左上隅の項は、次の式で与えられる： ◎ Thus, the upper left term of the hue matrix turns out to be:

%m/00 ~EQ 0.2127 ~PLUS `cos^op( %hueRotate ) ~MUL 0.7874 ~MINUS `sin^op( %hueRotate ) ~MUL 0.2127

`type$aCM="`luminanceToAlpha@v"

`values$aCM は適用-可能でない。次の行列による演算と等価になる： ◎ For type="luminanceToAlpha", values is not applicable. A luminanceToAlpha operation is equivalent to the following matrix operation:

`feColorMatrix-luminanceToAlpha-3^dgm

`初期~値$は、単位行列を表現する値になる — すなわち， `type$aCM に応じて ⇒＃ `matrix^v ならば `1 0 0 0 0 0 1 0 0 0 0 0 1 0 0 0 0 0 1 0^v ／ `saturate^v ならば `1^v ／ `hueRotate^v ならば `0^v ◎ The initial value for values ◎ type="matrix" • defaults to the identity matrix ◎ type="saturate" • defaults to the value 1 ◎ type="hueRotate" • defaults to the value 0 which results in the identity matrix.

`values$aCM による~listを成す~entryの個数が `type$aCM に要求される~entryの個数に合致しない場合、この原始filterは`通過~filter$として動作する。 ◎ If the number of entries in the values list does not match the required number of entries by the type, the filter primitive acts as a pass through filter.