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: ...} 섹션의 배열입니다. - 섹션 레이블 목록입니다. 곡의 흐름 배열에 대한 자세한 내용은 Flow를 참조하세요.
• {midi: ...} 곡을 볼 때 전송할 MIDI 명령입니다. OnSong에서 MIDI 명령을 텍스트로 표현하는 방법은 MIDI 구문을 참조하세요.
• {midi-index: ...} 이 곡을 곡 뷰어에서 열도록 트리거할 MIDI 명령입니다. OnSong에서 MIDI 명령을 텍스트로 표현하는 방법은 MIDI 구문을 참조하세요.
• {pitch: ...} 피치 파이프 기능을 사용할 때 재생할 음입니다.
• {keywords: ...} 또는 {topic: ...} 주제 검색에 사용할 태그의 목록입니다. 주제별 탐색에 대한 자세한 내용은 주제를 참조하세요.
• {copyright: ...} 또는 {footer: ...} 또는 {f: ...} 페이지 또는 가사 프로젝션의 하단에 나타날 저작권 바닥글 텍스트를 지정합니다.
• {ccli: ...} 곡의 CCLI 번호입니다.
• {restrictions: ...} 곡의 권리 관리를 위한 쉼표로 구분된 제한 사항 목록입니다. 곡의 제한 사항 설정에 대한 자세한 내용은 제한 사항을 참조하세요.
• {composer: ...} 곡의 음악을 작곡한 개인입니다. 이 목록은 별도의 값에 대해 세미콜론으로 구분되어야 합니다.
• {lyricist: ...} 곡의 가사를 작성한 개인입니다. 이 목록은 별도의 값에 대해 세미콜론으로 구분되어야 합니다.

인라인 태그

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

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