Usando la librería

Usando liquidos.h

liquidos.h está basado en waterelement.h, una librería desarrollada por Emily Short para su juego Savoir-Faire. Esta adaptación se ha hecho a partir de una librería considerada como beta, por lo que estaría bien comunicarle a Emily Short cualquier anomalía detectada, e incluso felicitarla por el trabajo en su e-mailemshort@mindspring.com. La adaptación la ha realizado dhan con la ayuda de Zak. Cualquier comentario también será bien recibido en mi e-mail dhan@interlap.com.ar

Esta distribución incluye liquidos.h, estas instrucciones y un juego mínimo para probar las nuevas funcionalidades de la librería, llamado chapuzon.inf

Esta librería puede ser usada libremente en tus juegos en Inform. Emily agradecería que su trabajo apareciera en los créditos.

Configuración básica
Creando un nuevo objeto líquido
Objetos flotantes
Absorbentes
Recipientes
Lista completa de mejoras

Configuración Básica

Incluye "liquidos" después de eParser, pero antes de Acciones
En la rutina de Inicializar llama a Inicio_Liquidos();
Después de incluir Gramatica, añade esta línea:
Extend 'estruja' * noun 'en' noun -> RetorcerEn;
Si tus localidades son de la clase "Habitacion", se crearán charcos al derramar agua sobre el suelo.

Creando un líquido

Para hacer un nuevo líquido debes declararlo de la clase Liquido. Este ejemplo está tomado del juego Savoir-Faire;de paso agradecemos a Emily que haya promocionado un alimento andaluz en este tutorial ;-)

Liquido aceite_oliva "aceite de oliva" with nombre_especifico "aceite de oliva", nombre 'aceite' 'oliva', descripcion [; "De color amarillo claro y viscoso."; ], has comestible;

Las propiedades especiales que un líquido puede tener son:

nombre_especifico. Usamos este nombre en lugar de nombre_corto porque este último ya lo usa la librería. Todos los líquidos deben tener la propiedad nombre_especifico.
cantidad. La cifra indica cuánto líquido hay.
- Menos de 40 se describe como "no demasiado";
- Menos de 100 como"un poco";
- De 100 a 500 como"una gran cantidad".
- Si el jugador bebe, se consumirá entre 10 y 20 unidades por trago.

SaborMezclado. Es opcional; si se usa te dirá a qué sabe el liquido al mezclarse con otros.

SaborMezclado usará las descripciones del líquido que predomina en la mezcla .
SaborMezclado toma un argumento del próximo líquido que prevalece en la mezcla.

Por ejemplo, el vino de Savoir-Faire tiene la siguiente rutina:

SaborMezclado [ other; switch(other) { aceite_oliva: "More of a salad dressing than a beverage."; agua: "Aunque predomina el sabor del vino, está claro que
algo de agua hay en la mezcla. Juego de niños. Tras beberlo
te sientes reconfortado."; te_menta: "Tras un momento de concentración, te diriges a engullirlo. El efecto es extrañamente balsámico."; } ];

Si quieres mover líquidos a otros recipientes, la instrucción es del tipo liquido.deploy([nuevo recipiente], [cantidad de unidades a mover]). El proceso se ocupará de crear nuevos objetos líquidos si es necesario, mezclarlo con lo que hubiera allí o mojar los objetos sólidos, etc.
Si quieres crear algunos líquidos en un recipiente nuevo (imagina que tienes un hechizo que copia el líquido de un recipiente en otro pero sin que desaparezca el original), puedes invocar la rutina CopiarLiquidos([líquido original a copiar], [cantidad de unidades del nuevo liquido], [recipiente al que se copia]). Así por ejemplo CopiarLiquidos(leche, 5, jarra_azul) creará 5 unidades de leche en la jarra azul.
Si quieres eliminar algún líquido del juego, no uses REMOVE LIQUIDO. Llama a liquido.evaporar (); además de llevarse el líquido del árbol de objetos, reiniciará el objeto como si fuera generado dinámicamente.

Si quieres emular algún objeto basado en polvos en vez de líquidos, puedes usar esta clase también, dandole a este tipo de objetos el atributo ~humedo. No hará que floten, pero si reaccionarán al mezclarse con líquidos; la mezcla de polvos permanecerá seca hasta que se le añada un líquido. (Nota que las proporciones no se vigilan en este aspecto: podrías añadir agua con un cuentagotas a un saco de harina y el resultado se considerará húmedo. Habrá que vigilar si esto será importante en tu juego.)

Por ejemplo:

Liquido harina "harina", with cantidad 50, nombre "harina", nombre_especifico "harina", articulo "Cierta cantidad de", descripcion [; "Harina bien tamizada."; ], has ~humedo comestible;

Objetos flotantes (sí identificados)

Cualquier objeto que reciba el atributo de "flotador", flotará al estar en líquido. Por ejemplo, sacado del ejemplo chapuzon.h:

Object patito "patito de goma" Laboratorio,
with nombre 'pato' 'patito' 'amarillo' 'goma' 'adorable',
describir [;
if (self has flotante)
"^Tu querido patito de goma flota muy contento.";
"^Tu querido patito de goma está tirado a tus pies.";
],
descripcion [;
"Un adorable patito de goma ha evitado de alguna forma caer a la
cuba de ácido. Al menos, por el momento...";
],
has flotador;

Absorbentes

Cualquier objeto que reciba el atributo de "absorbente", se comportará como tal. Este objeto viene en la librería por defecto:

Absorbente esponja "esponja",	 
	with nombre 'esponja',
	Tamano 1,
	despues [;
		Empapar: give self general; rfalse;
	],
	descripcion [;
		print "Una esponja, del tamaño y forma de una manza. Actualmente está ";
		if (self has humedo) "goteando.";
		if (self has general) "ligeramente humedecida.";
		"seca.";
	],
	has femenino;

Por defecto, un objeto absorbente absorberá 50 unidades de líquido. Puedes cambiar esto dandole la propiedad absorcion seguida de una cantidad. Una esponja con un nivel 3 de absorcion no será especialmente útil (puede que sea una esponja muy pequeñita)
Atención: debido a la forma en que los absorbentes siguen el rastro de los líquidos que absorben, hacer a un objeto de la clase absorbente recipiente o soporte puede generar problemas. Hasta el momento no se han necesitado, por lo que es un camino inexplorado.

Recipientes

Cualquier recipiente del juego puede contener líquidos, como debe ser normal.

Si deseas hacer tu propia regla sobre esto (quizá tienes un montón de envoltorios que no deseas que el jugador llene con sus líquidos), debes usar el punto de entrada ContenedorMalo. Define la rutina ContenedorMalo tras incluir Liquidos.h. Debería tomar un argumento, el recipiente que se examina, y devolverá false en el caso de que que recipiente sea correcto; de otra forma arrojará un mensaje negativo. Por ejemplo:

[ContenedorMalo x; if (x ofclass prenda) {
if (tate_callao) rtrue; "", (_El) x, " tiene demasiadas vías de escape."; } rfalse; ];

Puede ocurrir que quieras incluir objetos con un tamaño como propiedad. Si esto ocurre, el juego usará esta información para manejar la capacidad de los recipientes y ver si caben o no. (Nota: esto no interfiere con la colocación de objetos sólidos. Solo afecta a verter líquidos y si el juego cree que hay bastante espacio para ellos.)

Si deseas usar tamaños, pero quieres asignar a un objeto una capacidad superior de la que pudiera tener, puedes añadir la propiedad porosidad. Por ejemplo:

Object conducto "conducto muy profundo" Laboratorio,
with
inicial [;
"Un conducto muy profundo corre a lo largo de un lateral de la habitación.";
],
nombre 'conducto' 'profundo',
porosidad [;
! Da igual el tamaño que aparente, aceptará líquidos siempre
return 10000;
],
has recipiente abierto ~abrible;

Si deseas usar un recipiente que pierda lentamente parte de su contenido por un periodo largo de tiempo, puedes usar la propiedad goteo. Goteo se llama una vez que el recipiente está lleno, y después cada turno que el recipiente continua teniendo líquido (incluyendo el turno en el que fue llenado) Por ejemplo, un recipiente que pierde líquido poco a poco podría ser éste:

Object jarro "jarro", with nombre 'jarro', porosidad [; return 200; ], goteo [ liq flag par; if (flag==0) rfalse;
liq.cantidad = liq.cantidad-5; if (PruebaDeAlcance(self)) { new_line; if (liq.cantidad) print "Algo de ", (el) liq; else print (_El) liq; print " gotea fuera.^"; } if (liq.cantidad< 1) liq.evaporar(); ], has abierto recipiente ~abrible;

También puedes usar goteo para hacer que un recipiente pierda líquido cada turno. Hacer esto es más complicado de lo que puedas pensar, desafortunadamente. Sin embargo, este uso específico de la propiedad goteo ha hecho que se incluya una clase especial para este uso, llamada Poroso, que puedes añadir de esta forma:

Poroso recipiente_poroso "recipiente poroso", with nombre 'recipiente' 'poroso', porosidad [; return 200; ], poro 10, has abierto ~abrible;

La propiedad Poro de un objeto poroso indica cuánto fluirá cada turno. Por defecto son 5 unidades.
La propiedad describe_goteo de un objeto poroso dará una descripción apropiada del caudal de goteo. De todas formas puedes cambiarla sin tener que reemplazar la propiedad porosidad por completo.

Goteo se llama con dos argumentos: el líquido que contine, y una bandera. Si la bandera se pone a 0 es que el recipiente se acaba de llenar (por ejemplo, podemos querer dar una descripción al acabar de llenarlo) y 1 en ocasiones posteriores.
Nota que Goteo no necesita un mensaje para imprimir cada turno, quizá lo encuentres raro; podrías también hacer un mensaje que se imprima mediante un random sólo cada tres turnos o con el intervalo que consideres oportuno.

Resumen de mejoras de la librería:

Un objeto líquido posee las propiedades de
- cantidad (cuánto hay)
- fuente (de qué líquido procede originalmente)
Un líquido puede poseer los atributos de
- humedo (los líquidos no-húmedos son polvos, ver más adelante)
- comestible (sólo los líquidos comestibles pueden beberse)
Los líquidos pueden almacenarse en recipientes no porosos
- Mientras los líquidos están en el inventario, el contenido de un recipiente se describirá con la información de cómo de lleno está.
- Si existen dificultades para desambiguar entre líquidos del mismo nombre, el juego preguntará al jugador (y entenderá la respuesta) de "¿te refieres al agua de la copa o a la de la jarra?"
  - Para evitar molestias, el agua no se nombrará más rutinariamente como "el agua de la jarra"
- Los recipientes abiertos con líquido no se pueden poner en el saco de objetos del juego
- Si un recipiente abierto se arroja o se golpea, derramará líquido.
- Si se rompe el recipiente, el líquido se derramará.
Los líquidos son divisibles; se pueden almacenar en distintas cantidades en distintos recipientes.
- Al beber un líquido se quitará una cantidad variable dentro de un rango. Esto previene al jugador de resolver puzzles que impliquen medidas exactas y no podrá medir el líquido en tragos exactos.
  - Los tragos de distinto tamaño se describirán al azar como tragos cortos, tragos, o gran trago, de manera que el jugador conserve una cierta sensación de cuánto ha bebido
- Al verter líquidos de un recipiente a otro se comprueba la capacidad del nuevo. Si es menor (incluyendo objetos sólidos o líquidos que pudiera haber dentro) que lo que la cantidad de líquido a introducir demanda, se dividirá el líquido original.
- Un recipiente puede tener definida una rutina de goteo. Si la tiene, el líquido llamará a esta rutina cada turno para determinar si debe hacer algo.
  - La rutina de goteo puede usarse para simular efectos de desaparición gradual de líquido como evaporarse o fluir a otro segmento, como por ejemplo unas tuberías.
Los líquidos pueden mezclarse
- Las mezclas de líquidos 'recuerdan' lo que contiene y en que porcentaje contiene esos componentes:
  - La degustación de mezclas de líquidos ofrece una descripción por defecto que menciona los dos líquidos que prevalecen en la mezcla.
    - Es posible superar esta opción con una rutina que dé un mensaje individual con una descripción específica de la mezcla de dos o más sabores específicos.
- Combinar dos líquidos de la misma fuente hace que se conviertan en uno solo y no se use la terminología de "mezcla"
- Una mezcla de líquidos se señala como 'comestible' si los componentes usados lo eran
Algunos materiales son capaces de flotar
- Verter un líquido en un recipiente que contenga un objeto flotador hará que automáticamente ese objeto flote a la superficie
Algunos materiales son absorbentes
- Colocar un objeto de la clase absorbente en un líquido o verter un líquido sobre él hará que éste se vuelva húmedo
- Los objetos absorbentes recuerdan qué tipo de líquido contienen
- Retorcer o estrujar un objeto absorbente hará que se seque
  - Retorcer un objeto absorbente sobre un recipiente moverá una cantidad apropiada de líquido dentro del recipiente
  - Retorcer un objeto absorbente húmedo sobre otro, hará que el otro se humedezca
Los polvos están simulados como líquidos secos
- Los objetos que floten no flotarán a la superficie con polvos
- Los objetos absorbentes no absorberan polvos
- Las mezclas se volverán húmedas tan pronto que algún líquido 'húmedo' se añada a ellas; de otra forma permanecerán como mezclas en seco.
Las localidades funcionan como un recipiente
- Verter líquidos al suelo hará que se mezclen en charcos
- Se previene al jugador de que no es aconsejable beber líquidos directamente del suelo.
- Los charcos de una localidad no harán que los objetos allí situados floten