# JSAntenna

> Module.CreateAntenna() API를 생성합니다.

```javascript
var object = Module.CreateAntenna("ID");
```

## Function

### CreateCoverageCone(position, height, radius, angle, x, segment) → boolean

> 전파 범위 3차원 모델 객체를 생성합니다.

{% tabs %}
{% tab title="Information" %}

| Name     | Type                                                                                       | Description                              |
| -------- | ------------------------------------------------------------------------------------------ | ---------------------------------------- |
| position | [JSVector3D](https://egiscorp.gitbook.io/xdworld-webgl-manual/introduce-1/core/jsvector3d) | 전파 시작 경위도.                               |
| height   | number                                                                                     | 전파 시작 경위도에서 전파 모델링 높이 설정.                |
| radius   | number                                                                                     | 전파 모델링 반경 설정(radius>0 입력).               |
| angle    | number                                                                                     | 전파 모델링 파형 각도 설정(angle>-90, angle<90 입력). |
| x        | number                                                                                     | 전파 모델링 파형 화각 너비 설정.                      |
| segment  | number                                                                                     | 전파 모델링 정밀도 설정(segment>3 입력).             |

* Return
  * true : 생성 성공.
  * false : 생성 실패.
  * 실패 조건.
    * effect\_radius < 0 값이 설졍 된 경우.
    * effect\_angle < -90, effect\_angle > 90 값이 설정된 경우.
    * effect\_radius < 3 값이 설졍 된 경우.
* Sample
  * the create function 참조.
  * [Sandbox\_Radio Coverage](https://sandbox.egiscloud.com/code/main.do?id=object_antenna)
    {% endtab %}

{% tab title="Template" %}

```javascript
```

{% endtab %}
{% endtabs %}

### SetCoverageDistance(radius) → boolean

> 전파 범위 모델 반경 변경.

{% tabs %}
{% tab title="Information" %}

| Name   | Type   | Description                 |
| ------ | ------ | --------------------------- |
| radius | number | 전파 모델링 반경 설정(radius > 0 입력) |

* Return
  * true : 설정 성공.
  * false : 설정 실패.
  * 실패 조건
    * radius < 0 값이 설정된 경우.
* Sample
  * the SetCoverageDistance function 참조.
  * [Sandbox\_Radio Coverage](https://sandbox.egiscloud.com/code/main.do?id=object_antenna)
    {% endtab %}

{% tab title="Template" %}

```javascript
```

{% endtab %}
{% endtabs %}

## Getter / Setter

### getDescription(), setDescription(desc) → string

> 객체에 대한 설명을 설정합니다.

{% tabs %}
{% tab title="Information" %}

| Name | Type   | Description |
| ---- | ------ | ----------- |
| desc | string | 설명 문자열.     |

* Return
  * string: 객체 설명 문자열이 성공적으로 반환.
  * null: 객체가 null인 경우.
    {% endtab %}

{% tab title="Template" %}

```javascript
var strDesc = object.getDescription();
// ... or ...
object.setDescription("First Object.");
```

{% endtab %}
{% endtabs %}

### getName(), setName(name) → string

> 객체 이름을 설정합니다.

{% tabs %}
{% tab title="Information" %}

| Name | Type   | Description |
| ---- | ------ | ----------- |
| name | string | 객체 이름.      |

* Return
  * string: 객체 이름을 성공적을 반환
  * null: 객체가 null인 경우.
    {% endtab %}

{% tab title="Template" %}

```javascript
var objName = object.getName();
// ... or ...
object.setName("MyObject");
```

{% endtab %}
{% endtabs %}

### getVisible(), setVisible(visible) → boolean

> 객체의 가시화 유무를 설정합니다.

{% tabs %}
{% tab title="Information" %}

| Name    | Type    | Description                             |
| ------- | ------- | --------------------------------------- |
| visible | boolean | <p>true: 객체 가시화.<br>false: 객체 비가시화.</p> |

* Return
  * true: 객체 가시화 상태.
  * false: 객체 비가시화 상태.
    {% endtab %}

{% tab title="Template" %}

```javascript
var objName = object.getName();
// ... or ...
object.setVisible(true);
```

{% endtab %}
{% endtabs %}