Pular para o conteúdo principal
O ABBYY FineReader Engine 12 não é compatível em nível binário com o ABBYY FineReader Engine 11. Os aplicativos compilados com o ABBYY FineReader Engine 11 devem ser recompilados usando os arquivos de cabeçalho e a biblioteca do ABBYY FineReader Engine 12. Algumas alterações no código-fonte podem ser necessárias devido às melhorias na API do ABBYY FineReader Engine. Este artigo contém uma lista completa das alterações, juntamente com sugestões de como reescrever seu código para que ele funcione na nova versão. Principais alterações:
  • Os objetos obsoletos DocumentAnalyzer e Exporter foram removidos, juntamente com os métodos de processamento do objeto Engine. Use os métodos mais eficientes dos objetos FRDocument e FRPage, que reúnem todas as informações necessárias para o processamento completo do documento. Não é mais necessário manter o objeto DocumentInfo em todas as etapas do processamento, acompanhar todos os documentos de imagem com os layouts correspondentes nem implementar a interface IRecognizedPages.
  • A API que fornecia acesso à estrutura lógica do documento (DocumentStructure, PageStructure e seus subobjetos) foi removida. A edição das propriedades e do conteúdo do documento por meio dos objetos removidos poderia levar a resultados imprevisíveis na exportação. Se você precisar verificar ou pós-processar os resultados do reconhecimento, trabalhe com os dados por meio do subobjeto Layout de cada FRPage e, ao terminar, chame qualquer um dos métodos que realizam a síntese do documento. A estrutura lógica do documento será então recriada e usada na etapa de exportação, embora não fique mais disponível para edição por meio da FineReader Engine API. Versões futuras do ABBYY FineReader Engine poderão fornecer acesso somente leitura a parte da estrutura lógica do documento.
  • A API de Classificação foi totalmente substituída e agora usa algoritmos novos e aprimorados, além de oferecer técnicas integradas de validação cruzada.
  • O objeto Engine agora deve ser carregado por meio da função InitializeEngine. As funções GetEngineObject e GetEngineObjectEx para carregar o Engine foram removidas do ABBYY FineReader Engine.
    Propriedade/Método/ConstanteO que mudou?Comentário
    CreateDocumentAnalyzer CreateDocumentInfo CreateExporterRemovidoEsses métodos não são mais necessários, pois os objetos que eles criavam foram removidos.
    CreateExportFileWriterAssinatura alteradaO parâmetro obsoleto PagesCount foi removido.
    CreateImageDocumentsInMemory <Note> Apenas para Windows </Note>RemovidoOs documentos de imagem são sempre criados na memória. Você pode usar os métodos SaveTo ou SaveToFile sempre que precisar salvar o documento de imagem no disco.
    CreateLayoutRemovidoO objeto Layout não pode mais ser usado separadamente da página correspondente.
    CreateMultipageImageWriterComportamento modificadoAgora, este método aceita parâmetros avançados para salvar imagens nos formatos JPEG e TIFF.
    CreateMultipageImageWriterExRenomeadoEsse método agora é chamado de CreateMultipageImageWriter. A implementação antiga do método CreateMultipageImageWriter foi removida.
    ExportPageRemovidoUse o método IFRPage::Export em vez disso.
    ExportPagesExRemovidoEm vez disso, use o método IFRDocument::Export.
    InjectTextLayerComportamento alteradoEste método agora oferece parâmetros adicionais para a injeção da camada de texto, além da opção de selecionar as páginas do arquivo PDF que serão processadas e uma interface de callback para tratar avisos e erros.
    InjectTextLayerEx InjectTextLayerEx2RemovidoA nova versão do método InjectTextLayer agora oferece todas as opções anteriormente disponíveis nesses métodos.
    OpenImageFileRemovidoUse o método IFRDocument::AddImageFile para abrir um arquivo de imagem e adicioná-lo ao documento para processamento. O objeto ImageDocument poderá ser acessado por meio da FRPage correspondente.
    PrepareImageFileRemovidoUse o método IFRDocument::AddImageFile para abrir um arquivo de imagem e adicioná-lo ao documento para processamento. O objeto ImageDocument poderá ser acessado pela FRPage correspondente e poderá ser salvo em disco posteriormente.
    ProcessPageRemovidoUse, em vez disso, o método IFRDocument::Process.
    ProcessPagesExRemovidoEm vez disso, use o método IFRDocument::Process.
    SynthesizePagesExRemovidoUse o método IFRDocument::Synthesize em vez dele.
    OpenMemoryImageFormat10RemovidoEste método foi fornecido apenas para manter a compatibilidade com o ABBYY FineReader Engine 10.
    OpenBitmap OpenBitmapBits<br />OpenDib<br />PrepareBitmap<br />PrepareBitmapBits<br />PrepareDibDescontinuado no Linux e no macOSEssas Properties agora estão obsoletas e serão excluídas em versões futuras.
    MétodoO que mudou?Comentário
    Load LoadExRemovidoMétodos descontinuados; use Engine.InitializeEngine no lugar.

    Objeto/Enumeração

    Propriedade/Método/Constante

    O que aconteceu?

    Comentário

    ImageDocument

    SuppressColorObjects

    Removido

    Em vez disso, use o método RemoveColorObjectsEx, que permite remover de uma só vez objetos de vários matizes especificados e também obter a imagem dos objetos removidos.

    RemoveGarbage

    Comportamento alterado

    Este método ainda procura ruído no plano em preto e branco, mas o remove de todos os planos de cor da imagem.

    RemoveGarbageEx

    Renomeado

    Esse método agora se chama RemoveGarbage. A implementação anterior desse método foi removida.

    PrepareImageMode

    ImageCompression

    Renomeado, tipo alterado

    Esta propriedade agora se chama CompressImage e é do tipo ThreeStatePropertyValueEnum. O comportamento padrão permanece o mesmo.

    KeepOriginalCoordinatesInfo

    Obsoleto

    Esta propriedade agora está obsoleta e será excluída em versões futuras.

    ImageCompressionEnum


    Removido

    A propriedade que usava essa enumeração agora tem outro tipo.

    Image

    EstimateBitmapSize

    GetBitmap

    Obsoleto no Linux e no macOS

    Esses métodos agora estão obsoletos e serão excluídos em versões futuras.

    TrainingImage

    SetBitmapBits

    Obsoleto no Linux e no macOS

    Este método agora está obsoleto e será excluído em versões futuras.

    Objeto/Enumeração

    Propriedade/Método/Constante

    O que aconteceu?

    Comentário

    Block

    BackgroundColor

    Comportamento alterado

    Esta propriedade agora é somente leitura.

    BlockLayerType

    Comportamento alterado

    Esta propriedade agora é somente leitura. Para RasterPictureBlock e VectorPictureBlock, o tipo de camada pode ser alterado usando o método SetBlockLayerType.

    BlockLayerTypeEnum

    BLT_Unknown

    Removido

    Esta constante não é mais usada.

    Removido

    Essas propriedades não são mais suportadas: não é mais possível detectar a divisão do parágrafo entre duas páginas.

    Removido

    Esta propriedade retornava o ID do PageElement correspondente à imagem e não é mais útil, pois o objeto PageElement foi removido junto com o restante da API de estrutura de documento.

    Comportamento alterado

    Este método agora exige a especificação do nome do marcador do usuário no formato “UserDefinedBookmark:<my_user_bookmark>”.

    Removido

    As propriedades do parágrafo agora podem ser acessadas somente por meio do objeto.

    Comportamento alterado

    Essas propriedades agora são somente leitura. Nenhuma propriedade do estilo de parágrafo pode ser editada.

    Removido

    Nenhuma propriedade do estilo de parágrafo pode ser editada ou copiada de outro objeto.

    Removido

    O estilo de parágrafo pode ser acessado por meio do objeto.

    Renomeado

    Este método agora se chama AddNew. A implementação anterior do método AddNew foi removida.

    Comportamento alterado

    Este método agora permite definir todas as propriedades do preenchimento de tabulação no momento da criação.

    Removido

    Todas as propriedades de uma parada de tabulação devem ser especificadas na criação do objeto com o auxílio do métododo objeto. Elas não podem ser alteradas nem copiadas de outro objeto.

    Comportamento alterado

    As propriedades agora são somente leitura. Elas devem ser especificadas na criação do objeto com o auxílio domethod of theobjeto e não pode ser alterado ou copiado de outro objeto.

    Removido

    Esta propriedade foi descontinuada na versão anterior.

    Removido

    Esta propriedade foi removida em decorrência da remoção da API de estrutura lógica do documento, pois não é mais possível acessar as partes do documento pela sua função na estrutura lógica.


    Removido

    A propriedade que utilizava esta enumeração foi removida.

    Removido

    Esta propriedade foi descontinuada e marcada para remoção. Foi substituída por duas propriedades:, que especifica o primeiro caractere da palavra quando lida da esquerda para a direita, e, que especifica o primeiro caractere logicamente para qualquer direção de leitura utilizada no idioma.

    CFL_Picture

    Removido

    A propriedade que utilizava esta constante foi removida.

    Descontinuado

    Estas propriedades estão descontinuadas e serão removidas em versões futuras.

    Comportamento alterado

    Esta propriedade agora exige a especificação do nome do marcador do usuário no formato “UserDefinedBookmark:<my_user_bookmark>” para a criação de um hiperlink.


    Renomeado

    Esta interface agora se chama. A versão anterior dessa interface foi removida.

    Parâmetros alterados

    Este método agora possui um parâmetro adicional que especifica o índice da página no documento ao qual o aviso se refere.


    Removido

    Esses objetos representavam a estrutura lógica do documento e suas diversas partes. A edição da estrutura do documento não é mais suportada, pois seu uso incorreto poderia afetar a aparência do documento exportado. Qualquer verificação de texto ou outras modificações podem ser realizadas por meio da API do documento (,e subobjetos). As versões futuras do ABBYY FineReader Engine poderão oferecer acesso somente leitura a partes da estrutura lógica do documento.


    Removido

    Essas enumerações eram utilizadas pelos objetos de estrutura do documento que não estão mais disponíveis.

    Comportamento alterado

    Este método agora fornece parâmetros estendidos para detecção de páginas vazias.

    Renomeado

    Este método agora se chama. A implementação anterior do método IsEmpty foi removida.

    Removido

    A classificação de páginas agora pode ser realizada pelo métododo objeto. Ele requer como parâmetro de entrada um, que pode ser criado com o método.

    Obsoleto

    Esta propriedade está obsoleta e será removida em versões futuras. Use o métodopara verificar se um arquivo tem conteúdo textual.

    Objeto/EnumeraçãoPropriedade/Método/ConstanteO que aconteceu?Comentário
    BatchProcessorStartExRemovidoO método Start agora usa a interface avançada de origem de imagem, que por sua vez foi renomeada para IImageSource.
    IImageSourceEx<br />RenomeadoEssa interface agora se chama IImageSource.
    IImageSource<br />Comportamento alteradoEssa interface agora permite adicionar documentos de imagem, bem como arquivos de imagem, à fila.


    Removido

    O objeto está obsoleto. Seus métodos foram substituídos por métodos mais eficientes dos objetose, que não exigem a manutenção do objeto DocumentInfo em todas as etapas de processamento nem a implementação da interface IRecognizedPages.

    Removido

    Use os métodos,,para trabalhar com dicionários de cache.

    Removido

    Use o métodoem vez disso.

    Removido

    Use o métodoem vez disso.

    Removido

    Use o métodoem vez disso.

    Removido

    Use o métodoem vez disso.

    Removido

    Use a propriedade, que funciona exatamente da mesma forma.

    Removido

    Use o método, que funciona exatamente da mesma forma.

    Removido

    Use o método IImageDocument::RemoveGeometricalDistortions em vez disso.

    Removido

    Use o métodoem vez disso.

    Removido

    Use o métodoem vez disso.

    Removido

    Use o métodoem vez disso.

    Removido

    Use o métodoem vez disso.

    Removido

    Use o métodoem vez disso.

    Removido

    Use o métodoem vez disso. Ele executa o processamento completo do documento, incluindo a síntese do documento.

    Removido

    Use o métodoem vez disso.

    Removido

    Use o métodoem vez disso.

    Removido

    Use o métodoem vez disso.

    Removido

    Para reconhecer uma imagem como texto simples, crie oa partir da imagem usando o método, use o métodopara reconhecer o documento e, em seguida, acesse a propriedade.

    Removido

    Para reconhecer a página como texto simples, use o métodoe, em seguida, acesse a propriedade.

    Removido

    Use o métodoem vez disso.

    Removido

    Use o métodoem vez disso.


    Removido

    O objeto está obsoleto. Seus métodos foram substituídos por métodos mais eficientes dos objetose, que não exigem a manutenção do objeto DocumentInfo em todas as etapas de processamento, nem a implementação da interface IRecognizedPages.

    Removido

    Use o métodoem vez disso.

    Removido

    Use o métodoem vez disso.


    Removido

    Esta interface não é mais necessária porque o objeto que reportava eventos foi removido.

    As interfacesefornecem informações semelhantes sobre progresso e erros para os objetos que substituíram DocumentAnalyzer.


    Removido

    Esta interface não é mais necessária porque o objeto que reportava eventos foi removido.

    As interfacesefornecem informações semelhantes sobre progresso e erros para os objetos que substituíram Exporter.


    Removido

    Os métodos que exigiam um objeto deste tipo foram removidos.

    FREM_DocumentAnalyzer

    Removido

    Esta constante não está mais em uso.

    Removido

    Esta propriedade está obsoleta desde o FineReader Engine 11. Use a propriedadeno lugar.

    Removido

    Esta propriedade está obsoleta desde o FineReader Engine 11. Use a propriedadedo objetono lugar.

    Removido

    Use a propriedadepara emular o layout original do texto com o auxílio de espaços.

    WS_Default

    Removido

    Windows

    Recomendamos usar WS_Auto para garantir a melhor qualidade de reconhecimento.

    Se precisar selecionar o estilo de escrita correspondente ao idioma atual do sistema operacional, use WS_DetectByLocale.

    Removido

    Use a propriedade KeepPageBreaks no lugar.

    PEM_SingleLineParagraphsWithSpaceFormatting

    Removido

    Use a propriedadepara emular a aparência original do texto com o auxílio de espaços ao exportar para o formato TXT.

    Removido

    Use a propriedadepara selecionar o tipo de criptografia.

    Removido

    Use a propriedade LanguageDetectionMode para gerenciar a detecção automática de idiomas de reconhecimento.

    Removido

    Use a nova propriedadeque elimina os diversos níveis de confiança e oferece uma escolha simples: destacar ou não os caracteres reconhecidos com incerteza. Se precisar de uma distinção mais refinada, use a propriedadedo, embora a comparação das confianças de reconhecimento de diferentes caracteres com o mesmo limite nem sempre produza resultados consistentes.

    Obsoleto

    Use a propriedadepara definir o modo de reconhecimento com as constantes(RM_Normal corresponde a BalancedMode = TRUE e RM_Fast corresponde a FastMode = TRUE).

    AEM_FastMode

    AEM_BalancedMode

    Obsoleto

    Os módulos que utilizavam essas constantes estão obsoletos.


    Removido

    A propriedade que utilizava esta enumeração foi removida.

    Renomeado, tipo alterado

    Essas propriedades agora se chamame CorrectResolution, e são do tipo. Os valores padrão permanecem os mesmos.

    Renomeado, tipo alterado

    Essas propriedades agora se chamam,, e são do tipo. Os valores padrão permanecem os mesmos.

    Renomeado, tipo alterado

    Esta propriedade agora se chamae é do tipo. Por padrão, as imagens não são tratadas como parte do plano de fundo.


    Removido

    As propriedades que utilizavam essas enumerações agora são de outro tipo.

    Obsoleto

    Esta propriedade está obsoleta e será removida em versões futuras. Os mesmos resultados podem ser obtidos definindo a propriedadecomo TXTLRM_ExactCopy.

    Removido

    Esta propriedade já estava obsoleta.

    Obsoleto

    Esta propriedade agora está obsoleta e será removida em versões futuras.

    Obsoleto

    Estas propriedades agora estão obsoletas e serão removidas em versões futuras.

    Obsoleto no Windows e no Linux

    Esta propriedade agora está obsoleta e será removida em versões futuras.

    Objeto/EnumeraçãoPropriedade/Método/ConstanteO que aconteceu?Comentário
    ClassificationEtalon ClassificationParams ClassificationClass ClassificationClasses ClassificationTrainer ClassificationTrainerError ClassificationTrainerErrors ClassificationTrainerErrorTypeEnum ClassificationModeEnum<br />RemovidoA API antiga de classificação foi removida. O treinamento de modelos de classificação agora é realizado por meio do objeto Trainer, com as configurações especificadas em TrainingParams e ValidationParams, e os dados de entrada fornecidos como TrainingData. A classificação de documentos ou páginas agora pode ser feita por meio do objeto Model. Tanto o treinamento quanto a classificação exigem a conversão prévia de um documento ou de uma página em um ClassificationObject, o que pode ser feito com os métodos do objeto ClassificationEngine. Veja também Objetos relacionados à classificação e a descrição do cenário Classificação.

    Objeto/Enumeração

    Propriedade/Método/Constante

    O que aconteceu?

    Comentário

    DocumentInfo


    Removido

    Os métodos que exigiam um objeto desse tipo foram removidos.

    DocumentContentInfo

    Removido

    O objeto que contém informações sobre autor, palavras-chave, assunto e título do documento pode ser obtido por meio da propriedade DocumentContentInfo do objeto FRDocument.