enuSpace

enuSpace professional 2016 기준

void PlaySound method (enuSpace in lua script)

enuSpace in lua lua function

void PlaySound(

[in] string Filename

};

Parameters

Filename[in]

Type:string

wav 파일 이름을 사용

Return value

Type : bool

Remarks

루아 스크립트에서 본 함수를 사용하는 경우, windos api PlaySound 함수 호출 수행

Examples

enuSpace script editor

function onmousedown()

PlaySound("Alarm02.wav")

end

enuSpace professional 2016 기준

void ShellExecute method (enuSpace in lua script)

enuSpace in lua function

void ShellExecute(

[in] string Operation,

[in] string File,

[in] string Parameters,

[in] string Directory,

};

Parameters

Operation[in]

Type:string

The set of available verbs depends on the particular file or folder. Generally, the actions available from an object's shortcut menu are available verbs. The following verbs are commonly used:

edit

Launches an editor and opens the document for editing. If File is not a document file, the function will fail.

explore

Explores a folder specified by File.

find

Initiates a search beginning in the directory specified by Directory.

open

Opens the item specified by the File parameter. The item can be a file or folder.

print

Prints the file specified by File. If File is not a document file, the function fails.

File[in]

Type:string

A pointer to a null-terminated string that specifies the file or object on which to execute the specified verb. To specify a Shell namespace object, pass the fully qualified parse name. Note that not all verbs are supported on all objects. For example, not all document types support the "print" verb. If a relative path is used for the Directory parameter do not use a relative path for File.

Parameters[in]

Type:string

If File specifies an executable file, this parameter is a pointer to a null-terminated string that specifies the parameters to be passed to the application. The format of this string is determined by the verb that is to be invoked. If File specifies a document file, Parameters should be NULL.

Directory[in]

Type:string

A pointer to a null-terminated string that specifies the default (working) directory for the action. If this value is NULL, the current working directory is used. If a relative path is provided at File, do not use a relative path for Directory.

Return value

Type : void

Remarks

루아 스크립트에서 본 함수를 사용하는 경우, windows api ShellExecute 함수 호출 수행.

Examples

enuSpace script editor

function onmousedown()

ShellExecute("open", "http://enuspace.tistory.com", "", "")

end

enuSpace professional 2016 기준

enuSpace 편집기 스크립트 사용자 함수 호출 (lua script)

스크립트 내에서의 다른 함수 실행 

같은 객체 내의 함수 실행

각 객체는 다른 여러 개의 함수를 포함할 수 있으며 예시로 사용된 것처럼 직접 함수 이름을 호출할 수 있다.

다음 그림에서 GetColor함수는 같은 사각형 객체 내에 있으며 onmousedown함수에서 사용된 예이다.

이웃 객체 내의 함수 실행

각 객체에 함수는 이웃하는 다른 객체의 함수를 호출할 수 있다.

다음 그림에서 GetColor함수는 같은 사각형 객체 내에 있으며 onmousedown함수에서 사용된 예이다.

다음 그림은 "빨강"이라는 텍스트 객체에 SetFontSize함수를 이용하여 fonts-size를 바꾸는 함수를 만들고 이웃한 객체인 사각형 객체의 마우스다운 이벤트 함수를 이용하여 실행하는 함수 예시이다. 사각형 객체는 마우스를 클릭하여 index 값을 바꾸고 인덱스 값에 따라 이웃한 객체인 ID_TestRed 객체의 font-size를 바꾼다.

Lua Script 함수 실행

각 객체는 자식객체의 함수, 상위객체의 함수 페이지 함수, 전역 함수, 인터페이스 함수, 루아스크립트 함수 등을 실행할 수 있는데 실행되는 순서는 다음과 같다.

- 같은 객체 내의 함수

- 자식 객체의 함수

- 이웃 객체의 함수

- 상위 객체의 함수

- 페이지 함수

- 전역함수

- 인터페이스 함수

- .루아스크립트 함수

우선 순위는 같은 객체 내의 함수가 가장 높고 루아스크립트 함수가 가장 낮다. 자식 객체의 함수를 실행하기 위해서는 자식객체 id.함수 이름으로 실행해야 하며 자식객체에서 찾지 못하면 이웃 객체에서 찾는데 이웃객체에도 없으면 차례로 우선순위가 높은 순으로 찾는다. 따라서 우선 순위가 낮은 함수를 사용하려면 같은 이름의 함수는 우선 순위가 낮은 함수를 찾을 때까지 존재하지 않아야 한다. mean 함수는 테이블을 인수로 받아 테이블 내의 모든 값을 더해서 테이블의 필드 개수로 나누어 평균값을 구한 후 그 값을 반환한다. 다음 그림은 mean 전역함수를 선언한 예시이다.

다음 그림은 전역함수 mean 함수를 이용해서 onmousedown에 의해 바뀌는 index 값을 각 테이블의 필드 값에 더하고 테이블의 평균값을 구하는 전역함수 mean을 이용해서 평균값을 구해서 텍스트 객체(ID_TextRed)의 text 에 문자열을 할당하는 onmousedown함수 예제와 그 실행된 상태를 표시하는 예시이다.

다른 함수를 실행함으로써 바뀐 값을 그 후에 사용하는 방법

다른 함수를 실행함으로써 전역 변수나 다른 기타의 변수가 바뀐 상태의 것을 현재의 스크립트 함수에서 다시 사용하고자 할 때 값을 다시 가져오는 GetValue(변수이름) 을 사용하여야 하며 그냥 사용할 시는 변경된 값이 적용되지 않는다.

다음 그림은 스크립트 내에서 index의 값을 사용하는 예시를 보여준다. IncreaseIndex함수는 index값을 1씩 증가시키므로 IncreaseIndex함수가 실행된 후에는 index 값이 1이 증가되어 있으나 스크립트 내에서는 아직 이전 값을 가지고 있다. 변경된 값을 가져오기 위해서 GetValue(index)를 사용하여 현재의 값을 가지고 와서 사용한다.

enuSpace professional 2016 기준

enuSpace HMI 편집기를 이용한 동적 디스플레이 기능

Dynamic Script

속성 변경

속성의 변수 타입이 boolean인 속성은 스크립트 내에서는 true, false 값을 할당함으로써 바꿀 수 있으며, wchar 인 속성은 string의 보조 함수인 string.format 함수를 이용해서 바꿀 수 있다. wchar 속성의 변수를 string.format 함수를 사용하지 않고 직접 할당할 경우 처음에 할당되었던 문자의 크기보다 새로이 할당된 문자의 크기가 클 경우 메모리 침범이 발생할 수 있으며, 심해질 경우 프로그램이 정지할 수도 있다. 속성 변수의 이름은 -가 포함될 수 없으며 '-'는 '_'로 대치(속성 : fill-opacity, 변수명 : fill_opacity)하여 변수를 설정하였으므로 반드시 '-'는 '_'로 바꾸어 사용해야 한다.

boolean : visibility, lock, disabled, multiline, password, read-only, want-return, border, number, lowercase, uppercase, static-edge, auto-scroll, horizontal-scroll, vertical-scroll 등.

wchar : id, fill, stroke-dash, stroke, points, d, text, font-family 등.

int : stroke-width, stroke-linejoin, stroke-linecap, text-anchor, font-style, font-weight 등.

float, double : fill-opacity, stroke-opacity, x, y, rx, ry, width, height, translate-x, translate-y, rotate, scale-x, scale-y, center-x, center-y, cx, cy, r, rx, ry, font-size 등. 

색상변경 : 문자열 속성

각 객체의 색상은 텍스트 문자열로 "rgb(0,0,0)" , "black" 또는 "#000000" 처럼 스크립트 내에서 입력함으로써 변경할 수 있다.

onmousedown 이벤트에 의해 index의 값을 바꾸고 index 값에 따라 색상 값을 반환해주는 GetColor함수에서 색상 값을 받아서 사각영역을 채우는 색상 fill값을 바꾼다.

투명도 변경 : float 속성

각 객체의 색상은 0~1 사이의 투명도를 가지며 실수이다. 0은 완전 투명 1은 완전 불투명이다. 

onmousedown 이벤트에 의해 index의 값을 바꾸고 index 값에 따라 투명도 값을 반환해주는 GetOpacity함수에서 투명도 값을 받아서 사각영역의 투명도를 설정하는 fill-opacity 값을 바꾼다.

visibility 변경 : boolean 속성

각 객체의 속성 중 visibility는 객체가 보여질 것인지 보여지지 않을 것인지에 대해 결정하며 조건에 따라 객체가 보여질지 안 보여질지에 대해 스크립트 내에서 설정할 수 있는데 visibility의 변수 타입은 boolean이므로 스크립트 내에서 true 혹은 false로 할당하여 바꿀 수 있다.

다음 그림 예시는 세 개의 문자열 "빨강", "녹색", "파랑"의 visibility속성을 사각형의 마우스 다운이벤트가 한번 발생할 때마다 바뀌는 예시이며, 각각의 문자열은 사각형에 이웃한 객체의 고유한 id를 가지고 id.visibility를 바꾸는 스크립트를 작성한 예제이다.

다음 그림은 visibility를 바꾸는 이벤트 함수가 차례로 실행되어 표시된 상태이고 ○1은 편집 창에서의 표시를 나타내고 ○2는 실행창에서의 표시를 나타낸다. 편집 창에서는 편집을 위해 객체가 완전히 사라지지 않고 hidden 상태를 나타내는 회색 박스를 표시한다. 

enuSpace 그래픽 저작기 디버깅 윈도우(Debuging Window)

Runtime Debug

Runtime Debug는 그래픽 편집기에서 사용자가 개발하는 프로젝트에 대한 정보를 화면에 출력해 주는 기능을 제공한다. 예를 들어 Picture를 불러오기 할 때는 정상적으로 불러오기를 수행했는지 에러가 발생했는지에 대해 Runtime Debug 에서 텍스트 형태로 제공하며, Library 정의 시 이벤트가 정상적으로 작동하는지, 함수 동작이 정상적으로 동작하는지에 대해서도 역시 텍스트 형태로 제공한다. 또한 Script 작성 시 해당 Script가 정상적으로 사용되었는지도 텍스트 형태로 제공한다. 아래 그림은 Runtime Debug가 텍스트 형태로 제공되는 형태를 나타낸 것이다.

enuSpace 그래픽 저작기 Runtime View 사용하기 

Graphic Viewer는 그래픽 편집기에서 사용자가 개발한 Library 및 Picture 등을 사용자가 정의한 이벤트 및 사용 목적에 맞게 정상적으로 동작하는지 확인하기 위한 기능을 제공한다. Graphic Viewer는 그래픽 편집기 상단 오른쪽에 위치한 “Runtime” 버튼을 클릭하면 편집기 중앙에 팝업 형태로 표시된다. 아래 그림은 Graphic Viewer를 사용하는 방법에 대해 나타낸 것이다.

enuSpace 그래픽 저작기 Trend 사용하기 (Trend)

통합 그래픽 Prototype 소프트웨어에서는 Chart의 생성 및 Chart 설정, Chart데이터 설정 등과 같은 Trend 기능을 제공한다.

Trend 생성

Trend의 생성은 Picture 화면에서 그래픽 편집기 상단 중앙에 위치한 “Chart”버튼을 클릭하여 화면에 원하는 크기로 드래그 하여 생성한다. 아래 그림은 Trend 생성 방법을 나타낸 것이다.

Trend 삭제

Trend 삭제를 위해서는 생성된 Trend를 선택한 후 키보드의 “Delete” 버튼을 누르면 Trend를 삭제 시킬 수 있다. 아래 그림은 Trend 삭제 방법을 나타낸 것이다.

Trend Element 생성

Trend를 선택 후 나타나는 리본메뉴에서 “Add Chart Element” 버튼 클릭하여 하위 메뉴를 선택하여 Element를 생성한다. 아래의 표는 하위 메뉴의 설명이다.

아래 그림은 Trend Element 생성 방법에 대해 나타낸 것이다.

Trend 속성 변경

생성한 Trend를 선택하고 속성 창에서 Layout, Trend Properties, Trend background, Trend AxisProperties 섹션을 찾아 속성을 변경한다. 아래의 표는 Trend 속성에 대한 설명이다.

아래 그림은 Trend의 Background 속성을 변경하는 방법에 대해 나타낸 것이다.

Trend Title 속성 변경

Trend의 Title영역을 선택하여 속성 창을 열고, 속성을 변경한다. 아래의 표는 Title속성에 대한 설명이다.

아래 그림은 Trend의 Title 속성을 변경하는 방법에 대해 나타낸 것이다.

Trend Legend 속성 변경

Trend의 Legend영역을 선택하여 속성 창을 열고, 속성을 변경한다. 아래 표는 Legend속성에 대한 설명이다

아래 그림은 Trend의 Legend 속성을 변경하는 방법을 나타낸 것이다.

Trend X axis 속성 변경

Trend의 X axis(X축) 영역을 선택하여 속성 창을 열고, 속성을 변경 한다. 아래의 표는 X axis의 속성에 대한 설명이다.

아래 그림은 Trend의 X axis(X축) 속성 값을 변경하는 방법을 나타낸 것이다.

Trend Y axis 속성 변경

Trend의 Y axis(Y축) 영역을 선택하여 속성 창을 열고, 속성을 변경 한다. 아래 표는 Y axis의 속성에 대한 설명이다.

아래 그림은 Trend의 Y axis(Y축) 속성 값을 변경하는 방법을 나타낸 것이다.

Trend Grid 속성 변경

Trend의 Grid 영역을 선택하여 속성 창을 열고, 속성을 변경 한다. 아래 표는 Grid의 속성에 대한 설명이다.

아래 그림은 Trend의 Grid 속성 값을 변경하는 방법을 나타낸 것이다.

Trend 기능

Trend에 band-highlimit로 최대 기준선, band-lowlimit로 최소 기준선을 그린다. 아래의 표는 Trend Band 속성에 대한 설명이다.

아래 그림은 Trend의 Band 기능을 나타낸 것이다.

Trend Series

Trend Series 생성

Trend를 선택하면 나오는 리본메뉴에서 Select Data섹션의 Add Data항목을 선택한다. 선택 후 나오는 Chart Add Data창에서 Add 버튼을 눌러 Series를 생성한다. 아래 그림은 Trend의 Series 을 생성하는 방법에 대해 나타낸 것이다.

Trend Series 속성 변경

Chart Add Data창에서 속성 변경을 하고자 하는 Series의 ID를 선택하고, 같은 창의 오른쪽에 Series Properties에서 선택한 Series의 속성을 변경한다. 밑의 표는 Series의 속성에 대한 설명이다.

아래 그림은 Trend Series 속성을 변경하는 방법에 대해 나타낸 것이다.

Trend Series Data Interface

Trend 속성 중 variable속성에 연결하려는 Logic객체의 Connection Pin의 이름을 입력한다. 아래 그림은 Trend Series Data Interface에 대해 나타낸 것이다.

Extended Trend

인스턴트 Trend로써 Logic객체의 Pin정보를 받아 같이 보여주는 Trend이다. 생성을 위해서 Logic객체가 필요하다. 아래 그림은 Trend에서 확장된 Extended Trend를 생성하는 법을 나타낸 것이다.

아래 그림은 Extended Trend를 나타낸 것이다.

enuSpace 그래픽 저작기 프로젝트 익스플로어 기능 (Project Explorer)

프로젝트 탐색기는 전체 프로젝트를 트리 구조로 관리하는 기능으로 크게 4개의 기능이 있으며, 각각은 전역변수 관리(Global), Picture 관리, Library 관리, Style 관리이다. 

전역변수 관리는 Global이라는 폴더는 전역변수를 관리하는 영역으로 새로운 전역변수 파일을 만들거나 삭제하고 전역변수 파일에 전역변수를 생성, 제거하는 역할을 한다. 폴더를 클릭하고 우측버튼을 눌러 팝업 창을 띄우면 전역변수 파일 생성 및 불러오기 항목의 메뉴가 나타난다. 

Add New Global Item은 새로운 전역변수 선언 파일을 생성하고 Add Existing Global Item은 이미 만들어진 전역변수 선언 파일을 불러온다. 만들어진 전역변수 파일에 변수를 추가 삭제하려면 파일명을 클릭하고 우측버튼을 누르면 저장 파일을 저장하고 변수를 추가하고 파일을 제거하는 메뉴가 나타나며 파일의 저장 및 제거는 확인 다이얼로그가 나타나며 사용자가 확인을 하면 실행된다. 

전역변수의 추가는 추가를 위한 새로운 다이얼로그 박스가 나타나는데 변수 형식을 선택하고 이름을 설정하고 Add버튼을 누르면 생성이 된다. 변수의 형식에는 “bool”, “int”, “float”, “double”, “wchar” 형식을 제공하며 사용자가 새로운 형식의 구조체를 등록할 수가 있다. 아래 그림에서는 “Color”와 “SD” 라는 형식의 구조체가 등록된 상태이다. 구조체 변수는 선택하면 우측 속성 창에 변수형식과 이름이 나타난다. 단일변수를 선택하면 우측 속성 창에 변수이름과 초기값이 보인다. 이렇게 선언된 변수는 라이브러리 및 그리기 객체의 스크립트에서 사용 가능하다.

Picture 관리는 프로젝트에서 사용되는 도면과 같은 기능을 제공한다. Picture의 생성은 Add New Picture Item은 새로운 그림 파일을 생성하고, Picture 파일의 이름을 입력하는 다이얼로그 박스가 나타나고 이름을 입력한 후 “Create” 버튼을 누르면 생성이 된다. 생성된 파일명으로 가운데 창에 그림 차이 생성이 된다. 생성된 그림 창에 그리기 기능을 통해 그리거나 편집하여 파일을 생성한다. 

Library 관리는 Picture에서 사용되는 객체 대한 Logic Symbol 및 HMI Symbol의 생성과 저장, 불러오기, 삭제 등과 같은 기능을 제공한다. Library의 생성은 New HMI Library Item 또는 Logic Library Item 으로 생성할 수 있으며, 생성된 Library는 각각 기능 및 이벤트 정의 후 Picture에서 사용할 수 있다.

Style 관리는 Picture에서 사용하는 색상이나 글꼴 등에 대한 것을 미리 정의 하고 그리기에서 사용할 수 있도록 한다. Add New Style Item을 선택하여 새로운 스타일 파일을 생성하거나 Add Existing Style Item을 선택하여 기존의 스타일 파일을 불러올 수 있다. Style File을 생성하고 생성된 파일을 마우스 우측 버튼을 클릭하여 팝업메뉴에서 Add Style을 선택하면 새로운 스타일을 생성하는 창이 나타난다. 

Add Style을 하여 스타일 이름을 설정하고 “New” 버튼을 눌러 적용한다. 스타일 트리에 새로운 이름의 스타일이 생성되고 새로 생성된 이름을 클릭하여 선택하면 우측 속성 창에 선택할 속성 창이 나타난다. Add style item 항목에서 적용하고자 하는 스타일을 선택한다. fill과 stroke를 선택하고 스타일 항목에서 변경M한 예는 다음과 같다. 

적용을 하기 위해 편집된 스타일을 저장한다. 스타일을 적용할 객체를 선택한다. 적용하고자 하는 스타일을 선택한다. Class에서 선택하여 적용하면 속성 창에서 적용한 fill 및 stroke는 변경되지 않고 Class에서 정의한 상태를 따라간다.

아래 그림은 Project Explorer에서 지원하는 기능을 나타낸 것이다.

enuSpace 그래픽 저작기 Undo Redo 기능

그래픽 편집기에서는 Undo(되돌리기) 기능과 Redo(다시하기)기능을 제공한다. Undo는 그래픽 편집기에서 편집행위를 한 것을 이전의 단계로 되돌리는 역할을 하며, 키보드 단축키는 “Ctrl + Z” 이다. 버튼을 한번 클릭할 때마다 한 단계씩 되돌아간다.

Redo는 Undo 단계에서 다른 편집 행위를 하기 전에 다시하기를 하여 이전에 했던 편집 작업을 다시 행할 수 있다. 키보드로는 “Ctrl + Y” 이고, 화면에서는 되돌리기 이전의 상태가 될 때까지 버튼을 한번 클릭할 때마다 한 단계씩 다시하기를 한다. Undo/Redo 버튼은 아래 그림과 같이 프로그램 좌측 상단에 위치해 있다.

아래 표는 그래픽 편집기에서 Undo/Redo 기능에 대한 단축키를 나타낸다

enuSpace professional 2016 기준

enuSpace 그래픽 저작기 확대 축소 기능(Zoom In/Out)

그래픽 편집기에서 제공하는 Zoom 기능은 프로그램 오른쪽 하단에 위치해 있으며, 아래 그림은 그래픽 편집기에서 제공하는 Zoom 기능에 대해 나타낸 것이다. 

그래픽 편집기의 Zoom 기능은 “-“, “+” 버튼을 클릭하여 Zoom Out, Zoom In을 할 수 있으며, 이들 버튼 사이에 슬라이드 바를 Drag하여 Zoom Out, Zoom In을 할 수 있다. Zoom In/Out 시 원 상태로 되돌리기를 원하면 “100%” 버튼을 클릭하면 원래 사이즈로 돌아온다.