Linha de comando

flatty -h imprime tudo. Nada aqui é necessário para o uso comum — isto é para scripts de construção, para reproduzir um relatório de erro e para abrir a app já apontada para algo.

Abrir algo

Sinalizador	Faz
`-open <path>`	abre um projeto: a sua pasta ou o seu `project.fdraw`
`-project <dir>`	a pasta do projeto em que trabalhar; criada por `-save` se ainda não existe
`-name "Nice Name"`	o nome do projeto, que também define os nomes dos ficheiros exportados
`-palette <file>`	importa um ficheiro de paleta ao arrancar
`-tool <name>`	coloca uma ferramenta à mão: `brush`, `bucket`, `texture`, `glyph`, `flextrude`, `shapes` ou `generator`
`-no-launcher`	salta o seletor de arranque
`-show-launcher`	força-o, mesmo que outra coisa o tivesse saltado

Funcionamento sem interface

Sinalizador	Faz
`-save`	escreve o ficheiro de projeto e sai
`-export`	escreve `exports/` e `exports/latest/`, depois sai

flatty -project ./sprites/cloud -demo cloud -save   # cria-a e escreve o ficheiro de projeto
flatty -open ./sprites/cloud -export                # escreve as exportações

Ambas precisam de um sítio para escrever, por isso recusam funcionar sem -project ou -open em vez de inventarem um caminho. Derivar um a partir de uma raiz mais o título é o que costumava mover o trabalho de alguém quando renomeava um projeto.

Uma execução com script não escreve definições. -project, -save, -export e -screenshot suprimem escritas de configuração, para que uma execução indicada o que fazer não reescreva o seu histórico, espaços de trabalho ou preferências como efeito secundário. O painel Definições diz Não guarda quando isto está em vigor.

A janela

Sinalizador	Faz
`-width N` / `-height N`	tamanho da janela; 0 preenche o monitor
`-layout <id>`	começa com um esquema integrado em vez dos espaços de trabalho guardados
`-workspaces N`	começa com N espaços de trabalho, mostrando um vazio
`-theme <id>`	tema da interface apenas para esta execução, por id
`-lang <code>`	idioma da interface apenas para esta execução: `en`, `pl`, `es`, `de`, `pt`

Os ids dos esquemas são default, full, deck, palette, settings e rico-full. São ids e não os nomes que o painel mostra — default é Simples, full é Claudy, rico-full é Rico — porque um id tem de continuar a funcionar depois de um esquema ser renomeado. Nenhuma flag restaura a sua sessão; um nome que não é integrado para a execução em vez de silenciosamente lhe devolver os seus próprios espaços de trabalho.

Os ids dos temas são organic, night-wave e os cinco humores — night-wave-jungle, night-wave-kapuccino, night-wave-soft, night-wave-soft-jungle e night-wave-soft-kapuccino — mais qualquer um do seu. Um nome que não é nenhum deles para a execução e imprime a lista.

-theme e -lang não mudam nada no disco: são apenas para esta execução.

Abrir um painel ao arrancar

Cada uma faz exatamente o que um clique algures na interface faz. Existem para que um painel possa ser fotografado ou reproduzido sem uma mão no rato.

Sinalizador	Abre
`-show-help`	o cartão de ajuda da app
`-show-setup`	o painel de configuração
`-show-commands`	a paleta de comandos
`-show-knife`	o canivete suíço, fixo aberto
`-show-picker`	o seletor de projetos
`-show-new-project`	o painel Novo Projeto
`-show-quit`	o diálogo de saída
`-show-unsaved`	o diálogo de alterações por guardar
`-show-wheel`	a roda de cores
`-show-layouts`	o painel Disposições
`-show-media`	o painel Media
`-show-vector`	o painel Vector
`-show-recorder`	o painel Gravador
`-show-glyphs`	o painel Caracteres, com o carimbo à mão
`-show-keys`	o painel Teclas
`-show-texture-picker`	o navegador de ficheiros em modo de ficheiro
`-edit-image <file>`	o editor de imagem, a caminho da biblioteca Media
`-place-image <file>`	o editor de imagem, a caminho da tela
`-popout <name>`	destaca um painel sobre o espaço de trabalho — qualquer nome escrito do painel: `settings`, `keys`, `theme`, `view3d`, `vector`, `export`, `recorder`, …
`-record`	começa uma gravação logo e sai quando está escrita. Precisa de `-project` ou `-open` e não vai filmar a tela — essa espera que alguém desenhe. Filmar a janela é permitido: acaba sozinha no limite do seu cartão

Capturas de ecrã e desenho de teste

Sinalizador	Faz
`-screenshot <file>`	renderiza N quadros, escreve um PNG, sai
`-frames N`	quantos quadros primeiro. Padrão 30
`-demo <name>`	semeia desenho de teste
`-show-redraw`	colore cada painel no quadro em que é redesenhado, para ver quais estão a ser mantidos

-demo toma cloud, layers, mirror, clip, lasso, palettes, deck, deckback, decksolo e texture.

Duas coisas sobre -screenshot valem a pena saber, porque ambas parecem erros:

Escreve relativo ao diretório atual, não onde pensou que pediu. Um caminho absoluto falha.
Uma contagem -frames baixa mal avança uma animação. Os primeiros quadros ainda não são cadenciados pela exibição, por isso -frames 30 pode ser centésimos de segundo de tempo animado — e qualquer coisa que se mova parece não estar a desenhar nada. Use 60 ou mais antes de concluir que algo está quebrado.

-screenshot também desliga dicas de ferramentas e hover durante a execução, porque uma execução com script não tem uma mão no apontador e o apontador fica onde o compositor o deixou.