컴플렉스 제작 방법 2021

DH 교육용 위키
이동: 둘러보기, 검색

§ 컴플렉스란?

  • 여러 개의 파빌리온을 함께 열람할 수 있도록 편성한 저작물을 말합니다.
  • 이곳에서는 Cesium 3D 지도상에 여러 곳의 파빌리온을 함꺼번에 표시하고, 선택적으로 개별 파빌리온을 방문할 수 있게 하는 시스템의 제작 방법을 설명합니다.

※ 가상 전시관 구성 체계

No 편성 단위 이름 Curation Level 저작도구 S/W
1 모노미디어 Mono-medium Objects ExtractPhotoMetaXml.bat / ExtractPhptoMetaKml.bat / Make 2D Video.bat / Make 3D Video.bat
2 Scene PTGui / MAKE PANO (MULTIRES) droplet.bat
3 파빌리온 Pavilion Make 3D Scene.bat
4 컴플렉스 Complex xml2cesium.exe Xml2cesium.png altitude.exe Altitude.png

§ Cesium 기반 컴플렉스 제작 도구

  • xml2cesium.exe
    • 최종 버전: v 1.0 (2021. 4. 30.)
    • 실행 Droplet: xml2cesium.exe
    • Xml2cesium.png
  • altitude.exe
    • 최종 버전: v1.0 (2021. 4. 30.)
    • 실행 Droplet: altitude.exe
    • Altitude.png

ftp://digerati.aks.ac.kr/2021/101/home/vr-tools 에서 다운로드받으실 수 있습니다. (FTP S/W로 접속하세요. FileZilla 등)

§ Cesium 기반 컴플렉스 제작 프로그램 사용 예시 사이트

  ※ 3D Scene Pavilion 만을 대상으로 제작한 컴플렉스 예시

  ※ 3D Scene Pavilion과 함께, Wiki Text, Network Graph, Photo Gallery, 3D Model 등 다양한 멀티미디어 요소들의 종합 메뉴 제공 예시

§ Cesium 기반 컴플렉스 스크립트 작성 방법

  • Cesium 기반 컴플렉스 스크립트는 Xml 문서 형식으로 작성합니다.

1. Xml 문서

  • Template:
<?xml version="1.0" encoding="UTF-8"?>
<?xml-stylesheet type="text/xsl" href="validation.xsl"?>

<complex>
	<home></home>
	<pavilion>
		<id></id>
		<label></label>
		<position>
			<latitude></latitude>
			<longitude></longitude>
			<altitude></altitude>
		</position>
		<reference>
			<icon></icon>
			<vr></vr>
			<textpage></textpage>
			<network></network>
			<gallery></gallery>
			<model></model>
		</reference>
	</pavilion>
</complex>
  • 예시 1:
<?xml version="1.0" encoding="UTF-8"?>
<?xml-stylesheet type="text/xsl" href="validation.xsl"?>

<complex>
	<home>http://digerati.aks.ac.kr/DhLab/2021/Pavilions/complex</home>
	<pavilion>
		<id>aks_central</id>
		<label>한국학중앙연구원 중앙</label>
		<position>
			<longitude>127.054242</longitude>
			<latitude>37.392349</latitude>
			<altitude>114.696</altitude>
		</position>
		<reference>
			<vr>http://digerati.aks.ac.kr/DhLab/2021/Pavilions/aks/aks_central/aks_central.htm</vr>
		</reference>
	</pavilion>
	<pavilion>
		<id>aks_west</id>
		<label>한국학중앙연구원 서편</label>
		<position>
			<longitude>127.051544 </longitude>
			<latitude>37.392732</latitude>
			<altitude>126.321</altitude>
		</position>
		<reference>
			<vr>http://digerati.aks.ac.kr/DhLab/2021/Pavilions/aks/aks_west/aks_west.htm</vr>
		</reference>
	</pavilion>
	<pavilion>
		<id>aks_east</id>
		<label>한국학중앙연구원 동편</label>
		<position>
			<longitude>127.054177</longitude>
			<latitude>37.393398</latitude>
			<altitude>125.713</altitude>
		</position>
		<reference>
			<vr>http://digerati.aks.ac.kr/DhLab/2021/Pavilions/aks/aks_east/aks_east.htm</vr>
		</reference>
	</pavilion>
	<pavilion>
		<id>motionVideo</id>
		<label>보미네</label>
		<position>
			<longitude>127.081632</longitude>
			<latitude>37.357351</latitude>
			<altitude>98.8601</altitude>
		</position>
		<reference>
			<vr>http://digerati.aks.ac.kr/DhLab/2021/Pavilions/motionVideo/video360.htm</vr>
		</reference>
	</pavilion>
</complex>
  • 예시 2:
<?xml version="1.0" encoding="UTF-8"?>
<?xml-stylesheet type="text/xsl" href="validation.xsl"?>

<complex>
	<home>http://digerati.aks.ac.kr/DhLab/2021/Pavilions/complex</home>
	<pavilion>
		<id>D00-0289-0000</id>
		<label>구 목포 일본영사관</label>
		<position>
			<longitude>126.382</longitude>
			<latitude>34.7875</latitude>
			<altitude>51.0</altitude>
		</position>
		<reference>
			<icon>http://www.cha.go.kr/unisearch/images/history_site/thumb/1627104.jpg</icon>
			<textpage>http://www.heritage.go.kr/heri/cul/culSelectDetail.do?ccbaCpno=1333602890000</textpage>
			<network>http://dh.aks.ac.kr/~sandbox/cgi-bin/Story02.py?db=mokpo&project=mokpo&key=목포일본영사관</network>
			<vr>http://dh.aks.ac.kr/~mokpo/pavilion/gallery/land/area/D00-0289-0000/museum.htm</vr>
			<gallery>http://dh.aks.ac.kr/~mokpo/wiki/index.php/Photo:Heritage:D00-0289-0000</gallery>
			<model>http://dh.aks.ac.kr/~mokpo/cgi-bin/ModelView2.py?url=dh.aks.ac.kr/~mokpo/model/D00-0289-0000.glb</model>
		</reference>
	</pavilion>
</complex>

2. 스크립트 작성 및 실행 프로세스

1. 템플릿 파일(xml)을 이용하여 자신의 파빌리온 정보를 담은 xml 문서를 작성합니다.

   ※ xml 문서의 이름이 곧 컴플렉스의 이름이 됩니다. ( 컴플렉스_이름.xml )
   ※ 컴플렉스 이름 안에 공백이 들어가거나 "." 문자를 사용해서는 안됩니다.

2. xml 문서를 xml2cesium.exeXml2cesium.png 프로그램에 떨어뜨리면 (Drag and Drop) 컴플렉스 뷰어 실행 문서가 (html 파일, 컴플렉스_이름.htm) 생성됩니다.

3. xml 문서와 html 문서를 웹 서버상의 자신의 파빌리온 컴플렉스 홈 폴더에 업로드 합니다. (FTP)

4. 웹 브라우저에서 웹 서버상의 html 문서를 실행합니다.

2. 스크립트 Xml 요소 설명

  • complex ....... 이 xml 문서의 최상위 요소.
  • complex/home ....... 지금 작성하는 컴플렉스 스크립트를 실행시킬 홈페이지 위치. 웹 서버상의 폴더 주소를 요소 값으로 지정합니다. (필수 요소)
  • complex/pavilion ....... 이 컴플렉스에 포함시킬 파빌리온의 갯수만큼 작성합니다. (1개 이상 필수 요소)
  • complex/pavilion/id ....... 각 파빌리온을 시스템이 식별할 수 있게 할 고유한 이름, 한 컴플렉스 안에서 중복 id가 있으면 안됩니다. (필수 요소)
  • complex/pavilion/label ....... 해당 파빌리온이 세슘 지도상에 표시될 보일 이름 (필수 요소)
  • complex/pavilion/pisition/longitude ....... 해당 파빌리온의 위치 .... 경도 값 (필수 요소)
  • complex/pavilion/pisition/latitude ....... 해당 파빌리온의 위치 .... 위도 값 (필수 요소)
  • complex/pavilion/pisition/altitude ....... 해당 파빌리온의 위치 .... 고도 값 (필수 요소)
  • complex/pavilion/reference/icon ........ 해당 파빌리온 마커를 클릭했을 때 정보 창 안에서 보여 줄 썸네일 이미지 (선택 요소)
  • complex/pavilion/reference/vr ........ 해당 파빌리온의 3D VR 씬 링크 주소 (선택 요소)
  • complex/pavilion/reference/text ........ 해당 파빌리온의 위키 텍스트 씬 링크 주소 (선택 요소)
  • complex/pavilion/reference/network ........ 해당 파빌리온의 네트워크 그래프 링크 주소 (선택 요소)
  • complex/pavilion/reference/gallery ........ 해당 파빌리온의 사진 갤러리 링크 주소 (선택 요소)
  • complex/pavilion/reference/model ........ 해당 파빌리온의 3D 모델 링크 주소 (선택 요소)

3. 고도 (altitude) 값 획득 방법

  • Cesium 3D 지도 상에서 컴플렉스를 구현하기 위해서는 각 파빌리온의 위치를 경도, 위도, 고도 값으로 표시해야 합니다.
  • 경도(longitude)와 위도(latitude) 값만 알고 고도(altitude) 값을 모르는 경우, altitude.exe 프로그램을 이용하여 여러 장소의 고도 값을 한꺼번에 얻을 수 있습니다.
  • altitude.exeAltitude.png 사용법

1. 위도와 경도 값을 차례대로 기록한 데이터 파일을 작성합니다. (확장자는 반드시 .lst)

  • 입력 파일 예시
#AKS
37.392349, 127.054242
37.392732, 127.051544
37.393398, 127.054177
#Home
37.357351, 127.081632

#으로 시작하는 행은 주석문입니다. (없어도 무방)

2. 이 파일을 altitude.exeAltitude.png 에 떨어뜨리면 고도 값을 포함하는 새 파일이 *_a.lst라는 이름으로 생성됩니다.

  • 출력 파일 예시
#AKS
37.392349, 127.054242, 114.6968688964844
37.392732, 127.051544, 126.3219146728516
37.393398, 127.054177, 125.7135009765625
#Home
37.357351, 127.081632, 98.86018371582031

§ 저작권 사용 허가

이곳에서 소개하는 파빌리온 제작 도구는 누구나 교육/연구의 목적으로 자유롭게 사용할 수 있습니다. 이 프로그램을 이용하여 제작한 디지털 콘텐츠를 발행, 배포하거나 이에 관한 2차적 교육 자료, 연구물을 제작할 경우, 이 도구의 사용 허가 사항을 다음과 같이 표시하여 주시기 바랍니다.

"이 저작물상의 가상 전시관 프로그램은 DH 디지털 큐레이션 저작도구 (Copyright (C) 2017-2021 디지털인문학연구소, AKS)를 이용하여 제작하였습니다."
“Virtual Reality Programs in this work were created using DH Digital Curation Tools (Copyright (C) 2017-2018 Center for Digital Humanities, AKS).”