JoyPro2 Discord GitHub
Páginas da interface

Modo de ajuda e visitas

Mostrar:

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.

  1. Janela Os seus jogos
    no primeiro arranque de todos
  2. As boas-vindas
    O que quer fazer?
  3. 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.

#As boas-vindas

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.

#Visitas

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):

  1. 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.
  2. 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.
  3. 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.
  4. 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).

Avançado

#Detalhes

  • 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.

Detalhes técnicos internos

#Por trás da ajuda

  • 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.

#Referência

A documentação das funções por trás desta página, gerada a partir do repositório:

#Todos os controlos desta página

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.

#Fechar

Botãoescritos

Dica Fechar esta ajuda (o modo de ajuda continua ativo)

Fecha esta pequena janela.

Fecha esta janela de ajuda; o modo de ajuda continua ativado.

Clique no controlo seguinte para ler a sua ajuda, ou prima F1 ou Esc para sair do modo de ajuda.

Mais detalhes (em inglês)

#Mostra ou oculta a explicação mais longa

Botãoescritos

Mostra ou oculta o texto mais longo.

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.

Com palavras fáceis começa fechada.

Mais detalhes (em inglês)

#Mais na wiki

Botãoescritos

Dica Abre no seu browser a página deste controlo na wiki do JoyPro

Abre o site do JoyPro no navegador.

Mais na wiki abre no seu navegador a entrada deste controlo na wiki do JoyPro.

Aí encontra os pormenores, as imagens e como o controlo funciona em conjunto com o resto do JoyPro.

Mais detalhes (em inglês)

#Configurar tudo por mim

Botãoescritos

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.

Mais detalhes (em inglês)

#Abrir o meu perfil do JoyPro 1

Botãoescritos

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.

Mais detalhes (em inglês)

#Voltar

Botãoescritos

Dica O passo anterior

Volta um passo atrás.

Voltar vai para o passo anterior desta visita.

Fica a cinzento no primeiro passo.

Mais detalhes (em inglês)

#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.

Mais detalhes (em inglês)

#Saltar

Botãoescritos

Dica Saltar este passo e ir para o seguinte

Salta este passo.

Saltar deixa este passo de fora e vai para o seguinte sem o fazer.

No último passo, termina a visita.

Mais detalhes (em inglês)

#Terminar visita

Botãoescritos

Dica Terminar a visita (inicie-a de novo com o botão Ajuda > Visitas)

Para a visita.

Terminar visita para a visita onde está e retira o escurecimento.

Pode iniciá-la de novo a qualquer momento com Ajuda > Visitas... ou Configurações > Visitas.

Mais detalhes (em inglês)

#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.

Mais detalhes (em inglês)

#Sair do modo de ajuda

Botãoescritos

Dica Voltar ao normal: os cliques voltam a acionar os botões (F1 ou Esc fazem o mesmo)

Para a ajuda. Os botões voltam a funcionar normalmente.

Sair do modo de ajuda desativa o modo de ajuda, para que os cliques voltem a executar os botões.

F1 ou Esc fazem o mesmo.

Mais detalhes (em inglês)

#O JoyPro sugere isto com base nos jogos que encontrou neste PC

Opçãoescritos

Escolher a resposta que melhor se adapta.

Uma resposta a "O que quer fazer?": escolha a que lhe serve e depois prima Iniciar.

A resposta marcada como sugerido é a que o JoyPro escolheu a partir dos jogos que encontrou neste PC; Sem visita não inicia nada.

Mais detalhes (em inglês)

#Curta

Opçãoescritos

Dica O caminho mais curto: só os passos de que precisa

Uma visita curta só com os passos importantes.

Só o essencial: a visita que escolher mostra só os passos de que precisa, pelo caminho mais curto.

O JoyPro guarda esta escolha para mais tarde.

Mais detalhes (em inglês)

#Longa, com todos os extras

Opçãoescritos

Dica Todos os passos, incluindo os extras

Uma visita longa que mostra tudo.

Todas as funções: a visita que escolher mostra todos os passos, também os extras.

Mais detalhes (em inglês)

#Palavras fáceis: texto grande, frases curtas

Caixa de verificaçãoescritos

Dica Texto grande e frases muito curtas nas visitas e na ajuda. Pode mudar a qualquer momento em Configurações > Visitas.

Texto grande e frases curtas nas visitas e na ajuda.

Palavras fáceis: cartões grandes e os textos mais curtos nas visitas, e a ajuda começa com uma frase simples.

O mesmo interruptor que em Configurações > Visitas; mantém-se após reiniciar.

Mais detalhes (em inglês)

#Escolha inicial das boas-vindas

Botãoescritos

Inicia o que foi escolhido.

Iniciar começa da forma que escolheu: a sua visita, a configuração rápida, ou nada com Sem visita.

O ecrã de boas-vindas conta então como respondido e não volta a abrir sozinho.

Mais detalhes (em inglês)

#Agora não

Botãoescritos

Dica Fecha as boas-vindas; não voltam a aparecer sozinhas

Fecha as boas-vindas. Nada começa.

Agora não fecha o ecrã de boas-vindas sem iniciar nada.

Não volta a aparecer sozinho; Ajuda > Visitas..., Configurações > Visitas ou a entrada JoyPro 2 - Tour ao lado do JoyPro abrem-no de novo.

Mais detalhes (em inglês)