Setting Parameters for the Application Launchers

Increasing the amount of memory that Oxygen XML Author uses on Windows and Linux

For Windows and Linux installations of Oxygen XML Author, the startup launchers for the application and its executable internal tools (Tree Editor, XML Schema Regular Expressions Builder, Large File Viewer, SVN Client, Compare Directories, and Compare Files) include a default .vmoptions file in the installation directory that contain some startup parameters (such the -Xmx parameter, which is used for allocating memory for that particular application). If your installation contains these .vmoptions files, you can edit the parameters in them so that the applications will launch with your desired values. However, if you re-install the application, install an update for the application, or deploy it to other users or machines, those parameters will be reset to their default values.

To increase the memory available to Oxygen XML Author on Windows:
  • Browse to the installation directory of Oxygen XML Author.
  • Locate the -Xmx parameter in the oxygenAuthor19.1.vmoptions file.
    Note: For 32-bit Windows modify the parameter to -Xmx1024m or larger, but not over -Xmx1200m. Make sure you do not exceed your physical RAM. For 64-bit Windows modify the parameter to a larger value (for example, -Xmx2048m). We recommended you to not use more than half of your existing physical RAM.

Restart Oxygen XML Author. Go to Help > About and verify the amount of memory that is actually available (see the JVM Memory Used in the last row in the Copyright tab). If Oxygen XML Author does not start and you receive and error message saying that it could not start the JVM, decrease the -Xmx parameter and try again.

For Windows Vista/7/8/10, copy the oxygenAuthor19.1.vmoptions to your desktop (or to any other folder with write access), modify it there, then copy it back to the Oxygen XML Author installation folder.
Note: The parameters from the .vmoptions file are used when you start Oxygen XML Author with the oxygen launcher (or with the desktop shortcut). In case you use the command line script oxygen.bat/oxygen.sh, modify the -Xmx parameter in the script file.

Increasing the amount of memory that Oxygen XML Author uses on OS X

To increase the memory available to Oxygen XML Author on OS X:
  • Ctrl + Single-Click (Command + Single-Click on OS X) (or right-click) the Oxygen XML Author icon in Finder.
  • From the contextual menu, select Show Package Contents.
  • Go to the contents directory and edit the Info.plist file.
    Note: You can open this file either with the Property List Editor, or the TextEdit.
  • Look for the VMOptions key and adjust the -Xmx parameter to a larger value (for example, -Xmx1500m)
    Note: For a Mac kit bundled with Java 8, look for the VMOptionArray key and add the -Xmx parameter in a new string element from the array element. For example, for 1500 MB use the following:
    <string>-Xmx1500m</string>
    Tip: Try not to use more than half of your existing physical RAM if possible.

Setting a system property

To set a system property, edit the application launcher and add a parameter after the %OXYGEN_JAVA% token, using the following form:
-Dproperty.name=value
You can also set a system property through a parameter prefixed with -Doxy in the command line used to start the application:
oxygenAuthor19.1.exe "-Doxyproperty.name=value"

All system properties are displayed in the System properties tab of the About dialog box.

To view the list of Oxygen XML Author system properties, go to Custom System Properties.

Disabling DPI Scaling

Some users may prefer the look of smaller icons in an HiDPI display. To achieve this, display scaling needs to be disabled for high DPI settings. To disable the DPI scaling, set the following property in .vmoptions (or in the .bat script):
sun.java2d.dpiaware=false