Part JoinEmbed/pl: Difference between revisions

From FreeCAD Documentation
(Updating to match new version of source page)
No edit summary
 
(26 intermediate revisions by the same user not shown)
Line 1: Line 1:
<languages/>
<languages/>


{{Docnav
{{Docnav/pl
|[[Part_JoinConnect|JoinConnect]]
|[[Part_JoinConnect/pl|Połącz obiekty]]
|[[Part_JoinCutout|JoinCutout]]
|[[Part_JoinCutout/pl|Wycięcie dla obiektu]]
|[[Part_Workbench|Part]]
|[[Part_Workbench/pl|środowisko pracy Część]]
|IconL=Part_JoinConnect.svg
|IconL=Part_JoinConnect.svg
|IconR=Part_JoinCutout.svg
|IconR=Part_JoinCutout.svg
Line 10: Line 10:
}}
}}


{{GuiCommand
{{GuiCommand/pl
|Name=Part JoinEmbed
|Name=Part JoinEmbed
|Name/pl=Część: Osadź obiekt
|MenuLocation=PartJoinEmbed Object
|MenuLocation=CzęśćPołączOsadź obiekt
|Workbenches=[[Part_Workbench|Part]]
|Workbenches=[[Part_Workbench/pl|Część]]
|Version=0.16
|Version=0.16
|SeeAlso=[[Part_JoinConnect|Part JoinConnect]], [[Part_JoinCutout|Part JoinCutout]], [[Part_Boolean|Part Boolean]], [[Part_Thickness|Part Thickness]]
|SeeAlso=[[Part_JoinConnect/pl|Połącz obiekty]], [[Part_JoinCutout/pl|Wycięcie dla obiektu]], [[Part_Boolean/pl|Operacja logiczna]], [[Part_Thickness/pl|Grubość]]
}}
}}


==Description==
<span id="Description"></span>
==Opis==


Narzędzie '''Osadź''' umożliwia umieszczenie obiektu ze ściankami ''(np. rury)'' w innym obiekcie ze ściankami.
Embed tool embeds a walled object (e.g., a pipe) into another walled object.


[[image:JoinFeatures_Embed.png|600px]]
[[image:JoinFeatures_Embed.png|600px]]


==Usage==
<span id="Usage"></span>
==Użycie==


# Wybierz najpierw obiekt bazowy, a następnie obiekt, który ma zostać osadzony. Kolejność wyboru jest ważna. Wystarczy wybrać jeden kształt podrzędny każdego obiektu ''(np. ściany)''.
# Select the base object first, then the object to be embedded. The order of selection is important. It is enough to select one sub-shape of each object (e.g., faces).
# Wywołaj polecenie Osadź obiekt.
# Invoke the Part JoinEmbed command.


Tworzony jest obiekt środowiska Część CechaPołączenia z ustawionym trybem "Osadź". Oryginalne obiekty są ukryte, a wynik osadzenia jest wyświetlany w oknie widoku 3D.
A Part JoinFeature object is created, with Mode set to 'Embed'. Original objects are hidden, and the result of embedding is shown in 3D view.


==Properties==
<span id="Properties"></span>
==Właściwości==


{{TitleProperty|Base}}
{{TitleProperty|Podstawa}}


* {{PropertyData|Base}}: Reference to base object (the one the other object is to be embedded into). The object should be a single solid.
* {{PropertyData|Baza}}: Odniesienie do obiektu bazowego ''(tego, w którym ma zostać osadzony inny obiekt)''. Obiekt powinien być pojedynczą bryłą.
* {{PropertyData|Tool}}: Reference to tool object (the object to be embedded). The object can be a single solid, or a [[Part_Compound|valid compound]] of solids.
* {{PropertyData|Narzędzie}}: Odniesienie do obiektu narzędzia (obiektu, który ma zostać osadzony). Obiekt może być pojedynczą bryłą lub [[Part_Compound|prawidłowym złożeniem]] brył.
* {{PropertyData|Mode}}: The mode of operation, equals 'Embed' (Changing that will transform the tool into another Part_JoinXXX). The value of 'bypass' can be used to temporarily disable the long computations (a compound of Base and Tool will be created, which is a fast operation).
* {{PropertyData|Tryb}}: Tryb działania, równy '''Osadź''' ''(Zmiana, która przekształci narzędzie w inne Part_JoinXXX)''. Wartość '''obejdź''' może być użyta do tymczasowego wyłączenia długich obliczeń (zostanie utworzone połączenie bazy i narzędzia, co jest szybką operacją).
* {{PropertyData|Ulepsz}}: Określa, czy zastosować operację [[Part_RefineShape/pl|ulepszania]] wobec ostatecznego kształtu. Wartość domyślna jest określona przez pole wyboru "Automatycznie udoskonal model po wykonaniu operacji logicznej" w [[PartDesign_Preferences/pl|Preferencjach środowiska Projekt Części]]. Gdy właściwość '''Tryb''' ma wartość '''Obejdź''', Ulepszanie jest ignorowane ''(nigdy nie jest stosowane)''.
* {{PropertyData|Refine}}: Sets whether to apply [[Part RefineShape|Refine]] operation or not, to the final shape. The default value is determined by a 'Automatically refine shape after boolean operation' checkbox in PartDesign preferences. When Mode property is 'bypass', Refine is ignored (never applied).


==Example==
<span id="Example"></span>
==Przykład==


# Create a pipe by applying [[Part_Thickness|thickness]] to a [[Part_Cylinder|cylinder]]:<br />[[Image:JoinFeatures_Example_step1.png|320px]]
# Utwórz rurę, stosując narzędzie [[Part_Thickness/pl|grubość]] do bryły [[Part_Cylinder/pl|cylindra]]:
<br>[[Image:JoinFeatures_Example_step1.png|320px]]
# Create another, smaller diameter pipe, and [[Placement|place]] it so that it pierces the wall of the first pipe:<br />[[image:JoinFeatures_Example_step2.png|320px]]
# Utwórz kolejną rurę o mniejszej średnicy i [[Placement/pl|umieść]] ją tak, aby przebiła ścianę pierwszej rury:
# Select the first pipe, then the second pipe (order of selection is important), and click the 'Embed object' option from the Join tools dropdown toolbar button. <br />[[image:JoinFeatures_Example_step3_Embed.png|320px]]
<br>[[image:JoinFeatures_Example_step2.png|320px]]
# Use some cross-section tool ([[Std_ToggleClipPlane|Clipping plane]], [[Arch_SectionPlane|Arch Section Plane]], [[Arch_CutPlane|Arch Cut Plane]]) to reveal internals. On the picture below, Arch Section Plane is used.<br />[[image:JoinFeatures_Example_step4_Embed.png|320px]]
# Wybierz pierwszą rurę, a następnie drugą rurę (kolejność wyboru jest ważna) i kliknij opcję "Osadź obiekt" na rozwijanym pasku narzędzi Dołącz.
<br>[[image:JoinFeatures_Example_step3_Embed.png|320px]]
# Zastosuj narzędzie przekroju ''([[Std_ToggleClipPlane/pl|Przełącz płaszczyznę tnącą]], [[Arch_SectionPlane/pl|Płaszczyzna przekroju]] środowiska Architektura, [[Arch_CutPlane/pl|Płaszczyzna cięcia]] środowiska Architektura)'', aby odsłonić elementy wewnętrzne. Na poniższym obrazku użyto narzędzia Płaszczyzna przekroju środowiska Architektura.
<br>[[image:JoinFeatures_Example_step4_Embed.png|320px]]


==Algorithm==
<span id="Algorithm"></span>
==Sposób działania==


Algorytmy stojące za narzędziami Połącz są dość proste, a ich zrozumienie jest ważne dla prawidłowego korzystania z narzędzi.
The algorithms behind Join tools are quite simple, and understanding them is important to use the tools correctly.


1. Base object is [[Part Cut|boolean-cut]] with Tool object. The resulting shape is a set ([[Part_Compound|compound]]) of non-intersecting solids (typically, two).
1. Obiekt bazowy jest [[Part Cut/pl|wycięty logicznie]] za pomocą obiektu narzędzia. Wynikowy kształt jest zestawem ''([[Part_Compound/pl|złożeń]])'' nieprzecinających się brył ''(zazwyczaj dwóch)''.


2. Uzyskane złożenie jest kolejnie filtrowane, przy czym zachowywana jest tylko największa bryła.
2. The resulting compound is filtered: only the largest solid is kept.


3. That largest solid is [[Part_Fuse|boolean-fused]] with Tool object.
3. Ta największa bryła jest [[Part_Fuse/pl|logicznym połączeniem]] z obiektem narzędzia.


4. If Refine property is true, the resulting shape is [[Part RefineShape|refined]].
4. Jeśli właściwość Ulepsz ma wartość {{true/pl}}, wynikowy kształt to obiekt funkcji [[Part RefineShape|Ulepsz]].
<br /><br />[[image:JoinFeatures-Algo-Embed.png|800px]]
<br><br>[[image:JoinFeatures-Algo-Embed.png|800px]]


===Notes===
<span id="Notes"></span>
===Uwagi===


* Jeśli po kroku 1 obiekt pozostaje w jednym kawałku, wynik operacji Osadź będzie równoważny [[Part_Fuse/pl|połączeniu]] bazy i narzędzia, ale jego obliczenie zajmie więcej czasu.
* If after step 1, the object remains in one piece, the result of Embed will be equivalent to [[Part_Fuse|union]] of Base and Tool, but taking longer to compute.
* Obecnie narzędzie wygeneruje nieoczekiwany wynik, jeśli jako baza zostanie użyte złożenie. ''(Może to zostać zmienione w przyszłości.)''
* Now, the tool will produce unexpected result, if a compound is supplied as Base. This may be changed in the future.
* Ponieważ największy element jest określany przez porównanie objętości elementów, narzędzie może działać tylko z bryłami. ''(Może to zostać zmienione w przyszłości.)''
* Because the largest piece is determined by comparing volumes of pieces, the tool can only work with solids. This may be changed in the future.


==Scripting==
<span id="Scripting"></span>
==Tworzenie skryptów==


Narzędzie Osadź może być używane w [[Macros/pl|makrodefinicjach]] i z konsoli [[Python/pl|Python]] za pomocą następującej funkcji:
The Join tools can by used in [[macros]] and from the python console by using the following function:


{{Code|code=JoinFeatures.makePartJoinFeature(name = 'Embed', mode = 'Embed')}}
{{Code|code=JoinFeatures.makePartJoinFeature(name = 'Embed', mode = 'Embed')}}


* Tworzy pusty element osadzania ''(lub inny element dołączania, w zależności od przekazanego trybu)''. Następnie należy jawnie przypisać właściwości Baza i Narzędzie.
* Creates an empty Embed feature (or other Join feature, depending on mode passed). The properties Base and Tool must be assigned explicitly, afterwards.
* Zwraca nowo utworzony obiekt.
* Returns the newly created object.


Przykład:
Example:


{{code|code=
{{code|code=
Line 84: Line 96:
}}
}}


The tool itself is implemented in Python, see {{FileName|/Mod/Part/JoinFeatures.py}} ([https://github.com/FreeCAD/FreeCAD/blob/master/src/Mod/Part/JoinFeatures.py Github link]) under where FreeCAD is installed.
Samo narzędzie jest zaimplementowane w środowisku Python, patrz {{FileName|/Mod/Part/JoinFeatures.py}} ([https://github.com/FreeCAD/FreeCAD/blob/master/src/Mod/Part/JoinFeatures.py Link do Github]) w miejscu, w którym zainstalowany jest FreeCAD.




{{Docnav
{{Docnav/pl
|[[Part_JoinConnect|JoinConnect]]
|[[Part_JoinConnect/pl|Połącz obiekty]]
|[[Part_JoinCutout|JoinCutout]]
|[[Part_JoinCutout/pl|Wycięcie dla obiektu]]
|[[Part_Workbench|Part]]
|[[Part_Workbench/pl|środowisko pracy Część]]
|IconL=Part_JoinConnect.svg
|IconL=Part_JoinConnect.svg
|IconR=Part_JoinCutout.svg
|IconR=Part_JoinCutout.svg

Latest revision as of 11:09, 4 July 2023

Część: Osadź obiekt

Lokalizacja w menu
Część → Połącz → Osadź obiekt
Środowisko pracy
Część
Domyślny skrót
brak
Wprowadzono w wersji
0.16
Zobacz także
Połącz obiekty, Wycięcie dla obiektu, Operacja logiczna, Grubość

Opis

Narzędzie Osadź umożliwia umieszczenie obiektu ze ściankami (np. rury) w innym obiekcie ze ściankami.

Użycie

  1. Wybierz najpierw obiekt bazowy, a następnie obiekt, który ma zostać osadzony. Kolejność wyboru jest ważna. Wystarczy wybrać jeden kształt podrzędny każdego obiektu (np. ściany).
  2. Wywołaj polecenie Osadź obiekt.

Tworzony jest obiekt środowiska Część CechaPołączenia z ustawionym trybem "Osadź". Oryginalne obiekty są ukryte, a wynik osadzenia jest wyświetlany w oknie widoku 3D.

Właściwości

Podstawa

  • DANEBaza: Odniesienie do obiektu bazowego (tego, w którym ma zostać osadzony inny obiekt). Obiekt powinien być pojedynczą bryłą.
  • DANENarzędzie: Odniesienie do obiektu narzędzia (obiektu, który ma zostać osadzony). Obiekt może być pojedynczą bryłą lub prawidłowym złożeniem brył.
  • DANETryb: Tryb działania, równy Osadź (Zmiana, która przekształci narzędzie w inne Part_JoinXXX). Wartość obejdź może być użyta do tymczasowego wyłączenia długich obliczeń (zostanie utworzone połączenie bazy i narzędzia, co jest szybką operacją).
  • DANEUlepsz: Określa, czy zastosować operację ulepszania wobec ostatecznego kształtu. Wartość domyślna jest określona przez pole wyboru "Automatycznie udoskonal model po wykonaniu operacji logicznej" w Preferencjach środowiska Projekt Części. Gdy właściwość Tryb ma wartość Obejdź, Ulepszanie jest ignorowane (nigdy nie jest stosowane).

Przykład

  1. Utwórz rurę, stosując narzędzie grubość do bryły cylindra:


  1. Utwórz kolejną rurę o mniejszej średnicy i umieść ją tak, aby przebiła ścianę pierwszej rury:


  1. Wybierz pierwszą rurę, a następnie drugą rurę (kolejność wyboru jest ważna) i kliknij opcję "Osadź obiekt" na rozwijanym pasku narzędzi Dołącz.


  1. Zastosuj narzędzie przekroju (Przełącz płaszczyznę tnącą, Płaszczyzna przekroju środowiska Architektura, Płaszczyzna cięcia środowiska Architektura), aby odsłonić elementy wewnętrzne. Na poniższym obrazku użyto narzędzia Płaszczyzna przekroju środowiska Architektura.


Sposób działania

Algorytmy stojące za narzędziami Połącz są dość proste, a ich zrozumienie jest ważne dla prawidłowego korzystania z narzędzi.

1. Obiekt bazowy jest wycięty logicznie za pomocą obiektu narzędzia. Wynikowy kształt jest zestawem (złożeń) nieprzecinających się brył (zazwyczaj dwóch).

2. Uzyskane złożenie jest kolejnie filtrowane, przy czym zachowywana jest tylko największa bryła.

3. Ta największa bryła jest logicznym połączeniem z obiektem narzędzia.

4. Jeśli właściwość Ulepsz ma wartość Prawda, wynikowy kształt to obiekt funkcji Ulepsz.

Uwagi

  • Jeśli po kroku 1 obiekt pozostaje w jednym kawałku, wynik operacji Osadź będzie równoważny połączeniu bazy i narzędzia, ale jego obliczenie zajmie więcej czasu.
  • Obecnie narzędzie wygeneruje nieoczekiwany wynik, jeśli jako baza zostanie użyte złożenie. (Może to zostać zmienione w przyszłości.)
  • Ponieważ największy element jest określany przez porównanie objętości elementów, narzędzie może działać tylko z bryłami. (Może to zostać zmienione w przyszłości.)

Tworzenie skryptów

Narzędzie Osadź może być używane w makrodefinicjach i z konsoli Python za pomocą następującej funkcji:

JoinFeatures.makePartJoinFeature(name = 'Embed', mode = 'Embed')
  • Tworzy pusty element osadzania (lub inny element dołączania, w zależności od przekazanego trybu). Następnie należy jawnie przypisać właściwości Baza i Narzędzie.
  • Zwraca nowo utworzony obiekt.

Przykład:

import JoinFeatures
j = JoinFeatures.makePartJoinFeature(name = 'Embed', mode = 'Embed' )
j.Base = FreeCADGui.Selection.getSelection()[0]
j.Tool = FreeCADGui.Selection.getSelection()[1]

Samo narzędzie jest zaimplementowane w środowisku Python, patrz /Mod/Part/JoinFeatures.py (Link do Github) w miejscu, w którym zainstalowany jest FreeCAD.