Terrain Edge Matching

Matches an edge on a TerrainBlock to the opposite edge on the same or different TerrainBlock.

Handy for Quickly matching up terrains for tiling.

In terrData.h
At the end after void inspectPostApply();
Add..

// << Jonajoint Added
private:
	struct SmoothBufferInfo{
		U32 x;
		U32 y;
		F32 height;
	};
public:
	// terrain = the terrain block to match to, edge is the edge number:- 0 being north, 2 south, 1 west, 3 east
	// set slope to enable linear slope smoothing.
	// smoothBorder is the amount in from the edge to smooth
   void matchEdge(TerrainBlock* terrain, U32 edge,bool slope, U32 smoothBorder);
//>> Jonajoint End

In terrData.cpp
At the Very end after everything else
Add..

//<< Jonajoint Added
	// terrain = the terrain block to match to
	// edge is the edge number:- 0 being north, 2 south, 1 west, 3 east
	// set slope to enable linear slope smoothing.
	// smoothBorder is the amount in from the edge to smooth

void TerrainBlock::matchEdge(TerrainBlock* terrain, U32 edge,bool slope, U32 smoothBorder)
{
	U32 edge2 = edge+2;
	if(edge2 > 3)
		edge2 -= 4;

	TerrainFile* file2=terrain->getFile();
	const U32 blockSize = terrain->getBlockSize();
	U32 edgeYMin,edgeYMax,edge2Y;
	U32 edgeXMin,edgeXMax,edge2X;
	U16 height;
	height = 0;
	if(edge==0)
	{
		edgeYMin=0;
		edgeYMax=1;
		edgeXMin=0;
		edgeXMax=blockSize;
		edge2Y=blockSize-1;
		edge2X=0;
	}else if(edge==1)
	{
		edgeYMin=0;
		edgeYMax=blockSize;
		edgeXMin=blockSize-1;
		edgeXMax=blockSize;
		edge2Y=0;
		edge2X=0;
	}else if(edge==2)
	{
		edgeYMin=blockSize-1;
		edgeYMax=blockSize;
		edgeXMin=0;
		edgeXMax=blockSize;
		edge2Y=0;
		edge2X=0;
	}else{
		edgeYMin=0;
		edgeYMax=blockSize;
		edgeXMin=0;
		edgeXMax=1;
		edge2Y=0;
		edge2X=blockSize-1;
	}
	if(edge==0 || edge==2){
		for ( U32 y = edgeYMin; y < edgeYMax; y++ )
		{
			for ( U32 x = edgeXMin; x < edgeXMax; x++ )
			{
				height = file2->getHeight(x,edge2Y);
				mFile->setHeight( x, y, height );
				if(slope && smoothBorder > 0 ){
					F32 temp1;
					F32 height2;
					height2=fixedToFloat(height);
					F32 inc;
					F32 dif;
					if(edge==0){
//						Con::printf("Doing North Smooth");
						temp1 = fixedToFloat(mFile->getHeight(x,smoothBorder+1));
						dif = temp1-height2;
						inc = dif/smoothBorder;
						for(int i=1;i<edgeYMax+smoothBorder;i++){
							//height=mFile->getHeight(x,i);
							mFile->setHeight(x,i,floatToFixed(height2+(inc*i)));
						}
					}else{
//						Con::printf("Doing South Smooth");
						temp1 = fixedToFloat(mFile->getHeight(x,blockSize-(smoothBorder+1)));
						dif = temp1-height2;
						inc = dif/smoothBorder;
						for(int i=smoothBorder+1;i>1;i--){
							//height=mFile->getHeight(x,i);
							mFile->setHeight(x,blockSize-i,floatToFixed(height2+(inc*i)));
						}
					}
				}
			}
		}
	}else{
		for ( U32 y = edgeYMin; y < edgeYMax; y++ )
		{
			for ( U32 x = edgeXMin; x < edgeXMax; x++ )
			{
				height = file2->getHeight(edge2X,y);
				mFile->setHeight( x, y, height );
			}
			if(slope && smoothBorder > 0 ){
				F32 temp1;
				F32 height2;
				height2=fixedToFloat(height);
				F32 inc;
				F32 dif;
				if(edge==1){
//					Con::printf("Doing West Smooth");
					temp1 = fixedToFloat(mFile->getHeight(blockSize-(smoothBorder+1),y));
					dif = temp1-height2;
					inc = dif/smoothBorder;
					for(int i=smoothBorder+1;i>1;i--){//blockSize-(smoothBorder-1);i<blockSize-1;i++){
						mFile->setHeight(blockSize-i,y,floatToFixed(height2+(inc*i)));
					}
				}else{
//					Con::printf("Doing East Smooth");
					temp1 = fixedToFloat(mFile->getHeight(smoothBorder+1,y));
					dif = temp1-height2;
					inc = dif/smoothBorder;
					for(int i=1;i<smoothBorder+1;i++){
						//height=mFile->getHeight(x,i);
						mFile->setHeight(i,y,floatToFixed(height2+(inc*i)));
					}
				}
			}
		}
	}
	// TODO add Average height radius smoothing 
	// TODO Linear Regression smoothing (Dan Kellers Resource would be a good place to start)
	// http://www.garagegames.com/community/resources/view/21479
	

	// Note:- TODO The update range passed to upDateGrid is set to the full terrain size
	// This works well enough for use in the editor, but needs sorting for game use
	// and should be easy enough, Just cant be bothered :p
	if(this->isServerObject()){
		TerrainBlock* clientTerrain = dynamic_cast<TerrainBlock*>( this->getClientObject() );
        	updateGrid( Point2I::Zero, Point2I( blockSize, blockSize ) );
        	clientTerrain->updateGrid(Point2I::Zero, Point2I( blockSize, blockSize ));
	}
	
    
//    terrain->updateGridMaterials( Point2I::Zero, Point2I( blockSize, blockSize ) );
}

DefineEngineMethod( TerrainBlock, matchEdge, void, ( TerrainBlock* terrBlock, U32 edge, bool slope, U32 smoothBorder),,
				   "@brief Matches an edge on this terrain block with the opposite edge on the one supplied.nn"
				   "@param terrBlock = the TerrainBlock to match to.nn"
				   "@param edge = The edge on this terr.nn"
				   "@param slope = do linear slope smoothing.nn"
				   "@param smoothBorder = amount of edge to do smoothing operations on.nn")
{
	object->matchEdge(terrBlock,edge,slope,smoothBorder);
}
//>> Jonajoint End

Usage:-

You need at least 1 terrain block in the scene.
If you are using more than 1 then they need to be the same grid size (not squaresize)
where terr1 is the name of a TerrainBlock in the editor and terr2 is the name of another.
use following command in console:-

terr1.matchEdge(terr2,0,true,50);

Command Break down :-
<Terrain Name>.matchEdge(<Terrain Name>, <Edge to Match>, <Do Linear Slope>, <Amount in from edge to slope>);



and... Some obligatory before and after pictures..



Just need to sort out those pesky black lines now :/