Java tutorial
/* * Copyright 2014 MovingBlocks * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ package org.terasology.world.generation.facets.base; import com.google.common.collect.Maps; import org.terasology.math.Region3i; import org.terasology.math.geom.BaseVector3i; import org.terasology.math.geom.Vector3i; import org.terasology.world.generation.Border3D; import java.util.Collections; import java.util.Map; import java.util.Map.Entry; /** * A sparse (map-based) implementation * of {@link ObjectFacet3D}. * */ public abstract class SparseObjectFacet3D<T> extends SparseFacet3D implements ObjectFacet3D<T> { private final Map<BaseVector3i, T> relData = Maps.newLinkedHashMap(); /** * @param targetRegion * @param border */ public SparseObjectFacet3D(Region3i targetRegion, Border3D border) { super(targetRegion, border); } @Override public T get(int x, int y, int z) { return get(new Vector3i(x, y, z)); } @Override public T get(BaseVector3i pos) { checkRelativeCoords(pos.x(), pos.y(), pos.z()); return relData.get(pos); } @Override public void set(int x, int y, int z, T value) { set(new Vector3i(x, y, z), value); } @Override public void set(BaseVector3i pos, T value) { checkRelativeCoords(pos.x(), pos.y(), pos.z()); relData.put(pos, value); // TODO: consider using an immutable vector here } @Override public T getWorld(BaseVector3i pos) { return getWorld(pos.x(), pos.y(), pos.z()); } @Override public T getWorld(int x, int y, int z) { checkWorldCoords(x, y, z); Vector3i index = worldToRelative(x, y, z); return relData.get(index); } @Override public void setWorld(BaseVector3i pos, T value) { setWorld(pos.x(), pos.y(), pos.z(), value); } @Override public void setWorld(int x, int y, int z, T value) { checkWorldCoords(x, y, z); Vector3i index = worldToRelative(x, y, z); relData.put(index, value); } /** * @return an unmodifiable view on the relative entries */ public Map<BaseVector3i, T> getRelativeEntries() { return Collections.unmodifiableMap(relData); } /** * @return a <b>new</b> map with world-based position entries */ public Map<BaseVector3i, T> getWorldEntries() { Map<BaseVector3i, T> result = Maps.newLinkedHashMap(); for (Entry<BaseVector3i, T> entry : relData.entrySet()) { BaseVector3i relPos = entry.getKey(); BaseVector3i worldPos = relativeToWorld(relPos.x(), relPos.y(), relPos.z()); result.put(worldPos, entry.getValue()); } return result; } }