Release version 0.3.0

Author: ItEndsWithTens

Quinstance/Properties/AssemblyInfo.cs

@@ -32,5 +32,5 @@
 // You can specify all the values or you can default the Build and Revision Numbers
 // by using the '*' as shown below:
 // [assembly: AssemblyVersion("1.0.*")]
-[assembly: AssemblyVersion("0.2.2.0")]
-[assembly: AssemblyFileVersion("0.2.2.0")]
+[assembly: AssemblyVersion("0.3.0.0")]
+[assembly: AssemblyFileVersion("0.3.0.0")]

Quinstance/lib/vmfii/vmfii.exe

@@ -1,4 +1,4 @@
-Quinstance 0.2.2
+Quinstance 0.3.0
 ================
 
 A wrapper around VMFInstanceInserter, enabling the use of func_instances in
@@ -52,6 +52,10 @@ Usage
         Specify the directory in which to store temporary files. Defaults to the
         user's temp directory.
 
+      -r, --remove_entities [optional]
+        A comma-separated list of entities to remove from all input files. Allows
+        placeholder geometry in editors which don't display instance contents.
+
 
 Background
 ----------
@@ -148,6 +152,20 @@ Quinstance and compiled, a copy of the other map's contents will have appeared
 where the func_instance once was, offset from the entity by the same amount they
 were offset from their map's origin.
 
+No editors currently display instance contents, so in your viewports you'll see
+only a point entity representing each func_instance. To make editing easier, you
+can build simple placeholder geometry and tie it to a brush entity that then
+gets removed by Quinstance.
+
+A basic definition for such an entity, func_placeholder, is provided by the
+included FGD and ENT files, but in some editors you can also manually change an
+entity's classname. You can use any name you want, actually, as long as it's
+unique and not shared with entities you want to keep. Then just add
+
+  --remove_entities func_placeholder
+
+to your Quinstance command line and those will be removed from the final output.
+
 
 func_instance
 -------------
@@ -186,13 +204,38 @@ For more information about func_instances as they're implemented in the Source
 engine, see https://developer.valvesoftware.com/wiki/Func_instance
 
 
+func_placeholder
+----------------
+
+A brush entity for placeholder geometry, to make mapping easier in editors that
+don't show func_instance contents. This classname is only a sample: Quinstance
+will remove all entities matching its --remove_entities parameter, which to be
+clear is a comma separated list.
+
+For example, if you tied some temporary brushwork to func_placeholder, and want
+to remove it, you could try this:
+
+  quinstance input.map --fgd quake.fgd --remove_entities func_placeholder
+
+But now let's say you ignored func_placeholder, and defined your own by manually
+editing a brush entity's classname. Let's say you chose func_greybox, for the
+sake of demonstration. You also want to remove all grunts from your map for some
+reason, and use a shorter command line as well. In that case, this would do:
+
+  quinstance input.map -f quake.fgd -r func_greybox,monster_army
+
+
 Changes
 -------
 
+0.3.0 - September 18th, 2016
+  Fix FGD preprocessing for certain input
+  Add entity removal, to allow placeholder geometry
+
 0.2.2 - August 16th, 2016
   Improve configuration instructions
   Update VMFII
-  
+
 0.2.1 - October 25th, 2015
   Fix worldspawn handling for some maps
   Fix calling VMFII in Linux/OSX

README.txt

@@ -24,4 +24,8 @@ Keys:
 <string key="replace10" name="Replace">If you need more than ten replacements, don't forget you can add keys manually: replace11, replace12, etc.</string>
 
 </point>
+
+<group name="func_placeholder">
+Placeholder geometry, to be removed with the --remove_entities option of Quinstance 0.3.0 and later.
+</group>
 </classes>

extra/func_instance.ent

@@ -13,12 +13,12 @@
 // robert.martens@gmail.com
 // @ItEndsWithTens
 //
-// October 18th, 2015
+// September 18th, 2016
 
 
 // Jackhammer
 //
-// JH is the editor I use most often, and version 1.1.700 is where I've done
+// J.A.C.K. is the editor I use most, and version 1.1.1064 is where I've done
 // most of my testing so far. Other editors may or may not be able to load this
 // file, so please be prepared for failure!
 
@@ -51,6 +51,12 @@
 	replace10(string) : "Replace" : : "If you need more than ten replacements, don't forget you can turn off SmartEdit (if applicable) and add keys manually: replace11, replace12, etc."
 ]
 
+@SolidClass = func_placeholder : "Placeholder geometry, to be removed with the --remove_entities option " +
+  "of Quinstance 0.3.0 and later."
+[
+]
+
+
 
 // TrenchBroom
 //
@@ -81,3 +87,7 @@
 //	replace09(string) : "Replace" : ""
 //	replace10(string) : "Replace" : ""
 //]
+//
+//@SolidClass = func_placeholder : "Placeholder geometry, to be removed with the --remove_entities option of Quinstance 0.3.0 and later."
+//[
+//]