INSTRUCCIONES DE USO Y DISFRUTE DEL GENERADOR DE ETAPAS (c) Allroch

Escritas a modo de FAQ

0. Qu cambios hay con respecto a la versin anterior del FAQ?
28/12/2004
Aadida informacin sobre tramos de pav en la pregunta 5

8/3/2004
Aadida pregunta 10, con consejos sobre insercin de puntos calientes

9/1/2004
Versin inicial

1. Qu es genetapa?
Es un generador de etapas 3D para el Eurotour a partir de sencillos ficheros de
definicin textuales. No me gusta llamarle editor porque este trmino tiene 
otras connotaciones

2. Cmo se instala?
Descomprime todos los ficheros en una misma carpeta. Yo recomiendo hacerlo en 
una que cuelgue de la carpeta en que est el Eurotour, para facilitar la copia 
de ficheros. Si quieres correr en las etapas de ejemplo, copia car000.sb y 
car001.sb a la carpeta scripts/competicion para que el GP Friori y la Challenge 
Jen Allroch sustituyan a Down Under y Mallorca. Las fechas de estas dos carreras 
(16-23/1 y 24/1-2/2) no deben coincidir con las de otras carreras. Si tienes 
instalado el original o los parches 2/2.1, no te preocupes; en otro caso, 
verifcalo. Copia tambin los ficheros con extensin .bin a scripts/etapas. No 
olvides guardar copia de los originales.

3. Qu necesito para generar una etapa?
El programa genetapa y cualquier editor de textos. El bloc de notas o el Wordpad 
son suficientes. Generar una etapa es tan sencillo como escribir las siguientes 
lneas
========
rect 1000
up08 100
========
Salvar el fichero con cualquier nombre o extensin (por ejemplo, "mietapa.txt"), 
arrancar genetapa, introducir el nombre del fichero de definicin (habamos 
dicho "mietapa.txt"), el del binario 3D (por defecto sera "mietapa.bin") y el 
del perfil (por defecto, "mietapa.sb") y ya hemos generado una etapa de 220 kms, 
los 200 primeros llanos y los 20 ltimos con una subida constante al 8%

4. Cmo se construye una etapa?
Una etapa se consigue juntando tramos. El Eurotour define unos 15 tramos. Cada 
tramo es de aproximadamente 200 m. En el fichero de definicin habr que 
especificar qu tramos componen la etapa. El generador permite colocar mltiples 
tramos consecutivos del mismo tipo. En el ejemplo de arriba, "rect 1000" 
significa que deben insertarse 1000 tramos del tipo 'rect' (que corresponde a 
una recta llana en va interurbana de longitud igual a 200m). 200m x 1000 = 200 
kms. De ah que con esas dos simples lneas se pueda crear una etapa de 220 kms.

5. Qu tipos de tramos hay?
Genetapa identifica los tramos con cdigos de cuatro carcteres. Admite los 
siguientes:
- 'aven'
   Distancia: 200 m
   Desnivel: 0%
   Direccin: 0
   Descripcin: es un tramo recto y llano por ciudad

- 'giro', 'gird' y 'giri'
   Distancia: 154 m
   Desnivel: 0%
   Direccin: +90 (gird), -90 (giri) y variable + y - 90 (giro)
   Descripcin: es un giro de 90 en entorno urbano. gird supone torcer a la 
derecha y giri a la izquierda. 'giro' realiza el dem en la direccin opuesta al 
ltimo cambio de direccin, para as evitar bucles

- 'rtnd', 'rtni' y 'rtdi'
   Distancia: 200 m
   Desnivel: 0%
   Direccin: 0
   Descripcin: este tramo recorre una rotonda urbana, por la derecha (rtnd) o 
por la izda (tanto rtni como rtdi, que son dos formas de denominar lo mismo)

- 'rect'
   Distancia: 200 m
   Desnivel: 0%
   Direccin: 0
   Descripcin: este tramo no es ms que una recta plana, pero a diferencia de 
'aven' ya en campo abierto     

- 'pnte'
   Distancia: 200 m
   Desnivel: 0%
   Direccin: 0
   Descripcin: otro tramo recto y llano de 200m, con la particularidad que 
atraviesa un puentecico

- 'rdeo' y 'rode'
   Distancia: 202 m
   Desnivel: 0%
   Direccin: 0
   Descripcin: en la prctica, muy parecido a los anteriores. Se diferencia en 
que se desva a la izda para hacer un pequeo rodeo. La mejor forma de verlo 
(aparte de probarlo o disputar el GP Friori) es pensar en un desvo provisional 
en carretera por obras, que te hace moverte al otro carril.

- 'crno'
   Distancia: 200 m
   Desnivel: 0%
   Direccin: 0
   Descripcin: es un tramo 'aven' al que se le aade la rampa de salida de 
contrarreloj. No tiene sentido utilizarlo en otros sitios, aunque origina un 
efecto curioso.

- 'curv', 'crvd' y 'crvi'
   Distancia: 154 m
   Desnivel: 0%
   Direccin: +90 (crvd), -90 (crvi) y variable (curv)
   Descripcin: es el equivalente extraurbano de 'giro'

- 'eses', 'essd' y 'essi'
   Distancia: 263 m
   Desnivel: 0%
   Direccin: +90 (essd), -90 (essi) y variable (eses)
   Descripcin: es un tramo chulo. 'essi' toma direccin a izda despus de 
iniciar el tramo hacia la derecha. 'essd' recorre el tramo en sentido inverso. 
'eses' alterna el cambio de direccin con el anterior realizado.

- 'up04'
   Distancia: 200 m
   Desnivel: 4% (+8m)
   Direccin: 0
   Descripcin: empezamos con las subidas. En este caso, una recta con el 4% de 
pendiente

- 'up08'
   Distancia: 200 m
   Desnivel: 8% (+16m)
   Direccin: 0
   Descripcin: seguimos con las subidas. Ahora la recta es del 8%

- 'up12'
   Distancia: 200 m
   Desnivel: 12% (+24m)
   Direccin: 0
   Descripcin: ltima subida en recta. Del 12% sostenido.

- 'up11', 'u11d' y 'u11i'
   Distancia: 154 m
   Desnivel: 11% (+16m)
   Direccin: +90 (u11d), -90 (u11i) y variable (up11)
   Descripcin: curva de las que se agarra, al 11%. Vara ligeramente segn se 
tome a la dcha (u11d) o a la izda (u11i). Con up11 se consigue girar de forma 
alterna, evitando cruces.

- 'up17'
   Distancia: 263 m
   Desnivel: medio del 6% (+16m), con rampa mxima del 17%
   Direccin: -90
   Descripcin: es un tramo de curveo con baja pendiente, pero que se eleva a 
17% a mitad del mismo. Siempre supone cambiar la direccin hacia la izquierda, 
por lo que debe usarse con cuidado para evitar cruces. 

- 'up21'
   Distancia: 250m
   Desnivel: medio del 10% (+24m), con rampa mxima del 21%
   Direccin: 0
   Descripcin: sube en zig-zag alcanzando el 21%, con otras rampas del 18 y el 20

- 'up26'
   Distancia: 350 m
   Desnivel: medio del 7% (+24m), con rampa mxima del 26% en una revuelta terrible
   Direccin: 0
   Descripcin: el tramo ms largo, tiene sendas revueltas del 22% y el 26%, 
pero es ms suave en las rectas que las enlazan.

- 'dn04'
   Distancia: 200 m
   Desnivel: -4% (-8m)
   Direccin: 0
   Descripcin: Inverso del up04

- 'dn08'
   Distancia: 200 m
   Desnivel: -8% (-16m)
   Direccin: 0
   Descripcin: inverso del up08

- 'dn12'
   Distancia: 200 m
   Desnivel: -12% (-24m)
   Direccin: 0
   Descripcin: Inverso del up12, es decir, 200m de descenso recto del 12%

- 'dn11', 'd11d' y 'd11i'
   Distancia: 154 m
   Desnivel: -11% (-16m)
   Direccin: +90 (d11d), -90 (d11i) y variable (dn11)
   Descripcin: inversos de los correspondientes up11
 
- 'pave'
   Distancia: 200 m
   Desnivel: 0%
   Direccin: 0
   Descripcin: tramo recto y llano adoquinado. Requiere eurotour-plus v2.3 o superior

- 'pv04'
   Distancia: 200 m
   Desnivel: 4% (+8m)
   Direccin: 0
   Descripcin: tramo recto adoquinado con pendiente del 4%. Requiere eurotour-plus v2.3 o superior

- 'pv08'
   Distancia: 200 m
   Desnivel: 8% (+16m)
   Direccin: 0
   Descripcin: tramo recto adoquinado con pendiente del 8%. Requiere eurotour-plus v2.3 o superior

- 'pv12'
   Distancia: 200 m
   Desnivel: 12% (+24m)
   Direccin: 0
   Descripcin: tramo recto adoquinado con pendiente del 12%. Requiere eurotour-plus v2.3 o superior

- 'pv11', 'p11d' y 'p11i'
   Distancia: 154 m
   Desnivel: 11% (+16m)
   Direccin: +90 (p11d), -90 (p11i) y variable (pv11)
   Descripcin: curva adoquinada al 11%. Puede tomarse a derecha (p11d) o a izda (p11i). Con pv11 
se consigue girar de forma alterna. Requiere eurotour-plus v2.3 o superior


Recuerdo que junto a cada tramo se puede indicar el nmero de repeticiones del 
mismo, para as poder construir la etapa ms rpidamente. Esto es especialmente 
til para los largos segmentos llanos tpicos de cualquier etapa.

6. Qu es eso de los bucles y cruces y por qu hay que evitarlos?
Eurotour sita cada tramo en una coordenada (x,y). No puede haber dos tramos en 
el mismo sitio, por lo que los cruces no son nada recomendables (no es que pete 
directamente, sino que hace efectos raros). Por eso los cdigos por defecto 
indicando tramos en curva (salvo el up17) escogen el cambio de direccin opuesto 
al previo, de forma que puedan escribirse etapas sin tener que preocuparse 
demasiado de que aparezcan bucles.

En el caso del up17, recomiendo ponerlo siempre despus de giro hacia la 
derecha, para que tambin con estos tramos se alterne el sentido de giro. Que 
sepis que las etapas salen en direccin Norte y que el primer giro por defecto 
ser hacia la derecha, para tomar direccin Este. 

7. Pero una etapa no son slo tramos. Habr que definir puertos, 
avituallamientos y dems.
Cierto. Por eso genetapa admite tambin otros cdigos extra. Estos cdigos 
complementan los cdigos de tramo y se aplican al tramo que los sigue en la 
definicin. Es decir, si yo escribo:
========
up12 1
prte 1
rect 1
========
El puerto de categora especial se colocar en el tramo rect. En concreto, va al 
principio del mismo, con lo que puede pensarse que la cima del puerto va entre 
los dos tramos. Es una forma de verlo, pero no siempre es la mejor. Pero prte 
slo es uno de los cdigos extra que soporta genetapa. La lista completa es:

slda, sali - indica que la salida estar en el siguiente tramo. En etapas contrarreloj, lo recomendable es que ese siguiente tramo sea del tipo 'crno'
meta - indica que la meta estar en el siguiente tramo
avtl - indica avituallamiento
km01 - pondr el tringulo amarillo al principio del siguiente tramo
km05 - pancarta de 5 kms
km10 - la de 10 a meta
km20 - quedan 20
prt4, prt3, prt2, prt1 y prte - puertos respectivamente de cuarta, tercera, 
segunda, primera y especial
sprn, mvol - sirve para insertar una meta volante (o sprint especial, como 
quieras llamarlo)
time - punto de cronometraje

Todos estos cdigos pueden complementarse con un nmero. Por defecto el valor es 
uno, que significa que se colocar la pancarta correspondiente y el punto de 
foco (la cmara fija que indica que el punto est realmente ah). El valor 2 
indica que slo ha de colocarse la pancarta, sin ningn significado real (es 
decir "prte 2" pondra una pancarta de puerto pero este no puntuara ni se 
produciran ataques de los escaladores). El valor 0 indica que se coloque el 
punto caliente pero sin pancarta. En pancartas kilomtricas, la interpretacin 
es diferente: el valor 1 tampoco inserta el punto caliente, para esto es
necesario el 3 ("km01 3", por ejemplo)

banr, bner - coloca una pancarta blanca. til para ayudar a ubicar la carrera
panl, pnel - como banr, es un objeto sin significado especial. Su utilidad es 
decorativa y de referencia.
paso - coloca un paso elevado por debajo del cual pasa la carretera. dem a banr 
y panl
gaso - vers una gasolinera en el lado derecho

Estos cuatro objetos, junto con las anteriores pancartas, sern visibles en 
todos los tramos, al princicipio del mismo (en la mayora de los casos) o al 
final (u11i y tramos en descenso salvo d11d). Slo puede colocarse un objeto por 
tramo, que ser el primero que aparezca.

pprf - este cdigo sirve nicamente para que genetapa informe sobre el punto 
concreto en que se encuentra (distancia y altitud), y lo inserte en el perfil 
del fichero .sb
jump - un cdigo especial que provoca un salto en la posicin de la carrera. 
Sirve para simular circuitos (ver la etapa criterium final de GP Friori). 
pvtx - utiliza el fichero car03.bmp como textura en el tramo que sigue. Por
defecto, ese fichero no es una textura de pave, es necesario modificarlo. Esta 
etiqueta no es ya necesaria al existir tramos de pave con efecto real de pave.


8. Puedes poner un ejemplo ms realista de etapa?
Cmo no. Tomemos por ejemplo el perfil de la etapa 17 del Tour del ao que 
viene, 212 kms de Bourg d'Oisans a Le Grand Bornand, con cinco puertos. El 
perfil puedes verlo en el fichero profil17.gif (descargado de www.letour.com) 
que acompaa a esta distribucin.

En primer lugar, hay que dividir la etapa en bloques. En este caso es fcil:
0-9: Llano
9-36: Col du du Glandon, 27 km at 4.5%
36-63: Descenso
63-66: Llano (ponemos MVOL y avituallamiento)
66-86: Col de la Madeleine, 19.5 at a 8%
86-116: Descenso
116-134: Llano (ponemos MVOL y avituallamiento)
134-143: Col de Tami, 9 km at 6%
143-158: Descenso
158-167: Col de la Forclaz, 8.5 km at 8%
167-180: Descenso
180-188: Llano
188-201: Col de la Croix-Fry, 12.5 km at 6.8% 
201-212: Descenso

Y ahora rellenar cada bloque con los tramos que queramos. En el ejemplo no sigo
las altimetras reales de los puertos.
=========================
# 0-9: Llano
rect 2	# Previos a la salida
slda 1
rect 45	# Primeros kilmetros, llanos y rectos

# 9-36: Col du du Glandon, 27 km at 4.5%
up04 25	# Primeros kilmetros llevaderos
curv 1	# Descansillo
rect 2
up04 3
rect 2
up04 1
rect 1	# Fin de 2 kms fciles
up08 2	# Alterno ahora rampas del 8% con llanos, durante 3 kms
curv 1	# Abuso del copy y paste
up08 2
curv 1
up08 2
curv 1
up08 2
curv 1
up08 2
curv 1
up08 5	# Empieza lo serio, 1 km al 8%. Ya van 11
rect 1	# Sigue otro descansillo de 1 km
curv 1
up04 1
rect 2
up17 1	# Pongo como ejemplo un 17%. He verificado que el anterior giro era hacia la derecha
up11 1	# Lo combino con un 11%, y relleno hasta el km 20 en un plis-plas
up04 38
up21 4	# Me quedan 7 kms (es decir, unos 35 tramos). Empiezo con rampas fuertes
up08 4	# Y sostenidas
rect 1	# Secuencia de rectas curvas, del 0 y el 11% semialeatoriamente
up11 1
up04 5
up11 1
up08 3
eses 1
up04 2
up26 2
curv 1
up04 5	# Final duro y en recta
up12 3
up08 2	# Corono, pongo la pancarta en el siguiente
prt1 1
rect 1

# 36-63: Descenso
dn08 60
dn04 75	# Descenso rpido de 27 kms

# 63-66: Llano (ponemos MVOL y avituallamiento)
rect 5	# Meta volante y avituallamiento en estos 3 kms
mvol 1
rect 8
avtl 1
rect 2

# 66-86: Col de la Madeleine, 19.5 at a 8%
up08 100	# Este tambin lo resuelvo rpido
prte 1
rect 1

# 86-116: Descenso
dn04 150	# No me complico la vida

# 116-134: Llano (ponemos MVOL y avituallamiento)
pprf		# Pongo un punto de referencia para el perfil
rect 50	# Tras 10kms, meta volante
mvol 1
rect 25	# Tras otros 5, segundo avituallamiento
avtl 1
rect 15	# ltimos 3 para enlazar con el siguiente puerto

# 134-143: Col de Tami, 9 km at 6%
pprf		# Hay que marcar el comienzo del puerto
up04 4	# Decido concentrar la dureza al final
curv 1
up04 2
curv 1
up08 2
up11 2
up04 1
eses 1
up04 4
curv 1
up08 2
curv 1
up04 3	# Van 5 kms
up08 2
up11 1
up04 2
rect 1
up04 1
up08 1
up12 1
up26 1
up11 1
up08 4
up11 1
up08 4	# Cima
prt2 1
curv 1

# 143-158: Descenso
dn04 5
dn11 6
dn08 65

# 158-167: Col de la Forclaz, 8.5 km at 8%
pprf
up04 20
up21 5
up12 20
prt1
rect

# 167-180: Descenso
dn04 65

# 180-188: Llano
pprf
rect 40

# 188-201: Col de la Croix-Fry, 12.5 km at 6.8% 
pprf
up04 20
up11 1
km20 1	# A mitad de subida, km 20 a meta
up08 4
up11 1
up08 4
up11 1
up08 4
up11 1
up08 4
up11 1
up08 4
up11 1
up08 4
up11 1
up08 4
up11 1
up08 4
up12 3
prt1 1
rect 

# 201-212: Descenso
dn08 3
dn11 1
dn08 1
km10 1	# Pancarta de km10. 
rect 1
dn11 1
dn08 4
dn11 1
dn08 4
dn11 1
dn08 4
dn11 1
dn08 4
dn11 1
dn08 4
dn11 1
km05 1	# km05
dn04 3
rect 2
dn04 3
rect 2
dn04 3
rect 2
dn04 3
rect 2
km01 1	# ltimo kilmetro
aven 5
meta
aven 2	# Conviene colocar una o dos rect/aven tras meta, para evitar problemas
==========================

Pues ya est, aadimos los comentarios que queramos (precedindolos con el 
caracter #), y salvamos (por ejemplo, en tour17-04.txt). Al ejecutar genetapa, 
introducimos el nombre del fichero de definicin (tiene que estar en la misma 
carpeta que el programa) y los que queremos generar como salida (pongamos, 
tour17-04.bin y tour17-04.sb. Si es as, basta con pulsar 'Intro' dos veces). El 
resultado, que se muestra por pantalla y se guarda en el fichero tour17-04.sb, 
es

# Fichero tour17-04.bin generado con 1070 tramos

# Distancia total:    212.5 kms
# Subida acumulada:    73.1 kms  Desnivel: 5136 m.  Pte. media: 7.0%
# Descenso acumulado:  93.3 kms  Desnivel: 5048 m.  Pte. media: 5.4%
# Llano acumulado:     46.1 kms
# Perfil:
# Km   0.0, 1000 m. Salida
# Km  36.1, 2352 m. Puerto de primera
# Km  64.3,  792 m. Meta volante 
# Km  65.9,  792 m. Avituallamiento
# Km  86.3, 2392 m. Puerto de categoria especial
# Km 116.5, 1192 m. 				Punto de perfil
# Km 126.5, 1192 m. Meta volante 
# Km 131.5, 1192 m. Avituallamiento
# Km 134.5, 1192 m. 				Punto de perfil
# Km 143.4, 1704 m. Puerto de segunda
# Km 158.5,  528 m. 				Punto de perfil
# Km 167.7, 1328 m. Puerto de primera
# Km 180.9,  808 m. 				Punto de perfil
# Km 188.9,  808 m. 				Punto de perfil
# Km 201.2, 1680 m. Puerto de primera
# Km 212.5, 1088 m. Meta

Con esto, ya podemos editar un fichero carXXX.sb (en eurotour/scripts/competicion), donde definir el perfil. La altura de salida se 
toma por defecto como de 1000m, pero en el fichero carXXX.sb cualquiera vale 
(tanto para la de salida como para el resto). Con la distribucin v0.9 se 
acompaan todos estos ficheros: tour17-04.txt, tour17-04.bin y tour17-04-edit.sb 
con su perfil editado (tour17-04.sb tiene el perfil autogenerado).

9. Y tengo que escribir a mano todo el perfil?
No. El perfil se genera automticamente a partir de las metas volantes, los 
puertos y los puntos de perfil definidos. Este perfil, que representa una etapa, 
debe copiarse a un fichero de definicin de carrera (carXXX.sb), y normalmente 
habr un pequeo trabajo de edicin para ajustar las altitudes, poner nombres de 
puertos, etc. 

El fichero .sb generado no es directamente utilizable, ya que slo define el perfil de la etapa, y en los carXXX.sb hay informacin adicional sobre la 
carrera (fechas, categora, etc). Es decir, el fichero .sb con el perfil no
vale para puede sustituir sin ms un fichero carXXX.sb. Cuanto menos, hay que
aadir unos campos de cabecera, y respetar el formato original.

10. Algn otro consejo a seguir para generar una buena etapa?
Debe tenerse especial cuidado con la insercin de puntos calientes. La IA del
Eurotour depende de cual es el siguiente punto caliente en la etapa. Por 
ejemplo, no sabr que se est subiendo un puerto hasta que el siguiente punto 
caliente no sea de un puerto. Aunque las rampas sean del 12%, si en medio hay 
una meta volante, o un punto caliente kilomtrico, a un avituallamiento, el 
Eurotour asumir que es una zona llana. Esto es importante ya que en etapas de 
montaa los ataque se producen sobre todo en lo que para el Eurotour es subida. 
Esto tambin explica por qu normalmente hay tan pocos ataque en el ltimo 
puerto. Probad las etapas modificadas del Giro original que acompaan la 
distribucin para ver el resultado.

La versin 0.91 de genetapa ayuda a paliar esto, al no incluir automticamente 
los puntos calientes kilomtricos, y por defecto slo poner la pancarta (no lo 
que sirve de "cmara", para entendernos). Y no se me ocurre ningn motivo por el 
que valga la pena poner los puntos calientes kilomtricos. Tampoco es en general 
bueno, por tanto, poner un avituallamiento, o una meta volante en pleno ascenso.

Otra cosa que recomiendo es, sobre todo en pruebas de un da con muchas cotas, 
espaciar los puertos puntuables cada unos 20 kms, para as no interrumpirlas con 
absurdos sprints cada poco. Para fomentar los ataques, debe situarse la ltima 
subida puntuable lo ms cerca posible de meta, y aqu respetar a rajatabla lo de 
no poner ningn otro puerto puntuable en los 20 kms anteriores. En la versin 
0.91 se ha hecho esto con Amstel y Flecha.


Creo que con esto ya est dicho todo. Para cualquier otra pregunta, comentario o 
sugerencia, escribidme a allroch@yahoo.com

(c) Allroch
http://www.angelfire.com/games5/allroch/
