doc: go generate; Add style.css

_docs/index.tmpl.html

@@ -4,23 +4,7 @@
 <link rel="shortcut icon" href="./favicon.png" type="image/png">
 <link rel="icon" href="./favicon.png" type="image/png">
 <title>Ebiten - A simple SNES-like 2D game library in Go</title>
-<style>
-body {
-  font-family: sans-serif;
-}
-img.example {
-  background-color: #000;
-  border-color: #999;
-  border-style: solid;
-  border-width: 1px;
-  image-rendering: crisp-edges;
-  image-rendering: pixelated;
-}
-pre {
-  background: #eee;
-  padding: 1em;
-}
-</style>
+<link rel="stylesheet" href="./style.css">
 <a href="https://github.com/hajimehoshi/ebiten"><img style="position: absolute; top: 0; right: 0; border: 0;" src="https://camo.githubusercontent.com/365986a132ccd6a44c23a9169022c0b5c890c387/68747470733a2f2f73332e616d617a6f6e6177732e636f6d2f6769746875622f726962626f6e732f666f726b6d655f72696768745f7265645f6161303030302e706e67" alt="Fork me on GitHub" data-canonical-src="https://s3.amazonaws.com/github/ribbons/forkme_right_red_aa0000.png"></a>
 <h1>Ebiten (海老天)</h1>
 <p>Stable version: v{{.StableVersion}} / Development version: v{{.DevVersion}}</p>

_docs/public/examples/_resources/images/license.md

@@ -23,6 +23,14 @@ Photograph by Chris Nokleberg
 the Creative Commons Attribution 3.0 License
 ```
 
+## tile.png
+
+```
+http://opengameart.org/node/8016
+
+CC0 1.0
+```
+
 ## Other image files
 
 ```

_docs/public/examples/alphablending.html

@@ -36,7 +36,9 @@ pre {
 
 <h1>Ebiten example - alphablending</h1>
 <iframe src="alphablending.content.html" width="640" height="480"></iframe>
-<pre><code>package main
+<pre><code>// &#43;build example
+
+package main
 
 import (
     &#34;image/color&#34;
@@ -88,7 +90,9 @@ func update(screen *ebiten.Image) error {
         diff = float64(480-count) * 0.2
     }
 
-    screen.Fill(color.NRGBA{0x00, 0x00, 0x80, 0xff})
+    if err := screen.Fill(color.NRGBA{0x00, 0x00, 0x80, 0xff}); err != nil {
+        return err
+    }
     op := &amp;ebiten.DrawImageOptions{}
     op.ColorM.Scale(1.0, 1.0, 1.0, 0.5)
     op.ImageParts = &amp;imageParts{

_docs/public/examples/audio.html

@@ -36,7 +36,9 @@ pre {
 
 <h1>Ebiten example - audio</h1>
 <iframe src="audio.content.html" width="640" height="480"></iframe>
-<pre><code>package main
+<pre><code>// &#43;build example
+
+package main
 
 import (
     &#34;fmt&#34;
@@ -68,13 +70,17 @@ func init() {
     if err != nil {
         log.Fatal(err)
     }
-    playerBarImage.Fill(&amp;color.RGBA{0x80, 0x80, 0x80, 0xff})
+    if err := playerBarImage.Fill(&amp;color.RGBA{0x80, 0x80, 0x80, 0xff}); err != nil {
+        log.Fatal(err)
+    }
 
     playerCurrentImage, err = ebiten.NewImage(4, 10, ebiten.FilterNearest)
     if err != nil {
         log.Fatal(err)
     }
-    playerCurrentImage.Fill(&amp;color.RGBA{0xff, 0xff, 0xff, 0xff})
+    if err := playerCurrentImage.Fill(&amp;color.RGBA{0xff, 0xff, 0xff, 0xff}); err != nil {
+        log.Fatal(err)
+    }
 }
 
 type Player struct {
@@ -217,7 +223,9 @@ func update(screen *ebiten.Image) error {
     op := &amp;ebiten.DrawImageOptions{}
     x, y, w, h := playerBarRect()
     op.GeoM.Translate(float64(x), float64(y))
-    screen.DrawImage(playerBarImage, op)
+    if err := screen.DrawImage(playerBarImage, op); err != nil {
+        return err
+    }
     currentTimeStr := &#34;00:00&#34;
     if musicPlayer != nil {
         c := musicPlayer.audioPlayer.Current()
@@ -233,7 +241,9 @@ func update(screen *ebiten.Image) error {
         cy := y - (ch-h)/2
         op := &amp;ebiten.DrawImageOptions{}
         op.GeoM.Translate(float64(cx), float64(cy))
-        screen.DrawImage(playerCurrentImage, op)
+        if err := screen.DrawImage(playerCurrentImage, op); err != nil {
+            return err
+        }
     }
 
     msg := fmt.Sprintf(`FPS: %0.2f
@@ -244,7 +254,9 @@ Press Z or X to change volume of the music
     if musicPlayer == nil {
         msg &#43;= &#34;\nNow Loading...&#34;
     }
-    ebitenutil.DebugPrint(screen, msg)
+    if err := ebitenutil.DebugPrint(screen, msg); err != nil {
+        return err
+    }
     if err := audioContext.Update(); err != nil {
         return err
     }
@@ -297,7 +309,10 @@ func main() {
         }
         close(musicCh)
         // TODO: Is this goroutine-safe?
-        p.Play()
+        if err := p.Play(); err != nil {
+            log.Fatal(err)
+            return
+        }
     }()
     if err := ebiten.Run(update, screenWidth, screenHeight, 2, &#34;Audio (Ebiten Demo)&#34;); err != nil {
         log.Fatal(err)

_docs/public/examples/font.html

@@ -36,7 +36,9 @@ pre {
 
 <h1>Ebiten example - font</h1>
 <iframe src="font.content.html" width="640" height="480"></iframe>
-<pre><code>package main
+<pre><code>// &#43;build example
+
+package main
 
 import (
     &#34;image&#34;
@@ -76,7 +78,9 @@ func parseFont() error {
     if err != nil {
         return err
     }
-    defer f.Close()
+    defer func() {
+        _ = f.Close()
+    }()
     b, err := ioutil.ReadAll(f)
     if err != nil {
         return err
@@ -98,12 +102,11 @@ func parseFont() error {
             Hinting: font.HintingFull,
         }),
     }
-    dy := size * dpi / 72
-    y := dy
+    y := size
     for _, s := range text {
         d.Dot = fixed.P(0, y)
         d.DrawString(s)
-        y &#43;= dy
+        y &#43;= size
     }
     return textImage.ReplacePixels(dst.Pix)
 }

_docs/public/examples/gamepad.html

@@ -36,7 +36,9 @@ pre {
 
 <h1>Ebiten example - gamepad</h1>
 <iframe src="gamepad.content.html" width="640" height="480"></iframe>
-<pre><code>package main
+<pre><code>// &#43;build example
+
+package main
 
 import (
     &#34;fmt&#34;
@@ -78,7 +80,9 @@ func update(screen *ebiten.Image) error {
   Pressed Buttons: {{.Buttons}}`
     str = strings.Replace(str, &#34;{{.Axes}}&#34;, strings.Join(axes, &#34;\n    &#34;), -1)
     str = strings.Replace(str, &#34;{{.Buttons}}&#34;, strings.Join(pressedButtons, &#34;, &#34;), -1)
-    ebitenutil.DebugPrint(screen, str)
+    if err := ebitenutil.DebugPrint(screen, str); err != nil {
+        return err
+    }
     return nil
 }
 

_docs/public/examples/hsv.html

@@ -36,7 +36,9 @@ pre {
 
 <h1>Ebiten example - hsv</h1>
 <iframe src="hsv.content.html" width="640" height="480"></iframe>
-<pre><code>package main
+<pre><code>// &#43;build example
+
+package main
 
 import (
     &#34;fmt&#34;

_docs/public/examples/hue.html

@@ -36,7 +36,9 @@ pre {
 
 <h1>Ebiten example - hue</h1>
 <iframe src="hue.content.html" width="640" height="480"></iframe>
-<pre><code>package main
+<pre><code>// &#43;build example
+
+package main
 
 import (
     _ &#34;image/jpeg&#34;

_docs/public/examples/keyboard.html

@@ -36,7 +36,9 @@ pre {
 
 <h1>Ebiten example - keyboard</h1>
 <iframe src="keyboard.content.html" width="640" height="480"></iframe>
-<pre><code>package main
+<pre><code>// &#43;build example
+
+package main
 
 import (
     &#34;log&#34;
@@ -108,7 +110,9 @@ func update(screen *ebiten.Image) error {
     op := &amp;ebiten.DrawImageOptions{}
     op.GeoM.Translate(offsetX, offsetY)
     op.ColorM.Scale(0.5, 0.5, 0.5, 1)
-    screen.DrawImage(keyboardImage, op)
+    if err := screen.DrawImage(keyboardImage, op); err != nil {
+        return err
+    }
 
     pressed := []string{}
     for i := 0; i &lt;= 9; i&#43;&#43; {
@@ -136,7 +140,9 @@ func update(screen *ebiten.Image) error {
         ImageParts: pressedKeysParts(pressed),
     }
     op.GeoM.Translate(offsetX, offsetY)
-    screen.DrawImage(keyboardImage, op)
+    if err := screen.DrawImage(keyboardImage, op); err != nil {
+        return err
+    }
 
     return nil
 }

_docs/public/examples/masking.html

@@ -36,7 +36,9 @@ pre {
 
 <h1>Ebiten example - masking</h1>
 <iframe src="masking.content.html" width="640" height="480"></iframe>
-<pre><code>package main
+<pre><code>// &#43;build example
+
+package main
 
 import (
     &#34;image&#34;

_docs/public/examples/mosaic.html

@@ -36,7 +36,9 @@ pre {
 
 <h1>Ebiten example - mosaic</h1>
 <iframe src="mosaic.content.html" width="640" height="480"></iframe>
-<pre><code>package main
+<pre><code>// &#43;build example
+
+package main
 
 import (
     _ &#34;image/jpeg&#34;
@@ -61,10 +63,14 @@ var (
 func update(screen *ebiten.Image) error {
     op := &amp;ebiten.DrawImageOptions{}
     op.GeoM.Scale(1.0/mosaicRatio, 1.0/mosaicRatio)
-    gophersRenderTarget.DrawImage(gophersImage, op)
+    if err := gophersRenderTarget.DrawImage(gophersImage, op); err != nil {
+        return err
+    }
     op = &amp;ebiten.DrawImageOptions{}
     op.GeoM.Scale(mosaicRatio, mosaicRatio)
-    screen.DrawImage(gophersRenderTarget, op)
+    if err := screen.DrawImage(gophersRenderTarget, op); err != nil {
+        return err
+    }
     return nil
 }
 

_docs/public/examples/noise.html

@@ -36,7 +36,9 @@ pre {
 
 <h1>Ebiten example - noise</h1>
 <iframe src="noise.content.html" width="640" height="480"></iframe>
-<pre><code>package main
+<pre><code>// &#43;build example
+
+package main
 
 import (
     &#34;fmt&#34;
@@ -80,8 +82,12 @@ func update(screen *ebiten.Image) error {
         noiseImage.Pix[4*i&#43;2] = uint8(x &gt;&gt; 8)
         noiseImage.Pix[4*i&#43;3] = 0xff
     }
-    screen.ReplacePixels(noiseImage.Pix)
-    ebitenutil.DebugPrint(screen, fmt.Sprintf(&#34;FPS: %f&#34;, ebiten.CurrentFPS()))
+    if err := screen.ReplacePixels(noiseImage.Pix); err != nil {
+        return err
+    }
+    if err := ebitenutil.DebugPrint(screen, fmt.Sprintf(&#34;FPS: %f&#34;, ebiten.CurrentFPS())); err != nil {
+        return err
+    }
     return nil
 }
 

_docs/public/examples/paint.html

@@ -36,7 +36,9 @@ pre {
 
 <h1>Ebiten example - paint</h1>
 <iframe src="paint.content.html" width="640" height="480"></iframe>
-<pre><code>package main
+<pre><code>// &#43;build example
+
+package main
 
 import (
     &#34;fmt&#34;
@@ -129,7 +131,9 @@ func main() {
     if err != nil {
         log.Fatal(err)
     }
-    canvasImage.Fill(color.White)
+    if err := canvasImage.Fill(color.White); err != nil {
+        log.Fatal(err)
+    }
 
     if err := ebiten.Run(update, screenWidth, screenHeight, 2, &#34;Paint (Ebiten Demo)&#34;); err != nil {
         log.Fatal(err)

_docs/public/examples/perspective.html

@@ -36,7 +36,9 @@ pre {
 
 <h1>Ebiten example - perspective</h1>
 <iframe src="perspective.content.html" width="640" height="480"></iframe>
-<pre><code>package main
+<pre><code>// &#43;build example
+
+package main
 
 import (
     _ &#34;image/jpeg&#34;
@@ -84,7 +86,9 @@ func update(screen *ebiten.Image) error {
     maxWidth := float64(w) &#43; float64(h)*0.75
     op.GeoM.Translate(-maxWidth/2, -float64(h)/2)
     op.GeoM.Translate(screenWidth/2, screenHeight/2)
-    screen.DrawImage(gophersImage, op)
+    if err := screen.DrawImage(gophersImage, op); err != nil {
+        return err
+    }
     return nil
 }
 

_docs/public/examples/piano.html

@@ -36,7 +36,9 @@ pre {
 
 <h1>Ebiten example - piano</h1>
 <iframe src="piano.content.html" width="640" height="480"></iframe>
-<pre><code>package main
+<pre><code>// &#43;build example
+
+package main
 
 import (
     &#34;fmt&#34;
@@ -113,7 +115,9 @@ func addNote(freq float64, vol float64) error {
         if err != nil {
             return err
         }
-        p.Play()
+        if err := p.Play(); err != nil {
+            return err
+        }
         return nil
     }
     length := len(pcm) * baseFreq / f
@@ -134,7 +138,9 @@ func addNote(freq float64, vol float64) error {
     if err != nil {
         return err
     }
-    p.Play()
+    if err := p.Play(); err != nil {
+        return err
+    }
     return nil
 }
 
@@ -185,7 +191,9 @@ func init() {
     if err != nil {
         panic(err)
     }
-    imageEmpty.Fill(color.White)
+    if err := imageEmpty.Fill(color.White); err != nil {
+        panic(err)
+    }
     imagePiano, err = ebiten.NewImage(screenWidth, screenHeight, ebiten.FilterNearest)
     if err != nil {
         panic(err)
@@ -201,8 +209,12 @@ func init() {
         op.GeoM.Scale(float64(width-1)/float64(w), float64(height)/float64(h))
         op.GeoM.Translate(float64(x), float64(y))
         op.ColorM.Scale(1, 1, 1, 1)
-        imagePiano.DrawImage(imageEmpty, op)
-        common.ArcadeFont.DrawText(imagePiano, k, x&#43;8, y&#43;height-16, 1, color.Black)
+        if err := imagePiano.DrawImage(imageEmpty, op); err != nil {
+            panic(err)
+        }
+        if err := common.ArcadeFont.DrawText(imagePiano, k, x&#43;8, y&#43;height-16, 1, color.Black); err != nil {
+            panic(err)
+        }
     }
 
     blackKeys := []string{&#34;Q&#34;, &#34;W&#34;, &#34;&#34;, &#34;R&#34;, &#34;T&#34;, &#34;&#34;, &#34;U&#34;, &#34;I&#34;, &#34;O&#34;}
@@ -217,8 +229,12 @@ func init() {
         op.GeoM.Scale(float64(width-1)/float64(w), float64(height)/float64(h))
         op.GeoM.Translate(float64(x), float64(y))
         op.ColorM.Scale(0, 0, 0, 1)
-        imagePiano.DrawImage(imageEmpty, op)
-        common.ArcadeFont.DrawText(imagePiano, k, x&#43;8, y&#43;height-16, 1, color.White)
+        if err := imagePiano.DrawImage(imageEmpty, op); err != nil {
+            panic(err)
+        }
+        if err := common.ArcadeFont.DrawText(imagePiano, k, x&#43;8, y&#43;height-16, 1, color.White); err != nil {
+            panic(err)
+        }
     }
 }
 
@@ -233,10 +249,16 @@ func update(screen *ebiten.Image) error {
         }
     }
 
-    screen.Fill(color.RGBA{0x80, 0x80, 0xc0, 0xff})
-    screen.DrawImage(imagePiano, nil)
+    if err := screen.Fill(color.RGBA{0x80, 0x80, 0xc0, 0xff}); err != nil {
+        return err
+    }
+    if err := screen.DrawImage(imagePiano, nil); err != nil {
+        return err
+    }
 
-    ebitenutil.DebugPrint(screen, fmt.Sprintf(&#34;FPS: %0.2f&#34;, ebiten.CurrentFPS()))
+    if err := ebitenutil.DebugPrint(screen, fmt.Sprintf(&#34;FPS: %0.2f&#34;, ebiten.CurrentFPS())); err != nil {
+        return err
+    }
 
     if err := audioContext.Update(); err != nil {
         return err

_docs/public/examples/rotate.html

@@ -36,7 +36,9 @@ pre {
 
 <h1>Ebiten example - rotate</h1>
 <iframe src="rotate.content.html" width="640" height="480"></iframe>
-<pre><code>package main
+<pre><code>// &#43;build example
+
+package main
 
 import (
     _ &#34;image/jpeg&#34;

_docs/public/examples/sprites.html

@@ -36,7 +36,9 @@ pre {
 
 <h1>Ebiten example - sprites</h1>
 <iframe src="sprites.content.html" width="640" height="480"></iframe>
-<pre><code>package main
+<pre><code>// &#43;build example
+
+package main
 
 import (
     &#34;fmt&#34;

_docs/public/index.html

@@ -18,23 +18,7 @@ limitations under the License.
 <link rel="shortcut icon" href="./favicon.png" type="image/png">
 <link rel="icon" href="./favicon.png" type="image/png">
 <title>Ebiten - A simple SNES-like 2D game library in Go</title>
-<style>
-body {
-  font-family: sans-serif;
-}
-img.example {
-  background-color: #000;
-  border-color: #999;
-  border-style: solid;
-  border-width: 1px;
-  image-rendering: crisp-edges;
-  image-rendering: pixelated;
-}
-pre {
-  background: #eee;
-  padding: 1em;
-}
-</style>
+<link rel="stylesheet" href="./style.css">
 <a href="https://github.com/hajimehoshi/ebiten"><img style="position: absolute; top: 0; right: 0; border: 0;" src="https://camo.githubusercontent.com/365986a132ccd6a44c23a9169022c0b5c890c387/68747470733a2f2f73332e616d617a6f6e6177732e636f6d2f6769746875622f726962626f6e732f666f726b6d655f72696768745f7265645f6161303030302e706e67" alt="Fork me on GitHub" data-canonical-src="https://s3.amazonaws.com/github/ribbons/forkme_right_red_aa0000.png"></a>
 <h1>Ebiten (海老天)</h1>
 <p>Stable version: v1.4.0-alpha / Development version: v1.4.0-alpha</p>
@@ -70,10 +54,12 @@ pre {
   <a href="examples/alphablending.html"><img src="images/examples/alphablending.png" width="320" height="240" alt="Ebiten example: alphablending" class="example"></a><a href="examples/audio.html"><img src="images/examples/audio.png" width="320" height="240" alt="Ebiten example: audio" class="example"></a><a href="examples/font.html"><img src="images/examples/font.png" width="320" height="240" alt="Ebiten example: font" class="example"></a><a href="examples/hsv.html"><img src="images/examples/hsv.png" width="320" height="240" alt="Ebiten example: hsv" class="example"></a><a href="examples/hue.html"><img src="images/examples/hue.png" width="320" height="240" alt="Ebiten example: hue" class="example"></a><a href="examples/gamepad.html"><img src="images/examples/gamepad.png" width="320" height="240" alt="Ebiten example: gamepad" class="example"></a><a href="examples/keyboard.html"><img src="images/examples/keyboard.png" width="320" height="240" alt="Ebiten example: keyboard" class="example"></a><a href="examples/masking.html"><img src="images/examples/masking.png" width="320" height="240" alt="Ebiten example: masking" class="example"></a><a href="examples/mosaic.html"><img src="images/examples/mosaic.png" width="320" height="240" alt="Ebiten example: mosaic" class="example"></a><a href="examples/noise.html"><img src="images/examples/noise.png" width="320" height="240" alt="Ebiten example: noise" class="example"></a><a href="examples/paint.html"><img src="images/examples/paint.png" width="320" height="240" alt="Ebiten example: paint" class="example"></a><a href="examples/perspective.html"><img src="images/examples/perspective.png" width="320" height="240" alt="Ebiten example: perspective" class="example"></a><a href="examples/piano.html"><img src="images/examples/piano.png" width="320" height="240" alt="Ebiten example: piano" class="example"></a><a href="examples/rotate.html"><img src="images/examples/rotate.png" width="320" height="240" alt="Ebiten example: rotate" class="example"></a><a href="examples/sprites.html"><img src="images/examples/sprites.png" width="320" height="240" alt="Ebiten example: sprites" class="example"></a><a href="examples/blocks.html"><img src="images/examples/blocks.png" width="256" height="240" alt="Ebiten example: blocks" class="example"></a>
 </p>
 
-<h2>Execute the example</h2>
+<h2>Execute the examples</h2>
 <pre><code>:; go get github.com/hajimehoshi/ebiten
 :; cd $GOPATH/src/github.com/hajimehoshi/ebiten/examples
-:; go run rotate/main.go</code></pre>
+:; go run -tags example rotate/main.go</code></pre>
+
+<p>Note that you need to specify <code>example</code> tag.</p>
 
 <h2>Getting Started</h2>
 

_docs/public/style.css

@@ -0,0 +1,15 @@
+body {
+  font-family: sans-serif;
+}
+img.example {
+  background-color: #000;
+  border-color: #999;
+  border-style: solid;
+  border-width: 1px;
+  image-rendering: crisp-edges;
+  image-rendering: pixelated;
+}
+pre {
+  background: #eee;
+  padding: 1em;
+}

internal/license.go

@@ -21,6 +21,7 @@ import (
 	"strings"
 )
 
+// LicenseComment returns the license string in Go comment style.
 func LicenseComment() (string, error) {
 	_, path, _, _ := runtime.Caller(0)
 	licensePath := filepath.Join(filepath.Dir(path), "..", "LICENSE")