rattatwinko/Minecraft1.12SRC
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

add comment in extendedBlockStorge ChunkPrimer

Browse Source
This commit is contained in:
WangTingZheng
2020-07-20 00:48:32 +08:00
parent a22751a745
commit a3864ac263
2 changed files with 63 additions and 26 deletions
Download Patch File Download Diff File Expand all files Collapse all files

12
src/minecraft/net/minecraft/world/chunk/ChunkPrimer.java
View File

@@ -7,6 +7,7 @@ import net.minecraft.init.Blocks;
public class ChunkPrimer
{
private static final IBlockState DEFAULT_STATE = Blocks.AIR.getDefaultState();
//很可能是存储一个chunk中方块的id的，minecraft中一个section由16*16*16格的方块组成，16个section垂直排列，组成一个chunk，也就是一个chunk有16的四次方个方块，也就是65536
private final char[] data = new char[65536];
public IBlockState getBlockState(int x, int y, int z)
@@ -20,6 +21,17 @@ public class ChunkPrimer
this.data[getBlockIndex(x, y, z)] = (char)Block.BLOCK_STATE_IDS.get(state);
}
/**
* a<<b -> 把数字转换为二进制后左移b位，相当于a*2^b a|b -> 把a和化为二进制后按位取或
* 根据方块的坐标，获得方块在一个chunk中的id？？？这个坐标不是全局坐标，而是一个chunk内的局部坐标
* 我们知道，按位取或的结果最大值，是由每一位中最长的哪一位决定的，这里的x，y都是1->16的，而z是1->16*16，然后x<<12表示的是x*4096，所以最大值是65536，而y的最大值是256
* 所以这个函数的返回值的最大值是65536，也就是最后一个方块
* 所以这个函数的作用是，输入一个chunk内的相对坐标，返回一个chunk内1-65536的唯一id
* @param x 一个方块在某一个区块内的x坐标，范围是1-16
* @param y 一个方块在某一个区块内的y坐标，范围是1-16
* @param z 一个方块在某一个区块内的z坐标，也就是纵向的坐标，范围是1-256
* @return 这个方块在这个chunk内的一个唯一id
*/
private static int getBlockIndex(int x, int y, int z)
{
return x << 12 | z << 8 | y;

77
src/minecraft/net/minecraft/world/chunk/storage/ExtendedBlockStorage.java
View File

@@ -7,33 +7,45 @@ import net.minecraft.src.Reflector;
import net.minecraft.world.chunk.BlockStateContainer;
import net.minecraft.world.chunk.NibbleArray;
/**
* 描述一个section的类
* 一个section由16*16*16个block组成
*/
public class ExtendedBlockStorage
{
/**
* Contains the bottom-most Y block represented by this ExtendedBlockStorage. Typically a multiple of 16.
* 存储着这个能代表这个section的最底层y轴的方块，通常是16的倍数
*/
private final int yBase;
/**
* A total count of the number of non-air blocks in this block storage's Chunk.
* 在这个section中，非空气方块的数量
*/
private int blockRefCount;
/**
* Contains the number of blocks in this block storage's parent chunk that require random ticking. Used to cull the
* Chunk from random tick updates for performance reasons.
* 包含此section所属的父chunk中被标记的随机ticking的方块数量，由于性能问题，通常会在随机tick更新中剔除一些方块
* 一般情况下，在一个chunk中会随机选择3个方块作为随机更新方块，在一个随机刻中，这些方块将会被更新
*/
private int tickRefCount;
private final BlockStateContainer data;
/** The NibbleArray containing a block of Block-light data. */
/**
* The NibbleArray containing a block of Block-light data.
* 一个包含光照（点光源/局部光照？？？）数据的半字节数组
*/
private NibbleArray blockLight;
/**
* The NibbleArray containing skylight data.
*
* 一个包含skylight（全局光照？？？）数据的半字节数组
* Will be null if the provider for the world the chunk containing this block storage does not {@linkplain
* net.minecraft.world.WorldProvider#hasSkylight have skylight}.
* net.minecraft.world.WorldProvider# hasSkylight have skylight}.
*
*/
private NibbleArray skyLight;
@@ -54,38 +66,47 @@ public class ExtendedBlockStorage
return this.data.get(x, y, z);
}
/**
* 设置某一个位置的方块的状态
* @param x 方块在一个chunk的的x的位置
* @param y 方块在一个chunk的的y的位置
* @param z 方块在一个chunk的的z的位置
* @param state 一个方块的状态
*/
public void set(int x, int y, int z, IBlockState state)
{
if (Reflector.IExtendedBlockState.isInstance(state))
if (Reflector.IExtendedBlockState.isInstance(state)) //判断这个state是不是由net.minecraftforge.common.property.IExtendedBlockState类继承IBlockState实现的
{
state = (IBlockState)Reflector.call(state, Reflector.IExtendedBlockState_getClean);
}
IBlockState iblockstate = this.get(x, y, z);
Block block = iblockstate.getBlock();
Block block1 = state.getBlock();
IBlockState iblockstate = this.get(x, y, z); //从这个section中获得这个方块的状态，可能是旧的方块
Block block = iblockstate.getBlock(); //从section中的这个状态中获得方块
Block block1 = state.getBlock(); //从传入的状态中获得方块，可能是新的方块
if (block != Blocks.AIR)
//下面这段要从一个section中剔除旧的方块
if (block != Blocks.AIR) //如果旧方块不是空气（不为空）
{
--this.blockRefCount;
--this.blockRefCount; //就减少这个区块的非方块的数量，毕竟要把这个方块代替了
if (block.getTickRandomly())
if (block.getTickRandomly()) //如果这个方块是被挑选为随机刻更新的方块
{
--this.tickRefCount;
--this.tickRefCount; //那么就减少随机刻方块的数量
}
}
if (block1 != Blocks.AIR)
//下面这段要在一个section中添加新方块
if (block1 != Blocks.AIR) //如果旧的方块不是空气方块（不为空）
{
++this.blockRefCount;
++this.blockRefCount; //增加非空方块的数量
if (block1.getTickRandomly())
if (block1.getTickRandomly()) //如果这个方块被选择在随机刻中更新
{
++this.tickRefCount;
++this.tickRefCount; //增加随机刻方块的数量
}
}
this.data.set(x, y, z, state);
this.data.set(x, y, z, state); //通过真正的set方法传入新的方块
}
/**
@@ -99,6 +120,7 @@ public class ExtendedBlockStorage
/**
* Returns whether or not this block storage's Chunk will require random ticking, used to avoid looping through
* random block ticks when there are no blocks that would randomly tick.
*
*/
public boolean needsRandomTick()
{
@@ -145,36 +167,39 @@ public class ExtendedBlockStorage
return this.blockLight.get(x, y, z);
}
/**
* 通过遍历检查的方式重新计算整个section中的非空方块的数量和随机刻方块的数量
*/
public void recalculateRefCounts()
{
IBlockState iblockstate = Blocks.AIR.getDefaultState();
IBlockState iblockstate = Blocks.AIR.getDefaultState(); //获取空气的方块状态
int i = 0;
int j = 0;
for (int k = 0; k < 16; ++k)
for (int k = 0; k < 16; ++k) //遍历一个section中的所有方块
{
for (int l = 0; l < 16; ++l)
{
for (int i1 = 0; i1 < 16; ++i1)
{
IBlockState iblockstate1 = this.data.get(i1, k, l);
IBlockState iblockstate1 = this.data.get(i1, k, l); //从当前section中获取这个方块的状态
if (iblockstate1 != iblockstate)
if (iblockstate1 != iblockstate) //如果这个方块不是空气
{
++i;
Block block = iblockstate1.getBlock();
++i; //i的计数加一，也就是非空方块计数加一
Block block = iblockstate1.getBlock(); //从状态中获得方块
if (block.getTickRandomly())
if (block.getTickRandomly()) //如果方块是随机刻方块
{
++j;
++j;//j的计数加一，也就是随机刻方块数量加一
}
}
}
}
}
this.blockRefCount = i;
this.tickRefCount = j;
this.blockRefCount = i; //重新赋值非空方块数量
this.tickRefCount = j; //重新赋值随机刻方块数量
}
public BlockStateContainer getData()