> [Site index](https://perfectvector.com/llms.txt) — available pages and descriptions.

# Marcadores SVG no QGIS: cores editáveis

> Prepare um marcador SVG QGIS com parâmetros de preenchimento e contorno, um recorte real e um detalhe fixo. Guarde um original SVG comum e inspecione a cópia de destino.

Source: https://perfectvector.com/pt-BR/blog/qgis-svg-markers

Language: pt-BR
Author: Irene Kim
Published: 2026-09-25T08:00:00+09:00

Para preparar um marcador SVG personalizado do QGIS com cores editáveis, adicione os marcadores de posição `param()` do QGIS aos atributos de pintura que você quer que o aplicativo controle. Mantenha cores explícitas nas regiões que devem permanecer fixas. O [manual do Seletor de Símbolos do QGIS 3.44](https://docs.qgis.org/3.44/en/docs/user_manual/style_library/symbol_selector.html#parametrizable-svg) documenta marcadores para preenchimento, contorno, suas opacidades e largura do contorno.

Comece com um símbolo pequeno e limpo. Um ícone que parece convincente em tamanho de ilustração pode perder sua abertura, seu detalhe ou seu contorno quando usado como marcador de mapa.

**Escopo deste guia:** renderizamos o original SVG comum em um navegador e auditamos o XML da cópia parametrizada. Não importamos a cópia no QGIS. A sintaxe dos parâmetros abaixo segue a documentação 3.44; as verificações de destino devem ser concluídas no aplicativo por você ou pelo destinatário que usa GIS.

## Guarde um original comum e uma cópia QGIS

Use dois arquivos com a mesma geometria:

| Arquivo             | Objetivo                                                                          |
| ------------------- | --------------------------------------------------------------------------------- |
| `marker-master.svg` | Pinturas SVG comuns para edição e inspeção no navegador.                          |
| `marker-qgis.svg`   | Uma cópia de destino com marcadores de parâmetros QGIS em atributos selecionados. |

Essa separação mantém a arte original fácil de inspecionar. Uma prévia no navegador do original comum comprova como essa origem é renderizada no navegador. Ela não prova que a cópia QGIS foi importada corretamente nem que seus controles se comportam como pretendido.

Nosso marcador original tem um corpo verde, uma abertura circular transparente e um detalhe de losango dourado. Ele contém dois traçados e nenhuma imagem raster incorporada.

**Arte de origem original**

![Renderização no navegador do SVG comum de um alfinete verde com abertura transparente e detalhe dourado fixo, incluindo prévias com 24, 32 e 48 pixels](https://perfectvector.com/blog/qgis-svg-markers/marker-source-test.webp)

*O original SVG comum renderizado em um navegador. O quadriculado aparece por sua abertura; isso não é uma importação QGIS nem um teste de parâmetros de cor.*

## Crie uma abertura real na origem

Salve isto como `marker-master.svg`:

```xml
<svg xmlns="http://www.w3.org/2000/svg"
     width="64" height="64" viewBox="0 0 64 64">
  <path id="body" fill="#237466" fill-opacity="1"
        stroke="#173f37" stroke-opacity="1" stroke-width="2"
        fill-rule="evenodd"
        d="M32 5C19 5 10 14 10 27C10 42 32 59 32 59S54 42 54 27C54 14 45 5 32 5Z M32 17A10 10 0 1 0 32 37A10 10 0 1 0 32 17Z"/>
  <path id="accent" fill="#f2c96c" stroke="none"
        d="M32 41L36 46L32 51L28 46Z"/>
</svg>
```

O traçado do corpo inclui um contorno externo e um contorno circular interno. `fill-rule="evenodd"` faz da região interna um recorte nesta construção. Ele mostra o fundo através do marcador em vez de pintar um disco branco por cima. A [referência de fill-rule do MDN](https://developer.mozilla.org/en-US/docs/Web/SVG/Reference/Attribute/fill-rule) explica como a regra determina quais regiões são preenchidas.

O [`viewBox`](https://developer.mozilla.org/en-US/docs/Web/SVG/Reference/Attribute/viewBox) define o retângulo de coordenadas da origem. Aqui ele é um quadrado de 64 unidades, com espaço ao redor do contorno. Mantenha esse enquadramento consistente entre as duas cópias. Se o símbolo parecer inesperadamente pequeno dentro dele, inspecione a geometria e as margens vazias antes de aumentar seu tamanho exibido.

O detalhe dourado é um traçado separado, o que deixa sua escolha de pintura explícita. Para um ícone mais elaborado, decida quais regiões pertencem à cor compartilhada do corpo antes de adicionar parâmetros. Nosso [guia de cores SVG](https://perfectvector.com/pt-BR/blog/how-to-change-svg-color) explica onde preenchimentos e contornos podem ser armazenados.

## Parametrize o corpo e deixe o detalhe fixo

Faça uma cópia chamada `marker-qgis.svg`. No traçado com `id="body"`, substitua seus cinco atributos de pintura por este bloco:

```xml
fill="param(fill) #237466"
fill-opacity="param(fill-opacity) 1"
stroke="param(outline) #173f37"
stroke-opacity="param(outline-opacity) 1"
stroke-width="param(outline-width) 2"
```

Mantenha os dados do traçado e `fill-rule` iguais. Deixe `fill="#f2c96c"` e `stroke="none"` do traçado `accent` como estão.

| Atributo SVG     | Marcador QGIS            | Controle pretendido                 |
| ---------------- | ------------------------ | ----------------------------------- |
| `fill`           | `param(fill)`            | Cor de preenchimento do corpo       |
| `fill-opacity`   | `param(fill-opacity)`    | Opacidade de preenchimento do corpo |
| `stroke`         | `param(outline)`         | Cor do contorno do corpo            |
| `stroke-opacity` | `param(outline-opacity)` | Opacidade do contorno do corpo      |
| `stroke-width`   | `param(outline-width)`   | Largura do contorno do corpo        |

Os valores após os marcadores são padrões opcionais na sintaxe QGIS. Eles não prometem que um visualizador SVG comum entenderá o valor parametrizado de pintura. Use o original comum para edição e prévia gerais de SVG.

Não substitua automaticamente todas as cores por `param(fill)`. Neste design, isso descartaria a decisão de manter o detalhe dourado separado. Aplique o marcador compartilhado apenas às regiões que devem responder ao mesmo controle.

## Audite a cópia de destino antes de entregá-la

Nossa verificação XML confirmou que os dois arquivos têm o mesmo `viewBox` e dados de traçados idênticos. A cópia QGIS contém os cinco marcadores pretendidos em `body`; `accent` mantém seu preenchimento dourado fixo. Não há elementos `<image>`, arquivos externos ou fontes neste exemplo.

Para seu próprio marcador, confira:

* A origem contém as formas vetoriais esperadas. Mudar um atributo de pintura não recolore pixels dentro de uma imagem incorporada como regiões separadas.
* Apenas os traçados pretendidos recebem parâmetros. Mantenha detalhes decorativos explícitos.
* Uma declaração de estilo não mantém um valor fixo de pintura conflitante em outro lugar do arquivo.
* O recorte permanece uma abertura real quando visto sobre um fundo contrastante.
* O marcador tem espaço suficiente para seu contorno sem um enquadramento vazio grande.

Uma análise XML bem-sucedida verifica a sintaxe. Ela não certifica que o renderizador de destino suporta todos os recursos SVG. Mantenha a origem simples e conclua as verificações no aplicativo em seguida.

## Confira o marcador no projeto QGIS do destinatário

No seletor do símbolo de ponto, escolha uma camada de símbolo **SVG marker** e carregue a cópia de destino. O manual QGIS da versão indicada acima descreve esse tipo de símbolo e seus controles disponíveis.

Antes de usar o símbolo em todo o mapa, peça ao destinatário que verifique o preenchimento, o contorno e a opacidade do corpo separadamente; confirme que o detalhe dourado permanece fixo; inspecione a abertura no tamanho pretendido do marcador; e reabra o projeto compartilhado com o arquivo do símbolo disponível. Inspecione também o mapa ou layout exportado, pois esse é o arquivo que o público receberá.

Essas verificações concluem a entrega. Nossa imagem no navegador e auditoria da origem cobrem a arte de entrada, enquanto o projeto QGIS real determina o resultado final.

## Quando o ícone começa como clipart raster

Se seu pictograma personalizado existe apenas como PNG ou JPG, a [ferramenta de clipart para SVG do PerfectVector](https://perfectvector.com/pt-BR/clipart-to-svg) pode recuperar arte vetorial para edição. Inspecione os traçados, simplifique detalhes que desaparecem no tamanho de marcador e separe o corpo de qualquer detalhe fixo antes de adicionar parâmetros QGIS. O [guia de preparação de ícones pequenos](https://perfectvector.com/pt-BR/blog/convert-png-icons-to-svg-for-ui-kit) aborda clareza da origem e limpeza em tamanhos pequenos.

Isso prepara a aparência de um símbolo. Não georreferencia uma imagem, não recupera coordenadas nem transforma um mapa desenhado em dados geográficos precisos. Nosso [guia de mapas desenhados à mão](https://perfectvector.com/pt-BR/blog/hand-drawn-map-vector) explica essa distinção. Se a entrada já tiver os traçados vetoriais necessários, use-a diretamente; o [guia de arquivos SVG](https://perfectvector.com/pt-BR/blog/what-is-an-svg-file) pode ajudar a inspecionar seu conteúdo.

## Perguntas frequentes

**Por que um marcador SVG importado não expõe as cores que eu quero?**
Confira se os atributos de pintura relevantes contêm os marcadores de parâmetros QGIS. Neste exemplo, apenas o corpo é parametrizado; o detalhe dourado é deliberadamente fixo. Depois verifique os controles na versão QGIS de destino.

**Posso manter uma cor de detalhe fixa?**
Deixe o preenchimento dessa região como uma cor explícita e aplique os parâmetros compartilhados apenas às regiões que você quer controlar. Mantenha o detalhe em um traçado separado para facilitar a auditoria da origem.

**Vetorizar um ícone o transforma em dados geográficos?**
Não. Isso cria arte para o símbolo. As localizações, coordenadas e precisão do mapa ainda dependem dos dados geográficos e do fluxo GIS.

## Fontes

1. [QGIS 3.44 — O Seletor de Símbolos](https://docs.qgis.org/3.44/en/docs/user_manual/style_library/symbol_selector.html#parametrizable-svg) — Parâmetros de marcadores SVG e padrões opcionais.
2. [MDN — fill-rule](https://developer.mozilla.org/en-US/docs/Web/SVG/Reference/Attribute/fill-rule) — Regiões preenchidas e a regra par-ímpar usada na abertura.
3. [MDN — viewBox](https://developer.mozilla.org/en-US/docs/Web/SVG/Reference/Attribute/viewBox) — O retângulo de coordenadas SVG usado pelas duas cópias de origem.

Para um pictograma raster, [converta o clipart em SVG](https://perfectvector.com/pt-BR/clipart-to-svg), inspecione a abertura e os pequenos detalhes e prepare uma cópia QGIS separada. Guarde o original comum e peça ao destinatário que teste as cores e a aparência do marcador no projeto real antes da entrega.

## Explore

- [Read the HTML article](https://perfectvector.com/pt-BR/blog/qgis-svg-markers)
- [Unidades de gradiente SVG: uma transição entre traçados](https://perfectvector.com/pt-BR/blog/svg-gradient-units.md)
- [SVG inline ou img: escolha o comportamento da arte](https://perfectvector.com/pt-BR/blog/inline-svg-vs-img.md)
- [Product facts](https://perfectvector.com/product-facts.md)
- [FAQ](https://perfectvector.com/faq.md)
- [Pricing and credits](https://perfectvector.com/pricing.md)
