Edit

YCbCr Effect

  • Article

Converts planar and chroma subsampled JPEG YCbCr data to RGB. This effect assumes that the YCbCr data is formatted in compliance with the JPEG standard. Data for the inputs may be obtained from IWICPlanarBitmapSourceTransform. The YCbCr effect requires two inputs; the first must be a DXGI_FORMAT_R8 bitmap containing luma data, and the second must be a DXGI_FORMAT_R8G8 bitmap containing subsampled chroma data. For more information about using this effect, see JPEG YCbCr Support.

The CLSID for this effect is CLSID_D2D1YCbCr.

Effect properties

Display name and index enumeration Description
ChromaSubsampling
D2D1_YCBCR_CHROMA_SUBSAMPLING
 Specifies the chroma subsampling of the input chroma image.
The type is D2D1_YCBCR_CHROMA_SUBSAMPLING.
The default value is D2D1_YCBCR_CHROMA_SUBSAMPLING_AUTO.
TransformMatrix
D2D1_YCBCR_PROP_TRANSFORM_MATRIX
 A 3x2 Matrix specifying the axis-aligned affine transform of the image. Axis aligned transforms include Scale, Flips, and 90 degree rotations.
The type is D2D1_MATRIX_3X2_F.
The default value is Matrix3x2F::Identity().
InterpolationMode
D2D1_YCBCR_INTERPOLATION_MODE
 The interpolation mode.
The type is D2D1_YCBCR_INTERPOLATION_MODE.

Subsampling modes

Enumeration Description
D2D1_YCBCR_CHROMA_SUBSAMPLING_AUTO
 This mode attempts to infer the chroma subsampling from the bounds of the input images. When this option is selected, the smaller plane is upsampled to the size of the larger plane and this effect s output rectangle is the intersection of the two planes. When using this mode, care should be taken when applying effects to the input planes that change the image bounds, such as the border transform, so that the desired size ratio between the planes is maintained.
D2D1_YCBCR_CHROMA_SUBSAMPLING_420
 The chroma plane is horizontally subsampled by and vertically subsampled by . When this option is selected, the chroma plane is horizontally and vertically upsampled by 2x and this effect s output rectangle is the intersection of the two planes.
D2D1_YCBCR_CHROMA_SUBSAMPLING_422
 The chroma plane is horizontally subsampled by . When this option is selected, the chroma plane is horizontally upsampled by 2x and this effect s output rectangle is the intersection of the two planes.
D2D1_YCBCR_CHROMA_SUBSAMPLING_444
 The chroma plane is not subsampled. When this option is selected this effect s output rectangle is the intersection of the two planes.
D2D1_YCBCR_CHROMA_SUBSAMPLING_440
 The chroma plane is vertically subsampled by . When this option is selected, the chroma plane is vertically upsampled by 2x and this effect s output rectangle is the intersection of the two planes.

Interpolation modes

Enumeration Description
D2D1_YCBCR_INTERPOLATION_MODE_NEAREST_NEIGHBOR Samples the nearest single point and uses that. This mode uses less processing time, but outputs the lowest quality image.
D2D1_YCBCR_INTERPOLATION_MODE_LINEAR Uses a four point sample and linear interpolation. This mode uses more processing time than the nearest neighbor mode, but outputs a higher quality image.
D2D1_YCBCR_INTERPOLATION_MODE_CUBIC Uses a 16 sample cubic kernel for interpolation. This mode uses the most processing time, but outputs a higher quality image.
D2D1_YCBCR_INTERPOLATION_MODE_MULTI_SAMPLE_LINEAR Uses 4 linear samples within a single pixel for good edge anti-aliasing. This mode is good for scaling down by small amounts on images with few pixels.
D2D1_YCBCR_INTERPOLATION_MODE_ANISOTROPIC Uses anisotropic filtering to sample a pattern according to the transformed shape of the bitmap.
D2D1_YCBCR_INTERPOLATION_MODE_HIGH_QUALITY_CUBIC Uses a variable size high quality cubic kernel to perform a pre-downscale the image if downscaling is involved in the transform matrix. Then uses the cubic interpolation mode for the final output.

Output bitmap

The size of the output bitmap depends on the transform matrix that is applied to the image.

The effect performs the transform operation and then applies a bounding box around the result. The output bitmap is the size of the bounding box.

Requirements

Requirement Value
Minimum supported client Windows 8.1 [desktop apps | Windows Store apps]
Minimum supported server Windows Server 2012 R2 [desktop apps | Windows Store apps]
Header d2d1effects_1.h
Library d2d1.lib, dxguid.lib

ID2D1Effect

JPEG YCbCr Support

IWICPlanarBitmapSourceTransform