Imaginate es un lenguaje pensado tanto para produccion de imagenes, como para el proceso creativo del diseñador grafico. Mediante el lenguaje, podras crear de forma deterministica, pudiendo aplicar operaciones como filtros, efectos, flavours, etc. Si no que tambien permite crear imagenes de forma no deterministica, es decir, poder obtener una imagen producto de un pool de filtros, efectos y demas, donde se aplicaran los dichos de forma aleatoria.
Primero es necesario hacer un pull de la siguiente imagen de docker. La cual es cortesia del grupo de Alejo Flores Lucey, al cual agradecemos por compartirnos dicha imagen de docker con todo configurado para poder compilar ambos proyectos.
$ docker pull alejofl/tla-compiler
Para construir el proyecto por completo, ejecute en la raíz del repositorio los siguientes comandos:
$ chmod u+x --recursive script
$ docker run -v "${PWD}:/root" -ti --rm alejofl/tla-compiler
$ ./script/build.sh
Este comando va a abrir una sesion en el contenedor donde se va podra correr los scripts .sh directamente desde ahi.
Nota: El docker de Alejo Flores Lucey ha sido actualizado para incluir las dependencias necesarias. Por lo que puede ser necesario actualizar dicha imagen previamente descargada. > Simplemente seria hacer un nuevo docker pull alejofl/tla-compiler. Nuevamente, muchas gracias al Grupo de Alejo.
Para compilar un programa, primero cree un archivo vacío denominado program
(o el nombre que desee), con el siguiente contenido:
Imaginate
.addFocus("./Hola")
.addContrast()
.renderAll()
Luego, ejecute el compilador indicando el path hacia el script start.sh
y pasando por parámetro el path hacia el programa a compilar:
root@docker-session:path/ $ ./script/start.sh program
Debería obtener el valor de retorno valido (0) para dicho programa. En caso de que se modifque la sintaxis del programa por una incorrecta, el valor de retorno sera diferente de 0.
El resultado sera un codigo en python que sera capaz de generar la imagen deseada. Para ejecutar dicho codigo puede hacerlo a mano:
$ python3 python3 generator.py
Alternativamente, a la hora de compilar el programa Imaginate se puede utilizar el flag '-x' para que dicho codigo Pyhton sea ejecutado automaticamente:
root@docker-session:path/ $ ./script/start.sh program -x
Para poder testear el correcto funcionamiento del compilador interpretando la sintaxis, se proveen en el directorio test casos de aceptacion y rechazo. Para validar esto, la catedra ha provisto el siguiente script ./script/test.sh
que tratara de compilar todos los casos de aceptacion y rechazo y mostrara por stdout en cuales se acepto y cuales se rechazo.
root@docker-session:path/ $ ./script/test.sh
Si desea agregar nuevos casos de uso, deberá crear un archivo por cada uno, que contenga el programa a testear dentro de las carpetas test/accept
o test/reject
según corresponda (es decir, si el mismo debe ser aceptado o rechazado por el compilador).
Para poder poner a prueba el compilador con casos de uso real, en el repositorio hay un directorio con ejemplos basicos en "./examples" que utilizan imagenes tambien presentes en el repositorio. Un ejemplo seria:
root@docker-session:path/ $ ./script/start.sh examples/basic -x
...
root@docker-session:path/ $ ./script/start.sh examples/customMethodAndObjects -x
...
root@docker-session:path/ $ ./script/start.sh examples/forEachFocus2objects -x
Notar el uso del flag -x para la generacion automatica de las imagenes.
Recordar ejectura dentro del docker