Mon, 27 Jul 2020 10:56:17 +0200
fixes some code inspection issues
1 /*
2 * Copyright 2013 Mike Becker. All rights reserved.
3 *
4 * Redistribution and use in source and binary forms, with or without
5 * modification, are permitted provided that the following conditions are met:
6 *
7 * 1. Redistributions of source code must retain the above copyright
8 * notice, this list of conditions and the following disclaimer.
9 *
10 * 2. Redistributions in binary form must reproduce the above copyright
11 * notice, this list of conditions and the following disclaimer in the
12 * documentation and/or other materials provided with the distribution.
13 *
14 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
15 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
16 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
17 * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
18 * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
19 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
20 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
21 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
22 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
23 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
24 * POSSIBILITY OF SUCH DAMAGE.
25 */
27 package de.uapcore.sudoku;
29 import javax.swing.*;
30 import java.awt.*;
31 import java.awt.image.BufferedImage;
33 /**
34 * A panel rendering the Sudoku field.
35 * <p>
36 * Cells are identified by zero-based indices from top-left to bottom-right.
37 */
38 public final class Field extends JPanel {
39 private final SudokuTextField[][] cells;
41 /**
42 * Constructs a new 9x9 Sudoku grid.
43 */
44 public Field() {
45 setBackground(Color.WHITE);
47 setLayout(new GridBagLayout());
48 GridBagConstraints c = new GridBagConstraints();
49 c.insets = new Insets(5, 5, 5, 5);
51 cells = new SudokuTextField[9][9];
52 for (int x = 0; x < 9; x++) {
53 for (int y = 0; y < 9; y++) {
54 cells[x][y] = new SudokuTextField();
55 c.gridx = x;
56 c.gridy = y;
57 add(cells[x][y], c);
58 }
59 }
60 }
62 /**
63 * Paints the grid and all contained cells.
64 *
65 * @param graphics the graphics context
66 */
67 @Override
68 public void paint(Graphics graphics) {
69 final int w = getWidth();
70 final int h = getHeight();
71 final int cw = w / 9;
72 final int ch = h / 9;
74 BufferedImage img = new BufferedImage(w, h, BufferedImage.TYPE_INT_RGB);
75 Graphics2D g = img.createGraphics();
76 g.setBackground(Color.WHITE);
77 g.clearRect(0, 0, w, h);
79 g.setColor(Color.BLACK);
80 g.drawRect(1, 1, w - 2, h - 2);
81 g.drawRect(2, 2, w - 4, h - 4);
82 for (int x = cw; x < w; x += cw) {
83 for (int y = ch; y < h; y += ch) {
84 g.drawLine(x, 2, x, h - 2);
85 g.drawLine(2, y, w - 2, y);
86 if ((x / cw) % 3 == 0) {
87 g.drawLine(x + 1, 2, x + 1, h - 2);
88 }
89 if ((y / ch) % 3 == 0) {
90 g.drawLine(2, y + 1, w - 2, y + 1);
91 }
92 }
93 }
95 graphics.drawImage(img, 0, 0, this);
96 super.paintChildren(graphics);
97 }
99 /**
100 * Checks whether a cell is empty
101 *
102 * @param x horizontal position
103 * @param y vertical position
104 * @return true if the cell is empty, false otherwise
105 */
106 public boolean isCellEmpty(int x, int y) {
107 return getCellValue(x, y) == 0;
108 }
110 /**
111 * Returns value of a specific cell.
112 *
113 * @param x horizontal position
114 * @param y vertical position
115 * @return the cell's value
116 */
117 public int getCellValue(int x, int y) {
118 return cells[x][y].getValue();
119 }
121 /**
122 * Sets the value of a specific cell.
123 *
124 * @param x horizontal position
125 * @param y vertical position
126 * @param v the cells value
127 * @throws IllegalArgumentException if v is not between 0 and 9
128 */
129 public void setCellValue(int x, int y, int v) {
130 cells[x][y].setValue(v);
131 }
133 /**
134 * Clears the value of a specific cell.
135 *
136 * @param x horizontal position
137 * @param y vertical position
138 */
139 public void clearCellValue(int x, int y) {
140 setCellValue(x, y, 0);
141 }
143 /**
144 * Sets the modified state of a specific cell.
145 *
146 * @param x horizontal position
147 * @param y vertical position
148 * @param modified the modified state
149 */
150 public void setCellModified(int x, int y, boolean modified) {
151 cells[x][y].setModified(modified);
152 }
154 /**
155 * Sets the modified state of all cells.
156 *
157 * @param modified the modified state
158 */
159 public void setAllCellsModified(boolean modified) {
160 for (int x = 0; x < 9; x++) {
161 for (int y = 0; y < 9; y++) {
162 cells[x][y].setModified(modified);
163 }
164 }
165 }
167 /**
168 * Checks whether any cell is modified.
169 *
170 * @return true if any cell is modified, false otherwise
171 */
172 public boolean isAnyCellModified() {
173 for (int x = 0; x < 9; x++) {
174 for (int y = 0; y < 9; y++) {
175 if (cells[x][y].isModified()) {
176 return true;
177 }
178 }
179 }
180 return false;
181 }
183 /**
184 * Clears all cells.
185 */
186 public void clear() {
187 for (int x = 0; x < 9; x++) {
188 for (int y = 0; y < 9; y++) {
189 cells[x][y].setValue(0);
190 }
191 }
192 }
194 /**
195 * Returns a square identified by square coordinates.
196 * <p>
197 * Cells within the square are identified by the same coordinate system.
198 *
199 * @param x horizontal position from 0 to 2
200 * @param y vertical position from 0 to 2
201 * @return a two-dimensional array containing the square cell values
202 * @throws IllegalArgumentException if the coordinates are out of bounds
203 */
204 public int[][] getSquare(int x, int y) {
205 if (x < 0 || x > 2 || y < 0 || y > 2) {
206 throw new IllegalArgumentException("Invalid square coordinates");
207 }
208 int[][] square = new int[3][3];
210 for (int u = 0; u < 3; u++) {
211 for (int v = 0; v < 3; v++) {
212 square[u][v] = getCellValue(3 * x + u, 3 * y + v);
213 }
214 }
216 return square;
217 }
219 /**
220 * Returns an entire row.
221 *
222 * @param y the row position
223 * @return an array containing the row values
224 * @throws IllegalArgumentException if y is not between 0 and 8
225 */
226 public int[] getRow(int y) {
227 if (y < 0 || y > 8) {
228 throw new IllegalArgumentException("Invalid row number");
229 }
230 int[] row = new int[9];
232 for (int x = 0; x < 9; x++) {
233 row[x] = getCellValue(x, y);
234 }
236 return row;
237 }
239 /**
240 * Returns an entire column
241 *
242 * @param x the column position
243 * @return an array containing the column values
244 * @throws IllegalArgumentException if x is not between 0 and 8
245 */
246 public int[] getColumn(int x) {
247 if (x < 0 || x > 8) {
248 throw new IllegalArgumentException("Invalid column number");
249 }
250 int[] column = new int[9];
252 for (int y = 0; y < 9; y++) {
253 column[y] = getCellValue(x, y);
254 }
256 return column;
257 }
258 }