Cmc - Revision history

John: /* Installation */

2018-01-23T05:11:47Z

‎Installation

John at 11:50, 4 January 2018

2018-01-04T11:50:48Z

John: /* Maps built with CMC */

2013-11-29T05:25:13Z

‎Maps built with CMC

Gsigms: /* Creating the clip model map */

2012-01-30T09:22:11Z

‎Creating the clip model map

Gsigms at 14:42, 6 January 2012

2012-01-06T14:42:00Z

Gsigms: /* Creating the clip model map */

2011-09-16T13:42:10Z

‎Creating the clip model map

Gsigms: /* Requirements */

2011-09-16T13:39:39Z

‎Requirements

Rylius: /* Set up */

2011-09-13T15:15:47Z

‎Set up

Pickles at 13:43, 9 September 2011

2011-09-09T13:43:16Z

Gsigms at 13:31, 9 September 2011

2011-09-09T13:31:47Z

@@ Line 17: / Line 17: @@
 === Installation ===
-[http://www.custommapmakers.org/resources/cmc.zip Download CMC] from Custom Map Makers. The Zip archive contains a one file python program. Unzip and copy it to a conveniant location.
+[http://www.custommapmakers.org/resources/cmc.zip Download CMC] from Custom Map Makers. The Zip archive contains a one file python program. Unzip and copy it to a convenient location.
 === Creating a ''clip model'' ===

@@ Line 1: / Line 1: @@
 == CMC ==
-[http://www.custommapmakers.org/storage/resources/cmc.zip CMC] is a commandline tool for semi-automatic clipping of models for Q3map2 map files. The approach carried by CMC is to automatically insert clip brushes into a map file following a "clip model" (''ie,'' a standalone map file) provided by the user. CMC consists of a python script and is licensed under beerware revision 42. Beware, the licence will be strongly enforced.
+[http://www.custommapmakers.org/resources/cmc.zip CMC] is a commandline tool for semi-automatic clipping of models for Q3map2 map files. The approach carried by CMC is to automatically insert clip brushes into a map file following a "clip model" (''ie,'' a standalone map file) provided by the user. CMC consists of a python script and is licensed under beerware revision 42. Beware, the licence will be strongly enforced.
 {{Warning|Don't blame the tool if you forgot to backup your map...}}
@@ Line 17: / Line 17: @@
 === Installation ===
-[http://www.custommapmakers.org/storage/resources/cmc.zip Download CMC] from Custom Map Makers. The Zip archive contains a one file python program. Unzip and copy it to a conveniant location.
+[http://www.custommapmakers.org/resources/cmc.zip Download CMC] from Custom Map Makers. The Zip archive contains a one file python program. Unzip and copy it to a conveniant location.
 === Creating a ''clip model'' ===

← Older revision		Revision as of 05:25, 29 November 2013
Line 140:		Line 140:
	* '''Azurea''': ut4_azurea_a1 is a jump map and the main motivation for building CMC. The flameholders that are also used in this tutorial have been clipped with CMC.		* '''Azurea''': ut4_azurea_a1 is a jump map and the main motivation for building CMC. The flameholders that are also used in this tutorial have been clipped with CMC.
	* '''Bus Stop''': ut4_bus_stop_b2 is a frag map by JohnnyEnglish. Johnny used CMC to clip various models (buses, seats, garbages).		* '''Bus Stop''': ut4_bus_stop_b2 is a frag map by JohnnyEnglish. Johnny used CMC to clip various models (buses, seats, garbages).
		+
		+	Most recently
		+
		+	* '''Nightmare xmas''', a map with a lot of small models (trim, coffins, lights. presents), 12 clips used with 170 models

@@ Line 102: / Line 102: @@
+    {
       qer_trans .4
       surfaceparm nodraw
       surfaceparm nolightmap

← Older revision		Revision as of 14:42, 6 January 2012
Line 134:		Line 134:
	python ./cmc.py --unclip textures/test/autoclip \		python ./cmc.py --unclip textures/test/autoclip \
	-o maps/test_unclipped.map maps/test_clipped.map		-o maps/test_unclipped.map maps/test_clipped.map
		+
		+	== Maps built with CMC ==
		+
		+	* '''Azurea''': ut4_azurea_a1 is a jump map and the main motivation for building CMC. The flameholders that are also used in this tutorial have been clipped with CMC.
		+	* '''Bus Stop''': ut4_bus_stop_b2 is a frag map by JohnnyEnglish. Johnny used CMC to clip various models (buses, seats, garbages).

@@ Line 108: / Line 108: @@
       surfaceparm slick
+    }
 You can optionally remove the brazier model. CMC will ignore it anyway.
 Save the ''clip model'' map

← Older revision		Revision as of 13:39, 16 September 2011
Line 10:		Line 10:

	CMC requires a working Python environment, and the argparse library (shipped with Python starting from version 2.7).		CMC requires a working Python environment, and the argparse library (shipped with Python starting from version 2.7).
		+
		+	For Python versions prior to 2.7, easy_install is a convenient way to install python library (may require root privileges).
		+
		+	easy_install argparse

	=== Installation ===		=== Installation ===

@@ Line 79: / Line 79: @@
 === Set up ===
-For this tutorial, you need to set up a map "test.map". This can be a simple rectangular room ([[Create your first room]]). Add a model into your map ([[Radiant:Using#How_to_add_a_model]]), this can be any kind of model (''eg,'' md3, ase). In this example we have a rectangular room containing two instance of a brazier model "model/test/brazier.ase". One instance is scaled/rotated in an awkward fashion, to illustrate CMC features.
+For this tutorial, you need to set up a map "test.map". This can be a simple rectangular room ([[Mapping:Create your first room]]). Add a model into your map ([[Radiant:Using#How_to_add_a_model]]), this can be any kind of model (''eg,'' md3, ase). In this example we have a rectangular room containing two instance of a brazier model "model/test/brazier.ase". One instance is scaled/rotated in an awkward fashion, to illustrate CMC features.
 [[File:Cmc-test-map.png|thumb|center|700px|Cmc-test-map.png]]

@@ Line 1: / Line 1: @@
 == CMC ==
-[http://www.custommapmakers.org/storage/resources/cmc.zip CMC] is a commandline tool for semi-automatic clipping of models for Q3map2 map files. The approach carried by CMC is to automaticaly insert clip brushes into a map file following a "clip model" (''ie,'' a standalone map file) provided by the user. CMC consists of a python script and is licenced under beerware revision 42. Beware, the licence will be strongly enforced.
+[http://www.custommapmakers.org/storage/resources/cmc.zip CMC] is a commandline tool for semi-automatic clipping of models for Q3map2 map files. The approach carried by CMC is to automatically insert clip brushes into a map file following a "clip model" (''ie,'' a standalone map file) provided by the user. CMC consists of a python script and is licensed under beerware revision 42. Beware, the licence will be strongly enforced.
 {{Warning|Don't blame the tool if you forgot to backup your map...}}
@@ Line 7: / Line 7: @@
 == Usage ==
-=== Requierements ===
+=== Requirements ===
 CMC requires a working Python environment, and the argparse library (shipped with Python starting from version 2.7).
@@ Line 17: / Line 17: @@
 === Creating a ''clip model'' ===
-Create an new map, import the model to clip for reference and place its origin at the center of the map (''ie,'' at coordinates 0 0 0), do not rotate or scale the model. Create the clip brush around your model, once finished you can remove the model and save the ''clip model'' map.
+Create a new map, import the model to clip for reference and place its origin at the centre of the map (''ie,'' at coordinates 0 0 0), do not rotate or scale the model. Create the clip brush around your model, once finished you can remove the model and save the ''clip model'' map.
 === Commandline argument ===
@@ Line 59: / Line 59: @@
      --output maps/mymap_clipped.map
-This instruct CMC to output the new map into the file "maps/mymap_clipped.map" (highly recommended). Without this option, CMC will overwrite the input file
+This instructs CMC to output the new map into the file "maps/mymap_clipped.map" (highly recommended). Without this option, CMC will overwrite the input file
      --clip models/mapobjects/mymodel/mymodel.md3:maps/clip_pattern.map
-This instruct CMC to clip every instance of model "models/mapobjects/mymodel/mymodel.md3" (This is not the path to the md3 file, but the model name as it appears in the entity window in GtkRadiant), according to the clip model from file maps/clip_pattern.map.
+This instructs CMC to clip every instance of model "models/mapobjects/mymodel/mymodel.md3" (This is not the path to the md3 file, but the model name as it appears in the entity window in GtkRadiant), according to the clip model from file maps/clip_pattern.map.
 ==== Clipping multiple models at once<br/> ====
@@ Line 79: / Line 79: @@
 === Set up ===
-For this tutorial, you need to set up a map "test.map". This can be a simple rectangular room ([[Create your first room]]). Add a model into your map ([[Radiant:Using#How_to_add_a_model]]), this can be any kind of model (''eg,'' md3, ase). In our example is a rectangular room containing two instance of a brazier model "model/test/brazier.ase". One instance is scaled/rotated in a awkard fashion, to illustrate CMC features.
+For this tutorial, you need to set up a map "test.map". This can be a simple rectangular room ([[Create your first room]]). Add a model into your map ([[Radiant:Using#How_to_add_a_model]]), this can be any kind of model (''eg,'' md3, ase). In this example we have a rectangular room containing two instance of a brazier model "model/test/brazier.ase". One instance is scaled/rotated in an awkward fashion, to illustrate CMC features.
 [[File:Cmc-test-map.png|thumb|center|700px|Cmc-test-map.png]]
@@ Line 89: / Line 89: @@
 Create a new map called "brazier_clip.map".
-To help us draw our clip brushes, import one brazier model into the map, and place the model origin at the center of the map (''ie,'' coordinates (0 0 0)). It is important that the model must not be rotated or scaled here.
+To help us draw our clip brushes, import one brazier model into the map, and place the model origin at the centre of the map (''ie,'' coordinates (0 0 0)). It is important that the model must not be rotated or scaled here.
 Now create the clip brushes around your model. It is not necessary to precisely cover every detail of the model. The purpose of a clip is to be accurate enough without being too complex. In our example, only the rough form of the base has been clipped.
-Apply a "clip" shader to the newly created brushes. A clip shader is provided in the "common" shader script. But for CMC, we recommend using a dedicated shader only for CMC purpose. We will later see that this will come handy for future modifications. Here, we used a new shader called "textures/test/autoclip":
+Apply a "clip" shader to the newly created brushes. A clip shader is provided in the "common" shader script. But for CMC, we recommend using a dedicated shader only for CMC purpose. We will later see that this will become handy for future modifications. Here, we used a new shader called "textures/test/autoclip":
      textures/test/autoclip
@@ Line 124: / Line 124: @@
 === Because nothing is right the first time ===
-You might realize later that your clip model brushes need some modifications. Or you may to add new instances of your model and want CMC to clip them for you. Sadly, as of today CMC has no way of tracking models that have been clipped or replace clip brushes with a new pattern. With CMC you must first remove the clip brushes before reapplying a new clip model else you map might have duplicated clip brushes.
+You might realize later that your clip model brushes need some modifications. Or you may want to add new instances of your model and want CMC to clip them for you. Sadly, as of today CMC has no way of tracking models that have been clipped or replace clip brushes with a new pattern. With CMC you must first remove the clip brushes before reapplying a new clip model else you map might have duplicated clip brushes.
-Hopefully, if you followed this tutorial recommendation to use a dedicated clip shader, CMC will help you do that. CMC allows you to remove every brush that have at least one face with a given shader from you map. To do that run the following command.
+Hopefully, if you followed this tutorial recommendation to use a dedicated clip shader, CMC will help you do that. CMC allows you to remove every brush that has at least one face with a given shader from you map. To do that run the following command.
      python ./cmc.py --unclip textures/test/autoclip \
       -o maps/test_unclipped.map maps/test_clipped.map