ChordPro

ChordPro 파일 형식은 다른 소프트웨어 애플리케이션에서 사용되는 일반적인 형식입니다. OnSong은 이 형식을 기본적으로 이해합니다. OnSong은 다음 파일 확장자를 가진 파일을 인식합니다: .chordpro, .chopro, .cho, .crd, .pro

ChordPro 형식을 사용하면 곡 정보를 중괄호로 구분된 태그로 표현할 수 있습니다. 이 정보는 논리적으로 메타데이터 태그와 인라인 태그로 나눌 수 있습니다.

메타데이터 태그

이것들은 곡의 메타데이터 부분에서 사용할 ChordPro 태그입니다. 다음 태그에서 세 개의 점(...)은 사용자가 제공하는 텍스트를 나타내며, 이는 콜론과 닫는 중괄호 사이에 들어갑니다. 예를 들어:

{title: Amazing Grace}
{key: G}

OnSong은 다음 ChordPro 태그를 지원합니다:

• {title: ...} 또는 {t: ...} 곡의 제목입니다.
• {subtitle: ...}, {st: ...} 또는 {su: ...} 아티스트 이름 또는 기타 부제 정보입니다. 세미콜론으로 이름을 구분하여 여러 아티스트를 지정할 수 있습니다. - Kim Walker-Smith; Chris Quilala
• {album: ...} 곡이 위치한 앨범의 이름입니다.
• {artist: ...} 또는 {a: ...} 아티스트 이름 또는 기타 부제 정보입니다. 세미콜론으로 이름을 구분하여 여러 아티스트를 지정할 수 있습니다. - Kim Walker-Smith; Chris Quilala
• {author: ...} 코드 차트를 만든 사람의 이름입니다. 이는 코드 차트의 하단과 가사 프로젝션에 표시됩니다.
• {key: ...} 또는 {k: ...} 또는 {ok: ...} 음정 선호도와 단조를 나타내는 선택적 "m"을 포함한 키로 작성된 곡의 키입니다. - 알파벳순, 예: Bb 또는 Em
• {capo: ...} 프렛 수로 설정할 카포입니다 - 숫자
• {tempo: ...} 분당 비트(BPM) - 숫자
• {time: ...} 박자표 - 박자 분할 숫자, 예: 3/4
• {duration: ...} 자동 스크롤을 위한 곡 길이입니다 - 초 또는 mm:ss
• {book: ...} 곡을 배치할 책 또는 책의 이름입니다. 이것은 곡이 배치될 책 이름의 쉼표로 구분된 목록입니다. 책이 없으면 자동으로 생성됩니다.
• {number: ...} 곡의 번호입니다 - 숫자, 찬송가, 연도 등에 사용합니다. 참고용으로 번호별로 곡을 정렬할 수 있습니다.
• {flow: ...} 섹션의 배열 - 섹션 레이블 목록입니다. 곡의 흐름을 배열하는 방법에 대한 자세한 내용은 흐름을 참조하세요.
• {midi: ...} 곡을 볼 때 전송할 MIDI 명령입니다. OnSong에서 MIDI 명령을 텍스트로 표현하는 방법에 대해서는 MIDI 구문을 참조하세요.
• {midi-index: ...} 곡 뷰어에서 이 곡을 열도록 트리거할 MIDI 명령입니다. OnSong에서 MIDI 명령을 텍스트로 표현하는 방법에 대해서는 MIDI 구문을 참조하세요.
• {pitch: ...} 피치 파이프 기능을 사용할 때 재생할 음입니다.
• {keywords: ...} 또는 {topic: ...} 주제 검색에 사용할 태그 목록입니다. 주제별 탐색에 대한 자세한 내용은 주제를 참조하세요.
• {copyright: ...} 또는 {footer: ...} 페이지의 하단 또는 가사 프로젝션에 나타날 저작권 바닥글 텍스트를 지정합니다.
• {ccli: ...} 곡의 CCLI 번호입니다.
• {restrictions: ...} 곡의 쉼표로 구분된 제한 사항 목록에 대한 권리 관리입니다. 곡의 제한 설정에 대한 자세한 내용은 제한 사항을 참조하세요.

인라인 태그

이 태그들은 곡의 콘텐츠 내에서 사용되며 섹션을 정의하거나 곡의 일부를 형식화하는 데 사용할 수 있습니다.

• {define: ...} 사용자 정의 코드 다이어그램을 정의하는 데 사용됩니다. 자세한 내용은 코드 정의를 참조하세요.
• {comment: ...} 또는 {c: ...} 주석을 정의하며 음악 지시로 표시됩니다.
• {comment_bold: ...} 또는 {cb: ...} 굵게 표시할 텍스트를 정의합니다.
• {comment_italic: ...} 또는 {ci: ...} 기울임꼴로 표시할 텍스트를 정의합니다.
• {guitar_comment: ...} 또는 {gc: ...} 음악 지시로 표시되는 주석을 정의합니다.
• {start_of_verse: ..} 또는 {sov} 선택적 섹션 레이블을 포함한 절 섹션의 시작을 선언합니다.
• {end_of_verse} 또는 {eov} 절 섹션의 끝을 선언합니다.
• {start_of_chorus: ...} 또는 {soc} 선택적 섹션 레이블을 포함한 합창 섹션의 시작을 선언합니다.
• {end_of_chorus} 또는 {eoc} 합창 섹션의 끝을 선언합니다.
• {start_of_bridge: ...} 또는 {sob} 선택적 섹션 레이블을 포함한 브릿지 섹션의 시작을 선언합니다.
• {end_of_bridge} 또는 {eob} 브릿지 섹션의 끝을 선언합니다.
• {start_of_part: ..} 또는 {sop} 선택적 섹션 레이블을 포함한 파트의 시작을 선언합니다.
• {end_of_part} 또는 {eop} 파트의 끝을 선언합니다.
• {start_of_tab} 또는 {sot} OnSong이 고정폭 글꼴로 렌더링하는 태뷸러처의 시작을 선언합니다.
• {end_of_tab} 또는 {eot} 태뷸러처 섹션의 끝을 선언합니다.
• {new_page} 또는 {np} 새 페이지를 선언하는 데 사용됩니다.
• {new_physical_page} 또는 {npp} 새 페이지를 선언하는 데 사용됩니다.

형식 태그

다음 태그는 코드 차트의 가사 및 코드에 대한 기본 글꼴 및 크기를 정의하는 데 사용됩니다.

• {textsize: ...} 포인트 단위의 숫자 값으로 가사의 크기를 정의합니다.
• {textfont: ...} 가사에 사용할 글꼴의 이름을 정의합니다. 플랫폼에서 지원되어야 합니다.
• {chordsize: ...} 포인트 단위의 숫자 값으로 코드의 크기를 정의합니다.
• {chordfont: ...} 코드에 사용할 글꼴의 이름을 정의합니다. 플랫폼에서 지원되어야 합니다.

지원되는 파일 확장자

ChordPro 파일 형식은 일반적으로 합의된 구문이지만 표준 형식이 아니라는 점에서 고유합니다. 이는 다양한 공급업체가 다양한 방식으로 그리고 다양한 파일 확장자로 이를 구현할 수 있음을 의미합니다. OnSong은 ChordPro 형식의 파일을 가져올 때 다음 파일 확장자를 지원합니다:

• .chopro
• .cho
• .chordpro
• .crd
• .pro
• .cpm