Added ChunkSnapshot for efficient, thread-safe copies of Chunk data. Thanks mikeprimm!

By: EvilSeph <evilseph@unaligned.org>
2011-06-07 03:34:23 -04:00
parent c9032d99bb
commit 08d7a5ecb0
2 changed files with 152 additions and 4 deletions
--- a/paper-server/src/main/java/org/bukkit/craftbukkit/CraftChunkSnapshot.java
+++ b/paper-server/src/main/java/org/bukkit/craftbukkit/CraftChunkSnapshot.java
@@ -0,0 +1,130 @@
+package org.bukkit.craftbukkit;
+
+import org.bukkit.ChunkSnapshot;
+/**
+ * Represents a static, thread-safe snapshot of chunk of blocks
+ * Purpose is to allow clean, efficient copy of a chunk data to be made, and then handed off for processing in another thread (e.g. map rendering)
+ */
+public class CraftChunkSnapshot implements ChunkSnapshot {
+    private final int x, z;
+    private final String worldname;
+    private final byte[] buf; // Flat buffer in uncompressed chunk file format
+    private final byte[] hmap; // Height map
+    private final long capture_fulltime;
+
+    private static final int BLOCKDATA_OFF = 32768;
+    private static final int BLOCKLIGHT_OFF = BLOCKDATA_OFF + 16384;
+    private static final int SKYLIGHT_OFF = BLOCKLIGHT_OFF + 16384;
+
+    /**
+     * Constructor
+     */
+    CraftChunkSnapshot(int x, int z, String wname, long wtime, byte[] buf, byte[] hmap) {
+        this.x = x;
+        this.z = z;
+        this.worldname = wname;
+        this.capture_fulltime = wtime;
+        this.buf = buf;
+        this.hmap = hmap;
+    }
+
+    /**
+     * Gets the X-coordinate of this chunk
+     *
+     * @return X-coordinate
+     */
+    public int getX() {
+        return x;
+    }
+
+    /**
+     * Gets the Z-coordinate of this chunk
+     *
+     * @return Z-coordinate
+     */
+    public int getZ() {
+        return z;
+    }
+
+    /**
+     * Gets name of the world containing this chunk
+     *
+     * @return Parent World Name
+     */
+    public String getWorldName() {
+        return worldname;
+    }
+
+    /**
+     * Get block type for block at corresponding coordinate in the chunk
+     *
+     * @param x 0-15
+     * @param y 0-127
+     * @param z 0-15
+     * @return 0-255
+     */
+    public int getBlockTypeId(int x, int y, int z) {
+        return buf[x << 11 | z << 7 | y] & 255;
+    }
+
+    /**
+     * Get block data for block at corresponding coordinate in the chunk
+     *
+     * @param x 0-15
+     * @param y 0-127
+     * @param z 0-15
+     * @return 0-15
+     */
+    public int getBlockData(int x, int y, int z) {
+        int off = ((x << 10) | (z << 6) | (y >> 1)) + BLOCKDATA_OFF;
+
+        return ((y & 1) == 0) ? (buf[off] & 0xF) : ((buf[off] >> 4) & 0xF);
+    }
+
+    /**
+     * Get sky light level for block at corresponding coordinate in the chunk
+     *
+     * @param x 0-15
+     * @param y 0-127
+     * @param z 0-15
+     * @return 0-15
+     */
+    public int getBlockSkyLight(int x, int y, int z) {
+        int off = ((x << 10) | (z << 6) | (y >> 1)) + SKYLIGHT_OFF;
+
+        return ((y & 1) == 0) ? (buf[off] & 0xF) : ((buf[off] >> 4) & 0xF);
+    }
+
+    /**
+     * Get light level emitted by block at corresponding coordinate in the chunk
+     *
+     * @param x 0-15
+     * @param y 0-127
+     * @param z 0-15
+     * @return 0-15
+     */
+    public int getBlockEmittedLight(int x, int y, int z) {
+        int off = ((x << 10) | (z << 6) | (y >> 1)) + BLOCKLIGHT_OFF;
+
+        return ((y & 1) == 0) ? (buf[off] & 0xF) : ((buf[off] >> 4) & 0xF);
+    }
+
+    /**
+     * Gets the highest non-air coordinate at the given coordinates
+     *
+     * @param x X-coordinate of the blocks
+     * @param z Z-coordinate of the blocks
+     * @return Y-coordinate of the highest non-air block
+     */
+    public int getHighestBlockYAt(int x, int z) {
+        return hmap[z << 4 | x] & 255;
+    }
+
+    /**
+     * Get world full time when chunk snapshot was captured
+     * @return time in ticks
+     */
+    public long getCaptureFullTime() {
+        return capture_fulltime;
+    }
+}