T2Mark Docs
Painel
Docs / Agente Windows / Template da Marca D'Água

Template da Marca D'Água

O template define exatamente como a marca d’água aparece na tela. Você pode customizar cores, fontes, ângulo, opacidade e o texto exibido usando variáveis dinâmicas que se adaptam a cada usuário e máquina.

Formato do Template

O template segue um padrão chamado Front Matter, comum em geradores de sites:

color=#FFFF00\nopacity=0.15\nfontsize=20\nfontsizesecondary=15\nfontfamily=Segoe UI\nangle=15\nbold=1\nenabled=1\n---\n{domain}\{user} | {date}\nCONFIDENCIAL

Estrutura

Regra Importante: \n Literal

⚠️ Use \n (barra invertida + n) como dois caracteres, não como quebra de linha real:

✅ CORRETO:   color=#FF0000\nopacity=0.5\n---\nTexto na linha 1\nTexto na linha 2
❌ ERRADO:    color=#FF0000
              opacity=0.5
              ---
              Texto na linha 1
              Texto na linha 2

O agente converte \n em quebra de linha real ao renderizar.


Metadados Visuais (Parte 1)

Cor Hexadecimal

color=#RRGGBB
Exemplo Valor Resultado
color=#FFFF00 Amarelo puro Amarelo brilhante
color=#FF0000 Vermelho puro Vermelho
color=#00FF00 Verde puro Verde
color=#FFFFFF Branco Branco
color=#000000 Preto Preto

Dica: Amarelo e branco são melhores para contraste com fundo claro ou escuro.

Opacidade (Transparência)

opacity=0.15
Valor Aparência
0.05 Muito transparente (quase invisível)
0.15 Leve (padrão, recomendado)
0.30 Moderada
0.50 Bem visível
1.00 Totalmente opaco (bloqueia conteúdo)

Recomendação: 0.15 a 0.25 para não interferar com o trabalho.

Tamanho da Fonte

fontsize=20          # Texto principal
fontsizesecondary=15 # Texto secundário (linha 2)
Valor Tamanho
12 Pequeno
16 Normal
20 Grande (padrão)
24 Muito grande
32 Enorme

Família de Fonte

fontfamily=Segoe UI

Fontes Windows comuns:

Ângulo de Rotação

angle=15
Valor Efeito
0 Horizontal (sem rotação)
15 Diagonal leve (padrão)
30 Diagonal moderada
-15 Diagonal para trás
90 Vertical (lê de baixo para cima)

Negrito

bold=1    # Ativado (mais visível)
bold=0    # Desativado

Habilitado/Desabilitado

enabled=1    # Marca d'água ativa
enabled=0    # Marca d'água desativada (ainda renderizada, mas invisível)

Variáveis Dinâmicas (Parte 2)

Depois do separador ---, você pode usar variáveis que se adaptam automaticamente:

Variáveis Disponíveis

Variável Valor Exemplo
{domain} Domínio Windows ACME (de ACME\joao.silva)
{user} Nome do usuário joao.silva
{date} Data atual 05/05/2026
{hostname} Nome da máquina PC-VENDAS-001

Usando Escape (Barra Invertida)

Para exibir uma barra literal (não como separador de domínio), use barra invertida dupla:

{domain}\{user}    # Renderiza: ACME\joao.silva

Exemplos Práticos

Exemplo 1: Simples (Padrão Recomendado)

color=#FFFF00\nopacity=0.15\nfontsize=20\nfontsizesecondary=15\nfontfamily=Segoe UI\nangle=15\nbold=1\nenabled=1\n---\n{domain}\{user} | {date}\nCONFIDENCIAL

Renderiza como:

ACME\joao.silva | 05/05/2026
CONFIDENCIAL

(em amarelo, levemente transparente, diagonal)


Exemplo 2: Simples Minimalista

color=#FF0000\nopacity=0.20\nfontsize=16\nfontfamily=Arial\nangle=0\nbold=0\nenabled=1\n---\n{user} @ {date}

Renderiza como:

joao.silva @ 05/05/2026

(em vermelho, horizontal, Arial)


Exemplo 3: Detalhado (Multi-linha)

color=#0000FF\nopacity=0.25\nfontsize=24\nfontsizesecondary=16\nfontfamily=Courier New\nangle=30\nbold=1\nenabled=1\n---\nRESTRITO\n{domain}\{user}\n{hostname}\n{date}

Renderiza como:

RESTRITO
ACME\joao.silva
PC-VENDAS-001
05/05/2026

(em azul, maior, diagonal acentuada)


Exemplo 4: Desabilitado Temporariamente

color=#FFFF00\nopacity=0.15\nfontsize=20\nfontfamily=Segoe UI\nangle=15\nbold=1\nenabled=0\n---\n{domain}\{user} | {date}\nCONFIDENCIAL

A marca d’água é renderizada mas invisível (útil para “desativar” sem perder config).


Renderização em Dois Níveis

O agente aplica um truque visual para garantir contraste em qualquer fundo (claro ou escuro):

  1. Camada 1: Texto na cor especificada
  2. Camada 2: Texto ligeiramente deslocado (1px) em cor invertida (RGB complement)

Isso garante que a marca d’água seja visível em fundos brancos, pretos ou cores.


Como Testar Seu Template

  1. No painel web, abra Política de Marca D’Água
  2. Customize as opções visuais (a visualização abaixo atualiza em tempo real)
  3. Copie o template final exibido
  4. Crie uma nova política com este template
  5. Associe a uma máquina teste
  6. Observe o agente receber e aplicar a marca

Tempo: ~5-10 segundos até a marca aparecer na tela (após polling de política)


Retrocompatibilidade (Legacy)

Se o template não contém o separador ---, é tratado como texto simples com valores visuais padrão:

Apenas texto
Sem metadados

Renderiza com configuração padrão (amarelo, 0.15 opacidade, etc).


Troubleshooting

Problema Causa Solução
Marca não aparece enabled=0 Mude para enabled=1
Texto muito pequeno fontsize baixo Aumente para 20+
Variáveis aparecem literais ({user}) Separador --- mal formatado Verifique \n---\n (com quebras ao redor)
Cores estranhas Formato hex inválido Use #RRGGBB (6 dígitos)
Caracteres quebrados Encoding incorreto Use UTF-8

Resumo Rápido

TEMPLATE = METADADOS + --- + TEXTO

Metadados importantes:
  • color=#RRGGBB (ex: #FFFF00 = amarelo)
  • opacity=0.15 (0.05 a 1.00)
  • fontsize=20
  • angle=15

Variáveis no texto:
  • {domain} = domínio Windows
  • {user} = usuário logado
  • {date} = data (DD/MM/YYYY)
  • {hostname} = nome máquina

Use \n para quebras de linha (literal)
Use \n---\n para separar metadados do texto