Pixerate/pixerate-brushes

Pincéis

Um pincel é composto por facetas que definem o que ele é e como se comporta, não qual mecanismo o desenha. Apenas id, nome, tipo e ponta.forma são obrigatórios; todos os outros campos usam o padrão do mecanismo que as facetas selecionam, então um pincel armazena apenas o que o torna único. A biblioteca contém os predefinidos nativos (somente leitura) e os pincéis do usuário, compartilhados por todos os editores que pintam.

Faceta (campo)	O que contém
Tipo	marca aplica um material; ferramenta trabalha sobre tinta já aplicada.
Meio e variedade	Marcas: o que aplica (tinta, nanquim, seco, spray) e de que tipo (óleo, aquarela, guache, lápis, carvão, aerógrafo, marcador, marca-texto…). Descritivo, para encontrar pincéis; um pincel úmido cuja variedade é aquarela, guache ou óleo pinta esse meio.
Ferramenta	Ferramentas: borracha, misturador, borrão, e em tinta úmida água, secador, sopro, absorvente, mistura-úmida, arrasto-úmido.
Ponta	forma (redonda, chata, chanfrada são elipses definidas por arredondamento e ângulo; cerdas tem um tufo; carimbo assume a forma de carimbos: um carimbo de editor editor:estrela, qualquer referência de adesivo de find_stickers, ou uma fonte de imagem source:<id> de list_brush_sources), tamanho em px, dureza (uma ponta de imagem desvanece nas bordas abaixo de 1), espaçamento, opacidade, fluxo, modo de mesclagem, e grão: textura dentro de cada pincelada (fonte: um padrão como áspero, tela, lixado, ou source:<id>; modo texturizado permanece fixo na tela, móvel rola com a ponta; escala, profundidade, contraste, inverter).
Marcas	contínuas pinceladas (padrão; em uma ponta de carimbo, cada pincelada é a forma do primeiro carimbo, na cor da tinta), dispersão (um spray: gotículas espalhadas pela ponta, densidade, tamanho), partículas (fios, molas, fitas, faíscas; pontos texturizados dos carimbos) ou objetos (cada marca um adesivo editável, em suas próprias cores).
Dinâmica	Sensibilidade à caneta: pressão para tamanho e opacidade, suavização, inclinação, velocidade, vibração (tamanhoVibracao, anguloVibracao para rotação, opacidadeVibracao, dispersao), rotação, contagem (pinceladas por passo de espaçamento, cada uma com vibração) e inverter (espelhar pinceladas aleatoriamente: x, y, xy).
Comportamento	superfície seca, úmida (configurações úmida) ou espessa (configurações espessa de impasto); grão do papel; troca (captura e mistura; um reservatório cria um Pincel de Mistura); força da ferramenta.
Luz	Luz que o pincel emite (quantidade), além de espalhamento e brilho sugeridos para a camada.
Movimento	Animação após pintar (efeito de tinta viva, velocidadeOnda de partículas).
Cor	Uma cor padrão, uma paleta de até 16 cores, própria (sempre sua própria cor). Cada uma é uma cor hex ou rgba(), um par claro / escuro { claro, escuro }, um gradiente ou tinta de efeito. Um gradiente padrão é sempre pintado; um padrão sólido ou claro/escuro se torna a cor do editor quando o pincel é escolhido (a menos que o usuário tenha bloqueado a sua), resolvido para o esquema de cores. Traçados de canvas e traçados de pincel vetorial também a usam, quando não recebem nenhuma cor. Canvas e vetor têm o mesmo bloqueio (canvas.setColorLocked, vector.setColorLocked), e uma cor de canvas obtida de um padrão claro/escuro segue o esquema como o editor de pintura; traçados vetoriais já feitos mantêm as suas.

Como os meios mapeiam para facetas: um lápis ou carvão é seco com alto grão e inclinação; nanquim é uma ponta redonda dura com pressão para tamanho (uma caneta afina com a velocidade); aquarela e óleo úmido são tinta em superfície: 'úmida'; impasto é superfície: 'espessa'; um aerógrafo é spray, macio e de baixo fluxo; uma lata de spray é spray com marcas de dispersão; uma esferográfica, caneta gel ou caneta fina é nanquim com uma ponta pequena e dura (uma caneta fina sem pressão para tamanho); giz de cera e giz são seco com alto grão; um marca-texto é nanquim / marca-texto, uma ponta chanfrada multiplicativa com um pouco de luz, raio de espalhamento 0, amarelo fluorescente por padrão; um pincel de carimbo é uma ponta carimbo com marcas contínuas; pincéis de partícula e adesivo são marcas de partículas ou objetos em uma ponta carimbo. Um pincel de imagem (uma marca de carvão digitalizada, uma folha, uma textura de pincel seco) é uma ponta carimbo cujo carimbo é uma fonte de imagem, geralmente com ponta.grão, anguloVibracao, inverter e um pouco de dispersao para que as repetições não apareçam.

Fontes de imagem são as imagens a partir das quais pontas e grãos são feitos, mantidas na biblioteca com seus bytes (uma máscara cinza, no máximo 512 px) e sua licença. add_brush_source cria uma a partir de um PNG: as marcas são lidas de sua transparência, suas partes escuras (uma digitalização em papel) ou suas partes claras (branco sobre preto). Arquivos de biblioteca (export_brushes) e pinturas salvas carregam as fontes que seus pincéis nomeiam, para que pintem e reproduzam da mesma forma em qualquer lugar.

Perfis de host

Cada host renderiza uma parte disso. check_brush informa o que um host recusa (erros) e o que ele pinta sem (avisos), cada um com uma correção; listas e gravações usam o host atual.

Host	Renderiza
Editor de pintura (paint)	Tudo, incluindo pontas de imagem e grão de ponta.
Editor de imagens (image)	Pinceladas secas em pontas redondas, chatas e chanfradas, o Pincel de Mistura e a borracha; sem superfície úmida ou espessa, partículas, objetos, pontas de carimbo ou imagem, luz ou movimento; ele pinta sem grão de ponta e contagem. Escolha um com set_brush_preset.
Canvas (canvas)	Pincéis secos de pinceladas ao longo de um caminho (sem ferramentas, úmido, espesso, partículas, objetos, pontas de carimbo ou imagem, ou luz); velocidade, grão de ponta e contagem são ignorados. Desenhe com um como canvas.drawFreehand brush.
Traçados vetoriais (vector)	Como canvas, mais tinta úmida (aquarela, guache, óleos úmidos: simulados na própria área do traçado, depois secos), o Pincel de Mistura e as ferramentas de borrão e misturador (agindo nas formas abaixo do traçado); pincéis de luz pintam como cor sólida. As ferramentas úmidas (água, secador, sopro, mistura úmida, arrasto úmido, absorvente), tinta espessa, partículas, objetos e borrachas são recusadas. Desenhe com um como vector.addBrushstroke brushId.

Cada host lista os predefinidos que seu perfil admite e os pincéis salvos da biblioteca que admite, e cada um registra essas ferramentas com seu próprio perfil, então list_brush_presets mostra os pincéis desse host. As pessoas editam pincéis em cada host com o mesmo editor de pincéis, com o mesmo escopo: ele mostra apenas os controles que o host usa (sem velocidade no canvas, sem grão no editor de imagens), e o que o pincel tem para outros hosts é mantido ao salvar. As ferramentas seguem a mesma regra (veja Armadilhas). Um pincel salvo usado em canvas ou traçados vetoriais é copiado para o traçado, para que o documento renderize onde a biblioteca não está; alterar o pincel na biblioteca posteriormente não altera traçados já desenhados.

Método de trabalho

1. Encontre o pincel mais próximo. list_brush_presets com meio, variedade, tipo ou texto. Ele lista apenas o que este host pode renderizar (all: true lista o restante com renderizavel).
2. Leia-o. describe_brush para a especificação completa, o mecanismo para o qual resolve e sua verificação.
3. Crie um pincel. create_brush com um novo id, um nome, baseadoEm no predefinido mais próximo e apenas as facetas que mudam (objetos mesclam; listas substituem). Leia problemas (valores limitados ou descartados) e avisos. Um pincel que o host não pode renderizar é recusado e nada é salvo.
4. Observe-o. preview_brush quando o host tem um renderizador; caso contrário, pinte um traço de teste no editor (set_brush com o novo id, depois paint_stroke).
5. Ajuste-o. update_brush com as facetas a alterar, ou unset para descartar facetas inteiras. Ele retorna os caminhos das folhas alterados. Predefinidos nativos não podem ser alterados: duplicate_brush primeiro.
6. A partir de uma imagem. add_brush_source com o PNG (canal quando auto escolhe a parte errada; mantenha a licença com a qual veio), depois create_brush com ponta: { forma: "carimbo", carimbos: ["source:<id>"] } para uma ponta de imagem, ou ponta.grao.fonte para grão. list_brush_sources lista as fontes e quais pincéis usam cada uma.
7. Importe um pacote. import_brush_pack com o arquivo (base64), seu nomeDoArquivo e a licença com a qual veio. Leia pinceis (com renderizavel para este host), naoSuportados (o que não foi mapeado) e licenca, depois preview_brush alguns e ajuste-os com update_brush.
8. Compartilhe-o. export_brushes escreve um arquivo de biblioteca; import_brushes adiciona um (arquivos versão 1 de pincéis mais antigos do editor de pintura são migrados). check_brush com host antes de entregar um pincel a outro editor.

Melhores práticas

• Comece do predefinido mais próximo e altere duas ou três facetas; um pincel do zero obtém padrões do mecanismo que raramente se adequam a um meio.
• Teste no papel e na cor em que o pincel será usado: a resposta do grão e os esmaltes parecem diferentes em papel liso e áspero.
• Dê a pincéis de luz papel escuro, e a marca-textos um raio de luz.espalhamento de 0 para que o brilho permaneça no traço.
• Mantenha a variedade verdadeira (é como as pessoas encontram o pincel) e adicione tags para o trabalho (lettering, folhagem).
• Dê a um pincel uma cor.padrao apenas quando o meio tem uma cor típica (esferográfica azul, marca-texto amarelo): escolher o pincel a define como a cor do usuário. Use um par claro/escuro quando a cor certa depende do fundo (giz branco em um quadro escuro, grafite em papel), e uma paleta para as outras cores usuais. Nanquins escuros também precisam de um par (azul marinho / azul claro, quase preto / quase branco): um único padrão escuro desaparece em um editor de esquema escuro. Verifique cada lado contra o fundo para o qual é destinado (pelo menos 3:1). cor.propria apenas para pincéis que devem sempre pintar sua própria cor (um marcador arco-íris).
• Pré-visualizações e miniaturas escolhem sua própria cor contra o fundo em que são desenhadas (o padrão do pincel quando ele lê lá, senão uma cor para o meio). Não dê a um pincel um padrão apenas para tornar sua pré-visualização visível: escolher o pincel torna esse padrão a cor do usuário.
• Pontas de carimbo pintam a forma do adesivo na cor da tinta; para manter as cores próprias de um adesivo, use marcas objetos.
• Pontas de imagem: recorte a imagem para a marca e dê a ela um fundo transparente ou simples, para que a pincelada seja a marca e não sua caixa. Espaçamento 0,2–0,4 para uma marca contínua, acima de 1 para impressões separadas; adicione anguloVibracao, inverter e dispersao para que a mesma imagem não se repita visivelmente.
• Grão: o grão texturizado (padrão) é uma textura que o traço revela, como papel; o grão móvel pertence à ponta e rola com ela (uma esponja, um rolo). Profundidade 0,4–0,7 lê-se como textura; 1 deixa apenas os picos. Use ponta.grao para a textura da ferramenta e comportamento.grao para a do papel.

Armadilhas

• Uma faceta que o host recusa. create_brush recusa-a, e update_brush recusa uma alteração que a adiciona, com a faceta e a correção; check_brush retorna degradado, o pincel com essas facetas removidas, para começar.
• Ajustar um pincel em um host que não pode pintar tudo dele. update_brush mantém o que o pincel já tem para outros hosts (a luz de um pincel de pintura, alterada do canvas) e lista em mantido; não é removido. Para fazer uma cópia apenas para este host, create_brush a partir do pincel degradado de check_brush.
• Ids. Ids nativos não podem ser reutilizados ou alterados; um id já usado é recusado (atualize-o em vez disso).
• Carimbos. Quaisquer marcas aceitam qualquer referência de adesivo de find_stickers, ou um carimbo do editor (editor:estrela…). Uma referência que a biblioteca de adesivos do host não pode carregar é recusada com as referências mais próximas. Apenas o editor de pintura renderiza pontas de carimbo e marcas de dispersão; canvas, vetor e o editor de imagens as recusam (check_brush informa).
• Fontes de imagem. Um source:<id> que a biblioteca não tem é recusado, com os ids mais próximos; adicione-o primeiro. Substituir a imagem de uma fonte (overwrite) altera todos os pincéis que a nomeiam, mas não traçados já pintados. Marcas de objetos aceitam apenas adesivos, então uma fonte de imagem lá é descartada (problemas informa). Pacotes de pincéis são frequentemente licenciados apenas para uso pessoal: mantenha o texto da licença com a fonte.
• Pacotes de pincéis. Apenas as pontas (e o grão do Procreate) são importados: dinâmicas, curvas de lápis, padrões, pincéis duplos e configurações úmidas são listados em naoSuportados, então pincéis importados pintam com sensação padrão; ajuste-os. Pontas de imagem importadas são pontas de carimbo, então canvas, vetor e o editor de imagens não podem pintá-las (renderizavel falso). Pacotes são frequentemente apenas para uso pessoal: passe e mantenha sua licença; nunca redistribua um arquivo de biblioteca de pincéis importados sem verificar.
• Valores fora do intervalo são recusados pelo esquema (ponta.tamanho é 1..2500 px); um pincel armazenado é limitado na importação e relatado em problemas.
• O editor de pintura pinta a partir desta biblioteca. Seu set_brush seleciona um pincel por id aqui e aplica facetas sobre ele sem salvar; create_brush / update_brush armazenam um. Um host de pintura registra essas ferramentas com sua própria pré-visualização (createPaintBrushLibraryToolProvider), então o editor de pintura não tem lista, salvar, exportar, importar ou ferramentas de miniatura próprias.

Habilidades de fluxo de trabalho

• pixerate-brushes-design: de uma descrição ("um marca-texto rosa suave", "giz para o canvas") a um pincel salvo e verificado.

Referência de ferramentas

Ferramenta	Uso
list_brush_presets	Encontre pincéis que este host renderiza: tipo, meio, variedade, ferramenta, tag, texto, fonte (todos, nativos, usuário), todos, offset, limite. Retorna pinceis (id, nome, nativo, tipo, meio, variedade ou ferramenta, categoria, mecanismo, ponta, tamanho, marcas, superfície, luz) e total. Chame primeiro.
describe_brush	Um pincel por id: sua faceta completa pincel (com sua cor: padrão, paleta, própria), nativo, mecanismo, categoria e verificacao para este host (adesivos de carimbo incluídos). Ids desconhecidos são recusados com os mais próximos.
create_brush	Salve um novo pincel: id, nome, opcional baseadoEm, e as facetas, cor incluída (para manter o pincel atual de um editor, passe o pincel que seu get_brush retorna). Normalizado e verificado para este host (e sua biblioteca de adesivos, para pontas de carimbo); pincéis recusados não salvam nada. Retorna id, pincel, mecanismo, problemas, avisos.
`upd

…

[truncado para tradução]