GeOnDT for JS API

Class: U3dImageWMSLayer

U3dImageWMSLayer

~extends U3dImageLayer
OGC WMS를 이용한 이미지 레이어 클래스입니다.
타일 영역별로 이미지를 요청해 지도에 표출합니다.

[용어]
WMS(웹 맵 서비스)는 맵 서버에서 생성된 지도 이미지를 웹상에서 제공하기 위한 표준 프로토콜입니다.

new U3dImageWMSLayer(opt)

WMS 요청 옵션과 이미지 레이어의 공통 상태를 초기화합니다. baseUrl이 없으면 기반 생성 이후 안내를 출력하고 WMS 설정을 중단합니다. URL·파라미터 값은 직접 인코딩하거나 보정하지 않습니다.

Name	Type	Default	Description
`opt`	U3dImageWMSLayerCO	{}	optional 생성자 옵션

Example

const layer = new U3dImageWMSLayer({
     name: 'osm_wms',
     baseUrl: '/service/wms',
     layerName: 'OSM-Overlay-WMS',
     ext: 'image/png',
     reverseY: false,
     minLevel: 14
  });

Members

OPT_KEYS

Methods

createTexture(tile)Promise.<U3dQuadTile>|undefined

입력 받은 타일에 WMS 이미지 텍스처를 적용합니다. EPSG:3857과 기반 레이어의 생성 조건을 통과할 때 공통 이미지 처리를 시작합니다. 완료 시 캐시 메시의 단일 또는 첫 머터리얼에 현재 블렌딩 설정을 반영합니다. 곱셈 블렌딩은 premultipliedAlpha를 활성화하고, 다른 모드에서는 그 값을 재설정하지 않습니다. 반환 객체와 완료·오류·취소 시점은 기반 이미지 처리에서 결정합니다.

Name	Type	Description
`tile`	U3dQuadTile	텍스처를 적용할 타일

Returns:

Type	Description
Promise.<U3dQuadTile> \| undefined	타일 작업의 완료 객체. 요청을 시작하지 않으면 undefined

createUrl(tile)string|undefined

입력 받은 타일에 대응하는 WMS GetMap 요청 URL을 생성합니다.
타일의 영역(BBOX), 레벨, CRS, 스타일, CQL 필터 등을 조합하여 URL을 만들며, 타일 레벨이 minlevel/maxlevel 범위를 벗어나면 undefined 를 반환합니다.

Name	Type	Description
`tile`	U3dQuadTile	WMS 요청을 생성할 타일

Returns:

Type	Description
string \| undefined	WMS 요청 URL. 생성 불가 시 `undefined` 를 반환합니다.

setParams(params)

입력 받은 파라미터 값으로 WMS 레이어 속성을 갱신합니다.
cqlFilter, styles, transparent, key, useproxy, proxyurl, appendQuery 중 지정된 항목만 변경됩니다. 빈 문자열로 값을 지울 수 없으며, boolean false는 반영합니다. 생성자와 달리 키를 정규화하지 않고, 이 호출만으로 이미지를 재요청하지 않습니다. params가 없으면 오류 안내 후 속성 접근에서 예외가 발생합니다.

Name	Type	Description
`params`	U3dImageWMSLayerSetParamsOption	변경할 파라미터 객체

Type Definitions

U3dImageWMSLayerCOobject

~extends U3dImageLayer~U3dImageLayerCO
WMS 요청과 이미지 표현에 사용하는 생성자 옵션입니다.

Properties:

Name	Type	Argument	Default	Description
`baseUrl`	string	<optional>		WMS 서비스 요청 URL. 선택 타입이지만 생략하면 WMS 설정은 초기화되지 않음
`layerName`	string	<optional>		WMS 서비스 레이어 이름
`ext`	string	<optional>	'png'	WMS 이미지 OutputFormat `png` \| `jpeg`
`reverseX`	boolean	<optional>	false	X축 반전 여부
`reverseY`	boolean	<optional>	false	Y축 반전 여부
`crs`	string	<optional>	'EPSG:3857'	WMS 요청 좌표계
`version`	string	<optional>	'1.3.0'	WMS 버전
`width`	number	<optional>	256	요청 이미지 너비 (pixel)
`height`	number	<optional>	256	요청 이미지 높이 (pixel)
`minLevel`	number	<optional>	0	레이어 가시화 최소 레벨
`maxLevel`	number	<optional>	19	레이어 가시화 최대 레벨
`cqlFilter`	string	<optional>		CQL FILTER 문자열. (해당 필터 문자열에 따라 wms 데이터를 가져올 때 필터 조건을 적용)
`key`	string	<optional>		인증 키. 값이 있으면 현재 URL 조립에서 STYLES 항목을 KEY 항목으로 대체
`styles`	string	<optional>		스타일 이름 문자열. 인증 키와 함께 보내는 경우의 처리는 key 설명 참조
`useProxy`	boolean	<optional>		프록시 사용 여부
`proxyUrl`	string	<optional>		프록시 url 문자열
`appendQuery`	string	<optional>		url 쿼리 추가 문자열
`renderOrder`	number	<optional>		랜더링 우선 순위
`opacity`	number	<optional>	1	이미지 리소스 투명도
`blendingType`	string	<optional>	'normal'	블렌딩 선택 키: noblending, normal, additive, subtractive, multiply

U3dImageWMSLayerSetParamsOptionobject

WMS 요청 속성 중 변경할 값만 전달하는 옵션입니다. 빈 문자열·null·undefined는 기존 값을 유지하고, boolean false는 반영합니다. useproxy와 proxyurl은 생성자 옵션과 달리 소문자 키를 사용합니다.

Properties:

Name	Type	Argument	Description
`cqlFilter`	string	<optional>	CQL FILTER 문자열
`styles`	string	<optional>	스타일 이름 문자열
`transparent`	boolean	<optional>	transparent(투명) 적용 여부
`key`	string	<optional>	key 문자열
`useproxy`	boolean	<optional>	프록시 사용 여부
`proxyurl`	string	<optional>	프록시 url 문자열
`appendQuery`	string	<optional>	url 쿼리 추가 문자열