examples: Update comments

examples/additive/main.go

@@ -70,15 +70,10 @@ func (g *Game) Layout(outsideWidth, outsideHeight int) (int, int) {
 }
 
 func main() {
-	// Decode image from a byte slice instead of a file so that
+	// Decode an image from a byte slice.
-	// this example works in any working directory.
+	// Now this image file's byte slice is generated with //go:generated for Go 1.15 or older.
-	// If you want to use a file, there are some options:
+	// If you use Go 1.16 or newer, it is strongly recommended to use //go:embed to embed the image file.
-	// 1) Use os.Open and pass the file to the image decoder.
+	// See https://pkg.go.dev/embed for more details.
-	//    This is a very regular way, but doesn't work on browsers.
-	// 2) Use ebitenutil.OpenFile and pass the file to the image decoder.
-	//    This works even on browsers.
-	// 3) Use ebitenutil.NewImageFromFile to create an ebiten.Image directly from a file.
-	//    This also works on browsers.
 	img, _, err := image.Decode(bytes.NewReader(images.Ebiten_png))
 	if err != nil {
 		log.Fatal(err)

examples/address/main.go

@@ -36,15 +36,10 @@ const (
 var ebitenImage *ebiten.Image
 
 func init() {
-	// Decode image from a byte slice instead of a file so that
+	// Decode an image from a byte slice.
-	// this example works in any working directory.
+	// Now this image file's byte slice is generated with //go:generated for Go 1.15 or older.
-	// If you want to use a file, there are some options:
+	// If you use Go 1.16 or newer, it is strongly recommended to use //go:embed to embed the image file.
-	// 1) Use os.Open and pass the file to the image decoder.
+	// See https://pkg.go.dev/embed for more details.
-	//    This is a very regular way, but doesn't work on browsers.
-	// 2) Use ebitenutil.OpenFile and pass the file to the image decoder.
-	//    This works even on browsers.
-	// 3) Use ebitenutil.NewImageFromFile to create an ebiten.Image directly from a file.
-	//    This also works on browsers.
 	img, _, err := image.Decode(bytes.NewReader(images.Ebiten_png))
 	if err != nil {
 		log.Fatal(err)

examples/airship/main.go

@@ -46,15 +46,10 @@ var (
 )
 
 func init() {
-	// Decode image from a byte slice instead of a file so that
+	// Decode an image from a byte slice.
-	// this example works in any working directory.
+	// Now this image file's byte slice is generated with //go:generated for Go 1.15 or older.
-	// If you want to use a file, there are some options:
+	// If you use Go 1.16 or newer, it is strongly recommended to use //go:embed to embed the image file.
-	// 1) Use os.Open and pass the file to the image decoder.
+	// See https://pkg.go.dev/embed for more details.
-	//    This is a very regular way, but doesn't work on browsers.
-	// 2) Use ebitenutil.OpenFile and pass the file to the image decoder.
-	//    This works even on browsers.
-	// 3) Use ebitenutil.NewImageFromFile to create an ebiten.Image directly from a file.
-	//    This also works on browsers.
 	img, _, err := image.Decode(bytes.NewReader(images.Gophers_jpg))
 	if err != nil {
 		log.Fatal(err)

examples/alphablending/main.go

@@ -79,15 +79,10 @@ func (g *Game) Layout(outsideWidth, outsideHeight int) (int, int) {
 }
 
 func main() {
-	// Decode image from a byte slice instead of a file so that
+	// Decode an image from a byte slice.
-	// this example works in any working directory.
+	// Now this image file's byte slice is generated with //go:generated for Go 1.15 or older.
-	// If you want to use a file, there are some options:
+	// If you use Go 1.16 or newer, it is strongly recommended to use //go:embed to embed the image file.
-	// 1) Use os.Open and pass the file to the image decoder.
+	// See https://pkg.go.dev/embed for more details.
-	//    This is a very regular way, but doesn't work on browsers.
-	// 2) Use ebitenutil.OpenFile and pass the file to the image decoder.
-	//    This works even on browsers.
-	// 3) Use ebitenutil.NewImageFromFile to create an ebiten.Image directly from a file.
-	//    This also works on browsers.
 	img, _, err := image.Decode(bytes.NewReader(images.Ebiten_png))
 	if err != nil {
 		log.Fatal(err)

examples/animation/main.go

@@ -65,15 +65,10 @@ func (g *Game) Layout(outsideWidth, outsideHeight int) (int, int) {
 }
 
 func main() {
-	// Decode image from a byte slice instead of a file so that
+	// Decode an image from a byte slice.
-	// this example works in any working directory.
+	// Now this image file's byte slice is generated with //go:generated for Go 1.15 or older.
-	// If you want to use a file, there are some options:
+	// If you use Go 1.16 or newer, it is strongly recommended to use //go:embed to embed the image file.
-	// 1) Use os.Open and pass the file to the image decoder.
+	// See https://pkg.go.dev/embed for more details.
-	//    This is a very regular way, but doesn't work on browsers.
-	// 2) Use ebitenutil.OpenFile and pass the file to the image decoder.
-	//    This works even on browsers.
-	// 3) Use ebitenutil.NewImageFromFile to create an ebiten.Image directly from a file.
-	//    This also works on browsers.
 	img, _, err := image.Decode(bytes.NewReader(images.Runner_png))
 	if err != nil {
 		log.Fatal(err)

examples/audiopanning/main.go

@@ -122,15 +122,10 @@ func (g *Game) Layout(outsideWidth, outsideHeight int) (int, int) {
 }
 
 func main() {
-	// Decode image from a byte slice instead of a file so that
+	// Decode an image from a byte slice.
-	// this example works in any working directory.
+	// Now this image file's byte slice is generated with //go:generated for Go 1.15 or older.
-	// If you want to use a file, there are some options:
+	// If you use Go 1.16 or newer, it is strongly recommended to use //go:embed to embed the image file.
-	// 1) Use os.Open and pass the file to the image decoder.
+	// See https://pkg.go.dev/embed for more details.
-	//    This is a very regular way, but doesn't work on browsers.
-	// 2) Use ebitenutil.OpenFile and pass the file to the image decoder.
-	//    This works even on browsers.
-	// 3) Use ebitenutil.NewImageFromFile to create an ebiten.Image directly from a file.
-	//    This also works on browsers.
 	img, _, err := image.Decode(bytes.NewReader(images.Ebiten_png))
 	if err != nil {
 		log.Fatal(err)

examples/blur/main.go

@@ -70,15 +70,10 @@ func (g *Game) Layout(outsideWidth, outsideHeight int) (int, int) {
 }
 
 func main() {
-	// Decode image from a byte slice instead of a file so that
+	// Decode an image from a byte slice.
-	// this example works in any working directory.
+	// Now this image file's byte slice is generated with //go:generated for Go 1.15 or older.
-	// If you want to use a file, there are some options:
+	// If you use Go 1.16 or newer, it is strongly recommended to use //go:embed to embed the image file.
-	// 1) Use os.Open and pass the file to the image decoder.
+	// See https://pkg.go.dev/embed for more details.
-	//    This is a very regular way, but doesn't work on browsers.
-	// 2) Use ebitenutil.OpenFile and pass the file to the image decoder.
-	//    This works even on browsers.
-	// 3) Use ebitenutil.NewImageFromFile to create an ebiten.Image directly from a file.
-	//    This also works on browsers.
 	img, _, err := image.Decode(bytes.NewReader(images.FiveYears_jpg))
 	if err != nil {
 		log.Fatal(err)

examples/camera/main.go

@@ -53,15 +53,10 @@ var (
 )
 
 func init() {
-	// Decode image from a byte slice instead of a file so that
+	// Decode an image from a byte slice.
-	// this example works in any working directory.
+	// Now this image file's byte slice is generated with //go:generated for Go 1.15 or older.
-	// If you want to use a file, there are some options:
+	// If you use Go 1.16 or newer, it is strongly recommended to use //go:embed to embed the image file.
-	// 1) Use os.Open and pass the file to the image decoder.
+	// See https://pkg.go.dev/embed for more details.
-	//    This is a very regular way, but doesn't work on browsers.
-	// 2) Use ebitenutil.OpenFile and pass the file to the image decoder.
-	//    This works even on browsers.
-	// 3) Use ebitenutil.NewImageFromFile to create an ebiten.Image directly from a file.
-	//    This also works on browsers.
 	img, _, err := image.Decode(bytes.NewReader(images.Tiles_png))
 	if err != nil {
 		log.Fatal(err)

examples/clip/main.go

@@ -73,15 +73,10 @@ func (g *Game) Layout(outsideWidth, outsideHeight int) (int, int) {
 }
 
 func main() {
-	// Decode image from a byte slice instead of a file so that
+	// Decode an image from a byte slice.
-	// this example works in any working directory.
+	// Now this image file's byte slice is generated with //go:generated for Go 1.15 or older.
-	// If you want to use a file, there are some options:
+	// If you use Go 1.16 or newer, it is strongly recommended to use //go:embed to embed the image file.
-	// 1) Use os.Open and pass the file to the image decoder.
+	// See https://pkg.go.dev/embed for more details.
-	//    This is a very regular way, but doesn't work on browsers.
-	// 2) Use ebitenutil.OpenFile and pass the file to the image decoder.
-	//    This works even on browsers.
-	// 3) Use ebitenutil.NewImageFromFile to create an ebiten.Image directly from a file.
-	//    This also works on browsers.
 	img, _, err := image.Decode(bytes.NewReader(images.Gophers_jpg))
 	if err != nil {
 		log.Fatal(err)

examples/contextlost/main.go

@@ -89,15 +89,10 @@ func (g *Game) Layout(outsideWidth, outsideHeight int) (int, int) {
 }
 
 func main() {
-	// Decode image from a byte slice instead of a file so that
+	// Decode an image from a byte slice.
-	// this example works in any working directory.
+	// Now this image file's byte slice is generated with //go:generated for Go 1.15 or older.
-	// If you want to use a file, there are some options:
+	// If you use Go 1.16 or newer, it is strongly recommended to use //go:embed to embed the image file.
-	// 1) Use os.Open and pass the file to the image decoder.
+	// See https://pkg.go.dev/embed for more details.
-	//    This is a very regular way, but doesn't work on browsers.
-	// 2) Use ebitenutil.OpenFile and pass the file to the image decoder.
-	//    This works even on browsers.
-	// 3) Use ebitenutil.NewImageFromFile to create an ebiten.Image directly from a file.
-	//    This also works on browsers.
 	img, _, err := image.Decode(bytes.NewReader(images.Gophers_jpg))
 	if err != nil {
 		log.Fatal(err)

examples/drag/main.go

@@ -192,15 +192,10 @@ type Game struct {
 var ebitenImage *ebiten.Image
 
 func init() {
-	// Decode image from a byte slice instead of a file so that
+	// Decode an image from a byte slice.
-	// this example works in any working directory.
+	// Now this image file's byte slice is generated with //go:generated for Go 1.15 or older.
-	// If you want to use a file, there are some options:
+	// If you use Go 1.16 or newer, it is strongly recommended to use //go:embed to embed the image file.
-	// 1) Use os.Open and pass the file to the image decoder.
+	// See https://pkg.go.dev/embed for more details.
-	//    This is a very regular way, but doesn't work on browsers.
-	// 2) Use ebitenutil.OpenFile and pass the file to the image decoder.
-	//    This works even on browsers.
-	// 3) Use ebitenutil.NewImageFromFile to create an ebiten.Image directly from a file.
-	//    This also works on browsers.
 	img, _, err := image.Decode(bytes.NewReader(images.Ebiten_png))
 	if err != nil {
 		log.Fatal(err)

examples/filter/main.go

@@ -66,15 +66,10 @@ func (g *Game) Layout(outsideWidth, outsideHeight int) (int, int) {
 }
 
 func main() {
-	// Decode image from a byte slice instead of a file so that
+	// Decode an image from a byte slice.
-	// this example works in any working directory.
+	// Now this image file's byte slice is generated with //go:generated for Go 1.15 or older.
-	// If you want to use a file, there are some options:
+	// If you use Go 1.16 or newer, it is strongly recommended to use //go:embed to embed the image file.
-	// 1) Use os.Open and pass the file to the image decoder.
+	// See https://pkg.go.dev/embed for more details.
-	//    This is a very regular way, but doesn't work on browsers.
-	// 2) Use ebitenutil.OpenFile and pass the file to the image decoder.
-	//    This works even on browsers.
-	// 3) Use ebitenutil.NewImageFromFile to create an ebiten.Image directly from a file.
-	//    This also works on browsers.
 	img, _, err := image.Decode(bytes.NewReader(images.Ebiten_png))
 	if err != nil {
 		log.Fatal(err)

examples/flood/main.go

@@ -91,15 +91,10 @@ func (g *Game) Layout(outsideWidth, outsideHeight int) (int, int) {
 }
 
 func main() {
-	// Decode image from a byte slice instead of a file so that
+	// Decode an image from a byte slice.
-	// this example works in any working directory.
+	// Now this image file's byte slice is generated with //go:generated for Go 1.15 or older.
-	// If you want to use a file, there are some options:
+	// If you use Go 1.16 or newer, it is strongly recommended to use //go:embed to embed the image file.
-	// 1) Use os.Open and pass the file to the image decoder.
+	// See https://pkg.go.dev/embed for more details.
-	//    This is a very regular way, but doesn't work on browsers.
-	// 2) Use ebitenutil.OpenFile and pass the file to the image decoder.
-	//    This works even on browsers.
-	// 3) Use ebitenutil.NewImageFromFile to create an ebiten.Image directly from a file.
-	//    This also works on browsers.
 	img, _, err := image.Decode(bytes.NewReader(images.Ebiten_png))
 	if err != nil {
 		log.Fatal(err)

examples/fullscreen/main.go

@@ -43,15 +43,10 @@ var (
 )
 
 func init() {
-	// Decode image from a byte slice instead of a file so that
+	// Decode an image from a byte slice.
-	// this example works in any working directory.
+	// Now this image file's byte slice is generated with //go:generated for Go 1.15 or older.
-	// If you want to use a file, there are some options:
+	// If you use Go 1.16 or newer, it is strongly recommended to use //go:embed to embed the image file.
-	// 1) Use os.Open and pass the file to the image decoder.
+	// See https://pkg.go.dev/embed for more details.
-	//    This is a very regular way, but doesn't work on browsers.
-	// 2) Use ebitenutil.OpenFile and pass the file to the image decoder.
-	//    This works even on browsers.
-	// 3) Use ebitenutil.NewImageFromFile to create an ebiten.Image directly from a file.
-	//    This also works on browsers.
 	img, _, err := image.Decode(bytes.NewReader(images.Gophers_jpg))
 	if err != nil {
 		log.Fatal(err)

examples/hsv/main.go

@@ -139,15 +139,10 @@ func (g *Game) Layout(outsideWidth, outsideHeight int) (int, int) {
 }
 
 func main() {
-	// Decode image from a byte slice instead of a file so that
+	// Decode an image from a byte slice.
-	// this example works in any working directory.
+	// Now this image file's byte slice is generated with //go:generated for Go 1.15 or older.
-	// If you want to use a file, there are some options:
+	// If you use Go 1.16 or newer, it is strongly recommended to use //go:embed to embed the image file.
-	// 1) Use os.Open and pass the file to the image decoder.
+	// See https://pkg.go.dev/embed for more details.
-	//    This is a very regular way, but doesn't work on browsers.
-	// 2) Use ebitenutil.OpenFile and pass the file to the image decoder.
-	//    This works even on browsers.
-	// 3) Use ebitenutil.NewImageFromFile to create an ebiten.Image directly from a file.
-	//    This also works on browsers.
 	img, _, err := image.Decode(bytes.NewReader(images.Gophers_jpg))
 	if err != nil {
 		log.Fatal(err)

examples/hue/main.go

@@ -65,15 +65,10 @@ func (g *Game) Layout(outsideWidth, outsideHeight int) (int, int) {
 }
 
 func main() {
-	// Decode image from a byte slice instead of a file so that
+	// Decode an image from a byte slice.
-	// this example works in any working directory.
+	// Now this image file's byte slice is generated with //go:generated for Go 1.15 or older.
-	// If you want to use a file, there are some options:
+	// If you use Go 1.16 or newer, it is strongly recommended to use //go:embed to embed the image file.
-	// 1) Use os.Open and pass the file to the image decoder.
+	// See https://pkg.go.dev/embed for more details.
-	//    This is a very regular way, but doesn't work on browsers.
-	// 2) Use ebitenutil.OpenFile and pass the file to the image decoder.
-	//    This works even on browsers.
-	// 3) Use ebitenutil.NewImageFromFile to create an ebiten.Image directly from a file.
-	//    This also works on browsers.
 	img, _, err := image.Decode(bytes.NewReader(images.Gophers_jpg))
 	if err != nil {
 		log.Fatal(err)

examples/infinitescroll/main.go

@@ -39,15 +39,10 @@ var (
 )
 
 func init() {
-	// Decode image from a byte slice instead of a file so that
+	// Decode an image from a byte slice.
-	// this example works in any working directory.
+	// Now this image file's byte slice is generated with //go:generated for Go 1.15 or older.
-	// If you want to use a file, there are some options:
+	// If you use Go 1.16 or newer, it is strongly recommended to use //go:embed to embed the image file.
-	// 1) Use os.Open and pass the file to the image decoder.
+	// See https://pkg.go.dev/embed for more details.
-	//    This is a very regular way, but doesn't work on browsers.
-	// 2) Use ebitenutil.OpenFile and pass the file to the image decoder.
-	//    This works even on browsers.
-	// 3) Use ebitenutil.NewImageFromFile to create an ebiten.Image directly from a file.
-	//    This also works on browsers.
 	img, _, err := image.Decode(bytes.NewReader(images.Tile_png))
 	if err != nil {
 		log.Fatal(err)

examples/mascot/main.go

@@ -43,15 +43,10 @@ var (
 )
 
 func init() {
-	// Decode image from a byte slice instead of a file so that
+	// Decode an image from a byte slice.
-	// this example works in any working directory.
+	// Now this image file's byte slice is generated with //go:generated for Go 1.15 or older.
-	// If you want to use a file, there are some options:
+	// If you use Go 1.16 or newer, it is strongly recommended to use //go:embed to embed the image file.
-	// 1) Use os.Open and pass the file to the image decoder.
+	// See https://pkg.go.dev/embed for more details.
-	//    This is a very regular way, but doesn't work on browsers.
-	// 2) Use ebitenutil.OpenFile and pass the file to the image decoder.
-	//    This works even on browsers.
-	// 3) Use ebitenutil.NewImageFromFile to create an ebiten.Image directly from a file.
-	//    This also works on browsers.
 	img1, _, err := image.Decode(bytes.NewReader(rmascot.Out01_png))
 	if err != nil {
 		log.Fatal(err)

examples/masking/main.go

@@ -42,15 +42,10 @@ var (
 )
 
 func init() {
-	// Decode image from a byte slice instead of a file so that
+	// Decode an image from a byte slice.
-	// this example works in any working directory.
+	// Now this image file's byte slice is generated with //go:generated for Go 1.15 or older.
-	// If you want to use a file, there are some options:
+	// If you use Go 1.16 or newer, it is strongly recommended to use //go:embed to embed the image file.
-	// 1) Use os.Open and pass the file to the image decoder.
+	// See https://pkg.go.dev/embed for more details.
-	//    This is a very regular way, but doesn't work on browsers.
-	// 2) Use ebitenutil.OpenFile and pass the file to the image decoder.
-	//    This works even on browsers.
-	// 3) Use ebitenutil.NewImageFromFile to create an ebiten.Image directly from a file.
-	//    This also works on browsers.
 	img, _, err := image.Decode(bytes.NewReader(images.Gophers_jpg))
 	if err != nil {
 		log.Fatal(err)

examples/minify/main.go

@@ -98,15 +98,10 @@ func (g *Game) Layout(outsideWidth, outsideHeight int) (int, int) {
 }
 
 func main() {
-	// Decode image from a byte slice instead of a file so that
+	// Decode an image from a byte slice.
-	// this example works in any working directory.
+	// Now this image file's byte slice is generated with //go:generated for Go 1.15 or older.
-	// If you want to use a file, there are some options:
+	// If you use Go 1.16 or newer, it is strongly recommended to use //go:embed to embed the image file.
-	// 1) Use os.Open and pass the file to the image decoder.
+	// See https://pkg.go.dev/embed for more details.
-	//    This is a very regular way, but doesn't work on browsers.
-	// 2) Use ebitenutil.OpenFile and pass the file to the image decoder.
-	//    This works even on browsers.
-	// 3) Use ebitenutil.NewImageFromFile to create an ebiten.Image directly from a file.
-	//    This also works on browsers.
 	img, _, err := image.Decode(bytes.NewReader(images.Gophers_jpg))
 	if err != nil {
 		log.Fatal(err)

examples/mosaic/main.go

@@ -39,15 +39,10 @@ var (
 )
 
 func init() {
-	// Decode image from a byte slice instead of a file so that
+	// Decode an image from a byte slice.
-	// this example works in any working directory.
+	// Now this image file's byte slice is generated with //go:generated for Go 1.15 or older.
-	// If you want to use a file, there are some options:
+	// If you use Go 1.16 or newer, it is strongly recommended to use //go:embed to embed the image file.
-	// 1) Use os.Open and pass the file to the image decoder.
+	// See https://pkg.go.dev/embed for more details.
-	//    This is a very regular way, but doesn't work on browsers.
-	// 2) Use ebitenutil.OpenFile and pass the file to the image decoder.
-	//    This works even on browsers.
-	// 3) Use ebitenutil.NewImageFromFile to create an ebiten.Image directly from a file.
-	//    This also works on browsers.
 	img, _, err := image.Decode(bytes.NewReader(images.Gophers_jpg))
 	if err != nil {
 		log.Fatal(err)

examples/particles/main.go

@@ -46,15 +46,10 @@ const (
 var smokeImage *ebiten.Image
 
 func init() {
-	// Decode image from a byte slice instead of a file so that
+	// Decode an image from a byte slice.
-	// this example works in any working directory.
+	// Now this image file's byte slice is generated with //go:generated for Go 1.15 or older.
-	// If you want to use a file, there are some options:
+	// If you use Go 1.16 or newer, it is strongly recommended to use //go:embed to embed the image file.
-	// 1) Use os.Open and pass the file to the image decoder.
+	// See https://pkg.go.dev/embed for more details.
-	//    This is a very regular way, but doesn't work on browsers.
-	// 2) Use ebitenutil.OpenFile and pass the file to the image decoder.
-	//    This works even on browsers.
-	// 3) Use ebitenutil.NewImageFromFile to create an ebiten.Image directly from a file.
-	//    This also works on browsers.
 	img, _, err := image.Decode(bytes.NewReader(images.Smoke_png))
 	if err != nil {
 		log.Fatal(err)

examples/perspective/main.go

@@ -70,15 +70,10 @@ func (g *Game) Layout(outsideWidth, outsideHeight int) (int, int) {
 }
 
 func main() {
-	// Decode image from a byte slice instead of a file so that
+	// Decode an image from a byte slice.
-	// this example works in any working directory.
+	// Now this image file's byte slice is generated with //go:generated for Go 1.15 or older.
-	// If you want to use a file, there are some options:
+	// If you use Go 1.16 or newer, it is strongly recommended to use //go:embed to embed the image file.
-	// 1) Use os.Open and pass the file to the image decoder.
+	// See https://pkg.go.dev/embed for more details.
-	//    This is a very regular way, but doesn't work on browsers.
-	// 2) Use ebitenutil.OpenFile and pass the file to the image decoder.
-	//    This works even on browsers.
-	// 3) Use ebitenutil.NewImageFromFile to create an ebiten.Image directly from a file.
-	//    This also works on browsers.
 	img, _, err := image.Decode(bytes.NewReader(images.Gophers_jpg))
 	if err != nil {
 		log.Fatal(err)

examples/raycasting/main.go

@@ -47,15 +47,10 @@ var (
 )
 
 func init() {
-	// Decode image from a byte slice instead of a file so that
+	// Decode an image from a byte slice.
-	// this example works in any working directory.
+	// Now this image file's byte slice is generated with //go:generated for Go 1.15 or older.
-	// If you want to use a file, there are some options:
+	// If you use Go 1.16 or newer, it is strongly recommended to use //go:embed to embed the image file.
-	// 1) Use os.Open and pass the file to the image decoder.
+	// See https://pkg.go.dev/embed for more details.
-	//    This is a very regular way, but doesn't work on browsers.
-	// 2) Use ebitenutil.OpenFile and pass the file to the image decoder.
-	//    This works even on browsers.
-	// 3) Use ebitenutil.NewImageFromFile to create an ebiten.Image directly from a file.
-	//    This also works on browsers.
 	img, _, err := image.Decode(bytes.NewReader(images.Tile_png))
 	if err != nil {
 		log.Fatal(err)

examples/rotate/main.go

@@ -70,15 +70,10 @@ func (g *Game) Layout(outsideWidth, outsideHeight int) (int, int) {
 }
 
 func main() {
-	// Decode image from a byte slice instead of a file so that
+	// Decode an image from a byte slice.
-	// this example works in any working directory.
+	// Now this image file's byte slice is generated with //go:generated for Go 1.15 or older.
-	// If you want to use a file, there are some options:
+	// If you use Go 1.16 or newer, it is strongly recommended to use //go:embed to embed the image file.
-	// 1) Use os.Open and pass the file to the image decoder.
+	// See https://pkg.go.dev/embed for more details.
-	//    This is a very regular way, but doesn't work on browsers.
-	// 2) Use ebitenutil.OpenFile and pass the file to the image decoder.
-	//    This works even on browsers.
-	// 3) Use ebitenutil.NewImageFromFile to create an ebiten.Image directly from a file.
-	//    This also works on browsers.
 	img, _, err := image.Decode(bytes.NewReader(images.Gophers_jpg))
 	if err != nil {
 		log.Fatal(err)

examples/shader/main.go

@@ -42,15 +42,10 @@ var (
 )
 
 func init() {
-	// Decode image from a byte slice instead of a file so that
+	// Decode an image from a byte slice.
-	// this example works in any working directory.
+	// Now this image file's byte slice is generated with //go:generated for Go 1.15 or older.
-	// If you want to use a file, there are some options:
+	// If you use Go 1.16 or newer, it is strongly recommended to use //go:embed to embed the image file.
-	// 1) Use os.Open and pass the file to the image decoder.
+	// See https://pkg.go.dev/embed for more details.
-	//    This is a very regular way, but doesn't work on browsers.
-	// 2) Use ebitenutil.OpenFile and pass the file to the image decoder.
-	//    This works even on browsers.
-	// 3) Use ebitenutil.NewImageFromFile to create an ebiten.Image directly from a file.
-	//    This also works on browsers.
 	img, _, err := image.Decode(bytes.NewReader(resources.Gopher_png))
 	if err != nil {
 		log.Fatal(err)

examples/sprites/main.go

@@ -42,15 +42,10 @@ var (
 )
 
 func init() {
-	// Decode image from a byte slice instead of a file so that
+	// Decode an image from a byte slice.
-	// this example works in any working directory.
+	// Now this image file's byte slice is generated with //go:generated for Go 1.15 or older.
-	// If you want to use a file, there are some options:
+	// If you use Go 1.16 or newer, it is strongly recommended to use //go:embed to embed the image file.
-	// 1) Use os.Open and pass the file to the image decoder.
+	// See https://pkg.go.dev/embed for more details.
-	//    This is a very regular way, but doesn't work on browsers.
-	// 2) Use ebitenutil.OpenFile and pass the file to the image decoder.
-	//    This works even on browsers.
-	// 3) Use ebitenutil.NewImageFromFile to create an ebiten.Image directly from a file.
-	//    This also works on browsers.
 	img, _, err := image.Decode(bytes.NewReader(images.Ebiten_png))
 	if err != nil {
 		log.Fatal(err)

examples/spriteshd/main.go

@@ -44,15 +44,10 @@ var (
 )
 
 func init() {
-	// Decode image from a byte slice instead of a file so that
+	// Decode an image from a byte slice.
-	// this example works in any working directory.
+	// Now this image file's byte slice is generated with //go:generated for Go 1.15 or older.
-	// If you want to use a file, there are some options:
+	// If you use Go 1.16 or newer, it is strongly recommended to use //go:embed to embed the image file.
-	// 1) Use os.Open and pass the file to the image decoder.
+	// See https://pkg.go.dev/embed for more details.
-	//    This is a very regular way, but doesn't work on browsers.
-	// 2) Use ebitenutil.OpenFile and pass the file to the image decoder.
-	//    This works even on browsers.
-	// 3) Use ebitenutil.NewImageFromFile to create an ebiten.Image directly from a file.
-	//    This also works on browsers.
 	img, _, err := image.Decode(bytes.NewReader(images.Ebiten_png))
 	if err != nil {
 		log.Fatal(err)

examples/tiles/main.go

@@ -44,15 +44,10 @@ var (
 )
 
 func init() {
-	// Decode image from a byte slice instead of a file so that
+	// Decode an image from a byte slice.
-	// this example works in any working directory.
+	// Now this image file's byte slice is generated with //go:generated for Go 1.15 or older.
-	// If you want to use a file, there are some options:
+	// If you use Go 1.16 or newer, it is strongly recommended to use //go:embed to embed the image file.
-	// 1) Use os.Open and pass the file to the image decoder.
+	// See https://pkg.go.dev/embed for more details.
-	//    This is a very regular way, but doesn't work on browsers.
-	// 2) Use ebitenutil.OpenFile and pass the file to the image decoder.
-	//    This works even on browsers.
-	// 3) Use ebitenutil.NewImageFromFile to create an ebiten.Image directly from a file.
-	//    This also works on browsers.
 	img, _, err := image.Decode(bytes.NewReader(images.Tiles_png))
 	if err != nil {
 		log.Fatal(err)

examples/touch/main.go

@@ -229,15 +229,10 @@ func (g *Game) Layout(outsideWidth, outsideHeight int) (int, int) {
 }
 
 func main() {
-	// Decode image from a byte slice instead of a file so that
+	// Decode an image from a byte slice.
-	// this example works in any working directory.
+	// Now this image file's byte slice is generated with //go:generated for Go 1.15 or older.
-	// If you want to use a file, there are some options:
+	// If you use Go 1.16 or newer, it is strongly recommended to use //go:embed to embed the image file.
-	// 1) Use os.Open and pass the file to the image decoder.
+	// See https://pkg.go.dev/embed for more details.
-	//    This is a very regular way, but doesn't work on browsers.
-	// 2) Use ebitenutil.OpenFile and pass the file to the image decoder.
-	//    This works even on browsers.
-	// 3) Use ebitenutil.NewImageFromFile to create an ebiten.Image directly from a file.
-	//    This also works on browsers.
 	img, _, err := image.Decode(bytes.NewReader(images.Gophers_jpg))
 	if err != nil {
 		log.Fatal(err)

examples/ui/main.go

@@ -46,15 +46,10 @@ var (
 )
 
 func init() {
-	// Decode image from a byte slice instead of a file so that
+	// Decode an image from a byte slice.
-	// this example works in any working directory.
+	// Now this image file's byte slice is generated with //go:generated for Go 1.15 or older.
-	// If you want to use a file, there are some options:
+	// If you use Go 1.16 or newer, it is strongly recommended to use //go:embed to embed the image file.
-	// 1) Use os.Open and pass the file to the image decoder.
+	// See https://pkg.go.dev/embed for more details.
-	//    This is a very regular way, but doesn't work on browsers.
-	// 2) Use ebitenutil.OpenFile and pass the file to the image decoder.
-	//    This works even on browsers.
-	// 3) Use ebitenutil.NewImageFromFile to create an ebiten.Image directly from a file.
-	//    This also works on browsers.
 	img, _, err := image.Decode(bytes.NewReader(images.UI_png))
 	if err != nil {
 		log.Fatal(err)

examples/windowsize/main.go

@@ -377,15 +377,10 @@ func main() {
 	w, h := ebiten.ScreenSizeInFullscreen()
 	fmt.Printf("Screen size in fullscreen: %d, %d\n", w, h)
 
-	// Decode image from a byte slice instead of a file so that
+	// Decode an image from a byte slice.
-	// this example works in any working directory.
+	// Now this image file's byte slice is generated with //go:generated for Go 1.15 or older.
-	// If you want to use a file, there are some options:
+	// If you use Go 1.16 or newer, it is strongly recommended to use //go:embed to embed the image file.
-	// 1) Use os.Open and pass the file to the image decoder.
+	// See https://pkg.go.dev/embed for more details.
-	//    This is a very regular way, but doesn't work on browsers.
-	// 2) Use ebitenutil.OpenFile and pass the file to the image decoder.
-	//    This works even on browsers.
-	// 3) Use ebitenutil.NewImageFromFile to create an ebiten.Image directly from a file.
-	//    This also works on browsers.
 	img, _, err := image.Decode(bytes.NewReader(images.Gophers_jpg))
 	if err != nil {
 		log.Fatal(err)