Exportador do Blender¶
O add-on OVB vive na barra lateral da 3D-view, sob a aba OVB. Ele transforma o que sua cena produz — traços do Grease Pencil, linhas Pencil+ ou uma imagem renderizada — no layout de pastas que o importador do Harmony lê, um frame por vez.
Existe uma árvore e um botão. Você monta a Structure do que o Harmony vai receber, diz o que cada passe produz e aperta Export Structure. O add-on roda os pipelines que a árvore pedir — Grease Pencil, render bitmap, Pencil+ — na ordem certa, sozinho.
O que um passe pode produzir¶
Toda folha da árvore é um passe — uma saída de exportação, uma subartlayer no Harmony (veja Structure e Subartlayers). O primeiro dropdown do painel Content diz o que o passe selecionado produz:
| Fonte | O que o Harmony recebe | |
|---|---|---|
 Vector |
Grease Pencil | seus traços, lidos diretamente, como SVG com a pressão real por ponto — o fino-para-grosso que você desenhou é o fino-para-grosso que chega. GP v3 e GP legado. |
| Vector |
Pencil+ | a geração de linha estilizada da PSOFT. O EPS que ele escreve é chapado, então o OVB reconstrói largura e cor amostrando o render raster (Pressure → Variable Width em Settings). |
 Bitmap |
Render Pass | uma sequência PNG direto da saída de um view layer — o beauty, ou qualquer passe / AOV que o node Render Layers expõe. |
| Bitmap |
Compositor | uma sequência PNG tirada de um node seu na árvore do compositor — um glow assado, uma imagem gradada, layers mescladas. O OVB se conecta a esse socket e não toca em mais nada na sua árvore. |
Passes vetoriais viram linhas de lápis editáveis do Harmony; passes bitmap viram layers bitmap do Toon Boom. Os dois podem viver no mesmo drawing, em art layers diferentes — o importador lê os dois juntos.
Pencil+ é opcional
O Grease Pencil é a fonte padrão e não precisa de nada extra. A fonte Pencil+ precisa do add-on Pencil+ 4 Line da PSOFT e do seu Pencil+ 4 Render App separado (a parte paga — o add-on Line gratuito sozinho não desenha linhas). Sem eles o passe apenas avisa; nada mais no add-on é afetado.
Camera¶
A câmera da cena de onde o OVB projeta. Todo passe — o raycast, o render, o frame do Pencil+ — é medido a partir desta câmera. Ela fica no topo e nunca se recolhe.
Structure¶
A árvore é o layout de pastas que o importador do Harmony lê, e o outliner do importador é seu espelho. Três níveis:
Drawing — um drawing do Harmony (um Read node). Output é a raiz: é a pasta de saída e o drawing raiz ao mesmo tempo, e por isso mantém sua marca própria. Um drawing nomeado abaixo dele é uma pasta dentro da saída, e vira seu próprio Read node na importação.- Containers de art layer — todo drawing nasce com as quatro do Harmony, em z-order:
Overlay, 
Line Art, 
Colour Art, 
Underlay — mais Flat, um passe que escreve direto na pasta do drawing sem art layer própria. Containers são fixos: nunca são renomeados e nunca guardam arte por conta própria. - Passes — as folhas. Cada um carrega uma caixa de enable, seu nome e o ícone do que produz: vetor ou bitmap. Vários passes em um container viram a pilha daquela art layer, de cima para baixo na ordem da árvore — a posição é o prefixo
NN_no disco.
Os chevrons dobram um drawing ou um container. Um Output dobrado ainda lista seus drawings, então a árvore recolhida lê como um resumo do que a exportação escreve.
A coluna de botões¶
| Botão | O que faz | |
|---|---|---|
+ |
Add Pass | um passe novo, nascido onde a seleção está: abaixo de um passe selecionado, por último em um container selecionado, na Line Art de um drawing selecionado. |
− |
Remove | o passe selecionado, ou um drawing inteiro com tudo dentro. |
| Add Drawing | uma pasta de drawing nova sob Output, com seus quatro containers. | |
| Add Existing Drawing | um drawing que já existe no disco — da árvore de outra exportação, ou uma pasta real na saída — para que duas exportações compartilhem um drawing (linhas SVG na Line Art de uma, um bitmap na Colour Art de outra). | |
| ▲ ▼ | Move Pass | para cima ou para baixo, cruzando as bordas dos containers — um passe anda pela árvore sem arrastar. |
| Generate — por objeto GP / por layer GP | um passe Grease Pencil por objeto, ou por objeto + layer. | |
| Generate — por Line Pencil+ / por Line + Line Set | um passe Pencil+ por Line, ou por Line + Line Set. | |
| Generate — Render Passes | um passe bitmap por view layer da cena. |
Os geradores são o jeito de um clique para abrir um setup inteiro em leque; cada resultado é um passe comum que você depois edita.
Um modo de drawing por art layer
Uma art layer do Harmony é ou vetorial ou bitmap. Um container com os dois tipos perderia um deles em silêncio na importação, então a árvore o marca em vermelho na linha do container (vector + bitmap in one art layer) e a exportação se recusa até você mover um dos passes.
A linha abaixo da árvore informa o custo de render: 1 view layer(s) — each one costs a render, e N compositor trees — N renders per frame quando os passes leem árvores diferentes. Um passe de render layer custa um render completo de cada frame; vários passes no mesmo view layer o compartilham.
Content — o que o passe selecionado pega¶
O painel abaixo da árvore depende da fonte do passe. O destino vive na árvore; só o quê é configurado aqui.
Grease Pencil¶
Um filtro sobre a cena. A linha de resumo abaixo do dropdown informa a que ele se resolve (STR-skateboard › all layers).
- Pickers de Collections, Objects, Layers — cada
+adiciona o que você tiver selecionado no viewport. Um picker vazio adiciona nada (não é "tudo"); um filtro vazio significa a cena inteira. - Layers habilita quando uma Collection ou Object é escolhido (um layer pertence a um objeto). Cada slot é um dropdown dos layers das fontes escolhidas; o conta-gotas adiciona em massa todos os layers que elas têm.
- Except (na linha Layers) inverte a lista de layers — pega todo layer menos esses.
- Um objeto já coberto por uma collection escolhida aparece acinzentado — escolhê-lo de novo é redundante, e o cinza diz isso.
- Export as-is (never hide) — pula a oclusão para este passe: linhas de velocidade, notas em raio-x, anotação.
Pencil+¶
Um filtro sobre sua configuração do Pencil+. Uma Line é a unidade de origem (o análogo de um objeto GP); um Line Set é a sub-unidade dentro dela (o análogo de um layer do GP) e é o que carrega os edge types e o brush.
- Lines — os nodes Pencil+ Line que o passe cobre. Vazio = todas as Lines.
- Line Sets — os Line Sets dentro das Lines escolhidas; desabilitado até uma Line ser escolhida. Vazio = todos os Line Sets dessas Lines. Except inverte.
Render Pass¶
- View Layer — o view layer a renderizar.
- Output — qual socket do node Render Layers daquele layer escrever: a Image (beauty) ou qualquer passe / AOV que ele expõe. A lista é lida do próprio node, então um AOV customizado aparece sem configuração extra.
O passe escreve PNG, RGBA, straight alpha, na resolução e porcentagem da cena.
Compositor¶
- Tree — a árvore de nodes do compositor a ler (a da cena, ou um node group).
- Node e Output — o node e o socket que o OVB pega. O OVB adiciona seu próprio File Output ao lado do seu graph para a exportação e o remove depois; seus nodes nunca são marcados, movidos ou desconectados.
Mantenha habilitados os view layers que sua cadeia lê — um layer desabilitado não alimenta nada no node que você escolheu.
Recipe — como o passe é estilizado¶
O card Recipe aparece para as duas fontes vetoriais. Ele é armazenado por passe: o passe de outline pode querer seu Line Art no topo só com contour; o passe de inline, o contrário — a partir dos mesmos modifiers.
Um card por modifier Line Art ou Thickness que o OVB controla nos objetos do passe:
- o nome (a identidade — como outline se distingue de inline);
- um alternador On — controla a câmera de render e o monitor do viewport;
- ▲ ▼ — reordena o modifier dentro deste passe;
- Line Radius (Line Art) ou Factor / Thickness (modifier Thickness);
- os seis edge types do Grease Pencil — Contour (com seu modo, ex.: Silhouette), Crease (com seu ângulo), Material, Edge Mark, Intersection, Loose.
Um card por (Line › Line Set) a que o filtro se resolve, nascido da configuração atual do seu Line Set:
- um alternador On para aquele Line Set;
- duas colunas independentes, Visible e Hidden, sobre os oito edge types do Pencil+ — Outline, Object, Intersection, Smoothing Boundary, Material Boundary, Selected Edges, Normal Angle, Wireframe;
- um multiplicador Thickness —
1.00deixa seus tamanhos como estão; ele escala todos os brushes visíveis do Line Set de uma vez.
Live Preview vem desligado por padrão
- Off: a receita é aplicada apenas na exportação. Seu viewport, seus modifiers e seu histórico de undo ficam intactos — Cards are applied only on export.
- On: a cena segue o passe selecionado, para que o viewport mostre o que ele exporta — o que escreve nos seus modifiers ou Line Sets a cada edição.
Restore Defaults coloca sua própria configuração de volta (e reseta os cards); o botão ⟳ torna o estado atual o novo padrão do qual novos passes partem. Desligar o Live Preview restaura automaticamente — um preview nunca suja sua configuração para sempre.
Output¶
- Folder — onde a árvore é escrita. Aponte o importador do Harmony para esta pasta.
- Clean Art Folders — opcional e destrutivo: antes de exportar, apaga pastas de passe
NN_que uma exportação anterior deixou e que esta não escreve mais. Apenas pastas que o OVB reconhece como suas são tocadas. Desligado por padrão. - Vector Format — SVG, PDF ou AI, para os passes vetoriais. O SVG mantém a pressão por ponto (
data-widths); PDF e AI desenham uma largura por linha, e o painel avisa enquanto um deles está escolhido. Um.aisão os bytes do PDF com a extensão do Illustrator (contêiner PDF desde o Illustrator 9) — abre no Illustrator com os caminhos editáveis. - Bitmap Format — TGA, PNG ou TIF, e vale só para passes de bitmap. A lista é curta porque estes arquivos são reimportados no Harmony: precisam do alfa, senão a arte entra como um retângulo preenchido, e compressão com perda degrada arte que está voltando para uma cena. JPG é escolha do exportador do Harmony, nunca de um passe. Esta opção não toca num passe vetorial: um passe vetorial do Pencil+ sai em SVG, e o PNG escrito ao lado é andaime que o exportador usa para ler a espessura real de volta dos pixels, numa pasta temporária própria.
- Bitmap passes: PNG, RGBA, straight alpha — informado, não escolhido.
Export¶
- Frame Range — Start / End, ou Scene Range.
- Occlusion — a regra em duas linhas: meshes block lines, render icon off = exempt. Show in Viewport pinta traços mantidos vs descartados a partir da câmera antes de você confirmar. Apenas Grease Pencil; a história completa está na página Oclusão.
- Fills — um traço do Grease Pencil que carrega fill (os traços de fill do 5.1) sai como path preenchido; um cujo contorno está escondido sai só como fill, e um material de gradiente de duas cores vira um gradiente SVG com o mesmo eixo. Um fill sai inteiro ou não sai: a oclusão corta linhas ponto a ponto, mas um polígono cortado não é mais um fill, então ele fica enquanto algum ponto é visto e some só quando todos estão escondidos.
- Export Structure — roda a árvore inteira. A ordem é do mais barato e menos contaminante primeiro: Grease Pencil (sem render) → bitmap (um render por frame, todos os passes) → Pencil+ (um render por frame por passe). As verificações bloqueantes — tipos misturados, colisões de nome, árvores ausentes — rodam antes de qualquer render, sobre a árvore inteira.
Import¶
A ponte no outro sentido, com a forma do importer do Harmony: uma lista à qual você adiciona, e depois importa. Add abre o navegador: marque um .svg ou vários e cada um é um desenho; não marque nada e a pasta em que você está é a origem, ou marque uma pasta e clique em Add Folder na barra lateral para adicioná-la sem entrar — a pasta de um desenho, ou um export inteiro do OVB, lido do jeito que o importer do Harmony lê — desenhos, art layers, e dentro de cada art layer suas tracks (frames soltos na pasta, depois subpastas NN_ por número, depois as demais), cada track vetor (.svg) ou bitmap (PNG/TGA/TIF). Frames soltos na pasta do desenho não nomeiam art layer nenhuma, então entram em cima do Line Art e o relatório diz isso. Nada some sem aviso.
O que o Add achou fica listado no card Import: cada desenho, cada art layer com o glifo da própria suíte, vetor ou bitmap, quantas tracks e frames — uma caixa por art layer, um remover por desenho, e dá para somar de várias pastas antes de decidir. Import Drawings roda sobre essa lista. Depois, o painel no canto inferior esquerdo (ou F9) refaz o resultado ao vivo enquanto você muda qualquer opção; esse painel é o preview, e a lista fica para outro import com outras escolhas.
- Arte vetorial vira Grease Pencil: uma camada GP por track (
Line Art / outline), as larguras por ponto do exporter do Harmony como raio do traço, cores como materiais, gradiente como material de gradiente com o eixo no traço. - Arte bitmap vira um plano de imagem por track (sequência de imagens quando tem vários frames), no mesmo plano e fit da arte vetorial, para as duas registrarem pixel a pixel. Bitmap Shader: Shadeless (cor e alfa direto na saída, blended) ou Principled.
- Art Layers — a estrutura. Objects: cada art layer é um objeto próprio, Grease Pencil para vetor, plano de imagem para bitmap, tudo numa Collection com o nome do desenho — anime e esconda por art layer, como o Harmony faz. Layers: um objeto Grease Pencil por desenho, art layer vira camada (ou layer group quando tem várias tracks), tracks bitmap como planos ao lado. Objetos num mesmo plano de câmera recuam um fio ao longo da vista pela posição na pilha, para o Overlay ficar sobre o Underlay.
- Placement — Fit to Camera põe o desenho num plano a Distance metros na frente da câmera ativa, com a proporção mantida e centralizado, de modo que um export do OVB reimporta onde a câmera o viu. Sem câmera: um Plane do mundo (Front, Top, Side) a Metres per Pixel. Parent to Camera e Lock Transform são para arte de referência.
- Geometry — Curves: Bezier mantém um ponto de controle por âncora do SVG com seus handles; Points achata, com Curve Steps por segmento curvo. Thickness multiplica todo raio; Uniform Thickness ignora as larguras por ponto.
- Frames — Keep Source Frame Numbers põe o
0011.svgno frame 11 da cena, a mesma regra que o exporter do Harmony mantém. Senão o primeiro frame cai em Frame Start, buracos preservados, e Hold estica o tempo. - Into — objetos New, ou o Active Object: camadas achadas pelo nome ou criadas, frames somados, frame existente Skipped ou Replaced.
- Materials — Reuse Materials pega um material existente com o mesmo nome como está, então o seu recolor fica. Gradients: Gradient Material ou Flat no primeiro stop.
Reload. Um objeto importado lembra de onde veio. Com ele selecionado, Reload no card Import relê a origem no lugar: um objeto Grease Pencil tem camadas e frames refeitos, um plano de imagem relê a imagem, e transform, parent, modificadores e qualquer material que você recoloriu continuam seus.
Gradiente na viewport
Em shading Solid com a cor em Material, o Blender desenha todo fill do Grease Pencil chapado — é a regra do Blender para esse modo, não um gradiente perdido. Troque a cor da viewport para Texture, ou use Material Preview ou um render, e a rampa está lá.
O Import SVG as Grease Pencil nativo do Blender continua existindo; ele funde as art layers e descarta as larguras por ponto, que é justamente o que este guarda.
Settings¶
Exibido para o passe vetorial selecionado.
Grease Pencil — Raycasting
- Surface Bias — encurta o raio de oclusão em direção à câmera, para que um traço apoiado sobre uma superfície não seja bloqueado por essa superfície.
- Ignore Thinner Than — uma obstrução mais fina que isso é atravessada (o teste de lasca);
0desliga. - Gap Tolerance — quantos pontos descartados um traço pode transpor antes de ser dividido em dois.
- Stroke Width — a largura base escrita no SVG.
- Pressure → Variable Width — leva a pressão por ponto para o SVG. Desligado exporta uma largura uniforme.
Pencil+ — Include hidden lines também exporta as linhas que o Pencil+ marca como ocultas; Use pressure mantém a largura variável reconstruída.
Licença¶
Status do trial, Activate License e Return License — o ponto de entrada no Blender da licença que cobre Blender, Maya e Harmony nesta máquina.