GeOnDT GeOnDT for JS

Class: U3dImageXYZLayer

U3dImageXYZLayer

~extends U3dImageLayer
XYZ/TMS URL의 타일 이미지를 표시하는 레이어입니다. baseUrl의 {x}, {y}, {z}는 타일 인덱스이며 {-x}, {-y}는 반전 인덱스입니다. {a-c} 또는 {1-3} 같은 서버 범위를 지정하면 초기화 시 요청 후보를 만들고 순환 사용합니다. 한 URL에서는 첫 소문자 범위를 우선하고, 없으면 첫 숫자 범위만 확장합니다. 범위의 시작이 끝보다 크면 요청 후보가 비며 이후 createUrl 호출에서 예외가 발생합니다. reverseX·reverseY 옵션은 현재 URL 치환에 사용하지 않으므로 반전은 토큰으로 지정하십시오.

new U3dImageXYZLayer(opt)

U3dImageXYZLayer 생성자입니다.

Name Type Description
opt U3dImageXYZLayerCO

생성자 옵션

Members

OPT_KEYS

Methods

createMeshFromTile(tile)

Name Type Description
tile U3dQuadTile

이미지 URL을 생성할 타일

createTexture(tile)Promise.<U3dQuadTile>|undefined

입력 받은 타일에 XYZ(TMS) 이미지 텍스처를 변경하는 함수입니다.
레이어 BoundingBox 와 타일이 교차하지 않으면 작업을 건너뜁니다.

Name Type Description
tile U3dQuadTile

이미지를 변경할 타일
Returns:
Type Description
Promise.<U3dQuadTile> | undefined 작업 완료 시 resolve 되는 deferred.

createUrl(tile, drawArg)string

다음 URL 템플릿을 선택하여 타일 인덱스가 반영된 이미지 요청 URL을 반환합니다. 호출할 때마다 URL 선택 위치가 순환하며 reverseX·reverseY 대신 템플릿의 토큰을 사용합니다. 초기화 전이거나 확장된 URL 목록이 비어 있으면 토큰 치환 중 예외가 발생합니다.

Name Type Description
tile U3dQuadTile

이미지 URL을 생성할 타일
drawArg UDrawArg

호출 형식 유지용 실행 인수. 현재 구현에서는 미사용
Returns:
Type Description
string 선택한 템플릿의 좌표 토큰을 치환한 이미지 URL

getBoundingBox()Box3|undefined

레이어의 경계 영역(BoundingBox)을 반환합니다.

Returns:
Type Description
Box3 | undefined 레이어 경계 영역(BoundingBox)

async readXml()Promise.<void>

추가적인 xml 데이터를 읽어 레이어 속성에 적용하는 함수입니다.
xml 파일에서 좌표계(SRS/PROJ), 타일 포맷, 타일 크기, BoundingBox 등의 정보를 읽어옵니다.

Returns:
Type Description
Promise.<void> xml 로드/적용 완료 시 resolve 되는 promise

show(show)void

레이어의 가시화(show/hide) 여부를 설정하는 함수입니다.

Name Type Description
show boolean

가시화(show/hide) 여부. true면 가시화합니다.
Returns:
Type Description
void

Type Definitions

U3dImageXYZLayerCOobject

~extends U3dImageLayer~U3dImageLayerCO
생성자 옵션

Properties:
Name Type Argument Default Description
reverseX boolean <optional>
 false

X축 반전 여부
reverseY boolean <optional>
 false

Y축 반전 여부
needXml boolean <optional>
 false

추가적인 xml 파일을 사용할 지 여부.(xml 파일에서 proj나 타일 포멧, 바운딩박스 정보 등을 읽는다.)
xmlUrl string <optional>

추가적인 xml 파일을 사용할 지 여부가 true 일때, xml를 다운로드할 url, needXml이 true일때만 작동