Skip to content

Latest commit

 

History

History
126 lines (87 loc) · 6.93 KB

README_PTBR.md

File metadata and controls

126 lines (87 loc) · 6.93 KB
Raw

Actions Status CodeFactor Total Download Count

OpenTabletDriver

English | 한국어 | Español | Русский | 简体中文 | Français | Deutsch | Português-BR

OpenTabletDriver é um programa de código aberto, multi-plataforma, driver de tablet configurável pelo usuário. O objetivo do OpenTabletDriver é ser compatível em múltiplas plataformas em uma interface gráfica amigável e de fácil utilização para o usuário.

Tablets suportados

Todos os status dos tablets que estão suportados, não testados ou que estão em planejamento para serem testados estão aqui. Soluções de problemas comuns podem ser encontrados na wiki.

Instalação

Executando OpenTabletDriver

O OpenTabletDriver funciona como dois processos separados que comunicam-se entre si para poder funcionar perfeitamente. O programa ativo que lida com todos o manuseio de dados é OpenTabletDriver.Daemon, enquanto o GUI (interface) é OpenTabletDriver.UX.*, onde * depende da plataforma1. O daemon deve ser inicializado para que tudo possa rodar sem problemas, enquanto o GUI não é necessário. Se você possui uma configuração já pronta, elas devem ser aplicadas quando o daemon iniciar.

1Windows usa Wpf, Linux usa Gtk, e MacOS usa MacOS. O que pode ser ignorado por grande parte da aplicação se você não compilar a partir da fonte, já que apenas a versão correta será fornecida.

Buildando OpenTabletDriver da fonte

Os requisitos para buildar o OpenTabletDriver são referentes à todas as plataformas. Rodando OpenTabletDriver em cada plataforma requer dependências diferentes.

Todas as plataformas

  • .NET 7 SDK (pode ser obtida aqui - Você precisa do SDK para sua plataforma, usuários Linux devem instalar via gerenciador de pacotes se possível)

Windows

Execute build.ps1 para produzir as compilações binárias na pasta 'bin'. Estas compilações estão executadas no modo portátil por padrão.

Linux

Pacotes requeridos (alguns pacotes podem já estar pré-instalados na sua distro)

  • libx11
  • libxrandr
  • libevdev2
  • GTK+3

Para compilar no Linux, execute o arquivo fornecido chamado 'build.sh'. Irá executar o equivalente ao comando 'dotnet publish' usado para compilação do pacote AUR, e irá produzir as compilações binárias em 'OpenTabletDriver/bin'.

Para compilar no ARM linux, execute o arquivo fornecido 'build.sh' passando o runtime apropriado como argumento. Por exemplo, para o arm64 seria: 'linux-arm64'.

Nota: Se você está compilando pela primeira vez, execute junto o script generate-rules.sh. Isso irá gerar um pacote de regras de udev em OpenTabletDriver/bin, chamado '99-opentabletdriver.rules'. Esse arquivo deve ser movido para /etc/udev/rules.d/:

sudo mv ./bin/99-opentabletdriver.rules /etc/udev/rules.d/

MacOS [Experimental]

Sem outras dependências.

Funcionalidades

  • Interface totalmente nativa
    • Windows: Windows Presentation Foundation
    • Linux: GTK+3
    • MacOS: MonoMac
  • Ferramenta do console completa
    • Rápida criação, alteração, carregamento, ou salvando configurações
    • Suporte a scripts (saídas de json)
  • Posicionamento absoluto do cursor
    • Área da tela e área do tablet
    • Fixação do offset central
    • Rotação precisa da área
  • Posicionamento relativo do cursor
    • px/mm sensibilidade horizontal e vertical
  • Vinculações de teclas (binding)
    • Binding na pressão da ponta da caneta
    • Binding nas Express Key
    • Binding nos botões da caneta
    • Binding nos botões do mouse
    • Binding nas teclas do teclado
    • Binding de plugins externos
  • Salvando e carregando informações
    • Carregamento automático pelas configurações do usuário via settings.json no usuário ativo no diretório raiz de configurações %localappdata% ou .config
  • Plugins
    • Filtros
    • Modos de saída
    • Ferramentas

Contribuindo ao OpenTabletDriver

Se você deseja contribuir para o OpenTabletDriver, confira a aba de problemas. Quando criar pull requests, siga as orientações descritas em nosso guia de contribuição.

Se você tiver algum problema ou sugestão, relate um problema e preencha o template com informações relevantes. Somos gratos aos relatos de bugs quanto aos pedidos de novos tablets para adicionar suporte. Em alguns casos, adicionar um novo tablet pode ser fácil.

Para issues (problemas) e PRs relacionados aos pacotes do OpenTabletDriver, por favor veja neste repositório aqui.

Para issues e PRs relacionados ao site do OpenTabletDriver página web, veja este repositório aqui.

Adicionando suporte a um novo tablet

Se você gostaria de adicionar suporte a um novo tablet, abra uma issue ou entre em nosso discord solicitando o suporte. Nós geralmente preferimos as solicitações por um novo tablet sejam feitas via discord, devido as trocas de ideias envolvidas.

Nós precisaremos que você faça algumas coisas como gravar os dados enviados pelo seu tablet utilizando nossa ferramenta de debug integrada, testando funcionalidades do tablet (botões do tablet, botões da caneta, pressão da caneta, etc) com uma configuração diferente que nós iremos enviar a você para testar.

Você também, claro, é bem vindo a abrir uma PR adicionando o suporte a tablet por você mesmo, caso tenha uma boa compreensão do que está desenvolvido.

Geralmente esse processo é relativamente fácil, especialmente se a fabricante do seu tablet já exisitr em algum outro tablet que já tenha suporte.