Difference between revisions of "Custom Compiler GUI"

From Valve Developer Community
Jump to: navigation, search
Line 27: Line 27:
 
=== Features ===
 
=== Features ===
  
* '''Choose unwanted textures''' — Choose the textures you wish the converter to disregard, meaning that all faces with that texture will not be converted to triangles.
+
* '''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.
  
* '''Support for Generic Map files''' — Supports the [[MAP_file_format|Generic Map]] format (used mainly in [[Goldsource]] map editors).
+
* '''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.
  
* '''Material folder selection''' — Select the materials folder to read the .[[VMT]] materials from. This is required if converting texture info, because the dimensions of the textures used are required for converting between the two types (UV vectors & shifts to UV vertex coordinates).
+
* '''Compile''' — Runs the selected compilers with the chosen settings, then performs the selected file options (if any).
  
New in 1.1.0:
+
* '''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).
* '''Convert texture info''' — Choose whether or not to convert the texture application information. If selected, it is necessary that you choose a Map Material Folder, which contains all the materials not selected in the list above it.
 
  
* '''Calc Error''' — Change this only if any errors say to do so, you may also change this if you repeatedly get an error not related to textures during conversion. In the event of errors, please increase this value. I advise a value between 0.01 and 0.00001. Lower values improve the precision of the calculations, higher values allow for larger errors in the calculations of vertices. If the map contains only vertices at integer coordinates, I advise this to be set close to its maximum value for the lowest chance of error. If you still receive errors, try removing the most complicated and/or large objects from the map.
+
* '''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).
  
{{note|'''For the conversion to work''': [[UV]] vectors in the .[[VMF]] CANNOT BE PARALLEL (the map compiler would also error if this were the case).}}
+
* '''Paths''' — Allows users to edit the paths to the compiler programs, and to folders used by the file options.
{{note|'''If 'Convert texture info' is selected''': All the NON-selected materials in the material list must exist, in their specified directory, within the user-specified material folder. (If this is not the case an error will appear, which will state the file the program is looking for, so that users can put a material there.)}}
+
 
 +
* '''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!)}}
  
 
== Version History ==
 
== Version History ==
* '''1.1.0''' — Fixed a lot of bugs, including errors in .[[VMT]] reading. Made dev/ textures auto-select when reading .[[VMF]]s. Improved the conversion method (brush corners are now calculated, rather than assumed to be plane-defining points). Added a 'Calculation Error' field, which should help solve most errors that occur. Also, fixed some bugs in the .[[VMF]] reading.
+
* '''0.9.0''' — Pre-release (no icon) for public testing.
 
 
* '''1.0.0''' — Initial release.
 
  
 
== External links ==
 
== External links ==
* [http://www.ulti-s.tk/ VMF to SMD Homepage (UltimateSniper's Den)]
+
* [http://www.ulti-s.tk/ Custom Compiler GUI Homepage (UltimateSniper's Den)]
 
* [http://www.onlynoob.webs.com/VMFtoSMD.zip Direct Download Link  (UltimateSniper's Den)]
 
* [http://www.onlynoob.webs.com/VMFtoSMD.zip Direct Download Link  (UltimateSniper's Den)]

Revision as of 22:30, 5 October 2012

Custom Compiler GUI
Author UltimateSniper
Size 160 KiB
Date 5 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

  • 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).
  • 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!)

Version History

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

External links