Show Posts

Pages: [1] 2

1

Discussions / Java Gaming Wiki / Understanding relations between setOrigin, setScale and setPosition in libGdx

on: 20141009 22:34:59

For card animations in my Gods of Sparta game I'm using the largest card graphics all around. The cards get scaled and rotated as they move. To rotate the image around it's center, you need to setOrigin to (width/2, height/2). However, the origin is also used for scaling, so if you scale the image it will no longer stay at the same (x,y) position you set with setPosition. To get the scaled image in some particular position, you need to offset the coordinates. See the image below for the exact math: We want to position the scaled image to (60,70), but since it has setOrigin, it shows up in a different spot. To place it properly, we need to move it half of the difference between full and scaled image. Now that we know how it works, it all makes sense. I hope this saves other developers some time.



2

Discussions / Java Gaming Wiki / Definite guide to supporting multiple device resolutions on Android (2014)

on: 20141002 22:36:02

Hi all, I spent some time to investigate all the devices out there and do some analysis on the screen resolutions out there. For 3D games, you don't really care, but if you are making a 2D game you want graphics to be crisp clear. And only way to do that is to use 1:1 pixel mapping, i.e. set the game camera to the same resolution as the device screen. Of course, this means drawing all the assets in multiple sizes. I found that it not too hard, you can always draw stuff big and scale it down. I also like to use ImageMagick to add text to images that are already scaled down. If it's more complex, you can code it in Java as well. Anyway, drawing is not the problem if you know which resolutions you want to support and how big your pictures should be. In the end, I came up with six different sizes that should cover 99% of devices that are currently out there. I explained each one in detail. Take a look: http://bigosaur.com/blog/31androidresolutionsdefiniteanswerI hope this helps anyone who starts a new 2D Android game project.



4

Game Development / Articles & tutorials / Java and Game Development Tutorials

on: 20140613 22:47:22

I wanted to share my new Youtube series about Java and Game Development and I thought this was the right board to put it in. The first episode skims over basics such as methods, variables, arguments, logical operators etc. I dont think this was the appropriate board, sorry. My voice has been a little scratchy and I accidently had the gain on my *sensitive* blue yeti microphone on max so, headphone users, your ears may bleed a little. Just a fair warning. I would love some feedback and point in the right direction, and if I made a mistake give me a time and I will put an annotation.



6

Discussions / Java Gaming Wiki / Escape Analysis

on: 20140425 08:22:13

OverviewYet another stub  is probably completely wrong HotSpot detailsLike all HotSpot features this can only describe a particular version (JDK8 snapshot on 20140425) https://wikis.oracle.com/display/HotSpotInternals/EscapeAnalysisFor spot checking of impact escape analysis can be disable by: XX:DoEscapeAnalysisPartial list of situations where HotSpot conservatively assumes a reference escapes:  The object requires a finalizer
 The reference is passed to an invokedynamic call (e.g. lambda and method references)
 The reference is passed to an instance method where the call isn't known to be monomorphic (the method can be overridden).
 The reference is passed through a greater call chain depth than MaxBCEAEstimateLevel
 The reference is passed to method whos bytecode size is greater than MaxBCEAEstimateSize
Detailed information about escape analysis can be queried with: XX:+BCEATraceLevel = (1,3) HotSpot source code: hotspot/src/share/vm/ci/bcEscapeAnalyzer.cpp hotspot/src/share/vm/opto/escape.cpp



7

Discussions / Java Gaming Wiki / Good Examples

on: 20140401 16:40:34

This wiki page is supposed to contain "good examples" of specific kinds of thread topics, so everyone can link to this to explain, how their topic should improve. Good Examples For:Asking for teammatesA new topic for asking for additional teammates for a project should always contain a lot of information about the project itself, the work that already has been done, what kind of help is wanted and how helpers / interested persons can get in contact. You should never ask for teammates without a project or without having done much work, it won't work, nobody is going to be impressed. A good example for such a kind of topic/thread should look like this: http://www.javagaming.org/topics/2dmorpglookingfortalent/32656/view/topicseen.htmlMaking Tutorials/Articles in the article sectionTutorials in the article section are not allowed to only contain links to tutorials or similar, they are supposed to be directly included in the thread. If you wrote a blog post or similar, simply try to copy n' paste it into the article section and reformat it. You can find more information in the sticky post regarding the article section rules. An excellent example for that would be this tutorial on creating a 3D camera., or this especially good part of the LWJGL Tutorial Series  Lighting.



8

Discussions / Java Gaming Wiki / Anonymous/Local/Inner class gotchas

on: 20140310 13:19:36

If it isn't defined as static then it implicitly keeps a reference to it's outer instance. One issues is memory leaks due to entanglement. JLS ยง8.6: Instance InitializersThis will create a special class for 'bar' and bar holds a reference to it's container. 1 2 3 4 5
 @SuppressWarnings("serial") HashMap<String,String> bar = new HashMap<String, String>() {{ put("foo", "xyzzy"); put("bar", "yzzyx"); }}; 
which can be trivially reworked to this (without an anonymous class): 1 2 3 4 5
 HashMap<String,String> bar = new HashMap<>(); { bar.put("foo", "xyzzy"); bar.put("bar", "yzzyx"); } 
There's still a style gotcha here in that this is using an instance initializer and if 'bar' was changed to static the code would be executed each time a new instance of the container is created. The initializer would also have to be changed to a static one.



9

Discussions / Java Gaming Wiki / HotSpot Options

on: 20140210 09:47:15

Xms Sets the inital heap space. EXAMPLE: Xms2g Xmx Sets the max heap space. XX OptionsTo check all options supported by your VM: java server XX:+UnlockExperimentalVMOptions XX:+UnlockDiagnosticVMOptions XX:+PrintFlagsFinal 
http://jvmoptions.tech.xebia.fr/#http://www.oracle.com/technetwork/java/javase/tech/vmoptionsjsp140102.htmlBehavior OptionsIgnoreUnrecognizedVMOptions (Boolean: false) Ignore unrecognized VM options. EagerInitialization (Boolean: false) Eagerly initialize classes when possible. GenerateRangeChecks (Boolean: true) Generate range checks for array accesses ForceTimeHighResolution (Boolean: false) WIN32. OnError (Comma seperated string list: empty) Run userdefined commands on fatal error; see VMError.cpp for examples OnOutOfMemoryError (Comma seperated string list: empty) Run userdefined commands on first java.lang.OutOfMemoryError. Example: XX:OnOutOfMemoryError ="sh ~/somescript.sh" UseCompressedStrings (Boolean: false) Use byte arrays for strings which are ASCII. Memory OptionsInitialHeapSize (Integer: 0) Initial heap size (in bytes); zero means OldSize + NewSize MaxHeapSize (Integer: 96M) Maximum heap size (in bytes). Xmx maps to this. InitialRAMFraction (Integer: 64) Fraction (1/n) of real memory used for initial heap size MaxDirectMemorySize (Integer: 1) Maximum total size of NIO directbuffer allocations. MaxHeapFreeRatio (Integer: 70) Max percentage of heap free after GC to avoid shrinking. InitialCodeCacheSize (Integer: platform specific) Initial code cache size (in bytes) ReservedCodeCacheSizeUseCodeCacheFlushingRuntime Compiler OptionsAggressiveOpts (Boolean: false) Turn on optimizations that are expected to be default in upcomming version. CompileThreshold (Integer: platform specific) Number of interpreted method invocations before (re)compiling. Lowering this number gives the compiler less time to gather accurate statistics which could result in slower code and will cause the compiler to run more often which increases CPU burden within a given time window. DontCompileHugeMethods (Boolean: LOOKUP) Don't compile methods larger HugeMethodLimit if true. HugeMethodLimit (Integer: 8000) Don't compile methods larger than the value if DontCompileHugeMethods is true. MinInliningThreshold (Integer: 250) Minimum invocation count a method needs to have to be inlined. MaxInlineLevel (Integer: 9) Maximum number of nested calls that are inlined. MaxRecursiveInlineLevel (Integer: 1) Maximum number of nested recursive calls that are inlined. MaxTrivialSize (Integer: 6) Maximum bytecode size of a trivial method to be inlined MaxInlineSize (Integer: 35) Maximum bytecode size of a method to be inlined. FreqInlineSize (Integer : platform specific) maximum bytecode size of a frequent method to be inlined InlineFrequencyRatio (Integer: 20) Ratio of call site execution to caller method invocation. InlineSmallCode (Integer: ) Only inline already compiled methods if their code size is less than this. DelayCompilationDuringStartup (Boolean: true) Delay invoking the compiler until the main class is loaded. DesiredMethodLimit (Integer: 8000) Desired maximum method size (in bytecodes) after inlining. InlineAccessors (Boolean: true) Inline accessor methods (get/set) PerBytecodeRecompilationCutoff (Integer: 200) PerBCI limit on repeated recompilation (1=>'Inf') PerMethodRecompilationCutoff (Integer: 400) After recompiling N times, stay in the interpreter (1=>'Inf'). Garbage Collector Options (General)InitialSurvivorRatio (Integer: Initial ratio of eden/survivor space size InitialTenuringThreshold (Integer: 7) nitial value for tenuring threshold DisableExplicitGC (Boolean: false) Choose if calling does a full GC. Debugging aidesLogCompilation (Boolean: false) Log compilation activity in detail to hotspot.log or LogFile. It's in XML, co check out JITWatch, a HotSpot JIT compiler log analisys and visualization tool. PrintAssembly (Boolean: false) Print native assembly code after compiles. Requires an external disassembler plugin. https://wikis.oracle.com/display/HotSpotInternals/PrintAssembly also covers related options that enable printing of native methods, stubs, interpreter code, etc., and selective printing using CompileCommand. Both 32 and 64bit Windows binaries of a disassembler plugin can be found at the FCML Downloads pageFor windows 64bit VMs a copy of this plugin can be found inside: Graal/Truffle builds. Copy the library on your path (or sidebyside jvm.dll) to use with other OpenJDK based builds. PrintAssemblyOptions (String: empty) Options string for PrintAssembly PrintCompilation (Boolean: false) https://gist.github.com/chrisvest/2932907PrintInlining (Boolean: false) Prints inlining optimizations PrintIntrinsics (Boolean: false) prints attempted and successful inlining of intrinsics



11

Discussions / Java Gaming Wiki / Stupid enum tricks

on: 20140128 08:18:03

Number of elements1 2 3 4 5 6
 public enum Foo { A,B,C;
public static final int length = Foo.values().length; } 
As a singletonProbably the easiest way to safely create a singleton in java if no parent is needed, but an enum can implement any number of interfaces: 1 2 3 4 5
 public enum Foo { INSTANCE; } 
Note that the enum instance is constructed on class load: 1 2 3 4 5 6 7 8
 enum E { $; { System.out.println("Whoa! Hello World?!"); } public static void main(String[] a) {} } 
As a static utility class1 2 3 4 5
 public enum Foo { ; } 
Tree relationsAll kinds of stupid tricks you can do with this. Minimal example here just shows a boolean test of hierarchy membership. 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38
 public enum TreeEnum { THING, SUB_THING_1(THING), SUB_THING_2(THING), SUB_SUB_THING_2(SUB_THING_2), OTHER, SOME_OTHER(OTHER), AND_YET_ANOTHER(OTHER) ; private final TreeEnum parent; private final int depth; private TreeEnum() { this(null);} private TreeEnum(TreeEnum parent) { this.parent = parent; if (parent != null) { this.depth = parent.depth+1; } else { this.depth = 0; } } public boolean isA(TreeEnum other) { TreeEnum t = this; do { if (t == other) return true; t = t.parent; } while(t != null); return false; } } 



12

Discussions / Java Gaming Wiki / List of Learning Resources

on: 20140120 14:16:07

This page is dedicated to good quality learning resources. Feel free to modify it and throw in any books/articles/tutorials/websites of worth.Game Development TechniquesArticles & TutorialsOpenGL  GeneralArticles & TutorialsModern OpenGLBooksWebsitesOpenGL  GLSLWebsitesJava2DArticles & TutorialsMathThe Java LanguageArticles & TutorialsBooks



13

Discussions / Java Gaming Wiki / Stupid generics tricks

on: 20140114 15:50:40

Phantom TypesTODO: Add cheesey type refinement (sketched in the phantom types thread as well) Checked exceptions as uncheckedJava the language requires checked exceptions, where the JVM does not. This uses type erasure to allow throwing a checked exception as unchecked. 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15
 public final class Util { @SuppressWarnings("unchecked") private static <E extends Throwable> void throw_(Throwable e) throws E { throw (E)e; } public static void silentThrow(Throwable t) { Util.<RuntimeException>throw_(t); } } 
Constructor hugger1 2 3 4 5 6 7 8
 public class Animal<T> { public <P> Animal(P mommy, P daddy) { ... } }
dog = new <Wolf>Animal<Dog>(wooo, woooo); 



15

Discussions / Java Gaming Wiki / Resources for learning software design.

on: 20131017 14:25:24

Hi. I'm looking for something that will let me dive deep inside the software architecture. The problem is I cant find a correct way to structure my software. There are multiple layers and separate modules. The stuff gets heavier and more verbose. I would like to read any resources that describe common software design problems and solutions to this. I'm not looking for design patterns, which can solve rather small problems.
Thanks in advice.



17

Discussions / Java Gaming Wiki / Smoothing Algorithm Question

on: 20130528 00:57:32

COULD SOMEONE MOVE THIS TO THE GENERAL DISCUSSION SECTION. @_@
Hello! This is a question that's for all ya'll who have more experience in graphics and algorithms than myself. I'm working on a project (For work, and I did get permission to ask around) that requires the smoothing of a large set of data.
The basics of is that there is a data set that is a 3D matrix filled with 'slowness' values which is basically 'When moving through this cell how many units do you move per time step?' Initially, these values are filled in with a interpolated gradient from some min at the top to some max at the bottom. Then, this data set has a function applied to it repeatedly that takes the data set and another set of inputs, and updates certain cells in the matrix to new values. The updated data set is then fed back into the algorithm again and again until it converges or some maximum number of iterations is achieved.
This is where the major problems begin. For the most part, the function expects that there is some degree of smoothness to the data set, IE there is some finite, but unknown, allowed difference between values in adjacent cells for which the algorithm will produce meaningful data. This is due to the fact that there is no guarantee that each application of the function will touch the same cells, only that it should touch cells that are close to those touched in the prior step. Due to the fact that the starting estimation (The gradient) is so bad the updates result in large discrepancies between updated and unupdated cells. To help combat this a filtering operation, namely a smoothing, is applied to the the entire data set before it is fed back into the algorithm. Currently, the smoothing operation is a Sliding Windowed Mean with the window size that changes as the iterations continue and as the estimation becomes more exact. Typically it starts out at a window size that is the size of the data set with a slide of 1 (In each direction).
For the size of data set that we're typically work on, this takes a large portion of time (Think a data set that's about 100x50x50, with a sliding windowed mean of 100x50x50 and a slide of in the (x,y,z) direction). This has two major problems: First, it takes a long time to perform this operations, and Second, at least in early iterations there is a 'large' contribution to the value of cells from those that are relatively far away.
So, while it would be nice to figure out a better initial data set, IE One that will result in a smaller degree in discrepancies between early applications of the function, I've been asked to work on the problem of making the filtering itself more efficient. So many, I'm asking about various filters and whether anyone has any resources for the use of them in 3D (As in smooth across depth instead of just height and width) resources, anything about how to figure out when the application of a filter will result in littletono change (IE figuring out when I can exclude a cell from having the filter applied to it) and things like that?



18

Discussions / Java Gaming Wiki / Complex number cookbook

on: 20130314 16:44:34

By representing an orientation (or rotation) by a complex number instead of an explicit angle we can drop a fair number of expensive operations. So instead of storing angle 'a', we store complex number (cos(a), sin(a)). Another potential advantage is the algebra framework (just manipulating algebra) and reasoning. Algebra's like complex number, vectors, quaternions, etc allow thinking in terms of relative information which can greatly simplify the process. We will assume that standard mathematical convention of the X axis pointing the to right and the Y axis pointing up. Additionally we will assume that the reference orientation of objects is pointing straight right. Combining these together when thinking about some specific entity, we can think in terms of its center being at the origin and its facing straight down the X axis. NOTE: Although angles are talked about, this is for understanding and thinking purposes and not computation. Basic examples in code: Common definitionsCapital letter are complex number and small are scalars. X=(a,b) Y=(c,d) P=(x,y) R=(cos(a), sin(a)) S=(cos(b), sin(b)) Complex number basicsComplex numbers are represented by two numbers, which we will denote as a pair (a,b). The first number we will call 'x' and the second 'y'. ConjugateX^{*} = (a,b)^{*} = (a,b)R^{*} = (cos(a),sin(a))^{*} = (cos(a),sin(a)) = (cos(a),sin(a))
So the conjugate reflects ( wikipedia) about the X axis, which is the same as negating the angular information. (SEE: Trig identities: Symmetry) Addition/Subtraction X+Y = (a,b)+(c,d) = (a+c,b+d) XY = (a,b)(c,d) = (ac,bd)Operation is componentwise. Can represent translation. Product XY = (a,b)(c,d) = (acbd, ad+bc) RP = (cos(a), sin(a))(x,y) = (x cos(a)  y sin(a), y cos(a) + x sin(a)) RS = (cos(a), sin(a))(cos(b), sin(b)) = (cos(a)cos(b)  sin(a)sin(b), cos(b)sin(a) + cos(a)sin(b)) = (cos(a+b), sin(a+b))So the product sums the angular information of the two inputs. (SEE: Trig identities: angle sum) SEE: C2D.mul(C2D)Product combined with conjugate X^{*}Y = (a,b)^{*}(c,d) = (a,b)(c,d) = (ac+bd, adbc) R^{*}S = (cos(a),sin(a))^{*}(cos(b),sin(b)) = (cos(a),sin(a))(cos(b),sin(b)) = (cos(a)cos(b)+sin(a)sin(b), cos(b)sin(a)+cos(a)sin(b)) = (cos(ba),sin(ba))Since we can add angles with the product and can negate an angle with the conjugate, the two together allow us to subtract angles. (AKA get relative angular information) SEE: C2D.mulc(C2D) & C2D.cmul(C2D)Magnitude (L_{2} norm)X = XX^{*} = (a,b)(a,b) = sqrt(a^{2}+b^{2})Notice that we're not calling this length. Complex numbers, vectors, etc do not have lengths (nor positions). What they represent in a give instance might have a length equal to its magnitude. Unit complex and trig formUnit complex numbers have a magnitude of one and can be written in 'trig form': (cos(t),sin(t)). Since scale factors can be pulled out (see scalar product) all complex numbers can also be written in 'trig form': m(cos(t),sin(t)). Scalar productsX = s(a,b) = (s,0)(a,b) = (sa, sb)This can be reversed, so all scale factors can be pulled out. Inverse 1/X = X^{*}/(XX^{*}) = (a,b)/(a^{2}+b^{2}) 1/R = (cos(a),sin(a))/(cos(a)^{2}+sin(a)^{2}) = (cos(a),sin(a)) = R^{*}The multiplicative inverse of a unit complex is the same as its conjugate. SEE: C2D.inv()Counterclockwise rotation of point about the originFalls directly out of the product. Given rotation (R) and point (P), the point after rotation (P'): P' = RP = (cos(a), sin(a))(x,y) = (x cos(a)  y sin(a), y cos(a) + x sin(a))Example: P = (3,3) R = (cos(pi/4), sin(pi/4)) = (.707107, .707107) P' = (3,3)(.707107, .707107) = (0, 4.24264)How do I find rotation of A into BSolve the above. Assuming A & B are unit vectors: RA = B R = B(1/A) R = BA^{*}Example: A = (0.809017, 0.587785) B = (0.5, 0.866025) R = BA^{*} = (0.5, 0.866025)(0.809017, 0.587785)^{*} = (0.5, 0.866025)(0.809017, 0.587785) = (0.104528, 0.994522)Counterclockwise rotation of point about arbitrary pointWe can rotate about the origin, to rotate about an arbitrary point (C) translate the system to the origin, perform the rotation and then undo the translation. P' = R(PC)+C = RPRC+C = RP+CRC = RP+C(1R) = RP+Twhere T = C(1R). Look at the last line. It is telling you that the rotation R about point C is equivalent to a rotation about the origin R followed by a translation T. And C is recoverable from T & R: C = T/(1R) (assuming R isn't 1...or no rotation). Composition of rotationsFalls directly out of the product. Given rotation (R) followed by rotation (S): RS = (cos(a+b), sin(a+b))Orthogonal directionTo find a direction orthogonal in a righthanded sense is the same as rotating by pi/2 radians (90 degrees), which is to multiply by (cos[pi/2], sin[pi/2) = (0,1). ortho(X) = ortho((a,b)) = (a,b)(0,1) = (b,a)Relation to dot and cross productsFalls directly from the product where one is conjugated: X^{*}Y = (a,b)^{*}(c,d) = (a,b)(c,d) = (ac+bd, adbc)dot(X,Y) = ac+bdcross(X,Y) = adbcThe dot product is the parallel projection and the cross is the orthogonal projection. Cross product is related to dot product by: cross(X,Y) = dot(ortho(X),Y). Basic geometryOn which side of a line is a point?A line can be represented by a direction (L) and a point on the line (A). The simplest case is a line which coincides with the X axis, L=(1,0) & P=(0,0), in which case we can simply examine the 'y' value of a test point (P). If 'y' is positive, then it is above, zero on the line and if negative then it is below. Moreover the value is the orthogonal distance of the point from the line. Next let's consider an arbitrary line through the origin with unit direction L. We can simply rotate the system such that the line coincides with the X axis as above and we're done. Our modified test point becomes: P'=PL^{*}. Now the 'y' of P' is exactly the same as above. To fully generalize we simply need to move the line to the origin which give us: P'=(PA)L^{*}. If we were to plug in symbolic values: P=(px,py), L=(lx,ly) & A=(ax,ay) and expand we would see that we have unused intermediate values. This is because we are ultimately only examining a single component..we're only examining the orthogonal projection of the point into the line (SEE: cross product above). Additionally the direction of the line does not need to be normalized if we're only interested in above, on or below line question. The reason is because we only care about the sign of the result to answer our question. So the 'which side' question reduces to: cross(L,PA), which expands to the following pseudocode: return lx*(pyay)ly*(pxax) Aside: the previous can be expanded to cross(L,P)cross(L,A) = cross(L,P)m. The scalar 'm' can be stored instead of the point 'A' to represent the line. This value 'm' is commonly called the 'moment about the origin'. Basic examplesAt the top we say we can represent an entity by its position and orientation and think about its center as being at the origin and facing straight down the X axis (the reason for this is because that's the entity's local coordinate frame). Let's call it's position E and orientation F and we have some test point P. We can translate the system to the origin (PE) and then we can undo the rotation of the system by multiplying by F^{*}, which gives us: (PE)F^{*}. So P in the reference frame of our entity is: P' = (PE)F^{*}Example: P = (100,100) E = (200,200) F = (.92388, .382683) < Pi/8 or 22.5 degrees P' = ((200,200)(100,100))(.92388, .382683) = (130.656, 54.1196)If you've ever worked with vectors, this should seem similar: find the delta distance and perform the dot and/or cross product. The above equation is finding the delta distance and then effectively computing both. (Obviously you only compute one if only need one). So the dot product is simply the 'x' coordinate in the local coordinate frame (parallel projection) and the cross is the 'y' coordinate (orthogonal projection). What's my unit direction vector?It's pretending the unit complex number of the orientation is a unit vector. It has the same numeric values for 'x' & 'y'. Is it behind me?As noted above the dot product is 'x' in the local coordinate frame, so the sign of the dot product. If negative it's behind the center point with respect to facing and positive if forward. Turn clockwise or counterclockwise?As noted above the cross product is 'y' in the local coordinate frame, so the sign of the cross product. If positive the shortest turn is counter clockwise, if negative it's clockwise and if zero it's straight ahead. Turn toward point with constant angular velocityAgain, the sign of cross product tells the minimum direction. Take a constant angular velocity, store as a unit complex number 'A'. If the sign of the cross product is negative, we need to conjugate A (negate it's 'y' component). Multiply the current facing 'F' by the potentially modified 'A'. Take our new 'F' and cross again. If the sign has changed, we've overshot the target. Is point within field of viewGiven an entity in its local coordinate frame: image some field of view (<= Pi or 180 degrees), which become a pair of line segments symmetric about the Xaxis (or triangle or cone). We can immediately note a couple of things. The first is that if our x component of a test point P=(px,py) is negative that it cannot be inside. The second is that given the symmetry about the Xaxis, P and P ^{*} will always return the same results. Given the second we can form a new test point P'=(px,py). Now the problem is identical to on which side a point falls with respect to a line through the origin and we the first observation isn't required to compute the result. Since we're asking 'below' the line, we negate the result to convert into the convention of positive is inside, yielding the following pseudocode: return ly*pxlx*Math.abs(py);As with the point to line test, our direction L does not need to be normalized and L is half of the fieldofview. Which unit direction forms the minimum angle with the local X axis.Although related to point/line and viewofview, this case reduces to simply the direction with the greatest x component. Bounce reflectionGiven a vector (v) of something that hits a surface with normal (n) the resulting vector (v') has the same orthogonal part and the parallel part is negated. The parallel part is dot(n,v), so vn(dot(n,v)) removes the parallel part and v2n(dot(n,v)) results in the parallel part being negated. For point reflections: negate the bounce reflection equation. SEE: C2D.uref (this is point refection implementation)



19

Discussions / Java Gaming Wiki / Forms of Randomness

on: 20121208 22:46:42

Forms of Randomness
I. Random Number Generatorsi. IntroductionRandom number generators create a sequence of random bits. The client to a random number generator class can request the raw bits directly or interpreted data derived from the bit sequence (floats, doubles, values between two other values, values with a certain distribution, etc.) Random number generators produce bits in a sequence and have a state. It may not be possible to achieve random access to a number in the sequence produced by an RNG. Random numbers are also not be suited for applications with data in multiple dimensions stretching to infinity or finite grids that are too large to store in RAM. If you need random data as a function of one or more variables, you can use a hash function or an RNG seeded from the value of a hash function. 1. RNG SeedA value called a seed can be used to derive the initial state of a Pseudo Random Number Generator. If you provide the same seed to a PRNG, it will produce the same sequence of numbers every time (but only for the same algorithm). This is useful for creating reproducible procedurally created content, synchronizing random number sequences between multiple computers, or any other scenario require consistency or reproducibility. 2. RNG StateThe state of a PRNG is normally hidden to the user of the object. You can create a PRNG that lets you copy it's state into a different object, so you can create identical sequences starting from the middle of a sequence (instead of just the beginning using a seed) and so you can save and restore the state of the PRNG in the middle of a sequence. All pseudo random number generators have a state. PRNGs are deterministic and do not return truly random sequences. ii. Cryptographic Random Number GeneratorsCryptographic random number generators have special properties useful for security related applications. They exploit properties of number systems that can be used for private communication, authentication, and zero knowledge proofs. They work with large numbers and may be too slow for applications that do not require them, such as simulations or games. If you think you need one in your game but don't know how it works or what it's used for, then you probably don't need one. iii. NonDeterministic Random NumbersYou don't need true random number generators for the same reason you don't need cryptographically secure random number generators. Cryptographic PRNGs may benefit from keys derived from real world noise in order to prevent some attacks, but a game won't have to worry about such attacks. To get this type of randomness, computers use input from the physical world that can be considered random. The "state" of this RNG is the state of the real world. It does not have the useful properties of PRNGs other than the appearance of randomness. Computers might utilize this source of randomness or user inputted key to seed a cryptographic PRNG instead of a timer to prevent certain side channel attacks. If you're not using cryptography, don't look for this type of randomness. II. Hash Functioni. IntroductionHash functions take a sequence of bits and transform them to a new sequence of bits, usually of some fixed length. The function for Java Objects produces a 32 bit output. Hash functions are sometimes (that is, very rarely) referred to as compression functions because they take a sequence of bytes and shorten it to a smaller sequence. One way to do this is to simply truncate the sequence (for example "Java Gaming" could be hashed to "Java"), but it's generally better to have some type of random output. This way "Java Gaming" and "Java Programming Language" don't create a hash collision. One good reason to never call a hash function a compression function is that it can easily be confused with a compression algorithm. A compression algorithm also shortens a sequence of bits, but in a way that is meant to be reversible. In a way, hash functions work the opposite of a random number generator. A random number generator may take a 32 bit seed and be used to create a much larger sequence of random numbers. A hash function takes a long sequence of bytes and can convert it to a "random" 32 bit hash. A PRNG always produces the same output sequence given the same seed. And a hash function always produces the same hash given the same input. This article uses H(X) = Y to represent a generic hash function. X is the input and Y is the output, or "hash," or "hash value." 1. Cascade Effect and Relation to PRNGsThe cascade effect says that if you change one bit of the input to a hash function, then about half the bits of the output should change, too, on average. This means that H("StringA"), H("StringB"), and H("StringC") all produce very different output. A random number generator where each output bit had a uniform probably of being zero or one will produce a similar outcome. One way a cryptographic PRGN can be created is to take the hash of a counter using a cryptographic hash function, although this would be too slow to use in a video game. Some general purpose PRNGs operate in the form where f(x) is a onetoone hash function. Special care must be taken to ensure that f(x) has a long enough period for all valid states and that its sequence still appears random. iii. Randomness, collisions, and Hash TablesHash tables take advantage of hash functions to make make fast searches for key values. Java's hashCode() function compresses the data represented by an Object (such as a String, which can be much longer than 32 bits) so that it can be manipulated as an int. The first location the hash table looks for an object is at array index key.hashCode() % arraySize 
If different values map to the same array index (or hash value if not further compressed using %, then those two values are said to cause a collision using that hash function, which makes look up slower. Collisions in hash functions used in procedural content generation may create visual artifacts. Good hash functions are unpredictable, have the cascade effect, and are statistically as likely to produce one value as any other, so that the chance of collision is minimized. iv. Procedural Content, Salting, and Spatial HashingHash functions are useful for generating random values that can be found without sequential access or a look up table. For example, if I had a randomly generated RPG world but if I wanted the same people to appear, I could combine a hash function and RNG to generate similar characters with the same name in alternate realities. In this example Bob may be a character with brown hair, a green shirt, blue pants, black shoes, and no glasses. In other save file, he might look the same but have brown hair. Or have glasses in a third save file. 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40
 public static Character createCharacter(String characterName, String worldId) { Rng rng = new Rng(characterName.hashCode()); Character c = new Character(characterName);
c.setHairColor(rng.nextInt(0, MaxHairColorId)); c.setShirtColor(rng.nextInt(0, MaxShirtColorId)); c.setPantsColor(rng.nextInt(0, MaxPantsColorId)); c.setShoeColor(rng.nextInt(0, MaxShoeColorId)); c.setGlasses(rng.nextBoolean); c.setGlassesColor(rng.nextInt(0, MaxGlassesColorId));
rng.reset((characterName + ":" + worldId).hashCode()); switch(rng.nextInt(0, 5) { case 0: c.setHairColor(rng.nextInt(0, MaxHairColorId)); break; case 1: c.setShirtColor(rng.nextInt(0, MaxShirtColorId)); break; case 2: c.setPantsColor(rng.nextInt(0, MaxPantsColorId)); break; case 3: c.setShoeColor(rng.nextInt(0, MaxShoeColorId)); break; case 4: c.setGlasses(!c.hasGlasses()); break; case 5: c.setGlassesColor(rng.nextInt(0, MaxGlassesColorId)); break; } return c; } 
Another way to use hash functions is to hash xy coordinates. Separate your game world into grids and randomly generate content in a grid one grid at a time. You can generate them all ahead of time, or you can generate them on the fly by using a hash function H(x, y) to seed the RNG in that grid location. When the player leaves that area, you can forget about that grid cell and recreate the exact same area the next time the player goes to that area. One potential problem with this approach is that if a person replays the game, all maps will be the same. This may be desirable. (And it may be helpful. Procedurally created worlds may let you distribute a small binary file and no extra resources (Java4k?) and still have consistent user experience.) One way to change the output of a hash function is to add a "salt" value. You could store the salt in the player's save file or derive one from their username. Modifying the salt is like modifying the RNG seed. Utilizing String's hashcode function again, you could have a saltless version of a hash function that returns (x + ", " + y).hashCode() 
and a salted version that returns (playerName + "..." + x + ", " + y).hashCode() 
. Spatial hashing is one you take a point in multidimensional space, determine what grid cell (square, hexagonal, cubic, or whatever) it is in, and convert the position of that cell to a value. III. Other sequencesOther sequences may be used that look random to humans and provide certain properties, but aren't actually. Halton and Sobol sequences are examples of low discrepancy sequences and are also called quasirandom sequences. IV. NoiseNoise combines one or more of the above forms of randomness and algorithms to produce a desired affect. Perlin noise, for example, requires a grid of random values, which can either be derived ahead of time using an RNG (for small grids) or on the fly at any point using a hash function (for large or infinite grids,) and interpolates between those values for other locations. White noise in the real world represents a signal with many many frequencies present over an entire spectrum of frequencies. The intensity of the noise is completely random. You could convert the output of an RNG to a PCM sound data to produce (1D) white noise sound or set the brightness of each pixel in a black and white image to the output of an RNG to produce a (2D) white noise image. White noise generally isn't very useful. Noise may be generated with specific aesthetic, frequency spectrum, or structural properties instead. See other articles for descriptions of types of noise, noise algorithms, and applications of noise.



20

Discussions / Java Gaming Wiki / GLSL tricks

on: 20121207 04:44:28

Todays GPUs are very powerful but it's important to understand the limitations of the hardware of GPUs. For example, branching in GLSL is very expensive due to the way that the stream processors on GPUs work. In many cases branching causes both branches to be executed and the correct result is then picked afterwards. A general tip when coding shaders is to use the builtin functions as much as possible. They are always faster than manually doing the calculations.  Never manually normalize a vector by calculating the length of it using a square root and dividing it by it. Always use normalize().
 Don't use branching to clamp values. Use min(), max() and clamp() for that.
 A very common function is linear blending and there's a function called mix() for it.
Generating random numbers Generating random numbers on a GPU in a traditional way is impossible since we can't use a global seed (well, we can in OGL4+ using atomic counters, but I wouldn't count on good performance). Random numbers can be useful to introduce noise to counter banding in algorithms like HBAO (randomly rotate the sampling ray) or volumetric lighting (random offsets) to trade banding for noise which is much harder to spot and looks better when blurred. This oneline function is a pretty simple noise function seeded with a 2D position (you can use the screen position or texture coordinates as the seed). Generating random numbers on the GPU presents a couple of challenges. The first is that from a practical standpoint you start with some nonrandom data (say a texture coordinate) which needs to be hashed to give a "random" starting value. The second is that most GPUs currently in use are very slow at integer computations which are invaluable in hashing and generating PRNGs. The results needing to perform very hacky hashing and random number generation entirely in floating point until your low end target has fullspeed integer support.1 2 3
 float rand(vec2 co){ return fract(sin(dot(co.xy ,vec2(12.9898,78.233))) * 43758.5453); } 
Permutation polynomials. In use examples: ( Local value noise, gradient and simplex noise) 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18
 vec2 mod289(vec2 x) { return x  floor(x * (1.0 / 289.0)) * 289.0; } vec2 permute(vec2 x) { return mod289(((x*34.0)+1.0)*x); } vec2 rng(vec2 x) { return fract(x*1.0/41.0); }
float bar(vec2 x) { float h, r; vec2 m = mod289(x);
h = permute(permute(m.x)+m.y); r = rng(h); ... h = permute(h); r = rng(h); }

Dot products The dot() function is used to calculate the dotproduct of two vectors, which is the same as multiplying the vectors componentwise and then adding them together. For a 3D vector, that means that dot(v1, v2) = v1.x*v2.x + v1.y*v2.y + v1.z*v2.z 
. This is a very useful function for doing many things. For example, calculating the distance between two points using Pythagoras' theorem: 1 2 3 4 5 6 7 8
 vec3 p1; vec3 p2;
vec3 delta = p1p2; float distSqrd = dot(delta, delta); float dist = sqrt(distSqrd); 
Converting a color to grayscale: 1 2 3 4 5
 vec3 color;
float grayscale = dot(color, vec3(0.21, 0.71, 0.07)); 
Shadow mapping Shadow mapping is basically a software depth test against a shadow map. The shadow map coordinates are interpolated as a vec4, so we need to do a wdivide per pixel, get the shadow map depth at that coordinate and compare it to the pixel's depth. A simple implementation does this: 1 2 3 4 5 6 7 8 9
 uniform sampler2D shadowMap;
float shadow(){ vec3 wDivShadowCoord = shadowCoord.xyz / shadowCoord.w;
float distanceFromLight = texture(shadowMap, wDivShadowCoord.xy).z; return distanceFromLight < wDivShadowCoord.z ? 0.0 : 1.0; } 
This is not optimal. By using the function called step() we can eliminate the branch by just writing return step(wDivShadowCoord.z, distanceFromLight); 
instead. Even better, the GPU can do the shadow test for us in hardware with some basic shadow filtering if we use a sampler2DShadow instead of a normal sampler2D. That way we just feed in the xyz wdivided shadow coordinates into it. On the shadow map, set up the following parameter to enable hardware shadow testing: GL11.glTexParameteri(GL_TEXTURE_2D, GL14.GL_TEXTURE_COMPARE_MODE, GL14.GL_COMPARE_R_TO_TEXTURE); 
and change the sampler type to sampler2DShadow. It's also possible to enable GL_LINEAR as the texture filter and get 4tap PCF bilinear filtering. There is one final optimization. Not only can the GPU do the shadow test in hardware with filtering, it can also do the wdivide in hardware using ! It can't get better than that! 1 2 3
 float shadow(){ return textureProj(sampler, shadowCoord); } 
We get better performance, better image quality thanks to the PCF filtering AND a simpler shader. However, the first shader is extremely fast anyway, so why optimize it this much? Shadow filtering. To get smoother shadow edges you do lots of shadow tests on nearby pixels in the shadow map, usually 8 to 16 of them. In that case we would've gotten 16 branches, not just one, so eliminating them means a lot here. Using hardware filtering also gives you 4 samples per texture lookup instead of just one, allowing you to sample a bigger area. GLSL Gotchas Array declaration is broken on Mac Snow Leopard[1]



21

Discussions / Java Gaming Wiki / Uniform feature points

on: 20121205 15:27:32

Main/Procedural contentSTUB (YEAH, I'M MAKING LOTS OF THESE) TO REMIND MYSELF TO DO A WRITEUP. Uniform Feature PointsLet us imagine that we have a 100x100 meter field and in this field we what there to be, on average, two flowers per meter squared. So we could create an array with 100x100x2 = 20,000 elements to explicitly store the positions of each flower. Using a seeded uniform random number generator we could then fill the array with repeatable coordinates for each. If we were to examine the placement of flowers we would notice that there would be regions with none and areas where they are clummped up. 1 2 3 4 5 6 7
 rng.setSeed(someValue);
for(int i=0; i<100*100*2; i++) { float x = 100*rng.nextFloat(); float y = 100*rng.nextFloat(); doMyFlower(x,y); } 
Now if were to examine each square meter (or some other regular chunk) and count the number of flowers it contains, then the "distribution" of the counts approaches the Poisson distribution ( Wikipedia, MathWorld). So instead of precomputing a explicit list of "features", the space in question can be broken down into parts. For each part one computes a poisson random number to determine the number of features inside it. 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31

public static final int poisson(float eMean) { int r = 1; float t = rng.nextFloat(); while (t > eMean) { r++; t *= rng.nextFloat(); } return r1; }
private static final float FLOWER_POWER = (float)Math.exp(2);
private void doSomeCellFlowerThing(...) { rng.setSeed(hashOfThisCell);
int num = poisson(FLOWER_POWER);
for(int i=0; i<num; i++) { float x = rng.nextFloat(); float y = rng.nextFloat(); ... } }

Assuming that the chosen hashing function does a reasonable job, then the "look" of the localized vs. global versions should be similar. Up until now I've avoided too much techospeak but some definitions are required. All of the above rng.nextFloat() calls are assume to return a uniformly distributed random number on [0,1) which is the standard base contract for a uniform floating point result (actually the inclusion/exclusion of the endpoints may vary, but I'm assuming the presented). In probability a uniform distribution ( Wikipedia, MathWorld) means that all results on the range are equally probable...like in a single fair die roll. So in the examples above the 'x' coordinate of each flower is completely independent of 'y', which should be expected. Moreover the coordinates of each flower is independent of any other. This leads to the previously mentioned empty and clumpped up areas. This result, like many from probability, is likely to seem counterintuitive. Most likely "uniform" will tend to invoke notions of uniformly (or evenly) covered areas. This is a radially different notion of uniform as implies that all of the values are related to each other rather than independent. Note that these two different notions of uniform approach one another as the number of features (or event) increase.



22

Discussions / Java Gaming Wiki / Orders of magnitude

on: 20121127 13:22:32

BANGED OUT QUICK  MIGHT BE MISTAKESProgrammers daily work with 32 and 64 bit quantities so it's sometimes easy to loose sight of scale. Additionally humans are better at thinking in terms of linear changes and have difficult with fast growing functions. Likewise once number get bigger/smaller beyond some point, any additional bigger/smaller has less and less meaning to to point where changes become somewhat meaningless. Distances (in meters) greater than 10 ^{6} are officially termed "Astronomical", which is ~2 ^{23}. The following table list some powersoftwo along with the bounding factorials and some quantities of that scale: Number  Relation of scale to real world  12! < 2^{32 } < 13!   The diameter of the sun is ~2^{30}m.
 The number of people alive today (~2^32).
 20! < 2^{64 } < 21!   The number of people whom have ever lived: ~2^{37}
 Thickness of the Milky Way's gaseous disk ~2^{55}Km
 The distance from the sun to Proxima Centauri is ~2^{55}m
 The age of the universe is ~2^{59} seconds.
 34! < 2^{128 } < 35!   The observable universe has an estimated radius of 93 billion lightyears which is ~2^{119} nanometers.
 57! < 2^{256 } < 58!   98! < 2^{512 } < 99!   The number of atoms in the observable universe is ~2^{266}.
 170! < 2^{1024} < 171!  
Notice to reach a mere 2 ^{614} we are measuring the incomprehensibly large in terms of the incomprehensibly small. Now consider the value of 2 ^{64}2 ^{32}. Without stopping to think you might be tempted say that this is ~2 ^{32}, when actually the value is ~2 ^{64232} or ~2 ^{63.999999999664}. Since we're programmers it is probably more useful to consider computation. Real world examples below are using FLOPS measurements.  AMD 7970 system which can perform ~2^{44} computations per second and ~2^{68} per year.
 The Cray Titan which can perform ~2^{54} computations per second and ~2^{79} per year.
 It's estimated super computers will reach ~2^{60} per second by 2018.
 It's estimated super computers will reach ~2^{70} per second around 2030.
 Imagine an atom which is a quantum computer that can perform one computation per Plank's time (5.39106*10^{44}s). Then this atom computer can perform ~2^{144} computations per second and ~2^{169} per year.
 Imagine a supercomputer made of all the atoms in the observable universe which is ~10^{80}, each of which is one of the above, resulting in ~2^{410} computations per second and ~2^{435} per year.
We'll also define a time scale BB which is equal 4.339*10 ^{17}s, the amount of time from the big bang until now. The Titan can perform 2 ^{64} computations in ~17 minutes and 2 ^{128} in ~2 ^{16} BB. The atom computer could perform 2 ^{128} computations in ~15 milliseconds and 2 ^{256} in ~2 ^{53} BB. The universe could perform 2 ^{256} computations in less than one Plank time and 2 ^{512} in ~2 ^{43} BB. It would take the Titan ~2 ^{65} years to perform one second of the atom computer. The big bang was merely ~2 ^{34} years ago. It would take the atom computer ~2 ^{241} years to perform one second of the "universe" super computer.



23

Discussions / Java Gaming Wiki / Pseudo random number generators

on: 20121115 16:40:51

VERY ROUGH WORK IN PROGRESS..NO REAL USEFUL INFORMATION AS OF YET. A random number generator is like sex; When it's good, it's wonderful, And when it's bad, it's still pretty good. George Marsaglia Games? Crank 'em out as fast as you can; Wham! Bam! Thank you ma'am! Roquen OverviewThe purpose of this page is to give an rough overview of how pseudo random number generators (PRNG) work and a rough idea of how to choose ones which are adequate for a game runtime. Rules of thumb Never use the same instance of a generator in more than one thread.
 Never create static utility methods which call a generator unless single threaded (same as previous).
 If using a JDK supplied generator, use ThreadLocalRandom.
XXX Use different generators if you need a more expensive one for a subset of tasks...oh, and don't really worry about any of this stuff if you just don't generate many random numbers for a given task. Everything below this point can (and should) be ignored unless you are generating a large numbers of random numbers per frame OR you tempted to use OR are using a "good" random number generator especially one with a period greater than 2 ^{64}. If a your most expensive AI entity needs up to half a million random numbers per frame, then a barely reasonable PRNG with a period of 2 ^{32} should be more than sufficient. Again this page is only dealing with PRNGs for game runtimes where "real" money is not directly involved...as in for gambling.IntroductionThe vast majority of PRNGs all work in the same way. They take some statedata in the form of a sequence of bits and perform computations which mix the bits. Notice that hashing and random number generation are very similar. A given generator will have a period which is the number of unique values the state will assume before wrapping around and repeating itself. Yeah, that was clear. OK, let's pretend like we're using a 2bit integer for our state data, so our 2bit integer can have values of: {0,1,2,3}. For our random number generator we want to produce some permutation ( MathWorld, Wikipedia) of that set which appears random. The number of permutations of a set with n elements is Factorial[n], so we have 24 choices for our 2bit integer. Limiting the set to those that start with '0' (all the remaining are rotations), we have: {0,1,2,3},{0,1,3,2},{0,2,1,3},{0,2,3,1},{0,3,1,2},{0,3,2,1}. Now obviously none of the above permutation choices look very random but this is exactly how random number generators work. The problem here is that there just aren't enough unique values that any of the permutations appear random. Luckily factorials explode and if we were talking about only 8bits then there would be approximately 8.6x10 ^{506} choices and 16bits is ~5.2x10 ^{287193}. Other than some very narrow special cases (like in GLSL, when attempting to avoid using integers) there's no reason to use generators with less than 32bits. An implication of this is that the period can be at most 2 ^{n}, where 'n' is the number of bits. On this page we will only consider "full period generators" which will have a period of either 2 ^{n} or 2 ^{n}1. The minus one comes into play for generators for which zero is an invalid state. This does not imply that PRNGs with longer periods are superior in quality than those that are shorter. PeriodAs mentioned above the period of a PRNG is the length of the sequence that it generates. Once the period is exhausted, the sequence wrapsaround and starts to repeat itself. For scientific usage long periods are important. The reason for this is that statistically they will begin show defects if in "single computation" more than sqrt(T) random numbers are used, where T is the period. Note that the sqrt(T) = T^{1/2}. Even more important is because one can break a problem across multiple CPUs/servers/whatever to attack a single problem and the longer the period, the lower the probability that the individual computation units will be using overlapping parts of the sequence. Note the "single computation" part. There's the mistaken notion in games that one needs a period long enough that it never repeats during gameplay. Not at all, it simply should be long enough that every single computation has more than enough values to complete. So what about the period? Do we need to think in terms of T or sqrt(T)? The question is more or less moot. As noted above there's no reason to use a generator with a period shorter than ~2 ^{32}, so you should feel safe if any single problem needs no more than 2 ^{16} or 65536 random numbers, which seems highly unlikely. At the opposite end of the spectrum (SEE: url=http://www.javagaming.org/topics/ordersofmagnitude/27917/view.html]orders of magnitude[/url]) it would take the Cray Titan more than 17 minutes to generate 2 ^{64} random numbers and an infinite amount of time to generate 2 ^{128}. Sticking the sqrt(T) rule of thumb this means you never need a generator with a period greater than 2 ^{128}. DimensionsHumm...any ideas here kids, other than don't worry about dimensions. Just don't use a LCG for more than 2. QualityPRNGs do not attempt to create sequences which appear random. Instead they are attempting to simulate statistical randomness. For our purposes the main usefulness of having a generator which passes the majority to all of XXXX XX note uniform distribution XX Write something somehow convincing about how quality a la. diehard and various crushes shouldn't matter. Old SkoolPermutation PolynomialsSEE: GLSL TricksWeyl GeneratorsThis family is based on the equidistribution theorem (properties of irrational numbers). Quality varies widely depending on formulation and precision. Like permutation polynomials they can be computed purely in floating point and are currently useful on the GPU. The simplest version looks like: u_{n} = na mod 1 = (u_{n1}+a) mod 1where: 'a' is a fixed irrational number mod 1. 'n' is the number in the sequence (0,1,2...) Common variants include nested: u_{n} = n(na mod 1) mod 1and shuffled nested (where 'm' is a fixed large integer): v_{n} = m(n(na mod 1) mod 1)+1/2 u_{n} = (v_{n}(v_{n} a mod 1)) mod 11 2 3 4 5 6 7 8
 vec3 weyli(vec3 s, vec3 a) { return fract(s+a); } vec3 weyl(vec3 n, vec3 a) { return fract(n*a); } vec3 weyln(vec3 n, vec3 a) { return fract(n*fract(n*a)); } vec3 weylns(vec3 n, vec3 a) { n = m*fract(n*fract(n*a))+0.5; return fract(n*fract(n*a)); } 
On the CPU side these are of limted usefulness, mainly integer versions can be used in a combined generator (below). Integer versions use a scaled irrational number rounded to the nearest odd value. This results in an abysmal quality generator with a period of 2 ^{n} where 'n' is the number of bits in the integer. 1 2 3 4 5 6
 private static final int WEYL = 0x61c88647;
private int weyl;
private void updateState() { weyl += WEYL; } 
Linear Congruent GeneratorsLinear congruent generators are among the oldest and best understood family of generators. Their quality can vary from poor to stateoftheart. It's only worth considering the poorest quality and fastest variants: standard integers with poweroftwo modulus. The first variant, the MLCG, is a single multiply and has a period of 2 ^{n}1 (zero is an illegal state). This is worth mentioning for the 4K contest. 1 2 3 4 5
 private int state;
private static final int K = 741103597;
public int nextInt() { state = K*state; return state; } 
Of more general interest is the most common variant, which simply adds an odd constant at every step. 1 2 3 4 5 6
 private int state;
public final int nextInt() { state = 0xac549d55 * state + 0x61c88647; return state; } 
LCGs have a very bad reputation. This is mainly due to some early C compilers using poorly chosen constants. Poorly chosen constants severly impact the quality of the generated sequence and this is true for all families of generators. A real issue with poweroftwo LCGs is that the quality decreases based on bit position. The highest bit is the most random and each following bit is slightly less than the previous and the lowest bits aren't random at all. This is less of a concern than one might imagine assuming your using a library with helper functions ( nextInt(int n), nextFloat(), nextBoolean(), etc) that take this fact into account. In this case the user might only need to consider this fact if using raw state: ' nextInt' in the case of 32bit and ' nextLong' in the case of 64bit generators. As an example calling nextInt() and using the result as a set of boolean one should use the top bits. SEE: "Tables of linear congruential generators of different sizes and good lattice structure", Pierre L'Ecuyer. New kids on the blockA fair number of modernish generators are based on linearshiftfeedback register (LSFRs). Most popular generators which are considered stateoftheart are based on (generalized) LSFR, such as Mersenne twister, WELL, et al. Generators like MT and WELL are insane overkill. For game related purposes interesting ones include: XorShift, XorWow and MSets. SEE: "Fast random number generators based on linear recurrences modulo 2: Overview and Comparison", Pierre LโEcuyer and Francois PannetonCombined generatorsWhen one family of generators has a statistical weakness at a given set of tests it can be combined with another family of generators that performs well at those tests. SummaryReferenceBlah, blah



24

Discussions / Java Gaming Wiki / World save system

on: 20120827 16:04:35

Hello, i'm new on the forum :p, I want to do a world save system but i have no idea of how to do this. I use a sprite system for my game. Can you help me ? Thx, Brian22950
PS : I'm french



25

Discussions / Java Gaming Wiki / How do I start Java Game Development?

on: 20120822 20:37:44

Java game development is not for the faint of heart. Like everything else, it requires patience, comprehension, and practice. These paragraphs are part of a triedandtrue track of experience levels that would be very beneficial to your growth. You don't have to start at the beginning, but can jump in at any spot you know you are in. Beginner, the most important and *required* step: For now since you are a beginner, learning Java syntax, core classes, and command line stuff is very important and should be your first priority. Do not jump straight into graphics. Make basic command line games using ASCII art. Make almost any game you can think of for the command line. Eclipse is a very useful and powerful tool and as much as you may like it too, I also recommend you to start with the command line. Write an entire command line app using just notepad, compile it, and run it. Start using packages and experience the pain and confusion of compiling and running programs that are in packages. *OPTIONAL*. Nowadays, it is best to start with LibGDX. Slick2D is another library with a slightly easier learning curve, but it's buggy, no longer maintained, and many years old. When you feel you know and understand Java well enough, jump into graphics using Java2D. Java2D is the java.awt packages and subpackages. These allow you to do custom drawing and offer very, very powerful tools for making 2D graphical apps and games. Also you may learn Swing, Java's GUI widget toolkit. It offers nice tools for making GUIs (Graphical User Interface). While you are becoming proficient with Java2D, you will learn and accept one grave and heartbreaking truth: Java2D is slow and unsuitable for professional and graphically expensive games. However, despite this shortcoming, it is the perfect playground for gaming beginners. I advise you to not advance until you have learned basic game systems, designs, code architectural organization, etc...*OPTIONAL*Finally, when you notice you are ready for hardcore, speedhungry games, you may jump into the OpenGL bandwagon. OpenGL is a portable highlevel API to interface with graphics cards. It is portable in the sense that it works on almost all graphics cards and all systems, and high level since it abstracts away the differences in graphics card functions and drivers. This means you get to skip the slowness of Java2D and be able to directly access the power and performance of raw graphics card awesomeness. This may all seem neat and amazing but there is 1 drawback......its API is written in C (another language). This means you can't really access it directly from Java without writing native code doing a lot of complicated stuff. Well fear not, a bunch of really cool people wrote a library that lets you access these functions and more, and these cool people named it the Lightweight Java Game Library (LWJGL). There is also another group of cool people who wrote a similar library and called it JOGL. They are both almost exactly the same and the only difference is in your perception of it and your choice. There are some libraries that try to simplify your life when making 2D/3D games and GUIs using OpenGL. Such tools include:  Slick2D: an opensource library whose API looks very similar to Java2D yet uses LWJGL underneath. So it lets you make 2D games without worrying about the details underneath. However, it is best if you understand the underlying inner workings so you can gain experience and be able to understand any problems you run into.  libGDX: opensource library that easily allows you to make OpenGL applications on PCs, HTML5, iOS and Android  Java Monkey Engine (JME): fully featured Java 3D engine built on OpenGL (LWJGL, JogAmp, Android GL, ...) that has tons of tools for making professionallooking games  jPCT: Another 3D engine built on LWJGL that to some is simpler and easier than JME yet isn't as powerful and proprietary. Ardor3D: A recently emerging 3D engine also built on OpenGL (LWJGL, JogAmp) that looks very promising, from what I've heard it combines the ease of jPCT and the power of JME. (discontinued in March 2014)  JogAmp's Ardor3D Continuation: A subset of Ardor3D actively developed and maintained exclusively based on JogAmp  Themable Widget Toolkit (TWL): A GUI widget toolkit. It is very powerful and allows for full customization of your widgets. This is the "Swing" version of OpenGL An alternative to TWL is scene2d.ui which is part of libgdx. These tools and engines are nice to use if you don't want to get too much into the details of OpenGL. However, it is better if you do because it is just nicer to understand what is going on behind the scenes and will help you debug any problems you run into. These libraries just ease the lives of those who already understand OpenGL, rather than helping ignorant impatient programmers who want to get their hands dirty in 3D designing. Well this was a long post, and I hope you now understand the current situation of Java gaming and have a basic timeline of your future If you need any help or assistance, we are always here to guide and point you along the way, not to spoon feed you with code. Remember, we're all a bunch of chill dudes sacrificing our time to help newbies because we enjoy it You can also join us at the #lwjgl channel on the Freenode IRC network for more help, but know that if no one responds, do idle since we are all on different timezones (half of them live in Europe!). P.S: You can contact another group of cool people at the #jogamp channel on the Freenode IRC network for more help. Good luck!!!! LINKS: Java Resources: http://www.javagaming.org/index.php?action=resources  OpenGL tutorials  Java ports  Another Java port



28

Discussions / Java Gaming Wiki / Noise (bandpassed white)

on: 20120810 08:42:04

Main/Procedural content/NoiseOverviewThe purpose of this page is to give an overview of how noise functions in this family work and the various tradeoffs that can be made in implementation choices. How to use noise to create and modify content is a huge topic...BLAH, BLAH add links. WebGL demo: http://glsl.heroku.com/e#7967.0Top to bottom: value noise, gradient noise and value noise. Righttoleft: single sample, 3sample fBn, 3sample turbulence. Cells are purposefully aligned. IntroductionThis family of noise functions are incredibly useful tools for creating and modifying content. According to CG industry lore it was informally observed in the 90s that "90% of 3D rendering time is spent in shading, and 90% of that time is spent computing Perlin (gradient) noise". Regardless of the truth of this observation, this family of noise functions are certainly one of the most important techniques not only in procedurally generated content but in CG as a whole. Increases in CPU speed and the relatively new addition of GPU computation allow for runtime evaluation of the cheaper of these methods in realtime graphics. Attempting to give any detailed descriptions of how to "use" noise functions to create or modify content is well beyond the scope of any short description. The goal here is to outline some basics of core generation techniques and to provide links to more detailed information in specific areas of interest. For the local discussion, we'll assume that noise accepts floating point input for a sample coordinate and returns a floating point value (usually either on [0,1] or [1,1]). It will provide some sketches of 2D implementations to (hopefully) aid in understanding. Noise functions are evaluated in some number of dimensions (typically 1,2,3 or 4). This is simply to say that you provide some input coordinate and noise returns the corresponding fixed value at that position, just like any other multidimensional function. From a signal processing perspective this family can be described as an attempt to approximate bandpass filtering of white noise. Perhaps a simpler description would be that they are attempts at coherent pseudorandom number generators (PRNG). Regular PRNGs attempt to create a fixed sequence (from some initial state data...frequently termed the 'seed') of values that appear to be statistically independent. White noise can be created from a PRNG as in the following sketch (in 2D): 1 2 3 4 5 6
 float eval(float x, float y) { long seed = mix(x,y); prng.setSeed(seed); return prng.nextFloat(); } 
Unfortunately raw white noise is of very little use. If you were to create a 2D texture from white noise, regardless of how you walk through the 'noise' function the result would be virtually identical. The result would be like what you'd see on an old broadcast TV tuned to a channel without a signal. What's really needed to be useful are random values that are coherent: which roughly says that sample points far apart are like PRNG values, appear to be independent, and the set of all sample points close to one another vary continuously (or smoothly in less formal speak). Value noiseValue noise is the one of the original attempts at this style of noise generation. It is very often miscalled Perlin noise. Evaluation is very cheap, but it burden with serious defects and is very poor at bandpass filtering. Quality can be improved, but even the most basic improvements make it more expensive than gradient noise. So a general guideline for using this technique is to only use a very cheap version and only when some existing content can be minorly modified by one or two evaluations. Value noise is computed by forming a regular grid, computing random values at each vertex and blending the values to produce a result. Sketch in 2D: 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20
 float eval(float x, float y) { int ix = (int)Math.floor(x); int iy = (int)Math.floor(y);
float dx = x  ix; float dy = y  iy;
float r00 = mix(ix, iy); float r10 = mix(ix+1, iy); float r01 = mix(ix, iy+1); float r11 = mix(ix+1, iy+1);
return blend(r00,r10,r01,r11,dx,dy); } 
So to compute value noise in 'n' dimensions, the work required is related to 2 ^{n} (1D = line segment or 2 vertices, 2D = square or 4 verts, 3D = cube and 8, etc). The problems with value noise stem from the fact that at each evaluation point, the result only depends on blended data interior the cell that its within. This results in sample points close to one another, but in different cells, to not vary continuously. This results in very obvious defects along cell boundaries. Early attempts to fix this major problem included visiting further away cells and using more complex blending functions...which drastically increase complexity. The introduction of gradient noise made these solutions obsolete. However value noise is far from useless. Its very cheap computational cost can make it a good choice when many noise samples are required and is what you will most often find used in "demoscene" style shaders. ReferencesPerlin gradient noiseCreated in 1983 by Ken Perlin, this Oscar award winning technique is a clever way to minorly modify value noise to drastically improve the output quality. Usually when one is (correctly) calling a noise function "Perlin" noise, this is the technique being discussed. The clever addition is to choose a vector associated with each vertex (gradient vector). Then to calculate the vector from the vertex to the sample point. The dot product between these two vectors gives a weighting to modify the value at each vertex. It was quickly noted that this last step is not really useful and that the dot product itself is more than a sufficiently random value (dropping one multiply). Next the dot product results at the vertices are interpolated to generate a final result. Although the dot product drastically reduces defects along the cell boundaries, it introduces a new defect. Specifically the dot product will always approach zero as the sample point approaches one of the cell vertices. Notice that like value noise, the output entirely depends on the evaluation of a single cell and has the same complexity in the number of dimensions. The difference here is that the random vector helps to smooth out values across neighboring cells...much in the same way that Gouraud shading improves over flat shading. Sketch in 2D: 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36
 float eval(float x, float y) { int ix = (int)Math.floor(x); int iy = (int)Math.floor(y);
x = ix; y = iy;
int h00 = mix(ix, iy); int h10 = mix(ix+1, iy); int h01 = mix(ix, iy+1); int h11 = mix(ix+1, iy+1);
float r00 = dotRandVect(h00, x, y); float r10 = dotRandVect(h10, x1, y); float r01 = dotRandVect(h01, x, y1); float r11 = dotRandVect(h11, x1, y1);
x = weight(x); y = weight(y);
float xb = lerp(x, r00, r10); float xt = lerp(x, r01, r11);
return lerp(y, xb, xt); } 
Note that there have been numerous improvements made to gradient noise over the years, so some references may be referring to older versions. And, of course, authors may make minor tweaks (for better or worse) to their specific implementation. Variants of note:  Originally the vectors were randomly generated unit vectors. Creating these on the fly is rather expensive. In days of yore a precomputed table of random vectors was an option (less so today given memory access overhead). The reduced number of random vectors introduces some very minor directional defects.
Perlin later noted that using a small set of vectors (all the permutations of vector components of zero and +/one, but not all zero) drastically reduced computational cost. Specifically this drops 1 multiply per dimension per vertex (2*4 in 2D, 3*8 in 3D). This significantly increases directional defects (SEE: Defects below). Some GPU implementations use more mathematically complex selection to address this issue.  Two ease functions: Perlin uses a weight function which he terms either ease or scurve. The original function was: 3t^{2}2t^{3}. This function is continuous but its derivative is not. This was later replaced by the more expensive: 10t^{3}15t^{4} + 6t^{5} which is C2 continuous.
References Yeah...add tons of stuff here Perlin simplex noiseIn 2002 Ken Perlin introduced a new noise function that is a drastic change in direction. The purpose was to create a function which could be cheaply implemented in hardware and addresses some of the defects in gradient noise. Although designed for hardware it is a better fit for modern CPU and GPU architectures. The first major change is how cells are formed. Instead of regular breaking up of space, the input is skewed into a simplex (SEE: Stefan Gustavon's paper for details). This drops the number of vertices needed from 2 ^{n} to (n+1), where 'n' is the number of dimensions. The second major change is instead of calculating values and each vertex and blending the results to compute the final result, the result is instead a summation of contributions from each. This lowers the dependency chain and can increase throughput. For example in 2D, in value and gradient noise, one might first blend in "X": the top edge, then the bottom (these two are independent), then take those results and blend in "Y" to get a final result. In 2D simplex noise, the contribution from the three vertices are independently computed and summed to produce the result. As a rule of thumb, if you need noise (of this variety) in three or four dimensions, then simplex noise is the way to go. ReferencesDefectsNoise is one of those area's where science and art collide. As such the various listed defects only really have meaning if they have a negative impact on the desired result.  hash function:
 gradient vector selection:
 aligned cell structure:
The cheapest way to attempt to hide these defects is to insure that the grid structures of multiple noise evaluations are not aligned with one another. BLAH, BLAH Isotropic and anisotropicIsotropic is mathspeak for uniform in all directions and anisotropic is, well, not...the thing in question isn't uniform in all directions. The goal of all the above noise functions is to be isotropic. All, however, have directional defects which make this not quite true. Getting anisotropic results from isotropic noise simply involves applying a nonuniform scale factor when sampling. Periodic noiseThe sketches above are for noise functions without a period. It is commonly desirable to have noise be periodic, or in other words to wrap at specific boundaries. Well, there's good and there's bad news. The first bad news is that most "methods" to make noise periodic are very expensive and don't really work (SEE: Matt Zucker's FAQ above for an example). The first good news is that it's simple to perform cheaply, assuming that wrapping at integer boundaries and in particular poweroftwo boundaries is an acceptable limitation. Making a minor modification to the vertex computation allows this to happen..masking in the case of poweroftwo and "faking" an integer modulo in other cases. This requires modifying the base noise function (having special cases, dynamic code generations, etc.) Another option is to use a noise function in (potentially) a higher dimension higher than desired and to "walk" that space in such a way that you reach the same coordinate at boundary points. This later happens someway naturally if computation is performed at runtime on the GPU. As an example to apply noise to a sphere (or any other 3D object), one simply samples a 3D noise function at a scaled and/or translated coordinate of the object's surface (or 4D function if the noise is to be animated in time). OptimizationsNoise functions tend to be expensive as many calls are usually required to create a specific effect. As such speed is pretty important when computated at runtime. Given the nature of noise it is a very good candidate for running on the GPU...blah, blah Precomputation vs. runtimeBlah, Blah. Other noise functionsThere are many other noise functions, many of which are too complex to be evaluated at runtime, but may have game usage for pregenerated content. BLAH BLAH:  Anisotropic noise
 Gabor noise: not the same family, but can generate similar results.
 Sparse convolution noise: realtime variants potentially reasonable on the GPU
 Wavelet noise
References



29

Discussions / Java Gaming Wiki / Concurrency

on: 20120803 14:45:04

Here is a good tutorial on Java concurrency : ConcurrencyThe most common way of way of handling concurrent modifications is by using the synchronized key word, but that is not the only way to do it. There is also methods based on message passing like the actor model and there is atomic variable. The 5 levels of thread safety. It defines objects that are the best/easiest to use in a multithreaded environment to the worst/hardest. 1. Immutable : The object can't be modified once created. This is the most safe level. No matter how many threads access this object you won't run into any problems. 2. Threadsafe : The object contains enough internal synchronization (synchronized method) to be used without problems by multiple threads. 3. Conditionally threadsafe : Same as threadsafe except that under some circumstances, you will need to provide external synchronization (outside of that object) 4. ThreadCompatible : Can be used in multithreaded environment but it is up to the programmer to do the synchronization 5. Threadhostile : Can't be used in multithreaded envrionment (Ex.: Thread.stop()  That method was deprecated because it releases the lock when it is called. Hence it could leave an object into an invalid state) People usually think that the method Collections.synchronizedList(new ArrayList()) will return a threadsafe collection. But that is not true. It is conditionnaly threadsafe. That is true for almost all Java default ''synchronized'' collections. Here is a list of collections that are Threadsafe : Concurrent CollectionsVectors are conditionally threadsafe. That means that most of the time you don't need to provide external synchronization but in some cases you might. One case where you need external synchronization is when iterating over the Vector and modifying it. Collection.getSynchronizedCollection()  (or something like that) are also conditionnally threadsafe : meaning that you have to provide external synchronization for some operation. ArrayList is thread compatible : meaning that if you want to use it in a multithreaded environment you have to provide all the synchronization The Best Advice On Using Concurrency(ROQUEN: All of this is so wrong it should be axed) ... is to avoid using concurrency at all if you can help it. Threads are extremely difficult to debug, behaving and interacting in very complex ways that are often counterintuitive or seemingly completely indeterministic. They are also not nearly as effective as you'd like to hope in a typical SMP desktop system: two threads does not equal twice the computation, typically. You'll be lucky to achieve a fraction of an increase, for a great deal of extra complexity.  this is junk...brain dumpish Blocking vs. NonBlockingClassic concurrent methods are built using locks ( wikipedia) and mutual exclusions ( wikipedia). In these methods a single thread acquires a lock, performs some task and then releases the lock. Any other running thread which attempts to access the structure at the same time is "blocked" until the first releases the lock. ( wikipedia) ( wikipedia) Progress GuaranteesA given concurrent data structure will provide some type of progress guarantee which describes how it behaves under contention. Nonblocking data structures can be described as one of the following: Obstruction Free  a thread running exclusively will make a progress  Lock Free  at least one of the running threads will make a progress  Wait Free  every thread that gets the CPU will make a progress 
More complete descriptions can be found on the nonblocking wikipedia link above.



30

Discussions / Java Gaming Wiki / ArrayList vs LinkedList

on: 20120803 01:17:00

ArrayList and LinkedList are both very similar. They're used in the exact same way, but have very different performance characteristics. Even if you're using the right one for the job, you might still be using the list in a bad way leading to bad performance. A very important thing to consider when choosing which one to use is how they scale for large lists. How lists (and algorithms in general) scale with their size can be described using Big O notation. For example, ArrayList.get(int index) method always returns in O(1) time. The time it takes to find an object is always the same. It does not get slower as the list grows, since it's just simple array access in this case. LinkedList.get(int index) however is O(n). Finding the i'th object requires it to follow the linked list to the i'th. As the list gets longer, get(int index) ON AVERAGE gets slower. Finding the first object is obviously fast, O(1), but finding the last object is O(n) where n is the length of the list. On average, finding an object is O(n/2). However, the /2 is irrelevant in big O notation since it only describes how the list SCALES. LinkedList.get(int index) on average scales linearly with the list's length, so it's therefore O(n). ArrayList:  Adding objects is O(1).  Getting objects is O(1).  Removing objects is O(n). Double the size and the (average) access time doubles too. Note that remove(0) is the worse case scenario as a remove forces a copy of all following objects to fill the first spot that was left empty.  contains(object) is O(n) since the whole list has to be traversed to check if the object is in the list. LinkedList:  Adding objects is O(1)  Random access (getting using indices) is O(n). Getting objects in order using an iterator is O(1).  Removing objects is O(n) when using indices or references to remove objects. Removing objects with an iterator is O(1).  contains(object) is O(n) since the whole list has to be traversed to check if the object is in the list. Which should I use for my game objects? Looking at the above makes it's easy to conclude that LinkedList is the most flexible one. Adding objects is O(1), iterating over objects in order is O(1) and removing objects as we iterate over them is O(1). ArrayList is very similar, but is O(n) for removing. Game objects will die and be removed as the game progresses, so LinkedList scales the best. Even though LinkedList scales better, it does not necessarily have to be the fastest option for a certain use case. The problem with LinkedList is that it creates an Entry object which it wraps in each object added to store the next and previous entries. This allocation (and later garbage collection) makes it a lot slower to add and remove stuff than ArrayList in most use cases. Big O notation says nothing about the actual performance of these two. Adding objects is O(1) for both lists, but is still a lot slower for LinkedLists. Basically, for "small" lists ArrayList will always be faster, but for "large" lists LinkedList is faster. The exact point where you should start using LinkedList also depends on how you use the list, so it's impossible to give an exact number. ArrayList is most almost always the best choice for a game object list. Even when you have lots of stuff to remove, ArrayList can be a good choice. A good solution might be to use TWO ArrayLists and pingpong your objects between them. By doing that you can avoid all shifting while still getting fast (and random) access to all objects. 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31
 ArrayList<GameObject> currentList, nextList;
while(true){
update(); render();
}
private void update(){ for(int i = 0; i < currentList.size(); i++){ GameObject go = currentList.get(i); go.update(); if(go.isAlive()){ nextList.add(go); } } currentList.clear(); ArrayList<GameObject> temp = nextList; nextList = currentList; currentList = temp; } 





Add your game by posting it in the WIP section,
or publish it in Showcase.
The first screenshot will be displayed as a thumbnail.

javagaming.org is not responsible for the content posted by its members, including references to external websites,
and other references that may or may not have a relation with our primarily
gaming and game production oriented community.
inquiries and complaints can be sent via email to the info‑account of the
company managing the website of java‑gaming.org

