Sample lines no Civil 3D: como criar linhas de amostra automaticamente, em qualquer estaca, sem refazê-las a cada mudança

Uma linha de amostra diz onde a via é cortada e com qual largura. Em cada linha, o Civil 3D corta as fontes que você escolher —o terreno natural, o corredor, as superfícies do corredor e também as redes de tubulação— e com isso monta a seção transversal.

Delas depende tudo o que vem depois:

• As vistas de seção, uma por linha.
• Os volumes de corte e aterro, calculados entre seções.
• O diagrama de massas e as pranchas de seções.

Por isso as linhas vivem num grupo de linhas de amostra, que pertence a um alinhamento. O grupo guarda as fontes, os estilos e os rótulos de todas as suas linhas.

O comando fica na guia Início › Gráficos do perfil longitudinal e de seção › Linhas de amostra. Na linha de comando é _CREATESAMPLELINES, em qualquer idioma.

Você escolhe o alinhamento. Se for o primeiro grupo, abre-se Criar/Editar grupo de linhas de amostra, onde se escolhem as fontes e os estilos. Depois aparece a barra Ferramentas de linha de amostra, com cinco formas de criá-las:

A largura para cada lado é definida ao criá-las: um valor fixo, ou «presa» a outro alinhamento, como o limite da faixa de domínio, para que a largura varie ao longo da via. Se ficar curta, a seção sai cortada e o volume, incompleto.

Quando alguém pergunta se as sample lines podem ser geradas automaticamente, a primeira resposta é que o Civil 3D já faz isso, e mais do que se costuma usar.

Por faixa de estacas abre uma caixa com o que um projeto pede:

• A faixa: do início ao fim do alinhamento, ou entre duas estacas.
• Intervalos diferentes em tangente, curva e espiral. No Brasil, o estaqueamento costuma ser de 20 em 20 m, e é comum gerar uma seção por estaca e acrescentar seções intermediárias nas curvas, conforme o que o termo de referência pedir.
• A partir de onde se conta: da estaca zero ou do início da faixa. Contando a partir de zero, as linhas caem em estacas redondas, a cada 20 m exatos, mesmo que a faixa comece aos 13 m.
• Linhas adicionais: no início e no fim da faixa, nos pontos de geometria horizontal —início e fim de curvas e espirais— e nas estacas críticas da superelevação.
• A largura para cada lado: fixa, ou até um alinhamento de deslocamento.

A partir de estacas do corredor cria uma linha em cada estaca do corredor. É a opção mais fiel ao modelo, porque cada seção mostra exatamente o que o corredor calculou. Só fica disponível se o alinhamento já tiver um corredor.

E as linhas acompanham o eixo. Cada linha tem a opção Bloqueio para a estaca, nas suas propriedades, guia Dados de linha de amostra:

• Marcada: se o alinhamento mudar, a linha desliza para a nova posição da sua estaca.
• Desmarcada: a linha fica onde está e o Civil 3D recalcula a sua estaca.

Editar uma linha. Ao selecioná-la aparecem os grips: um a move ao longo do eixo, outros alongam cada lado e outros mudam o seu ângulo.

Mudar a largura de todas de uma vez. Na barra Ferramentas de linha de amostra, Editar larguras de amostra alonga ou apara todas as linhas do grupo para a mesma largura.

Acrescentar linhas a um grupo que já existe. Execute de novo Linhas de amostra, escolha o mesmo alinhamento e, na barra de ferramentas, o grupo existente. As vistas de seção novas não entram sozinhas no grupo de vistas: mova-as com o comando para movê-las a um grupo de vistas de seção (Move to Section View Group), porque o comando de atualizar não as reordena. As pranchas também não se regeneram sozinhas.

Excluir linhas. Selecione-as no desenho e apague. As vistas de seção delas são apagadas junto.

Nomes e números. O Civil 3D atribui o número de cada linha em ordem de estaca. O nome sai de um modelo com um contador, como SL-1 ou SL-2. Para mostrar a estaca na planta usa-se o rótulo da linha. O Civil 3D não traz um comando para renomear de uma vez todas as linhas de um grupo.

O que vimos funciona bem num alinhamento com intervalos regulares. Os problemas aparecem nos projetos reais:

• Estacas de uma tabela. As do projeto, dos bueiros, das mudanças de seção ou as que a fiscalização pede. O Civil 3D não lê uma lista: elas são criadas uma a uma, em uma estaca de cada vez.
• Muitos alinhamentos. Um loteamento com 30 ruas são 30 grupos e 30 vezes a mesma caixa, com o risco de esquecer uma fonte ou uma largura.
• Mudanças de projeto. As linhas acompanham o eixo, mas não se acrescentam nem se removem sozinhas. Se o eixo cresce, o trecho novo fica sem linhas. Se aparece uma curva nova, os seus pontos de geometria não têm linha. Se muda a frequência do corredor, as linhas continuam nas estacas de antes.
• Refazer custa caro. O habitual é apagar e criar de novo. Mas ao apagar as linhas apagam-se as vistas de seção delas, e as pranchas são montadas outra vez.
• A largura. É fixa ou vai até um alinhamento de deslocamento. Se um aterro alto se abre além disso, a seção sai cortada, e às vezes ninguém nota até conferir o volume.
• Os nomes. Se o projeto identifica cada seção pela sua estaca, renomear as linhas é trabalho manual.

Com o Dynamo, sem escrever código. O Dynamo é a programação visual do Civil 3D: conectam-se blocos em vez de escrever código. Desde o Civil 3D 2025.1 ele traz nós nativos para criar grupos de linhas de amostra e linhas de amostra, e um para criar vistas de seção. Em versões anteriores, o pacote gratuito Camber também tem nós de linhas de amostra. Um script típico lê as estacas de um Excel e cria uma linha em cada uma: explicamos em 10 scripts de Dynamo para Civil 3D.

Com um plugin em C#. A API do Civil 3D tem o necessário: SampleLineGroup.Create cria o grupo num alinhamento e SampleLine.Create cria cada linha numa estaca, ou com os pontos que você definir.

// Um grupo por alinhamento e uma linha em cada estaca da tabela
ObjectId grupo = SampleLineGroup.Create("Secoes do projeto", alinhamentoId);

foreach (double estaca in estacas)            // lidas do Excel do projeto
{
    string nome = estaca.ToString("0+000");   // ou o formato do seu escritório
    SampleLine.Create(nome, grupo, estaca);
}

São duas chamadas. O que dá trabalho, e o que torna o plugin útil, é o que está em volta: ler e validar a tabela, calcular a largura de cada linha, atribuir fontes e estilos, decidir quais linhas acrescentar ou remover depois de uma mudança e registrar o que foi feito.

A comparação completa está em Dynamo ou C# para Civil 3D e Revit. E se a sua equipe quer aprender a API, comece por Civil 3D API em C#, primeiros passos.

Desenvolvemos plugins sob medida para o Civil 3D. Para as sample lines, um plugin típico:

• Lê as suas regras: intervalos em tangente, curva e espiral, mais uma tabela de estacas em Excel com os bueiros, as mudanças de seção e os pontos que a fiscalização pede.
• Trabalha em todos os alinhamentos do desenho numa só passada, com um grupo por alinhamento.
• Calcula a largura de cada linha para que cubra o corredor com os taludes, mais uma margem.
• Dá a cada linha o nome da sua estaca e atribui as fontes, os estilos e os rótulos do seu template.
• Depois de uma mudança, compara as linhas que existem com as que deveriam existir: acrescenta as que faltam, remove as que sobram e deixa intactas as demais, com as suas vistas de seção.
• Registra o que fez num relatório, para conferir antes de montar as pranchas.

Se você também precisa das vistas ou das pranchas, elas entram no mesmo plugin. Explicamos em produção automática de pranchas no Civil 3D e no Revit.

Como trabalhamos:

1. Diagnóstico (1 semana, gratuito): vemos a tarefa num dos seus projetos e escrevemos as regras.
2. Protótipo (1 a 2 semanas): validamos a lógica no seu projeto.
3. Desenvolvimento (2 a 4 semanas): o plugin em C#, com testes nos seus próprios modelos.
4. Instalação: instalador para todo o escritório, botão na barra superior do Civil 3D, manual e documentação.
5. Suporte: atualização a cada nova versão do Civil 3D.

O código-fonte fica com a sua empresa: o plugin é seu.