Anders Tornblad

All about the code

Label archive for javascript

Tajmkiper, part 1

There are lots of project time clock apps out there for those who want to keep track of how much time they spend in different projects. There's a genuine need for this type of app, but I have still not found one that is as simple and easy to use as it could be. Most of them either cost money, require that I install some piece of software on my smartphone, or demand my email address for some reason.

I would like a minimal functional web interface, designed mobile-first, that runs completely local to my browser of choice. I don't want my project data to be stored anywhere but locally in the browser. And I want to be able to export my projects and time spent to Excel. That shouldn't be so difficult to create, so I'll start hacking.

Mockup

After som pen-on-paper action, I came up with the following html/css mockup:
Tajmkiper Mockup

<html> <head> <link rel="stylesheet" href="tajmkiper.css"> </head> <body> <ul id="projects"> <li class="running"> <a href="#"> <header>Creating Tajmkiper</header> <span class="time">1:37:11</span> </a> </li> <li> <a href="#"> <header>Killing some time</header> <span class="time">2:12:54</span> </a> </li> <li id="total"> <a href="#"> <header>Total:</header> <span class="time">3:50:05</span> </a> </li> </ul> <nav> <ul> <li id="addProject"><a href="#addProject"><header>Add new project</header></a></li> <li id="stopTimer" class="hideSpan"><a href="#stopTimer"><span>Stop timer</span></a></li> <li id="settings" class="hideSpan"><a href="#settings"><span>Tools</span></a></li> </ul> </nav> </body> </html> ul, li { margin: 0; padding: 0; list-style: none none inside; text-indent: 0; } a { color: inherit; text-decoration: none; } a:hover { text-decoration: underline; } #projects { position: fixed; top: 2px; left: 2px; right: 2px; bottom: 36px; overflow-x: hidden; overflow-y: auto; } #projects li { position: relative; background: #259; color: #fff; height: 32px; margin-top: 2px; overflow: hidden; } #projects a.activate { position: absolute; display: block; left: 0; top: 0; right: 0; bottom: 0; } #projects header { position: absolute; display: block; left: 8px; top: 0; right: 80px; bottom: 0; overflow: hidden; font-weight: normal; line-height: 32px; text-decoration: inherit; } #projects .time { position: absolute; display: block; right: 0px; width: 70px; padding-right: 8px; top: 0; bottom: 0; border-left: solid 1px #fff; overflow: hidden; line-height: 32px; font-size: 80%; text-decoration: none; text-align: right; background-color: #259; transition: background-color 0.25s ease-in-out; } #projects .running .time { background-color: #5f3; color: #281; font-weight: bold; } #projects #total { background: #ddd; } #projects #total header { text-align: right; } #projects #total .time { color: #000; font-weight: bold; } #projects li:first-child { margin-top: 0; } li { border-radius: 3px; } nav { position: fixed; bottom: 2px; left: 2px; right: 2px; height: 32px; } nav > ul { position: absolute; left: 0; top: 0; right: 0; bottom: 0; } nav li#addProject { position: absolute; left: 0; top: 0; bottom: 0; right: 68px; background: #4a2; color: #fff; } nav li#stopTimer { position: absolute; top: 0; bottom: 0; right: 34px; width: 32px; background: #a31 url('stop.png') no-repeat scroll 50% 50%; color: #fff; } nav li#settings { position: absolute; top: 0; bottom: 0; right: 0; width: 32px; background: #259 url('settings.png') no-repeat scroll 50% 50%; color: #fff; } nav a { display: block; position: absolute; left: 0; right: 0; top: 0; bottom: 0; padding: 0 8px 0 8px; line-height: 32px; } .hideText span { display: none; }

My thought is to simply click on a project to start that project's time clock (and stop any other running time clock), click on Add new project to pop up a dialog where I enter my project's name, and then the new project's time clock starts. When I go to lunch, I click the stop button. If I want to remove all projects, set all time clocks to zero, or export everything as a CSV file (using the CSV framework I've made), I click the "settings" button in the lower right corner.

I think this looks good for now. Next time, I'll start writing some JavaScript

EDIT: Tajmkiper is now publicly available to anyone who wants to use it.
Try it: tajmkiper.com

Tajmkiper, part 1 (this part)
Tajmkiper, part 2
Tajmkiper, part 3

Artsy part 3, SoundBox

Wow, it's been a really long time since I wrote anything about my demo projects here. I apologize for that, but the good news is that I have finally found some extra time to spend on "pleasure programming" again.

First, there's the unfinished business of Artsy (and slightly insane). About five months ago, I was finished with the first two parts, and I haven't had time to start on part three until now. So far, it looks pretty good. Unfortunately it doesn't yet work on iOS devices, but feel free to check it out:

Artsy part 3

SoundBox

Someone in the CODEF Facebook group linked to the SoundBox tool, and I find it quite amazing. It's a JavaScript-based chip tune tracker, with a really nice and small playback routine. I have been experimenting a bit with it, and here are some results:

Lots of unfinished business in this update, and I'm sorry about that.

Artsy (and slightly insane), first two parts now in beta

A couple of minutes ago, I uploaded a new version of Artsy (and slightly insane). It includes JavaScript remakes of the first two parts of the iconic Amiga Demo Arte by Sanity.

The code is pure JavaScript and Canvas. There is no Flash, no Silverlight, no WebGL stuff, and there are no frameworks involved. When I'm done remaking the third and final part of Arte, my plans are to release the full source code for the demo. Also, I'll take the "plumbing" parts of the code and release as a JavaScript demo framework in itself, and I'll open-source it.

But for now, enjoy the first two parts of "Artsy (and slightly insane)". The adress is demo.atornblad.se/artsy.

Phenomenal & Enigmatic, part 4

TV Cube remakeI remember seeing the "TV Cube" part of Enigma for the first time – and not really being able to figure out how it was made. Heck, I couldn't even do the math for a proper backface culling, so back in the 1990s my occational 3D objects were never any good. So the thought of making 2D and 3D objects appear on the surfaces of another 3D object was way beyond my understanding of math.

Once again, I am aware that the prettier way of doing this is by manipulating a transformation matrix to rotate, translate and project coordinates from different branches of a hierarchical coordinate system. But I ignored that and rolled it all by hand.

Star field

The stars on the front of the cube might look as if there is some depth, but that's just an illusion. Each star has an (X,Y) coordinate, and a third constant (which I called Z) that governs speed along the X axis and also the alpha component of its color. The lower the speed, the dimmer the light. When observed face on, it gives the impression of a 3D space, but it's really just a form of parallax scroller.

Pseudo code

for (var star, i = 0; star = stars[i++];) { // Move the star a bit to the "right" star.x += (star.z * star.z * speedConstant);     // Limit x to (-1 .. 1) if (star.x > 1) star.x -= 2;     // Left out: Project the star's coordinates to screen coordinates var screenCoords = ( /* left out */ );     // Draw the star, using Z to determine alpha and size context.fillStyle = "rgba(255,255,255," + (star.z * star.z).toFixed(3) + ")"; context.fillRect(screenCoords.x, screenCoords.2, star.z * 2, star.z * 2); }

Hidden line vector

Back in the days, I could never do a proper hidden line vector, because I didn't know how to properly cull back-facing polygons. For the Phenomenal & Enigmatic "TV Cube" part, I arranged all polygons in the hidden line pyramid so that when facing the camera, each polygon is to be drawn clockwise. That way I could use a very simple algorithm to determine each polygon's winding order.

I found one really efficient algorithm on StackOverflow, and I learned that since all five polygons are convex (triangles cannot be concave, and the only quadrangle is a true square), it's really enough to only check the first three coordinates, even for the quadrangle.

Rotating the pyramid in 3D space was exactly the same as with the intro part of the demo, and after all coordinates are rotated, I simple use the polygon winding order algorithm to perform backface culling, then drawing all polygons' outlines. Voilá, a hidden line vector.

Pseudo code

// Points var points = [ { x : -40, y : -40, z : 70 }, // Four corners at the bottom { x : 40, y : -40, z : 70 }, { x : 40, y : 40, z : 70 }, { x : -40, y : 40, z : 70 }, { x : 0, y : 0, z : -70 } // And finally the top ];   // Each polygon is just an array of point indices var polygons = [ [0, 4, 3], // Four triangle sides [1, 4, 0], [2, 4, 1], [3, 4, 2], [3, 2, 1, 0] // And a quadrangle bottom ];   // First rotate the points in space and project to screen coordinates var screenCoords = [];   for (var point, i = 0; point = points[i++];) { screenCoords.push(rotateAndProject(point)); // rotateAndProject is left out }   // Then go through each polygon and draw those facing forward for (var polygon, i = 0; polygon = polygons[i++];) { var edgeSum = 0; for (var j = 0; j < 3; ++j) { var pointIndex = polygon[j]; var pointIndex2 = polygon[(j + 1) % 3];   var point = screenCoords[pointIndex]; var point2 = screenCoords[pointIndex2];   edgeSum += (point2.x - point.x) * (point2.y + point.y); }   if (edgeSum < 0) { // This polygon is facing the camera // Left out: Draw the polygon using screenCoords, context.moveTo and context.lineTo } }

Plane vector

The plane vector is super-simple. Just rotating a plane around its center and then using the code already in place to project it to screen coordinates.

Projection

The function responsible for translating coordinates in the 3D space to screen coordinates is not particularly complex, since it's basically the exact same thing as for the intro part of the demo. Also, to determine which faces of the cube that are facing the camera, I just used the same backface culling algorithm as for the hidden line vector. I was really pleased with the end result.

Phenomenal & Enigmatic, part 1
Phenomenal & Enigmatic, part 2
Phenomenal & Enigmatic, part 3
Phenomenal & Enigmatic, part 4 (this part)

The entire demo, including non-minified JavaScript, is available on GitHub: /lbrtw/enigmatic

Artsy (and slightly insane), first part now in beta

In between writing about the Phenomenal & Enigmatic JavaScript demo, I'm also doing a JavaScript remake of the Arte demo by Sanity from 1993. The first effect I made was the "disc tunnel" effect, seen 2min 9sec into the YouTube clip, and the entire first part is now live, but still in beta.

The address is demo.atornblad.se/artsy, but I haven't tested it that many browsers and devices yet. I do know that it crashes on Windows Phone 7.8 after just a few scenes, but it works really nicely on my iPad 3, especially in fullscreen mode. Add a shortcut to your iPad's start screen for fullscreen mode.

I will make some changes to the bitmap tunnel effect, and make sure that the demo runs correctly on most browsers and devices. Also, stay tuned for parts 2 and 3 of Sanity Arte, and of course there will be a blow-by-blow description here on atornblad.se when the whole thing is complete.

Phenomenal & Enigmatic, part 3

When I made Phenomenal & Enigmatic, I didn't want to reuse any of the graphics art from the original demo. I had decided to take the music and some sense of the overall demo design, but didn't want to infringe on the original graphics artist's creativity, so for the Enigmatic logo, I turned to rendering the logo using code.

Enigmatic logoOne popular technique of creating good-looking logos back in the Amiga days was to first draw the logo flat, then duplicating it in a new layer a few pixels off, making that new layer translucent. Then one would paint in side surfaces and edge lines with varying levels of opacity. After adding some final touches, like surface textures or lens flares, the end result would be a glossy, glassy look, much like the original Enigma logo by Uno of Scoopex.

Enigmatic logoThe logo scene uses the same technique, painting the front, back and sides of the word ENIGMATIC as filled polygons with slightly different colors and opacity levels. During the scene, I animate some of the transformation vectors for effect. Of course, the original artwork by Uno is much better in exactly every way, but it was a fun exercise.

Pseudocode

function transformLogoCoord(chapterId, time, x, y) {     // Left out: Perform a simple coordinate transformation     return { x : transformedX, y : transformedY }; }   function logoMoveTo(chapterId, time, x, y, xOffset, yOffset) {     var coords = transformLogoCoords(chapterId, time, x, y);     context.moveTo(coords.x, coords.y); }   function logoLineTo(chapterId, time, x, y, xOffset, yOffset) {     var coords = transformLogoCoords(chapterId, time, x, y);     context.lineTo(coords.x, coords.y); }   function renderLogo(chapterId, time) { var xOffset, yOffset;     // Left out: Calculate xOffset and yOffset from the chapterId and time values         // Draw bottom surfaces     context.beginPath();     for (var block, i = 0; block = logoPolygons[i++];) {         logoMoveTo(chapterId, time, block[0].x, block[0].y, 0, 0);         for (var coord, j = 1; j = block[j++];) {             logoLineTo(chapterId, time, coord.x, coord.y, 0, 0); }         logoLineTo(chapterId, time, block[0].x, block[0].y, 0, 0);     }     context.closePath();     context.fill();         // Left out: draw side surfaces         // Left out: draw top surfaces }

Phenomenal & Enigmatic, part 1
Phenomenal & Enigmatic, part 2
Phenomenal & Enigmatic, part 3 (this part)
Phenomenal & Enigmatic, part 4

The entire demo, including non-minified JavaScript, is available on GitHub: /lbrtw/enigmatic

Phenomenal & Enigmatic, part 2

Stars and text intro

Stars and text Enigma screendumpThe opening scene of Enigma by Phenomena starts out looking like an average side-scrolling star parallax, which was very normal in 1991. Nice way to lower people's expectations. :) But after just a couple of seconds, the stars begin twisting and turning in space around all three axes.

Back in 1991 I knew how to rotate a plane around the origo, by simply applying the angle sum identities of Sine and Cosine. I also realized that rotating any 3D coordinate in space could by done by simply the case of rotating around more than one axis, one axis a time.

Stars and text screendumpIn the Phenomenal & Enigmatic demo, I only rotate the stars around two axes. First I rotate the (x,z) components around the Y axis to get (x',z'), and then the (y,z') components around the X axis to get (y',z''). I also translate each star along the X axis before the rotation takes place. To finally get the 2D screen coordinates of the 3D space coordinate, I take the (x',y') coordinate and multiply by (2/(2+z'')) for a pseudo-distance feel. The z'' value controls both the color alpha component, and the size of the rectangle being drawn.

The even better way of doing this is through vector addition and multiplication, but I'm sticking to the math that I know. :) After all this math is in place, the trick is to change the offset and rotation variables in a nice way.

Rendering text is just a couple of calls to the context.fillText method and animating the value of context.globalAlpha.

Pseudo code

// Prefetch sin and cosine of angles var cosY = Math.cos(yAngle); var sinY = Math.sin(yAngle); var cosX = Math.cos(xAngle); var sinX = Math.sin(xAngle);   for (var star, i = 0; star = stars[i++]; ) {     // Fetch x, y, z and translate x     var x = star.x + xOffset;     var y = star.y;     var z = star.z;         // Limit x to [-1 .. 1]     while (x > 1) x -= 2;     while (x < -1) x += 2;         // Rotate (x, z) around Y axis     var x2 = x * cosY + z * sinY; // x'     var z2 = z * cosY - x * sinY; // z'         // Rotate (y, z') around X axis     var y2 = y * cosX + z2 * sinX; // y'     var z3 = z2 * cosX - y * sinX; // z''         // Transform to screen coordinates     var screenX = x2 * 2 / (2 + z3) * halfScreenWidth + halfScreenWidth;     var screenY = y2 * 2 / (2 + z3) * halfScreenWidth + halfScreenHeight;         // Draw the star     context.fillRect(screenX, screenY, 2 - z3, 2 - z3); }

Phenomenal & Enigmatic, part 1
Phenomenal & Enigmatic, part 2 (this part)
Phenomenal & Enigmatic, part 3
Phenomenal & Enigmatic, part 4

The entire demo, including non-minified JavaScript, is available on GitHub: /lbrtw/enigmatic

Phenomenal & Enigmatic, part 1

Twenty-two years ago, the Amiga demo scene was extremely active. The boundaries of the little 16-bit miracle machine were stretched a little bit more for each new release, and a special breed of programmers was created. We loved efficient algorithms, we enjoyed squeezing out as much as possible from every CPU clock cycle, and we really liked showing off to each other.

Back then, I was a decent 68000 assembler programmer, but nowhere near being among the greatest. I knew my way around the Copper and the Blitter, I knew how trigonometry and vector mathematics worked for creating 3D worlds, and I understood that the "shadebobs" effect on the Amiga was nothing more than repeated half-adders with carry, using the "Fat Agnus" chip's dedicated memory block manipulation instruction set.

My favorite demo from 1991 was Enigma by Phenomena, programmed by Olof "Azatoth" Lindroth, with music by the amazing Jimmy "Firefox" Fredriksson and Robert "Tip" Österbergh. The combination of music and direction with some really good programming set a new standard for demos on the Amiga.

First attempt

About four years ago, I started replicating the Enigma demo in C# and Silverlight 2, just as a side-project. I got as far as the opening scene and the "TV Cube" effect, which I must say I really nailed! But then I grew tired of the effort, and put the whole project aside. It just wasn't rewarding enough, but I did re-awaken some of my old "hacking the bare metal" programming skills.

Come 2013

For the last couple of weeks, I've been working from scratch, exploring what is possible using just a HTML5 AUDIO element, a CANVAS element, and a truck-load of JavaScript. Instead of trying to recreate the exact Enigma experience, I "borrowed" the amazing music, and did something of my own, inspired by Enigma.

I'll write a bit about each scene in the following weeks, but for now you're welcome to check out the fruit of my effort at demo.atornblad.se/enigmatic

Links

Phenomenal & Enigmatic, part 1 (this part)
Phenomenal & Enigmatic, part 2
Phenomenal & Enigmatic, part 3
Phenomenal & Enigmatic, part 4

JavaScript Csv file generator, part 3

The Csv file generator is almost done. All we need to do is to enclose and escape certain special characters. Values containing the separator need to be enclosed in double quotes. Values containing double quotes need to be escaped and, just to be sure, enclosed in double quotes.

Two more requirements and two more unit tests coming up...

Requirements

  1. Values containing the current separator must be enclosed in double quotes.
  2. Values containing double quotes must be escaped (by doubling the double quote characters), and also enclosed in double quotes.
engine.add("Csv.getFileContents should quote fields containing the separator", function(testContext, the) { // Arrange var properties = ["name", "age"]; var csv = new Csv(properties); csv.add({"name" : "Doe, John", "age" : "Unknown"}); csv.add({"name" : "Bunny", "age" : "2"}); // Act var file = csv.getFileContents(); // Assert the(file).shouldBeSameAs("\"Doe, John\",Unknown\r\nBunny,2"); }); engine.add("Csv.getFileContents should quote and escape fields containing double quotes", function(testContext, the) { // Arrange var properties = ["model", "size"]; var csv = new Csv(properties); csv.add({"model" : "Punysonic", "size" : "28\""}); csv.add({"model" : "Philip", "size" : "42\""}); // Act var file = csv.getFileContents(); // Assert the(file).shouldBeSameAs('Punysonic,"28"""\r\nPhilip,"42"""'); }); // Helper function to create one line of text function createTextLine(values, separator) { var result = []; var doubleQuotes = new RegExp("\"", "g"); values.forEach(function(value) { var text = value.toString(); if (text.indexOf(separator) == -1 && text.indexOf("\"") == -1) { result.push(text); } else { result.push("\"" + text.replace(doubleQuotes, "\"\"") + "\""); } }); return result.join(separator); } // New getFileContents implementation Csv.prototype.getFileContents = function(separator, includePropertyNames) { separator = separator || ","; var textLines = []; if (includePropertyNames) { textLines.push(createTextLine(this.propertyOrder, separator)); } this.items.forEach((function(item) { var values = []; this.propertyOrder.forEach(function(propertyName) { values.push(item[propertyName]); }); textLines.push(createTextLine(values, separator)); }).bind(this)); return textLines.join("\r\n"); };

And we're done! EDIT: The finished code can be found on github at /lbrtw/csv.

JavaScript Csv file generator, part 1
JavaScript Csv file generator, part 2
JavaScript Csv file generator, part 3 (this part)