Editing Building structures

A '''Block''' is an object that can be used to create structures on bases. It is a cube or rectangular prism consisting of three dimensions, length, width, and height, and it can use any of the textures that are listed in the base.cfg file (Orbiter\Config\base.cfg), although some may not be appropriate for a block.

The description of a block is written into the config file of a base (Orbiter\Config\<''Planet''>\Base\<''BaseConfig.cfg''>). 

== Textures ==

Textures used for building a block are found in the directory Orbiter\Textures and are listed in the file Orbiter\Config\Base.cfg. Note that there are a number of textures in the \Textures directory that are not listed in the Base.cfg file that could be used, so, if you like type in the filename without the extension into the Base.cfg file so you can use them in building structures, such as door01, but, not, let's say, Exhaust.

So, let's build a block building. If you created

Open the Bonneville.cfg file (Orbiter\Config\Earth\Base\) in your favorite text editor such as Notepad or Notepad+. Place your cursor at the end of the line BEGIN_OBJECTLIST and press {{Key|Enter}}. That provides a line to type in an object.

 BLOCK
 POS 0 0 -50
 SCALE 1 1 1
 ROT 330
 TEX1 0 0 0
 TEX2 0 0 0
 TEX3 0 0 0
 END

Save the file, you can keep the file open as we will be editing this block. Exit the scenario, then re-launch it. Now, you will see a small cube sitting on the ground about 100 meters in front of you. In the scenario editor, change the time to about 18:00 hours, that puts the Sun behind you so you can see what effect shadows have. 

Now note the block is white on the side facing you. If you moved your ship so you could see one of the sides, you will note that it is gray. Orbiter applies shading for shadows.

The block should look something like this:
[[Image:Block_0_01.png|200px|thumb|center|Image of a BLOCK with no texture.]]

This block is a cube 1 meter cubed. Now, let's edit the block in Bonneville.cfg as follows:

 BLOCK
 POS 0 0 -50
 SCALE 1 1 1
 ROT 330
 TEX1 Fcd01 1 1
 TEX2 Fcd03 1 1
 TEX3 Roof01 1 1
 END

Again, save the scenario, exit to the Launchpad and re-launch. Now, your block should look like something like this.
[[Image:Block_Fcd01_01.png|200px|thumb|center|Image of the same block with Fcd01 on the front and back, Fcd03 on the sides, Roof01 on the top, 1 meter per side.]]

Fcd01 produces a wall with four windows wide and four windows tall all into that one meter square side, and Fcd03 produces a wall with three sets of windows wide and three tall. The number of items produced on a face vary from one to another Fcd.

== Components of a block ==
When building a block, the first line must be '''BLOCK'''. 

The next line describes the position of the block in relation to the center of the base. If you type '''POS 0 0 0''', the center of the block will sit right on the center of the base. 

For the position parameter, '''POS''' must be the first part of the line. 

The first number '''X''' is the distance north or south of center of the base (north is -, south us +) in meters.  

The second number '''Y''' is the elevation above the terrain or base plane the bottom of the block sits, above is +, below is -. 

The third number '''Z''' is the position in meters east +, or west - of the center of the base.

The next line starts with '''SCALE'''. This indicates the size of the block in the X, Y, and Z axis. So, if you type in SCALE 1 2 3, that makes the block 1 meter wide, 2 meters tall, and 3 meters front to back. Orbiter will stretch the texture to fill the dimensions called out.

The next line is '''TEX1'''followed by three parameters, the first 0 or which texture is called out from Base.cfg, the first number is how many iterations of the texture is squeezed into the width, and the third number is how many iterations is squeezed into the height. This applies to the front face and the back face of the block.

The next line is '''TEX2''' followed by three parameters, the same as TEX1, but applies to the left and right faces of the block.

The next line is '''TEX3''' followed by three parameters, the same as TEX1 and TEX2, but applies to the top, or roof of the block.

The first term of each '''TEX''' callout is the name of a texture from Base.cfg. Any one can be used in each, but, using Runway1 or Lpad02 would probably not be appropriate.

Now, let's build two blocks each with different parameters and compare.

Replace the existing block with the following:
 BLOCK
 POS  0 0 -50
 SCALE 1 2 3
 ROT 330
 TEX1 Fcd01 1 1
 TEX2 Fcd01 1 1
 TEX3 Roof01 1 1
 END
 BLOCK
 POS -4 0 -50
 SCALE 1 2 3
 ROT 330
 TEX1 Fcd01 1 2
 TEX2 Fcd01 2 1
 TEX3 Roof01 2 2
 END

After launching Orbiter, you will see two blocks, the same size, both use Fcd01 for all sides, but the windows are different. 

For the left block, SCALE 1 2 3 creates a block 1 meter wide, 2 meters tall, 3 meters deep. TEX1 Fcd01 1 1 creates one Fcd01 wide, 1 Fcd01 tall stretching the Fcd to fit the height. The same with TEX2 and TEX3, TEX3 calling out a Roof design.

For the right block, SCALE 1 2 3 does the same, but TEX1 Fcd01 1 2 creates one Fcd01 wide and two Fcd01 tall making twice as many windows. TEX2 2 1 creates four windows high and eight windows wide on the side faces. TEX3 2 2 creates a roof with twice as many seams.

A TEX parameter can use decimal numbers in the second and third parameter. For example, TEX1 1 1.5 will get you 1.5 times as many Fcd01 tall, which creates 6 windows tall. Remember each Fcd entity may have different number of windows or doors, etc., so you need to vary the math.

Also, note that many of the textures, particularly Fcd ones will have a texture for daytime and another for nighttime, showing some lights through the windows. You can see this by changing your time of day in the scenario to nightime.

== Gallery ==
In my Block.cfg I have added all textures from the Orbiter\Textures\ folder that can be used for blocks and shown below so you don't have to keep changing blocks in your scenario to see what they look like. Just pick one from here.