Criando Imagens de Código de Barras 1BPP em C#

Curtis Chau

Updated: 9 de maio de 2026

Download IronBarcode

• NuGet Download
• DLL Download

• ---

• Start Free Trial

Copy for LLMs

• Copy for LLMs

  Copy page as Markdown for LLMs

• ---

• Open in ChatGPT

  Ask ChatGPT about this page
• Open in Gemini

  Ask Gemini about this page
• Open in Grok

  Ask Grok about this page
• Open in Perplexity

  Ask Perplexity about this page

Share

• Share on Facebook
• Share on X (Twitter)
• Share on LinkedIn

• ---

• Email article

IronBarcode permite que você crie imagens de códigos de barras em preto e branco 1BPP compactos em C#, reduzindo tamanhos de arquivos enquanto mantém a legibilidade por máquina através de métodos como To1BppImage(), SaveAs1BppBitmap() e To1BppBinaryData().

O processamento em massa de códigos de barras requer consideração de tamanho e dimensões. Imagens de código de barras 1BPP fornecem uma solução eficaz para processamento rápido e leitura precisa por máquinas. Uma imagem 1BPP é monocromática, exibindo apenas preto e branco. Cada pixel usa um único bit - '0' para preto e '1' para branco, ou vice-versa.

Imagens de código de barras 1BPP oferecem o menor tamanho de arquivo possível, com cada pixel representado por apenas um bit. Esse tamanho compacto proporciona eficiência para armazenar e transmitir imagens de códigos de barras para impressoras, particularmente impressoras térmicas ou ao otimizar o armazenamento em banco de dados. Para desenvolvedores que trabalham com múltiplos formatos de código de barras, imagens 1BPP oferecem desempenho consistente em todos os tipos suportados.

IronBarcode suporta converter códigos de barras em imagens 1BPP e mais, fornecendo flexibilidade para todas as situações. Se você estiver criando códigos de barras a partir de várias fontes de dados ou otimizando fluxos de trabalho de código de barras existentes, a conversão 1BPP oferece vantagens significativas. Este guia cobre todas as opções que o IronBarcode oferece para criar imagens de código de barras 1BPP.

Este exemplo demonstra como o IronBarcode produz um código de barras 1BPP compacto e monocromático em apenas uma linha. Ideal para escaneamento de alto contraste e processamento em massa rápido.

Como Eu Crio Imagens de Código de Barras 1BPP?

Converter códigos de barras em imagens 1BPP é simples usando o método To1BppImage. Este método salva o código de barras como uma imagem 1BPP. O processo se assemelha a criar imagens padrão de código de barras mas com benefícios de tamanho de arquivo reduzido.

using IronBarCode;

// Create a barcode with "12345" encoded in the EAN8 format
var myBarcode = BarcodeWriter.CreateBarcode("12345", BarcodeWriterEncoding.EAN8);

// Converts the barcode into a 1bpp image
var anyBitmap = myBarcode.To1BppImage();

using IronBarCode;

// Create a barcode with "12345" encoded in the EAN8 format
var myBarcode = BarcodeWriter.CreateBarcode("12345", BarcodeWriterEncoding.EAN8);

// Converts the barcode into a 1bpp image
var anyBitmap = myBarcode.To1BppImage();

Imports IronBarCode

' Create a barcode with "12345" encoded in the EAN8 format
Dim myBarcode = BarcodeWriter.CreateBarcode("12345", BarcodeWriterEncoding.EAN8)

' Converts the barcode into a 1bpp image
Dim anyBitmap = myBarcode.To1BppImage()

Imports IronBarCode

' Create a barcode with "12345" encoded in the EAN8 format
Dim myBarcode = BarcodeWriter.CreateBarcode("12345", BarcodeWriterEncoding.EAN8)

' Converts the barcode into a 1bpp image
Dim anyBitmap = myBarcode.To1BppImage()

A imagem resultante mantém as informações do código de barras enquanto reduz drasticamente o tamanho do arquivo. Isso é útil ao trabalhar com a personalização de estilo do código de barras onde a informação de cor não é necessária.

Por que o método To1BppImage produz tamanhos de arquivo menores?

O método To1BppImage produz tamanhos de arquivo menores armazenando cada pixel usando apenas um bit, em vez dos típicos 24 ou 32 bits em imagens coloridas. Isso atinge uma taxa de compressão de até 32:1 em comparação com imagens RGBA padrão. Para um código de barras pixel 500x100 típico, uma imagem colorida requer aproximadamente 200KB, enquanto uma versão 1BPP precisa de apenas cerca de 6KB.

Quais formatos de imagem são suportados para saída 1BPP?

IronBarcode suporta múltiplos formatos de imagem para saída 1BPP: BMP (bitmap), PNG e TIFF. BMP é o mais comum para imagens 1BPP devido ao suporte nativo a dados monocromáticos. PNG e TIFF também oferecem excelente compressão para imagens em preto e branco. Para detalhes sobre formatos suportados, veja o guia de formatos de dados de saída.

Quando devo usar imagens 1BPP em vez de formatos de código de barras padrão?

Use imagens 1BPP quando:

• Trabalhando com impressoras térmicas ou monocromáticas
• Armazenando milhares de códigos de barras em bancos de dados
• Transmitindo códigos de barras com largura de banda limitada
• Integrando com sistemas legados que requerem imagens monocromáticas
• Processando códigos de barras em operações massivas onde o tamanho do arquivo importa

Como Eu Salvo Códigos de Barras como Arquivos Bitmap 1BPP?

Para salvar como bitmap, use o método SaveAs1BppBitmap com um caminho de arquivo. Este método é útil quando você precisa exportar códigos de barras para impressão ou fins de arquivamento.

using IronBarCode;

// Create a barcode with "12345" encoded in the EAN8 format
var myBarcode = BarcodeWriter.CreateBarcode("12345", BarcodeWriterEncoding.EAN8);

// Save the barcode as a 1bpp Bitmap
myBarcode.SaveAs1BppBitmap("1bppImage.bmp");

using IronBarCode;

// Create a barcode with "12345" encoded in the EAN8 format
var myBarcode = BarcodeWriter.CreateBarcode("12345", BarcodeWriterEncoding.EAN8);

// Save the barcode as a 1bpp Bitmap
myBarcode.SaveAs1BppBitmap("1bppImage.bmp");

Imports IronBarCode

' Create a barcode with "12345" encoded in the EAN8 format
Dim myBarcode = BarcodeWriter.CreateBarcode("12345", BarcodeWriterEncoding.EAN8)

' Save the barcode as a 1bpp Bitmap
myBarcode.SaveAs1BppBitmap("1bppImage.bmp")

Imports IronBarCode

' Create a barcode with "12345" encoded in the EAN8 format
Dim myBarcode = BarcodeWriter.CreateBarcode("12345", BarcodeWriterEncoding.EAN8)

' Save the barcode as a 1bpp Bitmap
myBarcode.SaveAs1BppBitmap("1bppImage.bmp")

Quais são os benefícios de usar o formato bitmap para códigos de barras 1BPP?

O formato bitmap oferece várias vantagens para códigos de barras 1BPP:

• Suporte Nativo: BMP tem suporte integrado à profundidade de cor 1-bit
• Sem Artefatos de Compressão: BMP preserva dados de pixel exatos, ao contrário do JPEG
• Ampla Compatibilidade: Suportado por praticamente todo software de imagem
• Processamento Rápido: Não é necessário descompressão para leitura
• Preparado para Impressão: Compatibilidade direta com a maioria dos drivers de impressora

Como especifico caminhos de arquivo personalizados para bitmaps salvos?

Especifique caminhos de arquivo personalizados usando caminhos absolutos ou relativos. Ao trabalhar em ambientes como Azure ou AWS Lambda, assegure permissões de escrita para o diretório de destino:

// Relative path
myBarcode.SaveAs1BppBitmap("./output/barcode.bmp");

// Absolute path
myBarcode.SaveAs1BppBitmap(@"C:\BarcodeOutput\barcode.bmp");

// Using environment variables
string path = Path.Combine(Environment.GetFolderPath(Environment.SpecialFolder.MyDocuments), "barcode.bmp");
myBarcode.SaveAs1BppBitmap(path);

// Relative path
myBarcode.SaveAs1BppBitmap("./output/barcode.bmp");

// Absolute path
myBarcode.SaveAs1BppBitmap(@"C:\BarcodeOutput\barcode.bmp");

// Using environment variables
string path = Path.Combine(Environment.GetFolderPath(Environment.SpecialFolder.MyDocuments), "barcode.bmp");
myBarcode.SaveAs1BppBitmap(path);

' Relative path
myBarcode.SaveAs1BppBitmap("./output/barcode.bmp")

' Absolute path
myBarcode.SaveAs1BppBitmap("C:\BarcodeOutput\barcode.bmp")

' Using environment variables
Dim path As String = Path.Combine(Environment.GetFolderPath(Environment.SpecialFolder.MyDocuments), "barcode.bmp")
myBarcode.SaveAs1BppBitmap(path)

' Relative path
myBarcode.SaveAs1BppBitmap("./output/barcode.bmp")

' Absolute path
myBarcode.SaveAs1BppBitmap("C:\BarcodeOutput\barcode.bmp")

' Using environment variables
Dim path As String = Path.Combine(Environment.GetFolderPath(Environment.SpecialFolder.MyDocuments), "barcode.bmp")
myBarcode.SaveAs1BppBitmap(path)

O que acontece se o caminho do arquivo já existir?

SaveAs1BppBitmap sobrescreve arquivos existentes por padrão. Para evitar sobrescritas acidentais:

string filePath = "barcode.bmp";
if (File.Exists(filePath))
{
    // Add timestamp or increment filename
    filePath = $"barcode_{DateTime.Now:yyyyMMdd_HHmmss}.bmp";
}
myBarcode.SaveAs1BppBitmap(filePath);

string filePath = "barcode.bmp";
if (File.Exists(filePath))
{
    // Add timestamp or increment filename
    filePath = $"barcode_{DateTime.Now:yyyyMMdd_HHmmss}.bmp";
}
myBarcode.SaveAs1BppBitmap(filePath);

Dim filePath As String = "barcode.bmp"
If File.Exists(filePath) Then
    ' Add timestamp or increment filename
    filePath = $"barcode_{DateTime.Now:yyyyMMdd_HHmmss}.bmp"
End If
myBarcode.SaveAs1BppBitmap(filePath)

Dim filePath As String = "barcode.bmp"
If File.Exists(filePath) Then
    ' Add timestamp or increment filename
    filePath = $"barcode_{DateTime.Now:yyyyMMdd_HHmmss}.bmp"
End If
myBarcode.SaveAs1BppBitmap(filePath)

Como Eu Converto Códigos de Barras para Dados Binários 1BPP?

Para salvar como dados binários, use o método To1BppBinaryData. O formato binário permite o uso dos dados em outros aplicativos e integração com sistemas existentes. Essa abordagem se assemelha a exportação de códigos de barras como streams mas otimizada para o formato 1BPP.

using IronBarCode;

// Create a barcode with "12345" encoded in the EAN8 format
var myBarcode = BarcodeWriter.CreateBarcode("12345", BarcodeWriterEncoding.EAN8);

// Save the barcode as a 1pp binary data object
var byteData = myBarcode.To1BppBinaryData();

using IronBarCode;

// Create a barcode with "12345" encoded in the EAN8 format
var myBarcode = BarcodeWriter.CreateBarcode("12345", BarcodeWriterEncoding.EAN8);

// Save the barcode as a 1pp binary data object
var byteData = myBarcode.To1BppBinaryData();

Imports IronBarCode

' Create a barcode with "12345" encoded in the EAN8 format
Dim myBarcode = BarcodeWriter.CreateBarcode("12345", BarcodeWriterEncoding.EAN8)

' Save the barcode as a 1pp binary data object
Dim byteData = myBarcode.To1BppBinaryData()

Imports IronBarCode

' Create a barcode with "12345" encoded in the EAN8 format
Dim myBarcode = BarcodeWriter.CreateBarcode("12345", BarcodeWriterEncoding.EAN8)

' Save the barcode as a 1pp binary data object
Dim byteData = myBarcode.To1BppBinaryData()

Por que eu precisaria de dados binários em vez de arquivos de imagem?

Dados binários oferecem vantagens sobre armazenamento baseado em arquivos:

• Integração com Banco de Dados: Armazenar diretamente em campos BLOB
• Eficiência de Memória: Sem sobrecarga de I/O de arquivo
• Transmissão de API: Fácil de enviar via APIs REST
• Geração Dinâmica: Crie códigos de barras sem acesso ao sistema de arquivos
• Implantação na Nuvem: Perfeito para ambientes sem servidor

Como posso integrar dados binários de código de barras com bancos de dados?

Os dados binários de código de barras integram-se perfeitamente com bancos de dados modernos. Este exemplo mostra armazenamento e recuperação:

// Storing barcode in database
public void StoreBarcodeInDatabase(string barcodeValue, string connectionString)
{
    var barcode = BarcodeWriter.CreateBarcode(barcodeValue, BarcodeWriterEncoding.Code128);
    byte[] barcodeData = barcode.To1BppBinaryData();
    
    using (SqlConnection conn = new SqlConnection(connectionString))
    {
        string query = "INSERT INTO BarcodeTable (Value, ImageData, CreatedDate) VALUES (@value, @data, @date)";
        using (SqlCommand cmd = new SqlCommand(query, conn))
        {
            cmd.Parameters.AddWithValue("@value", barcodeValue);
            cmd.Parameters.AddWithValue("@data", barcodeData);
            cmd.Parameters.AddWithValue("@date", DateTime.Now);
            
            conn.Open();
            cmd.ExecuteNonQuery();
        }
    }
}

// Storing barcode in database
public void StoreBarcodeInDatabase(string barcodeValue, string connectionString)
{
    var barcode = BarcodeWriter.CreateBarcode(barcodeValue, BarcodeWriterEncoding.Code128);
    byte[] barcodeData = barcode.To1BppBinaryData();
    
    using (SqlConnection conn = new SqlConnection(connectionString))
    {
        string query = "INSERT INTO BarcodeTable (Value, ImageData, CreatedDate) VALUES (@value, @data, @date)";
        using (SqlCommand cmd = new SqlCommand(query, conn))
        {
            cmd.Parameters.AddWithValue("@value", barcodeValue);
            cmd.Parameters.AddWithValue("@data", barcodeData);
            cmd.Parameters.AddWithValue("@date", DateTime.Now);
            
            conn.Open();
            cmd.ExecuteNonQuery();
        }
    }
}

' Storing barcode in database
Public Sub StoreBarcodeInDatabase(barcodeValue As String, connectionString As String)
    Dim barcode = BarcodeWriter.CreateBarcode(barcodeValue, BarcodeWriterEncoding.Code128)
    Dim barcodeData As Byte() = barcode.To1BppBinaryData()

    Using conn As New SqlConnection(connectionString)
        Dim query As String = "INSERT INTO BarcodeTable (Value, ImageData, CreatedDate) VALUES (@value, @data, @date)"
        Using cmd As New SqlCommand(query, conn)
            cmd.Parameters.AddWithValue("@value", barcodeValue)
            cmd.Parameters.AddWithValue("@data", barcodeData)
            cmd.Parameters.AddWithValue("@date", DateTime.Now)

            conn.Open()
            cmd.ExecuteNonQuery()
        End Using
    End Using
End Sub

' Storing barcode in database
Public Sub StoreBarcodeInDatabase(barcodeValue As String, connectionString As String)
    Dim barcode = BarcodeWriter.CreateBarcode(barcodeValue, BarcodeWriterEncoding.Code128)
    Dim barcodeData As Byte() = barcode.To1BppBinaryData()

    Using conn As New SqlConnection(connectionString)
        Dim query As String = "INSERT INTO BarcodeTable (Value, ImageData, CreatedDate) VALUES (@value, @data, @date)"
        Using cmd As New SqlCommand(query, conn)
            cmd.Parameters.AddWithValue("@value", barcodeValue)
            cmd.Parameters.AddWithValue("@data", barcodeData)
            cmd.Parameters.AddWithValue("@date", DateTime.Now)

            conn.Open()
            cmd.ExecuteNonQuery()
        End Using
    End Using
End Sub

Quais são os casos de uso comuns para dados binários de código de barras?

Os dados binários de código de barras são comumente usados em:

• APIs Web: Retornar imagens de códigos de barras sem arquivos temporários
• Geração de Relatórios: Incorporar códigos de barras diretamente em relatórios PDF
• Sistemas de Email: Anexar códigos de barras a emails automatizados
• Sistemas de Cache: Armazenar no Redis ou Memcached
• Microsserviços: Passar dados de código de barras entre serviços

Para cenários avançados, explore processamento assíncrono de códigos de barras para aplicações de alto volume.

Curtis Chau

Redator Técnico

Converse agora mesmo com a equipe de engenharia.

Curtis Chau é bacharel em Ciência da Computação (Universidade Carleton) e se especializa em desenvolvimento front-end, com experiência em Node.js, TypeScript, JavaScript e React. Apaixonado por criar interfaces de usuário intuitivas e esteticamente agradáveis, Curtis gosta de trabalhar com frameworks modernos e criar manuais bem estruturados e visualmente atraentes.

Leia mais