Importing Python Modules in Blender: A Tutorial for Beginners

블렌더 사용자는 블렌더의 시스템 경로에 디렉터리를 추가하여 사용자 지정 및 외부 Python 모듈을 쉽게 가져올 수 있습니다.

### 블렌더에서 파이썬 모듈 및 패키지 임포트하기: 자세한 가이드
* 📌 **블렌더 내부**에서 작성한 파이썬 모듈을 다른 스크립트에서 불러오는 방법을 설명합니다.  'file_one' 모듈의 'my_function' 함수를 'file_two'에서 사용하려면, 'file_one' 파일의 전체 경로를 복사하여 `import file_one` 명령어를 사용합니다.  블렌더의 고유한 파일 구조 때문에 상대 경로 임포트는 작동하지 않습니다.
* 📌 블렌더의 파이썬 인터프리터를 통해 외부 패키지를 설치하는 것은 권장하지 않습니다. 관리자 권한이 필요하고 다른 사용자 환경에서 호환성 문제가 발생할 수 있기 때문입니다.
* 📌 대신, **수동으로** 외부 패키지를 설치하는 방법을 제시합니다.  `pip install --target "설치 경로"` 명령어를 사용하여 원하는 폴더에 패키지를 설치합니다.  예를 들어, Pillow 패키지를 설치하려면 `pip install Pillow --target "설치 경로"`를 사용합니다.  만약 오류가 발생하면 `pip install -m Pillow --target "설치 경로"` 명령어를 사용해 보세요.
* 📌 설치된 패키지를 블렌더에서 사용하려면, `sys.path.append()` 함수를 이용하여 블렌더의 **시스템 경로**에 설치 폴더를 추가해야 합니다.  예시 코드는 다음과 같습니다: `sys.path.append(r"설치 경로")`.
* 📌  **`PIL` (Pillow)** 과 **`cv2` (OpenCV)** 패키지를 예시로 사용하여,  `sys.path.append()`를 통해 시스템 경로에 추가 후 성공적으로 임포트하는 과정을 보여줍니다.
* 📌  결론적으로,  자신이 만든 모듈 뿐만 아니라 **외부 패키지**도  `--target` 플래그를 사용하여 특정 폴더에 설치하고, `sys.path.append()`를 통해 블렌더에서 접근 가능하도록 설정하는 방법을 제시합니다. 이 방법은 애드온 개발 시에도 유용하게 활용될 수 있습니다.

This is a tutorial for common folk who just want to use Python and aren't sure about importing their own code

or other people's code. It can get confusing. The first scenario is you've written some Python code; you have a very

special module, and you have some other script that you want to transfer that information to. We'll call one file 'file one',

we'll call the other 'file two'. Let's assume that in 'file one', we've written something super important, a definition called 'my

function'. What my function does is arbitrary. It's so arbitrary!

Importing 'file one' and running that doesn't know what 'file one' is. Okay, maybe it's a relative import: `from relative import this`. No.

The issue is that Blender's file structure is different from a normal directory because, in fact, we have two text files that live inside the blend file,

as you can see. So what you do is you right-click, copy the full data path. I'm going to make a module name, so I'm going

to say `file_one = this_text_file`. We don't actually need the name, and then you write `import file_one`. You wouldn't

believe how many workarounds people have on the internet for this instead of using this basic line. The only other

thing you need is to import Blender's Python. I run this, and now it runs fine. In fact, I could write `file_one.my_function()`.

I will run it. We can go to the system console; it says 'so arbitrary'. Now, the second scenario is you want to import

somebody else's code. What you might be tempted to do is... Blender has its own Python interpreter, so what I've seen

people do is they navigate over to Blender 4.2, 4.2 Python, and say, 'Okay,

Python, install some things.' It ends up going to this... this is just useless information, but it goes to the site...

Packages like this aren't very reliable because they require admin permissions, and if you make an add-on, you don't know if

it'll work on somebody else's computer. So the best course of action is to just do this manually.

I'm going to make a custom folder; I can literally just call it 'custom'. In fact, just copy this address. What do I

want you to do? I want you to `pip install` something like Pillow (that's the name of a package), and the key is you

want this `--target` flag, set equal to this path. So what this statement says is,

okay, we're going to import blah blah blah, but put it inside of this folder; target it to this folder. So if we were

trying to import Pillow (which goes by `PIL` if you're trying to import it)... there's no such thing. But now, when we install

this... no such file or directory. Okay, this is important: if it doesn't work for you, do this with `-m`, and now you're going to see

it's going to start installing, and it's in this folder. We're going to have Blender reference this directory. So

again, we installed into a folder, but then we say, 'Blender, you're allowed to look inside of this.' What I need to do is I

need to import `sys`. This means `sys.path.append`. I believe you have to do something like this, where you uh

do a string literal, put an `r` before it, and put your path inside of these quotation marks. So I run this; uh, you can

see it worked fine. But now the difference is, if I were to import `PIL`, let's try this again; now it can do it. So let's try

something that isn't there yet, so `cv2` for OpenCV... no such thing. And now I will install it, making sure to use this

target flag—very important—and now it's going to install OpenCV. And now, because this is already in the

System path. I run it, and it can actually execute that. Not only can we import our own things with the `as` module command,

but we can import other people's things by using a tertiary, uh, folder that you could even pack inside of an add-on.

You have a script where it then adds the relevant folder to their system path, which turns out to be pretty easy to do.

Importing Python Modules and Packages // Blender (no module named...)

Default Cube

자신이 작성한 Python 코드(file one)를 다른 스크립트(file two)에 적용하는 방법 설명

'file one'에 정의된 'my_function'을 'file two'에서 사용

Blender의 파일 구조가 일반 디렉토리와 다르다는 점을 강조하며, 상대 경로 임포트가 불가능함을 설명

Blender 내부 텍스트 파일의 전체 경로 복사 후 `import file_one`을 사용하여 모듈 임포트

Blender의 Python 임포트 후 `file_one.my_function()` 실행하여 결과 확인

Blender의 Python 인터프리터를 이용한 라이브러리 설치의 비효율성 및 문제점 지적 (관리자 권한 필요, 다른 시스템에서 작동 불가능성)

수동으로 라이브러리 설치 및 경로 추가를 권장

사용자 지정 폴더 생성 후 `pip install --target` 명령어를 사용하여 라이브러리 설치

`--target` 플래그를 사용하여 특정 폴더에 라이브러리를 설치하는 방법 설명

`sys.path.append`를 사용하여 Blender에서 사용자 지정 폴더를 참조하도록 설정

자체 모듈과 외부 라이브러리 임포트 방법 요약

애드온에 외부 라이브러리 포함 및 시스템 경로 추가 방법 설명