1. 기능 개요

• 메시지 대상 윈도우 클래스명: TFrmKalmuri

• 메시지 유형: WM_COPYDATA (0x004A)

• 데이터 형식(JSON):

  {"command": "capture"}

• 지원 명령

  • "capture" : 캡처 실행
  • "about" : 프로그램 정보창 표시

현재는 위 두 가지 명령만 지원하지만,
향후 버전에서 다양한 명령어를 추가할 예정입니다.

2. Python 예제 코드

아래 코드는 Python에서 WM_COPYDATA 메시지를 보내 캡처를 트리거하는 간단한 예시입니다.

import ctypes, json
from ctypes import wintypes

user32 = ctypes.WinDLL("user32", use_last_error=True)
WM_COPYDATA = 0x004A

class COPYDATASTRUCT(ctypes.Structure):
    _fields_ = [("dwData", wintypes.LPARAM),
                ("cbData", wintypes.DWORD),
                ("lpData", wintypes.LPVOID)]

# 전송할 데이터
data = json.dumps({"command": "capture"})
buf = ctypes.create_unicode_buffer(data)
cds = COPYDATASTRUCT(1, len(data.encode('utf-16le')), ctypes.cast(buf, wintypes.LPVOID))

# Kalmuri 윈도우 찾기
hWnd = user32.FindWindowW("TFrmKalmuri", None)

if hWnd:
    r = user32.SendMessageW(hWnd, WM_COPYDATA, 0, ctypes.byref(cds))
    print("전송 완료" if r == 1 else f"실패 (결과: {r})")
else:
    print("창을 찾을 수 없습니다.")

Python 3 이상 환경에서 실행하면
칼무리가 실행 중일 때 즉시 캡처가 동작합니다.

3. 배치파일에서도 간단하게 사용하기

파이썬 환경이 없는 경우를 위해
WM_COPYDATA 메시지를 직접 전송하는 경량 실행파일(kalmuri_cmd.exe) 을 제공합니다.

사용 방법

kalmuri_cmd.exe

실행 즉시 칼무리의 캡처 기능이 호출됩니다.

첨부 파일

• kalmuri_cmd.c — 순수 WinAPI 기반 소스 코드
• kalmuri_cmd.exe — 컴파일된 실행 파일 (약 4KB)

5. 마무리

칼무리의 캡처 기능은 이제 외부 스크립트나 자동화 환경에서도 제어할 수 있습니다.
배치 스크립트, 작업 스케줄러, 또는 다른 프로그램과 연동해
자동 캡처 및 후속 작업을 자유롭게 구성할 수 있습니다.

앞으로도 외부 명령을 확장하여
더 다양한 자동화 환경에서 활용할 수 있도록 지속적으로 개선하겠습니다.

감사합니다.