SolidWorks Scripting: Python, Macros, and Visual Basic Tutorial

Python 스크립팅을 통해 SolidWorks 사용자는 작업을 자동화하고 생산성을 향상시킬 수 있습니다.

### 솔리드웍스 Python 스크립팅: 매크로, Visual Basic 및 Python 연결
* 👨‍💻 이 비디오는 솔리드웍스에서 Python을 사용한 스크립팅 시리즈의 두 번째 강의로, 매크로, Visual Basic, 그리고 Python과 솔리드웍스 연결 방법을 다룹니다.
* 🖱️ 솔리드웍스 매크로 레코딩, 실행, 생성, 편집 기능을 설명하고, 사용자 지정 도구 모음에 매크로 버튼 추가 방법을 보여줍니다.  **Visual Basic 코드**는 매크로 레코딩을 통해 생성되며, 이를 Python 코드로 변환하는 과정을 보여줍니다.
* 💡 Visual Basic의 기본 개념인 `Dim` (변수 선언), `Sub Main` (메인 함수), `Set` (값 설정)을 설명하고, SolidWorks API 헬프를 활용하여 매크로 함수 사용법을 배우는 방법을 제시합니다.  특히, **API 헬프의 예제 코드**를 활용하는 것을 강조합니다.
* 🐍 Python에서 SolidWorks API를 제어하기 위해 `win32com.client` 와 `pythoncom` 라이브러리를 import하고, Visual Basic 코드를 Python 코드로 변환하는 방법을 단계별로 시연합니다.  **Python 코드**는 Jupyter Notebook을 사용하여 작성됩니다.
* ⚙️ Python 코드를 통해 솔리드웍스에서 프런트 플레인 선택, 스케치 생성, 원 생성, 스케치 닫기 등의 작업을 자동화하는 방법을 보여주고,  `pythoncom.Nothing`을 사용하여 Visual Basic의 `Nothing` 변수를 대체하는 방법을 설명합니다.
* ⚪ Python 코드에서 원 생성 함수 (`CreateCircle`)의 매개변수 (중심 좌표, 반지름 정의 점 좌표)를 설명하고,  **API 헬프를 참고하여 매개변수 값을 설정**하는 방법을 강조합니다.  단위는 미터임을 명시합니다.
* 🔄  Visual Basic 코드를 Python 코드로 변환하는 과정을 통해,  **두 언어 간의 코드 변환 방법**을 상세히 보여줍니다.  변수 선언의 차이점을 포함하여, 각 코드 라인의 기능을 자세히 설명합니다.
* 总结  본 강의에서는 매크로 활용법, Visual Basic 기초, Python과 SolidWorks 연결 및 간단한 원 생성 코드 작성법을 통해 Python을 이용한 SolidWorks 자동화의 기초를 다룹니다.

Hi guys, welcome back to my channel. This is a series of videos about SolidWorks scripting using Python. In this video, I'm going to talk about

macros, Visual Basic, and how to connect SolidWorks to Python. Okay, let's start.

I'm going to start a new part, and first of all, I'm going to talk about macros. If you have the macro here, you can use it.

But if you don't have it, you can go to Tools, and here in the Macros, we have different options here, such as Run,

Record, New, and Edit. But personally, I don't like to open the Tools menu and then

go to the Macros section and then start it. So if you come here to Customize in the toolbar menu and scroll down, you can see the Macros

here. So if you check this box, you can have the Macros on your SolidWorks main page. Okay, I'm going to explain

each button here. First, we have Record or Pause Macro. By using this button, you can start recording your actions and do whatever you want in SolidWorks.

The Stop Macro stops the recording, and the Run button can run the previous macro you have recorded. For example, I have a macro here which I can run now.

Okay, we have the New Macro button, which creates a page for you that you can write your own code there from scratch, and we have the Edit Macro, that you can edit your

previous macros. Okay. If I click the Record Macro,

now SolidWorks is recording my actions. I click on the front plane. I create a new sketch and I just want to create a simple circle.

And then I'm going to exit from the sketch. Now I have a very simple circle in my SolidWorks.

Okay, I'm going to stop the macro and I'm going to save it with the name, for example,

Macro3, and just click Save. And now my macro is saved. So I'm going to delete this sketch and I just

I want to know if the macro is working. So, if I click "Run Macro", open my macro, you can see that SolidWorks automatically creates a circle for me on the front plane.

I'm going to delete this sketch once more and I'm going to show you how to edit the macro.

I'm going to open the macro again. Okay, here we are in the Visual Basic

programming language, and all of these codes are written in the VB programming language. In this tutorial, we are going to translate VB code to Python code.

So you need to be familiar with coding and, besides that, know a little about the Visual Basic. It is very simple, and I'm going to

explain it now. In Visual Basic, we have something called "Dim." This is like defining new variables.

We have it, for example, in C++, but we don't have it in Python.

In Python, we don't define the variables in our program. Okay, this is "Dim," you need to know about it.

For example, you can see here in SolidWorks, or in the Visual Basic, SolidWorks defines `swApp` or

SolidWorksApp as an object and, for another example, `boolstatus` as a Boolean. So these are different kinds of variables we have in Visual Basic.

Okay, the next is "Sub" or "Sub Main," which is the main part of our program.

It's like a function in Python and other programming languages. With `Sub Main`, we are going to create a new section and we are going to put our codes here, and at

the end we need to write "End Sub." The next is "Set." "Set" is used to set the value of a property.

For example, here `swApp` is equal to `application.Solidworks`. And we have other lines here. For example, "Set parts = swApp.ActiveDoc"

And this is all you need to know about Visual Basic. The rest of it is very easy, and even if you are a beginner in programming, you

I can easily translate these Visual Basic codes into Python. Okay, I'm going to show you the API help.  There are some documents in the SolidWorks guide for using the Macro API in SolidWorks. So, if you click the help button and then click API help,

you can see the API help, which explains all of the things you can do with macros in SolidWorks. You just need to click the index, and you will be able to search. For example, I'm going to search for "extrude," and when I enter it, I can see everything related to extrude macros in SolidWorks.

And the most important part of this page is the examples. For example, we are going to click this one because we are coding in Visual Basic, and it's easier

to translate it to Python code. If I click it, you can see here a very good example

of how to use extrude using macros in SolidWorks. And here you can see what these codes do. For example, you can read line by line: open a new

part document, and so on. And you can see here we have some "Dims" defining some

parameters, a "Sub main," and here we can see a lot of code related to how to

extrude a part. Okay, now we are familiar with macros, we are familiar with Visual Basic, and

now we can go to Python and start coding in the Python programming language. Personally, I prefer to use Jupyter Notebook because

in my experience, it's easier to manage my code, so I'm going to use Jupyter Notebook in this tutorial.

Okay, I'm going to create a new file. I'm going to name it "getting_started.ipynb".

I'm going to enter it. Now, I have a very nice page to write my code to control the SolidWorks API.

Okay. First of all, we need to use some additional libraries in Python to be able to control SolidWorks. So I'm going to import them.

The first one is "win32com.client". Okay, I'm going to run with "Ctrl+Enter".

So I have this library, and if you don't have this library or other libraries that I will use, you can simply download and install them using "pip".

Okay, the other one is "pythoncom", and I'm going to run it, and everything is okay now.

Okay, I have imported all of the necessary libraries that I needed. So I'm going to just write some code that connects Python to SolidWorks.

I'm just going to paste them here, and I'm going to look at the Visual Basic code. I'm not going to copy this part of the code because

we do not need to define any variables in Python. So I'm just going to copy this part of the code in the Sub main,

"Ctrl+C", and I'm going to paste them here, and I will explain each of them line by line.

This block of code is the code I'm going to write, and this block of code

is the code that I brought from Visual Basic. In the first line, we can see here "swApp = Application.SldWorks".

This is the part where we can actually control SolidWorks through code, and we do not have it in Python directly.

So I'm going to use "win32com.client", and blah, blah, blah. I'm going to write "SLDWORKS.Application". And after that, for the

second line here, we have "Set part = swApp.ActiveDoc". This means we are going to work on the active document,

because in SolidWorks we have a lot of documents available. For example, I can just create another part. And now I have two documents, and Python

doesn't know which one I want to work with, so I'm going to just close Part 8.

And here in the second line, I'm going to say "part = swApp.ActiveDoc". So I'm going to delete this code and be sure

I'm going to run my libraries and then this block of code. Okay, you can see it runs perfectly and smoothly. I'm going to create

another section or another block to write my code here and not run this part again and again. This part is responsible to connect Python to Solidworks, so I don't

need to run it every time; I just need to run a block of code which creates a simple circle for me.

For this line, I'm going to just cut and paste it here.  `boolstatus` is a boolean variable that shows whether this line runs correctly or not.

This means it will go and select things for me, which can be anything, and in this

case it will be the front plane. So, front plane, and it has some default variables. I'm not going to go into detail about what these are; you can

see it in the API help, but we have something here called "Nothing." "Nothing" is a

variable in Visual Basic that we don't have in Python, so I'm going to delete it and

instead I'm going to use `pythoncom.Nothing`, and you can see it will work

perfectly and smoothly. Okay, I'm going to manage my windows to show you how these codes work, and for

the start, they are connected. Python is connected to Solidworks. So, I'm

just going to run this code, this block of code that will select the front plane.  [Ctrl+Enter] You can see it selected the front plane for me. Okay, for the next

lines, I'm going to translate them directly into Python. I'm going to cut this one and paste it here, and this code just creates

a sketch for me, and I'm going to translate it into Python. So, `True` goes inside the parentheses.

And if I run it another time, you can see that a new sketch is created for me in

SolidWorks. I'm going to delete that because I don't need it. Okay, in the next line, I'm going to translate it here.

It will clear the selection for me if I run it. Here you can see that the front plane

was selected, but now it cleared my selection. Now I'm going to delete this line because we don't define any variables in Python. Okay, for the next

line, I'm going to cut it and place it here like this. Okay, I'm going to delete "Set"

and I'm going to delete this symbol. This is a function that creates a circle. I'm going to delete our previous sketch

and this is a line, or this is a function that creates a circle. I'm going to explain each parameter to you,

but it is better to go to API help and see what this create function does for us

because sometimes you're going to face new functions; you don't know what its parameters do, so go to API help.

I copy "CreateCircle" and I'm going to paste it here and enter it. We have

different "CreateCircle" methods; one is under "ModelDoc", another is under "ModelDoc2",

and another one is under "SketchManager". We can see here our "CreateCircle" is under "SketchManager".

So I'm going to enter or click this one: "CreateCircle Method" under "SketchManager".

We can see here Visual Basic, and it's going to talk about how to define our variables and about the parameters that are available

for this method: xc, yc, zc, xp, yp, and zp. And we have here the most important

part: parameters. It explains what each parameter does for us. So, for example, "xc" is the x-coordinate of the center in meters, and

example here
"xp" is the x coordinate of the point on the circle. This means that by using xp, yp, and zp, SolidWorks will calculate the radius of the circle.

So, the first three parameters are the coordinates of the center of the circle; all of them are 0, 0, and 0. The next three are the x, y, and z coordinates of a point that defines the radius

of the circle. I'm just going to show you how to create a circle with a radius of

0.02 meters, which is equal to 20 millimeters. So here I'm just going to write this code, and for the

next three lines, I'm just going to cut and paste them here and translate them into Python.

This line will clear my selection and close the sketch.  In the end, it clears my

selection again to ensure that I haven't selected anything else. I'll manage the windows so you can see how fast and smooth SolidWorks is

at creating a circle. I'm just going to run this block of code. You can see it selects the front plane, creates a new sketch,

draws a circle, and then closes the sketch. I'm going to check the radius of the circle.

And you can see the radius of the circle is 20 mm. As I showed you in the document, these numbers are in meters, not

in millimeters, so be aware that you need to convert millimeters to meters or meters to millimeters.

Okay, I'm going to exit this sketch and save it.

SolidWorks scripting with Python 02 - Macro, Visual Basic, and Python

RoboMech Minds

SolidWorks 매크로 및 Visual Basic 소개

SolidWorks 매크로 사용법 및 위치 설명 (Tools > Macros)

도구 모음에 매크로 버튼 추가 방법

매크로 녹화, 일시 정지, 실행 및 중지 기능 설명

새 매크로 생성 및 기존 매크로 편집 방법

Visual Basic 코드 구조와 주요 요소 설명 (Dim, Sub Main, Set)

SolidWorks API 헬프 활용 및 Visual Basic 코드 분석

SolidWorks API 헬프 접근 방법 및 검색 기능 설명

API 헬프를 이용한 'extrude' 기능 예제 코드 분석

Visual Basic 코드의 각 라인 설명 (새 파트 문서 열기 등)

Python을 이용한 SolidWorks 스크립팅

Jupyter Notebook을 이용한 Python 코드 작성 환경 설정

필요한 Python 라이브러리 import (win32com.client, pythoncom)

Python과 SolidWorks 연결 코드 작성 및 설명

Visual Basic 코드에서 Python 코드로 변환하는 과정 설명

Python 코드를 이용한 간단한 원 생성 과정 설명

Python 코드를 이용한 전면 평면 선택 및 스케치 생성

API 헬프를 활용한 CreateCircle 함수 매개변수 설명 및 사용

완성된 Python 코드 실행 결과 확인 및 원의 반지름 확인

매크로 사용법, API 헬프 활용법 요약

Visual Basic에서 Python으로 코드 변환 방법 요약

Python을 이용한 SolidWorks 연결 및 원 스케치 생성 과정 요약