ComponentOne Bitmap for WPF
C1.WPF.DX.4.5.2 Assembly / C1.Util.DX.Direct2D Namespace / RenderTargetProperties Structure / RenderTargetProperties Constructor / RenderTargetProperties Constructor(RenderTargetType,PixelFormat,Single,Single,RenderTargetUsage,FeatureLevel)
A value that specifies whether the render target should force hardware or software rendering. A value of RenderTargetType.Default specifies that the render target should use hardware rendering if it is available; otherwise, it uses software rendering. Note that WIC bitmap render targets do not support hardware rendering.
The pixel format and alpha mode of the render target. You can use the {{D2D1::PixelFormat}} function to create a pixel format that specifies that Direct2D should select the pixel format and alpha mode for you. For a list of pixel formats and alpha modes supported by each render target, see {{Supported Pixel Formats and Alpha Modes}}.
The horizontal DPI of the render target. To use the default DPI, set dpiX and dpiY to 0. For more information, see the Remarks section.
The vertical DPI of the render target. To use the default DPI, set dpiX and dpiY to 0. For more information, see the Remarks section.
A value that specifies how the render target is remoted and whether it should be GDI-compatible. Set to RenderTargetUsage.None to create a render target that is not compatible with GDI and uses Direct3D command-stream remoting if it is available.
A value that specifies the minimum Direct3D feature level required for hardware rendering. If the specified minimum level is not available, the render target uses software rendering if the type member is set to RenderTargetType.Default; if type is set to to D2D1_RENDER_TARGET_TYPE_HARDWARE, render target creation fails. A value of FeatureLevel.Level_DEFAULT indicates that Direct2D should determine whether the Direct3D feature level of the device is adequate. This field is used only when creating WindowRenderTarget and DeviceContextRenderTarget objects.

In This Topic
    RenderTargetProperties Constructor(RenderTargetType,PixelFormat,Single,Single,RenderTargetUsage,FeatureLevel)
    In This Topic
    Initializes a new instance of the RenderTargetProperties struct.
    Syntax
    'Declaration
     
    Public Function New( _
       ByVal type As RenderTargetType, _
       ByVal pixelFormat As PixelFormat, _
       ByVal dpiX As Single, _
       ByVal dpiY As Single, _
       ByVal usage As RenderTargetUsage, _
       ByVal minLevel As FeatureLevel _
    )
    public RenderTargetProperties( 
       RenderTargetType type,
       PixelFormat pixelFormat,
       float dpiX,
       float dpiY,
       RenderTargetUsage usage,
       FeatureLevel minLevel
    )

    Parameters

    type
    A value that specifies whether the render target should force hardware or software rendering. A value of RenderTargetType.Default specifies that the render target should use hardware rendering if it is available; otherwise, it uses software rendering. Note that WIC bitmap render targets do not support hardware rendering.
    pixelFormat
    The pixel format and alpha mode of the render target. You can use the {{D2D1::PixelFormat}} function to create a pixel format that specifies that Direct2D should select the pixel format and alpha mode for you. For a list of pixel formats and alpha modes supported by each render target, see {{Supported Pixel Formats and Alpha Modes}}.
    dpiX
    The horizontal DPI of the render target. To use the default DPI, set dpiX and dpiY to 0. For more information, see the Remarks section.
    dpiY
    The vertical DPI of the render target. To use the default DPI, set dpiX and dpiY to 0. For more information, see the Remarks section.
    usage
    A value that specifies how the render target is remoted and whether it should be GDI-compatible. Set to RenderTargetUsage.None to create a render target that is not compatible with GDI and uses Direct3D command-stream remoting if it is available.
    minLevel
    A value that specifies the minimum Direct3D feature level required for hardware rendering. If the specified minimum level is not available, the render target uses software rendering if the type member is set to RenderTargetType.Default; if type is set to to D2D1_RENDER_TARGET_TYPE_HARDWARE, render target creation fails. A value of FeatureLevel.Level_DEFAULT indicates that Direct2D should determine whether the Direct3D feature level of the device is adequate. This field is used only when creating WindowRenderTarget and DeviceContextRenderTarget objects.
    See Also