본 항목에서는 경향감시 기능에서 자주 쓰이는 서브루틴(Subroutine)을 확인할 수 있습니다. 활용할 수 있는 서브루틴은 다음 표를 참조하여 주시기 바랍니다.
| NOTE
| 모든 명령어는 반드시 괄호를 사용하여야 합니다. TrendCsvWr 이외의 내부함수는 Xpanel Designer v2.53 이상 버전부터 사용 가능합니다. |
명령어 | 설명 | ||
경향감시 | 서브루틴 | TrendCsvWr | 경향감시 오브젝트의 데이터를 CSV 형식의 파일로 저장합니다. |
서브루틴 | SetTrendZoom | YT 트렌드에 등록된 펜의 최소값/최대값을 변경합니다. | |
서브루틴 | SetTrendRatio | YT 트렌드에 등록된 펜의 최소/최대비율을 변경합니다. | |
서브루틴 | ResetTrend | YT 트렌드에 등록된 펜의 최소값/최대값을 기본값으로 초기화합니다. | |
함수 | TrendGetPenVal | YT 트렌드에 등록된 펜의 최소값/최대값의 설정값을 가져옵니다. | |
함수 | TrendSetPenVal | YT 트렌드에 등록된 펜의 주석, 최소값/최대값의 설정값을 변경합니다. | |
서브루틴 | SetPenStatus | YT 트렌드에 등록된 펜을 보이게 하거나 숨깁니다. | |
TrendCsvWr | 경향감시 오브젝트의 데이터를 CSV 형식의 파일로 저장합니다. |
서브루틴명 | TrendCsvWr(“Trend이름”, 저장위치) |
기능 | 지정한 Trend이름의 경향감시 오브젝트 데이터를 CSV 파일로 변환하여 지정한 저장위치에 저장합니다. 저장위치에 0을 입력하면 로컬을 의미하며, 1을 입력하면 SD/MMC를 의미합니다. 2를 입력할 경우 USB에 파일을 저장합니다. 저장위치 는 다음 문자기호로도 표현할 수 있습니다. 0: _LOCAL_ 1: _SDMEM_ 2: _USBMEM_ 파일은 “Trendname_MMDDHHmmss.CSV” 의 형식의 이름으로 저장됩니다. |
사용 예제 | 경향감시 오브젝트 Trend 의 데이터를 USB 메모리에 CSV 파일로 저장합니다. TrendCsvWr(“Trend”,2) |
...
SetTrendZoom
...
YT 트렌드에 등록된 펜의 최소값과 최대값을 변경합니다.
...
서브루틴명
...
SetTrendZoom (“YT트렌드명”, 펜 번호, 트렌드에 설정할 최소값, 트렌드에 설정할 최대값)
...
기능
...
지정한 YT 트렌드 내에서 특정한 펜의 최소값과 최대값을 변경합니다. ResetTrend 명령함수을 통해 기본값으로 리셋할 수 있습니다. 각 파라미터는 다음과 같은 조건을 가집니다.
YT 트렌드명: 대상이 되는 YT 트렌드 오브젝트 이름
펜 번호: 최소값 및 최대값을 변경할 펜 (1~16)
트렌드에 설정할 최소값: 해당 펜에 설정된 태그의 최소값 이상 최대값 미만의 범위
트렌드에 설정할 최대값: 해당 펜에 설정된 태그의 최소값 이상 최대값 미만의 범위
...
사용 예제
...
‘Trend’ 라는 이름을 가진 YT 트렌드의 첫번째 펜의 최소값/최대값을 각각 30/100으로 변경합니다.
SetTrendZoom (“Trend”, 1, 30, 100)
...
SetTrendRatio
...
YT 트렌드에 등록된 펜의 최소/최대비율을 변경합니다.
...
서브루틴명
...
SetTrendRatio (“YT트렌드명”, 펜 번호, 트렌드에 설정할 최소값의 비율, 트렌드에 설정할 최대값의 비율)
...
기능
...
지정한 YT 트렌드 내에서 특정한 펜의 최소/최대비율을 변경합니다. ResetTrend 명령함수을 통해 기본값으로 리셋할 수 있습니다. 각 파라미터는 다음과 같은 조건을 가집니다.
YT 트렌드명: 대상이 되는 YT 트렌드 오브젝트 이름
펜 번호: 최소/최대비율을 변경할 펜 (1~16)
트렌드에 설정할 최소값의 비율: 해당 펜에 설정할 최소값의 비율 (0~99)
트렌드에 설정할 최대값의 비율: 해당 펜에 설정할 최대값의 비율 (1~100)
최소값의 비율은 최대값의 비율보다 크게 설정할 수 없습니다.
...
사용 예제
...
‘Trend’ 라는 이름을 가진 YT 트렌드의 첫번째 펜의 최소/최대비율을 각각 20%, 80%으로 변경합니다.
SetTrendRatio (“Trend”, 1, 20, 80)
...
ResetTrend
...
YT 트렌드에 등록된 펜의 최소값/최대값을 기본값으로 초기화합니다.
...
서브루틴명
...
ResetTrend (“YT트렌드명”, 펜 번호)
...
기능
...
지정한 YT 트렌드 내에서 특정한 펜의 최소값/최대값을 기본값으로 리셋합니다.
YT 트렌드명: 대상이 되는 YT 트렌드 오브젝트 이름
펜 번호: 최소값/최대값을 리셋할 펜 (1~16)
...
사용 예제
...
‘Trend’ 라는 이름을 가진 YT 트렌드의 첫번째 펜의 최소값/최대값을 기본값으로 리셋합니다.
ResetTrend (“Trend”, 1)
...
TrendGetPenVal
...
YT 트렌드에 등록된 펜의 최소값/최대값의 설정값을 가져옵니다.
...
함수명
...
N = TrendGetPenVal (“YT트렌드명”, 펜 번호, 값 종류)
...
기능
...
지정한 YT 트렌드 내에서 특정한 펜의 최소값/최대값을 반환합니다.
YT 트렌드명: 대상이 되는 YT 트렌드 오브젝트 이름
펜 번호: 최소값/최대값을 가져올 펜 (1~16)
값 종류:
2: 최소값
3: 최대값
7: 히스토리컬 모드에서 펜의 현재값
8: 히스토리컬 모드에서 펜의 현재시각(수치, time_t형)
9: 히스토리컬 모드에서 현재 프레임 내의 최소값
11: 히스토리컬 모드에서 현재 프레임 내의 최대값
15: 히스토리컬 모드에서 펜의 현재시각(문자열, YYYY-MM-DD hh:mm:ss)
...
사용 예제
...
‘Trend’ 라는 이름을 가진 YT 트렌드의 첫번째 펜의 최대값을 리턴합니다.
N = TrendGetPenVal (“Trend”, 1, 3)
...
TrendSetPenVal
...
YT 트렌드에 등록된 펜의 설정값을 변경합니다.
...
함수명
...
N = TrendSetPenVal (“YT트렌드명”, 펜 번호, 값 종류, 종류에 대한 변경값)
...
기능
...
지정한 YT 트렌드 내에서 특정한 펜의 설정값을 .변경합니다.
YT 트렌드명: 대상이 되는 YT 트렌드 오브젝트 이름
펜 번호: 설정값을 선택할 펜 (1~16)
값 종류: 펜의 주석 1, 최소값 2, 최대값 3
설정값 변경에 성공하였을 때 1 값이 반환됩니다. 설정값 변경에 실패하였을 경우에는 0 값이 반환됩니다.
...
사용 예제
...
‘Trend’ 라는 이름을 가진 YT 트렌드의 첫번째 펜의 최소값을 10으로 설정합니다.
1 = TrendSetPenVal (“Trend”, 1, 2, 10)
...
SetPenStatus
...
YT 트렌드에 등록된 펜을 보이게 하거나 숨깁니다.
...
서브루틴명
...
SetPenStatus (“YT 트렌드명”, 펜 번호, 옵션)
...
기능
...
지정한 YT 트렌드 내에서 특정한 펜을 보이게 하거나 숨길 수 있습니다.
YT 트렌드명: 대상이 되는 YT 트렌드 오브젝트 이름
펜 번호: 보임 여부를 설정할 펜 (1~16)
옵션: 보임 1, 숨김 0
...
사용 예제
‘Trend’ 라는 이름을 가진 YT 트렌드의 첫번째 펜이 보이도록 설정합니다.
...