View as Markdown

Graphics Mill Configuration

You can configure the settings of the application in the App.config file. This file is in the root folder of the application. You can also set the same parameters in code.

Important

The .NET 9 build of Graphics Mill does not read App.config. If your project targets .NET 9 or higher, set the parameters in code. See Using Graphics Mill in .NET projects for details.

Application Settings

The following snippet shows available parameters of the Graphics Mill application, which you can set up in App.config with their default values.

XML 
<configuration>
	<appSettings>
		<add key="GraphicsMillTempPath" value="C:\gm_temp" />
		<add key="GraphicsMillLicenseKey" value="" />
		<add key="GraphicsMillEnableTelemetry" value="true" />
	</appSettings>
</configuration>

Let's look at these parameters in more detail.

Name Description Possible values
GraphicsMillTempPath The path to the temporary folder used by Graphics Mill. The default value is "C:\gm_temp". This can also be set in code using Aurigma.GraphicsMill.Configuration.TempPath. folder path
GraphicsMillLicenseKey The license key for Graphics Mill. For example, "80FF0-112E8-123B6-81238-94D4C-FE0123". This can also be set in code using Aurigma.GraphicsMill.Licensing.License.Set. string
GraphicsMillEnableTelemetry Enables or disables telemetry data collection. Telemetry includes runtime counters of feature usage (e.g., how many times you use specific functions). This setting applies only to developer and floating license keys. Other key types do not send any data. The default value is "true". This can also be set in code using Aurigma.GraphicsMill.Configuration.IsTelemetryEnabled. "true" (enabled) / "false" (disabled)

Code Configuration

In addition to configuring settings in the App.config file, you can also set these parameters directly in your code. This is the only way to set them in the .NET 9 build.

  • TempPath: Set the temporary path by assigning a value to Configuration.TempPath. The folder must exist.
    C# 
    Aurigma.GraphicsMill.Configuration.TempPath = @"C:\custom_temp";
  • License: Set the license key by calling License.Set(String).
    C# 
    Aurigma.GraphicsMill.Licensing.License.Set("your-license-key-here");
  • IsTelemetryEnabled: Enable or disable telemetry by assigning a boolean value to Configuration.IsTelemetryEnabled.
    C# 
    Aurigma.GraphicsMill.Configuration.IsTelemetryEnabled = false;