Profile Converters

These converters handle game profile-specific data transformations, including cover images, color opacity, and profile-related UI elements.

ProfileCoverConverter

• Namespace: GenHub.Infrastructure.Converters
• Purpose: Converts profile cover paths or URIs into displayable images
• Supported Inputs:
  • File paths (string)
  • URIs (string)
  • null values (returns fallback image)
• Return Type: Bitmap or fallback image

Basic Usage

<Image Source="{Binding CoverPath, Converter={StaticResource ProfileCoverConverter}}" />

Fallback Handling

<!-- Automatically handles missing covers -->
<Image Source="{Binding Profile.CoverUri, Converter={StaticResource ProfileCoverConverter}}" />

Common Scenarios

• Profile Selection UI: Display profile covers in lists or grids
• Game Launch Screen: Show selected profile's cover image
• Fallback Images: Graceful handling of missing or invalid cover files

---

ProfileColorToOpacityConverter

• Namespace: GenHub.Infrastructure.Converters
• Purpose: Extracts opacity from profile colors for UI transparency effects
• Formula: color.A / 255.0
• Return Type: double

Opacity Effects

<Border Opacity="{Binding ProfileColor, Converter={StaticResource ProfileColorToOpacityConverter}}" />

Overlay Effects

<!-- Create semi-transparent overlays -->
<Rectangle Fill="{Binding ProfileColor, Converter={StaticResource ColorToBrushConverter}}" 
           Opacity="{Binding ProfileColor, Converter={StaticResource ProfileColorToOpacityConverter}}" />

---

ProfileSelectionConverter

• Namespace: GenHub.Infrastructure.Converters
• Implements: IMultiValueConverter
• Purpose: Combines a target content item (ContentItemViewModel or ContentManifest) with a target GameProfile into a two-element object array parameter for profile assignment commands (such as AddToProfileCommand).
• Input Bindings:
  1. values[0]: ContentItemViewModel or ContentManifest (from parent or dialog DataContext)
  2. values[1]: GameProfile (from current row or ItemsControl item)
• Return Type: object[] { content, profile } or null
• Singleton: ProfileSelectionConverter.Instance

Usage in Profile Selection List

<Button Command="{Binding #RootView.DataContext.AddToProfileCommand}">
    <Button.CommandParameter>
        <MultiBinding Converter="{x:Static converters:ProfileSelectionConverter.Instance}">
            <Binding Path="#RootView.DataContext.SelectedContent" />
            <Binding Path="." />
        </MultiBinding>
    </Button.CommandParameter>
    <TextBlock Text="Add to This Profile" />
</Button>

---

Usage Patterns

Profile Card Layout

<Border Background="{Binding ProfileColor, Converter={StaticResource ColorToBrushConverter}}"
        Opacity="{Binding ProfileColor, Converter={StaticResource ProfileColorToOpacityConverter}}">
    <StackPanel>
        <Image Source="{Binding CoverPath, Converter={StaticResource ProfileCoverConverter}}" 
               Width="120" Height="90" />
        <TextBlock Text="{Binding ProfileName}" 
                   Foreground="{Binding ProfileColor, Converter={StaticResource ContrastTextColorConverter}}" />
    </StackPanel>
</Border>

Profile Selection Grid

<ItemsControl ItemsSource="{Binding GameProfiles}">
    <ItemsControl.ItemTemplate>
        <DataTemplate>
            <Border Background="{Binding Color, Converter={StaticResource ColorToBrushConverter}}"
                    CornerRadius="8" Margin="4">
                <StackPanel>
                    <Image Source="{Binding CoverUri, Converter={StaticResource ProfileCoverConverter}}" />
                    <TextBlock Text="{Binding Name}" 
                               Foreground="{Binding Color, Converter={StaticResource ContrastTextColorConverter}}" />
                </StackPanel>
            </Border>
        </DataTemplate>
    </ItemsControl.ItemTemplate>
</ItemsControl>