Opções do Composer

Ambos ygofab compose e ygopic executam este módulo chamado Composer, que possui um conjunto de opções/parâmetros em comum, mas são especificados de forma diferente. ygofab compose pega os valores definidos nos picsets e os passa para o Composer, enquanto o ygopic pega os argumentos e flags passados diretamente pela linha de comando para o Composer. No primeiro caso, use o nome de cada opção nos picsets, e no segundo caso, use os nomes nas flags assim: --opção (ex.: --size 256x), exceto o mode, que é o primeiro argumento obrigatório do ygopic. Segue uma lista dessas opções e seus significados.

Opções

• mode: define qual modo de geração de cartas deve ser usado. Atualmente, a YGOFabrica suporta o layout padrão das cartas Yu-Gi-Oh! (modo chamado proxy) e um layout ao estilo do anime (modo chamado anime). Esta é a única opção definida no ygopic sem uma flag.
• size: define as dimensões finais das imagens. Ao atribuir <largura>x<altura> como o valor para esta opção, a largura final da imagem será <largura> e a altura, <altura>, então as proporções podem ser distorcidas. Se você quiser limitar o tamanho sem perder as proporções, omita ou a <largura> ou a <altura> (ex.: 256x limita a largura pra 256 px, x300 limita a altura pra 300 px). Se esta opção for omitida como um todo, a imagem final será mantida na sua qualidade total (694x1012 pro proxy e 570x831 pro anime).
• ext: define a extensão de arquivo usada na saída, como png ou jpg. Por padrão é jpg.
• artsize: define com a arte das cartas devem ser encaixadas no seu espaço. Valores possíveis são cover (a arte vai ser aumentada até cobrir o espaço), contain (a arte vai ser diminuída até estar contida no espaço, e o espaço excedente é preenchido com uma cópia borrada da arte) e fill (redimensiona a imagem pra preencher exatamente o espaço, quebrando as proporções). Por padrão é cover.
• year: define um ano a ser usado no modo proxy na linha de copyright. Por padrão é 1996.
• author: define um autor a ser usado no modo proxy na linha de copyright. Por padrão é KAZUKI TAKAHASHI.
• field: se definido, pra cada Card de Magia de Campo encontrado, um plano de fundo de campo será criado numa subpasta field.
• color-<tipo>: Muda a cor do nome de cartas no modo proxy, de acordo com seu <tipo>. O valor desta opção deve ser uma string em formato hexadecimal, ex.: #ffffff pra branco. Como pode imaginar, as opções disponíveis são: color-token, color-spell, color-trap, color-normal, color-effect, color-ritual, color-fusion, color-synchro, color-xyz e color-link.
• locale: define qual idioma será usado no texto das cartas, como já mencionado. Atualmente os idiomas disponíveis são inglês (en) e português (pt). Se não for definido, o idioma da interface será usado.
• holo: define se o holograma (aquele pequeno adesivo colado no canto inferior direito das cartas) deve ser colocado no modo proxy. Se não for especificado ou se for true, o holograma é colocado. Se for definido para false, o holograma não é colocado.

Algumas dessas opções podem ser definidas separadamente pra cada carta, e nesse caso, o valor especificado individualmente toma precedência sobre o mais geral.

Exemplos

Segue alguns exemplos das mesmas opções especificadas para os comandos diferentes.

[picset.anime]
mode = 'anime'
size = '361x'
artsize = 'contain'
ext = 'jpg'
field = true

$ ygopic anime /path/to/artwork /path/to/cdb /output/path --size 361x --artsize contain --ext jpg --field

Isso produz imagens ao estilo anime, com 361 px de largura, em .jpg, com a arta completamete contida no seu espaço, e todo Card de Magia de Campo ganha um plano de fundo.

---

[picset.hd]
mode = 'proxy'
ext = 'png'
locale = 'pt'
author = 'PIFACE'
year = 2021
color-effect = '#ffffff'
color-spell = '#ffffff'
color-trap = '#ffffff'
holo = false

$ ygopic proxy /path/to/artwork /path/to/cdb /output/path --ext png --author PIFACE --year 2021 --holo false

Isto cria imagens no estilo padrão com o máximo de resolução, em .png, com o copyright mudado para "©2021 PIFACE", e a cor dos nomes dos Monstros de Efeito e dos Cards de Magia/Armadilha mudada para branco. Além disso, o holograma não é colocado.