# Trabalhando com arquivos MusicXML

## Overview

**MusicXML** is a universal file format that allows music scores to be shared between different music notation programs. For example, you can convert a MuseScore .mscz file to a MusicXML file and it will open in **Sibelius**, **Finale**, or any other compatible scorewriter; and vice versa.

MusicXML faithfully reproduces the notes and instrumentation, but, nevertheless, it is usually necessary to do some clean-up work to make the transferred score look exactly the same as the original.

## Opening a MusicXML file

Quando um arquivo MusicXML é aberto pela primeira vez no MuseScore, as posições e propriedades personalizadas dos objetos de texto são preservadas tanto quanto possível. Também podem existir outras personalizações visíveis na partitura que você pode querer manter ou não.

## MusicXML import options

Essas opções podem ser encontradas em **Editar→Preferências→Importar**.

* **Importar layout** importará configurações de layout como tamanho da página, margens e tamanho da pauta, se estiverem no arquivo MusicXML\
  Caso contrário, serão aplicadas as configurações padrão. Ativado por padrão.
* **Importar quebras de sistema e página** faz exatamente o que indica, mas observe que ainda pode acontecer de o layout exato de sistemas e páginas não ser o mesmo inicialmente, pois diferenças nas configurações de espaçamento e fontes (etc.) podem impedir que o mesmo número de compassos caiba em um sistema como no software que gerou o MusicXML. Ativado por padrão.
* **Aplicar fonte padrão (Edwin) às partituras importadas** definirá todos os estilos de texto para Edwin (padrão do MuseScore Studio). Isso está desativado por padrão, o que significa que as fontes especificadas no arquivo MusicXML serão usadas. (Caso não estejam disponíveis no sistema, será usada uma fonte alternativa.)
* **Inferir tipo de texto com base no conteúdo quando possível** fará o possível para determinar inteligentemente o tipo de texto a partir de seu conteúdo. Em muitos arquivos MusicXML, textos de diversos tipos (tempos, digitações, linhas de direitos autorais etc.) são codificados como "texto de pauta" simples. Com esta opção ativada, ele tentará atribuir os itens aos tipos corretos de texto. Também tenta limpar, por exemplo, símbolos musicais dentro do texto usando codificações legadas. Embora não seja perfeito, costuma economizar muito tempo de limpeza manual. Desativado por padrão, pois tecnicamente implica desviar da aderência estrita à especificação MusicXML.

## Cleaning up an imported score

### Restoring stems

Para redefinir as hastes de todas as notas para suas posições e orientações padrão:

1. Clique com o botão direito em uma nota e escolha **Selecionar→Similar**
2. Pressione `Ctrl`+`R`.

### Restoring default leading spaces

Para redefinir o espaço de avanço de todas as notas para o padrão da partitura:

1. Clique com o botão direito em uma nota e escolha **Selecionar→Similar**
2. Clique no botão **Aparência** no painel **Propriedades**
3. Se o botão de redefinição de **Espaço de avanço** (seta circular) estiver ativo, clique nele para redefinir ao padrão da partitura; caso contrário, nenhuma ação adicional é necessária.

### Removing breaks

Para remover todas as quebras — de sistema, página e seção:\
1\. Clique com o botão direito em uma quebra e escolha **Selecionar→Similar**\
2\. Pressione **Delete**.

Para remover apenas quebras de sistema (mantendo as quebras de seção e página):

1. No menu principal, selecione **Formato→Adicionar/Remover quebras de sistema**.
2. Selecione **Remover quebras de sistema atuais**
3. Click `OK` to close the dialog.

### Restoring default text styles

Para redefinir todos os objetos de texto na partitura e nos quadros para seus estilos padrão:

1. No menu principal, escolha **Formato→Estilo**
2. Clique no botão marcado **Redefinir todos os estilos para o padrão**
3. Click `OK` to close the dialog.

Veja **Formato→Estilo→Estilos de texto** para visualizar a lista de estilos e os valores das propriedades.

### Resetting default text positions

#### Frame

Para redefinir as posições de todos os objetos de texto nos quadros:

1. Clique com o botão direito em um objeto de texto dentro de um quadro
2. Escolha **Selecionar→Similar**
3. Pressione `Ctrl`+`R`.

#### Score text

Você pode aplicar o mesmo método para objetos de texto na partitura, como para os quadros. Entretanto, será necessário repetir isso para cada classe individual de objeto — todos os textos de andamento, todos os textos de pauta etc.

## Preparing a score for export

Para exportar uma partitura como arquivo MusicXML, veja [Exportação de arquivos](/pt_br/file-management/file-export.md).

### Export settings

Ao exportar uma partitura para MusicXML, você pode escolher entre um formato compactado (opção padrão) ou descompactado; além de decidir exportar todas as quebras ou não, ou permitir que apenas quebras adicionadas manualmente apareçam no arquivo.

\[A ser adicionado: 1. armadilhas — ajustes manuais, uso incorreto de tipos de elemento, imagens, ... 2. configurações de exportação]

* armadilhas - ajustes manuais, uso incorreto de tipos de elementos, imagens, ...
* configurações de exportação]


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://handbook.musescore.org/pt_br/file-management/working-with-musicxml-files.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
