Std LinkMake/pl

Opis
Narzędzie tworzy obiekt App: Łącze (klasa ), typ obiektu, który odwołuje się lub łączy z innym obiektem, w tym samym dokumencie lub w innym dokumencie. Jest specjalnie zaprojektowany do wydajnego wielokrotnego powielania pojedynczego obiektu, co pomaga w tworzeniu skomplikowanych złożeń z mniejszych złożeń podrzędnych i wielu komponentów wielokrotnego użytku, takich jak śruby, nakrętki i podobne elementy złączne.

Obiekt App: Łącze został nowo wprowadzony w wersji 0.19. W przeszłości proste duplikowanie obiektów można było osiągnąć za pomocą, ale jest to mniej wydajne rozwiązanie ze względu na jego implementację, która zasadniczo tworzy kopię wewnętrznego kształtu obiektu źródłowego. Z drugiej strony, obiekt Łącze odwołuje się bezpośrednio do oryginalnego Kształtu, więc jest bardziej wydajny pamięciowo.

Sam obiekt Łącze może zachowywać się jak szyk, powielając swój obiekt bazowy wiele razy. Można to zrobić, ustawiając jego właściwość na wartość  lub większą. Ten obiekt "Szyk łączy" może być również tworzony za pomocą różnych narzędzi do tworzenia szyków w środowisku pracy Rysunek Roboczy, na przykład, , oraz.

W przypadku korzystania ze środowiska Projekt Części, Łącza są przeznaczone do użycia z obiektem, więc zaleca się ustawienie  na wrtość  w celu wybrania cech całej Zawartości, a nie indywidualnych cech. Aby utworzyć szyk wewnętrznych cech, użyj narzędzi, , oraz.

Narzędzie nie jest definiowane przez konkretne środowisko pracy, ale przez system bazowy, dlatego znajduje się na pasku narzędzi, który jest dostępny we wszystkich środowiskach pracy. Obiekt Łącze, używany w połączeniu z do grupowania różnych obiektów, stanowi podstawę środowiska pracy  Złożenie 3 i  Złożenie 4.

Użycie
Przy użyciu zaznaczenia:
 * 1) Wybierz obiekt w oknie widoku drzewa lub widoku 3D, dla którego chcesz utworzyć Łącze.
 * 2) Naciśnij przycisk . Utworzony obiekt ma taką samą ikonę jak oryginalny obiekt, ale posiada strzałkę wskazującą, że jest to Łącze.

Bez użycia zaznaczenia:
 * 1) Jeśli żaden obiekt nie jest zaznaczony, naciśnij przycisk, aby utworzyć puste Link.svg Łącze.
 * 2) Przejdź do edytora właściwości, następnie kliknij na właściwość, aby otworzyć okienko dialogowe Wybór obiektu i wybrać obiekt, a następnie naciśnij.
 * 3) Zamiast wybierać cały obiekt w oknie Widoku drzewa, można również wybrać elementy podrzędne (wierzchołki, krawędzie lub ściany) pojedynczego obiektu w oknie widoku 3D. W takim przypadku Łącze powieli tylko te elementy podrzędne, a ikonka strzałki będzie inna. Można to również zrobić za pomocą narzędzia.





Użycie: dokumenty zewnętrzne

 * 1) Zacznij od dokumentu, który ma co najmniej jeden obiekt, który będzie źródłem łącza.
 * 2) Otwórz nowy lub istniejący dokument. Dla łatwiejszej obsługi, użyj opcji, aby wyświetlić oba dokumenty w oknie Widoku drzewa. Zanim przejdziesz dalej, zapisz oba dokumenty. Łącze nie będzie w stanie znaleźć swojego źródła i celu, jeśli oba dokumenty nie zostaną zapisane na dysku.
 * 3) W pierwszym dokumencie wybierz obiekt, który chcesz powiązać. Następnie przełącz zakładki w głównego obszaru widoku, aby przejść do drugiego dokumentu.
 * 4) Naciśnij przycisk . Utworzony obiekt ma taką samą ikonę jak oryginalny obiekt, ale ma dodatkową nakładkę ze strzałką wskazującą, że jest to łącze pochodzące z zewnętrznego dokumentu.


 * Podczas zapisywania dokumentu z łączem, program poprosi również o zapisanie dokumentu źródłowego zawierającego oryginalny obiekt.
 * Aby dołączyć oryginalny obiekt do dokumentu z łączem, należy użyć przycisku lub.
 * Narzędzie może być użyte na istniejącym obiekcie łącza, w celu utworzenia łącza do łącza, które ostatecznie prowadzi do oryginalnego obiektu w dokumencie źródłowym. Można tego użyć z, aby wybrać tylko określone elementy podrzędne.





Przeciąganie i upuszczanie
Zamiast przełączać zakładki dokumentów, można tworzyć Łącza wykonując operację przeciągnij i upuść w oknie Widoku drzewa: wybierz obiekt źródłowy z pierwszego dokumentu, przeciągnij go, a następnie upuść na nazwę drugiego dokumentu przytrzymując klawisz na klawiaturze.

Przeciąganie i upuszczanie powoduje różne działania w zależności od trzymanego klawisza modyfikatora.
 * Bez klawisza modyfikatora po prostu przenosi obiekt z jednego dokumentu do drugiego. Na kursorze wyświetlana jest pochylona strzałka.
 * Przytrzymanie klawisza kopiuje obiekt. Na kursorze wyświetlany jest znak plus.
 * Przytrzymanie klawisza tworzy łącze. Na kursorze wyświetlana jest para ogniw łańcucha.

W przypadku modyfikatorów i, przeciąganie i upuszczanie może być również wykonywane w pojedynczym dokumencie. Oznacza to, że przeciągnięcie obiektu i upuszczenie go na nazwę tego samego dokumentu może być użyte do utworzenia wielu kopii lub wielu linków do niego.

Grupy
można użyć na obiekcie w celu szybkiego duplikowania grup obiektów umieszczonych w przestrzeni, czyli złożeniach.



Zwykła nie posiada właściwości, więc nie może kontrolować pozycji obiektów wewnątrz niego. Jednakże, gdy narzędzie zostanie użyte z, wynikowe łącze zachowuje się zasadniczo jak obiekt , a także może być przemieszczane w przestrzeni.



Łącze do utrzyma widoczność obiektów zsynchronizowaną z oryginalnym obiektem Część, więc jeśli ukryjesz jeden obiekt w Łączu, będzie on ukryty we wszystkich Łączach i w oryginalnym obiekcie. Z drugiej strony, łącze do pozwoli na niezależną kontrolę widoczności.





Kontrola wyglądu
Gdy tworzone jest łącze, domyślnie właściwość ma wartość, więc obiekt łącza będzie miał taki sam wygląd jak oryginalny.

Gdy właściwość jest ustawione na, właściwość  będzie teraz kontrolować wygląd obiektu Łącza.

Niezależnie od stanu właściwości, możliwe jest indywidualne ustawienie wyglądu elementów podrzędnych (wierzchołków, krawędzi, ścian) dla obiektu Łącza.
 * 1) Wybierz obiekt Łącza w oknie Widoku drzewa. Otwórz menu kontekstowe (kliknij prawym przyciskiem myszy) i wybierz.
 * 2) Teraz wybierz w oknie widoku 3D poszczególne elementy podrzędne, których chcesz użyć, naciśnij  i zmień właściwości, w tym przezroczystość.
 * 3) Aby usunąć niestandardowe atrybuty, zaznacz elementy na liście i naciśnij.
 * 4) Gdy wynik będzie zadowalający, naciśnij, aby zamknąć okno dialogowe.

od wersji 0.19 kolorowanie elementów podrzędnych podlega regułom problemu nazewnictwa topologicznego, więc powinno być wykonywane jako ostatni krok modelowania, gdy model nie podlega już zmianom.





Szyk łączy
Szyk ortogonalny.

Gdy tworzone jest Łącze, domyślnie jego wynosi, więc tylko pojedynczy obiekt Łącze będzie widoczny w Widoku drzewa.

Biorąc pod uwagę, że wartość jest domyślnie ustawiona na, gdy  jest ustawiona na  lub więcej, automatycznie więcej obiektów Łącze zostanie utworzonych poniżej pierwszego. Każdy nowy obiekt Łącze może zostać umieszczony w żądanej pozycji poprzez zmianę jego własnej właściwości.

W podobny sposób każdy element szyku może mieć zmieniony wygląd, albo przez właściwości i, albo przez użycie menu  na całym szyku, a następnie wybranie poszczególnych ścian. Zostało to opisane w akapicie Kontrola wyglądu.



Gdy jesteś zadowolony z rozmieszczenia i właściwości elementów Łącza w szyku, możesz zmienić wartość właściwości na, aby ukryć poszczególne Łącza w oknie Widoku drzewa. Ma to tę zaletę, że system jest bardziej dynamiczny, zwłaszcza jeśli w dokumencie znajduje się wiele obiektów.

Tworząc tego typu szyk Łączy, musisz umieścić każdy z elementów samodzielnie. Jeśli jednak chcesz użyć określonych wzorców do umieszczenia kopii, możesz użyć narzędzi szyku w środowisku pracy Rysunek Roboczy, takich jak, , oraz. Polecenia te mogą tworzyć normalne kopie lub kopie Łącz w zależności od opcji w czasie tworzenia.

Widoczność
Gdy właściwość ma wartość, a poszczególne elementy są wyświetlane w Widoku drzewa w szyku łączy, każde Łącze można wyświetlić lub ukryć, naciskając klawisz  na klawiaturze.

Innym sposobem na ukrycie poszczególnych elementów jest użycie menu.
 * 1) Wybierz szyk, otwórz z menu podręcznego  (kliknij prawym przyciskiem myszy).
 * 2) W oknie widoku 3D wybierz dowolny element podrzędny z dowolnego Łącza w szyku.
 * 3) Naciśnij . Powinna pojawić się ikona oka Invisible.svg wskazująca, że ten element został ukryty w widoku 3D. Obiekt tymczasowo pokaże się, gdy kursor najedzie na ikonę Invisible.svg.
 * 4) Możesz kliknąć, aby potwierdzić operację i zamknąć okno dialogowe. Łącze pozostanie ukryte, nawet jeśli jest wyświetlane jako widoczne w widoku drzewa.



Jeśli chcesz przywrócić widoczność tego elementu szyku, wejdź ponownie do okna dialogowego, wybierz ikonę oka, a następnie kliknij, aby usunąć status ukrycia, i kliknij , aby potwierdzić i zamknąć okno dialogowe. Element będzie ponownie widoczny w oknie widoku 3D.

Gdy Łącze odnosi się do obiektu lub, narzędzie z menu  działa podobnie jak w przypadku szyków. Pozwala kontrolować kolor ściany, kolor całego obiektu i widoczność obiektów w grupie.



Właściwości
Obiekt App: Łącze (klasa ) wywodzi się z podstawowej klasy App: DocumentObject , dlatego posiada podstawowe właściwości tej ostatniej, takie jak i.

Są to właściwości dostępne w edytorze właściwości. Ukryte właściwości można wyświetlić za pomocą polecenia w menu podręcznym edytora właściwości.

Dane

 * : wskazuje obiekt źródłowy App: Łącze. Może to być cały obiekt lub jego element (wierzchołek, krawędź lub ściana).
 * : domyślnie ustawiona na wartość, w którym to przypadku Łącze zastąpi własne położenie . Jeśli właściwość jest ustawiona na , Łącze zostanie umieszczone w tej samej pozycji co , a jego położenie będzie względne w stosunku do położenia . Można to również osiągnąć za pomocą narzędzia.
 * : umiejscowienie odnośnika we współrzędnych bezwzględnych.
 * : jest to przesunięcie nałożone na  . Ta właściwość jest normalnie ukryta, ale pojawia się, jeśli właściwość  jest ustawiona na wartość . W tym przypadku właściwość  staje się teraz ukryta.
 * : właściwość domyślnie ustawiona na wartość, w którym to przypadku widok drzewa pokaże poszczególne kopie Łącza, tak długo jak właściwość jest równa  lub większa.
 * : domyślnie . Jeśli wartość wynosi lub jest większa, obiekt App: Łącze będzie zachowywać się jak szyk i powieli ten sam  wiele razy. Jeśli właściwość ma wartość, każdy element w tablicy będzie wyświetlany w Widoku drzewa, a każdy z nich może mieć zmodyfikowane własne . Każda kopia Łącza będzie miała nazwę opartą na właściwości Nazwa Łącza, powiększoną o , gdzie  jest liczbą zaczynającą się od . Na przykład, z pojedynczym obiektem , kopie będą miały nazwy , ,  itd.
 * : nazwa funkcji execute, która zostanie uruchomiona dla tego konkretnego obiektu Łącza. Domyślnie jest to . Ustaw ją na, aby ją wyłączyć.
 * : lista elementów Łącza, których kolor został nadpisany.
 * : domyślnie przyjmuje wartość . Jest to współczynnik równomiernego skalowania w każdym kierunku, i . Na przykład, sześcian o wymiarach  x  x , który jest skalowany przez , da w wyniku kształt o wymiarach  x  x.
 * : współczynnik skali dla każdego elementu dla wszystkich elementów Łącza, gdy właściwość  ma wartość  lub większą. Jeśli  ma wartość inną niż, ta sama wartość zostanie użyta w trzech komponentach.
 * : współczynnik skali dla każdego elementu Łącza.
 * : stan widoczności każdego elementu Łącza, każdy element przyjmuje wartości albo  albo.
 * : the placement for each Link element.
 * : lista elementów Łącza.


 * : klasa własna związana z tym obiektem. Istnieje wyłącznie dla wersji środowiska Python. Zobacz sekcję tworzenie skryptów.

Obiekt App: Łącze będzie dodatkowo pokazywał właściwości oryginalnego, więc edytor właściwości może mieć grupy właściwości takie jak , , , itd.

Widok

 * : domyślnie . Może przyjąć wartości, , , . Definiuje styl krawędzi w oknie widoku 3D.
 * : wartość zmiennoprzecinkowa określająca szerokość w pikselach krawędzi w oknie widoku 3D. Domyślnie.
 * : wartość domyślna to . Jeśli zostanie ustawiona na, zastąpi materiał i wyświetli kolory zdefiniowane w właściwości.
 * : podobnie jak, definiuje rozmiar wierzchołków.
 * : jeśli przyjmie wartość, obiekt może zostać wybrany w oknie widoku 3D za pomocą kursora. W przeciwnym razie obiekt nie może zostać wybrany, dopóki wartość tej opcji nie zostanie ustawiona na.


 * : Ta właściwość zawiera właściwości podrzędne, które opisują wygląd obiektu.
 * , domyślnie, co jest wyświetlane jako na bazie 255, light blue.
 * , wartość domyślna to, co jest wyświetlane jako na bazie 255, dark gray.
 * , wartość domyślna to, co jest wyświetlane jako ona bazie 255, black.
 * , wartość domyślna to, co jest wyświetlane jako na bazie 255, black.
 * , wartość domyślna to
 * , wartość domyślna to.


 * : jeśli poszczególne materiały zostały dodane, będą one wymienione tutaj.
 * : jeśli poszczególne ściany lub krawędzie łącza zostały nadpisane, zostaną one wymienione tutaj.
 * : jeśli poszczególne materiały Łącza zostały nadpisane, zostaną one wymienione tutaj.
 * : jeśli poszczególne materiały Łącza zostały nadpisane, zostaną one wymienione tutaj.


 * : przyjmuję wartości lub.
 * : zobacz informacje na stronie Właściwości Python.
 * : zobacz informacje na stronie Właściwości Python.


 * : zobacz informacje na stronie Właściwości Python.
 * : zobacz informacje na stronie Właściwości Python.

Dodatkowo wyświetli właściwości widoku oryginalnego.

Dziedziczenie
Obiekt App: Łącze jest formalnie instancją klasy, której rodzicem jest podstawowy App: DocumentObject (klasa ). Jest to obiekt bardzo niskiego poziomu, który może być używany z większością innych obiektów dokumentów.



Tworzenie skryptów
Podstawy tworzenia skryptów FreeCAD, oraz Obiekty skryptowe.

Zapoznaj się z artykułem Część: Cecha, aby uzyskać ogólne informacje.

Obiekt App Łącze jest tworzony za pomocą metody dokumentu. Może on zdefiniować swój poprzez nadpisanie atrybutu  lub poprzez użycie metody.

Podstawowy nie ma obiektu Proxy, więc nie może być w pełni wykorzystany do tworzenia klas podrzędnych.

Dlatego też, dla klasy podrzędnej Python, powinieneś stworzyć obiekt.



Dodatkowe informacje
Obiekt App Łącze został wprowadzony po 2 latach rozwoju i prototypowania. Komponent ten został wymyślony i opracowany niemal samodzielnie przez użytkownika. Motywacje i implementacje stojące za tym projektem zostały opisane na jego stronie GitHub, Link. Aby wdrożyć tę funkcję, wprowadzono kilka podstawowych zmian w programie FreeCAD. Zostały one również obszernie udokumentowane w artykule Core-Changes.

Projekt związany z App Łącze rozpoczął się po tym, jak przeprojektowanie środowiska pracy Projekt Części zostało ukończone w wersji 0.17. Historię App Łącze można prześledzić w kilku istotnych wątkach na forum:
 * Dlaczego obiekt może znajdować się tylko w jednym App::Part? (marzec 2017)
 * Wprowadzenie App::Link/XLink (marzec 2017)
 * Linki (maj 2017)
 * Implementacja Realthunder Link: Dyskusja o architekturze (czerwiec 2017)
 * PR #876: Link, etap pierwszy, wybór świadomy kontekstu (lipiec 2017)
 * Preview: Link, etap drugi, podstawy API (lipiec 2017)
 * Podgląd Assembly3 (grudzień 2017)
 * Scalanie mojej gałęzi Link (czerwiec 2018)

W końcu nastąpiło zgłoszenie pull request i scalenie:
 * App::Link: the big merge, stary wątek (lipiec 2019), pull request #2350 (the BIG merge), LinkMerge branch.
 * App::Link: the big merge, główny wątek (lipiec 2019)
 * Prosty opis ścieżki Link, 019, Link stage, Asm3, merge? (sierpień 2019)
 * PR#2559: ujawnienie linków i akcji nawigacyjnych, wprowadzenie do funkcji Link w wersji 0.19 (wrzesień 2019).

Inne różne "odnośniki internetowe" dotyczące Łącza obejmują:
 * Obiekty łączone dynamicznie - Wzorzec z Łączem i złożeniami, który ma na celu zmniejszenie duplikacji logiki związanej ze złożeniem, takiej jak orientacja, pozycjonowanie lub liczba instancji.