O que um CSV de entrega leva a mais e a menos que um ALE

A planilha detalhada CSV e a lista ALE não são os mesmos dados com outra extensão. O CSV serve à leitura coluna por coluna feita por pessoas e por ferramentas de planilha, enquanto o ALE é uma lista de troca destinada ao fluxo de recebimento que o lê em máquina; os dois diferem no conjunto de valores admissíveis, na escrita dos valores ausentes, na codificação e no sentido dos campos. O CSV traz mais informação de câmera e de filmagem, mas continua sem ser um inventário de mídia e não oferece o mapeamento de canais; o timecode de início do som tem coluna própria, e valor que não passa na checagem de formato sai em branco na célula inteira.

Quando o formato muda, o que importa não é só “ter mais algumas colunas”, e sim de onde vem cada coluna e para quem ela deve ser conferida.

O que o CSV traz a mais é o detalhe de câmera e de filmagem

Comparado com o ALE, o CSV traz mais informação nas camadas de plano e de câmera. Distância focal, filtro, ISO, abertura, obturador, proporção da imagem, resolução, além de tamanho do plano, ângulo de filmagem e movimento, estão dentro do que esse detalhe tabular consegue expressar.

Ele também escreve alguns sinalizadores de estado: efeitos visuais, prancha, imagem limpa e referência acompanham a câmera daquela tomada, e MOS e wild track acompanham a própria tomada; todos podem ser marcados no registro da take, e ele leva junto a data de filmagem. Os dois sinalizadores de som se leem juntos: quando no banco estão ligados ao mesmo tempo MOS e wild track, a entrega sai como sem som; quando as duas colunas dizem FALSE, há duas possibilidades — a linha traz um fato de som síncrono, ou não deixa nada, e a célula sozinha não separa esses dois casos.

As notas da tomada e as notas da câmera também entram em colunas separadas. Ao gerar o CSV, quebras de linha, retornos de carro e tabulações dentro das notas são achatados em espaços, e por isso não se pode prometer “as notas ficam exatamente como foram escritas”. O que a parte receptora vê é texto já tratado para caber na tabela.

As três colunas de avaliação seguem regras próprias

O CSV tem a coluna Rating com o nome da avaliação em texto e uma coluna booleana Circle. O nome em texto é escrito como Circle, Keep, Hold ou N/G; sem marcação, pode ficar vazio. A coluna booleana Circle, por sua vez, escreve TRUE apenas na faixa que corresponde ao texto Circle, e FALSE em todos os outros casos.

Circled On Set também deriva do mesmo valor de avaliação, mas com uma regra mais ampla: tanto Circle quanto Keep escrevem TRUE, e as demais faixas escrevem FALSE. Por isso uma tomada Keep apresenta ao mesmo tempo Rating=Keep, Circle=FALSE e Circled On Set=TRUE.

Rating devolve o nome da avaliação em texto, Circle verifica apenas se a faixa é Circle, e Circled On Set inclui Circle e Keep como circuladas no set. As três colunas são três derivações de um mesmo valor de avaliação, não três estados independentes.

A parte receptora precisa mapear cada coluna separadamente. Olhar só Circle deixa de fora os textos Keep, Hold e N/G; olhar só Rating também não substitui o critério mais amplo de Circled On Set. As três colunas não se substituem nem servem como fontes independentes que se validem umas às outras.

O CSV continua sem posição de mídia e sem mapeamento de som

Mais campos não querem dizer que este arquivo tenha assumido toda a informação de vínculo com a mídia. A saída atual traz Source File Name e Source File Path, mais a coluna Sound TC para a posição de início do som — as duas células da fonte se preenchem por dois caminhos: pelo que foi copiado no set, ou quando o próprio app preenche essas mesmas células ao importar a mídia de um arquivo, sem sobrescrever o que já tinha sido copiado à mão. Para a posição de início do som só vale o primeiro caminho, e elas ficam vazias se não houve nenhum dos dois. Ele continua sem dizer onde a mídia está na sua máquina e continua sem mapeamento de canais: a posição do arquivo e a relação entre microfone e canal têm de vir da mídia e dos outros registros de passagem.

Do mesmo modo, aparecerem Filename, número do rolo ou identificador do clipe na tabela não transformam o arquivo, por si só, num inventário capaz de localizar toda a mídia. Os campos de identidade precisam ser cruzados com o nome real do arquivo de mídia, com o número do rolo e com o registro do set. Veja “Por que um arquivo de entrega não devolve um caminho até a mídia”.

A codificação e as regras de limpeza também diferem do ALE

O CSV é gravado com marca de ordem de bytes, e o ALE não. Os dois usam quebra de linha LF, mas o comportamento do ambiente de recebimento diante de codificação e quebras precisa ser medido na prática. Quando aparecer texto com caracteres trocados ou quando as colunas se deslocarem, confira primeiro codificação, separadores e tratamento de texto, antes de presumir que os campos de conteúdo estão errados.

Cada valor de dado do CSV passa pelo seu próprio caminho de escape. Quebras de linha e tabulações são achatadas; vírgulas e aspas duplas dentro do valor recebem aspas e escape conforme a regra atual. Esse comportamento descreve a forma de geração de hoje, e não deve ser ampliado para uma promessa de conformidade com alguma especificação externa de CSV.

A data também não segue um único critério em todas as entregas

A coluna Date do CSV é escrita num formato de máquina gregoriano fixo, yyyy-MM-dd. A data no cabeçalho de outro tipo de relatório segue, ela sim, o ajuste de formato de data do ambiente do aparelho. Os dois servem a situações de leitura diferentes, e por isso não se pode escrever que “a data em todas as entregas é necessariamente igual byte a byte”.

Se a parte receptora for confrontar arquivos entre si, deve tratar a diferença de formato dos campos de data como condição esperada e só então conferir se eles apontam para o mesmo dia. String diferente não implica necessariamente data diferente, e string igual não substitui a confirmação contra o registro de origem.

FAQ

O que o CSV traz a mais em relação ao ALE?

Principalmente detalhe mais fino de câmera, óptica, composição, estado e data, por exemplo distância focal, filtro, ISO, abertura, obturador, resolução, tamanho do plano, ângulo de filmagem e movimento.

Por que as colunas Rating e Circle podem parecer contraditórias?

As três colunas derivam do mesmo valor de avaliação, mas com regras diferentes: Rating escreve o texto, Circle escreve TRUE apenas quando a faixa é Circle, e Circled On Set escreve TRUE para Circle e Keep. Por isso uma tomada Keep resulta em Rating=Keep, Circle=FALSE e Circled On Set=TRUE.

O CSV preserva as notas exatamente como foram escritas?

Não caractere por caractere. Quebras de linha, retornos de carro e tabulações são achatados em espaços na geração, e a parte receptora vê o resultado tratado para caber na estrutura de linha da tabela.

Com mais campos, o CSV passa a localizar a mídia e os canais de som?

Em parte. As duas células da fonte têm duas origens: a cópia no set, ou o próprio app, que preenche essas mesmas células ao importar a mídia de um arquivo e nunca substitui o que já tinha sido copiado à mão. O timecode de início do som só tem a primeira origem; o que nunca chegou fica vazio; ainda omite o mapeamento de canais e não aponta para a mídia na sua máquina. Confira a posição da mídia e a relação do som na própria mídia e nas outras informações de passagem.

Axiom One LLC — SlateX