About Resolution Presets in XML Format

By default, resolution presets used by Harmony are stored in a file named resolution.conf which defines each preset using a very basic format, where each preset is defined using a line, and each of its properties are separated by spaces.

If you edit or create a resolution preset in Harmony, your resolution presets file will be saved as resolution.xml, in the same directory, and the presets will be defined in XML format. From that point on, the resolution.conf file will be ignored. Therefore, if you want to manually edit your resolution presets for a database, an environment or a job, and the corresponding directory contains both a resolution.conf and a resolution.xmlfile, you must edit the resolution.xml file.

The resolution.xml file is formatted like in the example below:

<!DOCTYPE resolutions> <!--This file defines the scene resolutions available to the program.--> <!--The default version of this file can be found in "<Application Folder>/etc" --> <!--You may copy this file to /USA_DB/jobs/your_job for job specific resolutions--> <!--or /USA_DB/environments/your_environment for environment wide resolutions.--> <!--You may add any resolution to this file that you frequently use in your scenes.--> <!----> <!--The syntax follows standard xml format, which each tag followed by its value.--> <!--The "custom" keyword means that this resolution was created by a user.--> <!--The "FPS" keyword specifies the number of frames per second.--> <!--The "fovFit" specifies the field of view. It is either vertical, horizontal, or custom, with the latter expressed--> <!--as an angle in degrees that specifies a custom field of view. If unspecified, horizontal fitting is used.--> <!--The "projectionType" is either "perspective" or "orthographic". If unspecified, a perspective projection is used.--> <resolutions> <default name="HDTV_1080p24"/> <resolution FPS="24" fovFit="vertical" projectionType="perspective" resX="1920" resY="1080" name="HDTV_1080p24"/> <resolution FPS="25" fovFit="vertical" projectionType="perspective" resX="1920" resY="1080" name="HDTV_1080p25"/> <resolution FPS="24" fovFit="vertical" projectionType="perspective" resX="1280" resY="720" name="HDTV_720p24"/> <resolution FPS="24" fovFit="vertical" projectionType="perspective" resX="3840" resY="2160" name="4K_UHD"/> <resolution FPS="24" fovFit="vertical" projectionType="perspective" resX="7680" resY="4320" name="8K_UHD"/> <resolution FPS="24" fovFit="vertical" projectionType="perspective" resX="2048" resY="1080" name="DCI_2K"/> <resolution FPS="24" fovFit="vertical" projectionType="perspective" resX="4096" resY="2160" name="DCI_4K"/> </resolutions>

As you can see, its format is very similar to resolution.conf, except that it uses an XML structure constructed like so:

<!DOCTYPE resolutions> <resolutions> <!--Resolution presets go here--> </resolutions>

Inside the <resolutions> block, the first line is a <default> tag, which defines the default resolution preset to use when creating a scene, in this format:

<default name="preset name"/>

Then, each <resolution> tag defines a single resolution preset, in this format:

<resolution FPS="frame rate" fovFit="field of view" projectionType="projection type" resX="width" resY="height" name="preset name"/>

Similar to the lines in resolution.conf, each <resolution> tag contains the following attributes:

  • FPS: The amount of frames to play per second.
  • fovFit: The angle of the camera lense. It can be set to vertical to make the camera cone fit the height of the camera field, to horizontal to make the camera cone fit the width of the camera field, or to an angle in degrees. If unspecified, the field of view is made to fit horizontally.
  • projectionType: How elements are projected in the 3D space. It can either be perspective or orthographic. If unspecified, the projection will be set to perspective.

    NOTE Orthographic projection is only available in Harmony Premium.
  • resX: The width of the scene in pixels.
  • resY: The height of the scene in pixels.
  • name: The name of the resolution. This is used to select the resolution preset in the Scene Settings dialog, the default resolution and the resolution in which to render a scene.