Skip to content

02. Usage

Jump to bottom
3Dickulus edited this page Jan 30, 2021 · 7 revisions

Table of Contents

Desktop Usage

Run from the desktop by clicking the icon for the executable file. You can drag and drop .frag , .fragparams and .png image files onto the main window and Fragmentarium will open a new tab for a .frag file or apply the parameter settings to the current fragment. Settings are stored in screen shot png files in a chunk named "frAg" and are automatically recognized by Fragmentarium.

Commandline Usage

Usage: ./Fragmentarium-2.5.5 [options] [filename.frag]

Fragmentarium is a cross-platform IDE for exploring pixel based GPU graphics.

Options: 

  -h, --help                    Displays this help.
  -v, --version                 Displays version information.
  --verbose <bool>              Sets reporting of shader variables and other
                                things to console.
  -a, --autorun <bool>          Execute auto-compile-run cycle at program
                                start.
  --style <stylename>           Sets the application GUI style.
                                Possible values are
                                'Breeze','bb10dark','bb10bright','cleanlooks','g
                                tk2','cde','motif','plastique','QtCurve','Window
                                s','Fusion'.
  --qstylesheet <qss filename>  Sets the application stylesheet. The value must
                                be a path to a valid .qss file.
  --editortheme <theme>         Sets the colour theme for the text editor.
                                Possible values are Default, Dark, Light, Retta
  -l, --language <language>     sets the application language.
                                Possible values are 'en','de','ru','nl'.
  -s, --script <fqs filename>   Fragmentarium script file to load. Must be
                                ".fqs" filename extention.
  -c, --compatpatch <bool>      Attempt to allow legacy shaders to run under
                                modern GL core profile.

Arguments: 

  filename.frag                 initial fragment to open.

Troubleshooting

OpenGL

FragM 2 requests OpenGL 4.5 Compatibility Profile on linux and Windows, OpenGL 4.1 Core for OSX and can be compiled for OpenGL 3.2. Some drivers provide a lower version in Compatibility Profile, reserving higher versions for Core Profile.

Check it : 

   glxinfo | grep "core profile"

Unfortunately if FragM gets a version it doesn't know how to deal with it can crash on startup with a segmentation fault.

Mesa

Check if you are using MESA: 

  glxinfo | grep version

If using Mesa for OpenGL (most commonly on Linux with Free/Libre Open Source drivers) you can force Mesa to lie about its capabilities by setting an environment variable in the shell before launching FragM: 

  export MESA_GL_VERSION_OVERRIDE="4.6COMPAT"

This may however merely postpone crashes until unsupported features are invoked. Use at your own risk.

Note

Please read the Fragmentarium FAQ for info about the GPU watchdog on Windows if startup is ok but heavy rendering shuts down the program.

Clone this wiki locally