Pixel FX Shop
Home / Support / Docs / FX-Framework Custom Modelines Guide
FX-Framework

FX-Framework Custom Modelines Guide

Requires N64Digital firmware >= 0.140.0, a firmware < 0.140.2 requires a power cycle to read the custom modelines
Requires PFX PS1Digital firmware

For a quick start use this Modeline generator tool

This is an advanced feature for expert users.

Please read and understand section Maximum supported resolution / pixel clock frequency before proceeding!

Currently it's only possible to create progressive custom resolutions.

FX-Framework supports two custom modelines, so you can customize the HDMI output timings if needed.

After creating a custom modeline.ini this file can be uploaded via the web interface:

Format#

Modelines are stored in an .ini file, which has the following format:

[NTSC]
custom1=DISPLAY_NAME, H_TOTAL, H_ACTIVE, H_FRONT_PORCH, H_BACK_PORCH, H_SYNC_WIDTH, V_TOTAL, V_ACTIVE, V_FRONT_PORCH, V_BACK_PORCH, V_SYNC_WIDTH, H_POL, V_POL, DZ, PR, VIC
custom2=DISPLAY_NAME,...

; lines starting with a ; or # or empty lines are ignored

[PAL]
custom1=DISPLAY_NAME,...
custom2=DISPLAY_NAME,...
  • custom1 / custom2 these are the two available custom slots. One modeline cannot be spread over multiple lines.

  • DISPLAY_NAME this is the name displayed in the OSD. Can be up to 8 characters long. Currently only the NTSC names are displayed.

  • H_TOTAL / V_TOTAL Horizontal total pixels / Vertical total lines

  • H_ACTIVE / V_ACTIVE Horizontal active pixels / Vertical active lines

  • H_FRONT_PORCH / V_FRONT_PORCH Horizontal front porch width / Vertical front porch lines

  • H_BACK_PORCH / V_BACK_PORCH Horizontal back porch width / Vertical back porch lines

  • H_SYNC_WIDTH / V_SYNC_WIDTH Horizontal sync width / Vertical sync lines

  • H_POL / V_POL Polarity of the horizontal / vertical sync signal (1: positive, 0: negative)

  • DZ Default Scaler Zoom for this resolution (floating point number)

  • PR

    • Pixel repetition (0: 1x, 1: 2x, 3: 4x) send to the sink

    • PLL Pixel repetition (p:0: 1x, p:1: 2x, p:3: 4x) pixels repeated on the HDMI TX

      Requires FX-Framework >= 2.1.0

  • VIC Video Information Code, should be 0 for non standard resolutions

Pixel clock is calculated from the frame rate

Each modeline should be defined for both NTSC or PAL, otherwise FX-Framework falls back to 1080p after a region change (loading a PAL game from an NTSC console and vice versa)

Maximum supported resolution / pixel clock frequency#

The HDMI TX used is specified for a maximum pixel clock frequency (PIXEL_CLOCK) of 165MHz.

To calculate the pixel clock frequency of a custom modeline, use this formula:

  • NTSC: PIXEL_CLOCK (MHz) = H_TOTAL * V_TOTAL * 60 / 1000000

  • PAL: PIXEL_CLOCK (MHz) = H_TOTAL * V_TOTAL * 50 / 1000000

Exceeding the specified guaranteed maximum frequency will increase current consumption and will generate more heat. It also may not work on your specific unit. Monitor temperatures!

You're doing it at your own risk!

Example 1 (1440p)#

[NTSC]
custom1=1440p,2080,1920,48,80,32,1481,1440,3,34,4,1,0,6.0,0,0
[PAL]
custom1=1440p,2080,1920,48,80,32,1481,1440,3,34,4,1,0,6.0,0,0

Example 2 (540p, 1440p alternative timinigs)#

[NTSC]
custom1=540p,1112,960,33,79,40,569,540,9,19,1,1,1,2.0,0,0
custom2=1440p,2080,1920,48,80,32,1481,1440,3,34,4,1,0,6.0,0,0
[PAL]
custom1=540p,1112,960,33,79,40,569,540,9,19,1,1,1,2.0,0,0
custom2=1440p,2080,1920,48,80,32,1481,1440,3,34,4,1,0,6.0,0,0

Example 3 (1440p (1920x1440p), 1440p PR (1280x1440p, pixel repeated to 2560x1440p))#

Requires FX-Framework >= 2.1.0

[NTSC]
custom1=1440p,2080,1920,48,80,32,1481,1440,3,34,4,1,0,6.0,0,0
custom2=1440p PR,1360,1280,24,40,16,1481,1440,3,33,5,1,0,6.0,p:1,0

[PAL]
custom1=1440p,2080,1920,48,80,32,1481,1440,3,34,4,1,0,6.0,0,0
custom2=1440p PR,1360,1280,24,40,16,1481,1440,3,33,5,1,0,6.0,p:1,0

Documentation - Index