Custom Compiler GUI

From Valve Developer Community
Revision as of 11:34, 6 October 2012 by UltimateSniper (talk | contribs)

Jump to: navigation, search
Custom Compiler GUI
Author UltimateSniper
Size 160 KiB
Date 6 Oct 2011
Current Version 0.9 (Pre-Release)
Prerequisites .NET Framework 4.0
Download

Custom Compiler GUI is a Graphical User Interface (GUI) for a/set of compiler(s). Essentially, it is allows users to change the settings for the compiler(s) they wish to run, but it is configurable for any (set of) compiler(s). It allows a "modder" to generate a configuration file, which contains information about the compiler(s). This is used by the program to display options to the user.

This tool is aimed mainly at mappers & modellers, who require compiler set-ups for more than one (set of) compiler(s) (eg. studiomdl for modelling, and the map compilers for mapping). Although, it can be used by anyone, for pretty much any program with a "standardoutput" (same message output as console command-line applications), and returns a non-zero exit code on erroring.

Features

Main Window

  • Compile Options — In the case of more than one compiler program, this tab has a list of the compilers at the top of the tab, with the properties/settings of the selected compiler on display underneath. Only the compilers that are ticked in the list will be used when "Compile" is clicked. In the case of one compiler, only the properties/options of that compiler are permanently on display.
  • File Options — This tab only appears in the case of the config containing options to copy/move/delete files after the compile process. It allows users to select which of those options they wish to be performed.
  • Compile — Runs the selected compilers with the chosen settings, then performs the selected file options (if any).
  • Tools => Create/Edit Config — Allows a "modder" to edit or create a configuration file, defining the command(s), and their respective value type(s) and default(s), of the compiler(s). More info on how to do this is here.
  • Tools => Create Shortcut — Creates a custom shortcut to start the program with the chosen configuration file (basically, a shortcut to a different compiler set-up).
  • Paths — Allows users to edit the paths to the compiler programs, and to folders used by the file options.
  • Settings => Save Settings — Saves the current settings for this configuration.
  • Settings => Open Settings — Opens settings for this configuration.
  • Settings => Reset Settings — Resets the settings to their default values.
Note:To open settings: Settings file must have been saved with the same configuration as the one that's currently loaded. (You can't import model compiler settings for a map compiler!)

Config Editor

There are 4 top-level items in the tree-view.

Generic

Generic settings for the configuration, has 2 properties:

  • FileFilter — The filter for browsing the source file for the first compiler.
  • Name — The name of the configuration.

Compilers

Collection of compiler definitions/settings. To add settings for a new compiler, select "Compilers" in the tree-view (on the left), and click "Add" (to remove, select the compiler and click "Remove"). The new compiler's properties should then be displayed, which are as follows:

  • CompilerName — File name of the compiler.
  • Format — (Read-only) Example of the command line format given to the compiler.
  • InputType — (Optional) The ending of the file name of the input file for this compiler (leave blank for first compiler).
  • Messages — Whether the GUI console should be shown and the compiler window hidden, or compiler window shown, or the user can decide.
  • Name — The displayed name of the compiler (must be unique).

Each compiler has a collection of commands. To add a command, select the compiler in the tree-view and click "Add" (to remove, select the command and click "Remove"). The new command's properties should then be displayed, which are as follows:

  • Category — (Optional) An arbitrary category (group) name this command belongs to.
  • Command — The command (eg. -random).
  • Description — A description for the command that users see.
  • Editor — The editor users can use to modify the command's value(s), it must be expanded (click on the "+") to be modified.
  • Format — (Read-only) Example of the command line segment made by this command.
  • Name — The displayed name of the command (must be unique within the compiler).
  • ReadOnly — Whether users can modify the value of this command.
  • Values — The collection of values for this command. To modify, click on the browse (...) button.

Each command has a collection of values, whose names are only important if there is more than 1 in the command. If the command is a boolean (on/off) command (ie. with no actual value), there must be 1 value of the "Boolean" type (this is the default). Once selected in the list, the value's properties are shown on the right-side of the window, which are as follows:

  • Name —
  • Folders — Collection of folder definitions/settings.
  • File Options — Collection of defined file operations.

Generic has 2 properties:

Version History

  • 0.9.0 — Pre-release (no icon) for public testing.

External links