Getting started
The Tórculo cheat sheet
The Tórculo language on one page: headers, prefixes, events and the commands to render.
This text is in Spanish.
One page to write .mesa pliegos without opening the specification. The law: the pliego
says human counts and manners; the engine sets the numbers. Every keyword comes from a
closed list; accents in keywords are optional. Text that goes on screen is between «», the
separator is ·, and every pliego carries its soundtrack. Keywords are Spanish.
Skeleton
MESA «Título»
formato 16:9 · sala crema · tirada borrador
BANDA sonido/banda EFECTOS sonido/efectos
MEZCLA para la web · sin stems
REPARTO ella: ultramar, cita_f, seca, a la izquierda
== CAPÍTULO 1 · NOMBRE ======= tensión sube · tambor ultramar
MÚSICA 1M1 AMBIENTE amb sala bucle ESPACIO estudio
-- ESCENA · diurna --
EJE de él a ella LUZ de la izquierda · dura
* función · afecto (or a shot: * primer contrapicado de ella · seco)
di: The narration, which sets the beat's duration.
ella: —Dialogue by a declared character.
al decir «palabra»: sonido: sello
== FIN ===
> silencio 2Clip lines
| To | Write |
|---|---|
| narrate | di: text · di (cita_f): text |
| speak | ella: —text (declared in REPARTO) |
| place | pon: cartulina «X» · pon: rescate «X» · pon: dymo «X» · pon: sello «X» · pon: apunte «X» |
| visualize | ver: key —data (ver: votos —sí: 7 · no: 4) |
| mark | marca: rodea «X» (rodea · señala · subraya · tacha) |
| caption | letrero (register): text (cartulina · cita · cita máquina · cita moderna · mano · rescate) · terminal: text · arriba: · pie: · nota: |
| place relative | junto a «X»: … · bajo «X»: … · delante de «X»: … · en los pies de él: … · juntos: a · b —en fila |
| move | la piedra rueda hasta el borde · por el suelo · pesado · a treses |
| anchor to the voice | al decir «word»: LINE · LINE hasta decir «word» · mientras: LINE |
| table camera | la truca se acerca a ella · ella mira a él · él sale por la izquierda · el foco en ella |
| sound | sonido: effect [a la izquierda] · > entra la música «1M2» · > silencio de verdad |
| an event | > deja posar · > dura 4 · > pasa página · > temblor · > congela |
| paste a photo | foto: x.jpg · sin fondo · canto de tijera · sombra levantada · con cinta |
| cut out a video | clip: x.mp4 de 0:02 a 0:07 · sin fondo (on twos) · clip de fondo: x.mp4 de 0:00 a 0:05 |
| a photo puppet | MARIONETA charlot · de la foto x.jpg (preamble) · python: charlot · CHARLOT saluda |
| make a piece act | REPARTO TIJERAS: minio, alias: tijeras · al decir «corta»: TIJERAS corta |
When in doubt, ask: mesa explica "line" · mesa chuleta · mesa bestiario pliego.mesa (the
pieces and their actions). Whatever looks like an instruction and is not one is an error in mesa lee.
Vocabularies
| affects | contenido · eufórico · exhausto · juguetón · nervioso · seco · sereno · solemne |
| functions | apertura · cartel · contrapunto · digresión · eco · giro · ilustración · prueba · remate · respiro · tesis |
| tensions · arcs | cae · mantiene · rompe · sube · espiral · letania · pregunta→respuesta · ruina · tesis→antitesis→sintesis · viaje y vuelta |
| shot sizes (ordered) | general · conjunto · medio · americano · corto · primer · detalle |
| heights · fronts | cenital · contrapicado · nadir · normal · picado · escorzo · espalda · frontal · perfil · tres cuartos |
| movement verbs | baja · cae · camina · corre · cruza · entra · esquiva · flota · gira · rebota · resbala · rueda · sale · salta · se apea · se encaja · se levanta · se sienta · sube · tiembla · tropieza · va · viaja · vuela |
| relational verbs | agarra · alcanza · arrastra · cuelga · empuja · esquiva · huye · órbita · se apoya · sigue · suelta |
| paths | a saltos · cayendo · en arco · en curva · en espiral · en zigzag · flotando · fuera de campo · girando · por el borde · por el camino · por el suelo · rebotando · recto · resbalando · rodando |
| manners | a la deriva · a regañadientes · a tirones · con anticipación · con cuidado · de golpe · de un tirón · despacio · en volandas · ligero · pesado · resuelto · rozando · sin ganas · titubeante |
| grains | a doses · a pulso · a treses · a unos (and en dos) |
| distances | al pie · al paso · cerca · a media distancia · lejos · al fondo · en el horizonte · en el cielo |
| drums | ámbar · bermellón · naranja · rosa · ultramar · verde · violeta |
rooms (ESPACIO) | estadio · estudio · patio · radio · seco |
| mix | con stems · para cine · para la web · sin stems |
| transitions | chasquido · corta · corta en la acción · cortinilla de tijera · desenfoque de pasada · encadena · entra de golpe · funde a blanco · funde a negro · funde desde blanco · funde desde negro · iris · la mano tapa · pasa página · se quema · sintoniza |
| materials · papers | acuarela · ninguna · papel · pincel · risografía · tejido · tinta · cuaderno · escolar · grano fino · khadi · kraft · lienzo · satinado · tintado · torchón · verjurado · washi |
| film stocks | noticiario · sin grano · truca |
| intensities | nula · quieta · serena · templada · viva · agitada · tensa · encendida · desatada · furiosa · rota |
| supports | limpio · usado · gastado · sucio · roto |
| lenses | gran angular · normal · ojo de pez · teleobjetivo |
What a pliego does NOT say
Curves, easing, keyframes, loose coordinates, durations in the plain dialect, hex colours, the shadow or speed of a single piece, unnamed pieces, two places for the same decision.
The loop
mesa lee (fix every error) → mesa graba (the voice) → mesa animatica --motor gx --sonido (look) → mesa toca --motor gx --sonido -o x.mp4 → mesa empaqueta.