Mazzle's Image Importer

The Image Importer takes a folder of images and automatically:

• []Builds a DDS texture atlas with configurable cell sizes and grid layout[/]

  []Generates the necessary BG3 mod files (LSX/LSF) needed to access the images and icons in your mod[/]

  []Deploys everything into your mod's directory structure[/]

  []Can also remove atlases from your mod[/]

  Supports the following formats

  • []PNG (.png)[/]

    []JPEG (.jpg, .jpeg)[/]

    []GIF (.gif)[/]

    []BMP (.bmp)[/]

    []TIFF (.tiff)[/]

    []WebP (.webp)[/]

    []DDS (.dds)[/]

    Installation

    • []Extract the tool to any location on your computer[/]

      []Ensure you have Python 3. 7+ installed[/]

      []The tool will auto-install required dependencies (Pillow, LSLib) on first run[/]

      Basic Usage

      Step 1: Select Your Mod Directory

      • []Click Browse next to "Target Mod (Public) Directory"[/]

        []Select your mod's root directory (the folder that contains the Public/ subfolder)[/]

        Step 2: Choose Images to Import

        • []Click Add Directory of Photos to Mod[/]

          []Select the folder containing your images[/]

          []The log should show how many images it found[/]

          Step 3: Configure Import

          • []Click Build & Deploy Atlas[/]

            []A window will appear allowing you to configure the the atlas being generated:[/]

            Atlas Information

            • []Atlas Name: Display name for the texture bank[/]

              []Atlas Key: Unique identifier. This is what you'll use to access the images in ScriptExtender.[/]

              Cell Sizing

              Choose how images should fit into atlas cells:

              • []Resize to largest: All images resized to match the largest image's dimensions[/]

                []Resize to average: Cells sized to the average image dimensions[/]

                []Resize to smallest: All images scaled down to the smallest image size[/]

                []Use largest (no resize): Cells sized to largest image, smaller images centered on transparent background without upscaling[/]

                []Icon 64x64: Standard icon size (64x64 pixels)[/]

                []Custom: Manually specify width and height[/]

                Grid Layout

                [*]Automatic: