✨ (sudoku-game): add layout for sudoku game to show ui

yuanyu90221 · yuanyu90221 · commit 536489697750 · 2025-09-07T17:22:56.000+08:00
diff --git a/cmd/main.go b/cmd/main.go
@@ -0,0 +1,17 @@
+package main
+
+import (
+	"log"
+
+	"github.com/hajimehoshi/ebiten/v2"
+	"github.com/leetcode-golang-classroom/sudoku-game/internal/layout"
+)
+
+func main() {
+	ebiten.SetWindowSize(layout.ScreenWidth, layout.ScreenHeight)
+	ebiten.SetWindowTitle("Sudoku Board")
+	gameLayout := layout.NewGameLayout()
+	if err := ebiten.RunGame(gameLayout); err != nil {
+		log.Fatal(err)
+	}
+}
diff --git a/go.mod b/go.mod
@@ -2,10 +2,22 @@ module github.com/leetcode-golang-classroom/sudoku-game
 
 go 1.24.0
 
-require github.com/stretchr/testify v1.11.1
+require (
+	github.com/hajimehoshi/ebiten/v2 v2.8.8
+	github.com/stretchr/testify v1.11.1
+)
 
 require (
 	github.com/davecgh/go-spew v1.1.1 // indirect
+	github.com/ebitengine/gomobile v0.0.0-20240911145611-4856209ac325 // indirect
+	github.com/ebitengine/hideconsole v1.0.0 // indirect
+	github.com/ebitengine/purego v0.8.0 // indirect
+	github.com/go-text/typesetting v0.2.0 // indirect
+	github.com/jezek/xgb v1.1.1 // indirect
 	github.com/pmezard/go-difflib v1.0.0 // indirect
+	golang.org/x/image v0.20.0 // indirect
+	golang.org/x/sync v0.8.0 // indirect
+	golang.org/x/sys v0.25.0 // indirect
+	golang.org/x/text v0.18.0 // indirect
 	gopkg.in/yaml.v3 v3.0.1 // indirect
 )
diff --git a/go.sum b/go.sum
@@ -1,9 +1,36 @@
 github.com/davecgh/go-spew v1.1.1 h1:vj9j/u1bqnvCEfJOwUhtlOARqs3+rkHYY13jYWTU97c=
 github.com/davecgh/go-spew v1.1.1/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=
+github.com/ebitengine/gomobile v0.0.0-20240911145611-4856209ac325 h1:Gk1XUEttOk0/hb6Tq3WkmutWa0ZLhNn/6fc6XZpM7tM=
+github.com/ebitengine/gomobile v0.0.0-20240911145611-4856209ac325/go.mod h1:ulhSQcbPioQrallSuIzF8l1NKQoD7xmMZc5NxzibUMY=
+github.com/ebitengine/hideconsole v1.0.0 h1:5J4U0kXF+pv/DhiXt5/lTz0eO5ogJ1iXb8Yj1yReDqE=
+github.com/ebitengine/hideconsole v1.0.0/go.mod h1:hTTBTvVYWKBuxPr7peweneWdkUwEuHuB3C1R/ielR1A=
+github.com/ebitengine/purego v0.8.0 h1:JbqvnEzRvPpxhCJzJJ2y0RbiZ8nyjccVUrSM3q+GvvE=
+github.com/ebitengine/purego v0.8.0/go.mod h1:iIjxzd6CiRiOG0UyXP+V1+jWqUXVjPKLAI0mRfJZTmQ=
+github.com/go-text/typesetting v0.2.0 h1:fbzsgbmk04KiWtE+c3ZD4W2nmCRzBqrqQOvYlwAOdho=
+github.com/go-text/typesetting v0.2.0/go.mod h1:2+owI/sxa73XA581LAzVuEBZ3WEEV2pXeDswCH/3i1I=
+github.com/go-text/typesetting-utils v0.0.0-20240317173224-1986cbe96c66 h1:GUrm65PQPlhFSKjLPGOZNPNxLCybjzjYBzjfoBGaDUY=
+github.com/go-text/typesetting-utils v0.0.0-20240317173224-1986cbe96c66/go.mod h1:DDxDdQEnB70R8owOx3LVpEFvpMK9eeH1o2r0yZhFI9o=
+github.com/hajimehoshi/bitmapfont/v3 v3.2.0 h1:0DISQM/rseKIJhdF29AkhvdzIULqNIIlXAGWit4ez1Q=
+github.com/hajimehoshi/bitmapfont/v3 v3.2.0/go.mod h1:8gLqGatKVu0pwcNCJguW3Igg9WQqVXF0zg/RvrGQWyg=
+github.com/hajimehoshi/ebiten/v2 v2.8.8 h1:xyMxOAn52T1tQ+j3vdieZ7auDBOXmvjUprSrxaIbsi8=
+github.com/hajimehoshi/ebiten/v2 v2.8.8/go.mod h1:durJ05+OYnio9b8q0sEtOgaNeBEQG7Yr7lRviAciYbs=
+github.com/jezek/xgb v1.1.1 h1:bE/r8ZZtSv7l9gk6nU0mYx51aXrvnyb44892TwSaqS4=
+github.com/jezek/xgb v1.1.1/go.mod h1:nrhwO0FX/enq75I7Y7G8iN1ubpSGZEiA3v9e9GyRFlk=
+github.com/pierrec/lz4/v4 v4.1.21 h1:yOVMLb6qSIDP67pl/5F7RepeKYu/VmTyEXvuMI5d9mQ=
+github.com/pierrec/lz4/v4 v4.1.21/go.mod h1:gZWDp/Ze/IJXGXf23ltt2EXimqmTUXEy0GFuRQyBid4=
 github.com/pmezard/go-difflib v1.0.0 h1:4DBwDE0NGyQoBHbLQYPwSUPoCMWR5BEzIk/f1lZbAQM=
 github.com/pmezard/go-difflib v1.0.0/go.mod h1:iKH77koFhYxTK1pcRnkKkqfTogsbg7gZNVY4sRDYZ/4=
 github.com/stretchr/testify v1.11.1 h1:7s2iGBzp5EwR7/aIZr8ao5+dra3wiQyKjjFuvgVKu7U=
 github.com/stretchr/testify v1.11.1/go.mod h1:wZwfW3scLgRK+23gO65QZefKpKQRnfz6sD981Nm4B6U=
+golang.org/x/image v0.20.0 h1:7cVCUjQwfL18gyBJOmYvptfSHS8Fb3YUDtfLIZ7Nbpw=
+golang.org/x/image v0.20.0/go.mod h1:0a88To4CYVBAHp5FXJm8o7QbUl37Vd85ply1vyD8auM=
+golang.org/x/sync v0.8.0 h1:3NFvSEYkUoMifnESzZl15y791HH1qU2xm6eCJU5ZPXQ=
+golang.org/x/sync v0.8.0/go.mod h1:Czt+wKu1gCyEFDUtn0jG5QVvpJ6rzVqr5aXyt9drQfk=
+golang.org/x/sys v0.25.0 h1:r+8e+loiHxRqhXVl6ML1nO3l1+oFoWbnlu2Ehimmi34=
+golang.org/x/sys v0.25.0/go.mod h1:/VUhepiaJMQUp4+oa/7Zr1D23ma6VTLIYjOOTFZPUcA=
+golang.org/x/text v0.18.0 h1:XvMDiNzPAl0jr17s6W9lcaIhGUfUORdGCNsuLmPG224=
+golang.org/x/text v0.18.0/go.mod h1:BuEKDfySbSR4drPmRPG/7iBdf8hvFMuRexcpahXilzY=
+gopkg.in/check.v1 v0.0.0-20161208181325-20d25e280405 h1:yhCVgyC4o1eVCa2tZl7eS0r+SDo693bJlVdllGtEeKM=
 gopkg.in/check.v1 v0.0.0-20161208181325-20d25e280405/go.mod h1:Co6ibVJAznAaIkqp8huTwlJQCZ016jof/cbN4VW5Yz0=
 gopkg.in/yaml.v3 v3.0.1 h1:fxVm/GzAzEWqLHuvctI91KS9hhNmmWOoWu0XTYJS7CA=
 gopkg.in/yaml.v3 v3.0.1/go.mod h1:K4uyk7z7BCEPqu6E+C64Yfv1cQ7kz7rIZviUmN+EgEM=
diff --git a/internal/fonts/embed.go b/internal/fonts/embed.go
@@ -0,0 +1,30 @@
+// Copyright 2022 The Ebitengine Authors
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+package fonts
+
+import (
+	_ "embed"
+)
+
+var (
+	//go:embed mplus-1p-regular.ttf
+	MPlus1pRegular_ttf []byte
+
+	//go:embed pressstart2p.ttf
+	PressStart2P_ttf []byte
+
+	//go:embed noto-emoji-regular.ttf
+	NotoEmojiRegular_ttf []byte
+)
diff --git a/internal/fonts/license.md b/internal/fonts/license.md
@@ -0,0 +1,31 @@
+# License
+
+## mplus-1p-regular.ttf
+
+```
+M+ FONTS                                Copyright (C) 2002-2015 M+ FONTS PROJECT
+
+-
+
+LICENSE_E
+
+
+
+
+These fonts are free software.
+Unlimited permission is granted to use, copy, and distribute them, with
+or without modification, either commercially or noncommercially.
+THESE FONTS ARE PROVIDED "AS IS" WITHOUT WARRANTY.
+
+
+http://mplus-fonts.sourceforge.jp/mplus-outline-fonts/
+```
+
+## PressStart2P-vaV7.ttf
+
+```
+Copyright (c) 2011, Cody "CodeMan38" Boisclair (cody@zone38.net),
+with Reserved Font Name "Press Start".
+
+This Font Software is licensed under the SIL Open Font License, Version 1.1.
+```
diff --git a/internal/fonts/mplus-1p-regular.ttf b/internal/fonts/mplus-1p-regular.ttf
diff --git a/internal/fonts/noto-emoji-regular.ttf b/internal/fonts/noto-emoji-regular.ttf
diff --git a/internal/fonts/pressstart2p.ttf b/internal/fonts/pressstart2p.ttf
diff --git a/internal/game/cell.go b/internal/game/cell.go
@@ -4,9 +4,10 @@ package game
 type CellType int
 
 const (
-	Empty  CellType = iota // 空格
-	Preset                 // 題目預設的數字
-	Input                  // 玩家輸入的數字
+	Empty         CellType = iota // 空格
+	Preset                        // 題目預設的數字
+	Input                         // 玩家輸入的數字
+	InputConflict                 // 輸入數值有 conflict
 )
 
 // Cell 代表數獨的一個格子
diff --git a/internal/game/sudoku.go b/internal/game/sudoku.go
@@ -23,12 +23,12 @@ func NewBoard() *Board {
 
 // Game - 遊戲結構
 type Game struct {
-	board *Board
+	Board *Board
 }
 
 // NewGame - 建構遊戲結構
 func NewGame() *Game {
 	return &Game{
-		board: NewBoard(),
+		Board: NewBoard(),
 	}
 }
diff --git a/internal/game/sudoku_test.go b/internal/game/sudoku_test.go
@@ -67,7 +67,7 @@ func TestNewGame(t *testing.T) {
 	for _, tt := range tests {
 		t.Run(tt.name, func(t *testing.T) {
 			game := NewGame()
-			assert.Equal(t, tt.wantBoard.Cells, game.board.Cells)
+			assert.Equal(t, tt.wantBoard.Cells, game.Board.Cells)
 		})
 	}
 }
diff --git a/internal/layout/font.go b/internal/layout/font.go
@@ -0,0 +1,51 @@
+package layout
+
+import (
+	"bytes"
+	"image/color"
+	"log"
+
+	"github.com/hajimehoshi/ebiten/v2/text/v2"
+	"github.com/leetcode-golang-classroom/sudoku-game/internal/fonts"
+	"github.com/leetcode-golang-classroom/sudoku-game/internal/game"
+)
+
+var (
+	mplusFaceSource *text.GoTextFaceSource
+)
+
+func init() {
+	s, err := text.NewGoTextFaceSource(bytes.NewReader(fonts.MPlus1pRegular_ttf))
+	if err != nil {
+		log.Fatal(err)
+	}
+	mplusFaceSource = s
+
+}
+
+func getTileColor(cellType game.CellType) color.Color {
+	switch cellType {
+	case game.Empty:
+		return color.RGBA{0x77, 0x6e, 0x65, 0xff}
+	case game.Preset:
+		return color.Black
+	case game.InputConflict:
+		return color.RGBA{0xff, 0, 0, 0xff}
+	case game.Input:
+		return color.RGBA{0, 0, 0xff, 0xff}
+	default:
+		return color.RGBA{0xf9, 0xf6, 0xf2, 0xff}
+	}
+}
+
+// getTileBgColor - Tile背景顏色
+func getTileBgColor(cellType game.CellType) color.Color {
+	switch cellType {
+	case game.Preset: // 顯示亮灰色
+		return color.RGBA{0xCD, 0xC9, 0xC9, 0xFF}
+	case game.InputConflict: // 顯示粉紅
+		return color.RGBA{0xDC, 0x69, 0xB4, 0xFF}
+	default: // 其他都是預設 白色
+		return color.RGBA{0xFF, 0xFF, 0xFF, 0xFF}
+	}
+}
diff --git a/internal/layout/layout.go b/internal/layout/layout.go
@@ -0,0 +1,161 @@
+package layout
+
+import (
+	"fmt"
+	"image/color"
+
+	"github.com/hajimehoshi/ebiten/v2"
+	"github.com/hajimehoshi/ebiten/v2/text/v2"
+	"github.com/hajimehoshi/ebiten/v2/vector"
+	"github.com/leetcode-golang-classroom/sudoku-game/internal/game"
+)
+
+const (
+	ScreenWidth    = 450
+	ScreenHeight   = 450
+	cellSize       = 50
+	thinkLineWidth = 3
+	leanLineWidth  = 1
+)
+
+type GameLayout struct {
+	gameInstance *game.Game
+	difficulty   game.Difficulty
+}
+
+func (gameLayout *GameLayout) Update() error {
+	return nil
+}
+
+func (gameLayout *GameLayout) Draw(screen *ebiten.Image) {
+	// 畫出基本背景
+	gameLayout.drawBoardBackground(screen)
+	// 根據遊戲狀態來畫出盤面
+	gameLayout.drawCellValuesOnBoard(screen)
+	// 畫出盤面格線
+	gameLayout.drawLinesOnBoard(screen)
+}
+
+// drawBoardBackground - 畫出盤面背景顏色
+func (gameLayout *GameLayout) drawBoardBackground(screen *ebiten.Image) {
+	boardBgColor := color.RGBA{0xFF, 0xFF, 0xFF, 0xFF}
+	boardBackground := ebiten.NewImage(ScreenWidth, ScreenHeight)
+	boardBackground.Fill(boardBgColor)
+	screen.DrawImage(boardBackground, nil)
+}
+
+// drawCellValuesOnBoard - 根據遊戲狀態來畫出盤面
+func (gameLayout *GameLayout) drawCellValuesOnBoard(screen *ebiten.Image) {
+	board := gameLayout.gameInstance.Board
+	for row := 0; row < game.BoardSize; row++ {
+		for col := 0; col < game.BoardSize; col++ {
+			// draw preset value
+			if board.Cells[row][col].Type == game.Preset {
+				gameLayout.drawCellBackground(screen, row, col, getTileBgColor(board.Cells[row][col].Type))
+				gameLayout.drawCellValue(screen, row, col, board.Cells[row][col].Value,
+					getTileColor(board.Cells[row][col].Type),
+				)
+			}
+			// TODO: draw input
+		}
+	}
+}
+
+// drawLinesOnBoard - 畫出目前盤面所需要的格線
+func (gameLayout *GameLayout) drawLinesOnBoard(screen *ebiten.Image) {
+	// 畫出盤面格線
+	for i := 0; i <= game.BoardSize; i++ {
+		x := i * cellSize
+		y := i * cellSize
+
+		// 預設是細線
+		var lineColor color.Color = color.RGBA{0x77, 0x77, 0x77, 0xFF}
+		lineWidth := leanLineWidth
+		if i%3 == 0 {
+			lineColor = color.Black
+			lineWidth = thinkLineWidth
+		}
+		// 畫直線
+		ebitenUtilDrawLine(screen, x, 0, x, ScreenHeight, lineColor, lineWidth)
+		// 畫橫線
+		ebitenUtilDrawLine(screen, 0, y, ScreenWidth, y, lineColor, lineWidth)
+	}
+}
+
+// ebitenUtilDrawLine - 劃線，從 x1,y1 到 x2, y2 並且寬度為 width
+func ebitenUtilDrawLine(screen *ebiten.Image, x1, y1, x2, y2 int,
+	lineColor color.Color, width int) {
+	img := ebiten.NewImage((x2-x1)+width, (y2-y1)+width)
+	img.Fill(lineColor)
+
+	op := &ebiten.DrawImageOptions{}
+	op.GeoM.Translate(float64(x1), float64(y1))
+	screen.DrawImage(img, op)
+}
+
+func (gameLayout *GameLayout) Layout(outsideWidth, outsideHeight int) (int, int) {
+	return ScreenWidth, ScreenHeight
+}
+
+func NewGameLayout() *GameLayout {
+	gameInstance := game.NewGame()
+	gameInstance.Board.GenerateSolution()
+	defaultDifficulty := game.Easy
+	gameInstance.Board.MakePuzzleFromSolution(int(defaultDifficulty))
+	return &GameLayout{
+		gameInstance: gameInstance,
+		difficulty:   defaultDifficulty,
+	}
+}
+
+// drawCellValue - 畫出 click 之後顯示出來的值
+func (*GameLayout) drawCellValue(screen *ebiten.Image, row, col, value int, numColor color.Color) {
+	// 繪製數字 (置中)
+	textValue := fmt.Sprintf("%d", value)
+	textXPos := col*cellSize + (cellSize)/2
+	textYPos := row*cellSize + (cellSize)/2
+	if col%3 == 0 {
+		textXPos += thinkLineWidth
+	} else {
+		textXPos += leanLineWidth
+	}
+	if row%3 == 0 {
+		textYPos += thinkLineWidth
+	} else {
+		textYPos += leanLineWidth
+	}
+	textOpts := &text.DrawOptions{}
+	textOpts.ColorScale.ScaleWithColor(numColor)
+	textOpts.PrimaryAlign = text.AlignCenter
+	textOpts.SecondaryAlign = text.AlignCenter
+	textOpts.GeoM.Translate(float64(textXPos), float64(textYPos))
+	text.Draw(screen, textValue, &text.GoTextFace{
+		Source: mplusFaceSource,
+		Size:   30,
+	}, textOpts)
+}
+
+// drawCellBackground - 繪圖出目前盤面的情況
+func (*GameLayout) drawCellBackground(screen *ebiten.Image, row, col int, bgColor color.Color) {
+	xPos := col * cellSize
+	yPos := row * cellSize
+	if col%3 == 0 {
+		xPos += thinkLineWidth
+	} else {
+		xPos += leanLineWidth
+	}
+	if row%3 == 0 {
+		yPos += thinkLineWidth
+	} else {
+		yPos += leanLineWidth
+	}
+	vector.DrawFilledRect(
+		screen,
+		float32(xPos),
+		float32(yPos),
+		cellSize-1,
+		cellSize-1,
+		bgColor,
+		false,
+	)
+}

Original file line number	Diff line number	Diff line change
`@@ -23,12 +23,12 @@ func NewBoard() *Board {`
`23`	`23`
`24`	`24`	`// Game - 遊戲結構`
`25`	`25`	`type Game struct {`
`26`		`- board *Board`
	`26`	`+ Board *Board`
`27`	`27`	`}`
`28`	`28`
`29`	`29`	`// NewGame - 建構遊戲結構`
`30`	`30`	`func NewGame() *Game {`
`31`	`31`	`return &Game{`
`32`		`- board: NewBoard(),`
	`32`	`+ Board: NewBoard(),`
`33`	`33`	`}`
`34`	`34`	`}`