2.2.2.18 EmfPlusFocusScaleData Object

The EmfPlusFocusScaleData object specifies focus scales for the blend pattern of a path gradient brush.


0


1


2


3


4


5


6


7


8


9

1
0


1


2


3


4


5


6


7


8


9

2
0


1


2


3


4


5


6


7


8


9

3
0


1

FocusScaleCount

FocusScaleX

FocusScaleY

FocusScaleCount (4 bytes): An unsigned integer that specifies the number of focus scales. This value MUST be 2.

FocusScaleX (4 bytes): A floating-point value that defines the horizontal focus scale. The focus scale MUST be a value between 0.0 and 1.0, exclusive.

FocusScaleY (4 bytes): A floating-point value that defines the vertical focus scale. The focus scale MUST be a value between 0.0 and 1.0, exclusive.

By default, the center color of a path gradient brush is displayed only at the center point of an area bounded by a path. Focus scales specify an inner path inside that area, and the center color is displayed everywhere inside it. The inner path is the boundary path scaled by horizontal and vertical scale factors.

For example, focus scales of {0.2, 0.3} specifies a path that is the boundary path scaled by a factor of 0.2 horizontally and 0.3 vertically. The area inside the scaled path MUST be filled with the center color. Between the inner and outer boundaries, the color MUST change gradually from the center color to the boundary color.

An EmfPlusFocusScaleData object MUST be present in the OptionalData field of an EmfPlusPathGradientBrushData object (section 2.2.2.29), if the BrushDataFocusScales flag (section 2.1.2.1) is set in its BrushDataFlags field.

See section 2.2.2 for the specification of additional structure objects.