Cambios documentación

src/pong/entities/Pelota.java

@@ -4,8 +4,7 @@
 import pong.vistas.Pista;
 
 /**
- * Esta clase representa la pelota del juego, es movida 
- * por un hilo.
+ * Esta clase representa la pelota del juego, es movida por un hilo.
  * 
  * @author javier
  */

src/pong/ui/EventoTeclado.java

@@ -5,8 +5,8 @@
 import java.awt.event.KeyEvent;
 
 /**
- * Esta clase recoge los eventos de teclado y permite 
- * mover las raquetas de manera sincronizada.
+ * Esta clase recoge los eventos de teclado y permite mover las raquetas de 
+ * manera sincronizada.
  * 
  * @author javier
  */

src/pong/ui/VentanaInicio.java

@@ -6,6 +6,11 @@
 import pong.vistas.Menu;
 import pong.vistas.Opciones;
 
+/**
+ * Esta ventana muestra el menú y las opciones del juego.
+ * 
+ * @author javier
+ */
 public class VentanaInicio extends JFrame {
 
     private JPanel menu, opciones;

src/pong/ui/VentanaJuego.java

@@ -5,8 +5,7 @@
 import javax.swing.JFrame;
 
 /**
- * Esta clase crea la ventana perincipal en la que se verá
- * el juego.
+ * Esta clase crea la ventana en la que se mostrará el juego.
  * 
  * @author javier
  */

src/pong/vistas/Menu.java

@@ -1,28 +1,29 @@
 package pong.vistas;
 
-import java.awt.CardLayout;
 import java.awt.Color;
 import java.awt.Font;
 import java.awt.event.MouseEvent;
 import java.awt.event.MouseListener;
-import javax.swing.JFrame;
 import javax.swing.JLabel;
 import javax.swing.JPanel;
 import javax.swing.SwingConstants;
 import pong.ui.VentanaInicio;
 
 /**
+ * En esta ventana se muestra el tútulo del juego y las opciones de jugar o
+ * salir.
  *
  * @author javier
  */
 public class Menu extends JPanel implements MouseListener {
+
     private JLabel jTitulo, jJuego, jSalir;
-    
+
     public Menu() {
         inicializar();
         estilos();
         posicionar();
-        
+
         add(jTitulo);
         add(jJuego);
         add(jSalir);
@@ -32,69 +33,69 @@ private void inicializar() {
         this.jTitulo = new JLabel("Pong", SwingConstants.CENTER);
         this.jJuego = new JLabel("Jugar", SwingConstants.CENTER);
         this.jSalir = new JLabel("Salir", SwingConstants.CENTER);
-        
+
         jJuego.addMouseListener((MouseListener) this);
         jSalir.addMouseListener((MouseListener) this);
     }
-    
+
     private void estilos() {
         setSize(600, 400);
         setBackground(Color.BLACK);
-        
+
         jTitulo.setFont(new Font("Vintage", Font.BOLD, 60));
         jJuego.setFont(new Font("Vintage", Font.BOLD, 25));
         jSalir.setFont(new Font("Vintage", Font.BOLD, 25));
-        
+
         jTitulo.setForeground(Color.WHITE);
         jJuego.setForeground(Color.WHITE);
         jSalir.setForeground(Color.WHITE);
     }
-    
-    private void posicionar(){
+
+    private void posicionar() {
         setLayout(null);
-        
+
         jTitulo.setSize(200, 100);
-        jTitulo.setLocation((getWidth() - jTitulo.getWidth())/2, 20);
-        
+        jTitulo.setLocation((getWidth() - jTitulo.getWidth()) / 2, 20);
+
         jJuego.setSize(200, 100);
-        jJuego.setLocation((getWidth() - jTitulo.getWidth())/2, 140);
-        
+        jJuego.setLocation((getWidth() - jTitulo.getWidth()) / 2, 140);
+
         jSalir.setSize(200, 100);
-        jSalir.setLocation((getWidth() - jTitulo.getWidth())/2, 240);
+        jSalir.setLocation((getWidth() - jTitulo.getWidth()) / 2, 240);
     }
 
     @Override
     public void mouseClicked(MouseEvent e) {
         VentanaInicio v = (VentanaInicio) this.getTopLevelAncestor();
-        
-        if (e.getSource().equals(jJuego)){
+
+        if (e.getSource().equals(jJuego)) {
             v.siguiente();
-            
-        }else if (e.getSource().equals(jSalir)){
+
+        } else if (e.getSource().equals(jSalir)) {
             System.exit(0);
         }
     }
 
     @Override
-    public void mousePressed(MouseEvent e) {}
+    public void mousePressed(MouseEvent e) { }
 
     @Override
-    public void mouseReleased(MouseEvent e) {}
+    public void mouseReleased(MouseEvent e) { }
 
     @Override
     public void mouseEntered(MouseEvent e) {
-        if (e.getSource().equals(jJuego)){
+        if (e.getSource().equals(jJuego)) {
             jJuego.setForeground(new Color(219, 219, 219));
-        }else if (e.getSource().equals(jSalir)){
+        } else if (e.getSource().equals(jSalir)) {
             jSalir.setForeground(new Color(219, 219, 219));
         }
     }
 
     @Override
     public void mouseExited(MouseEvent e) {
-        if (e.getSource().equals(jJuego)){
+        if (e.getSource().equals(jJuego)) {
             jJuego.setForeground(Color.WHITE);
-        }else if (e.getSource().equals(jSalir)){
+        } else if (e.getSource().equals(jSalir)) {
             jSalir.setForeground(Color.WHITE);
         }
     }

src/pong/vistas/Opciones.java

@@ -9,10 +9,13 @@
 import pong.ui.VentanaJuego;
 
 /**
+ * Esta vista muestra la opcines para iniciar el juego. Estas opciones son el
+ * tamaño de la pista y la velocidad de la pelota.
  *
  * @author javier
  */
 public class Opciones extends JPanel implements MouseListener {
+
     private ButtonGroup grupoPantalla, grupoVelocidad;
     private JRadioButton jRadioGrande, jRadioLenta, jRadioModerada, jRadioNormal,
             jRadioPeque, jRadioRapida;
@@ -22,7 +25,7 @@ public Opciones() {
         inicializar();
         estilo();
         posicionar();
-        
+
         add(jRadioGrande);
         add(jRadioNormal);
         add(jRadioPeque);
@@ -32,18 +35,18 @@ public Opciones() {
         add(jTamanio);
         add(jVelocidad);
         add(jIniciar);
-        
+
         jRadioPeque.setSelected(true);
         jRadioModerada.setSelected(true);
-        
+
         grupoPantalla.add(jRadioGrande);
         grupoPantalla.add(jRadioNormal);
         grupoPantalla.add(jRadioPeque);
         grupoVelocidad.add(jRadioRapida);
         grupoVelocidad.add(jRadioModerada);
         grupoVelocidad.add(jRadioLenta);
     }
-    
+
     private void inicializar() {
         grupoPantalla = new ButtonGroup();
         grupoVelocidad = new ButtonGroup();
@@ -55,14 +58,14 @@ private void inicializar() {
         jRadioLenta = new JRadioButton("Lenta");
         jTamanio = new JLabel("Tamaño pantalla");
         jVelocidad = new JLabel("Velocidad pelota");
-        jIniciar = new JLabel ("Iniciar");
+        jIniciar = new JLabel("Iniciar");
     }
-    
+
     private void estilo() {
         setBackground(Color.BLACK);
         setSize(600, 400);
         setLayout(null);
-        
+
         jRadioGrande.setForeground(new java.awt.Color(255, 255, 255));
         jRadioGrande.setBackground(Color.BLACK);
 
@@ -86,11 +89,11 @@ private void estilo() {
 
         jVelocidad.setFont(new java.awt.Font("Vintage", Font.BOLD, 14));
         jVelocidad.setForeground(new java.awt.Color(255, 255, 255));
-        
+
         jIniciar.setFont(new Font("Vintage", Font.BOLD, 20));
         jIniciar.setForeground(new java.awt.Color(255, 255, 255));
     }
-    
+
     private void posicionar() {
         jVelocidad.setBounds(151, 183, 140, 17);
         jTamanio.setBounds(151, 100, 140, 17);
@@ -100,7 +103,7 @@ private void posicionar() {
         jRadioRapida.setBounds(357, 218, 90, 19);
         jRadioPeque.setBounds(151, 135, 90, 19);
         jRadioNormal.setBounds(254, 135, 90, 19);
-        jIniciar.setBounds((getWidth() - 100)/2, 250, 
+        jIniciar.setBounds((getWidth() - 100) / 2, 250,
                 100, 100);
         jIniciar.addMouseListener(this);
     }
@@ -109,7 +112,7 @@ private void posicionar() {
     public void mouseClicked(MouseEvent e) {
         VentanaJuego vj;
         VentanaInicio vi = (VentanaInicio) this.getTopLevelAncestor();
-        
+
         if (e.getSource().equals(jIniciar)) {
             if (jRadioNormal.isSelected()) {
                 vj = new VentanaJuego(900, 600);
@@ -118,36 +121,38 @@ public void mouseClicked(MouseEvent e) {
             } else {
                 vj = new VentanaJuego(600, 400);
             }
-            
+
             if (jRadioModerada.isSelected()) {
                 vj.establecerVelocidad(30);
             } else if (jRadioRapida.isSelected()) {
                 vj.establecerVelocidad(20);
             } else {
                 vj.establecerVelocidad(40);
             }
-            
+
             vj.setVisible(true);
             vi.dispose();
         }
     }
 
     @Override
-    public void mousePressed(MouseEvent e) { }
+    public void mousePressed(MouseEvent e) {
+    }
 
     @Override
-    public void mouseReleased(MouseEvent e) { }
+    public void mouseReleased(MouseEvent e) {
+    }
 
     @Override
     public void mouseEntered(MouseEvent e) {
-        if (e.getSource().equals(jIniciar)){
+        if (e.getSource().equals(jIniciar)) {
             jIniciar.setForeground(new Color(219, 219, 219));
         }
     }
 
     @Override
     public void mouseExited(MouseEvent e) {
-        if (e.getSource().equals(jIniciar)){
+        if (e.getSource().equals(jIniciar)) {
             jIniciar.setForeground(Color.WHITE);
         }
     }

src/pong/vistas/Pista.java

@@ -9,8 +9,8 @@
 import pong.entities.Raqueta;
 
 /**
- * Esta clase crea la pista de juego, en ella se dibujarán las
- * raquetas, la bola y los marcadores.
+ * Esta clase crea la pista de juego, en ella se dibujarán las raquetas, la bola 
+ * y los marcadores.
  * 
  * @author javier
  */