Fisco 1.0.2

dotnet add package Fisco --version 1.0.2                
NuGet\Install-Package Fisco -Version 1.0.2                
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="Fisco" Version="1.0.2" />                
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add Fisco --version 1.0.2                
#r "nuget: Fisco, 1.0.2"                
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install Fisco as a Cake Addin
#addin nuget:?package=Fisco&version=1.0.2

// Install Fisco as a Cake Tool
#tool nuget:?package=Fisco&version=1.0.2                

Fisco.dll - Biblioteca para Impressoras Térmicas

A Fisco.dll é uma biblioteca desenvolvida para facilitar o uso de impressoras térmicas em aplicações que requerem a geração de documentos fiscais, como cupons e recibos. A biblioteca oferece componentes para a renderização de textos, imagens e tabelas em um contexto gráfico, permitindo o controle preciso sobre o layout e o formato dos documentos a serem impressos.

<details> <summary>ℹ️ Limitações da Impressão Térmica</summary>

Por ser uma imagem renderizada, a qualidade da impressão térmica pode variar. Fontes muito pequenas podem se tornar ilegíveis e a imagem pode parecer borrada, dependendo das configurações da impressora e da marca. </details>

<details> <summary>✔️ Vantagens da Impressão Térmica</summary>

  • Impressão rápida e silenciosa
  • Baixo custo de manutenção, pois não requer tinta
  • Ideal para impressões de recibos, etiquetas e códigos de barras
  • Menor consumo de energia em comparação com impressoras tradicionais </details>

<details> <summary>✔️ Vantagens da DLL de Impressão Térmica</summary>

  • Facilita a integração de impressão térmica em aplicativos C#
  • Abstrai complexidades de baixo nível, como configuração de impressora e formatação de imagem
  • Oferece suporte a recursos avançados, como alinhamento de elementos e criação de tabelas
  • Permite renderizar e imprimir imagens e texto com facilidade </details>

Componentes Principais

Image

O componente Image permite a inserção e renderização de imagens em documentos fiscais. Ele oferece suporte para alinhamento e dimensionamento de imagens, garantindo que se ajustem corretamente ao layout do documento.

Exemplo de uso:

var image = new Image(bitmap, ItemAlign.Center);

Text

O componente Text facilita a adição de texto aos documentos fiscais. Ele oferece controle sobre a fonte, a cor e o alinhamento do texto, permitindo a criação de documentos com layout personalizado.

Exemplo de uso:

var font = new Font("Arial", 12);
var text = new Text(font, "Exemplo de texto", ItemAlign.Left, Brushes.Black);

Table

O componente Table permite a criação e renderização de tabelas em documentos fiscais. Ele oferece suporte para definição de colunas, linhas, estilos e alinhamentos, facilitando a organização e apresentação de dados tabulares.

Exemplo de uso:

FiscoPapper fisco = new FiscoPapper(BobineSize._80x297mm, false)
var table = new Table(4, BobineSize._80x297mm)
{
    RowWrap = true,
    TableLineColor = Pens.Black
};

float[] widths = new float[] { 40, 20, 20, 20 };
table.SetPercentage(widths);

for (int i = 0; i < table.ColumnCount; i++)
{
    TableColumn column = new TableColumn($"COL {i + 1}")
    {
        DrawBackColor = true,
    };

    table.Columns.Add(column);
}

for (int i = 0; i < 40; i++)
{
    TableRow row = new TableRow(4);
    for (int j = 0; j < 4; j++)
        row.AddCell(new TableCell(new Text(new Font("Arial", 12f), $"({i}, {j})", ItemAlign.Left, i % 2 == 0 ? Brushes.Black : Brushes.White), i % 2 == 0 ? TableCell.BackColor.None : TableCell.BackColor.Black));

    table.Rows.Add(row);
}

fisco.AddComponent(table);

Exemplo de uso:

try
{
    using (FiscoPapper fisco = new FiscoPapper(BobineSize._80x297mm, false))
    {
        Fisco.Component.Image myImage = new Fisco.Component.Image(new Bitmap(Image.FromFile("sourceFile"), new Size(250, 350)), ItemAlign.Center);
        fisco.AddComponent(myImage);

        img = fisco.Render();
    }
}
catch (Exception e)
{
    MessageBox.Show(e.Message);
}

Este código cria uma instância de FiscoPapper com o tamanho da bobina 80x297mm, carrega uma imagem do arquivo sourceFile, redimensiona-a para 250x350 pixels, cria um objeto Image com a imagem e o alinhamento central e, em seguida, adiciona esse objeto ao FiscoPapper.

Enum ItemAlign

Valor Descrição
None Indeterminado
Left Alinhar à esquerda
Center Alinhar no centro
Right Alinhar à direita

Descrição: Alinhamento dos elementos gráficos.

Enum BobineSize

Valor Descrição
_58x297mm 58mm X 297mm
_58x3276mm 58mm X 3276mm
_80x297mm 80mm X 297mm
_80x3276mm 80mm X 3276mm

Descrição: Tipos de bobinas suportadas.

Essa tabela fornece uma visão detalhada dos valores e descrições associadas a cada enum na Fisco.dll.

Funcionalidades Adicionais

Além dos componentes principais, a Fisco.dll também oferece funcionalidades para o gerenciamento de contexto gráfico e tratamento de exceções, garantindo uma experiência de uso robusta e confiável.

Como Utilizar

  1. Adicione a referência à Fisco.dll em seu projeto.
  2. Utilize os componentes Image, Text e Table para criar o conteúdo do seu documento fiscal.
  3. Renderize os componentes em um contexto gráfico, como uma Graphics do C#.
  4. Envie o documento renderizado para a impressora térmica para impressão.

Com a Fisco.dll, você pode simplificar o processo de geração de documentos fiscais, tornando-o mais eficiente e preciso.

Product Compatible and additional computed target framework versions.
.NET Framework net48 is compatible.  net481 was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

This package has no dependencies.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
1.0.2 102 4/7/2024
1.0.1 92 4/7/2024
1.0.0 89 4/7/2024