ScalingEffectStopDirection Property

Returns/sets the direction used to evaluate ScalingEffectStops. The default is EffectStopDirection.UseItemPath.

Syntax

Visual Basic

'Declaration
 
Public Property ScalingEffectStopDirection As EffectStopDirection

C#

public EffectStopDirection ScalingEffectStopDirection {get; set;}

Remarks

The direction can be set to evaluate the effect stops based on an item's position along the ItemPath or based on the item's vertical or horizontal position within the XamCarouselPanel.

For example, if you are using a circular path and you want to give the user the sense that the items at the top of the circle are further away, set the this property to EffectStopDirection.Vertical and add ScalingEffectStops that range from a value of .6 at an Offset of zero to a value of 1 at an Offset of 1. This will make the items 'in the distance' appear a bit smaller. To further enhance the perspective effect you can also do a similar thing with OpacityEffectStops - make items in the foreground (i.e., bottom of the circle) opaque and items in the back (i.e., top of the circle) a bit transparent.

Example

In the following example, the UseScaling property has been set to true so that the ScalingEffectStops provided will be used when arranging the panel items. Since the ScalingEffectStopDirection is set to UseItemPath, the offsets specified in the ScalingEffectStop instances will be based on their position along the path with items about 80% along the path being scaled largest and items at each end of that percent having a decreasingly smaller scale.

XAML

<igWindows:XamCarouselPanel>
    <igWindows:XamCarouselPanel.ViewSettings>
        <igWindows:CarouselViewSettings 
            UseScaling="True" 
            ScalingEffectStopDirection="UseItemPath" 
            ItemPathRenderBrush="#77000000">
            
            <igWindows:CarouselViewSettings.ItemPath>
                <Path Data="M-96.905841,269.54353 C-96.905841,269.54353 -28.403209,328.24638 85.941049,349.95603 188.78648,369.4825 914.01753,418.65525 960.78345,385.1648" />
            </igWindows:CarouselViewSettings.ItemPath>

            <igWindows:CarouselViewSettings.ScalingEffectStops>
                <igWindows:ScalingEffectStopCollection>
                    <igWindows:ScalingEffectStop Value="0.1"/>
                    <igWindows:ScalingEffectStop Offset="0.2" Value="0.2"/>
                    <igWindows:ScalingEffectStop Offset="0.4" Value="0.4"/>
                    <igWindows:ScalingEffectStop Offset="0.7" Value="0.8"/>
                    <igWindows:ScalingEffectStop Offset="0.8" Value="2.0"/>
                    <igWindows:ScalingEffectStop Offset="1" Value="1"/>
                </igWindows:ScalingEffectStopCollection>
            </igWindows:CarouselViewSettings.ScalingEffectStops>

        </igWindows:CarouselViewSettings>
    </igWindows:XamCarouselPanel.ViewSettings>

    <Ellipse Width="50" Height="50" Stroke="Black" Fill="Red" />
    <Ellipse Width="50" Height="50" Stroke="Black" Fill="Green" />
    <Ellipse Width="50" Height="50" Stroke="Black" Fill="Purple" />
    <Ellipse Width="50" Height="50" Stroke="Black" Fill="SlateGray" />
    <Ellipse Width="50" Height="50" Stroke="Black" Fill="Yellow" />
    <Ellipse Width="50" Height="50" Stroke="Black" Fill="Blue" />
    <Ellipse Width="50" Height="50" Stroke="Black" Fill="White" />
</igWindows:XamCarouselPanel>

Requirements

Target Platforms: Windows 10, Windows 8.1, Windows 8, Windows 7, Windows Server 2012, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2