Pular para o conteúdo principal
Receita número 61

Receitas · Capítulo 2 · Tipo e texto

Formato de roteiro de cinema

Um roteiro de filmagem em Courier Prime 12 no papel Carta, cada fala num boxe sem moldura com o recuo do bloco de diálogo e cada cena numerada nas duas margens.

Nesta página
Saída
Canvas
Postext
Testada com o Postext 1.65.0
Requer ≥ 1.25.0
Licença
Atualizada em 11 de out. de 2026
Código MIT · Texto CC BY 4.0

p. 2–1 · 2–3 de 5

  • Amostra em inglês: ainda sem edição em português
  • Refile 215,9 × 279,4 mm
  • 1 coluna
  • Courier Prime 12/12
  • Oswald
  • Special Elite
  • 5 páginas
  • Nível
  • Postext 1.57.1
  • Diagramado em 59 ms
  • 149 linhas de código

Em poucas palavras

O roteiro de um curta-metragem no formato que os estúdios de cinema esperam. Usa uma letra de máquina de escrever, e as falas e os números das cenas ficam a distâncias fixas da borda.

O que você vai compor

A versão de filmagem de Lost Property, um curta inventado de três páginas, encadernado como os roteiros dos estúdios: capa de cartão amarelo-ouro com dois colchetes de latão e uma etiqueta datilografada, o verso carimbado com COPY 07 e, em seguida, o roteiro, composto em Courier Prime 12 sobre 12 em papel Carta furado. As medidas são as dos programas de roteiro: ação de 1,5 a 7,5 polegadas; fala de 2,5 a 6, sob o nome do personagem a 3,7; rubrica a partir de 3,1; e CUT TO: e FADE OUT. terminando na margem direita. Cada cabeçalho de cena leva o número nas duas margens. A página 1 do roteiro não tem número; as outras imprimem o número no alto à direita, com ponto. Cada fala é um boxe sem moldura, com o nome do personagem na mesma entrelinha de 12 pt do texto, de modo que ação e diálogo mantêm seis linhas por polegada.

Esta receita responde a

  • Como componho um roteiro de cinema ou uma peça de teatro: cabeçalhos de cena, nomes de personagens e diálogo recuado dos dois lados?

A resposta curta

script.js · linhas 43–64no código completo
// Positions from the left edge of the sheet, in inches, as screenwriting software gives them.
const DIALOGUE = { left: 2.5, right: 6 }; // the block of speech, 3.5 inches wide
const CUE = 3.7; // the character's name
const TEXT_RIGHT = 8.5 - MARGIN.right; // 7.5: where action lines end
const dialogue = {
  id: 'dialogue',
  backgroundEnabled: false, // no fill and no border: the box is only a measure
  padding: { top: pt(0), bottom: pt(0),
    left: mm((DIALOGUE.left - MARGIN.left) * IN), // 1 inch in from the action
    right: mm((TEXT_RIGHT - DIALOGUE.right) * IN) }, // 1.5 inches short of it
  // The fence's title is the cue: title="Dora (cont’d)" prints DORA (CONT’D) at 3.7 inches,
  // in the headings' Courier, with no gap under it (the default is half a line). On the
  // body's 12-pt leading (the default is 1.2 times its size, 14.4 pt), the name sits on a
  // grid line and a speech is a whole number of lines.
  titleStyle: { fontWeight: 400, textTransform: 'uppercase', lineHeight: pt(LEAD),
    indent: mm((CUE - DIALOGUE.left) * IN), gap: pt(0) },
  body: { paragraphSpacing: false }, // no blank line before a parenthetical mid-speech
  marginTop: pt(LEAD), marginBottom: pt(LEAD), // one blank line above and below
  // Snapped to the grid, a box keeps its bottom margin and the next speech adds its top
  // margin: two blank lines between speeches. Unsnapped, the two margins collapse into one.
  snapToGrid: false,
};

Ingredientes

Tipografia
Courier Prime, Oswald (SIL OFL 1.1) · Special Elite (Apache 2.0)
Materiais
Nenhum: todas as imagens são desenhadas em código

Preparo

O código está na resposta curta lá em cima. O preenchimento de um boxe é medido a partir da mancha, por isso 1 polegada à esquerda e 1,5 à direita deixam o bloco de 3,5 polegadas que começa a 2,5 da borda da folha (estilos de boxe). O nome do personagem é o título do boxe, escrito no bloco como title="Dora (cont’d)". textTransform o imprime em maiúsculas, e indent o leva 1,2 polegada além do preenchimento, até 3,7 polegadas. gap vale 0 porque o padrão deixa meio eme, 6 pt, entre o nome e a fala. Por padrão, o título de um boxe fica numa linha de 1,2 vez o corpo, aqui 14,4 pt. titleStyle.lineHeight o põe nos 12 pt do texto, de modo que o nome cai numa linha da grade e a fala ocupa um número inteiro de linhas de 12 pt; com o padrão, cada fala empurraria o texto seguinte mais 2,4 pt para fora da grade. Com snapToGrid desativado, a margem inferior de uma fala e a superior da seguinte se fundem numa única linha em branco. Por padrão um boxe fica inteiro, por isso uma fala que não cabe mais passa para a página seguinte junto com o nome.

#2 · Monte a página em polegadas

script.js · linhas 33–39no código completo
const MARGIN = { top: 1, bottom: 1, left: 1.5, right: 1 }; // inches: the left one takes the brads
const page = { sizePreset: 'custom', width: mm(8.5 * IN), height: mm(11 * IN), dpi: 150,
  margins: { top: mm(MARGIN.top * IN), bottom: mm(MARGIN.bottom * IN),
    left: mm(MARGIN.left * IN), right: mm(MARGIN.right * IN) } };
const bodyText = { fontFamily: TEXT, fontSize: pt(12), lineHeight: pt(LEAD), color: col('ink'),
  textAlign: 'left', firstLineIndent: pt(0), // action: flush left, never justified
  paragraphSpacing: true }; // a blank line between paragraphs

Papel Carta com a margem esquerda de 1,5 polegada por onde passam os colchetes e uma polegada nos outros três lados. A Courier Prime é uma fonte monoespaçada: em 12 pt cada letra tem um décimo de polegada de largura, de modo que uma linha de ação comporta 60 caracteres e uma fala, 35, e com entrelinha de 12 pt a página comporta 54 linhas. O texto é alinhado à esquerda, em bandeira, e paragraphSpacing põe uma linha em branco entre os parágrafos. Texto em bandeira só é hifenizado quando bodyText.hyphenation.ragged o pede, por isso nenhuma palavra do roteiro é dividida, como o formato exige.

#3 · Transforme rubricas e transições em estilos de parágrafo

script.js · linhas 68–72no código completo
const PAREN = 3.1;
const paragraphStyles = [
  { id: 'paren', firstLineIndent: mm((PAREN - DIALOGUE.left) * IN) }, // inside a speech
  { id: 'transition', textAlign: 'right' }, // CUT TO:, flush with the action's right edge
];

Um contêiner :::paragraphs{style="paren"} dentro de uma fala recua a primeira linha 0,6 polegada além da borda do diálogo, até 3,1 polegadas (estilos de parágrafo). Mantenha cada rubrica numa linha só: o estilo recua apenas a primeira. O body.paragraphSpacing: false do estilo de diálogo deixa fora do boxe a linha em branco dos parágrafos de ação, e assim (then) fica logo abaixo da linha anterior. CUT TO: e FADE OUT. vão em contêineres transition, cujo textAlign: 'right' os alinha com o fim das linhas de ação. Um contêiner devolve o texto à grade de linhas de base depois do último parágrafo; este roteiro nunca sai da grade, por isso o cabeçalho depois de CUT TO: mantém as duas linhas em branco.

#4 · Pendure os números de cena nas duas margens

script.js · linhas 76–105no código completo
// Each number sits in a box half an inch wide, text aligned left, so that 9, 12 and an
// inserted 12A start at the same place on both sides.
const NUMBER_W = 0.5; // inches
const number = (id, edge, x) => ({ kind: 'text', id, content: '{number}', fontFamily: TEXT,
  fontSize: pt(12), fontWeight: 700, lineHeight: 1, color: col('ink'), align: 'left',
  placement: { ...at('container', edge, x * IN), size: { width: mm(NUMBER_W * IN) } } });
// The heading's own text is not painted but still measured: at the level's default 15 pt,
// scene 1's heading would wrap and reserve a second line.
const slugline = { level: 2, fontSize: pt(12), lineHeight: pt(LEAD),
  marginTop: pt(2 * LEAD), marginBottom: pt(LEAD), // two blank lines above, one below
  numberingTemplate: '{2}', // the scene count, which {number} prints
  advancedDesign: { enabled: true, slot: { elements: [
    { kind: 'text', id: 'heading', content: '{titleText}', fontFamily: TEXT, fontSize: pt(12),
      fontWeight: 700, lineHeight: 1, color: col('ink'), align: 'left', overflow: 'wrap',
      placement: { ...at('container', 'top-left'), size: { width: 'fill' } } },
    number('left', 'top-left', -0.6), // starts at 0.9 inches from the edge of the sheet
    number('right', 'top-right', 0.25 + NUMBER_W), // starts a quarter inch past the text
  ] } } };
const headings = {
  // The family of the speech titles, and the one the headings' unpainted text is measured
  // in (left unset, a sixth face, Open Sans Bold, would be loaded for nothing).
  fontFamily: TEXT,
  // Script pages end where the last whole speech or paragraph ends. Balancing would add
  // blank lines above the sluglines to fill them.
  balancing: { enabled: false },
  levels: [
    // 'any': the cover, its inside and the title each open the next page, with no blank.
    { level: 1, breakBefore: { enabled: true, parity: 'any' } },
    slugline,
  ] };

numberingTemplate: '{2}' conta os títulos de nível 2, e {number} imprime essa contagem no design (ajustes por nível). Um título com design avançado mantém o lugar na coluna e desenha os elementos no lugar do texto (span e design avançado), e por isso os dois números podem ficar nas margens ao lado do cabeçalho em negrito. Cada um é ancorado à caixa do próprio título e empurrado para fora dela, 0,6 polegada à esquerda e, à direita, um quarto de polegada além do fim do texto, numa caixa de meia polegada com o texto alinhado à esquerda, para que, num roteiro com mais de nove cenas, os números de um e de dois algarismos comecem no mesmo ponto. O texto do próprio título não é pintado, mas continua sendo medido, por isso o nível fica em 12 pt: com os 15 pt padrão, o cabeçalho da cena 1 quebraria e reservaria uma segunda linha. O equilíbrio de colunas está desativado: ele acrescentaria linhas em branco acima dos cabeçalhos de cena para encher uma página curta, e uma página de roteiro termina onde termina a última fala ou o último parágrafo.

#5 · Fure e numere só as páginas do roteiro

script.js · linhas 109–129no código completo
// Three holes down the bound edge, 4.25 inches apart, as a three-hole punch leaves them.
const HOLES = [1.25, 5.5, 9.75].map((y) => y * IN); // mm: hole centres from the top
const EDGE = 0.375 * IN; // mm: from the bound edge to the centre of each hole
const HOLE = 7; // mm across
const punched = HOLES.map((y, i) => ({ kind: 'box', id: `punch${i}`,
  style: { backgroundColor: col('hole'), borderRadius: mm(HOLE / 2) },
  placement: { ...at('page', 'top-left', EDGE - HOLE / 2, y - HOLE / 2),
    size: { width: mm(HOLE), height: mm(HOLE) } } }));
// The script's first page opens with its title, an H1 that breaks the page, so the page is
// an 'opener' and pages: 'body' leaves it unnumbered, as the format asks.
const folio = { kind: 'text', id: 'folio', content: '{pageNumber}.', pages: 'body',
  fontFamily: TEXT, fontSize: pt(12), color: col('ink'), align: 'right',
  placement: at('page', 'top-right', -MARGIN.right * IN, 0.5 * IN) };
// The title's style carries the header of its section: the pages from the title to the end.
const title = { id: 'script', header: { elements: [...punched, folio] },
  advancedDesign: { enabled: true, slot: { elements: [
    { kind: 'text', id: 'title', content: '{titleText}', fontFamily: TEXT, fontSize: pt(12),
      lineHeight: 1, textTransform: 'uppercase', color: col('ink'), align: 'center',
      placement: { ...at('container', 'top'), size: { width: 'fill' } } },
  ] } }, // H1's own line, 1.2 × 18 pt, would reserve 21.6 pt and drop FADE IN: 9.6 pt
  lineHeight: pt(LEAD), marginBottom: pt(LEAD) };

O estilo do título do roteiro traz o próprio header, que substitui o do documento nas páginas da seção, do título até o fim (estilos de título). O cabeçalho do próprio documento é vazio, de modo que os furos e o número de página só aparecem no roteiro. O número de página é ancorado a meia polegada do alto da folha, e pages: 'body' o mantém fora das páginas de abertura (elementos de texto). O título é de nível 1 e quebra a página, por isso a página 1 é uma página de abertura e não imprime número, como o formato pede. As capas também são títulos de nível 1; :::numbering{startAt=1}, entre o verso da capa e o título, dá à página do título o número 1, e a página seguinte imprime 2. O estilo do título fixa uma linha de 12 pt; com os 18 pt próprios do nível 1, o título ficaria numa linha de 21,6 pt e empurraria FADE IN: 9,6 pt para baixo.

A receita completa

Sandbox
// ═══ Postext Cookbook · Nº 061 · Screenplay format ═══════════════════════════════
// https://postext.dev/en/cookbook/screenplay-format
// Code: MIT · Text: original (CC BY 4.0) · Pictures: none
// Fonts: Courier Prime, Oswald (SIL OFL 1.1), Special Elite (Apache 2.0) · Needs postext ≥ 1.25.0
import { buildDocumentWithFonts, renderPageToCanvas } from 'https://esm.sh/postext';

const LANG = 'en'; // @lang: the language of the sample document ('en' | 'es')
const RECIPE = 'screenplay-format';

// ─── 1 · Design ─────────────────────────────────────────────────────────────
const palette = { // black type on white bond, and a card cover in goldenrod
  ink: '#1b1b1b', // every line of the script
  paper: '#ffffff',
  hole: '#e3e1db', // the punched holes down the left edge of each script page
  card: '#e6b84a', // the cover stock
  cardDark: '#b98a2a', // the label's shadow and the rims of the punched holes
  cardInk: '#4a3510', // the small print on the cover (6.3:1 on the card)
  brass: '#a8812f', // the brads
  brassLight: '#e9cf82', // the glint on each brad
  stamp: '#8f231c', // the draft stamp (4.7:1 on the card)
};
// Every colour is linked to its palette entry by id.
const col = (id) => ({ hex: palette[id], model: 'hex', paletteId: id });
// The engine's defaults link to main-color: pointed at the ink, anything left unset prints black.
const colorPalette = Object.entries({ ...palette, 'main-color': palette.ink })
  .map(([id, hex]) => ({ id, name: id, value: { hex, model: 'hex' } }));
const TEXT = 'Courier Prime';
const IN = 25.4; // mm in an inch: the format is specified in inches
const LEAD = 12; // pt: 12-point Courier at six lines to the inch, so one line is one grid line
const at = (to, edge, x = 0, y = 0) => ({ anchor: { to, edge }, offset: { x: mm(x), y: mm(y) } });

// #region page: US Letter, a 1.5-inch binding margin, Courier 12 on 12, ragged right
const MARGIN = { top: 1, bottom: 1, left: 1.5, right: 1 }; // inches: the left one takes the brads
const page = { sizePreset: 'custom', width: mm(8.5 * IN), height: mm(11 * IN), dpi: 150,
  margins: { top: mm(MARGIN.top * IN), bottom: mm(MARGIN.bottom * IN),
    left: mm(MARGIN.left * IN), right: mm(MARGIN.right * IN) } };
const bodyText = { fontFamily: TEXT, fontSize: pt(12), lineHeight: pt(LEAD), color: col('ink'),
  textAlign: 'left', firstLineIndent: pt(0), // action: flush left, never justified
  paragraphSpacing: true }; // a blank line between paragraphs
// #endregion

// #region answer: a speech is a callout with no frame, padded to the 3.5-inch dialogue block
// Positions from the left edge of the sheet, in inches, as screenwriting software gives them.
const DIALOGUE = { left: 2.5, right: 6 }; // the block of speech, 3.5 inches wide
const CUE = 3.7; // the character's name
const TEXT_RIGHT = 8.5 - MARGIN.right; // 7.5: where action lines end
const dialogue = {
  id: 'dialogue',

O script.js montado funciona como está: cole-o como script de módulo em qualquer página ou abra a receita no CodePen. Pasta da receita no GitHub ↗ (abre em uma nova aba)

Variações

#Devolva as falas à grade

Cada fala passa então a manter a margem inferior e a seguinte soma a margem superior, o que deixa duas linhas em branco entre as falas (três antes de um cabeçalho de cena) e empurra o roteiro para uma quarta página.

-  snapToGrid: false,
 };

#Escreva os cabeçalhos de cena sem negrito

Nos roteiros datilografados, os cabeçalhos de cena vinham só em maiúsculas; o negrito chegou com os programas de roteiro.

-  fontSize: pt(12), fontWeight: 700, lineHeight: 1, color: col('ink'), align: 'left',
+  fontSize: pt(12), fontWeight: 400, lineHeight: 1, color: col('ink'), align: 'left',
-      fontWeight: 700, lineHeight: 1, color: col('ink'), align: 'left', overflow: 'wrap',
+      fontWeight: 400, lineHeight: 1, color: col('ink'), align: 'left', overflow: 'wrap',

Erros comuns

  • O Postext não imprime (MORE) sob uma fala que se divide entre duas páginas nem repete o nome acima do resto dela. Deixe keepTogether no valor padrão para que cada fala passe inteira para a página seguinte.
  • Os programas de roteiro acrescentam (CONT'D) ao nome automaticamente. Aqui ele faz parte do title do bloco, por isso digite-o você mesmo onde a fala de um personagem continua depois de uma linha de ação.
  • titleStyle.lineHeight mantém a fala na grade só enquanto for igual à entrelinha do texto. Um nome em corpo maior ou menor continua precisando desses 12 pt; sem eles, cada fala tira da grade as linhas seguintes.

Créditos

Texto
Texto original, CC BY 4.0
Fontes
Courier Prime (SIL OFL 1.1) · Special Elite (Apache 2.0) · Oswald (SIL OFL 1.1)
Sandbox