gimp

13.3.4.6. 스크립트를 등록하는 과정(Steps For Registering The Script)

코드 13.3.4.6.a1. script-fu-register 예시

(script-fu-register
  ;스크립트의 진입점 함수의 이름(entry-point function name)
  "script-fu-text-box"

  ;메뉴 라벨(menu label)
  "Text Box"

  ;스크립트 설명(description)
  "Creates a simple text box, sized to fit\
    around the user's choice of text,\
    font, font size, and color."

  ;스크립트 작성자(author)
  "Michael Terry"

  ;저작권 알림(copyright notice)
  "copyright 1997, Michael Terry;\
    2009, the GIMP Documentation Team"

  ;작성일(date created)
  "October 27, 1997"

  ;스크립트가 동작하는 이미지 타입(image type that the script works on)
  ""

  ;프롬프트의 사용자 입력 문자열 변수(a string variable)
  SF-STRING      "Text"          "Text Box"

  ;프롬프트의 사용자 입력 글꼴(a font variable)
  SF-FONT        "Font"          "Charter"

  ;프롬프트의 사용자 입력 글꼴 크기(a spin-button)
  SF-ADJUSTMENT  "Font size"     '(50 1 1000 1 10 0 1)

  ;프롬프트의 사용자 입력 색상(color variable)
  SF-COLOR       "Color"         '(0 0 0)
)

GIMP(김프)에 스크립트를 등록하기 위해서는 script-fu-register 함수를 호출해야 합니다. 스크립트 등록을 위해 script-fu-register에게 매개변수(parameter)로 줄 2개의 필수 파라미터와 5개의 선택 파라미터를 스크립트에 추가해야 합니다. 파라미터는 아래와 같습니다.

1. 스크립트의 진입점 함수의 이름(entry-point function name)(필수)

스크립트가 호출될 때, 실행되는 진입점(entry-point) 함수의 이름입니다. 스크립트 안에는 이 함수 외에도 다른 함수를 추가적으로 정의할 수 있으므로, GIMP(김프)에게 진입점이 되는 함수의 이름을 알려주어야 합니다.

코드 13.3.4.6.a2. script-fu-register 예시 - 함수 이름

(script-fu-register
  ;스크립트의 진입점 함수의 이름(entry-point function name)
  "script-fu-text-box"
  …
)

함수 이름은 프로시저 브라우저 대화상자에서도 확인할 수 있습니다.

그림 90.4.98.a111.1. 프로시저 브라우저 대화상자 - 추가한 스크립트 - 함수 이름 (Windows) (우리말)

90-04-98-a111-01

2. 메뉴 라벨(menu label)(필수)

메뉴 라벨은 이미지 메뉴 바의 메뉴에서 보여지는 이름입니다. GIMP(김프) 2.10 버전 이전에는 메뉴 라벨에 메뉴의 위치를 직접 지정해야 했었습니다. 하지만 GIMP(김프) 2.10 버전부터는 메뉴의 위치는 script-fu-menu-register 함수의 두번째 매개변수(parameter)로 넘기도록 바뀌었습니다. 참고로 메뉴의 위치를 설정하는 방법은 13.3.4.9. 메뉴 위치 등록하기(Registering the Menu Location)에서 확인할 수 있습니다.

코드 13.3.4.6.a3. script-fu-register 예시 - 메뉴 라벨

(script-fu-register
  …
  "Text Box"                                  ;메뉴 라벨(menu label)
  …
)

3. 스크립트 설명(선택)

스크립트에 대한 설명입니다.

코드 13.3.4.6.a4. script-fu-register 예시 - 스크립트 설명

(script-fu-register
  …
  "Creates a simple text box, sized to fit\
    around the user's choice of text,\
    font, font size, and color."              ;스크립트 설명(description)
  …
)

프로시저 브라우저 대화상자에서 이 설명을 확인할 수 있습니다.

그림 90.4.98.a111.2. 프로시저 브라우저 대화상자 - 추가한 스크립트 - 함수 설명 (Windows) (우리말)

90-04-98-a111-02

이미지 메뉴 바의 메뉴 위에 마우스 포인터가 올라가면, 이 설명을 확인할 수 있습니다.

그림 13.3.4.6.a5. 메뉴 위에 마우스 포인터 호버되면 스크립트 설명이 보입니다

90-04-98-a121-focus-tooltip

4. 스크립트 작성자 이름(선택)

스크립트 작성자의 이름입니다.

코드 13.3.4.6.a5. script-fu-register 예시 - 스크립트 작성자 이름

(script-fu-register
  …
  "Michael Terry"                             ;스크립트 작성자(author)
  …
)

프로시저 브라우저 대화상자에서 이 설명을 확인할 수 있습니다.

그림 90.4.98.a111.3. 프로시저 브라우저 대화상자 - 추가한 스크립트 - 스크립트 작성자 (Windows) (우리말)

90-04-98-a111-03

5. 저작권 알림(선택)

스크립트의 저작권 알림 정보입니다.

코드 13.3.4.6.a6. script-fu-register 예시 - 저작권 알림

(script-fu-register
  …
  "copyright 1997, Michael Terry;\
    2009, the GIMP Documentation Team"        ;저작권 알림(copyright notice)
  …
)

프로시저 브라우저 대화상자에서 이 설명을 확인할 수 있습니다.

그림 90.4.98.a111.5. 프로시저 브라우저 대화상자 - 추가한 스크립트 - 저작권 알림 (Windows) (우리말)

90-04-98-a111-05-focus-copyright

6. 작성 날짜와 버전 정보(선택)

스크립트의 작성일과 마지막 버전 정보입니다.

코드 13.3.4.6.a7. script-fu-register 예시 - 작성 날짜와 버전 정보

(script-fu-register
  …
  "October 27, 1997"                          ;작성일(date created)
  …
)

프로시저 브라우저 대화상자에서 이 설명을 확인할 수 있습니다.

그림 90.4.98.a111.4. 프로시저 브라우저 대화상자 - 추가한 스크립트 - 스크립트 작성일 (Windows) (우리말)

90-04-98-a111-04

7. 스크립트가 동작하는 이미지 타입(선택)

스크립트가 동작하는 이미지 타입입니다. 선택할 수 있는 값은 다음과 같습니다. 선택하지 않으면 스크립트가 모든 타입에서 동작하는 것으로 설정됩니다.

코드 13.3.4.6.a8. script-fu-register 예시 - 스크립트가 동작하는 이미지 타입

(script-fu-register
  …
  ""                                          ;스크립트가 동작하는 이미지 타입(image type that the script works on)
  …
)

다른 페이지로 가기

➡️ 다음: 13.3.4.7. 스크립트의 매개변수를 등록하기(Registering The Script’s Parameters)

⬅️ 이전: 13.3.4.5.1. 작업중인 스크립트

⬆️ 위: 13.3.4. 첫번째 Script-Fu 스크립트(Your first Script-Fu script)

⬆️ 위: 13.3. Script-Fu 튜토리얼(A Script-Fu tutorial)

⬆️ 위: 13. 스크립팅(Scripting)

🏠 홈

원문