WIP
DirectOutput framework for virtual pinball cabinets WIP
Go to:
Overview 
Global Configuration

Introduction

Note
Global config settings have changed for release 2 of the DirectOutput framework. If you are upgrading to the new version, be sure to create a new global config file using the global config editor.

The global configuration of the DirectOutput framework defines which files the system loads for the Cabinet and Table configuration as well as the options for logging.

Depending on the interface used to communicate with the framework, different global configuration files are loaded.

For the B2S.Server Plugin the configuration file "GlobalConfig_B2SServer.xml" is loaded. The framework is searching for this file in the following locations:

  • A directory named config withing the directory of the DirectOutput.dll.
  • A shortcut to a directory withing the directory of the DirectOutput.dll named config.
  • Table directory.
  • Directory of the DirectOutput.dll.

Global config editor

In the directory where you have installed the DirectOutput framework, you can also find the global configuration editor (GlobalConfigEditor.exe).

This tool allows you to define the settings for the global configuration.

In the file menu you find the usual commands for loading and saving.

The editor has several tabs for the different aspects of the gobal config settings.

Ini Files tab

GlobalConfigEditor_IniFiles.png
Ini Files tab

The ini files table contains the settings for ini files.

Usually DOF will try to find the ini files with the table configurations in one of the following directories:

  • Directory of the table file
  • Global config directory
  • Directory where the DirectOutput.dll is located

If you prefer to store your ini files in another directory, you'll have to enter the path to this directory in Ini Files Path textbox.

Cabinet Config tab

GlobalConfigEditor_Cabinet.png
Cabinet Config tab

The cabinet config tab allows you to specify the cabinet config file to be used.

If you use no cabinet config file (not needed if you just use one or several LedWiz, PacDrive or Pacled64 devices) keep this setting empty. If you have defined a cabinet config file, specify the name and path of your cabinet config file.

This setting supports wildcards (* represents any number of characters, ? represents one character). In addition the following placeholders are supported:

  • {DllDir} represents the directory of the DirectOutput.dll.
  • {GlobalConfigDir} represents the default global config directory.

Logging tab

GlobalConfigEditor_Logging.png
Logging tab

DOF can write a log file in which information about the initialization and operation of the framework is recorded.

This tab allows you to turn on and off the logging, specify the name and path for your log file and whether you want to discard the logfile for every session (good to keep the log file small).

The following placeholders can be used in the path and filename for the logfile:

  • {DllDir} represents the directory of the DirectOutput.dll.
  • {GlobalConfigDir} represents the default global config directory.
  • {TableDir} represents the full path to the directory of the table.
  • {TableDirName} represents the name of the table directory (last part of {TableDir}).
  • {TableName} represents the name of the table without extensions.
  • {RomName} is the name of the game rom.
  • {DateTime} is a timestamp containing the current date and type in the following form: yyyymmdd_hhmmss.
  • {Date} is the current date in the following form: yyyymmdd.
  • {Time} is the current time in the following form: hhmmss

Misc tab

GlobalConfigEditor_misc.png
Misc tab

In the Misc tab you can change the default intervall between commands which are sent to LedWiz units. For most installations 1ms should be just fine, but depending on the mainboard, usb hardware on the board, usb drivers and other factors the LedWiz does sometime tend to loose or misunderstand commands received if the are sent in to short intervals. This settings allows to increase the default minmal interval between commands from 1ms to a higher value. Higher values will make problems less likely, but decreases the number of possible updates of the ledwiz outputs in a given time frame. It is recommended to use the default interval of 1 ms and only to increase this interval if problems occur (Toys which are sometimes not reacting, random knocks of replay knocker or solenoids).

File format

Global config files are save in xml format. A typical global config file might looks like this:

1 <?xml version="1.0" encoding="utf-8"?>
2 
3 
4 <GlobalConfig>
5  <LedControlMinimumEffectDurationMs>60</LedControlMinimumEffectDurationMs>
6  <LedControlMinimumRGBEffectDurationMs>120</LedControlMinimumRGBEffectDurationMs>
7  <IniFilesPath>{DllDir}\config</IniFilesPath>
8  <CabinetConfigFilePattern>{DllDir}\config\cabinet.xml</CabinetConfigFilePattern>
9  <EnableLogging>true</EnableLogging>
10  <ClearLogOnSessionStart>false</ClearLogOnSessionStart>
11  <LogFilePattern>{DllDir}\DirectOutput.log</LogFilePattern>
12 </GlobalConfig>