com.jogamp.opengl.util.packrect.Level Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of jogl-all Show documentation
Show all versions of jogl-all Show documentation
Java™ Binding for the OpenGL® API
/*
* Copyright (c) 2006 Sun Microsystems, Inc. All Rights Reserved.
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions are
* met:
*
* - Redistribution of source code must retain the above copyright
* notice, this list of conditions and the following disclaimer.
*
* - Redistribution in binary form must reproduce the above copyright
* notice, this list of conditions and the following disclaimer in the
* documentation and/or other materials provided with the distribution.
*
* Neither the name of Sun Microsystems, Inc. or the names of
* contributors may be used to endorse or promote products derived from
* this software without specific prior written permission.
*
* This software is provided "AS IS," without a warranty of any kind. ALL
* EXPRESS OR IMPLIED CONDITIONS, REPRESENTATIONS AND WARRANTIES,
* INCLUDING ANY IMPLIED WARRANTY OF MERCHANTABILITY, FITNESS FOR A
* PARTICULAR PURPOSE OR NON-INFRINGEMENT, ARE HEREBY EXCLUDED. SUN
* MICROSYSTEMS, INC. ("SUN") AND ITS LICENSORS SHALL NOT BE LIABLE FOR
* ANY DAMAGES SUFFERED BY LICENSEE AS A RESULT OF USING, MODIFYING OR
* DISTRIBUTING THIS SOFTWARE OR ITS DERIVATIVES. IN NO EVENT WILL SUN OR
* ITS LICENSORS BE LIABLE FOR ANY LOST REVENUE, PROFIT OR DATA, OR FOR
* DIRECT, INDIRECT, SPECIAL, CONSEQUENTIAL, INCIDENTAL OR PUNITIVE
* DAMAGES, HOWEVER CAUSED AND REGARDLESS OF THE THEORY OF LIABILITY,
* ARISING OUT OF THE USE OF OR INABILITY TO USE THIS SOFTWARE, EVEN IF
* SUN HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
*
* You acknowledge that this software is not designed or intended for use
* in the design, construction, operation or maintenance of any nuclear
* facility.
*
* Sun gratefully acknowledges that this software was originally authored
* and developed by Kenneth Bradley Russell and Christopher John Kline.
*/
package com.jogamp.opengl.util.packrect;
import java.util.*;
public class Level {
private final int width;
private int height;
private final int yPos;
private final LevelSet holder;
private final List rects = new ArrayList();
private List freeList;
private int nextAddX;
static class RectXComparator implements Comparator {
@Override
public int compare(final Rect r1, final Rect r2) {
return r1.x() - r2.x();
}
@Override
public boolean equals(final Object obj) {
return this == obj;
}
}
private static final Comparator rectXComparator = new RectXComparator();
public Level(final int width, final int height, final int yPos, final LevelSet holder) {
this.width = width;
this.height = height;
this.yPos = yPos;
this.holder = holder;
}
public int w() { return width; }
public int h() { return height; }
public int yPos() { return yPos; }
/** Tries to add the given rectangle to this level only allowing
non-disruptive changes like trivial expansion of the last level
in the RectanglePacker and allocation from the free list. More
disruptive changes like compaction of the level must be
requested explicitly. */
public boolean add(final Rect rect) {
if (rect.h() > height) {
// See whether it's worth trying to expand vertically
if (nextAddX + rect.w() > width) {
return false;
}
// See whether we're the last level and can expand
if (!holder.canExpand(this, rect.h())) {
return false;
}
// Trivially expand and try the allocation
holder.expand(this, height, rect.h());
height = rect.h();
}
// See whether we can add at the end
if (nextAddX + rect.w() <= width) {
rect.setPosition(nextAddX, yPos);
rects.add(rect);
nextAddX += rect.w();
return true;
}
// See whether we can add from the free list
if (freeList != null) {
Rect candidate = null;
for (final Iterator iter = freeList.iterator(); iter.hasNext(); ) {
final Rect cur = iter.next();
if (cur.canContain(rect)) {
candidate = cur;
break;
}
}
if (candidate != null) {
// Remove the candidate from the free list
freeList.remove(candidate);
// Set up and add the real rect
rect.setPosition(candidate.x(), candidate.y());
rects.add(rect);
// Re-add any remaining free space
if (candidate.w() > rect.w()) {
candidate.setPosition(candidate.x() + rect.w(), candidate.y());
candidate.setSize(candidate.w() - rect.w(), height);
freeList.add(candidate);
}
coalesceFreeList();
return true;
}
}
return false;
}
/** Removes the given Rect from this Level. */
public boolean remove(final Rect rect) {
if (!rects.remove(rect))
return false;
// If this is the rightmost rectangle, instead of adding its space
// to the free list, we can just decrease the nextAddX
if (rect.maxX() + 1 == nextAddX) {
nextAddX -= rect.w();
} else {
if (freeList == null) {
freeList = new ArrayList();
}
freeList.add(new Rect(rect.x(), rect.y(), rect.w(), height, null));
coalesceFreeList();
}
return true;
}
/** Indicates whether this Level contains no rectangles. */
public boolean isEmpty() {
return rects.isEmpty();
}
/** Indicates whether this Level could satisfy an allocation request
if it were compacted. */
public boolean couldAllocateIfCompacted(final Rect rect) {
if (rect.h() > height)
return false;
if (freeList == null)
return false;
int freeListWidth = 0;
for (final Iterator iter = freeList.iterator(); iter.hasNext(); ) {
final Rect cur = iter.next();
freeListWidth += cur.w();
}
// Add on the remaining space at the end
freeListWidth += (width - nextAddX);
return (freeListWidth >= rect.w());
}
public void compact(final Object backingStore, final BackingStoreManager manager) {
Collections.sort(rects, rectXComparator);
int nextCompactionDest = 0;
manager.beginMovement(backingStore, backingStore);
for (final Iterator iter = rects.iterator(); iter.hasNext(); ) {
final Rect cur = iter.next();
if (cur.x() != nextCompactionDest) {
manager.move(backingStore, cur,
backingStore, new Rect(nextCompactionDest, cur.y(), cur.w(), cur.h(), null));
cur.setPosition(nextCompactionDest, cur.y());
}
nextCompactionDest += cur.w();
}
nextAddX = nextCompactionDest;
freeList.clear();
manager.endMovement(backingStore, backingStore);
}
public Iterator iterator() {
return rects.iterator();
}
/** Visits all Rects contained in this Level. */
public void visit(final RectVisitor visitor) {
for (final Iterator iter = rects.iterator(); iter.hasNext(); ) {
final Rect rect = iter.next();
visitor.visit(rect);
}
}
/** Updates the references to the Rect objects in this Level with
the "next locations" of those Rects. This is actually used to
update the new Rects in a newly laid-out LevelSet with the
original Rects. */
public void updateRectangleReferences() {
for (int i = 0; i < rects.size(); i++) {
final Rect cur = rects.get(i);
final Rect next = cur.getNextLocation();
next.setPosition(cur.x(), cur.y());
if (cur.w() != next.w() || cur.h() != next.h())
throw new RuntimeException("Unexpected disparity in rectangle sizes during updateRectangleReferences");
rects.set(i, next);
}
}
private void coalesceFreeList() {
if (freeList == null)
return;
if (freeList.isEmpty())
return;
// Try to coalesce adjacent free blocks in the free list
Collections.sort(freeList, rectXComparator);
int i = 0;
while (i < freeList.size() - 1) {
final Rect r1 = freeList.get(i);
final Rect r2 = freeList.get(i+1);
if (r1.maxX() + 1 == r2.x()) {
// Coalesce r1 and r2 into one block
freeList.remove(i+1);
r1.setSize(r1.w() + r2.w(), r1.h());
} else {
++i;
}
}
// See whether the last block bumps up against the addition point
final Rect last = freeList.get(freeList.size() - 1);
if (last.maxX() + 1 == nextAddX) {
nextAddX -= last.w();
freeList.remove(freeList.size() - 1);
}
if (freeList.isEmpty()) {
freeList = null;
}
}
//----------------------------------------------------------------------
// Debugging functionality
//
public void dumpFreeSpace() {
int freeListWidth = 0;
for (final Iterator iter = freeList.iterator(); iter.hasNext(); ) {
final Rect cur = iter.next();
System.err.println(" Free rectangle at " + cur);
freeListWidth += cur.w();
}
// Add on the remaining space at the end
System.err.println(" Remaining free space " + (width - nextAddX));
freeListWidth += (width - nextAddX);
System.err.println(" Total free space " + freeListWidth);
}
}