Difference between revisions of "Engine:FNA"

From PCGamingWiki, the wiki about fixing PC games
m (Sony Light Bar Support: updated template usage)
(Update launch options)
 
Line 40: Line 40:
 
|-
 
|-
 
|{{code|/gldevice:...}}
 
|{{code|/gldevice:...}}
|Force a specific renderer. Available options: OpenGL, Vulkan, D3D11, Metal
+
|Force a specific renderer. Available options: OpenGL, Vulkan, D3D11
|-
 
|{{code|/angle:1}}
 
|Attempt to use OpenGL ES 3.0 via ANGLE. Useful for rendering with D3D11, Vulkan, etc.
 
 
|}
 
|}
  

Latest revision as of 19:23, 27 October 2021

FNA
Engine - FNA - logo.svg
Developers
Website
First release date
Predecessor

FNA is an open source reimplementation of the Microsoft XNA Framework, specifically the 4.0 Refresh revision. It started as a branch of MonoGame called "MonoGame-SDL2".

The goal of the project is to recreate a fast, portable, and accurate XNA4 runtime library that prevents the need for code/content changes on the part of the XNA game developer. The currently supported platforms include Windows, GNU/Linux, and macOS, with further platform support including those supported by SDL2.

Launch Options[edit]

As of FNA 20.01, a handful of command line arguments are supported automatically by games using FNA:

Parameter Description
/enablehighdpi:1 On macOS and Wayland, attempt to use a Retina-capable window
/mojoshaderprofile:... Force a specific shader profile. Available options: glsl120, glspirv
/backbufferscalenearest:1 When scaling the game resolution, use a nearest-neighbor filter. Useful for pixel art games.
/usescancodes:1 Use scancodes for keyboard input, ignoring the user's keyboard layout
/disablelateswaptear:1 Do not use FIFO_RELAXED or EXT_swap_control_tear extension, disables adaptive VSync
/forcemailboxvsync:1 Enables triple-buffer vsync with the Vulkan renderer
/glprofile:... Force a specific OpenGL profile. Available options: es3, core, compatibility
/gldevice:... Force a specific renderer. Available options: OpenGL, Vulkan, D3D11

More detailed information about these options can be found on the FNA Developer Wiki.

Joysticks[edit]

About XNA Joystick Support[edit]

XNA, being a Microsoft technology, centered its controller input around the Xbox 360 Controller. Because of this, the XNA API is not cleanly compatible with custom controllers, including the Xbox 360 Controller when not being read by XInput. However, a config format was developed to allow binding of joystick input values to a virtual 360 controller, which then gets read by XNA games.

Automatic Configuration: SDL_GameController[edit]

Since FNA uses SDL2 as its base library, we also get the benefit of SDL_GameController, a new subsystem added by Alfred Reynolds at Valve. This takes configurations for known controllers and automatically configures them for the virtual 360 controller, so if your controller is recognized, manual configuration is not necessary. If you run an FNA title through Steam, your controller will automatically be configured using the Big Picture Mode configuration. Additionally, FNA reads from a gamecontrollerdb.txt file for configurations, when it's found in the game's base directory. You can find a community-sourced database here.

About GUIDs[edit]

In addition to expanded configuration support, FNA provides the GetGUIDEXT extension that allows XNA devs to pull in a trimmed/standardized GUID string to determine the controller hardware and react accordingly. TowerFall Ascension uses this for button icon support, for example.

Consider this GUID from the PlayStation 4 controller:

// This is the string reported by SDL2's SDL_JoystickGetGUIDString:
// https://wiki.libsdl.org/SDL_JoystickGetGUIDString
// Note characters 9-12 and 17-20.
030000004c050000c405000011010000
// This is the GUID string returned by FNA. Get it? 
4c05c405

For XInput controllers on Windows, the GUID string is simply 'xinput'.

Sony Light Bar Support[edit]

Previously only supported on Linux, FNA 21.01 introduced LED support for all operating systems.

FNA supports the DualShock 4 and DualSense light bar, although it requires game developers to make use of the SetLightBarEXT extension to set the color of the light bar by way of adjusting the brightness of the RGB LEDs.

Game Developer Publisher First release Available on
A Virus Named TOM Misfits Attic August 1, 2012
Windows
macOS (OS X)
Linux
Amorous Team Amorous Snaggletooth Studios April 13, 2018
Windows
macOS (OS X)
Linux
Apotheon Alientrap Games February 3, 2015
Windows
macOS (OS X)
Linux
Axiom Verge Thomas Happ Games May 14, 2015
Windows
macOS (OS X)
Linux
Bastion Supergiant Games Warner Bros. Interactive Entertainment, Supergiant Games August 16, 2011
Windows
macOS (OS X)
Linux
Before the Echo Iridium Studios October 20, 2011
Windows
macOS (OS X)
Linux
Bleed Bootdisk Revolution November 28, 2012
Windows
macOS (OS X)
Linux
Bleed 2 Bootdisk Revolution February 8, 2017
Windows
macOS (OS X)
Linux
Blueberry Garden Erik Svedäng June 10, 2009
Windows
macOS (OS X)
Linux
Brushwood Buddies Steven Colling February 17, 2016
Windows
Linux
Capsized Alientrap Games April 29, 2011
Windows
macOS (OS X)
Linux
Celeste Extremely OK Games January 25, 2018
Windows
macOS (OS X)
Linux
Charlie Murder Ska Studios May 12, 2017
Windows
macOS (OS X)
Linux
Chasm Bit Kid July 31, 2018
Windows
macOS (OS X)
Linux
CometStriker Iced Lizard Games January 1, 2018
Windows
macOS (OS X)
Linux
Cryptark Alientrap Games June 20, 2017
Windows
macOS (OS X)
Linux
Curse of the Crescent Isle DX Adam Mowery August 21, 2015
Windows
macOS (OS X)
Linux
Dust: An Elysian Tail Humble Hearts Microsoft Studios May 24, 2013
Windows
macOS (OS X)
Linux
Escape Goat Magical Time Bean June 14, 2012
Windows
macOS (OS X)
Linux
Escape Goat 2 Magical Time Bean Double Fine Productions March 24, 2014
Windows
macOS (OS X)
Linux
Fez Polytron Corporation Trapdoor May 1, 2013
Windows
macOS (OS X)
Linux
Fist Puncher Team2Bit Adult Swim Games June 21, 2013
Windows
macOS (OS X)
Linux
Flinthook Tribute Games April 18, 2017
Windows
macOS (OS X)
Linux
Flotilla Blendo Games, Ethan Lee February 27, 2010
Windows
macOS (OS X)
Linux
Fossil Echo Awaceb July 8, 2016
Windows
macOS (OS X)
Linux
Full Metal Furies Cellar Door Games January 17, 2018
Windows
macOS (OS X)
Linux
Gateways Smudged Cat Games June 22, 2012
Windows
macOS (OS X)
Linux
Gnomoria Robotronic Games February 23, 2016
Windows
macOS (OS X)
Linux
Growing Pains Smudged Cat Games May 28, 2014
Windows
macOS (OS X)
Linux
Hacknet Team Fractal Alligator Surprise Attack Games August 12, 2015
Windows
macOS (OS X)
Linux
Hidden in Plain Sight Adam Spragg July 16, 2014
Windows
macOS (OS X)
Linux
Hive BlueLine Games November 15, 2013
Windows
macOS (OS X)
Linux
Hyphen FarSpace Studios February 12, 2015
Windows
Linux
Jon Shafer's At the Gates Conifer Games January 23, 2019
Windows
macOS (OS X)
Linux
Khet 2.0 BlueLine Games October 1, 2014
Windows
macOS (OS X)
Linux
Little Racers Street Milkstone Studios September 27, 2012
Windows
macOS (OS X)
Linux
Melody's Escape Icetesy May 20, 2016
Windows
macOS (OS X)
Linux
Melody's Escape Icetesy May 20, 2016
Windows
macOS (OS X)
Linux
Mercenary Kings Tribute Games March 25, 2014
Windows
macOS (OS X)
Linux
MidBoss Kitsune Games May 25, 2017
Windows
macOS (OS X)
Linux
MidBoss Kitsune Games May 25, 2017
Windows
macOS (OS X)
Linux
Murder Miners JForce Games July 25, 2014
Windows
macOS (OS X)
Linux
Overdriven Reloaded TOMAGameStudio October 7, 2016
Windows
macOS (OS X)
Linux
Overdriven Reloaded TOMAGameStudio October 7, 2016
Windows
macOS (OS X)
Linux
Owlboy D-Pad Studio IndieBox November 1, 2016
Windows
macOS (OS X)
Linux
Paladin Pumpkin Games March 20, 2017
Windows
macOS (OS X)
Linux
Paladin Pumpkin Games March 20, 2017
Windows
macOS (OS X)
Linux
Panzer Paladin Tribute Games July 21, 2020
Windows
Poöf Arkedo Studio Neko Entertainment, Plug In Digital November 8, 2013
Windows
macOS (OS X)
Linux
Poöf Arkedo Studio Neko Entertainment, Plug In Digital November 8, 2013
Windows
macOS (OS X)
Linux
Press X to Not Die All Seeing Eye Games October 6, 2017
Windows
macOS (OS X)
Linux
Quadrilateral Cowboy Blendo Games July 25, 2016
Windows
macOS (OS X)
Linux
Reus Abbey Games May 16, 2013
Windows
macOS (OS X)
Linux
Rex Rocket Castle Pixel August 5, 2014
Windows
macOS (OS X)
Linux
River City Ransom: Underground Conatus Creative February 27, 2017
Windows
macOS (OS X)
Linux
Rogue Legacy Cellar Door Games June 27, 2013
Windows
macOS (OS X)
Linux
Salt and Sanctuary Ska Studios May 17, 2016
Windows
macOS (OS X)
Linux
Shipwreck Brushfire Games February 25, 2014
Windows
macOS (OS X)
Linux
Skulls of the Shogun 17-BIT July 29, 2013
Windows
macOS (OS X)
Linux
Slipstream ansdor May 21, 2018
Windows
macOS (OS X)
Linux
Solaroids: Prologue DynF/X Digital
Windows
macOS (OS X)
Linux
Soulcaster Magical Time Bean February 10, 2012
Windows
macOS (OS X)
Linux
Soulcaster II Magical Time Bean February 10, 2012
Windows
macOS (OS X)
Linux
SpeedRunners DoubleDutch Games, tinyBuild tinyBuild April 19, 2016
Windows
macOS (OS X)
Linux
Star-Twine Eric Billingsley April 29, 2011
Windows
macOS (OS X)
Linux
Staxel Plukit Humble Games April 11, 2019
Windows
macOS (OS X)
Linux
Streets of Rage 4 Lizardcube, Guard Crush Games, DotEmu, BlitWorks DotEmu, Yooreka Studio April 30, 2020
Windows
macOS (OS X)
Linux
Sumico - The Numbers Game Ludomotion July 3, 2015
Windows
macOS (OS X)
Linux
Super Bernie World Gamedevs for Bernie Kitsune Games March 9, 2020
Windows
macOS (OS X)
Linux
Super Rad Raygun TRU FUN Entertainment Rooster Teeth Games November 8, 2016
Windows
macOS (OS X)
Linux
Terraria Re-Logic May 16, 2011
Windows
macOS (OS X)
Linux
The Adventures of Shuggy Smudged Cat Games June 13, 2012
Windows
macOS (OS X)
Linux
The Dishwasher: Vampire Smile Ska Studios May 12, 2017
Windows
macOS (OS X)
Linux
Timespinner Lunar Ray Games Chucklefish Games September 25, 2018
Windows
macOS (OS X)
Linux
Tooth and Tail Pocketwatch Games September 12, 2017
Windows
macOS (OS X)
Linux
TowerFall Ascension Extremely OK Games March 11, 2014
Windows
macOS (OS X)
Linux
Transistor Supergiant Games May 20, 2014
Windows
macOS (OS X)
Linux
Unexplored Ludomotion February 22, 2017
Windows
macOS (OS X)
Linux
Unrailed! Indoor Astronaut Daedalic Entertainment, bilibili September 23, 2020
Windows
macOS (OS X)
Linux
Wizorb Tribute Games November 7, 2011
Windows
macOS (OS X)
Linux
Wyv and Keep: The Temple of the Lost Idol A Jolly Corpse August 14, 2013
Windows
macOS (OS X)
Linux

References