InkModelerAttributes Class

Reference

Definition

Namespace:: Windows.UI.Input.Inking

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Edit

Manages which types of ink modeler attributes can be processed by the InkPresenter object.

public ref class InkModelerAttributes sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 393216)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class InkModelerAttributes final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 393216)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class InkModelerAttributes

Public NotInheritable Class InkModelerAttributes

Inheritance: Object Platform::Object IInspectable InkModelerAttributes

Attributes: ContractVersionAttribute MarshalingBehaviorAttribute

Windows requirements

Device family	Windows 10, version 1803 (introduced in 10.0.17134.0)
API contract	Windows.Foundation.UniversalApiContract (introduced in v6.0)

Examples

Here, we show how increasing latency when rendering ink strokes can be used to reduce possible stroke correction artifacts due to incorrect prediction. This example reduces the default forward-looking prediction time from 15ms to 8ms.

public sealed partial class AdjustPrediction : Page
{
    public AdjustPrediction()
    {
        this.InitializeComponent();
        var inkPresenter = inkCanvas.InkPresenter;
        InkDrawingAttributes drawingAttributes =
            inkPresenter.CopyDefaultDrawingAttributes();
        InkModelingAttributes modelingAttributes = drawingAttributes.ModelingAttributes;
        modelingAttributes.PredictionTime = TimeSpan.FromMilliseconds(8);
        inkPresenter.UpdateDefaultDrawingAttributes(drawingAttributes);
    }
}

Remarks

Ink modeling refers to the process of processing and optimizing input for rendering as ink strokes. This can inlcude filtering, smoothing, prediction (to reduce perceived latency), and transformation (such as scaling for display DPI, or mapping pointer pressure to stroke width).

When using the InkToolbar, InkModelerAttributes should be set in the InkToolbar.ActiveToolChanged event as attributes are overwritten whenever the active tool is changed.

Version history

Windows version	SDK version	Value added
2004	19041	UseVelocityBasedPressure

Properties

PredictionTime	Gets or sets the amount of time into the future used to predict the expected location of the input pointer.
ScalingFactor	Gets or sets the scale transform for the coordinate space of the ink stroke.
UseVelocityBasedPressure	Gets or sets whether pen velocity is used in combination with pressure on the inking surface to calculate final pressure value.

Applies to

Dela via