TextOptions interface

패키지:

azure-maps-control

SymbolLayer에서 텍스트를 사용자 지정하는 데 사용되는 옵션

Extends

Options

속성

allowOverlap	텍스트가 다른 기호와 충돌하는 경우 텍스트가 표시되는지 지정합니다. true이면 이전에 그린 다른 기호와 충돌하더라도 텍스트가 표시됩니다. 기본값은 false입니다.
anchor	아이콘이 지도의 아이콘 앵커 위치에 가장 가깝게 배치되는 부분을 지정합니다. '"center"': 아이콘의 중심이 앵커에 가장 가깝게 배치됩니다. '"left"': 아이콘의 왼쪽은 앵커에 가장 가깝게 배치됩니다. '"오른쪽"': 아이콘의 오른쪽은 앵커에 가장 가깝게 배치됩니다. '"top"': 아이콘의 위쪽이 앵커에 가장 가깝게 배치됩니다. '"bottom"': 아이콘의 아래쪽이 앵커에 가장 가깝게 배치됩니다. '"왼쪽 위"': 아이콘의 왼쪽 위 모서리가 앵커에 가장 가깝게 배치됩니다. '"오른쪽 위"': 아이콘의 오른쪽 위 모서리가 앵커에 가장 가깝게 배치됩니다. '"왼쪽 아래"': 아이콘의 왼쪽 아래 모서리가 앵커에 가장 가깝게 배치됩니다. '"오른쪽 아래"': 아이콘의 오른쪽 아래 모서리가 앵커에 가장 가깝게 배치됩니다. 기본값 '"center"'.
color	텍스트의 색입니다. 기본값은 "#000000"입니다.
font	텍스트를 표시하는 데 사용할 글꼴 스택입니다. 가능한 값: "SegoeFrutigerHelveticaMYingHei-Bold", "SegoeFrutigerHelveticaMYingHei-Medium", "SegoeFrutigerHelveticaMYingHei-Regular", "SegoeUi-Bold", "SegoeUi-Light", , "SegoeUi-SemiBold""SegoeUi-Regular", "SegoeUi-SemiLight", "SegoeUi-SymbolRegular""StandardCondensedSegoeUi-Black", "StandardCondensedSegoeUi-Bold", "StandardCondensedSegoeUi-Light", "StandardCondensedSegoeUi-Regular", "StandardFont-Black", "StandardFont-Bold", "StandardFont-Light", "StandardFont-Regular""StandardFontCondensed-Black", "StandardFontCondensed-Bold", , . "StandardFontCondensed-Regular""StandardFontCondensed-Light" 기본값은 ["StandardFont-Regular"]입니다.
haloBlur	바깥쪽을 향한 후광의 페이드아웃 거리(픽셀)입니다. 0보다 크거나 같은 숫자여야 합니다. 기본값은 0입니다.
haloColor	배경에서 눈에 띄는 데 도움이 되는 텍스트 후광의 색입니다. 기본값은 "rgba(0,0,0,0)"입니다.
haloWidth	후광에서 글꼴 윤곽선까지의 거리(픽셀)입니다. 0보다 크거나 같은 숫자여야 합니다. 최대 텍스트 후광 너비는 글꼴 크기의 1/4입니다. 기본값은 0입니다.
ignorePlacement	다른 기호가 텍스트와 충돌할 수 있는지를 지정합니다. true이면 다른 기호가 텍스트와 충돌하더라도 표시될 수 있습니다. 기본값은 false입니다.
justify	텍스트 근거 옵션입니다. '"auto"': 텍스트가 앵커 위치에 맞춰집니다. '"left"': 텍스트가 왼쪽에 맞춰집니다. '"center"': 텍스트가 가운데에 배치됩니다. '"right"': 텍스트가 오른쪽에 맞춰집니다. 기본값 '"center"'.
offset	아이콘의 앵커에서 ems의 오프셋 거리를 지정합니다. 양수 값은 오른쪽과 아래쪽을 나타내고 음수 값은 왼쪽과 위쪽을 나타냅니다. 기본값은 [0, 0]입니다.
opacity	텍스트를 그릴 불투명도를 나타내는 0에서 1 사이의 숫자입니다. 기본값은 1입니다.
optional	텍스트를 다른 기호와 겹치는 경우 숨길 수 있는지를 지정합니다. true이면 텍스트가 다른 기호와 충돌하고 아이콘이 충돌하지 않으면 해당 텍스트 없이 아이콘이 표시됩니다. 기본값은 false입니다.
padding	기호 충돌을 감지하는 데 사용되는 텍스트 경계 상자 주위의 추가 영역 크기입니다. 기본값은 2입니다.
pitchAlignment	지도가 투구될 때 텍스트의 방향을 지정합니다. '"auto"': 'rotationAlignment'의 값과 자동으로 일치합니다. '"map"': 텍스트가 지도의 평면에 맞춰집니다. '"viewport"': 텍스트가 뷰포트의 평면에 맞춰집니다. 기본값: '"auto"'
radialOffset	기호 앵커 방향으로 텍스트의 방사형 오프셋입니다. 2차원(있는 경우)을 사용하는 기본값인 2차원 offset 과 variableAnchor함께 사용할 수 있습니다. 기본값: 0
rotation	텍스트를 시계 방향으로 회전할 각도입니다. 기본 0
rotationAlignment	속성SymbolLayerOptions과 함께 placement 텍스트를 형성하는 개별 문자 모양의 회전 동작을 지정합니다. '"auto"': 'placement'가 '"point"'로 설정된 경우 이는 '"map"'에 해당합니다. 'placement'를 'line'으로 설정하면 '"map"'에 해당합니다. '"map"': 'placement'가 'point'로 설정된 경우 텍스트를 동서로 맞춥니다. 'placement'가 'line'으로 설정된 경우 텍스트 x축을 선에 맞춥니다. '"viewport"': 'placement' 값에 관계없이 x축이 뷰포트의 x축과 정렬되는 문자 모양을 생성합니다. 기본값: '"auto"'
size	글꼴의 크기(픽셀)입니다. 0보다 크거나 같은 숫자여야 합니다. 기본값은 16입니다.
textField	텍스트 레이블에 사용할 기능의 속성 이름을 지정합니다.
variableAnchor	지도에 우선 순위가 높은 레이블을 배치할 가능성을 높이기 위한 잠재적 앵커 위치 목록입니다. 렌더러는 다음 레이블로 이동하기 전에 순서대로 각 위치에 레이블을 배치하려고 시도합니다. 앵커 위치에 따라 텍스트 근거를 선택하는 데 사용합니다 justify: "auto" . 오프셋을 적용하려면 2차원 offset 옵션을 사용합니다radialOffset. '"center"': 아이콘의 중심이 앵커에 가장 가깝게 배치됩니다. '"left"': 아이콘의 왼쪽은 앵커에 가장 가깝게 배치됩니다. '"오른쪽"': 아이콘의 오른쪽은 앵커에 가장 가깝게 배치됩니다. '"top"': 아이콘의 위쪽이 앵커에 가장 가깝게 배치됩니다. '"bottom"': 아이콘의 아래쪽이 앵커에 가장 가깝게 배치됩니다. '"왼쪽 위"': 아이콘의 왼쪽 위 모서리가 앵커에 가장 가깝게 배치됩니다. '"오른쪽 위"': 아이콘의 오른쪽 위 모서리가 앵커에 가장 가깝게 배치됩니다. '"왼쪽 아래"': 아이콘의 왼쪽 아래 모서리가 앵커에 가장 가깝게 배치됩니다. '"오른쪽 아래"': 아이콘의 오른쪽 아래 모서리가 앵커에 가장 가깝게 배치됩니다. 기본값: 'undefined'

속성 세부 정보

allowOverlap

텍스트가 다른 기호와 충돌하는 경우 텍스트가 표시되는지 지정합니다. true이면 이전에 그린 다른 기호와 충돌하더라도 텍스트가 표시됩니다. 기본값은 false입니다.

allowOverlap?: boolean

속성 값

boolean

anchor

아이콘이 지도의 아이콘 앵커 위치에 가장 가깝게 배치되는 부분을 지정합니다.

'"center"': 아이콘의 중심이 앵커에 가장 가깝게 배치됩니다.

'"left"': 아이콘의 왼쪽은 앵커에 가장 가깝게 배치됩니다.

'"오른쪽"': 아이콘의 오른쪽은 앵커에 가장 가깝게 배치됩니다.

'"top"': 아이콘의 위쪽이 앵커에 가장 가깝게 배치됩니다.

'"bottom"': 아이콘의 아래쪽이 앵커에 가장 가깝게 배치됩니다.

'"왼쪽 위"': 아이콘의 왼쪽 위 모서리가 앵커에 가장 가깝게 배치됩니다.

'"오른쪽 위"': 아이콘의 오른쪽 위 모서리가 앵커에 가장 가깝게 배치됩니다.

'"왼쪽 아래"': 아이콘의 왼쪽 아래 모서리가 앵커에 가장 가깝게 배치됩니다.

'"오른쪽 아래"': 아이콘의 오른쪽 아래 모서리가 앵커에 가장 가깝게 배치됩니다.

기본값 '"center"'.

anchor?: PositionAnchor | DataDrivenPropertyValueSpecification<PositionAnchor>

속성 값

PositionAnchor | DataDrivenPropertyValueSpecification<PositionAnchor>

color

텍스트의 색입니다. 기본값은 "#000000"입니다.

color?: string | DataDrivenPropertyValueSpecification<string>

속성 값

string | DataDrivenPropertyValueSpecification<string>

font

텍스트를 표시하는 데 사용할 글꼴 스택입니다. 가능한 값: "SegoeFrutigerHelveticaMYingHei-Bold", "SegoeFrutigerHelveticaMYingHei-Medium", "SegoeFrutigerHelveticaMYingHei-Regular", "SegoeUi-Bold", "SegoeUi-Light", , "SegoeUi-SemiBold""SegoeUi-Regular", "SegoeUi-SemiLight", "SegoeUi-SymbolRegular""StandardCondensedSegoeUi-Black", "StandardCondensedSegoeUi-Bold", "StandardCondensedSegoeUi-Light", "StandardCondensedSegoeUi-Regular", "StandardFont-Black", "StandardFont-Bold", "StandardFont-Light", "StandardFont-Regular""StandardFontCondensed-Black", "StandardFontCondensed-Bold", , . "StandardFontCondensed-Regular""StandardFontCondensed-Light" 기본값은 ["StandardFont-Regular"]입니다.

font?: string[] | DataDrivenPropertyValueSpecification<string[]>

속성 값

string[] | DataDrivenPropertyValueSpecification<string[]>

haloBlur

바깥쪽을 향한 후광의 페이드아웃 거리(픽셀)입니다. 0보다 크거나 같은 숫자여야 합니다. 기본값은 0입니다.

haloBlur?: number | DataDrivenPropertyValueSpecification<number>

속성 값

number | DataDrivenPropertyValueSpecification<number>

haloColor

배경에서 눈에 띄는 데 도움이 되는 텍스트 후광의 색입니다. 기본값은 "rgba(0,0,0,0)"입니다.

haloColor?: string | DataDrivenPropertyValueSpecification<string>

속성 값

string | DataDrivenPropertyValueSpecification<string>

haloWidth

후광에서 글꼴 윤곽선까지의 거리(픽셀)입니다. 0보다 크거나 같은 숫자여야 합니다. 최대 텍스트 후광 너비는 글꼴 크기의 1/4입니다. 기본값은 0입니다.

haloWidth?: number | DataDrivenPropertyValueSpecification<number>

속성 값

number | DataDrivenPropertyValueSpecification<number>

ignorePlacement

다른 기호가 텍스트와 충돌할 수 있는지를 지정합니다. true이면 다른 기호가 텍스트와 충돌하더라도 표시될 수 있습니다. 기본값은 false입니다.

ignorePlacement?: boolean

속성 값

boolean

justify

텍스트 근거 옵션입니다.

'"auto"': 텍스트가 앵커 위치에 맞춰집니다.

'"left"': 텍스트가 왼쪽에 맞춰집니다.

'"center"': 텍스트가 가운데에 배치됩니다.

'"right"': 텍스트가 오른쪽에 맞춰집니다. 기본값 '"center"'.

justify?: "auto" | "left" | "center" | "right"

속성 값

"auto" | "left" | "center" | "right"

offset

아이콘의 앵커에서 ems의 오프셋 거리를 지정합니다. 양수 값은 오른쪽과 아래쪽을 나타내고 음수 값은 왼쪽과 위쪽을 나타냅니다. 기본값은 [0, 0]입니다.

offset?: Pixel | DataDrivenPropertyValueSpecification<Pixel>

속성 값

Pixel | DataDrivenPropertyValueSpecification<Pixel>

opacity

텍스트를 그릴 불투명도를 나타내는 0에서 1 사이의 숫자입니다. 기본값은 1입니다.

opacity?: number | DataDrivenPropertyValueSpecification<number>

속성 값

number | DataDrivenPropertyValueSpecification<number>

optional

텍스트를 다른 기호와 겹치는 경우 숨길 수 있는지를 지정합니다. true이면 텍스트가 다른 기호와 충돌하고 아이콘이 충돌하지 않으면 해당 텍스트 없이 아이콘이 표시됩니다. 기본값은 false입니다.

optional?: boolean

속성 값

boolean

padding

기호 충돌을 감지하는 데 사용되는 텍스트 경계 상자 주위의 추가 영역 크기입니다. 기본값은 2입니다.

padding?: number | PropertyValueSpecification<number>

속성 값

number | PropertyValueSpecification<number>

pitchAlignment

지도가 투구될 때 텍스트의 방향을 지정합니다.

'"auto"': 'rotationAlignment'의 값과 자동으로 일치합니다.

'"map"': 텍스트가 지도의 평면에 맞춰집니다.

'"viewport"': 텍스트가 뷰포트의 평면에 맞춰집니다.

기본값: '"auto"'

pitchAlignment?: "auto" | "map" | "viewport"

속성 값

"auto" | "map" | "viewport"

radialOffset

기호 앵커 방향으로 텍스트의 방사형 오프셋입니다. 2차원(있는 경우)을 사용하는 기본값인 2차원 offset 과 variableAnchor함께 사용할 수 있습니다. 기본값: 0

radialOffset?: number | DataDrivenPropertyValueSpecification<number>

속성 값

number | DataDrivenPropertyValueSpecification<number>

rotation

텍스트를 시계 방향으로 회전할 각도입니다. 기본 0

rotation?: number | DataDrivenPropertyValueSpecification<number>

속성 값

number | DataDrivenPropertyValueSpecification<number>

rotationAlignment

속성SymbolLayerOptions과 함께 placement 텍스트를 형성하는 개별 문자 모양의 회전 동작을 지정합니다.

'"auto"': 'placement'가 '"point"'로 설정된 경우 이는 '"map"'에 해당합니다. 'placement'를 'line'으로 설정하면 '"map"'에 해당합니다.

'"map"': 'placement'가 'point'로 설정된 경우 텍스트를 동서로 맞춥니다. 'placement'가 'line'으로 설정된 경우 텍스트 x축을 선에 맞춥니다.

'"viewport"': 'placement' 값에 관계없이 x축이 뷰포트의 x축과 정렬되는 문자 모양을 생성합니다.

기본값: '"auto"'

rotationAlignment?: "auto" | "map" | "viewport"

속성 값

"auto" | "map" | "viewport"

size

글꼴의 크기(픽셀)입니다. 0보다 크거나 같은 숫자여야 합니다. 기본값은 16입니다.

size?: number | DataDrivenPropertyValueSpecification<number>

속성 값

number | DataDrivenPropertyValueSpecification<number>

textField

텍스트 레이블에 사용할 기능의 속성 이름을 지정합니다.

textField?: string | DataDrivenPropertyValueSpecification<string>

속성 값

string | DataDrivenPropertyValueSpecification<string>

variableAnchor

지도에 우선 순위가 높은 레이블을 배치할 가능성을 높이기 위한 잠재적 앵커 위치 목록입니다. 렌더러는 다음 레이블로 이동하기 전에 순서대로 각 위치에 레이블을 배치하려고 시도합니다. 앵커 위치에 따라 텍스트 근거를 선택하는 데 사용합니다 justify: "auto" . 오프셋을 적용하려면 2차원 offset 옵션을 사용합니다radialOffset.

'"center"': 아이콘의 중심이 앵커에 가장 가깝게 배치됩니다.

'"left"': 아이콘의 왼쪽은 앵커에 가장 가깝게 배치됩니다.

'"오른쪽"': 아이콘의 오른쪽은 앵커에 가장 가깝게 배치됩니다.

'"top"': 아이콘의 위쪽이 앵커에 가장 가깝게 배치됩니다.

'"bottom"': 아이콘의 아래쪽이 앵커에 가장 가깝게 배치됩니다.

'"왼쪽 위"': 아이콘의 왼쪽 위 모서리가 앵커에 가장 가깝게 배치됩니다.

'"오른쪽 위"': 아이콘의 오른쪽 위 모서리가 앵커에 가장 가깝게 배치됩니다.

'"왼쪽 아래"': 아이콘의 왼쪽 아래 모서리가 앵커에 가장 가깝게 배치됩니다.

'"오른쪽 아래"': 아이콘의 오른쪽 아래 모서리가 앵커에 가장 가깝게 배치됩니다.

기본값: 'undefined'

variableAnchor?: PositionAnchor[]

속성 값

PositionAnchor[]