Skip to content
Tórculo1.0 · working draft

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 2

Clip lines

ToWrite
narratedi: text · di (cita_f): text
speakella: —text (declared in REPARTO)
placepon: cartulina «X» · pon: rescate «X» · pon: dymo «X» · pon: sello «X» · pon: apunte «X»
visualizever: key —data (ver: votos —sí: 7 · no: 4)
markmarca: rodea «X» (rodea · señala · subraya · tacha)
captionletrero (register): text (cartulina · cita · cita máquina · cita moderna · mano · rescate) · terminal: text · arriba: · pie: · nota:
place relativejunto a «X»: … · bajo «X»: … · delante de «X»: … · en los pies de él: … · juntos: a · b —en fila
movela piedra rueda hasta el borde · por el suelo · pesado · a treses
anchor to the voiceal decir «word»: LINE · LINE hasta decir «word» · mientras: LINE
table camerala truca se acerca a ella · ella mira a él · él sale por la izquierda · el foco en ella
soundsonido: 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 photofoto: x.jpg · sin fondo · canto de tijera · sombra levantada · con cinta
cut out a videoclip: 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 puppetMARIONETA charlot · de la foto x.jpg (preamble) · python: charlot · CHARLOT saluda
make a piece actREPARTO 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

affectscontenido · eufórico · exhausto · juguetón · nervioso · seco · sereno · solemne
functionsapertura · cartel · contrapunto · digresión · eco · giro · ilustración · prueba · remate · respiro · tesis
tensions · arcscae · 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 · frontscenital · contrapicado · nadir · normal · picado · escorzo · espalda · frontal · perfil · tres cuartos
movement verbsbaja · 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 verbsagarra · alcanza · arrastra · cuelga · empuja · esquiva · huye · órbita · se apoya · sigue · suelta
pathsa 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
mannersa 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
grainsa doses · a pulso · a treses · a unos (and en dos)
distancesal 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
mixcon stems · para cine · para la web · sin stems
transitionschasquido · 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 · papersacuarela · ninguna · papel · pincel · risografía · tejido · tinta · cuaderno · escolar · grano fino · khadi · kraft · lienzo · satinado · tintado · torchón · verjurado · washi
film stocksnoticiario · sin grano · truca
intensitiesnula · quieta · serena · templada · viva · agitada · tensa · encendida · desatada · furiosa · rota
supportslimpio · usado · gastado · sucio · roto
lensesgran 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.