User Tools
Differences
This shows you the differences between two versions of the page.
| Both sides previous revision Previous revision Next revision | Previous revision | ||
|
mapping:compiling_new [2006-07-30 00:38] 127.0.0.1 (old revision restored) |
mapping:compiling_new [2013-01-07 12:07] (current) |
||
|---|---|---|---|
| Line 1: | Line 1: | ||
| - | ====== Compiling Maps for Ca3DE ====== | + | ====== Compiling Maps for Cafu ====== |
| - | When you have finished editing a map in CaWE, you’ll want to run it with Ca3DE. The engine however requires that the map is in a precomputed form, and this section describes how you turn your map into a fully precomputed world file. The process of turning your **cmap map file** into a for the engine usable **cw world file** is called //compiling//. | + | When you have finished editing a map in CaWE, you’ll want to run it with Cafu. The engine however requires that the map is in a precomputed form, and this section describes how you turn your map into a fully precomputed world file. The process of turning your **cmap map file** into a for the engine usable **cw world file** is called //compiling//. |
| As to not force you to run the compile procedure for all your cmap files [[mapping:compiling|by hand]], the CaWE mapping editor provides a "Compile" menu with which you can easily and very conveniently accomplish this task. In this section, you'll learn how to use it. | As to not force you to run the compile procedure for all your cmap files [[mapping:compiling|by hand]], the CaWE mapping editor provides a "Compile" menu with which you can easily and very conveniently accomplish this task. In this section, you'll learn how to use it. | ||
| Line 12: | Line 12: | ||
| The upper group of menu items tells CaWE which steps of the compile process should be run. You can turn the individual parts on or off by checking or unchecking the mark in the appropriate line. | The upper group of menu items tells CaWE which steps of the compile process should be run. You can turn the individual parts on or off by checking or unchecking the mark in the appropriate line. | ||
| - | - **Save Map:** Saves the map. Checking this does exactly the same as a click on the "File -> Save" menu item before compiling the map. Having this checked is practical and recommended when you work on a map and want to test it "live" in the Ca3D-Engine every now and then, because it makes sure that the compilers pick up the latest version of your map with the most recent changes. | + | - **Save Map:** Saves the map. Checking this does exactly the same as a click on the "File -> Save" menu item before compiling the map. Having this checked is practical and recommended when you work on a map and want to test it "live" in the Cafu engine every now and then, because it makes sure that the compilers pick up the latest version of your map with the most recent changes. |
| - | - **Run CaBSP:** This is the crucial step that runs the CaBSP compiler on your map. CaBSP takes your map file and creates a world file for use by the Ca3D-Engine from it (the map file is not modified). As all other compilation steps build on this one and the generated cw file, you cannot turn it off to omit CaBSP. | + | - **Run CaBSP:** This is the crucial step that runs the CaBSP compiler on your map. CaBSP takes your map file and creates a world file for use by the Cafu engine from it (the map file is not modified). As all other compilation steps build on this one and the generated cw file, you cannot turn it off to omit CaBSP. |
| - **Run CaPVS:** Runs the CaPVS compiler on the intermediate result obtained from CaBSP. CaPVS precomputes the PVS (Potentially Visibility Set) for the world file. This can be a lengthy process on its own, and you may wish to skip it when you're just testing your map. However, it also has a potential for improving the rendering performance of your map significantly, so you should never leave this out for release maps. | - **Run CaPVS:** Runs the CaPVS compiler on the intermediate result obtained from CaBSP. CaPVS precomputes the PVS (Potentially Visibility Set) for the world file. This can be a lengthy process on its own, and you may wish to skip it when you're just testing your map. However, it also has a potential for improving the rendering performance of your map significantly, so you should never leave this out for release maps. | ||
| - **Run CaLight:** Runs the CaLight compiler on your map, which precomputes the static lighting of your maps by using physically accurate Radiosity methods. CaLight too can take very much time to complete, and should therefore never be run without a preceding CaPVS pass. However, for testing you may want to skip CaLight as well as CaPVS, because your map will be full-bright when CaLight is not run, which may be sufficient for checking e.g. the geometry or entity placement during map development. | - **Run CaLight:** Runs the CaLight compiler on your map, which precomputes the static lighting of your maps by using physically accurate Radiosity methods. CaLight too can take very much time to complete, and should therefore never be run without a preceding CaPVS pass. However, for testing you may want to skip CaLight as well as CaPVS, because your map will be full-bright when CaLight is not run, which may be sufficient for checking e.g. the geometry or entity placement during map development. | ||
| - | - **Start Engine:** If this entry is checked, Ca3DE will automatically be launched with your map when the compiling process is finished. | + | - **Start Engine:** If this entry is checked, Cafu will automatically be launched with your map when the compiling process is finished. |
| Line 29: | Line 29: | ||
| However, you can stop the entire currently running compilation process prematurely by clicking on the "Compile -> Abort" menu item. | However, you can stop the entire currently running compilation process prematurely by clicking on the "Compile -> Abort" menu item. | ||
| - | If you activated the "Start Engine" item, Ca3DE will be started when the compile process is complete and you'll just have to click on "OK" in the Ca3DE dialog to start and play your map! | + | If you activated the "Start Engine" item, Cafu will be started when the compile process is complete and you'll just have to click on "OK" in the Cafu dialog to start and play your map! |
| ===== Tips, Tricks and Trouble-shooting ===== | ===== Tips, Tricks and Trouble-shooting ===== | ||
| - | Using the "Compile" menu requires that you have setup the "Configuration" dialog of CaWE completely and properly! If a compiler cannot be run correctly, please check if you got all the executable file names right in this dialog. Please refer to [[mapping:cawe:install]] for more details. | + | Using the "Compile" menu requires that you have setup the "Configuration" dialog of CaWE completely and properly. If a compiler cannot be run correctly, please check if you got all the executable file names right in this dialog. Please refer to [[mapping:cawe:install]] for more details. |
| + | |||
| + | If your map turns out to be pitch-black when run in the engine after the last compilation step, a likely cause is that you kept the CaLight compiler enabled, but did not place any radiosity light source (i.e. no light or sky material). For checking this quickly, just disable CaLight in the "Compile" menu, then start the compilation again and review the result in the Cafu engine. Thereafter, you may want to place some light sources into your map by applying materials that cast radiosity light, and re-enable CaLight again in order to compute a proper, realistic radiosity solution. | ||
| For quick tests during map development, you can save a lot of compile time by turning off the CaPVS and CaLight compile steps. You may get very low frame-rates and only full-bright lighting, but that's usually fine for checking the map geometry. When you're done, or about to release your map for others, you definitively should compile it once with CaPVS and CaLight enabled, in order to obtain the maximum speed and quality. | For quick tests during map development, you can save a lot of compile time by turning off the CaPVS and CaLight compile steps. You may get very low frame-rates and only full-bright lighting, but that's usually fine for checking the map geometry. When you're done, or about to release your map for others, you definitively should compile it once with CaPVS and CaLight enabled, in order to obtain the maximum speed and quality. | ||
mapping/compiling_new.1154212709.txt.gz · Last modified: 2013-01-07 12:07 (external edit)