본문 바로가기
  • You find inspiration to create your own path !
업무 자동화/FreeCAD

FreeCAD] 파이썬 파일로 모델만들기 #1

by ToolBOX01 2025. 8. 30.
반응형

FreeCAD에서 Python 스크립트를 사용하여 모델을 만드는 것은 매우 강력한 기능입니다. 환경 설정은 간단하며, FreeCAD 내에서 직접 스크립트를 작성하고 실행할 수 있습니다.

1. FreeCAD 내에서 Python 스크립트 실행하기

가장 기본적인 방법이며, FreeCAD에 내장된 Python 콘솔 또는 매크로 에디터를 사용하는 것입니다.

A. Python 콘솔 사용:

  • FreeCAD를 실행하고, 상단 메뉴에서 **보기(View) -> 패널(Panels) -> Python 콘솔(Python Console)**을 클릭하여 콘솔을 엽니다.
  • 콘솔 창에서 직접 Python 코드를 입력하고 엔터를 누르면 즉시 실행 결과를 확인할 수 있습니다.
  • 간단한 명령어를 테스트하고 객체의 속성을 조작하는 데 유용합니다.

[ Python 콘솔 ]

 

편집 → 환경설정 → 파이썬 → 매크로에서 "파이썬 콘솔에 스크립트 명령 표시" 옵션을 켜면, FreeCAD에서 마우스로 하는 작업이 파이썬 코드로 콘솔에 기록돼요. 콘솔을 열어놓고 작업하면 코드가 어떻게 만들어지는지 실시간으로 볼 수 있어서 파이썬을 배우는 데 큰 도움이 됩니다!

 

B. 매크로 에디터 사용:

매크로(Macro) → 매크로(Macros) → 만들기(Create)를 선택하면 매크로 에디터가 열립니다. 이 에디터는 여러 줄의 복잡한 코드를 작성하고 저장하는 데 사용됩니다. 작성된 코드는 하나의 파일(매크로)로 저장되며, 나중에 언제든지 매크로 창에서 선택해 한 번에 실행할 수 있습니다. 반복적인 작업을 자동화하거나 FreeCAD의 기능을 확장하는 데 매우 강력한 방법입니다.

  • 새로운 창이 열리면 여기에 Python 코드를 작성하고 저장합니다.
  • 저장된 매크로는 ~/.FreeCAD/Macro (Linux), C:\Users\<user>\AppData\Roaming\FreeCAD\Macro (Windows) 등 FreeCAD의 매크로 폴더에 저장됩니다.
  • 작성된 매크로는 매크로 실행(Run macro) 창에서 선택하여 실행할 수 있습니다.

Introduction to Python - FreeCAD Documentation

 

Oh noes!

Protected by Anubis From Techaro. Made with ❤️ in 🇨🇦. Mascot design by CELPHASE. This website is running Anubis version 1.22.0-pre1-6-gc661bc3.

wiki.freecad.org

 


▣ Python 콘솔 예시

[자동 완성 창]

1. 파이썬 콘솔창 실행

FreeCAD의 파이썬 콘솔에서 FreeCAD. (FreeCAD 뒤에 점)을 입력하면 자동 완성 창이 나타나요. 이 기능은 작업 속도를 높여줄 뿐만 아니라 FreeCAD에서 사용할 수 있는 명령어와 기능을 빠르게 찾도록 도와줍니다.자동 완성 목록의 각 항목에는 툴팁이 있어서 해당 기능이 뭘 하는지 설명해줍니다. 이건 특히 파이썬 초보자나 FreeCAD의 방대한 API(프로그래밍 인터페이스)를 탐색하는 고급 사용자에게 아주 유용합니다.

>> FreeCAD.newDocument()

파이썬 콘솔창에 FreeCAD.newDocument()를 입력하면 FreeCAD에서 새롭운 빈 문서를 만듭니다. 이건 툴바에서 새 문서" 버튼을 클릭하는 것과 같은 효과입니다. 만약 doc = FreeCAD.newDocument()라고 입력하면, 새로 만든 문서가 doc이라는 변수에 저장됩니다.. 이 변수를 사용하면 프로그래밍으로 문서를 조작할 수 있습니다. 예를 들어, doc을 이용해 객체를 추가하거나, 속성을 변경하거나, 문서를 저장할 수 있습니다.

2. 파이썬에서 점(.)의 역할

파이썬에서 점(.)은 한 요소가 다른 요소 안에 포함되어 있음을 나타냅니다. 예를 들어, newDocument는 FreeCAD 모듈 안에 있는 함수라서 FreeCAD.newDocument라고 씁니다. FreeCAD. 뒤에 점을 찍으면 자동 완성 창에 FreeCAD 모듈 안의 모든 기능이 표시됩니다. 만약 newDocument 뒤에 점을 찍으면 (괄호 없이), newDocument 함수에 속한 내용이 표시됩니다 이건 파이썬이 객체와 그 안의 구성 요소를 어떻게 조직하고 접근하는지를 보여줍니다. 중요한 점은, 파이썬에서 함수를 실행하려면 괄호()를 꼭 써야 한다는 겁니다. 괄호는 함수를 실행하라는 신호입니다.

예시: 

doc = FreeCAD.newDocument()

대소문자를 인식 합니다.
doc는 변수 입니다.

[자동 완성창]

doc.을 입력하면 자동 완성 창에 doc 객체에서 사용할 수 있는 함수와 속성들이 나타납니다. 예를 들어:

  • doc.addObject(): 문서에 새로운 객체(예: 상자, 원, 선 등)를 추가할 수 있음.
  • doc.saveAs(): 문서를 특정 이름으로 저장할 수 있음.
  • doc.Objects: 문서에 포함된 모든 객체 목록을 볼 수 있음.
>>doc = FreeCAD.newDocument()
>>doc.addObject("Part::Box", "myBox") # 이 코드는 "myBox"라는 이름의 상자를 문서에 추가합니다.
>>doc.saveAs("C:/Users/YourUsername/Documents/myFile.FCStd")

 

by korealionkk@gmail.com


반응형