Skip to content

Dialog Flux Convert

Jump to bottom
Digitoxin edited this page Dec 22, 2025 · 10 revisions

Convert Flux Image

Convert Flux Image Dialog

The Convert Flux Image dialog converts an existing flux image set into a supported image format that can be previewed, imported into the workspace, or saved directly to disk.

This dialog operates on flux image sets created externally or by DiskImageTool and does not modify the original flux data.

How to Open

The dialog can be opened in multiple ways:

  • Menu: Flux → Convert Flux Image
    Prompts you to select any .raw file from a flux image set.

  • Drag and Drop:
    Dragging either:

    • The parent folder of a flux image set, or
    • Any .raw file within a flux image set
      onto the main application window opens this dialog automatically.

Only one flux image set is loaded at a time.

Overview

Convert Flux Image processes raw flux data and produces a converted image using a selected device and format.

The dialog always opens with a flux image set already loaded and ready for processing.

Device Selection

Selects the device backend used for conversion.

Only devices configured in Flux Configuration are shown.

  • Greaseweazle
  • Kryoflux

Extended Log Output (Kryoflux)

When Kryoflux is selected, an additional checkbox appears:

  • Extended Log Output
    Includes read and format flags in the Kryoflux log output during conversion.

Auto Save Log

When enabled, the console output generated during conversion is automatically saved to the flux image set directory when the converted image is saved or imported.

This setting is remembered separately for each device.

File Name and Extension

File Name

Specifies the name used when saving or importing the converted image.

  • Defaults to the name of the flux image set’s parent folder
  • Required before importing or saving

Extension

The available extensions depend on the selected output type:

  • Basic Sector Image
    Displays extensions appropriate for the selected image format

  • HxC HFE (v1) Image
    Fixed to .hfe and disabled

The selected extension is remembered per device.

Open

The Open button loads a different flux image set for conversion.

This option is disabled after an image has been processed.

Image Format

Specifies the target image format for conversion.

When a flux image set is loaded, the first track is analyzed and the BIOS Parameter Block is used to attempt automatic format detection.

The format list includes common floppy disk layouts as well as special formats.

Output Type

Specifies the type of image generated during conversion.

Available options depend on the selected device:

  • Greaseweazle

    • Basic Sector Image
    • HxC HFE (v1) Image

  • Kryoflux

    • Basic Sector Image only

If only one output type is available, it is selected automatically and the control is disabled.

Double-Step

When enabled, conversion uses double-stepping.

This option is available only when the flux image was captured from a 5.25" high density drive reading a double density disk.

Track Grid

The track grid displays all tracks available in the flux image set.

  • Separate grids are shown for Side 0 and Side 1
  • Rows represent the tens digit of the track number
  • Columns represent the ones digit
  • Each cell corresponds to a physical track

The grid reflects both processed data and real-time conversion progress.

Grid Color Coding

During processing, the track grid uses color coding to indicate activity and results for each track:

  • Light Blue - Track is currently being read
  • Light Green - Track was processed successfully
  • Red - Warnings/Errors during track processing
  • Gray - Track is out of range for the selected format

Kryoflux specific:

  • Yellow - Track as processed successfully, but with Flags
  • Orange - Mismatch status
  • Light Gray - Unformatted

Cell Indicators

In addition to color coding, grid cells may display indicators reflecting the current state or outcome:

  • R - Track is currently being read
  • Bad sector count - Number of bad sectors detected on the track

Kryoflux specific:

  • Flags - If a track has a single flag is will be displayed, otherwise +n where n is the number of flags.

Track Tooltips

Hovering over a track cell displays additional information.

The tooltip will always display the following:

  • Track nn.n
  • Header information from the .raw file (name, version, host_date, host_time)

Additional details appear when applicable:

  • Sectors: nn bad - Displayed if bad sectors were detected
  • Bad Sector Ids - Lists affected sector IDs grouped into ranges
    (for example: 1–2, 4–5, 9)
  • Unexpected Sectors - Listed individually in the format:
    C:n H:n R:n N:n (nnnn)
    Where:
    • C - Cylinder
    • H - Head
    • R - Sector ID
    • N - Size ID
  • Status - Kryoflux status
  • Flags - Kryoflux flags listed individually in the format:
    Flag: Description

Actions

Preview

Processes the first track and displays a preview of the disk contents.

  • Before a full process, preview shows:

    • Summary panel
    • Root directory only

  • After a full process, preview shows:

    • Summary panel
    • Checksums panel
    • Complete file listing

Process

Starts the conversion process using the selected options.

After processing completes, this button changes to Reprocess, allowing the same flux image set to be processed again with different settings.

Discard

Discards the currently processed image and clears the currently loaded flux image set. You can then open a different flux image set for conversion.

Console Output

Displays real-time output generated during conversion.

This output is read-only and reflects the underlying conversion process.

Save and Import Actions

Save Log (Button)

Saves the current contents of the console output window to a log file.

Import / Save

Imports or saves the processed image while keeping the dialog open.

  • Import
    Imports the image into the workspace

  • Save
    Saves the image directly to disk without importing

Import and Close / Save and Close

Performs the selected action and closes the dialog afterward.

Changing the dropdown option on one of these buttons automatically updates the other.

Close

Closes the dialog without importing or saving.

Source Selection (Multiple Devices)

If both Greaseweazle and Kryoflux are configured and the same flux image set has been processed using both devices, an additional control appears:

  • Source
    Selects which converted result is used when importing or saving.

The track grid, console output state, and status bar state are preserved when switching devices.

Status Bar

The status bar displays live status information during disk reads:

  • Device
    Displays the device used when processing (Greaseweazle or Kryoflux)

  • Track nn Side n
    Indicates the track and side currently being read

  • Action
    Displays the current operation (Reading, Retrying, Failed, Complete, Aborted, Error)

  • Total Bad Sectors
    Displays the total number of bad sectors detected during the read operation. This item appears only when one or more bad sectors are found.

  • Total Unexpected Sectors
    Displays the total number of unexpected sectors detected during the read operation. This item appears only when one or more unexpected sectors are found.

Notes

  • The original flux image set is never modified
  • Import and save actions are enabled only after processing completes
  • Auto Save Log, Output Type, Device, and Source selections are remembered between sessions
  • Auto Save Log and Output Type are stored separately per device

DiskImageTool

Core UI

Dialogs

Disk Images

Files and Directories

Flux

Clone this wiki locally