FMOD Events Exporter (Free)

Exportando eventos para uma planilha

Features

- Exporte eventos para planilhas nos formatos TSV ou CSV
- Importe eventos de arquivos TSV ou CSV
- Exportação fácil: copie da área de texto e cole diretamente na planilha
- Formato fixo de 13 colunas, seguindo o estilo de planilhas da Game Audio Academy

Utilização

A documentação é sobretudo útil ao programador. Tendo isso em vista, para o bom funcionamento da exportação, faço algumas recomendações:

Recomendação	Motivo
Adicione uma tag ao evento: loop, one-shot ou cast	Corresponde à coluna Effect Type
Prefixe os nomes dos eventos com `sfx_`, `mus_` ou `scp_`	Corresponde à coluna Type, e os prefixos serão convertidos respectivamente para os valores SFX, Music ou Soundscape.
Preencha o campo `notes`	São anotações de propósito geral que podem ser úteis
Adicione uma User Property ao evento: `task`.	Isso se tornará a 1ª coluna da tabela, que é o nome do evento: Task

Importação

É possível criar eventos no FMOD a partir de linhas em uma planilha exportada como TSV ou CSV, gerando um esqueleto do projeto.

Para realizar isso, siga os seguintes passos:

1. Exporte a sua planilha para um arquivo SEM incluir a primeira linha, que é o cabeçalho
2. No FMOD, acesse Import/Export > Import Events from CSV/TSV...
3. Informe o caminho para o arquivo exportado
4. Pronto! Os eventos serão criados no FMOD.

A tabela abaixo explica o funcionamento da importação, com base em cada uma das colunas da tabela.

Coluna(s)	FMOD (Conteúdo)
Task	Gera uma User Property chamada `task`
Event	Esta coluna será ignorada, porque o nome do evento é gerado a partir das colunas Type e Task
Type	Deve conter um dos seguintes valores: SFX, Music ou Soundscape. Produzem uma tag com o valor informado. Além disso, serve para agrupar os eventos em pastas no FMOD, seguindo essa lógica: 1. Existindo, o evento é incluído em uma pasta com base no valor da coluna (SFX, Soundscape ou Music) 2. Não existindo, evento será alocado na pasta principal (master events folder)
Type + Task	Combinadas, produzem o nome do evento. A estratégia de definição do nome é a seguinte: 1. Caracteres especiais são removidos 2. Letras com acentos são trocadas por letras sem acento 3. Qualquer quantidade de espaços é transformada em um underscore (`_`) (formato `snake_case`) 4. O evento é prefixado com o Type. Exemplo: um evento com o type "SFX" e a task "Capturar troféu" será nomeado `sfx_capturar_trofeu` e localizado na pasta `SFX`
Position	Sendo 3D, irá resultar na criação de um Spatializer
Other info/Questions	Será o campo Notes

Exportação

Para gerar a documentação dos eventos na forma de planilha a partir do projeto, basta acessar o menu Import/Export > Export as....
O funcionamento da exportação é o seguinte:

Coluna	FMOD
Task	User Property: `task`
Event	Segue o seguinte formato: `[path_do_evento]` `[guid]`
Type	Há duas possibilidades: 1 - se o evento for prefixado com `sfx_`, `mus_` ou `scp_`, será usado o rótulo correspondente (SFX, Music ou Soundscape); 2 - Caso contrário, a identificação será feita com base na existência de alguma das seguintes tags: `sfx`, `music` ou `soundscape`.
Position	Havendo um `Spatializer` no evento, será `3D`; caso contrário, `2D`
Effect Type	O valor depende da existência de uma das seguintes `tags`: `one-shot`, `loop` ou `cast`
Parameters	Existindo parâmetros em um evento, o texto será gerado com o seguinte formato: `[nome_do_parametro]` min: `[valor_min]` max: `[valor_max]` init: `[valor_inicial]`
Other info/Questions	São as anotações do evento (campo `Notes`)

Download

Para receber o script, baixa preencher o campo abaixo com seu e-mail.
Você deverá recebê-lo após alguns minutos, juntamente com as instruções para instalação.
Caso encontre problemas, basta enviar uma mensagem pelo Telegram!