O JoyPro explica-se de quatro formas. O Modo de ajuda (F1) transforma cada clique numa pergunta: clique num botão, campo, linha de lista ou separador e uma pequena janela ao lado diz o que faz, onde se encaixa e o que acontece a seguir, sem o executar. As Visitas apontam para os botões reais um passo de cada vez e esperam pelo seu clique; cada página tem a sua própria Visita desta página. As boas-vindas perguntam uma vez o que quer fazer e começam o caminho que lhe serve. A resposta rápida, "Só pôr o meu manche a funcionar", inicia a configuração rápida do JoyPro: a mesma de Concluído, e configurar tudo por mim do primeiro arranque e de Configurar tudo por mim na página Início. Palavras fáceis torna tudo o mais simples possível: cartões grandes e as frases mais curtas, para crianças e para quem quiser tudo simples.
Janela Os seus jogos no primeiro arranque de todos
As boas-vindas O que quer fazer?
Uma visita ou a configuração rápida o que se adequar à sua resposta
Concluído, e configurar tudo por mim na janela Os seus jogos salta as boas-vindas: a configuração rápida começa de imediato. Sem a janela Os seus jogos (atualiza a partir de um JoyPro 2 mais antigo), as boas-vindas vêm primeiro.
Para iniciantes
#Modo de ajuda: clique em qualquer coisa para saber o que faz
Prima F1 (ou Ajuda em cima à direita > Modo de ajuda (F1)). O ponteiro do rato passa a ponto de interrogação e uma linha no topo diz "Modo de ajuda: clique em qualquer elemento para ver o que faz. F1 ou Esc termina-o."
Clique num controlo: ele não é executado. Uma pequena janela ao lado mostra:
primeiro uma frase simples sobre o que faz ("Clicar aqui e depois premir um botão do manche."),
Mais detalhes / Menos detalhes: a explicação mais longa, Porque é importante (para que serve esta parte do JoyPro no quadro geral), O que acontece a seguir e Palavras explicadas (até duas palavras do JoyPro do texto, numa frase simples cada: "Relação: uma tarefa, como 'subir o trem de aterragem', em todos os seus jogos e aeronaves de uma vez."). Aberto por predefinição; com Palavras fáceis começa fechado,
Mais na wiki: a entrada do controlo neste site.
Um botão com menu (Ajuda, Mais ...) lista as suas entradas, cada uma com uma linha curta.
Um sítio vazio de uma página explica a página.
O contorno por baixo do rato mostra que controlo um clique explicaria. A roda do rato continua a deslocar a página.
Com o teclado: vá até um controlo com Tab e prima Enter ou Espaço para ver a ajuda dele.
F1, Esc ou Sair do modo de ajuda na linha do topo termina o modo de ajuda; os cliques voltam a executar os botões.
Da primeira vez que abre esta versão do JoyPro (também quando vem de um JoyPro 2 mais antigo), pergunta uma vez: O que quer fazer? Quando aparece a janela "Os seus jogos" do primeiro arranque, as boas-vindas vêm logo a seguir. O JoyPro escolhe a resposta que se adequa aos jogos que encontrou e marca-a como sugerido; escolha outra se lhe servir melhor.
Resposta
O que acontece
Jogar ACE COMBAT com o meu manche
Uma visita que transforma o seu manche e acelerador num comando Xbox simulado: primeiro Configurar tudo por mim (a configuração rápida; o cartão espera enquanto a janela dela está aberta, e o seu Configurar o comando simulado trá-lo de volta), depois a página Joystick virtual: o ajudante gratuito ViGEmBus quando falta (primeiro marque a caixa por baixo da licença, depois Instalar ViGEmBus; o Windows pede autorização uma vez), Testar no separador Teste em direto (o cartão fica até mover o manche e premir Seguinte), e quando premir Iniciar: inicie o jogo; no ecrã de título mantenha Alt premido e prima Tab para voltar, clique em Iniciar, Alt+Tab de volta ao jogo.
DCS World ou Falcon BMS
Uma visita ao caminho do DCS: o seu perfil, ler as suas atribuições do DCS, relações em todas as aeronaves, curvas dos eixos, modo de retenção, exportação e a verificação.
Só pôr o meu manche a funcionar
A configuração rápida (abaixo), depois "Funcionou!" na página Início e uma visita curta: onde mudar um botão mais tarde (escolha um controlo do jogo na lista, depois Gravar entrada), como o enviar de novo para o jogo, "Pronto! Inicie o seu jogo".
Fazer uma visita guiada
As cinco ideias por trás do JoyPro (perfil, relações, atribuições, exportação, verificação), uma de cada vez, com grandes destaques; espera pelos seus cliques.
Usei o JoyPro 1
Onde está agora cada função do JoyPro 1: carregar e guardar, importar, relações, atribuições e curvas, exportar, a validação. O JoyPro 2 abre o seu perfil do JoyPro 1 tal como está: a visita oferece Abrir o meu perfil do JoyPro 1 quando o encontra (é aberta uma cópia; o ficheiro do JoyPro 1 fica). Sugerida quando esse perfil está no PC.
Sem visita
Nada começa.
Que duração para a visita?Curta mostra os passos de que precisa; Longa, com todos os extras mostra também os extras (por exemplo o passo da retenção na visita do DCS). Palavras fáceis (também em Configurações > Visitas) torna cada cartão grande e o texto dele o mais curto possível; o alemão passa então a usar "du". Prima Iniciar, ou Agora não para fechar as boas-vindas. Em qualquer dos casos, não voltam sozinhas; Ajuda > Visitas..., Configurações > Visitas > Mostrar as boas-vindas e a entrada JoyPro 2 - Tour ao lado do JoyPro abrem-nas de novo a qualquer momento.
Uma visita escurece a janela e faz brilhar o controlo real de que fala. Um cartão ao lado diz o que fazer; quatro cartões têm também uma pequena imagem: o que é um eixo de joystick, o que é o comando simulado, o que faz Exportar e como Alt+Tab o traz de volta de um jogo em ecrã inteiro.
Muitos passos esperam por si: "Clique em Relações na barra em baixo." e "À espera de que clique no botão que brilha." O passo continua sozinho quando clica. Num passo que lhe pede para abrir uma página, Seguinte abre-a por si, mesmo uma página que ocultou na barra inferior; num passo que espera por outro clique, Seguinte continua sem ele.
Seguinte é o grande botão azul. Voltar recua um passo; as pequenas ligações Saltar (deixa um passo de fora) e Terminar visita (para). O Terminar do último passo acaba a visita.
Feche o JoyPro a meio de uma visita e ela continua no mesmo passo no próximo arranque.
Visita desta página (em cima à direita, ao lado de Ajuda, e no menu Ajuda) mostra a página aberta: para que serve, as partes principais e o que vem a seguir.
Configurações > Visitas lista todas as visitas com Iniciar visita; uma visita que fez até ao fim fica marcada como vista.
#A configuração rápida: "Só pôr o meu manche a funcionar"
Para quem quer botões a funcionar e mais nada, a resposta rápida das boas-vindas abre a configuração rápida do JoyPro (o assistente de configuração a correr sozinho):
O JoyPro encontra os seus jogos e os seus dispositivos e faz a configuração sozinho. Um dispositivo que o JoyPro não conhece é descrito em palavras simples e configurado como um dispositivo habitual do seu tipo.
A revisão mostra o resultado como uma lista simples: que botão faz o quê ("Botão 4: Recarregar armas"). Mostrar a imagem em grande mostra o seu dispositivo com todos os botões; Alterar algo abre as ferramentas para mover, trocar ou deixar de fora uma função.
Prime Usar estes botões e depois Escrever no meu jogo (só um botão azul de cada vez). Os controlos antigos do jogo ficam guardados como backup. A janela fecha-se e uma visita curta mostra onde mudar um botão mais tarde.
Para um jogo que só conhece um comando Xbox (ACE COMBAT, Hell Let Loose: Vietnam), o segundo botão é antes Configurar o comando simulado: a página Joystick virtual mostra os últimos passos (ViGEmBus, Testar, Iniciar no ecrã de título). Esses jogos não precisam de exportação.
Quando algo está a atrapalhar (nenhum jogo encontrado, nenhum manche encontrado), a janela diz o que fazer em palavras simples, com Tentar de novo e Configurar passo a passo (o assistente de configuração com todos os passos).
Que resposta é sugerida: DCS ou Falcon BMS instalado: DCS World ou Falcon BMS. Só jogos de comando Xbox instalados (ACE COMBAT 7, ACE COMBAT 8, Hell Let Loose: Vietnam): Jogar ACE COMBAT com o meu manche. Qualquer outra coisa, ou ainda nenhum jogo encontrado: Só pôr o meu manche a funcionar. A linha por cima das respostas indica os jogos em que se baseou.
Concluído, e configurar tudo por mim do primeiro arranque responde às boas-vindas pelo caminho rápido: a configuração abre-se e as boas-vindas não se abrem ao lado.
Uma vez por utilizador: as boas-vindas contam como respondidas depois de Iniciar ou Agora não, também para Sem visita. Configurações > Visitas > Perguntar de novo no próximo arranque traz as boas-vindas de volta no próximo arranque e marca todas as visitas como não vistas.
Nunca em execuções de teste: as boas-vindas não se abrem quando o JoyPro corre na sua sandbox de testes ou com a variável de ambiente JOYPRO_NO_WELCOME=1.
A entrada JoyPro 2 - Tour: JoyPro 2 - Tour.cmd ao lado de JoyPro.Gui.exe inicia JoyPro.Gui.exe --welcome (também --tour): as boas-vindas abrem-se mesmo que já tenham sido respondidas. Quando o JoyPro já está a correr, a instância em execução vem para a frente e abre as boas-vindas.
O essencial ou todas as funções: a escolha das boas-vindas fica guardada para as visitas do percurso; Configurações > Visitas tem a sua própria escolha para as visitas iniciadas a partir da sua lista. Visita desta página mostra sempre todos os passos.
As visitas encontram os controlos pelo nome, não pela posição: o tamanho da janela, a escala da interface, o tema e a ordem da barra inferior não importam. Um controlo que não está no ecrã: o cartão fica no meio da janela escurecida.
F1 não faz nada enquanto as boas-vindas estão abertas. Iniciar uma visita ou as boas-vindas termina o modo de ajuda.
A configuração rápida é a do primeiro arranque e da página Início: executa sozinha os passos do assistente de configuração (engine setup devices, engine setup aircraft, engine setup plan) até à revisão; Usar estes botões aplica o plano (engine setup apply) e Escrever no meu jogo exporta os jogos como a página Exportar (com o seu backup).
No jogo: A configuração rápida escreve no jogo
A configuração rápida só altera um jogo quando prime Escrever no meu jogo: exporta os jogos, como Exportar na página Exportar. Os controlos antigos do jogo ficam guardados como backup; Desfazer exportação na página Exportar repõe-nos. O modo de ajuda e as visitas nunca alteram sozinhos o seu perfil nem os seus jogos; um passo de uma visita só mostra o botão, é você que o prime.
Camada: Views/Controls/HelpLayer.axaml (+ .axaml.cs) por cima do conteúdo da janela, dentro da escala da interface; teclas F1, Esc, Enter e Space: Views/MainWindow.Help.cs. View model: MainWindowViewModel.Help.cs, .Tours.cs; a resposta rápida chama StartQuickSetupAsync (.AutoSetupStart.cs). O controlo debaixo de um clique e o seu texto: Services/Help/HelpResolver.cs; os textos das páginas e as palavras explicadas: Services/Help/HelpCatalog.cs; as visitas: Services/Help/TourCatalog.cs.
Os textos por controlo são as entradas desta wiki: python website/build.py --help-catalog escreve as duas primeiras frases de cada entrada em gui/JoyPro.Gui/Resources/help-controls.json (incorporado na GUI); --check falha enquanto esse ficheiro for mais antigo do que a wiki. Um controlo é associado pelo seu comando, nome, rótulo ou dica.
O que as boas-vindas e as visitas memorizam: ui-settings.json, "tours" (respondidas, o percurso escolhido, o essencial ou todas as funções, as visitas vistas, a visita em curso e o seu passo).
Opções de arranque: Services/StartupOptions.cs (--welcome, --tour), a passagem para a instância já aberta num segundo arranque: AppShell.cs. Referência: Modo de ajuda e visitas.
17 controlos, lidos do código-fonte do programa: 17 escritos, 0 com os factos do código-fonte (dica, comentário no código, chamada ao motor), 0 ainda por desenvolver.
Mais detalhes na janela de ajuda mostra a explicação mais longa: tudo o que o controlo faz, porque é importante, o que acontece a seguir e as palavras do JoyPro que contém.
Dica O JoyPro coloca os controlos do jogo no seu manche e mostra-lhe o resultado
O JoyPro faz este passo automaticamente.
O botão próprio do cartão que faz o passo por si: na visita do comando, Configurar tudo por mim inicia a configuração rápida, e a visita continua por trás da janela dela.
Dica Abre uma cópia do perfil que o JoyPro 1 usou por último (last.pr0file em Documentos, pasta JoyPro). O próprio ficheiro do JoyPro 1 fica como está.
Abrir o meu perfil do JoyPro 1: abre-o no JoyPro 2, que lê os perfis do JoyPro 1 tal como são.
O JoyPro abre uma cópia, por isso o ficheiro do JoyPro 1 fica como está; um segundo clique volta a abrir essa cópia.
#Texto grande e frases muito curtas nas visitas e na ajuda. Pode mudar a qualquer momento em Configurações > Visitas.
Botãoescritos
Muda para texto grande e frases muito curtas.
Palavras mais fáceis ativa ou desativa as palavras fáceis mesmo onde um cartão é difícil de ler: cartões grandes, os textos mais curtos e uma ajuda que começa com uma frase simples.
O mesmo interruptor que em Configurações > Visitas; mantém-se após reiniciar.
#O passo seguinte (um passo que lhe pede para abrir uma página abre-a por si)
Botãoescritos
Passa ao passo seguinte.
Seguinte vai para o passo seguinte da visita, também quando o passo espera pelo seu clique.
Num passo que pede para abrir uma página, abre a página por si, mesmo uma que tenha ocultado na barra inferior; no último passo, o botão diz Terminar e termina a visita.