자주하는 질문

From FreeCAD Documentation
This page is a translated version of the page Frequently asked questions and the translation is 43% complete.

여기서는 FreeCAD 관련한 가장 흔한 질문에 대해 답하려고합니다. FreeCAD 관련 문제 또는 질문이 있으면, 먼저 아래의 문답을 확인해 보세요. 그 다음 특정 질문에 대한 답을 찾을 수없는 경우 FreeCAD 포럼에 가 보세요!

프로그램 설치

FreeCAD를 내 컴퓨터에 설치하는 가장 쉬운 방법은?

If you are on Windows or macOS, the simplest way is to head to the Download page, where you'll find several ready-to-install packages. If you are on Debian, Fedora or Ubuntu and some other distributions, FreeCAD is already included in the standard software repositories and you can simply install it with the software manager. On Ubuntu, the FreeCAD team also maintains its own PPA repositories. For further details about installation, refer to the installing page for your operating system (Windows, Linux or Mac).

FreeCAD 실행을 위해 필요한 조건은?

In contrast to most 3D CAD software, FreeCAD can run smoothly on the most modest computers - it's been known to run on Pentium IV and Intel Core2 Solo CPUs. If your computer is running a current operating system, chances are FreeCAD will run. The only prerequisite is that your graphics card or chipset must support OpenGL, preferably no older than v2.0. In case of problems, refer to the Troubleshooting section of this FAQ.

Multithreading

FreeCAD's underlying geometric modeling kernel, the OpenCASCADE Technology (OCCT) third-party library, has only partial multi-threading support at this time. See the multithreading page for more details.

FreeCAD를 내 스스로 컴파일하려면?

The source code of FreeCAD is always available in the project source code repository. Compiling FreeCAD yourself allows you to use the most recent features being developed, but requires a bit of computer knowledge, although the procedure is fairly simple. Access to the source code is explained here, and we have detailed instructions for compiling on Windows, Linux and macOS.

FreeCAD가 나에게 어떤 모듈이나 응용프로그램이 없다고 합니다

FreeCAD depends on a lot of things to offer all its functionality. All the main required components are usually bundled within your FreeCAD installation or provided by your package manager, so normally you have nothing to worry about. If you installed FreeCAD from unofficial sources, however, or compiled FreeCAD yourself, some piece might be missing, which is not critical to FreeCAD itself, but might cause some functionality to be unavailable. Some specific file formats such as Collada or DWG also require extra components, which cannot be bundled into FreeCAD, and must be installed by yourself separately.

All those components and the appropriate way to install them are listed on the Extra python modules page.

문제 해결

특정 OS관련하여 알려진 문제들

Find known OS-specific issues on this forum thread

FreeCAD가 시작되지 않습니다

There might be a lot of reasons for that, the most likely is that some library is missing. Try starting FreeCAD from a terminal (type freecad at a terminal prompt, FreeCAD on some systems) to see if some error message appears. Also, read the rest of this FAQ as it can give you more clues to detect the cause of the problem. If nothing helps, tell about it on the forum, there will surely be someone who can help.

On some older Windows XP systems you may get an error message like this: The application can't start, because the side-by-side configuration is wrong. The reinstallation of the application may solve the problem. The reason for this problem is that on your system either the CRT runtime libraries are missing or the version installed is too old because FreeCAD was linked against a newer version. In this case you have to install the Microsoft Visual C++ Redistributable Package which you'll find at Microsoft. See also the corresponding forum message.

FreeCAD가 정상적으로 시작은 되었는데 모든 아이콘들이 보여지지 않고 일부는 'X'로 표시됩니다.

Some parts of FreeCAD depend on an external Python module called Pivy. On Windows, pivy is included in the FreeCAD installation. On Debian/Ubuntu systems, the python-pivy package is part of standard software repositories. On other systems, at the moment, you might have to compile pivy yourself. Note that although some tools are not available without pivy, the rest of FreeCAD works normally.

I have display problems, the 3D view doesn't behave correctly, there is garbage when I move/rotate the view, etc.

FreeCAD depends on OpenGL for displaying 3D contents, and therefore requires a working OpenGL environment. On some systems, OpenGL is not activated by default, and you might need to install or upgrade your graphics drivers. This problems happens most often on Linux systems or on virtual systems. If you are on a Linux-based system, try the following steps:

  • verify that your computer has a 3D-capable graphics board
  • type glxinfo in a terminal window, and check in the output that Direct Rendering is set to "yes", and that the OpenGL vendor/renderer/version matches your graphics card.
  • install other OpenGL-based software (Blender, for example) and check if it runs and displays correctly.

FreeCAD가 시작할 때 충돌합니다

A crash might indicate a more serious bug, or some problem in your configuration. Most startup crashes occur because of one of the two following reasons:

OpenGL 드라이버가 설치되지 않음, 또는 제대로 정상적으로 작동하지 않습니다

This is a very common cause of the problem. The symptoms are simply that FreeCAD crashes at startup, or whenever you open a 3D view (for example by creating a new document). Try to find out what your graphic chip is, then find out if it supports OpenGL (most recent chips do), then find the correct driver and install it. A good way to doublecheck if OpenGL is available is to try to run another OpenGL application such as blender.

And as a general tip to get some more information about crashes with FreeCAD you can start it with the program parameter --write-log. This will create the file FreeCAD.log in $XDG_CONFIG_HOME/FreeCAD (version 0.20 and above) or $HOME/.FreeCAD (version 0.19 and below) on Linux, or $HOME/Library/Preferences/FreeCAD on macOS, or %APPDATA%/FreeCAD on Windows systems.

In some rare cases you may have a graphic driver installed that doesn't fit to your graphic card. We had a case where the user's laptop had an Intel on-board graphic but some ATI drivers were installed. Refer to forum thread in German FreeCAD startet nicht. After removing the files and re-installing the correct driver FreeCAD started to work.

FreeCAD에 필요한 어떤 라이브러리가 컴퓨터에 없거나 FreeCAD가 그것을 찾지 못했습니다

There can be two paths to this problem: either some library is simply missing, therefore FreeCAD will refuse to start, or the library is there, but it is an older version than the one FreeCAD expects, so a crash will occur when FreeCAD attempts to use a missing feature from that library. A common example is when you have Qt3 and Qt4 installed on your system, FreeCAD might detect Qt4 but if your Qt installation is not properly configured, some pieces of Qt3 might still be used, provoking crashes.

Please review the installing procedure (Windows, Linux or Mac), make sure you installed all the required libraries (on most linux systems this is done automatically), and check what is the minimum version number for each of the components.

If everything seems correct, describe the problem on the forum or submit a bug. If you are on a linux system, it is easy to do a debug backtrace, which provides very useful information about the crash to the developers:

  • in a terminal, type: gdb freecad (assuming package gdb is installed)
  • inside gdb, type run
  • after the crash, type bt to get the backtrace, that you can include in your bug report.

FreeCAD가 시작할 때 멈춥니다

When starting FreeCAD the GUI appears almost immediately but the GUI is frozen and the cpu is about 99%. This can happen on the KDE desktop when using the Oxygen theme. That's a bug in the Oxygen theme and choosing another theme should fix this issue.

새 문서를 만들 때 또는 파일을 열 때 FreeCAD 가 충돌합니다

If FreeCAD crashes when it creates a new 3D view, try launching FreeCAD from a terminal. If a message error appears when the crash occurs, mentioning Assertion Failed, and a component name beginning with "So" (SoBase, SoFieldContainer, etc.), the chances are very high, especially if you are on Linux, that FreeCAD is trying to use two different versions of the Coin library, which causes the crash. To verify if that is indeed the problem, try the following:

  • Locate the FreeCAD executable (usually in /usr/lib/FreeCAD/bin)
  • Run the command ldd FreeCAD from a terminal
  • Note down the version of the libCoin.so library that FreeCAD is using (for example libCoin.so.60)
  • Locate the libSoQt.so library (usually in /usr/lib)
  • run ldd libSoQt.so and check if it links to the same Coin version as FreeCAD

If there is any difference, either FreeCAD or SoQt must be recompiled (better to recompile the one that uses the oldest Coin version). The normal behavior is to try to contact the people responsible for packaging either SoQt or FreeCAD and kindly ask them to consider recompiling. If you want to undertake that step for yourself, and it is not possible to recompile SoQt because it breaks other applications on your system, you can force FreeCAD to compile with the required Coin version with ./configure --with-coin=DIR. But you have to make sure that the correct development package of this Coin version is installed.

편집→정렬 이후 FreeCAD가 충돌합니다

A segmentation fault happens at vbo_save_playback_vertex_list(). This means that the implementation of VBO in the graphic driver is bad. In order to avoid caching OpenGL calls you can try to set the environment variable IV_SEPARATOR_MAX_CACHES=0 and restart FreeCAD.

macOS에서 FreeCAD를 실행하는 데 문제가 있습니다

The Mac platform is less easy to support than Windows or Linux, since none of the core developers owns one. The macOS packages are compiled by volunteering FreeCAD users, and they might sometimes not work correctly on your machine, depending on your system. Your best chance is probably to head to the forums, look for macOS-related threads, and discuss your problem there or see if someone else encountered a solution.

FreeCAD의 속성 패널에서 숫자 값을 변경할 수 없습니다

language options
language options

You most likely have bad windows regional settings set-up. Please check if you have the same symbol for decimal separator and digit grouping symbol in your regional settings. If you do, adapt your system settings to use different characters for the digit grouping symbol and decimal separator. Note that it is not mandatory to have dot as decimal separator. It is mandatory to use different symbols in these two settings.

FreeCAD가 정상적으로 실행되고 있었는데 갑자기 더 이상 시작되지 않습니다

This can also happen if you had an older version of FreeCAD installed, and you upgraded to a newer version. In that process, the configuration files of FreeCAD might have been corrupted for some reason, and now FreeCAD cannot read them anymore, and fails to start. The solution is simply to delete these configuration files, so FreeCAD will recreate them on first run.

  • On Windows: Open the file explorer, and write %APPDATA%\FreeCAD as the file path. Once there, delete the files user.cfg and system.cfg
  • On Linux: Navigate to /home/USERNAME/.local/share/FreeCAD (version 0.20 and above) or /home/USERNAME/.FreeCAD (version 0.19 and below) and delete the files user.cfg and system.cfg
  • On Mac: Navigate to /Users/USERNAME/Library/Preferences/FreeCAD and delete the files user.cfg and system.cfg

이제 FreeCAD는 모든 설정이 재설정되어 정상적으로 다시 시작됩니다.


There is a Macro findConfigFiles available to help in locating your configuration files. It can be installed using the Addon Manager in the Tools menu. Tools → Addon Manager → Macros → findConfigFiles. The macro will find your config file folder, copy it to the clipboard, and (attempt to) open that location with your default file browser. It makes no changes to your files or settings.

FreeCAD 사용하기

FreeCAD 는 정말 무료인가요? 상업적 사용에도?

FreeCAD is open-source software, and is free not only to use, for yourself or for doing commercial work, but also to distribute, modify, or even use in a closed-source application. To summarize, you are free to do (almost) anything you want with it. See the License page for more details.

3D 뷰를 회전시키려면?

FreeCAD has several different navigation modes available, that can be set in the preferences settings dialog or changed by right-clicking in the 3D view. For full details about the modes, see the Mouse navigation page.

FreeCAD로 할 수 있는 건? 어디서부터 시작하나요?

Head to the Getting started page for a quick description of the tools you can use. There is also a new Tutorials section containing a few resources. The User hub section contains more detailed information about the different workbenches of FreeCAD. Note that since FreeCAD is relatively new, its user interface is still very bare and doesn't feature many tools. But much more advanced functionality is already available to you from Python scripting.

입문자를 위한 문서가 있나요? FreeCAD 사용법을 어떻게 배울 수 있나요?

There is a lot of documentation spread in different places, both on and outside the FreeCAD website. You might want to start with the Getting started page. The Tutorials section contains many specialized tutorial pages to help you getting started with the different workbenches. The Manual:Introduction is a general, complete user-oriented guide to FreeCAD. The User hub section of this wiki lists all pages aimed at end users. On external sites like Youtube, you will also find a load of video tutorials created by users. And, last but not least, the forum contains a lot of replies to questions asked by other newcomers.

I want to import/export data in format XYZ to/from FreeCAD. How do I do that?

Please refer to the FreeCAD Howto Import Export page. Maybe your questions are already answered there.

FreeCAD가 현재 지원하지 않는 기능에 대한 해결 방법은 어디에서 찾을 수 있나요?

해결방법모음을 참조하세요.

부품 형상 작업

어떻게 재료를 고체로 만들 수 있나요? 제대로 된 결과를 얻지 못했어요

The theory is simple: Lines (or wires), when extruded, form faces. Faces, when extruded, form solids.

If you extrude something and the result is not a solid, then the something was not a face. If you have lines and you want to extrude a solid from them, you must first select lines that form a closed perimeter (select several objects by pressing Ctrl), join them into a wire (Draft Upgrade tool), then make a face from that wire ( Draft Upgrade tool again). There you are, if all went well you can now extrude it to a solid.

Now, there can be many little twists that make you obtain the wrong result. The best way to make sure is to check what's inside the object you are extruding. Objects contents can be easily explored with python. Assuming for example you have an object called "Wire", you could type this into the Python console:

obj = FreeCAD.ActiveDocument.Wire
shp = obj.Shape
print shp.Faces
print shp.Wires
if shp.Wires:
    for w in shp.Wires:
        print w.isClosed()

The above code retrieves the shape from an object, shows the faces and wires your object has (if any), and, if there are wires, prints if those wires are closed. If you don't have any face, you won't get a solid. If there is no closed wire, it won't become a face. If you are interested, there is more info about what you can check with Python on the part scripting page. If you cannot join several lines into a wire, the most probable cause is that their endpoints don't meet, there must be small gaps between (some of) them. There, I'm afraid, my experience tells me the quickest way would be to redraw a wire on top of them.

부울 연산이 실패하거나 결과가 이상하게 나옵니다

The Open CASCADE geometric modeling kernel used in FreeCAD for Part geometry, although probably the best open-source geometry kernel available, has its flaws and limitations. Indeed the boolean operations (fusion, subtraction, intersection) are not its best features, and often give strange results. This is a current limitation we have no way to solve at once, so your best path is to try obtaining the desired result by modeling another way. For example, problems with primitives such as cylinder can often be solved by using an extruded circle instead. Coplanar surfaces between parts can cause trouble, as well as surface tangency. As a general rule, if a shape doesn't work, try remodeling it a different way. In 99% of the cases at the end you will manage to obtain the result you want.

모델을 내보내거나 볼 때 구멍이 채워집니다

Don't use Ctrl + A (Select All) to export everything from the hierarchy tree. If the model is of one single item, try selecting only the newest item (usually the last one) in the hierarchy tree.

As we create a model in the PartDesign Workbench, each feature takes the shape of the last one and adds or removes something, creating linear dependencies from feature to feature as the model is created. Hence a "Cut" feature is not only the cut hole itself, but the whole part with the cut. This is why the user usually should only have the newest item (feature) in the model tree visible, because otherwise the phases of the model overlay each other, and holes are filled in by the earlier model features.

To toggle visibility of an object on or off, select it in the hierarchy tree and press spacebar on your keyboard. Usually everything but the last item in the hierarchy tree should be greyed out and therefore not visible in the 3D view.

기본 스케치를 수정하면 파라메트릭 개체가 파손됩니다

여러분은 방금 유명한 위상명명 문제를 만났습니다.

This is a very hard problem to overcome (the Topological Naming Project aims at solving it). However, there are many workarounds available to mitigate the problem, and more advanced users generally manage to avoid it completely. A couple of strategies are:

  • Know that sketches are highly sensitive to the problem. Referencing a specific edge of a sketch, or a face of an object built on a sketch, such as a PartDesign Pad, is dangerous, unless you are pretty confident that these sketches will not change over time or the sketch is very simple. A Pad built on a simple rectangular sketch, for example, will likely be safe as it will generate only one face, so there is no order problem.
  • Prefer other kinds of objects such as Part or Draft when possible. These objects are always built the same way, and therefore their geometric components usually follow the same order each time they are rebuilt. They are much less susceptible to toponaming problems.
  • To attach further objects onto the faces of sketch-based geometry, prefer using Datum geometry. These invisible "helper objects" don't depend on sketch geometry, and therefore stay stable over time.

FreeCAD에 기여하기

FreeCAD는 정말 훌륭한 프로그램입니다! 내가 어떻게 도움이 될 수 있나요?

There are a lot of different ways to help, even if you are not a programmer. Here are a couple of things you can do:

  • Give some feedback to the FreeCAD developers: It is always useful to know what people think, what they found good, what they miss, etc. Drop a note on the forum giving your opinion or make a request on our issue tracker!
  • Help with writing documentation: The documentation we have here on this site is sometimes very limited. If you discovered something that is not well documented, add your knowledge there!
  • Help others newcomers: Hang around the forum, and help new people to solve basic questions, like how do I install, how do I add a cube, etc.
  • Translate the documentation into your own language
  • Translate FreeCAD into your own language
  • Write Tutorials, or record video tutorials: Tutorials are a very easy way for newcomers to learn a new software. If you did some nice stuff, why not show other people how to do it?
  • Contribute with assets and examples: We are still missing good example files in FreeCAD. If you created something good, share it with us!
  • Submit bugs: It is very important to have all possible bugs fixed. If you find one, report it as clearly as possible, so we can understand exactly what's happening.
  • Try to do some Python coding: You never programmed before but you want to try? Python is easy. Read our introduction to Python, but beware, you might get addicted quickly!
  • See the Help FreeCAD page for more details on how to contribute.

위키에 대한 편집 권한을 어떻게 얻을 수 있나요?

See the Work on the documentation page paragraph for more details on how to contribute.

FreeCAD는 Google Summer of Code에 참여하나요?

Yes. Beginning in 2016, FreeCAD participates in Google Summer of Code. See Google Summer of Code 2020 for information on past editions, and Google Summer Of Code 2016 in the forum for the original announcement.

위키문서를 우리 말로 번역하고 싶어요. 어떻게 해야 하면 되나요?

이 위키는 많은 콘텐츠를 호스팅하고 있습니다. 가장 최신의 흥미로운 자료는 온라인 도움말 목차에 모여 있습니다.

위키문서의 한국어 번역에 대한 자세한 내용은 Translate the documentation|문서 번역을 보세요.

기념품을 살 수 있나요?

FreeCAD doesn't offer swag you can order to support the project. But you can create your own. See our Swag page for instructions.

Licensing, copying and reuse

Do I have to pay something to use FreeCAD?

No. FreeCAD is totally free to use, to download, to redistribute, or to modify. It is open-source software, published under the terms of the GNU Lesser General Public License 2.1, which guarantees you those freedoms and, even more important, guarantees you that these freedoms will never be taken from you.

Can I reuse any part of the FreeCAD artwork or pieces of the website?

Sure. All the artwork (icons, banners, etc.) of FreeCAD are licensed LGPL, same as the FreeCAD code. Help yourself on the Artwork page. The website is a standard MediaWiki site, all graphic elements can freely be reused, and if you are curious about how to tweak the MediaWiki software like we did, look for the special Common css and js pages.

Can I reuse pieces of FreeCAD in another application?

Yes, you can use the core parts of FreeCAD in other applications as long as you comply with the terms of the LGPL. Third party libraries, external workbenches, and macros may be subject to their own license terms, so please consult with their authors. More details on the License page.