MarioCraft

Autores:

Jorge Cárdenas Cárdenas
Ricardo Antonio Hernández Torres
Samuel Arturo Garrido Sánchez

Manual técnico

Para consultar el manual técnico pique aquí

Ejecutable

Dentro del archivo Ejecutable.zip, existe el archivo MarioCraft.exe que se puede ejecutar simplemente con doble click.

Tiene un ícono de honguito.

INSTRUCCIONES PARA COMPILAR:

PASO 1:

Abrir el proyecto de Visual Studio (MarioCraft.vcxproj)

PASO 2:

SELECCIONAR ARQUITECTURA x86, si se elige x64 habrá un error inicial.

PASO 3:

Abrir las propiedades del proyecto:

En DEPURACIÓN hacer click en ENTORNO
- Hacer click en editar y agregar la siguiente entrada:
PATH=$(ProjectDir)dll

En caso de existir un error al compilar, asegurarse que se encuentren las siguientes configuraciones.

Ir a Propiedades de Configuración del Proyecto y colocar las siguientes configuraciones:

En C/C++ >> General, en la opción Dirección de inclusión adicicionales hacer click en editar y agregar en el mismo orden las siguientes entradas:
- $(SolutionDir)src\headers
- $(SolutionDir)include
- $(SolutionDir)include\SFML
- $(SolutionDir)include\ASSIMP
- $(SolutionDir)include\GLAD
- $(SolutionDir)include\GLFW
- $(SolutionDir)include\GLM
- $(SolutionDir)include\KHR
- $(SolutionDir)include\SDL
En Vinculador >> General, en la opción Dirección de bibliotecas adicicionales hacer click en editar y agregar las siguientes entradas:
- $(SolutionDir)lib\SFML
- $(SolutionDir)lib\SDL2
- $(SolutionDir)lib\GLFW3
- $(SolutionDir)lib\ASSIMP
En Vinculador >> Entrada, en la opción Dependencias adicicionales hacer click en editar y agregar las siguientes entradas:
- opengl32.lib
- glfw3.lib
- assimp-vc141-mtd.lib
- SDL2.lib
- SDL2main.lib
- sfml-main-d.lib
- sfml-graphics-d.lib
- sfml-system-d.lib
- sfml-window-d.lib
- sfml-audio-d.lib

Estructura general del proyecto

El proyecto fue generado utilizando el paradigma Orientado a Objetos de tal manera que cada elemento colocado en pantalla es una clase y algunos heredan atributos y métodos para que el proyecto sea más escalable y mejor estructurado.

dll: Bibliotecas de Enlaces Dinámicos
include: Bibliotecas generales del proyecto (headers)
lib: Bibliotecas de Enlaces Estáticos
resources: Modelos, imágenes y sonidos.
shaders: Scripts del GPU
src: Archivos fuente
- headers: Definición de las clases del proyecto.
  - Model3D.h (Clase general de todos los modelos, mejora las transformaciones, hereda de Model.h)
  - StaticModel.h (Clase para objetos estáticos, heredada de Model3D)
  - DynamicModel.h (Clase para objetos dinámicos, heredada de Model3D)
  - sound.h (Clase para el audio)
  - MarioCraft.h (Encabezado general del objeto del plano)
  - ModelManager. (Controlador de los modelos, para mandarlos al shader)
  - Lightning.h (Clase de la luz diurna)
  - Camera.h (Clase de la cámara)
  - Golem.h
  - Dragon.h
  - Kart.h
  - Peach.h
  - JumpAnimation.h (Clase para saltos generales)
  - MobMinecraft (Clase general de mobs de minecraft, para caminar solamente)
  - Vaca.h
  - Creeper.h
  - Moneda.h
- sources: Contenido de las clases del proyecto.
- main.cpp: Archivo principal, instancia las clases que conforman el proyecto.
MarioCraft.sln: Archivo de solución
MarioCraft.vcxproj: Archivo del proyecto.

Interacciones con el ambiente

1: Cámara
- Para moverse por el escenario, se cuenta con una cámara que se puede mover usando la siguiente configuración de teclas y mouse.
  - W : Arriba
  - S : Abajo
  - D : Derecha
  - A : Izquierda
  - Scroll mouse: Acerca y Aleja
  - Puntero mouse: Ángulo de la cámara
2: Carrera de autos
- Para realizar la animación de carrera de autos:
  - Barra espaciadora: Iniciar animación (se reproduce sonido).