Merge pull request #43 from sharkboyto/develop

Release 2023.1.1

addon/doc/it/readme.md

@@ -29,6 +29,7 @@ Si noti che Nao funziona con Windows Explorer, sul desktop, con il file manager
   * F: trova il testo e legge alcune parole prima e dopo la stringa.
 * NVDA + Shift + Ctrl + R: Effettua lo screenshot dell'intera videata e la riconosce.
   * Si tenga presente che è possibile utilizzare i comandi standard di NVDA per esplorare la finestra e portare il focus su un elemento. Ad esempio ci si può spostare con i tasti freccia e premere invio in un pulsante per attivarlo. Inoltre si può anche portare il mouse in quella posizione premendo la combinazione NVDA+barra del tastierino numerico e quindi fare clic con i tasti sinistro/destro.
+* NVDA + Shift + Ctrl + W: Effettua lo screenshot della finestra corrente e la riconosce (stesse funzionalità di navigazione dello screenshot dell'intera videata).
 
 Inoltre, si possono personalizzare le scorciatoie di Nao semplicemente dalla finestra di dialogo Tasti e gesti di immissione di NVDA. Aprire il menu NVDA, andare su preferenze e da quel sottomenu selezionare la finestra di dialogo tasti e gesti di immissione. La cosa importante da tenere a mente è che questi gesti non sono globali; essi appariranno soltanto se ci si trova in un ambiente in cui Nao può funzionare: desktop, Esplora file, Total Commander o Xplorer.
 
@@ -44,6 +45,20 @@ Se pensi che il nostro lavoro sia buono e migliori la tua vita, a <a href="https
 Vuoi segnalare un bug, suggerire nuove funzionalità, tradurre l'addon nella tua lingua? Abbiamo l'e-mail per te! Scrivi a [email protected] e saremo felici di aiutarti.
 
 ## Cronologia
+### 2023.1.1
+* Ripristinata compatibilità con NVDA versione 2023.3
+* Nuova hotkey NVDA + Ctrl + Shift + W effettua lo screenshot della finestra corrente e la riconosce
+* Aggiunta traduzione in Portoghese Brasiliano
+* Fix di sicurezza su Secure Screens
+* Rimosso menu strumenti NAO su Secure Screens
+* Rimossa cache documenti su Secure Screens
+* Aggiunti link al sito web NAO e al repository Git nel menu strumenti NAO
+### 2023.1
+* Compatibilità NVDA versione 2023.1
+### 2022.1.3
+* Compatibilità NVDA versione 2022.1
+* Traduzione in Cinese Semplificato e Francese aggiornate
+* Documentazione in spagnolo aggiornata
 ### 2022.1.2
 * Salvataggio e caricamento di file formato nao-document.
 * Una cache documenti conserva i riconoscimenti per velocizzarne l'apertura successivamente. Se un file viene trovato in cache non viene rieseguito il riconoscimento ma viene aperta la copia in cache (i parametri di riconoscimento devono essere uguali).

addon/doc/pt_BR/readme.md

@@ -0,0 +1,83 @@
+# Nao - Reconhecimento óptico de caracteres avançado para NVDA
+
+* Autores: Alessandro Albano, Davide De Carne, Simone Dal Maso
+* Baixar [Versão estável][1]
+* Compatível com NVDA: 2019.3 em diante
+
+Nao (reconhecimento óptico de caracteres avançado para NVDA) é um complemento que melhora a funcionalidade padrão de reconhecimento óptico de caracteres oferecida pelo NVDA em versões modernas do Windows.
+Enquanto o o comando padrão do NVDA usa os recursos de OCR do Windows para efetuar o reconhecimento da tela, o NAO é capaz de efetuar reconhecimento em arquivos salvos no disco rígido ou em dispositivos USB.
+Use tecla NVDA-Shift-R para efetuar reconhecimento em qualquer tipo de imagem ou pdf!
+Simplesmente coloque o cursor sobre o arquivo desejado, sem abri-lo, e pressione tecla NVDA-Shift-R.
+O arquivo será reconhecido e uma janela simples de texto aparecerá, na qual você poderá ler todo o conteúdo reconhecido, efetuar buscas por texto específico, copiar para a área de transferência e salvá-lo.
+O Nao também é capaz de lidar com PDFs contendo múltiplas páginas, então se você tiver um documento inacessível não se preocupe, o OCR do Windows será capaz de fazer o reconhecimento total.
+
+## Requisitos de sistema
+Este complemento funciona nos Windows 10 e 11, já que esses sistemas oferecem serviço nativo de reconhecimento ótico de caracteres.
+O Nao requer uma versão do NVDA igual ou superior a 2019.3, então não tente utilizá-lo com versões mais antigas do leitor de telas.
+Note que o Nao funciona apenas quando usado com o Windows Explorer, na área de trabalho, com o Total Commander ou com o xplorer² filemanager. Não tente utilizá-lo com aplicativos como o 7zip ou Winrar, já que esses programas não são suportados.
+
+## Funcionalidades e comandos
+* NVDA + Shift + R: reconhece qualquer tipo de imagem ou pdf a partir do sistema de arquivos;
+  * PgUp / PgDown: move o cursor entre páginas reais de um documento de múltiplas páginas.
+  * Ctrl + S: Salva o documento no formato nao-document-format.
+  * P: Informa o número da página atual relativa ao cursor em um documento de múltiplas páginas.
+  * L: informa a linha atual com relação à página corrente.
+  * Shift + L: informa a linha atual com relação ao documento inteiro.
+  * G: Vai diretamente a uma página.
+  * C: copia todo o texto para a área de transferência.
+  * S: salva uma cópia do documento no formato texto.
+  * F: localiza texto e lê algumas palavras antes e depois do resultado.
+* NVDA + Shift + Ctrl + R: realiza a captura completa da tela e reconhece o conteúdo.
+  * Note que é possível usar comandos padrão do NVDA para explorar a janela e mover o foco para um elemento. Por exemplo, você pode usar as setas para se mover até um botão e pressionar enter para ativá-lo. Você também pode mover o cursor do mouse até a posição atual com tecla NVDA-barra do teclado numérico e clicar com o botão esquerdo ou direito.
+
+Note que você pode alterar as teclas de atalho do Nao usando o diálogo de definição de comandos do NVDA. Acesse o menu do NVDA, vá até preferências e no sub menu selecione definir comandos. Lembre-se de que essas funcionalidades não são globais, elas só funcionarão em aplicativos de onde é possível realizar OCR. Assim, esses gestos aparecerão apenas se você estiver na área de trabalho, no explorador de arquivos, no Total Commander ou no Xplorer.
+
+Você também pode abortar um processo de OCR apenas pressionando "Cancelar" na janela com a barra de progresso.
+
+Também é possível encontrar um sub menu chamado Nao dentro do menu de ferramentas do NVDA. No momento, ele apenas oferece acesso a um diálogo de onde é possível fazer uma doação, mas nós vamos melhorá-lo com novas funcionalidades!
+
+## Suporte e doações
+Nao é totalmente gratuito. Entretanto, lembre-se de que este complemento é feito durante o tempo livre de seus desenvolvedores.
+Nós apreciaríamos demais qualquer contribuição que você possa nos dar!
+Se você entender que nosso trabalho é bom e melhora sua vida, <a href="https://nvda-nao.org/donate">considere fazer uma doação.</a>
+
+Quer reportar um bug, sugerir novas funcionalidades, traduzir o complemento para o seu idioma? Temos um e-mail para você! Apenas escreva para [email protected] e nós estaremos felizes em ajudá-lo.
+
+## Histórico
+### 2022.1.2
+* Salvar e carregar arquivos no formato de arquivo nao-document file format.
+* Um cache de documentos reconhecidos anteriormente torna o processo de reconhecimento mais rápido. Se um arquivo for detectado  no cache, a versão cacheada é usada em vez de um novo reconhecimento ocorrer.
+* Armazenar a última posição de leitura nos meta dados do cache.
+* Limpeza automática para o cache de documentos.
+* Limpeza manual do cache a partir do menu de ferramentas.
+* Agora, um arquivo pode ser reconhecido diretamente a partir de uma pasta comprimida no Windows explorer.
+* Melhor detecção de arquivos inválidos.
+* Melhor compatibilidade com Windows Explorer usando diferentes estratégias de seleção de arquivos: Primeiro, tentar usando Shell.Application no NVDA, depois tentar Shell.Application no PowerShell e, por fim, usar navegação manual.
+* Motor de OCR mantém a configuração do idioma atual mesmo se este for mudado durante um processo de reconhecimento de documentos de múltiplas páginas.
+* Fila de OCR para reconhecimento a partir de múltiplas origens.
+* Comando pg down vai até o fim do documento e anuncia a linha atual quando usado na última página de um documento.
+* Diretório temporário do Windows é usado para as ferramentas de conversão de arquivo em vez do diretório do complemento (melhor desempenho no NVDA portável).
+* Tradução para Romeno e atualização da tradução para Chinês simplificado.
+### 2022.1.1
+* Suporte para o formato de arquivo DjVu.
+* Suporte para arquivos tiff de múltiplas páginas.
+* Correção de bugs de codificação de PDFs em sistemas operacionais em chinês simplificado.
+* Atualização manual do complemento no menu ferramentas do NVDA.
+* Compatibilidade com NVDA a partir da versão 2019.3.
+### 2022.1
+* Atualizações automáticas do complemento.
+* Atualização nas traduções para Francês e Espanhol.
+### 2021.2
+* OCR de PDFs e imagens é apresentado em uma nova janela de texto, com alguns comandos para operações simples.
+* Suporte para o gerenciador de arquivos Xplorer.
+* Teclas de comando do Nao podem ser modificadas a partir do diálogo de definir comandos do NVDA.
+* Nao funciona apenas em contexto apropriado, então se você estiver em um aplicativo onde seu funcionamento não faz sentido os seus comandos serão ignorados. Isso resolveu um problema sério que impedia que usuários do Word e do Excel pressionassem nvda-Shift-R, uma vez que o complemento estava interceptando esse comando incorretamente.
+* Um processo longo de OCR pode ser abortado simplesmente pressionando-se o botão "Cancelar" na janela da barra de progresso.
+* Traduções para Turco, Russo, Espanhol, Chinês e Francês adicionadas.
+* Usuários podem fazer doações para o projeto.
+* Corrigido um bug com alguns caracteres em nomes de arquivos que impediam o processo de OCR de ocorrer corretamente.
+### 2021.1
+* Primeira versão pública!
+
+[1]: https://nvda-nao.org/download
+

addon/globalPlugins/nao/__init__.py

@@ -1,9 +1,10 @@
 #Nao (NVDA Advanced OCR) is an addon that improves the standard OCR capabilities that NVDA provides on modern Windows versions.
 #This file is covered by the GNU General Public License.
 #See the file COPYING for more details.
-#Last update 2022-02-04
+#Last update 2022-04-23
 #Copyright (C) 2021 Alessandro Albano, Davide De Carne and Simone Dal Maso
 
+import globalVars
 import globalPluginHandler
 import addonHandler
 from scriptHandler import script
@@ -30,7 +31,8 @@ def h():
 			if file_dialog.ShowModal() != wx.ID_CANCEL:
 				filename = file_dialog.GetPath()
 				OCRHelper(ocr_document_file_extension=OCR_DOCUMENT_FILE_EXTENSION, ocr_document_file_cache=NaoDocumentCache(), speak_errors=False).recognize_file(filename)
-	wx.CallAfter(h)
+	if not globalVars.appArgs.secure:
+		wx.CallAfter(h)
 
 class RecognizableFileObject(ScriptableObject):
 	# Allow the bound gestures to be edited through the Input Gestures dialog (see L{gui.prePopup})
@@ -43,25 +45,30 @@ class RecognizableFileObject(ScriptableObject):
 		category=ADDON_SUMMARY
 	)
 	def script_recognize_file(self, gesture):
-		try:
-			filename = explorer.get_selected_file()
-		except:
-			filename = None
-		if filename:
-			OCRHelper(ocr_document_file_extension=OCR_DOCUMENT_FILE_EXTENSION, ocr_document_file_cache=NaoDocumentCache()).recognize_file(filename)
-		else:
-			BrowseAndRecognize()
+		if not globalVars.appArgs.secure:
+			try:
+				filename = explorer.get_selected_file()
+			except:
+				filename = None
+			if filename:
+				OCRHelper(ocr_document_file_extension=OCR_DOCUMENT_FILE_EXTENSION, ocr_document_file_cache=NaoDocumentCache()).recognize_file(filename)
+			else:
+				BrowseAndRecognize()
 
 class GlobalPlugin(globalPluginHandler.GlobalPlugin):
 	def __init__(self):
-		from .nao_pickle import NaoPickle
-		from .systray_menu import SysTrayMenu
-		from .framework.generic.updates import AutoUpdates, ManualUpdatesCheck
 		super(GlobalPlugin, self).__init__()
-		self._systray = SysTrayMenu()
-		self._systray.create(on_updates_check=lambda: ManualUpdatesCheck(UPDATES_URL, pickle=NaoPickle()), on_select_file=BrowseAndRecognize)
-		self._auto_updates = AutoUpdates(url=UPDATES_URL, pickle=NaoPickle())
-		self._scheduled_cache_purge = NaoDocumentCache.schedule_purge()
+		if globalVars.appArgs.secure:
+			# Clear the unuseful document cache in secure screen
+			NaoDocumentCache.clear()
+		else:
+			from .nao_pickle import NaoPickle
+			from .systray_menu import SysTrayMenu
+			from .framework.generic.updates import AutoUpdates, ManualUpdatesCheck
+			self._systray = SysTrayMenu()
+			self._systray.create(on_updates_check=lambda: ManualUpdatesCheck(UPDATES_URL, pickle=NaoPickle()), on_select_file=BrowseAndRecognize)
+			self._auto_updates = AutoUpdates(url=UPDATES_URL, pickle=NaoPickle())
+			self._scheduled_cache_purge = NaoDocumentCache.schedule_purge()
 
 	def terminate(self):
 		ProgramTerminate()
@@ -82,4 +89,13 @@ def chooseNVDAObjectOverlayClasses(self, obj, clsList):
 		category=ADDON_SUMMARY
 	)
 	def script_recognize_screenshot(self, gesture):
-		OCRHelper.recognize_screenshot()
+		OCRHelper.recognize_screenshot()
+
+	@script(
+		# Translators: Message presented in input help mode.
+		description=_("Take a screen shot of the current window and recognize it"),
+		gesture="kb:NVDA+shift+control+W",
+		category=ADDON_SUMMARY
+	)
+	def script_recognize_current_window(self, gesture):
+		OCRHelper.recognize_screenshot(current_window=True)

addon/globalPlugins/nao/donate.py

@@ -1,39 +1,42 @@
 #Nao (NVDA Advanced OCR) is an addon that improves the standard OCR capabilities that NVDA provides on modern Windows versions.
 #This file is covered by the GNU General Public License.
 #See the file COPYING for more details.
-#Last update 2021-12-22
+#Last update 2022-04-23
 #Copyright (C) 2021 Alessandro Albano, Davide De Carne and Simone Dal Maso
 
 import addonHandler
+import globalVars
 
 from .framework import language
 
 language.initTranslation()
 
 def open():
-	import languageHandler
-	import webbrowser
-	lang = languageHandler.getLanguage()
-	if lang:
-		lang = lang.split("_")[0].lower()
-	else:
-		lang = 'en'
-	webbrowser.open("https://nvda-nao.org/donate?lang={lang}".format(lang=lang))
+	if not globalVars.appArgs.secure:
+		import languageHandler
+		import webbrowser
+		lang = languageHandler.getLanguage()
+		if lang:
+			lang = lang.split("_")[0].lower()
+		else:
+			lang = 'en'
+		webbrowser.open("https://nvda-nao.org/donate?lang={lang}".format(lang=lang))
 
 def request():
-	import wx
-	import gui
-
-	# Translators: The title of the dialog requesting donations from users.
-	title = _N("Please Donate")
-
-	# Translators: The text of the donate dialog
-	message = _("""{name} - free add-on for NVDA.
+	if not globalVars.appArgs.secure:
+		import wx
+		import gui
+
+		# Translators: The title of the dialog requesting donations from users.
+		title = _N("Please Donate")
+
+		# Translators: The text of the donate dialog
+		message = _("""{name} - free add-on for NVDA.
 You can make a donation to our team for helping further development of this add-on.
 Do you want to make a donation now? For transaction you will be redirected to the website of the developer.""")
-
-	name = addonHandler.getCodeAddon().manifest['summary']
-	if gui.messageBox(message.format(name=name), title, style=wx.YES_NO|wx.ICON_QUESTION) == wx.YES:
-		open()
-		return True
+		
+		name = addonHandler.getCodeAddon().manifest['summary']
+		if gui.messageBox(message.format(name=name), title, style=wx.YES_NO|wx.ICON_QUESTION) == wx.YES:
+			open()
+			return True
 	return False

addon/globalPlugins/nao/framework/generic/screen.py

@@ -1,25 +1,56 @@
 #Nao (NVDA Advanced OCR) is an addon that improves the standard OCR capabilities that NVDA provides on modern Windows versions.
 #This file is covered by the GNU General Public License.
 #See the file COPYING for more details.
-#Last update 2021-12-16
+#Last update 2022-04-22
 #Copyright (C) 2021 Alessandro Albano, Davide De Carne and Simone Dal Maso
 
-import wx
-import screenBitmap
-import vision
-from visionEnhancementProviders.screenCurtain import ScreenCurtainProvider
-
 def get_size(dc=None):
 	if dc is None:
+		import wx
 		dc = wx.ScreenDC()
 	return dc.Size.Get()
 
-def take_snapshot_pixels():
-	size = get_size()
-	sb = screenBitmap.ScreenBitmap(size[0], size[1])
-	return [sb.captureImage(0, 0, size[0], size[1]), size[0], size[1]]
+def get_window_rect(windowHandle):
+	if windowHandle:
+		import ctypes
+		from locationHelper import RectLTWH
+		r = ctypes.wintypes.RECT()
+		ctypes.windll.user32.GetWindowRect(windowHandle, ctypes.byref(r))
+		return RectLTWH.fromCompatibleType(r)
+	return None
+
+def get_current_window_rect():
+	import api
+	obj = api.getForegroundObject()
+	if obj:
+		return get_window_rect(obj.windowHandle)
+	return None
+
+def take_snapshot_pixels(x=0, y=0, width=None, height=None, current_window=False, only_positive_coordinates=False):
+	import screenBitmap
+	if current_window:
+		rect = get_current_window_rect()
+		if not rect:
+			return None
+		x = rect.left
+		y = rect.top
+		width = rect.width
+		height = rect.height
+	else:
+		if width is None or height is None: width, height = get_size()
+	if only_positive_coordinates:
+		if x < 0:
+			width += x
+			x = 0
+		if y < 0:
+			height += y
+			y = 0
+	sb = screenBitmap.ScreenBitmap(width, height)
+	return [sb.captureImage(x, y, width, height), x, y, width, height]
 
 def have_curtain():
+	import vision
+	from visionEnhancementProviders.screenCurtain import ScreenCurtainProvider
 	screenCurtainId = ScreenCurtainProvider.getSettings().getId()
 	screenCurtainProviderInfo = vision.handler.getProviderInfo(screenCurtainId)
 	return bool(vision.handler.getProviderInstance(screenCurtainProviderInfo))

addon/globalPlugins/nao/framework/generic/updates.py

@@ -1,9 +1,10 @@
 #Nao (NVDA Advanced OCR) is an addon that improves the standard OCR capabilities that NVDA provides on modern Windows versions.
 #This file is covered by the GNU General Public License.
 #See the file COPYING for more details.
-#Last update 2022-01-27
+#Last update 2022-04-23
 #Copyright (C) 2021 Alessandro Albano, Davide De Carne and Simone Dal Maso
 
+import globalVars
 import threading
 import time
 import os
@@ -172,7 +173,7 @@ def _check_proc():
 			self._thread = None
 			if cb: wx.CallAfter(cb, self, status, cb_data)
 
-		if not self._thread:
+		if not self._thread and not globalVars.appArgs.secure:
 			self._thread = threading.Thread(target = _check_proc)
 			self._thread.setDaemon(True)
 			self._thread.start()
@@ -327,7 +328,6 @@ def terminate(self):
 		self._pickle = None
 
 	def _check_remaining_time(self):
-		import globalVars
 		if self._timer and self._timer.IsRunning():
 			self._timer.Stop()
 			self._timer = None