"컴플렉스 제작 방법 2021"의 두 판 사이의 차이

DH 교육용 위키
이동: 둘러보기, 검색
 
(같은 사용자에 의한 20개의 중간 편집이 숨겨짐)
17번째 줄: 17번째 줄:
 
| 1 || 모노미디어 || Mono-medium Objects || ExtractPhotoMetaXml.bat / ExtractPhptoMetaKml.bat / Make 2D Video.bat /  Make 3D Video.bat  
 
| 1 || 모노미디어 || Mono-medium Objects || ExtractPhotoMetaXml.bat / ExtractPhptoMetaKml.bat / Make 2D Video.bat /  Make 3D Video.bat  
 
|-
 
|-
| 2 || || Scene || PTGui / MAKE PANO (MULTIRES) droplet.bat
+
| 2 || || Scene || PTGui / MAKE PANO (MULTIRES) droplet.bat
 
|-
 
|-
 
| 3 || 파빌리온 || Pavilion || Make 3D Scene.bat
 
| 3 || 파빌리온 || Pavilion || Make 3D Scene.bat
 
|-
 
|-
| 4 || 컴플렉스 || Complex || xml2cesium.exe / altitude.exe
+
| 4 || 컴플렉스 || Complex || xml2cesium.exe [[파일:xml2cesium.png|60px]]  altitude.exe [[파일:altitude.png|60px]]
 
|}
 
|}
  
 
==§ Cesium 기반 컴플렉스 제작 도구==
 
==§ Cesium 기반 컴플렉스 제작 도구==
  
* xml2cesium.exe
+
* '''xml2cesium.exe'''
** 최종 버전: v 1.0
+
** 최종 버전: v 1.0 (2021. 4. 30.)
** 실행 Droplet: xml2cesium.exe  
+
** 실행 Droplet: '''xml2cesium.exe'''
 +
** [[파일:xml2cesium.png|90px]]
  
* altitude.exe
+
* '''altitude.exe'''
** 최종 버전: v1.0
+
** 최종 버전: v1.0 (2021. 4. 30.)
** 실행 Droplet: altitude.exe
+
** 실행 Droplet: '''altitude.exe'''
 +
** [[파일:altitude.png|90px]]
  
※ ftp://digerati.aks.ac.kr/2021/101/home/vr-tools 에서 다운로드받으실 수 있습니다.
+
※ ftp://digerati.aks.ac.kr/2021/101/home/vr-tools 에서 다운로드받으실 수 있습니다. (FTP S/W로 접속하세요.  FileZilla 등)
  
 
==§ Cesium 기반 컴플렉스 제작 프로그램 사용 예시 사이트==
 
==§ Cesium 기반 컴플렉스 제작 프로그램 사용 예시 사이트==
  
* http:///digerati.aks.ac.kr/2021/Pavilions/complex/MyPlaces.htm
+
* 예시 1:  [http://digerati.aks.ac.kr/Dhlab/2021/Pavilions/complex/myPlaces.htm http://digerati.aks.ac.kr/Dhlab/2021/Pavilions/complex/MyPlaces.htm]
** 3D Scene Pavilion 만을 대상으로 제작한 컴플렉스 예시
+
  ※ 3D Scene Pavilion 만을 대상으로 제작한 컴플렉스 예시
 
+
* http:///digerati.aks.ac.kr/2021/Pavilions/complex/mokpo.htm
+
** 3D Scene Pavilion과 함께, Wiki Text, Network Graph, Photo Gallery, 3D Model 등 다양한 멀티미디어 요소들의 종합 메뉴 제공 예시
+
  
 +
* 예시 2:  [http://digerati.aks.ac.kr/Dhlab/2021/Pavilions/complex/mokpo.htm http://digerati.aks.ac.kr/Dhlab/2021/Pavilions/complex/mokpo.htm]
 +
  ※ 3D Scene Pavilion과 함께, Wiki Text, Network Graph, Photo Gallery, 3D Model 등 다양한 멀티미디어 요소들의 종합 메뉴 제공 예시
  
 
==§ Cesium 기반 컴플렉스 스크립트 작성 방법==
 
==§ Cesium 기반 컴플렉스 스크립트 작성 방법==
69번째 줄: 70번째 줄:
 
<icon></icon>
 
<icon></icon>
 
<vr></vr>
 
<vr></vr>
<text></text>
+
<textpage></textpage>
 
<network></network>
 
<network></network>
 
<gallery></gallery>
 
<gallery></gallery>
153번째 줄: 154번째 줄:
 
<reference>
 
<reference>
 
<icon>http://www.cha.go.kr/unisearch/images/history_site/thumb/1627104.jpg</icon>
 
<icon>http://www.cha.go.kr/unisearch/images/history_site/thumb/1627104.jpg</icon>
<text>http://www.heritage.go.kr/heri/cul/culSelectDetail.do?ccbaCpno=1333602890000</text>
+
<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&amp;project=mokpo&amp;key=목포일본영사관</network>
 
<network>http://dh.aks.ac.kr/~sandbox/cgi-bin/Story02.py?db=mokpo&amp;project=mokpo&amp;key=목포일본영사관</network>
 
<vr>http://dh.aks.ac.kr/~mokpo/pavilion/gallery/land/area/D00-0289-0000/museum.htm</vr>
 
<vr>http://dh.aks.ac.kr/~mokpo/pavilion/gallery/land/area/D00-0289-0000/museum.htm</vr>
162번째 줄: 163번째 줄:
 
</complex>
 
</complex>
 
</pre>
 
</pre>
 +
 +
===2. 스크립트 작성 및 실행 프로세스 ===
 +
 +
1. '''템플릿 파일(xml)'''을 이용하여 자신의 파빌리온 정보를 담은 xml 문서를 작성합니다. <br/>
 +
 +
&nbsp;&nbsp;&nbsp;※ xml 문서의 이름이 곧 컴플렉스의 이름이 됩니다. ( '''컴플렉스_이름.xml''' ) <br/>
 +
&nbsp;&nbsp;&nbsp;※ 컴플렉스 이름 안에 공백이 들어가거나 '''"."''' 문자를 사용해서는 안됩니다.
 +
 +
2. xml 문서를 '''xml2cesium.exe'''[[파일:xml2cesium.png|60px]] 프로그램에 떨어뜨리면 (Drag and Drop) 컴플렉스 뷰어 실행 문서가 (html 파일, '''컴플렉스_이름.htm''') 생성됩니다.
 +
 +
3. xml 문서와 html 문서를 웹 서버상의 자신의 파빌리온 컴플렉스 홈 폴더에 업로드 합니다. (FTP)
 +
 +
4. 웹 브라우저에서 웹 서버상의 html 문서를 실행합니다.
  
 
===2. 스크립트 Xml 요소 설명 ===  
 
===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.exe'''[[파일:altitude.png|60px]] 사용법
 +
1. 위도와 경도 값을 차례대로 기록한 데이터 파일을 작성합니다. (확장자는 반드시 '''.lst''')
 +
* 입력 파일 예시
 +
<pre>
 +
#AKS
 +
37.392349, 127.054242
 +
37.392732, 127.051544
 +
37.393398, 127.054177
 +
#Home
 +
37.357351, 127.081632
 +
</pre>
 +
※ '''#'''으로 시작하는 행은 주석문입니다. (없어도 무방)
 +
 +
2. 이 파일을 '''altitude.exe'''[[파일:altitude.png|60px]] 에 떨어뜨리면 고도 값을 포함하는 새 파일이 '''*_a.lst'''라는 이름으로 생성됩니다.
 +
* 출력 파일 예시
 +
<pre>
 +
#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
 +
</pre>
  
 
==§ 저작권 사용 허가==
 
==§ 저작권 사용 허가==
  
이곳에서 소개하는 '''파빌리온 제작 도구'''는 누구나 교육/연구의 목적으로 자유롭게 사용할 수 있습니다.  이 프로그램을 이용하여 제작한 디지털 콘텐츠를 발행, 배포하거나 이에 관한 2차적 교육 자료, 연구물을 제작할 경우, 이 도구의 사용 허가 사항을 다음과 같이 표시하여 주시면 감사하겠습니다.  
+
이곳에서 소개하는 '''파빌리온 제작 도구'''는 누구나 교육/연구의 목적으로 자유롭게 사용할 수 있습니다.  이 프로그램을 이용하여 제작한 디지털 콘텐츠를 발행, 배포하거나 이에 관한 2차적 교육 자료, 연구물을 제작할 경우, 이 도구의 사용 허가 사항을 다음과 같이 표시하여 주시기 바랍니다.
  
 
{|class="wikitable"
 
{|class="wikitable"

2021년 5월 5일 (수) 21:48 기준 최신판

§ 컴플렉스란?

  • 여러 개의 파빌리온을 함께 열람할 수 있도록 편성한 저작물을 말합니다.
  • 이곳에서는 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).”