# DDS Conversion

DDS (DirectDraw Surface) is the native texture format used throughout Farming Simulator for all visual assets including textures, icons, previews, and in-game maps. Understanding DDS conversion is essential for creating professional-quality map mods.

## Windows App: Built-in DDS Conversion

Maps4FS Windows application includes native DDS conversion powered by **texconv** (Microsoft DirectXTex), so you rarely need external tools.

### Background Terrain Texture — Fully Automatic

When the **Windows app** generates a map with background terrain enabled, the background satellite texture is automatically converted to DDS format:

* 📁 `map_directory/assets/background/background_texture.jpg` — source texture (always kept)
* 📁 `map_directory/assets/background/background_texture.dds` — DDS version, referenced by the i3d file

No extra steps needed — the i3d file is generated pointing straight to the `.dds` texture. If texconv is unavailable, Maps4FS falls back to a PIL-based converter so generation never fails.

### Icon & Preview — One-Click Conversion in Map Editor

In the **Map Editor** tab of the Windows app you can select any existing map folder and convert `icon.png` and `preview.png` to proper DDS format with a single button click:

1. Open the **Windows app** and go to the **Map Editor** tab.
2. Select your map directory.
3. Click **Convert icon & preview to DDS**.
4. Both `icon.dds` and `preview.dds` are written into the map root — ready for use in Farming Simulator.

> This replaces the need for GIMP, Paint.NET, or any other external tool for the two most commonly required DDS files.

## Why DDS Format?

**Performance Benefits:**

* **GPU-optimized** compression reduces memory usage
* **Faster loading times** compared to standard image formats
* **Built-in mipmapping** support for better rendering at distance
* **Hardware acceleration** compatibility with modern graphics cards

## Essential DDS Files for Maps

### Map Identity Files

| File           | Dimensions | Purpose                | Usage                    | FS25 Status                                |
| -------------- | ---------- | ---------------------- | ------------------------ | ------------------------------------------ |
| `preview.dds`  | 2048×2048  | Loading screen preview | Shows during map loading | ✅ **One-click** in Windows app Map Editor  |
| `overview.dds` | 4096×4096  | In-game minimap        | Interactive map display  | ✅ **Auto-generated** with satellite images |

> **FS25 Automation**: When **Download Satellite Images** is enabled, Maps4FS automatically creates `overview.dds` using satellite imagery - no manual conversion needed!

### Quality Requirements

**Compression Settings:**

* **Icon**: Use DXT1 or DXT5 compression for optimal file size
* **Preview**: DXT1 compression for photographic content
* **Overview**: DXT5 with alpha channel for transparency support

## Automated Overview Generation

**Maps4FS now automatically handles overview\.dds creation!**

### How It Works

When you enable **Download Satellite Images** in Maps4FS settings:

1. 🛰️ High-resolution satellite imagery is downloaded for your map area
2. 🎯 The image is automatically processed and optimized for in-game use
3. 📁 `overview.dds` is generated and saved in the correct format and dimensions
4. ✅ Ready to use immediately - no manual conversion required!

### Benefits

* **Perfect Quality**: Uses actual satellite imagery for photorealistic minimap
* **Correct Dimensions**: Automatically sized to 4096×4096 pixels
* **Optimal Compression**: Pre-configured with proper DXT5 settings
* **Time Saving**: Eliminates manual image editing and conversion steps

### When Manual Conversion is Still Needed

* **Custom overview designs**: If you prefer artistic or stylized minimaps
* **Icon and preview images**: Use the one-click converter in the Windows app Map Editor, or convert manually with the tools below

## Conversion Tools & Methods

### Recommended Free Tools

#### 1. **GIMP with DDS Plugin** ⭐ *Most Popular*

* **Download:** [GIMP](https://www.gimp.org/) + [DDS Plugin](https://code.google.com/archive/p/gimp-dds/)
* **Pros:** Free, full control over compression settings
* **Best For:** Users comfortable with image editing software

#### 2. **Paint.NET with DDS Plugin**

* **Download:** [Paint.NET](https://www.getpaint.net/) + DDS Plugin from Plugin Pack
* **Pros:** User-friendly interface, good compression options
* **Best For:** Beginners seeking simplicity

#### 3. **Online Converters**

* **Convertio.co** - Supports PNG/JPG to DDS conversion
* **CloudConvert** - Batch processing capabilities
* **Best For:** Quick one-off conversions without software installation

### Professional Tools

#### **Adobe Photoshop with NVIDIA Plugin**

* **Download:** [NVIDIA Texture Tools Plugin](https://developer.nvidia.com/nvidia-texture-tools-adobe-photoshop)
* **Pros:** Professional-grade compression control, batch processing
* **Best For:** Professional mod developers with Photoshop access

#### **Intel Texture Works Plugin**

* **Compatible with:** Photoshop, After Effects
* **Features:** Advanced compression algorithms, real-time preview
* **Best For:** High-quality texture optimization

## Step-by-Step Conversion Process

### Using GIMP (Recommended)

1. **Prepare Your Image**
   * Ensure correct dimensions (see table above)
   * Optimize image quality and contrast
   * Save backup in original format
2. **Export to DDS**
   * File → Export As → Choose `.dds` extension
   * Select appropriate compression:
     * **DXT1** for images without transparency
     * **DXT5** for images with alpha channel
   * Enable **Generate Mipmaps** for better performance
3. **Verify Results**
   * Check file size (should be significantly smaller than PNG)
   * Test in-game to ensure visual quality

### Batch Conversion Tips

**For Multiple Files:**

* Use **ImageMagick** command-line tool for batch processing
* **XnConvert** provides GUI-based batch conversion
* **Photoshop Actions** automate repetitive conversions

## Optimization Best Practices

### Image Preparation

* **Start with high-quality source images** (PNG or TIFF recommended)
* **Use power-of-2 dimensions** when possible (512, 1024, 2048, 4096)
* **Avoid excessive compression** in source files before DDS conversion

### Compression Guidelines

* **Icons**: Prioritize clarity over file size
* **Previews**: Balance visual appeal with loading performance
* **Overview Maps**: Ensure text and details remain readable

### File Size Management

* **Target Sizes:**
  * Icon: 50-200 KB
  * Preview: 500 KB - 2 MB
  * Overview: 2-8 MB

## Troubleshooting Common Issues

### **Problem:** DDS files appear corrupted in-game

**Solution:** Verify dimensions match exactly, check compression format compatibility

### **Problem:** Poor image quality after conversion

**Solution:** Use higher quality compression settings, start with better source images

### **Problem:** Large file sizes

**Solution:** Experiment with DXT1 vs DXT5, optimize source image before conversion

### **Problem:** Conversion software not recognizing DDS format

**Solution:** Ensure DDS plugin is properly installed and enabled

## Quality Verification

**Before finalizing your DDS files:**

1. **Visual Inspection:** Open converted files to check for artifacts
2. **Size Validation:** Confirm dimensions match requirements exactly
3. **In-Game Testing:** Load map to verify proper display
4. **Performance Check:** Monitor loading times and memory usage

## Advanced Techniques

### **Custom Compression Settings**

* Experiment with **BC7** compression for highest quality (if supported)
* Use **uncompressed DDS** for critical visual elements
* Consider **DXT1a** for single-bit alpha transparency

### **Mipmap Optimization**

* **Auto-generate mipmaps** for distant viewing quality
* **Custom mipmap chains** for specialized applications
* **Sharpening filters** to maintain detail at smaller sizes

***

**Pro Tip:** Always keep your original high-resolution source files. DDS conversion is lossy, so you'll want to re-convert from originals when making updates rather than editing DDS files directly.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://maps4fs.gitbook.io/docs/advanced-topics/dds_conversion.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.