

				Mus 48 v2.00. INSTRUCCIONES

ndice.
~~~~~~~
	* ndice.
	* Qu es esto? [Sumario].
	* Que lo sepas. [ADVERTENCIA].
	* Introduccin.
	* Cmo funciona.
	* Cmo se juega al mus.
	* No lo vern mis ojos... [Tud: (To Do, para ti, anglfilo)].
	* Let me talk about myself [Quin soy, mis gustos y aficiones, etc.].
	* rase una vez... [Versiones]
	* FIN.


Qu es esto? [Sumario].
~~~~~~~~~~~~~~~~~~~~~~~~
	El Mus 48 es una biblioteca que sirve para jugar al mus. Se necesitan
tantas calculadoras como jugadores y NO se puede jugar contra la calculadora
(todava ;-).

	La HP se encarga de repartir las cartas, sin que las calculadoras estn
conectadas! Por supuesto, se puede dar _mus_ tantas veces como lo requiera el
juego y el Mus 48 repartir las cartas de la baraja sin dar a dos jugadores la
misma carta, por ejemplo, el rey de copas. Y todo ello, insisto, sin conectar
las calculadoras!

	Aunque no sepas jugar al mus, te invito a que le eches un vistazo a
este juego de cartas. Slo por contemplar los naipes merece la pena. Ego dixit.


Que lo sepas. [ADVERTENCIA].
~~~~~~~~~~~~~~~~~~~~~~~~~~~~
	Advierto al lector que este captulo debe ser ledo con detenimiento,
pues soy ajeno al arte de ser claro para quien no quiere ser atento. Rousseau,
_el contrato social_.

	Todos los archivos de la biblioteca Mus 48 son propiedad (C) 1998 de
Rubn Prez.

	La biblioteca Mus 48 es de libre distribucin y fue  creada con el
objetivo de ser til, no obstante se distribuye tal cual, sin garanta de ningn
tipo, ni del programa, ni de la documentacin. El autor no se responsabiliza de
ningn fallo que el programa o la documentacin pueda tener, ni de ningn dao
que el programa o la documentacin pueda causar directamente o indirectamente.
La documentacin puede cambiar sin previo aviso.

	El permiso de  copia de la biblioteca completa, sin modificar, est
garantizado para todas las copias que no sean hechas o distribuidas obteniendo
un beneficio econmico de ello.


Introduccin.
~~~~~~~~~~~~~
	Suma de comprobacin: #18666d
	Tamao: 4732'5 bytes.

	La biblioteca est implementada en sys-RPL con un par de pequeas
rutinas en ml (machine lenguage). En principio debera funcionar en todas las
ROMs de las HP48G(X), si no es as hzmelo saber, no obstante ha sido probada
(satisfactoriamente ;) en las versiones P y R. En cuanto a las S(X)... pues no
s, si alguien ha perdido el juicio y quiere probar, que me lo cuente (lo del
juicio no, los tribunales son muy aburridos). Una cuestin ms, de los puertos
"fsicos" (como si existieran los puertos "psicolgicos"), han sido probados el
3 y el 6 sin problemas, de donde "sin problemas" debe de seguir siendo vlido
para los dems puertos. Por supuesto, yo la tengo en el 0 y "sin problemas".

	Supongamos que no sabes instalar una biblioteca en tu HP, Ya est bien!
A ver si aprendemos de una vez!  Miniinstrucciones:1) Pon la biblioteca en la
pila. 2) Pulsa el nmero [0]. 3) Pulsa la tecla [STO]. 4) Apaga y vuelve a
encender la calculadora. 5) Si todo falla, lete las instrucciones de la
calculadora.

	La gracia de este programa est en que las cartas se reparten sin
conectar las calculadoras, (bueno, a alguna gente tambin le parecen muy
graciosas las cartas en s mismas). Y la pregunta es cmo es eso posible? Lo
de repartir las cartas es bastante sencillo (lo de que los naipes induzcan a
risa es inexplicable).

	Bien, para seguir la explicacin supongamos que t eres el jugador 1 y
yo el 2. Al comenzar la partida cada uno de nosotros metemos en nuestra
calculadora la misma semilla generadora de nmeros aleatorios. En tu
calculadora y en la ma hay una lista de 40 nmeros, cada uno representa una
carta. Y empieza la partida. Tu calculadora coge 8 cartas (nmeros) al azar de
la lista, la ma tambin, y como le hemos metido la misma semilla tus 8 cartas
y las mas son las mismas. Hasta aqu las dos calculadoras hacen lo mismo.
Ahora tu HP coge las primeras 4 cartas de las 8 que tena y tira las 4 ltimas,
la ma hace lo contrario, tira las 4 primeras y coge las 4 ltimas. Aj! se
era el truco.

	Siguiendo la partida, hacemos mus, t tiras 1 y yo 4 cartas (es que no
tena nada, ni pares, ni juego, ni nada ;). Tu HP coger 5 cartas al azar de la
lista (ojo! La lista ahora NO tiene 40 nmeros, tiene 40-8=32 nmeros) y mi HP
coger las mismas 5 cartas de la baraja (es decir, de la lista de nmeros). Tu
HP coge la primera carta (t slo habas tirado una carta) y tira las otras 4,
la ma al revs, tira la primera carta y se queda con las otras 4 (recuerda, yo
haba tirado las cuatro cartas).

	sta es la explicacin de por qu no pueden salirnos cartas repetidas:
las que tienes t mi HP las ha tirado (y viceversa) y las cartas que ya han
aparecido no estn en la baraja (lista de nmeros) y en consecuencia no pueden
aparecer.


Cmo funciona.
~~~~~~~~~~~~~~
	Este programa se ha pretendido hacer a prueba de tontos. Aunque, cierto
es, hay tontos muy ingeniosos. As que los datos se meten a travs de plantillas
tpicas de la HP, con la ayuda en la parte inferior de la pantalla, y en muchas
ocasiones a travs de mens desplegables. Ergo te puedes saltar (?SKIP) lo que
queda de este apartado y leerlo ms tarde o cuando tengas terrorficos
problemas.

	*Primera pantalla. {Espero que no tengas terrorficos problemas, porque
esto te va a servir de poco}. Hay que meter un nmero real como semilla, sirve
cualquiera excepto el 0. Tambin hay que indicar el nmero total de jugadores
(2  4) y el nmero de jugador de cada uno (es obvio, cada jugador ha de tener
un 'nmero de jugador' diferente. 1, 2, 3  4 cuando jueguen 4 personas y 1 
2, cuando jueguen 2 personas). Se pulsa [ENTER] u [OK].

	*Pantalla principal. Aparecen en pantalla las cartas bocabajo. Y en la
parte inferior una serie de etiquetas que paso describir:
	- [FIN] Termina el juego.
	- [n] Donde n es tu nmero de jugador, pues eso, tu nmero de jugador.
	- [OTRA] Empieza una nueva partida. No es necesario meter una nueva
semilla generadora de nmeros aleatorios.
	- [np] Donde np es un nmero positivo. Esta etiqueta tiene el fondo
blanco y es un simple contador, se incrementa pulsando la tecla [+], se
decrementa pulsando la tecla [-] y se pone a 0 pulsando la tecla [DEL]. Para
gente de memoria limitada,  al pulsar la tecla correspondiente a la etiqueta
contador aparece en pantalla una ayuda.
	- [MUS] Da un mus, el funcionamiento de este comando lo explico ms
adelante.
	- [VER] A todo esto, las cartas siguen bocabajo, para verlas se pulsa
esta tecla. Para taparlas se pulsa la tecla [TAPAR] que est en el lugar que
antes ocupaba la tecla [VER].

	*El comando [MUS]:
	Pulsamos la tecla y aparece un cuadro de dilogo que te pregunta si
quieres tirar la 1 carta y un [S] y un [No] para que respondas. Lo mismo con
la 2, 3 y 4 carta.
	Tras decidir cules tiras y cules no aparece una curiosa plantilla
llamada "CUANTAS". Aqu en el campo correspondiente a tu nmero de jugador viene
un nmero de dos cifras junto a una representacin esquemtica y en los dems
campos pone "Elige cdigo". La primera cifra, la correspondiente a las decenas,
indica el nmero de cartas que has tirado, y la segunda cifra, la de las
unidades, la ordenacin. Ejemplo 1: 40 ____ indica que has tirado 4 cartas con
ordenacin 0 (slo hay esa ordenacin: las has tirado todas). Ejemplo 2:
32 ___ indica que has tirado 3 cartas con ordenacin 2, es decir, te has
quedado con la 3 carta, como muestra el esquema.

*Preguntas y Respuestas:
- Y esto para que sirve? 
- Para volver a barajar cuando se terminen las cartas del montn.
- Pero vaya rollo! Es imposible que me quede con tantos cdigos,
representaciones y no s qu historias!
- No, no hay que memorizar nada. T preguntas qu cdigo te ha salido? Y tu
compaero te dice, por ejemplo, el 24! Pues ya esta  t pones 24 y se acab.
- Y entonces, eso de las representaciones?
- Slo trataba de explicarte para qu servan y cmo funcionaban los cdigos,
pero puedes jugar perfectamente sin saberlo.
- Ah! Bueno.
- Nada, a mandar.
- Otra cosa!
- Dme.
- Tampoco he entendido muy bien eso del generador de nmeros, y que si mi
calculadora coge 1 y la tuya tira 4 o al revs.
- Ni te preocupes, puedes vivir en la ms absoluta ignorancia en lo que al
funcionamiento se refiere y el juego funcionar perfectamente. Simplemente
prueba a jugar :-).
- Vale!
- A mandar.

	Cuando terminas de meter los cdigos pulsas [OK] y listo.

NOTA: el comando [CHOOSE] tiene de por s algunas caractersticas que a veces
no explotamos:
- si pulsamos [+/-] pone en pantalla la siguiente entrada de la lista
desplegable.
- si queremos, por ejemplo, poner el cdigo 30 slo tenemos que pulsar la tecla
[3] y el programa buscar la primera entrada que empiece por "3".


Cmo se juega al mus.
~~~~~~~~~~~~~~~~~~~~~
	Buena pregunta. Pues realmente es uno de los 3 preceptos que todo
universitario tiene que cumplir para obtener su correspondiente ttulo. Estos
preceptos son: saber jugar al mus, hacer malabarismos con el boli (se valorar
el nmero de ciclos por minuto cpm que d el boli en tus manos) y el tercer
precepto es el ms trivial de todos: aprobar todas las asignaturas de la
carrera.

	Si no sabes jugar al mus y quieres aprender con mal maestro has ido a
dar ya que el que poco sabe poco puede ensear. Pero bueno, mndame un emilio
(e-mail para los anglfilos) y ya pillar a alguien para que te enve un
tutorial o similar. A todo esto, he curioseado en la red, y nada. Si alguien se
fabrica un tutorial y me lo quiere enviar se lo agradecer. UNIVERSITARIOS DEL
MUNDO, UNOS!


No lo vern mis ojos... [Tud: (To Do, para ti, anglfilo)].
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
	El proyecto ms inmediato para mejorar esta biblioteca es implementar
la opcin de jugar contra la calculadora. Todo llegar.
	Me han propuesto crear "ayudas" para el jugador poco instruido, que te
"aconsejen" a la hora de tomar decisiones.
	Un proyecto interesante es crear una biblioteca complementaria con
distintos tipos de cartas y de reversos de cartas, que incluso permitiera la
creacin de nuevas cartas por parte del usuario.

	Acepto encantado sugerenicas y crticas del programa y de los proyectos.


Let me talk about myself [Quin soy, mis gustos y aficiones, etc.].
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
	Soy Rubn Prez (Ruben Perez, sin tildes por si tu equipo no las soporta
y las sutituye por cualquier smbolo). Mi direccin de e-mail actual:
jtapevar@bi.ehu.es 

	Y mi intimidad es asunto mo, cotilla!


rase una vez... [Versiones]
~~~~~~~~~~~~~~~~~~~~~~~~~~~~

	Pues todo esto empez en una maravillosa clase de Ecuaciones
Diferenciales, mi objetivo era hacer que la HP sacara por pantalla un
nmero aleatorio entre 0 y 1, con 3 cifras decimales, que era el estndar
"compatible" con las otras calculadoras "inferiores" ;), para poder jugar
al mus. Y en esto ha degenerado esa efmera "versin 0.00"...

	Versin 2.00, cambios desde la versin 1.0:

- Se ha reescrito totalmente el programa en sys-RPL y ml.
- Se ha convertido en biblioteca.
- Se ha aadido un "about" con una denominacin ms propia: "autor".
- Se ha cambiado el algoritmo de barajar y no es compatible con versiones
anteriores :-(. Sin embargo, el tiempo de ejecucin del algoritmo es unas 4
veces menor :-).
- La velocidad general del programa es unas 8 veces! mayor.
- Las cartas ahora son redondeadas.
- Se ha cambiado el reverso de las cartas.
- Las cartas ahora son 1 pixel ms cortas.
- El nombre del autor (el mo) se ha quitado de los ases excepto del de oros.
- El cuadro de dilogo para dar mus ha cambiado, ahora es ms elegante y ms
fcil de utilizar.
- En las plantillas de entrada de datos se han aadido mens desplegables.
- El programa ahora no crea variables en ningn directorio.
- Y a pesar de todo esto el tamao a disminuido en 671 octetos (bytes para ti,
anglfilo).


FIN.
~~~~
	Tengo curiosidad por saber hasta qu lugares llega esto a lo que tanto
tiempo he dedicado gustosamente. Aqu te dejo mi direccin de correo electrnico:
jtapevar@bi.ehu.es
	Desde Vitoria, a 7 de noviembre de 1998, sbado, un saludo.
