기본 환경 설정하기 - 확장 기능 및 개발 설정 #1 Python (파이썬)

FreeCAD는 파이썬(Python) 기반으로 작동하기 때문에 사용자가 반복하는 작업을 매크로(스크립트)로 녹화하거나 실행할수 있습니다. 매크로는 유사하거나 반복적인 부품을 신속하게 생성해야 할 때 매우 유용합니다. 또한, AI를 활용하여 코드를 생성함으로써 사용자 정의 매크로를 쉽게 개발할 수 있습니다. 아래와 같이 매크로 환경 설정을 설명 합니다.

■ Macro

 

1. General Macro Settings (일반 매크로 설정)

• Run macros in local environment (로컬 환경에서 매크로 실행): * 체크하면 매크로가 사용자의 PC(로컬 시스템) 내부 자원과 환경을 사용하여 독립적으로 실행됩니다. 보안과 안정성을 위해 기본적으로 체크해 두는 것이 좋습니다.

2. Macro Recording Settings (매크로 녹화 설정)

• Macro Path (매크로 경로):
  • 내가 만든 매크로나 다운로드받은 매크로 파일(.FCMacro)이 저장되는 폴더 경로입니다.
  • 현재 C:/Users/korea/AppData/Roaming/FreeCAD/Macro로 지정되어 있으며, 오른쪽 ... 버튼을 눌러 원하는 다른 폴더로 바꿀 수 있습니다.
• Gui Commands (GUI 명령):
  • Record GUI commands: 체크하면 마우스로 아이콘을 클릭하거나 메뉴를 선택하는 등의 '화면(GUI) 조작'을 매크로 코드로 기록합니다.
  • Record as comment: 화면 조작 명령들을 실제 실행되는 코드가 아니라, 어떤 조작을 했는지 알아보기 쉽게 # 기호가 붙은 주석(Comment) 처리로 기록해 줍니다. (코드가 지저분해지는 것을 막아줌)

3. Logging Commands (로그 명령)

• Show script commands in Python console (파이썬 콘솔에 스크립트 명령 표시):
  • 매우 유용한 옵션입니다. 체크해 두면 FreeCAD에서 마우스로 패드를 만들거나 구멍을 뚫을 때, 그 동작에 해당하는 파이썬 코드가 프로그램 하단의 'Python console' 창에 실시간으로 출력됩니다. 나중에 매크로를 직접 짜거나 공부할 때 큰 도움이 됩니다.

 

4. Recent Macros Menu (최근 매크로 메뉴)

자주 쓰는 매크로에 빠르게 접근하기 위한 설정입니다.

• Size of recent macro list (최근 매크로 목록 크기):
  • FreeCAD 메뉴에 표시할 '최근 실행한 매크로'의 개수입니다. (현재 12개로 설정됨)
• Keyboard shortcut count (키보드 단축키 개수):
  • 최근 매크로 목록 중 상위 몇 개에 단축키를 자동으로 할당할지 정합니다. (현재 3개로 설정됨)
• Keyboard Modifiers (단축키 조합 키):
  • 위의 단축키를 누를 때 사용할 조합 키입니다. 현재 Ctrl+Shift+로 되어 있으므로, 최근 매크로 1, 2, 3번은 각각 Ctrl+Shift+1, Ctrl+Shift+2, Ctrl+Shift+3으로 바로 실행할 수 있게 됩니다.

 

---

■ General

FreeCAD 내부에서 파이썬 코드를 보여주고 실행하는 'Python console(파이썬 콘솔)' 창의 작동 방식과 관련된 옵션들입니다.

 

1. Console (콘솔 설정)

FreeCAD 하단에 있는 파이썬 콘솔 창의 텍스트 및 기록 관련 옵션입니다.

• Enable word wrap (자동 줄 바꿈 활성화):
  • 체크하면 콘솔 창에 출력되는 파이썬 코드가 너무 길어 창 오른쪽 끝을 벗어날 때, 가로 스크롤바를 만드는 대신 자동으로 다음 줄로 내려서(줄 바꿈) 보여줍니다. 가독성을 위해 체크해 두는 것을 추천합니다. (현재 체크 상태)
• Enable block cursor (블록 커서 활성화):
  • 체크하면 콘솔 창의 텍스트 입력 커서 모양이 일반적인 세로선(|) 모양에서 두꺼운 네모 블록(█) 모양으로 바뀝니다. 과거 DOS 시절이나 터미널 환경의 감성을 선호하는 사용자가 주로 켭니다.
• Save history (기록 저장):
  • 체크하면 파이썬 콘솔 창에 사용자가 직접 입력했던 명령어들의 기록(History)을 FreeCAD가 종료된 후에도 저장해 둡니다. 나중에 다시 켰을 때 키보드 방향키 위(↑)를 눌러 이전에 썼던 명령어를 쉽게 다시 불러올 수 있습니다.
• Python profiler interval (ms) (파이썬 프로파일러 간격):
  • 파이썬 스크립트가 실행될 때 프로그램의 성능(어느 코드에서 시간이 얼마나 걸리는지 등)을 모니터링하는 주기를 밀리초(ms) 단위로 설정합니다. 기본값(200ms) 그대로 두시면 됩니다.

 

2. Other (기타 설정)

• Path to external Python executable (optional) (외부 파이썬 실행 파일 경로 - 선택 사항):
  • FreeCAD는 기본적으로 내장된 파이썬 엔진을 사용합니다. 하지만 사용자가 PC에 별도로 설치한 다른 파이썬 버전이나 특정 라이브러리가 포함된 외부 파이썬 환경(python.exe 파일 경로)을 FreeCAD와 강제로 연동하고 싶을 때 여기에 그 경로를 지정합니다.
  • 특별히 외부 파이썬 라이브러리를 연동해 개발할 것이 아니라면 비워두는 것이 기본값이며 안전합니다.

 

---