---
sourceDocument: 호주 API 참조
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ko-KR/api-reference

 Release :

    - australia

ft:locale :

    - ko-KR

ft:publication_title :

    - 호주 API 참조

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# 색상 - 범위 지정, 전역

# 색상 - 범위 지정, 전역 {#ariaid-title1}

* 릴리스 버전: Australia
* 
* 업데이트 날짜 2026년 03월 12일
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 소요 시간: 3분

PDF의 요소에 적용할 수 있는 색상 속성을 정의하는 데 사용되는 색상 객체를 만듭니다. 셀, 테이블, 줄 등이 있습니다.

이 API는 PDF Generation Utilities 플러그인(com.snc.apppdfgenerator)의 ServiceNow 일부이며 `sn_pdfgeneratorutils` 네임스페이스 내에서 제공됩니다. 플러그인은 기본적으로 활성화되어 있습니다.

이 API는 PDF를 생성하기 위해 [문서 API](https://servicenow-prod.fluidtopics.net/1el8mFgzJVRLSfvarlrRdw#DocumentBothAPI "문서 API는 PDF를 초기화하고, 콘텐츠를 추가하고, PDF를 닫는 메서드를 제공합니다. 컨텐츠를 추가한 후에는 문서를 대상 기록에 첨부할 수 있습니다.") 와 함께 사용되는 구성요소입니다.

## 색상 - 색상(배열 색상) {#ariaid-title2}

RGB 값으로 새 Color 개체를 인스턴스화합니다.
색상은 다음 시나리오에 적용할 수 있습니다.
{#Color-Color_A__table_twm_hjk_34b__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 그림 물감 | 배열 | 0에서 1까지의 10진수 값을 사용하여 RGB 값을 나타내는 세 개의 숫자입니다. 예를 들어 `[0.1, 0.9, 0.5]`에서 첫 번째 위치의 값은 빨간색, 두 번째 값은 녹색, 세 번째 위치는 파란색입니다. 또한 `[0, 0, 0]` 은 검정색, `[0.5, 0.5, 0.5]` 는 회색, `[1, 1, 1]` 은 흰색 단색입니다. |
[표 1. 매개변수]

{#Color-Color_A__table_twm_hjk_34b}  
다음 예제에서는 Color 객체를 만드는 방법을 보여줍니다.

    var color = new sn_pdfgeneratorutils.Color([0.1, 0.9, 0.5]); //given as object containing RGB values

## 색상 - 같음(색상 색상) {#ariaid-title3}

서로 다른 두 색상 개체의 값이 일치하는지 여부를 나타냅니다.
{#Color-equals_O__table_vv5_52h_44b__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 색상 | 색상 | 일치 여부를 확인할 색상 객체입니다. |
[표 2. 매개변수]

{#Color-equals_O__table_vv5_52h_44b} {#Color-equals_O__table_wv5_52h_44b__entry__2}

| 유형 | 설명 |
|-|-|
| 부울 | 두 색상 객체의 값이 일치하는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 색상이 일치합니다. * false: 색상이 일치하지 않습니다. {#Color-equals_O__ul_grr_53x_r4b} |
[표 3. 반환]

{#Color-equals_O__table_wv5_52h_44b}  
다음 예시에서는 두 개의 색상 객체를 만들고 색상이 일치하는지 확인하는 방법을 보여줍니다.

    var color1 = new sn_pdfgeneratorutils.Color([1,0.5,0.5]);  // given as an array of RGB values
    var color2 = new sn_pdfgeneratorutils.Color([0.8,0.5,0.5]);         // given as an array of RGB values
    var isequal = color1.equals(color2);

## 색상 -- getGrayColor(Number grayScale) {#ariaid-title4}

검정색, 회색 또는 흰색 객체를 반환합니다.
{#Color-getGrayColor_N__table_vv5_52h_44b__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 그레이스케일 | 번호 | 0에서 1까지의 10진수 값으로, 여기서 0은 검은색이고 1은 흰색입니다. |
[표 4. 매개변수]

{#Color-getGrayColor_N__table_vv5_52h_44b} {#Color-getGrayColor_N__table_wv5_52h_44b__entry__2}

| 유형 | 설명 |
|-|-|
| 객체 | 제공된 회색조 값을 반영하는 색상 객체입니다. |
[표 5. 반환]

{#Color-getGrayColor_N__table_wv5_52h_44b}  
다음 예제에서는 50% 회색조의 색상 객체를 만드는 방법을 보여줍니다.

    var grayColor = new sn_pdfgeneratorutils.Color.getGrayColor(0.5);

## 색상 -- setColorValue(배열 색상) {#ariaid-title5}

주어진 값으로 색상을 생성하고 기존 색상의 값을 변경할 수 있습니다. 각 값은 0에서 1 사이여야 합니다.
{#Color-setColorValue_A__table_vv5_52h_44b__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 그림 물감 | 배열 | 0에서 1까지의 10진수 값을 사용하여 RGB 값을 나타내는 세 개의 숫자입니다. 예를 들어 `[0.1, 0.9, 0.5]`에서 첫 번째 위치의 값은 빨간색, 두 번째 값은 녹색, 세 번째 위치는 파란색입니다. 또한 `[0, 0, 0]` 은 검정색, `[0.5, 0.5, 0.5]` 는 회색, `[1, 1, 1]` 은 흰색 단색입니다. |
[표 6. 매개변수]

{#Color-setColorValue_A__table_vv5_52h_44b} {#Color-setColorValue_A__table_wv5_52h_44b__entry__2}

| 유형 | 설명 |
|-|-|
| 없음 |   |
[표 7. 반환]

{#Color-setColorValue_A__table_wv5_52h_44b}  
다음 예는 기존 색상의 값을 변경하는 방법을 보여줍니다.

    var color = new sn_pdfgeneratorutils.Color([1,0.5,0.5]);   //given as array of RGB values;
    color.setColorValue(color);

## 색상 - setOpacity(숫자 불투명도) {#ariaid-title6}

색상 불투명도 수준을 설정합니다.
{#Color-setOpacity_N__table_vv5_52h_44b__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 색상 | 색상 | 0에서 1까지의 부동 10진수 값으로, 0은 완전히 투명하고 1은 완전히 불투명입니다. |
[표 8. 매개변수]

{#Color-setOpacity_N__table_vv5_52h_44b} {#Color-setOpacity_N__table_wv5_52h_44b__entry__2}

| 유형 | 설명 |
|-|-|
| 없음 |   |
[표 9. 반환]

{#Color-setOpacity_N__table_wv5_52h_44b}  
다음 예제에서는 색상 개체를 만들고 불투명도를 50%로 설정하는 방법을 보여 줍니다.

    var color = new Color([1,0.5,0.5]);
    color.setOpacity(0.5);