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:
- Refer to FX-Framework-WebUI.html for how to connect to 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/custom2these are the two available custom slots. One modeline cannot be spread over multiple lines. -
DISPLAY_NAMEthis is the name displayed in the OSD. Can be up to 8 characters long. Currently only the NTSC names are displayed. -
H_TOTAL/V_TOTALHorizontal total pixels / Vertical total lines -
H_ACTIVE/V_ACTIVEHorizontal active pixels / Vertical active lines -
H_FRONT_PORCH/V_FRONT_PORCHHorizontal front porch width / Vertical front porch lines -
H_BACK_PORCH/V_BACK_PORCHHorizontal back porch width / Vertical back porch lines -
H_SYNC_WIDTH/V_SYNC_WIDTHHorizontal sync width / Vertical sync lines -
H_POL/V_POLPolarity of the horizontal / vertical sync signal (1: positive,0: negative) -
DZDefault 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 TXRequires FX-Framework >= 2.1.0
-
-
VICVideo Information Code, should be0for 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
