Содержание
- Summary
- Summary
- Sample Gallery Issues (from SDK 14383 and on)
- Summary
- Summary
- Summary
- Summary
- Summary
- Summary
- Summary
- Summary
- Summary
- Summary
- Summary
- New Known Issues
- 14352
- 14342
- 14332
#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
- No new feature additions or updates to Composition APIs
- AccessViolationException issue fixed with latest SDK Release (14366)
- No new known issues
- See Last Know Good for latest recommended configuration
#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.
This will be fixed with a new SDK drop, but until then, work around this issue by disabling the Live Visual Tree debugging:
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
- No new feature additions or updates to Composition APIs
- "Running Sample Gallery With Debugging" issue has been fixed
- See Last Know Good for latest recommended configuration
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:
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)
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;