Skip to content
This repository has been archived by the owner on Jun 10, 2024. It is now read-only.

Insider FAST

Jump to bottom
Patrick Siu edited this page Nov 16, 2016 · 22 revisions

#14971

Summary

API no longer available

  • Windows.UI.Composition.CompositionVisualSurface
  • CompositionShadow property on LayerVisual

#14393

Summary

  • No new feature additions or updates to Composition APIs
  • There are some identified issues on the Sample Gallery (see below). The apps will be fixed/updated in the near future.
  • See Last Know Good for latest recommended configuration

Sample Gallery Issues (from SDK 14383 and on)

  • Image Lighting Playground: exceptions for invalid effect input
  • Now Playing: exceptions for invalid effect input

#14390

Summary

  • No new feature additions or updates to Composition APIs
  • No new known issues
  • See Last Know Good for latest recommended configuration

#14388

Summary

  • No new feature additions or updates to Composition APIs
  • No new known issues
  • See Last Know Good for latest recommended configuration

#14385

Summary

  • No new feature additions or updates to Composition APIs
  • No new known issues
  • See Last Know Good for latest recommended configuration

#14383

Summary

  • No new feature additions or updates to Composition APIs
  • No new known issues
  • See Last Know Good for latest recommended configuration

#14379

Summary

  • No new feature additions or updates to Composition APIs
  • No new known issues
  • See Last Know Good for latest recommended configuration

#14376

Summary

  • No new feature additions or updates to Composition APIs
  • No new known issues
  • See Last Know Good for latest recommended configuration

#14372

Summary

  • No new feature additions or updates to Composition APIs
  • No new known issues
  • See Last Know Good for latest recommended configuration

#14371

Summary

  • No new feature additions or updates to Composition APIs
  • No new known issues
  • See Last Know Good for latest recommended configuration

#14367

Summary

#14366

Summary

  • No new feature additions or updates to Composition APIs
  • No new known issues
  • See Last Know Good for latest recommended configuration

#14361

Summary

  • No new feature additions or updates to Composition APIs
  • New known issue with ElementCompositionPreview.SetElementChildVisual (see below)
  • Identified issues with current Insider build and Sample Gallery (see below)
  • See Last Know Good for latest recommended configuration

New Known Issues

AccessViolationException with ElementCompositionPreview

There is a known compatibility issue between the latest insider flight 14361 and the most recent SDK 14332 that causes an exception to be thrown when using ElementCompositionPreview.SetElementChildVisual.

AccessViolationException

This will be fixed with a new SDK drop, but until then, work around this issue by disabling the Live Visual Tree debugging:

Disable UI Debugging Tools

Sample Gallery Issues

  • Thumbnail Lighting sample not working (since SceneLighting is currently broken for release builds).
  • Connected Animation sample: pressing the back button when in “XAML Connected Animation” mode does nothing; pressing the back button when in “Custom Connected Animation” mode when in a details page causes Sample Gallery to crash
  • Video Playground sample: blur effect on the video does not work

14352

Summary

  • No new feature additions or updates to Compostion APIs
  • Disposing Composition Objects and XAML Interop Issue has been fixed
  • Shadows Bleeding outside clipped region issue has been fixed
  • A number of fixes for situations where items not properly rendered when using SceneLightingEffects
  • A few behavior updates to Scene Lighting:
  • Non Invertible transformsthat exist above the source light will disable light. (For example a PlaneProjection set above your light will result in disabling the light)
  • Composition Scene Lighting cannot light items who exist above their light source coordinates or outside of them
  • See Last Know Good for latest recommended configuration

14342

Summary

New Known Issues

  • Shadows bleeding outside the app window on 14342 and 14332 - there are a number of identified cases where the shadow of a visual is not being constrained to the size of the app window or a defined clipped region and as a result is bleeding over.

14332

Summary

INSIDER_FAST Update 14332 includes the latest API updates to the Composition APIs seen at //BUILD (14295). These updates includes API changes, additions and removals. Details of these changes can be found below, but a few highlights:

  • Updates:
    • Interaction Tracker functionality has moved to Windows.UI.Composition.Interactions - large number of naming changes to the APIs.
    • Naming change in Implicit Animations for ImplicitAnimationsMap to ImplicitAnimationsCollection
    • Naming change for CompositionDestinationBrush to CompositionBackDropBrush
  • Additions:
    • CompositionNineGridBrush
    • Boolean support for Composition PropertySets
    • CompositionAnimation properties such as Direction, Target, etc.
    • Step Easing Function
    • Lighting including Ambient Light, Spot Light and more
  • Removals:
    • Visual.SnapToPixels

Known Issues

Running Sample Gallery with Debugging

We've noticed on some machines that folks are hitting exceptions immediately after they F5 the Sample Gallery.

There is a known work-around for this, please disable "Enable UI Debugging Tools for XAML" in debugging as shown here:

Tools -> Options -> Debugging

Uncheck "Enable UI Debugging Tools:

Disable UI Debugging Tools

This is a known issue that will be addressed in a future flight.

Disposing Composition Objects and XAML interop

ExecutionEngineExpection (if you only have Managed Debugging)

ExecutionEngineExpection

This error is hit when calling Dispose on Composition resources that are associated with XAML handoff Visuals that are cleaned up by XAML. Common examples of encoutering this issue is when navigating to a sample in the Sample Gallery. Temporary workaround is to not call Dipose on Composition resources before XAML cleans them up.

This is a known issue and will be addressed in a future flight.

API Updates - 14295 to 14332

The following outlines the API updates from Windows Insider Build + SDK 14295 and Windows Insider Build + SDK 14332

Brushes

14295 14332 Notes
N/A CompositionNineGridBrush A new brush type that applies nine-grid resizing to its source (which can be of type SurfaceBrush and ColorBrush). Allows for inset scaling to be controlled during resizing. Expected to be used to address nine-grid resizing of images (buttons, rounded rects, etc.) as well as borders (ColorBrush Source with IsCenterHollow.)
CompositionDestinationBrush CompositionBackdropBrush

InteractionTracker

Namespace relocation

The InteractionTracker APIs have been moved from Windows.UI.Composition to Windows.UI.Composition.Interactions. All APIs are now under the new namespace.

API Additions and Renames

The follow outlines API names that were renamed between 14295 and 14332.

Interfaces
14295 14332 Notes
IVisualInteractionSourceFactory IVisualInteractionSourceStatics Creating a visual interaction source is now done via VisualInteractionSource.Create(visual)
IInteractionTrackerInContactStateEnteredArgs IInteractionTrackerInteractingStateEnteredArgs InContact state for InteractionTracker was renamed to Interacting state
IInteractionTrackerInertiaEndpoint IInteractionTrackerInertiaRestingValue Endpoint was renamed to RestingValue in the InteractionTracker APIs
InteractionTracker Class

Any renamed properties being referenced in Expressions will also need to be updated

14295 14332 Notes
N/A IsPositionRoundingSuggested
NaturalEndPosition NaturalRestingPosition
NaturalEndScale NaturalRestingScale
ScrollPosition Position
N/A PositionInertiaDecayRate
ScrollPositionVelocity PositionVelocityInPixelsPerSecond
InitialInertiaVelocity PositionVelocityInPixelsPerSecond
ScrollScale Scale
N/A ScaleInertiaDecayRate
ScrollScaleVelocity ScaleVelocityInPixelsPerSecond
N/A AdjustPositionXIfGreaterThanThreshold
N/A AdjustPositionYIfGreaterThanThreshold
N/A TryUpdatePositionWithAdditionalVelocity
N/A TryUpdateScaleWithAdditionalVelocity
VisualInteractionSource Class

If any of these are referenced in expressions, they will need to be renamed there. Additionally, SystemManipulationMode now only has two members (None & CapableTouchpadOnly).

14295 14332 Notes
PositionXNestingMode PositionXChainingMode
PositionYNestingMode PositionYChainingMode
ScaleNestingMode ScaleChainingMode
SystemManipulationMode ManipulationRedirectionMode
Capture TryRedirectForManipulation
N/A IsPositionXRailsEnabled
N/A IsPositionYRailsEnabled
InteractionTrackerInertiaEndPoint Class

This class was renamed to InteractionTrackerInertiaRestingValue

14295 14332 Notes
Endpoint RestingValue
InteractionTrackerInertiaStateEnteredArgs Class
14295 14332 Notes
PositionVelocityInPixelsPerMillisecond PositionVelocityInPixelsPerSecond
ScaleVelocityInPixelsPerMillisecond ScaleVelocityInPixelsPerSecond
CalculatedFinalPosition NaturalRestingPosition
CalculatedFinalScale NaturalRestingScale
N/A ModifiedRestingPoisiton
N/A ModifiedRestingScale
Visual Class
14295 14332 Notes
Visual.SnapToPixels N/A It is now recommended to use InteractionTracker's IsPositionRoundingSuggested property to round the output of expressions

Expressions & PropertySets

API Additions and Renames

The follow outlines API names that were renamed between 14295 and 14332.

CompositionExpressionAnimation Class

14295 14332 Notes
N/A SetBooleanParameter(string key, bool value)
CompositionPropertySet Class
14295 14332 Notes
N/A InsertBoolean(string key, bool value)
N/A TryGetBoolean(string key, out value)

Animation

API Additions and Renames

The follow outlines API names that were renamed between 14295 and 14332.

Classes
14295 14332 Notes
ImplicitAnimationMap ImplicitAnimationCollection
AnimationGroup CompositionAnimationGroup
CompositionAnimation Class
14295 14332 Notes
N/A Target New property added to CompsitionAnimation named Target. This property will be used as target to run animations, overridden by StartAnimation Parameter. ImplicitAnimationCollection and CompositionAnimationGroup will only use this target property. If not present then animation will not occur
N/A Direction Direction property directs animation in a direction. Enum supports: Normal, Reverse, Alternate (Normal for first cycle and reverse the other), AlternateReverse (opposite of alternate)
Visual Class
14295 14332 Notes
N/A StartAnimationGroup(ICompositionAnimationBase value) AnimationGroups can now be started directly on the Visuals

Visuals

API Additions and Renames

The follow outlines API names that were renamed between 14295 and 14332.

Classes
14295 14332 Notes
N/A LayerVisual The LayerVisual is part of our effects system and allows for doing tree effects, applying one effects across a set of defined visual. LayerVisual is a specialized ContainerVisual that lets you use a CompositionEffectsBrush across anything rooted to that container.

Effects and Lighting

API Additions and Renames

The follow outlines API names that were renamed between 14295 and 14332.

Classes
14295 14332 Notes
N/A CompositionLight
N/A AmbientLight
N/A SpotLight
N/A DistantLight
N/A VisualUnorderedCollection
N/A PointLight

Overall Removals and Additions

Removed from Windows.UI.Composition

  • interface IAnimationGroup;
  • interface ICompositionDestinationBrush;
  • interface IImplicitAnimationMap;
  • interface IImplicitAnimationMapEntry;
  • interface IInteractionTracker;
  • interface IInteractionTrackerCustomAnimationStateEnteredArgs;
  • interface IInteractionTrackerIdleStateEnteredArgs;
  • interface IInteractionTrackerInContactStateEnteredArgs;
  • interface IInteractionTrackerInertiaEndpoint;
  • interface IInteractionTrackerInertiaModifier;
  • interface IInteractionTrackerInertiaMotion;
  • interface IInteractionTrackerInertiaStateEnteredArgs;
  • interface IInteractionTrackerOwner;
  • interface IInteractionTrackerRequestIgnoredArgs;
  • interface IInteractionTrackerValuesChangedArgs;
  • interface ICompositionInteractionSource;
  • ICompositionInteractionSourceCollection;
  • IVisualInteractionSource;
  • IVisualInteractionSourceFactory;
  • interface IVisual2;
  • runtimeclass AnimationGroup;
  • runtimeclass CompositionDestinationBrush;
  • runtimeclass CompositionPropertyChangedEventArgs;
  • runtimeclass ImplicitAnimationMap;
  • runtimeclass InteractionTracker;
  • runtimeclass InteractionTrackerCustomAnimationStateEnteredArgs;
  • runtimeclass InteractionTrackerIdleStateEnteredArgs;
  • runtimeclass InteractionTrackerInContactStateEnteredArgs;
  • runtimeclass InteractionTrackerInertiaEndpoint;
  • runtimeclass InteractionTrackerInertiaModifier;
  • runtimeclass InteractionTrackerInertiaMotion;
  • runtimeclass InteractionTrackerInertiaStateEnteredArgs
  • runtimeclass InteractionTrackerRequestIgnoredArgs;
  • runtimeclass InteractionTrackerValuesChangedArgs;
  • runtimeclass CompositionInteractionSource;
  • runtimeclass CompositionInteractionSourceCollection;
  • runtimeclass VisualInteractionSource;

Added to Windows.UI.Composition

  • interface IAmbientLight;
  • interface ICompositionBackdropBrush;
  • interface ICompositionAnimationBase;
  • interface ICompositionAnimationGroup;
  • interface ICompositionLight;
  • interface ICompositionNineGridBrush;
  • interface IDistantLight;
  • interface IImplicitAnimationCollection;
  • interface ILayerVisual;
  • interface IPointLight;
  • interface ISpotLight;
  • interface IVisualUnorderedCollection;
  • runtimeclass AmbientLight;
  • runtimeclass CompositionBackdropBrush;
  • runtimeclass CompositionAnimationGroup;
  • runtimeclass CompositionLight;
  • runtimeclass CompositionNineGridBrush;
  • runtimeclass DistantLight;
  • runtimeclass ImplicitAnimationCollection;
  • runtimeclass LayerVisual;
  • runtimeclass PointLight;
  • runtimeclass SpotLight;
  • runtimeclass VisualUnorderedCollection;

Added to Windows.UI.Composition.Interactions

  • interface ICompositionInteractionSource;
  • interface ICompositionInteractionSourceCollection;
  • interface IInteractionTracker;
  • interface IInteractionTrackerCustomAnimationStateEnteredArgs;
  • interface IInteractionTrackerIdleStateEnteredArgs;
  • interface IInteractionTrackerInteractingStateEnteredArgs;
  • interface IInteractionTrackerInertiaModifier;
  • interface IInteractionTrackerInertiaMotion;
  • interface IInteractionTrackerInertiaRestingValue;
  • interface IInteractionTrackerInertiaStateEnteredArgs;
  • interface IInteractionTrackerOwner;
  • interface IInteractionTrackerRequestIgnoredArgs;
  • interface IInteractionTrackerStatics;
  • interface IInteractionTrackerValuesChangedArgs;
  • interface IVisualInteractionSource;
  • interface IVisualInteractionSourceStatics;
  • runtimeclass CompositionInteractionSourceCollection;
  • runtimeclass InteractionTracker;
  • runtimeclass InteractionTrackerCustomAnimationStateEnteredArgs;
  • runtimeclass InteractionTrackerIdleStateEnteredArgs;
  • runtimeclass InteractionTrackerInteractingStateEnteredArgs;
  • runtimeclass InteractionTrackerInertiaModifier;
  • runtimeclass InteractionTrackerInertiaMotion;
  • runtimeclass InteractionTrackerInertiaRestingValue;
  • runtimeclass InteractionTrackerInertiaStateEnteredArgs;
  • runtimeclass InteractionTrackerRequestIgnoredArgs;
  • runtimeclass InteractionTrackerValuesChangedArgs;
  • runtimeclass VisualInteractionSource;
Clone this wiki locally