Arquivos na IDE: salvar, ler, exportar e importar

A IDE manipula vários tipos de arquivo, e cada um tem um papel diferente. Antes de decorar botões, vale entender o mapa geral:

O menu File: o projeto inteiro

O menu File (canto superior esquerdo) trata do projeto como um todo. Um projeto CrossScript não é só o texto do programa: ele inclui o script .CSX, o Assembly da aba ao lado, os tiles do Tile Editor, os sprites do Sprite Editor e a tela do Screen Editor.

• New Project — limpa tudo e começa um projeto vazio.
• Save (.csxproj) — grava o projeto inteiro num único arquivo .CSXPROJ no seu computador. Se o projeto ainda não tem nome, a IDE pergunta um.
• Save As (.csxproj) — grava uma cópia com outro nome, sem perder o projeto atual.
• Load Project (.csxproj) — abre um .CSXPROJ gravado antes e restaura tudo: código, tiles, sprites e tela.
• Ler DSK (drive A) — insere uma imagem de disquete .DSK no drive A do emulador. Útil para testar programas que leem arquivos do disco (capítulo 27).

O próprio menu mostra, na parte de baixo, o que existe no projeto aberto: o tamanho do script, do Assembly e se há tiles, sprites e tela gravados.

Salvamento na nuvem

Com login feito, aparecem mais duas opções:

• Save no Cloud — guarda o projeto na sua conta, sem baixar arquivo.
• Minhas aplicações — abre a lista dos seus projetos guardados, para abrir, renomear ou apagar.

A nuvem é opcional: o .CSXPROJ no seu computador continua sendo a forma mais direta de guardar e transportar um projeto.

O menu Arquivo: gravar e ler cada peça

Acima do editor fica o menu Arquivo, dividido em duas partes.

Gravar (exportar)

• .CSX (Script) — baixa o texto do programa como script.csx.
• .ASM (Assembly) — baixa o Assembly. Se a aba aberta for a de CSX, a IDE baixa o Assembly gerado pelo compilador (script.asm); se for a aba Assembly, baixa o que está nela (main.asm).
• .ROM (Binário) — compila, monta e baixa o cartucho main.rom.
• .BIN (BLOAD disco) — baixa MAIN.BIN, um binário com cabeçalho de 7 bytes que o BASIC carrega com BLOAD "MAIN.BIN",R.
• .COM (MSX-DOS) — baixa o executável de DOS. Atenção: um .COM precisa começar no endereço $0100, então esta opção só funciona quando o programa usa MEMORY COM (veja abaixo).

Ler (importar)

• .CSX (Script) — abre um arquivo .CSX no editor, substituindo o programa atual.
• .ASM (Assembly) — abre um arquivo .ASM na aba Assembly.
• .ROM (Disassemblar) — lê um cartucho e mostra o Assembly correspondente na aba Assembly, para estudo.

O botão Run e a diretiva MEMORY

O que o botão ▶ Run faz depende da primeira linha do programa, a diretiva MEMORY:

O disquete com Nextor

A palavra NEXTOR no fim da diretiva pede à IDE para gravar o sistema operacional Nextor dentro do próprio disquete, junto com o seu programa. O Nextor é um sistema livre e de código aberto, feito para ser copiado em discos — por isso a IDE já o traz embutido e não há problema em distribuir o disquete gerado. (O que teria restrição seria o MSX-DOS 1/2 original, da Microsoft/ASCII, que a IDE não usa.)

Vale tanto para MEMORY COM ... NEXTOR (programa .COM) quanto para MEMORY DSK ... NEXTOR (binário BLOAD). O mesmo ajuste existe no seletor Mem, na opção DSK NEXTOR + .COM….

O mesmo ajuste existe no seletor Mem ao lado do Run: AUTO, 16K, 32K, MAPPER e a opção DSK BUILD…, que pergunta o endereço de carga e o nome do binário e escreve a diretiva MEMORY DSK no programa por você.

Resumo: qual arquivo para qual situação

• Quero guardar meu trabalho completo → File › Save (.csxproj).
• Quero guardar só o texto do programa → Arquivo › .CSX.
• Quero um cartucho para emulador ou EPROM → Run com MEMORY ROM, ou Arquivo › .ROM.
• Quero um programa de MSX-DOS → MEMORY COM NAME "NOME" e Run (baixa o .COM).
• Quero um disquete que roda sozinho → MEMORY DSK LOAD $8500 NAME "NOME" e Run (baixa o .DSK).
• Quero testar um disquete que já tenho → File › Ler DSK (drive A).
• Quero estudar um cartucho pronto → Arquivo › .ROM (Disassemblar).