Brandon 5d346a77ee iOS: Preserve Aspect Ratio When Applying Device Presets ...

# iOS: Preserve Aspect Ratio When Applying Device Presets

## Summary

This pull request removes Aspect Ratio from the built-in Device Presets under:

```text
Settings > Settings Presets > Device Presets
```

Applying Default, Ultra Quality, High Quality, High Quality 30 FPS, Performance, or Ultra Performance now preserves the Aspect Ratio already selected by the user.

## Problem

The built-in quality and performance presets previously treated Aspect Ratio as part of their managed configuration:

- Default changed Aspect Ratio to Auto.
- The quality and performance presets changed Aspect Ratio to Stretch to Window.

Aspect Ratio is a display preference rather than a performance tier. Applying a graphics or emulation preset could therefore unexpectedly stretch or reshape the image, even when the user wanted to keep a native, automatic, 4:3, 16:9, or custom display choice.

Aspect Ratio was also included in the preset-active comparison. If a user changed only Aspect Ratio after applying a Device Preset, the preset would stop displaying as active even though every setting that the preset should manage still matched.

## Changes

### Device Preset application

Removed the assignment that wrote the built-in preset configuration into:

```swift
settings.aspectRatio
```

Applying any built-in Device Preset now leaves the current Aspect Ratio unchanged.

### Active-preset detection

Removed Aspect Ratio from `BuiltInSettingsPreset.isActive` matching.

The selected indicator now reflects only the settings actually managed by Device Presets. A user can change Aspect Ratio independently without making an otherwise matching Device Preset appear inactive.

### Preset configuration model

Removed the unused `aspectRatio` field and its preset-specific values from the private built-in `Configuration` structure.

This prevents Aspect Ratio from being accidentally restored to Device Preset application in a later refactor and keeps the configuration model aligned with actual behavior.

### User-facing descriptions

Updated the detailed descriptions for Default and Ultra Quality:

- Default no longer states that it restores Aspect Ratio to Auto.
- Ultra Quality no longer states that it changes Aspect Ratio to Stretch to Window.

The Device Presets footer can therefore continue to state that presets change only the listed settings.

## Preserved behavior

This change is intentionally limited to the built-in Device Presets.

The following behavior is unchanged:

- Manual Aspect Ratio selection in Graphics settings.
- Per-game Aspect Ratio overrides.
- Exporting Aspect Ratio in user-created `.ini` preset files.
- Importing Aspect Ratio from user-created `.ini` preset files.
- Internal Resolution settings in all Device Presets.
- FXAA and CAS Sharpening settings.
- Queue Size settings.
- Fast Boot, PNACH, widescreen patch, Fast CDVD, OPH Flag Hack, and Emulation-Only Mode settings.
- Background visibility and Virtual Pad skin behavior.

## Result by preset

| Device Preset | Previous Aspect Ratio behavior | New behavior |
| --- | --- | --- |
| Default | Forced Auto | Preserves current value |
| Ultra Quality | Forced Stretch to Window | Preserves current value |
| High Quality | Inherited Stretch to Window | Preserves current value |
| High Quality 30 FPS | Inherited Stretch to Window | Preserves current value |
| Performance | Inherited Stretch to Window | Preserves current value |
| Ultra Performance | Inherited Stretch to Window | Preserves current value |

## Performance impact

There is no runtime emulation performance cost. Preset application performs one fewer setting assignment and active-preset detection performs one fewer comparison.

The change does not affect the renderer, emulation threads, game boot, frame pacing, or gameplay resource usage.

## Changed file

- `platforms/ios/app/src/main/swift/Models/SettingsPresetCatalog.swift`

## Integration

The worktree was rebased onto the latest `origin/master` before this change was applied.

Base revision:

```text
daed4ed4a7
```

## Validation

- Confirmed that `SettingsPresetCatalog.swift` no longer references Aspect Ratio.
- Confirmed that custom preset import/export support remains present in `SettingsPresetFile.swift`.
- `git diff --check` passed for the changed preset catalog.
- Full unsigned iOS IPA build completed successfully with `build-ios-ipa.sh`.

2026-07-31 17:09:25 +02:00

..

android

Android: 2D fallback background, portrait status layout, Clear Shader Cache placement, memcard delete wording

2026-07-30 18:20:12 -04:00

ios

iOS: Preserve Aspect Ratio When Applying Device Presets

2026-07-31 17:09:25 +02:00