Working with the Query Language
Altium Essentials: PCB Global Editing and List Panel
This content is part of the official Altium Professional Training Program. For full courses, materials and certification, visit Altium Training.
W skrócie
- Dowiedz się, jak zapytania pozwalają wyszukiwać określone obiekty i jak zakres filtrowania określa, które dokumenty i obiekty są przeszukiwane.
- Poznaj sposoby tworzenia i sprawdzania wyrażeń zapytań oraz sterowania zaznaczaniem, powiększaniem i maskowaniem wyników.
- Dowiedz się, jak stosować i usuwać filtry, ponownie wykorzystywać ulubione i ostatnio używane zapytania oraz używać nawiasów, aby zwiększyć czytelność wyrażeń.
Czym jest zapytanie?
Prawdopodobnie największym wyzwaniem podczas pracy nad złożonym projektem elektronicznym jest zarządzanie dużą liczbą obiektów projektu. Od komponentów, etykiet sieci i ciągów tekstowych na arkuszach schematu po setki komponentów i ścieżek tworzących połączenia na płytce PCB — potrzebujesz możliwości dostępu do tych obiektów, ich przeglądania i edytowania. Podobnie jak w większości aplikacji systemu Windows, możesz kliknąć obiekt dwukrotnie i edytować jego właściwości. To dobre rozwiązanie w przypadku pojedynczego obiektu, ale nie wtedy, gdy trzeba edytować ponad 300 oznaczeń komponentów lub zmienić wszystkie przelotki na płytce PCB. Przy tego rodzaju zmianach potrzebujesz dostępu do wielu obiektów jednocześnie.
Podstawą działania edytorów schematów i PCB w Altium Designer jest zaawansowany silnik zapytań. Wprowadzając do niego zapytania, możesz filtrować obiekty, aby znaleźć i edytować dokładnie te, których potrzebujesz.
Zaawansowany system filtrowania i edycji danych w Altium Designer pozwala wskazać oprogramowaniu określony zestaw obiektów do zwrócenia. Instrukcja ta jest wprowadzana w postaci zapytania. Zapytanie to ciąg tekstowy zawierający określone słowa kluczowe i zgodny z określoną składnią, który zwraca wskazane obiekty. To, co z nimi zrobisz, zależy od Ciebie. Możesz je na przykład wyróżnić i przyciemnić wszystkie pozostałe obiekty albo przeglądać lub sortować ich właściwości i modyfikować określone atrybuty wspólne dla wszystkich tych obiektów.
Zapytania można stosować w wielu miejscach, ale głównym centrum sterowania są Filter panele pokazane na poniższych ilustracjach. Naciśnij F12, aby wyświetlić lub ukryć panel Filter .
Panele PCB Filter i SCH Filter z zapytaniami

Panele PCBLIB Filter i SCHLIB Filter z zapytaniami
Elementy sterujące w panelu służą do określania, do których obiektów zostanie zastosowane zapytanie oraz jak mają być traktowane obiekty spełniające jego warunki, a także te, które ich nie spełniają.
Panel SCH Filter

Szybko znajduj i wyróżniaj obiekty za pomocą zapytań logicznych w panelu SCH Filter.
Podsumowanie
Panel SCH Filter umożliwia tworzenie filtrów za pomocą zapytań logicznych. Zdefiniowany filtr można następnie zastosować do aktywnego dokumentu schematu lub wszystkich otwartych dokumentów schematów, co pozwala precyzyjniej i wydajniej zaznaczać oraz edytować wiele obiektów.
Dostęp do panelu
Panel można otworzyć na następujące sposoby:
- Kliknij przycisk Panels w prawym dolnym rogu edytora, gdy aktywny jest edytor schematów, a następnie wybierz SCH Filter z menu podręcznego.
- Kliknij View » Panels » SCH Filter.
- Naciśnij klawisz skrótu F12.
Definiowanie zakresu filtra
Pierwsza sekcja panelu zawiera elementy sterujące służące do definiowania zakresu filtra:
Obszar Limit search to zawiera elementy sterujące umożliwiające dalsze doprecyzowanie zakresu filtra:
- All Objects — zastosuj filtr do wszystkich obiektów projektu.
- Selected Objects — zastosuj filtr tylko do aktualnie zaznaczonych obiektów projektu.
- Non Selected Objects — zastosuj filtr tylko do obiektów projektu, które nie są obecnie zaznaczone.
Pole listy rozwijanej Consider objects in pozwala określić, gdzie zostanie zastosowany filtr. Wybierz jedną z następujących opcji:
- Current Document — zastosuj filtrowanie tylko do aktywnego dokumentu schematu (domyślnie).
- Open Documents — zastosuj filtrowanie do wszystkich otwartych dokumentów schematów.
- Project Documents — zastosuj filtrowanie do wszystkich otwartych dokumentów schematów będących dokumentami źródłowymi tego samego projektu nadrzędnego.
Definiowanie zapytań filtra
Środkowa sekcja panelu umożliwia tworzenie filtrów przez wprowadzanie zapytań logicznych. Zapytanie można wpisać bezpośrednio w polu. Podczas wpisywania pojawi się lista podpowiedzi z możliwymi słowami kluczowymi.
Przy tworzeniu zapytań można korzystać z pomocy narzędzia Query Helper. Ta funkcja może być bardzo przydatna, jeśli nie masz pewności co do składni zapytania lub słów kluczowych, których chcesz użyć. Aby skorzystać z narzędzia Query Helper, kliknij przycisk Helper, aby otworzyć okno dialogowe Query Helper. Działający w tle silnik zapytań analizuje dokument i wyświetla listę wszystkich dostępnych obiektów wraz z ogólnymi słowami kluczowymi do wykorzystania w zapytaniach.
W górnej części okna dialogowego utwórz wyrażenie zapytania, korzystając z dostępnych SCH Functions i System Functions. Środkowa część okna dialogowego udostępnia szereg operatorów do wykorzystania podczas tworzenia wyrażenia. Użyj przycisku Check Syntax, aby sprawdzić poprawność składni wyrażenia.
Po zdefiniowaniu wyrażenia zapytania zgodnie z potrzebami kliknij OK, aby wczytać zapytanie do środkowej sekcji panelu SCH Filter i przygotować filtr do zastosowania.
Definiowanie wyróżniania wyników filtrowania
Przed zastosowaniem zapytania najlepiej określić sposób wizualnego przedstawiania wyników filtrowania w obszarze roboczym projektu. Sekcje Objects passing/not passing the filter panelu udostępniają różne opcje, które wspólnie tworzą zestaw ustawień wyróżniania dla trwałego filtrowania.
Opcje dostępne w obszarze Objects passing the filter pozwalają sterować sposobem wyświetlania w obszarze roboczym wszystkich obiektów objętych zakresem filtra i spełniających warunki określonego wyrażenia zapytania:
- Select — po włączeniu (domyślnie) odfiltrowane obiekty zostaną zaznaczone w obszarze roboczym.
- Zoom — po włączeniu (domyślnie) widok zostanie powiększony i wyśrodkowany na odfiltrowanych obiektach (o ile to możliwe) w oknie edytora projektu.
Opcje dostępne w obszarze Objects not passing the filter pozwalają sterować sposobem wyświetlania w obszarze roboczym wszystkich obiektów, które nie są objęte zakresem filtra i/lub nie spełniają warunków określonego wyrażenia zapytania:
- Deselect — po włączeniu (domyślnie) zaznaczenie wszystkich obiektów nieobjętych zakresem filtra zostanie usunięte w obszarze roboczym.
- Mask out — po włączeniu (domyślnie) odfiltrowane obiekty będą w pełni widoczne w oknie edytora projektu, a wszystkie pozostałe zostaną przyciemnione. Po zastosowaniu maskowania obiektów nieobjętych zakresem filtra nie będzie można zaznaczać ani edytować.
Można włączyć dowolną kombinację tych opcji. Możesz na przykład powiększyć i wyśrodkować widok na wszystkich odfiltrowanych obiektach objętych zakresem zapytania oraz zaznaczyć je w oknie edytora projektu, a jednocześnie zastosować maskowanie, aby pozostałe obiekty projektu nie utrudniały pracy.
Stosowanie i usuwanie filtra
Po zdefiniowaniu zapytania i odpowiednim ustawieniu opcji w panelu możesz zastosować filtr, klikając przycisk Apply lub naciskając Enter.
Aby usunąć aktualnie zastosowany filtr z poziomu panelu, usuń wyrażenie zapytania z panelu, a następnie kliknij przycisk Apply lub naciśnij Enter. Wszystkie obiekty w obszarze roboczym projektu staną się w pełni widoczne i dostępne do zaznaczania oraz edycji.
Menu kontekstowe
Kliknięcie prawym przyciskiem myszy w panelu SCH Filter zapewnia dostęp do dodatkowych opcji i poleceń w menu podręcznym.
Menu zawiera następujące polecenia:
- Add to Favorites — dodaje wyrażenie zapytania aktualnie wyświetlane w panelu do listy ulubionych zapytań. Zapytanie pojawi się jako nowy wpis na karcie Favorites okna dialogowego Menedżer wyrażeń. Po dodaniu zapytania do listy ulubionych będzie ono wyświetlane u góry menu kontekstowego. W menu wyświetlanych jest dziesięć ostatnio dodanych ulubionych zapytań (najnowsze na górze), co umożliwia szybki dostęp do ulubionych wyrażeń zapytań i ich ponowne użycie.
- Organize Favorites — otwiera kartę Favorites okna dialogowego Menedżer wyrażeń, na której można według potrzeb porządkować wpisy na liście ulubionych zapytań (zmieniać ich nazwy i je usuwać).
- Examples — kliknij, aby otworzyć podmenu z predefiniowanymi przykładowymi filtrami. Wybranie przykładowego filtra spowoduje wczytanie powiązanego z nim wyrażenia zapytania do środkowej części panelu.
- History — kliknij, aby otworzyć podmenu zawierające dziewięć ostatnio używanych wyrażeń zapytań z listy historii zapytań panelu. Kliknij pozycję More, aby otworzyć kartę History okna dialogowego Menedżer wyrażeń, na której można przeglądać pełną historię zapytań i stosować wybrane zapytania, a także w razie potrzeby wyczyścić historię.
- Show Scope Options — przełącza widoczność obszaru panelu służącego do określania zakresu filtrowania.
- Show Masking Options — przełącza widoczność obszaru panelu służącego do określania wyróżniania wyników filtrowania.
Uwagi
Ogólne
- Naciśnięcie klawisza F12 przełącza widoczność panelu w obszarze roboczym.
- Podczas tworzenia zapytania w oknie dialogowym Pomocnik zapytań kliknięcie wewnątrz wpisanego słowa kluczowego lub słowa kluczowego na jednej z dostępnych list i naciśnięcie F1 otworzy pomoc dotyczącą tego słowa kluczowego. Podobny dostęp do pomocy dotyczącej słów kluczowych można uzyskać, klikając wewnątrz słowa kluczowego w środkowej części panelu SCH Filter, a następnie naciskając F1.
- W zależności od kształtu i rozmiaru panelu jego zawartość będzie dynamicznie rozmieszczana w poziomie lub w pionie.
Tworzenie wyrażeń zapytań
- Zdecydowanie zaleca się stosowanie nawiasów zawsze, gdy istnieje choćby najmniejsze ryzyko, że zapytanie zostanie nieprawidłowo zinterpretowane.
-
Nawiasy mają najwyższy priorytet w kolejności wykonywania działań zdefiniowanej dla dostępnych operatorów. Kolejność ta określa sposób interpretowania zapytań przez oprogramowanie, gdy nie zastosowano nawiasów. Jest ona następująca:
Brackets
Not
^, *, /, Div, Mod, And
+, -, Or, Xor
=, <>, <, >, <=, >=
&&, ||
Ta kolejność wykonywania działań jest podobna do stosowanej w językach typu Pascal; częste używanie nawiasów eliminuje wątpliwości i ułatwia innym czytanie utworzonych zapytań. - Niejednoznaczności są rozstrzygane od lewej do prawej.
- Wyrażenia w nawiasach są obliczane od najbardziej wewnętrznych do zewnętrznych, a na tym samym poziomie — od lewej do prawej.
- Ponieważ opcje wyświetlania obiektów spełniających i niespełniających warunków zastosowanego filtra są rozdzielone, można stosować kolejne zapytania filtrujące do wyników wcześniejszego filtrowania.
- Filtrowanie stosowane za pomocą zapytań z panelu SCH Filter jest trwałe. Podczas maskowania obiektów projektu niespełniających warunków filtra stopień maskowania reguluje się suwakiem u dołu panelu.
- Trwały filtr należy usunąć, stosując puste zapytanie z panelu SCH Filter.
Panel SCHLIB Filter
Szybko znajduj i wyróżniaj obiekty biblioteki schematów za pomocą zapytań logicznych w panelu SCHLIB Filter.
Podsumowanie
Panel SCHLIB Filter umożliwia tworzenie filtrów za pomocą zapytań logicznych. Zdefiniowany filtr można następnie zastosować do aktywnego komponentu biblioteki schematów lub do wszystkich komponentów w aktywnej bibliotece schematów, co pozwala zaznaczać i edytować wiele obiektów z większą precyzją i wydajnością. Można określić sposób wyświetlania obiektów w zależności od tego, czy spełniają kryteria wyszukiwania filtra, czy też nie.
Dostęp do panelu
Panel można otworzyć na następujące sposoby:
- Kliknij przycisk Panele w prawym dolnym rogu obszaru roboczego, a następnie wybierz SCHLIB Filter.
- Wybierz View » Panels » SCHLIB Filter z menu głównego.
- Użyj skrótu klawiaturowego F12.
Definiowanie zakresu filtrowania
Lewa część panelu SCHLIB Filter zawiera elementy sterujące służące do definiowania (ograniczania) zakresu filtrowania.
Dostępne są następujące opcje zakresu:
- All Objects — stosuje filtr do wszystkich obiektów projektu.
- Selected Objects — stosuje filtr tylko do aktualnie zaznaczonych obiektów projektu.
- Non Selected Objects — stosuje filtr tylko do obiektów projektu, które nie są aktualnie zaznaczone.
- Whole Library — określa, czy filtrowanie jest stosowane tylko do aktywnego komponentu (opcja wyłączona), czy do wszystkich komponentów w aktywnym dokumencie biblioteki schematów (opcja włączona).
Definiowanie zapytań filtrujących
Środkowa część panelu SCHLIB Filter umożliwia tworzenie filtrów przez wprowadzanie zapytań logicznych.
Zapytanie można wpisać bezpośrednio w polu. Podczas wpisywania będzie wyświetlana lista podpowiedzi z możliwymi słowami kluczowymi.
Pomocnik zapytań
Oprócz listy podpowiedzi panel oferuje również narzędzie Query Helper, które pomaga w tworzeniu zapytań. Może być ono bardzo przydatne, jeśli nie masz pewności co do składni zapytania lub słów kluczowych, których można użyć. Aby skorzystać z Query Helper, kliknij przycisk Helper, aby otworzyć okno dialogowe Query Helper. Działający w tle silnik zapytań analizuje dokument i wyświetla listę wszystkich dostępnych obiektów wraz z ogólnymi słowami kluczowymi, których można używać w zapytaniach.
W górnej części okna dialogowego utwórz wyrażenie zapytania przy użyciu dostępnych SCH Functions i System Functions. Środkowa część okna dialogowego udostępnia szereg operatorów do tworzenia wyrażeń. Użyj przycisku Check Syntax, aby sprawdzić poprawność składni wyrażenia.
Po zdefiniowaniu wyrażenia zapytania zgodnie z wymaganiami kliknij OK, aby załadować zapytanie do środkowej części panelu SCHLIB Filter. Zastosuj filtr za pomocą przycisku Apply.
Po zastosowaniu filtra do całej biblioteki wyprowadzenia spełniające jego kryteria zostaną wyróżnione również we wszystkich pozostałych komponentach.
Więcej informacji na temat stosowania filtrów znajdziesz poniżej w sekcji Applying and Clearing a Filter.
Definiowanie wyróżniania wyników filtrowania
Przed zastosowaniem zapytania w panelu SCHLIB Filter najlepiej określić sposób wizualnego prezentowania wyników filtrowania w obszarze roboczym edytora projektu. Prawa część panelu udostępnia różne opcje, które łącznie tworzą zestaw ustawień wyróżniania dla filtrowania trwałego.
Opcje Objects passing the filter pozwalają określić sposób wyświetlania w obszarze roboczym wszystkich obiektów objętych zakresem filtra i spełniających warunki jego wyrażenia zapytania.
- Select - po włączeniu (domyślnie) przefiltrowane obiekty zostaną zaznaczone w obszarze roboczym.
- Zoom - po włączeniu (domyślnie) przefiltrowane obiekty zostaną powiększone i wyśrodkowane (w miarę możliwości) w oknie edytora biblioteki. Sposób powiększania można określić za pomocą opcji Zoom Library Components ustawianych na stronie Schemat - Automatyczne powiększanie biblioteki w oknie dialogowym Preferences.
Z kolei opcje Objects not passing the filter pozwalają określić sposób wyświetlania w obszarze roboczym wszystkich obiektów, które do not są objęte zakresem filtra i/lub nie spełniają warunków jego wyrażenia zapytania.
- Deselect - po włączeniu (domyślnie) zaznaczenie wszystkich obiektów nieobjętych zakresem filtra zostanie usunięte w obszarze roboczym.
- Mask out - po włączeniu (domyślnie) wszystkie obiekty nieobjęte zakresem filtra zostaną zamaskowane w oknie edytora biblioteki. Użyj suwaka, aby określić poziom maskowania.
Stosowanie i usuwanie filtra
Po zdefiniowaniu zapytania i odpowiednim ustawieniu opcji w panelu można zastosować filtr, klikając przycisk Apply w panelu lub naciskając Enter.
Aby usunąć aktualnie zastosowany filtr z poziomu panelu, usuń wyrażenie zapytania w jego środkowej części (zaznacz je i usuń), a następnie kliknij przycisk Apply lub naciśnij Enter. Wszystkie obiekty w obszarze roboczym projektu odzyskają pełną widoczność i będzie można je zaznaczać oraz edytować.
Aby usunąć filtrowanie w obszarze roboczym i pozostawić wyrażenie zapytania w środkowej części panelu, użyj przycisku Clear Current Filter na pasku narzędzi Sch Lib Standard (skrót Shift+C).
Menu kontekstowe
Kliknięcie prawym przyciskiem myszy w panelu SCHLIB Filter umożliwia dostęp do dodatkowych opcji i poleceń w menu kontekstowym.
Menu udostępnia następujące polecenia:
- Add to Favorites - służy do dodawania wyrażenia zapytania aktualnie wyświetlanego w środkowej części panelu do listy ulubionych zapytań. Zapytanie pojawi się jako nowa pozycja na karcie Favorites w oknie dialogowym Menedżer wyrażeń. Po dodaniu zapytania do listy ulubionych zostanie ono wyświetlone na górze menu kontekstowego. Menu wyświetla dziesięć zapytań ostatnio dodanych do listy ulubionych (najnowsze na górze), umożliwiając szybki dostęp do ulubionych wyrażeń zapytań i ich ponowne użycie.
- Organize Favorites - służy do otwierania karty Favorites w oknie dialogowym Menedżer wyrażeń, w którym można porządkować pozycje na liście ulubionych zapytań (zmieniać ich nazwy i usuwać je).
- Examples - kliknij, aby otworzyć podmenu z predefiniowanymi przykładowymi filtrami. Wybranie przykładowego filtra spowoduje załadowanie powiązanego z nim wyrażenia zapytania do środkowej części panelu.
- History - kliknij, aby otworzyć podmenu zawierające dziewięć ostatnio używanych wyrażeń zapytań z listy historii zapytań panelu. Kliknij pozycję More, aby otworzyć kartę History w oknie dialogowym Menedżer wyrażeń, w którym można przeglądać pełną historię zapytań i stosować wybrane zapytania, a także w razie potrzeby wyczyścić historię.
- Show Scope Options - służy do przełączania widoczności sekcji zakresu filtra w panelu.
- Show Masking Options - służy do przełączania widoczności sekcji wyróżniania wyników filtrowania w panelu.
Uwagi
Ogólne
- Naciśnięcie klawisza F12 przełącza widoczność panelu w obszarze roboczym.
- Filtrowanie zastosowane przy użyciu zapytań z panelu SCHLIB Filter jest trwałe w obrębie sesji. Filtr trwały należy usunąć za pomocą odpowiedniej operacji Clear (zastosowania pustego zapytania z panelu SCHLIB Filter).
- W zależności od kształtu i rozmiaru samego panelu SCHLIB Filter jego zawartość będzie dynamicznie rozmieszczana w poziomie lub w pionie.
Tworzenie wyrażeń zapytań
- Zdecydowanie zaleca się stosowanie nawiasów zawsze, gdy istnieje jakakolwiek możliwość nieprawidłowej interpretacji zapytania.
-
Nawiasy mają najwyższy priorytet w hierarchii zdefiniowanej dla poszczególnych dostępnych operatorów, która określa sposób interpretacji zapytań przez oprogramowanie (gdy użytkownik nie zastosował nawiasów). Kolejność priorytetów jest następująca:
Brackets
Not
^, *, /, Div, Mod, And
+, -, Or, Xor
=, <>, <, >, <=, >=
&&, ||
Ta kolejność priorytetów jest podobna do stosowanej w językach typu Pascal. Częste używanie nawiasów eliminuje jednak wątpliwości i ułatwia innym czytanie utworzonych zapytań. - Niejednoznaczności są rozstrzygane od lewej do prawej.
- Wyrażenia w nawiasach są obliczane od najbardziej wewnętrznych do najbardziej zewnętrznych, a na tym samym poziomie — od lewej do prawej.
Panel PCB Filter

Panel PCB Filter
Podsumowanie
Panel PCB Filter udostępnia elementy sterujące umożliwiające tworzenie filtrów za pomocą zapytań logicznych. Zdefiniowany filtr można następnie zastosować do aktywnej płytki PCB, co pozwala zaznaczać i edytować wiele obiektów z dużą precyzją i wydajnością.
Dostęp do panelu
Panel jest dostępny w edytorze PCB na następujące sposoby:
- Kliknij przycisk Panele w prawym dolnym rogu obszaru roboczego, a następnie wybierz PCB Filtr.
- Wybierz View » Panels » PCB Filtr z menu głównego.
- Użyj skrótu klawiaturowego F12 .
Sekcje panelu
Panel PCB Filter składa się z trzech obszarów. Pierwsze dwa to listy umożliwiające wybór pozycji, które wspólnie określają zakres filtrowania: Object i Layer.
Trzeci obszar, Filter, wyświetla zapytanie utworzone na podstawie aktualnie wybranych obiektów i warstw.
Tworzenie prostych wyrażeń filtrujących
Główny obszar panelu udostępnia elementy sterujące do szybkiego tworzenia prostych wyrażeń filtrujących obejmujących dowolną kombinację obiektów. Typy obiektów są rozmieszczone w „macierzy obiektów” i podzielone na obiekty sieci (Net), obiekty komponentów (Comp) oraz obiekty niezależne (Free). Poniższa podstawowa lista obiektów powtarza się we wszystkich trzech grupach:
- Ścieżka
- Łuk
- Przelotka
- Pad
- Wypełnienie
- Region
Obiekt Text jest dostępny w grupach Comp i Free , jednak ponieważ ten typ obiektu nie jest powiązany z siecią, nie należy do grupy Net . Ponadto grupa Free obejmuje również: Component, Component Body, Room i Polygon.
Jeśli wybrano na przykład „Komponent” i „Warstwa górna”, w widoku płytki zostaną wyróżnione komponenty na warstwie górnej. Wybory w obu sekcjach panelu składają się na łączny efekt wieloetapowego filtrowania, co pozwala szybko wyróżnić dowolny typ obiektu projektu.
Aby użyć obiektu podczas tworzenia wyrażenia filtrującego, czyli filtrować według tego obiektu, zaznacz odpowiednie pole wyboru powiązane z nim w macierzy obiektów. Polecenia dostępne w menu kontekstowym tego obszaru umożliwiają szybkie zaznaczenie lub odznaczenie wszystkich pozycji w macierzy albo odwrócenie stanu wszystkich pól wyboru w macierzy.
Użyj obszaru Layer panelu, aby ograniczyć filtr do określonej warstwy, kilku warstw lub określonej klasy warstw. Na liście znajdują się:
-
Klasy warstw zdefiniowane dla płytki, z następującymi klasami domyślnymi:
- <All Layers>
- <Component Layers>
- <Electrical Layers>
- <Signal Layers>
- Warstwy zdefiniowane w stosie warstw (przedstawione w Edytorze stosu warstw).
- Górna i dolna warstwa maski pasty lutowniczej.
Podczas wybierania opcji filtrowania wynikowe wyrażenie zapytania jest tworzone dynamicznie i wyświetlane w obszarze Filter panelu. Po zdefiniowaniu wyrażenia zapytania filtra zgodnie z potrzebami należy zastosować je w osobnym kroku. W tym celu kliknij przycisk Apply to All u dołu panelu. Jeśli natomiast chcesz zastosować filtr tylko do obiektów aktualnie zaznaczonych w obszarze roboczym, kliknij przycisk Apply to Selected.
Filtrowanie według obiektu
Wybór na liście Object panelu filtruje widok płytki tak, aby wyświetlał podstawowe obiekty projektu. Wszystkie obiekty zostaną wyróżnione, chyba że zostanie to zmienione przez ustawienia na listach filtrów Object lub Layer .

Płytka z wybranymi pozycjami Component Body i Pad (In Any Component) w sekcji Object. Layer ma ustawioną wartość <All>.

Płytka z opcją Object ustawioną na Tracks (In Any Net) i Pads (In Any Net). Layer ma ustawioną wartość <All>.
Filtrowanie według warstwy
Wybór na liście Layer panelu filtruje widok płytki tak, aby wyświetlał obiekty na wskazanej fizycznej warstwie projektu (warstwy sygnałowe, maski i opisu). Wszystkie obiekty na pasujących warstwach zostaną wyróżnione, chyba że zostanie to zmienione przez ustawienia na listach filtrów Layer lub Objects .

Płytka z opcją Object ustawioną na Components i Pads (In Any Component). Layers ma ustawioną wartość Top Layer.

Płytka z opcją Object ustawioną na Ścieżki (w dowolnej Net). Layer ma ustawioną wartość Bottom Layer.
Zaznaczanie przefiltrowanych obiektów
Łączne działanie filtrów dostępnych w panelu ułatwia zarówno wyświetlanie, jak i zaznaczanie interesujących obiektów projektu płytki.
Zaznaczać można tylko wyróżnione (przefiltrowane) obiekty, co ułatwia ich lokalizowanie, edycję i wyszukiwanie informacji o nich.
Usuwanie filtra
Usuń aktualnie zastosowany filtr, klikając przycisk Clear .
Ustawianie wizualnych efektów filtrowania
Efekt wizualny filtrowania zastosowanego do dokumentu w obszarze roboczym jest określany przez szereg ustawień wyróżniania. Efekt w widoku edytora można ustawić na Normal, Mask lub Dim, przy czym w praktyce Mask daje najbardziej wyraźne wyróżnienie.
Lista rozwijana Normal / Mask / Dim udostępnia opcje wizualnego rozróżniania obiektów spełniających i niespełniających kryteriów filtra w obszarze roboczym.

Wybierz sposób wizualizacji wyników filtrowania z listy rozwijanej trybu maskowania.
Efekt wizualnego wyróżnienia dla poszczególnych trybów maskowania:
- Normal — obiekty spełniające kryteria filtra są widoczne w obszarze roboczym, a wygląd pozostałych obiektów nie ulega zmianie.
- Mask — obiekty spełniające kryteria filtra są wyróżnione w obszarze roboczym, a wszystkie pozostałe obiekty są wyświetlane monochromatycznie.
- Dim — obiekty spełniające kryteria filtra są wyróżnione w obszarze roboczym, a wszystkie pozostałe obiekty zachowują swoje kolory, ale są przyciemnione.
Definiowanie zapytań filtrujących
Środkowa część panelu zawiera elementy sterujące umożliwiające tworzenie filtrów przez wprowadzanie zapytań logicznych.
Zapytanie można wpisać bezpośrednio w polu. Podczas wpisywania pojawia się pomocnicza lista możliwych słów kluczowych.
Dostępne są dwie funkcje ułatwiające tworzenie zapytań — Query Helper i Query Builder. Mogą być bardzo przydatne, jeśli nie masz pewności co do składni zapytania lub dostępnych słów kluczowych.
Asystent zapytań
Aby skorzystać z asystenta zapytań, kliknij przycisk Helper, aby otworzyć okno dialogowe Query Helper. Silnik zapytań analizuje dokument i wyświetla listę wszystkich dostępnych obiektów wraz z ogólnymi słowami kluczowymi, których można używać w zapytaniach.
W górnej części okna dialogowego utwórz wyrażenie zapytania, korzystając z dostępnych PCB Functions, PCB Object Lists i System Functions. Środkowa część okna dialogowego udostępnia szereg operatorów do tworzenia wyrażenia. Użyj przycisku Check Syntax, aby sprawdzić poprawność składni wyrażenia.
Po zdefiniowaniu odpowiedniego wyrażenia zapytania kliknij OK, aby wczytać zapytanie do środkowej części panelu i przygotować je do zastosowania filtra.
Kreator zapytań
Aby skorzystać z kreatora zapytań, kliknij przycisk Builder w panelu, aby otworzyć okno dialogowe Building Query from Board. Umożliwia ono utworzenie zapytania wskazującego określone obiekty w dokumencie projektu przez zbudowanie ciągu warunków połączonych operatorami AND i/lub OR. Lewa strona okna dialogowego służy do określania warunków niezbędnych do wskazania żądanego zbioru obiektów. Początkowo wpis w kolumnie Condition Type/Operator ma wartość Add first condition. Jednokrotne kliknięcie tego wpisu powoduje wyświetlenie listy rozwijanej typów warunków.
Na liście znajdują się wyłącznie typy warunków mające zastosowanie do projektu płytki.
Wybierz żądany warunek, a następnie kliknij w kolumnie Condition Value, aby wyświetlić listę rozwijaną możliwych wartości dla danego typu warunku. Podczas definiowania warunku po lewej stronie okna dialogowego po prawej stronie wyświetlany jest podgląd aktualnie tworzonego zapytania.
Dodawaj kolejne warunki, aby odpowiednio zawęzić docelowy zbiór obiektów projektu. Warunki można łączyć operatorami AND lub OR. Domyślnym operatorem logicznym jest AND, który jest automatycznie wstawiany po dodaniu kolejnego warunku.
Aby zmienić operator logiczny między warunkami, kliknij wpis AND lub OR w kolumnie Condition Type/Operator, a następnie wybierz żądany operator. Podgląd zapytania zostanie odpowiednio zaktualizowany.
Określanie kolejności wykonywania operacji
Przyciski
i
u góry okna dialogowego Building Query from Board umożliwiają dodawanie i usuwanie nawiasów wokół aktualnie zaznaczonego warunku (zwiększanie i zmniejszanie wcięcia). Pozwala to nadać pierwszeństwo określonym warunkom połączonym logicznie operatorami AND lub OR.
Rozważmy na przykład następujące zapytanie:
InNet('5V') AND (OnLayer('TopLayer')
Dla pierwszego warunku wybrano typ Belongs to Net i wartość 16M_IN. Następnie dodano kolejny warunek typu Exists on Layer z wartością TopLayer.
Na tym etapie, przy zaznaczonym drugim warunku w oknie dialogowym, kliknięto przycisk strzałki w prawo. Wokół drugiego warunku automatycznie dodano nawiasy i można teraz dodać warunek wewnątrz tej pary nawiasów.
Następnie wewnątrz nawiasów dodano trzeci warunek typu Object Kind is z wartością Track.
Użyj listy rozwijanej Show Level w lewym górnym rogu okna dialogowego, aby sterować wyświetlaniem poziomów w uporządkowanym ciągu warunków. W praktyce pozwala to rozwijać i zwijać widok nawiasów. Dodanie nawiasów tworzy nowy poziom. Można wyświetlać poziomy od 1 do 5, natomiast dla kolejnych dodanych poziomów należy użyć opcji Show All Levels.
Możesz też kliknąć symbole rozwijania lub zwijania (powiązane z warunkiem ujętym w nawiasy), aby odpowiednio wyświetlić kolejne poziomy lub ukryć bieżący poziom (wraz ze wszystkimi niższymi poziomami). Przyciski
i
u góry okna dialogowego również umożliwiają rozwijanie i zwijanie aktualnie zaznaczonego warunku.
Użyj przycisków
i
u góry okna dialogowego, aby przenieść zaznaczony warunek w ciągu zapytania. W przypadku warunku z poziomami podrzędnymi (czyli warunku ujętego w nawiasy) można przenieść dowolny warunek w strukturze poziomów. Gdy poziomy są rozwinięte, warunek można przenosić w dół lub w górę między poziomami. Gdy poziomy są zwinięte, warunek jest przenoszony z pominięciem ich wewnętrznej struktury.
Aby usunąć warunek, zaznacz go i kliknij przycisk
u góry okna dialogowego lub użyj klawisza Delete.
Po zdefiniowaniu odpowiedniego wyrażenia zapytania kliknij OK, aby wczytać zapytanie do środkowej części panelu PCB Filter i przygotować je do zastosowania filtra.
Tworzenie reguł projektowych
Panel PCB Filter umożliwia także utworzenie reguły projektowej, której zakres zastosowania będzie określany przez wyrażenie zapytania aktualnie zdefiniowane w środkowej części panelu.
Aby dodać nową regułę projektową, kliknij przycisk Create Rule w panelu PCB Filter. Otworzy się okno dialogowe Choose Design Rule Type.
W tym oknie dialogowym wyświetlane są wszystkie kategorie i typy reguł dostępne w dokumencie PCB. Wybierz typ reguły, którą chcesz utworzyć, a następnie kliknij OK (lub kliknij dwukrotnie bezpośrednio dany wpis). Otworzy się okno dialogowe PCB Rules and Constraints Editor.
Nazwa nowo utworzonej reguły jest zaznaczona w drzewie nawigacyjnym po lewej stronie. Wyrażenie zapytania reguły znajduje się w prawym górnym obszarze okna dialogowego.
Tworzona jest reguła wybranego typu i wyświetlane jest jej główne okno edycji, w którym można zdefiniować szczegółowe ograniczenia. Wyrażenie zapytania z panelu PCB Filter zostaje wprowadzone w obszarze Full Query okna dialogowego. Dostosuj ustawienia konfiguracji reguły do potrzeb i zastosuj nową regułę.
Stosowanie i usuwanie filtra
Po zdefiniowaniu zapytania i odpowiednim ustawieniu opcji w panelu można zastosować filtr, klikając jeden z przycisków Apply w panelu lub klikając Enter.
Aby usunąć aktualnie zastosowany filtr z poziomu panelu, wyczyść (zaznacz i usuń) wyrażenie zapytania w środkowym obszarze panelu, a następnie kliknij jeden z przycisków Apply lub naciśnij Enter. Wszystkie obiekty w obszarze roboczym projektu staną się ponownie w pełni widoczne i dostępne do zaznaczania oraz edycji.
Menu kontekstowe
Kliknięcie prawym przyciskiem myszy w panelu PCB Filter zapewnia dostęp do dodatkowych opcji i poleceń w menu podręcznych.
Kliknięcie prawym przyciskiem myszy w obszarze Object lub Layer panelu otwiera menu kontekstowe z następującymi opcjami:
- Toggle Check — wybierz, aby przełączyć stan opcji. Aktualnie zaznaczone opcje zostaną odznaczone, a niezaznaczone — zaznaczone.
- Check All — wybierz, aby zaznaczyć wszystkie dostępne opcje.
- Uncheck All — wybierz, aby odznaczyć wszystkie dostępne opcje.
Uwagi
Ogólne
- Naciśnięcie klawisza F12 przełącza widoczność panelu w obszarze roboczym.
- Kreator zapytań (okno dialogowe Building Query from Board) zapewnia prostą metodę tworzenia zapytań z wykorzystaniem kontekstowych typów warunków i wartości, które pozwalają korzystać wyłącznie z odpowiednich „elementów składowych”. Do tworzenia zaawansowanych zapytań, z pełną obsługą słów kluczowych i składni operatorów, służy okno dialogowe Query Helper.
- Ponieważ opcje wyświetlania obiektów spełniających i niespełniających warunków zastosowanego filtra są rozdzielone, można skutecznie stosować nowe zapytania filtrujące do wyników poprzedniego filtrowania.
Tworzenie wyrażeń zapytań
-
Zdecydowanie zaleca się stosowanie nawiasów zawsze, gdy istnieje możliwość, że zapytanie nie zostanie poprawnie zinterpretowane.
-
Nawiasy mają najwyższy priorytet w hierarchii pierwszeństwa zdefiniowanej dla dostępnych operatorów, która określa sposób interpretowania zapytań przez oprogramowanie (gdy użytkownik nie zastosował nawiasów). Kolejność ta jest następująca:
Brackets
Not
^, *, /, Div, Mod, And
+, -, Or, Xor
=, <>, <, >, <=, >=
&&, ||
Ta hierarchia pierwszeństwa jest podobna do stosowanej w językach typu Pascal. Jednak częste używanie nawiasów eliminuje wątpliwości i ułatwia innym osobom odczytywanie utworzonych zapytań. -
Niejednoznaczności są rozstrzygane od lewej do prawej.
-
Wyrażenia w nawiasach są obliczane od najbardziej wewnętrznych do zewnętrznych, a na tym samym poziomie — od lewej do prawej.
Panel PCBLIB Filter
Podsumowanie
Panel PCBLIB Filter udostępnia elementy sterujące umożliwiające tworzenie filtrów za pomocą zapytań logicznych. Zdefiniowany filtr można następnie zastosować do aktywnego footprintu komponentu PCB lub do wszystkich footprintów komponentów w aktywnej bibliotece PCB, co pozwala zaznaczać i edytować wiele obiektów z dużą precyzją i wydajnością.
Dostęp do panelu
Panel jest dostępny w edytorze bibliotek PCB na następujące sposoby:
- Kliknij przycisk Panels w prawym dolnym rogu obszaru roboczego, a następnie wybierz pozycję PCBLIB Filter.
- Wybierz View » Panels » PCBLIB Filter z menu głównego.
- Użyj skrótu klawiaturowego F12.
Sekcje panelu
Panel PCBLIB Filter składa się z trzech obszarów. Pierwsze dwa to listy umożliwiające wybór pozycji, które wspólnie określają zakres filtrowania: Object i Layer. Trzeci obszar, Filter, wyświetla zapytanie utworzone na podstawie aktualnie wybranych obiektów i warstw.
Tworzenie prostych wyrażeń filtrujących
Główny obszar panelu udostępnia elementy sterujące do szybkiego tworzenia prostych wyrażeń filtrujących obejmujących dowolną kombinację obiektów. Typy obiektów są rozmieszczone w „macierzy obiektów” i podzielone na obiekty należące do sieci (Net), obiekty komponentów (Comp) lub obiekty niezależne (Free). Poniższa lista podstawowych obiektów powtarza się w każdej z tych trzech grup:
- Ścieżka
- Łuk
- Przelotka
- Pad
- Wypełnienie
- Region
Obiekt Text jest dostępny w grupach Comp i Free , jednak ponieważ ten typ obiektu nie obsługuje przypisania do sieci, nie należy do grupy Net . Ponadto grupa Free obejmuje również Component, ComponentBody, Room i Polygon.
Jeśli na przykład wybrano „Components” i „Top Layer”, w widoku płytki zostaną wyróżnione komponenty na warstwie górnej. Wybory w obu sekcjach panelu odzwierciedlają łączny efekt wielu etapów filtrowania, co można wykorzystać do szybkiego wyróżniania dowolnego typu obiektów projektu.
Aby użyć obiektu podczas tworzenia wyrażenia filtrującego, czyli filtrować według tego obiektu, zaznacz odpowiadające mu pole wyboru w macierzy obiektów. Polecenia dostępne w menu kontekstowym tego obszaru pozwalają szybko zaznaczyć lub odznaczyć wszystkie pozycje w macierzy albo przełączyć stan wszystkich jej pól wyboru.
Użyj obszaru Layer, aby ograniczyć filtr do określonej warstwy, kilku warstw lub określonej klasy warstw. Wyświetlane pozycje obejmują:
-
Klasy warstw zdefiniowane dla płytki, których domyślne pozycje to:
- <All Layers>
- <Component Layers>
- <Electrical Layers>
- <Signal Layers>
- Warstwy zdefiniowane w stosie warstw (przedstawione w Layer Stack).
- Górną i dolną warstwę maski pasty lutowniczej.
Podczas wybierania opcji filtrowania wynikowe wyrażenie zapytania jest tworzone dynamicznie i wyświetlane w obszarze Filter panelu. Po zdefiniowaniu wyrażenia zapytania filtra zgodnie z wymaganiami należy zastosować je w osobnym kroku. W tym celu kliknij przycisk Apply to All u dołu panelu. Jeśli natomiast filtr ma zostać zastosowany tylko do obiektów aktualnie zaznaczonych w obszarze roboczym, użyj przycisku Apply to Selected.
Stosowanie filtrowania
Komponenty biblioteki PCB składają się z podstawowych obiektów (łuków, padów, ścieżek itp.) rozmieszczonych na różnych warstwach płytki. Obiekty te są „swobodne” lub należą do obiektu grupowego. Pamiętaj, że wybranie Free w obszarze Object spowoduje wyróżnienie tylko tych obiektów, które nie są częścią obiektu grupowego.
Filtrowanie według obiektu
Wybór na liście Object w panelu filtruje widok płytki tak, aby pokazywał podstawowe obiekty projektu. Wszystkie obiekty zostaną wyróżnione, chyba że ustawienia na liście filtrów Layer określają inaczej.

Przykładowa płytka z opcjami Track i Arc wybranymi w sekcji Object. Layer ma ustawioną wartość Top Overlay.
Filtrowanie według warstwy
Wybór na liście Layers w panelu filtruje widok płytki tak, aby pokazywał obiekty na wskazanej fizycznej warstwie projektu (warstwach sygnałowych, maski i opisowych). Wszystkie obiekty na odpowiednich warstwach zostaną wyróżnione, chyba że ustawienia na liście filtrów Object określają inaczej.

Przykładowa płytka z opcją Object ustawioną na Pad. Layer i wartością Top Layer.
Zaznaczanie przefiltrowanych obiektów
Łączne działanie filtrów dostępnych w panelu PCBLIB Filter ułatwia zarówno wyświetlanie, jak i zaznaczanie interesujących obiektów projektu płytki.
Zaznaczać można tylko wyróżnione (przefiltrowane) obiekty, co ułatwia ich znajdowanie, edytowanie i uzyskiwanie informacji o nich.
Usuwanie filtra
Aby usunąć aktualnie zastosowany filtr, użyj przycisku Clear w panelu.
Ustawianie wizualizacji filtrowania
Efekt wizualny filtrowania dokumentu w obszarze roboczym jest określany przez zestaw opcji wyróżniania. Efekt stosowany w widoku edytora można ustawić na Normal, Mask lub Dim, przy czym w praktyce Mask zapewnia najbardziej wyraziste wyróżnienie.
Lista rozwijana Normal / Mask / Dim zawiera opcje umożliwiające wizualne odróżnienie obiektów przefiltrowanych od pozostałych w obszarze roboczym.

Wybierz sposób wizualizacji filtrowania z listy rozwijanej trybu maskowania.
Efekt wizualnego wyróżnienia dla poszczególnych trybów maskowania:
- Normal — przefiltrowane obiekty są widoczne w obszarze roboczym, a wygląd pozostałych obiektów nie zmienia się.
- Mask — przefiltrowane obiekty są wyróżnione w obszarze roboczym, a wszystkie pozostałe obiekty są wyświetlane monochromatycznie.
- Dim — przefiltrowane obiekty są wyróżnione w obszarze roboczym, a wszystkie pozostałe obiekty zachowują swoje kolory, ale są przyciemnione.
Definiowanie zapytań filtrujących
Środkowy obszar panelu umożliwia tworzenie filtrów przez wprowadzanie zapytań logicznych.
Zapytanie można wpisać bezpośrednio w polu. Podczas wpisywania pojawi się lista podpowiedzi z dostępnymi słowami kluczowymi.
Tworzenie zapytań wspomagają dwie funkcje — Pomocnik zapytań i Konstruktor zapytań. Mogą one być bardzo przydatne, jeśli nie masz pewności co do składni zapytania lub dostępnych słów kluczowych, których chcesz użyć.
Pomocnik zapytań
Aby skorzystać z Pomocnika zapytań, kliknij przycisk Helper, aby otworzyć okno dialogowe Pomocnik zapytań. Działający w tle silnik zapytań analizuje dokument i wyświetla listę wszystkich dostępnych obiektów oraz ogólnych słów kluczowych do wykorzystania w zapytaniach.
W górnej części okna dialogowego utwórz wyrażenie zapytania, korzystając z dostępnych PCB Functions, PCB Object Lists i System Functions. Środkowy obszar okna dialogowego zawiera zestaw operatorów do wykorzystania przy tworzeniu wyrażenia. Użyj przycisku Check Syntax, aby sprawdzić poprawność składni wyrażenia.
Po zdefiniowaniu wyrażenia zapytania zgodnie z wymaganiami kliknij OK, aby wczytać zapytanie do środkowego obszaru panelu PCBLIB Filter i przygotować je do zastosowania filtra.
Konstruktor zapytań
Aby skorzystać z Konstruktora zapytań, kliknij przycisk Builder w panelu PCBLIB Filter, aby otworzyć okno dialogowe Tworzenie zapytania na podstawie płytki.
To okno dialogowe umożliwia tworzenie zapytania wskazującego określone obiekty w dokumencie projektu przez proste zestawianie warunków połączonych operatorami AND i/lub OR.
Po lewej stronie okna dialogowego określa się warunki wymagane do wskazania żądanego zbioru obiektów. Początkowo w kolumnie Condition Type/Operator widnieje wpis Add first condition. Kliknij go raz, aby otworzyć listę rozwijaną typów warunków.
Na liście znajdują się tylko typy warunków mające zastosowanie do projektu płytki.
Wybierz warunek, a następnie kliknij w kolumnie Condition Value, aby uzyskać dostęp do listy rozwijanej możliwych wartości dla tego typu warunku. Podczas definiowania warunku po lewej stronie okna dialogowego po prawej stronie wyświetlany jest podgląd aktualnie tworzonego zapytania.
Dodawaj kolejne warunki, aby odpowiednio zawęzić docelowy zbiór obiektów projektu. Warunki można łączyć operatorami AND lub OR. Domyślnym operatorem logicznym jest AND i jest on wstawiany automatycznie po dodaniu kolejnego warunku.
Aby zmienić operator logiczny między warunkami, kliknij wpis AND lub OR w kolumnie Condition Type/Operator, a następnie wybierz żądany operator. Podgląd zapytania zostanie odpowiednio zaktualizowany.
Określanie kolejności wykonywania
Przyciski
i
u góry okna dialogowego Tworzenie zapytania na podstawie płytki umożliwiają dodawanie i usuwanie nawiasów wokół aktualnie zaznaczonego warunku (zwiększanie i zmniejszanie wcięcia). Pozwala to określić pierwszeństwo wykonywania wybranych warunków połączonych operatorami logicznymi AND lub OR.
Dla pierwszego warunku ustawiono typ Exists on Layer z wartością Top Layer. Następnie dodano kolejny warunek typu Object Kind is z wartością Arc.
Na tym etapie, po zaznaczeniu drugiego warunku w oknie dialogowym, kliknięto przycisk strzałki w prawo. Wokół drugiego warunku automatycznie dodano nawiasy, dzięki czemu można teraz dodać kolejny warunek wewnątrz tej pary nawiasów.
Następnie wewnątrz nawiasów dodawany jest trzeci warunek typu In Any Polygon.
Użyj listy rozwijanej Show All Levels w lewym górnym rogu okna dialogowego, aby sterować wyświetlaniem poziomów w hierarchicznej strukturze warunków. W praktyce powoduje to rozwijanie lub zwijanie nawiasów. Dodanie nawiasów tworzy nowy poziom. Można wyświetlać poziomy 1–5, natomiast w przypadku kolejnych dodanych poziomów należy użyć opcji Show All Levels.
Można też kliknąć symbole rozwijania lub zwijania powiązane z warunkiem ujętym w nawiasy, aby odpowiednio wyświetlić kolejne poziomy lub ukryć bieżący poziom (i wszystkie poziomy poniżej). Przyciski
i
u góry okna dialogowego również umożliwiają rozwijanie lub zwijanie aktualnie zaznaczonego warunku.
Użyj przycisków
i
u góry okna dialogowego, aby przenieść zaznaczony warunek w tworzonym zapytaniu. W przypadku warunku zawierającego podpoziomy (czyli warunku ujętego w nawiasy) można przenieść dowolny warunek w strukturze poziomów. Gdy poziomy są rozwinięte, warunek można przenosić w dół lub w górę między poziomami. Gdy poziomy są zwinięte, warunek jest przenoszony z pominięciem zwiniętej struktury poziomów.
Aby usunąć warunek, zaznacz go, a następnie kliknij przycisk
u góry okna dialogowego lub naciśnij klawisz Delete.
Po zdefiniowaniu wyrażenia zapytania zgodnie z wymaganiami kliknij OK, aby wczytać zapytanie do środkowej części panelu PCBLIB Filter i przygotować je do zastosowania filtru.
Tworzenie reguł projektowych
Panel PCBLIB Filter umożliwia również tworzenie reguł projektowych. Zakres reguły będzie określany przez wyrażenie zapytania aktualnie zdefiniowane w środkowej części panelu.
Aby dodać nową regułę projektową, kliknij przycisk Create Rule w panelu PCBLIB Filter. Otworzy się okno dialogowe Choose Design Rule Type.
To okno dialogowe zawiera listę wszystkich kategorii i typów reguł dostępnych w dokumencie PCB. Wybierz typ reguły, którą chcesz utworzyć, a następnie kliknij OK (lub kliknij dwukrotnie bezpośrednio daną pozycję). Otworzy się okno dialogowe Edytor reguł i ograniczeń PCB.
Nazwa nowo utworzonej reguły jest zaznaczona w drzewie nawigacyjnym po lewej stronie. Wyrażenie zapytania reguły znajduje się w prawym górnym obszarze okna dialogowego.
Zostanie utworzona reguła wybranego typu i wyświetlone jej główne okno edycji, w którym można zdefiniować konkretne ograniczenia. Wyrażenie zapytania z panelu PCBLIB Filter zostanie wprowadzone do obszaru Full Query w oknie dialogowym. Dostosuj konfigurację reguły do potrzeb i zastosuj nową regułę.
Stosowanie i usuwanie filtru
Po zdefiniowaniu zapytania i odpowiednim ustawieniu opcji w panelu można zastosować filtr, klikając przycisk Apply w panelu lub naciskając Enter.
Aby usunąć aktualnie zastosowany filtr z poziomu panelu, usuń wyrażenie zapytania ze środkowej części panelu (zaznacz je i usuń), a następnie kliknij przycisk Apply lub naciśnij Enter. Wszystkie obiekty w obszarze roboczym projektu odzyskają pełną widoczność i będzie można je zaznaczać oraz edytować.
Menu kontekstowe
Kliknij prawym przyciskiem myszy w panelu PCBLIB Filter, aby uzyskać dostęp do dodatkowych opcji i poleceń w menu kontekstowych.
Kliknięcie prawym przyciskiem myszy w obszarze Object lub Layer panelu otwiera menu kontekstowe z następującymi opcjami:
- Toggle Check — przełącza stan opcji. Aktualnie zaznaczone opcje zostaną odznaczone, a odznaczone — zaznaczone.
- Check All — zaznacza wszystkie dostępne opcje.
- Uncheck All — odznacza wszystkie dostępne opcje.
Uwagi
Ogólne
- Naciśnięcie klawisza F12 przełącza widoczność panelu w obszarze roboczym.
- Kreator zapytań (okno dialogowe Tworzenie zapytania na podstawie płytki) zapewnia prosty sposób tworzenia zapytań przy użyciu kontekstowych typów warunków i wartości, które pozwalają korzystać wyłącznie z odpowiednich „elementów składowych”. Do tworzenia zaawansowanych zapytań z pełną specyfikacją słów kluczowych i składnią operatorów służy okno dialogowe Pomocnik zapytań.
- Ponieważ opcje wyświetlania obiektów spełniających i niespełniających warunków zastosowanego filtru są rozdzielone, można stosować kolejne zapytania filtrujące do wyników wcześniejszego filtrowania.
Podczas tworzenia wyrażeń zapytań
- Zdecydowanie zaleca się stosowanie nawiasów zawsze, gdy istnieje jakakolwiek możliwość nieprawidłowej interpretacji zapytania.
-
Nawiasy mają najwyższy priorytet w hierarchii pierwszeństwa zdefiniowanej dla dostępnych operatorów, która określa sposób interpretowania zapytań przez oprogramowanie (gdy użytkownik nie wprowadził nawiasów). Kolejność pierwszeństwa jest następująca:
Brackets
Not
^, *, /, Div, Mod, And
+, -, Or, Xor
=, <>, <, >, <=, >=
&&, ||
Ta kolejność pierwszeństwa jest podobna do stosowanej w językach typu Pascal. Jednak częste stosowanie nawiasów eliminuje wątpliwości i ułatwia innym odczytywanie utworzonych zapytań. - Niejednoznaczności są rozstrzygane od lewej do prawej.
- Wyrażenia w nawiasach są obliczane od najbardziej wewnętrznych do zewnętrznych, a na tym samym poziomie — od lewej do prawej.
Gdzie są wyniki zapytania?
Po zapisaniu zapytania w panelu Filter jak uzyskać dostęp do zwróconych przez nie obiektów? W środowisku Altium Designer istnieją dwa sposoby uzyskiwania dostępu do obiektów i ich edycji.
-
Graficznie — po zastosowaniu filtru domyślnie maskowane są wszystkie obiekty, które nie spełniają warunków zapytania (są przygaszane i nie można ich edytować), a dostępne pozostają tylko obiekty spełniające te warunki. Ten tryb doskonale nadaje się do lokalizowania i przeglądania obiektów w obszarze roboczym. Ponieważ zamaskowanych obiektów nie można edytować, polecenia takie jak Ctrl+A (zaznacz wszystko) dotyczą wyłącznie obiektów zwróconych przez zapytanie.
-
List panel — panel List (Shift+F12) przedstawia dane projektu w widoku przypominającym arkusz kalkulacyjny. Domyślnie wyświetla wszystkie obiekty projektu, ale po zastosowaniu filtra pokazuje tylko obiekty zwrócone przez zapytanie. Panel List oferuje standardowe funkcje sortowania i zaznaczania znane z arkuszy kalkulacyjnych, umożliwiając bezpośrednią edycję jednej lub wielu komórek.
Panele PCB List i SCH List wyświetlają wyniki zapytań PSB/SCH z poprzedniej sekcji.
Opcje wyróżniania
Po każdym zastosowaniu zapytania (lub użyciu funkcji filtrowania danych w inny sposób) każdy obiekt w dokumencie docelowym zostaje uwzględniony w wynikach tego filtrowania. Jednak sposób późniejszego wyświetlania obiektów należących do wyników oraz obiektów, które do nich nie należą, zależy od opcji wyróżniania wybranych w panelu Filter . Dostępne są trzy różne opcje wyróżniania, całkowicie od siebie niezależne, więc można wybrać jedną, dwie lub wszystkie.
Powiększenie
Jeśli podczas stosowania zapytania włączona jest opcja Zoom , widok dokumentu docelowego zostaje zaktualizowany tak, aby pokazywał obszar zajmowany przez wszystkie obiekty należące do wyników. To, czy pozostałe obiekty zostaną wyświetlone w zaktualizowanym widoku, zależy od ich położenia względem tego obszaru. Każdy z nich może więc być widoczny w całości, częściowo lub wcale.
Ta opcja jest często wybierana w połączeniu z jedną lub obiema pozostałymi opcjami. Jeśli opcja Mask nie została włączona, obiekty nienależące do wyników nadal będą wyświetlane w widoku graficznym, o ile znajdują się w jego nowych granicach. Na pierwszy rzut oka wybranie wyłącznie tej opcji może wydawać się bezcelowe, ale czasami warto zaktualizować widok graficzny tak, aby obejmował określone obiekty, bez zmiany stanu zaznaczenia ani maskowania któregokolwiek z obiektów dokumentu.
Zaznaczanie
Gdy opcja Select jest włączona, wszystkie obiekty należące do wyników są zaznaczone, a wszystkie pozostałe — niezaznaczone. Zaznaczone obiekty są wyświetlane w sposób bardziej wyróżniający się niż obiekty niezaznaczone.
Jeśli podczas stosowania bieżącego zapytania wybrana jest opcja Zaznaczanie, wszystkie obiekty należące do zbioru wyników zostają zaznaczone, natomiast wszystkie pozostałe obiekty (nienależące do zbioru wyników) tracą zaznaczenie. Tę opcję wybiera się zazwyczaj tuż przed rozpoczęciem edycji globalnej, ponieważ aktualizowane są wtedy właściwości tylko tych obiektów, które są aktualnie zaznaczone. Opcja Zaznaczanie może jednak przydać się również w innych sytuacjach, na przykład podczas przenoszenia, kopiowania lub usuwania określonych obiektów.
Maskowanie
Opcja wyróżniania Mask określa nowy stan maskowania obiektów w dokumencie docelowym. Po jej wybraniu wszystkie obiekty należące do wyników zostają zamaskowane, natomiast wszystkie pozostałe obiekty pozostają niezamaskowane. Główną cechą zamaskowanych obiektów jest brak możliwości edycji ich samych oraz ich właściwości. (Zamaskowane obiekty są wyświetlane w widoku listy jako przygaszone, ale pojawiają się w nim tylko wtedy, gdy w panelu List jest aktualnie wybrana opcja all objects .) Główną cechą zamaskowanych obiektów jest brak możliwości edycji obiektu i jego właściwości.
Kreator zapytań
Edytor PCB zawiera dedykowane okno dialogowe Query Builder. Umożliwia ono tworzenie złożonych zapytań przez wybieranie warunków z list rozwijanych. Zaletą narzędzia Query Builder jest możliwość tworzenia zapytań obejmujących różne rodzaje obiektów.
Okno dialogowe „Tworzenie zapytania” (część funkcji „Kreator zapytań”) pomaga osobom z mniejszym doświadczeniem w definiowaniu zapytań — automatycznie generuje zapytanie odpowiadające warunkom określonym przez projektanta.
Lewa część tego okna dialogowego zawiera elementy sterujące, które pomagają projektantowi określić, jakie właściwości muszą mieć obiekty dokumentu, aby zostały zwrócone przez zapytanie wygenerowane w tym oknie. Po określeniu lub edycji każdego warunku treść odpowiedniego zapytania jest aktualizowana i wyświetlana w prawej części okna dialogowego. Po zamknięciu tego okna przyciskiem OK (lub Zastosuj) powiązane zapytanie zostaje zastosowane albo jego treść zostaje skopiowana z powrotem do panelu Filtr (w zależności od sposobu otwarcia tego okna).
Okno dialogowe Query Builder można otworzyć z następujących miejsc (jak pokazano na poniższej ilustracji):
- W panelu PCB Filter kliknij przycisk Query Builder , aby utworzyć zapytanie i wczytać jego treść do panelu.
- W oknie dialogowym Edytor reguł i ograniczeń PCB kliknij przycisk Builder , aby utworzyć zapytanie określające, do których obiektów ma zastosowanie dana reguła.
Poniższa ilustracja przedstawia okno dialogowe Query Builder używane do tworzenia zapytania obejmującego zarówno pola lutownicze, jak i przelotki w sieci 5V.

Okno dialogowe Query Builder
Opcje i elementy sterujące okna dialogowego Kreator zapytań
-
Show All Levels — użyj listy rozwijanej, aby sterować wyświetlaniem poziomów w ustrukturyzowanym ciągu warunków. W praktyce pozwala to rozwijać i zwijać widok nawiasów. Dodanie nawiasów tworzy nowy poziom; można wyświetlać poziomy od 1 do 5. Można też kliknąć symbol rozwijania lub zwijania , aby odpowiednio pokazać kolejne poziomy albo ukryć bieżący poziom i wszystkie poziomy podrzędne.
-
— służy do usuwania nawiasów wokół aktualnie zaznaczonego warunku (zmniejszania wcięcia). Pozwala to określić pierwszeństwo niektórych warunków połączonych operatorami logicznymi AND lub OR.
-
— służy do dodawania nawiasów wokół aktualnie zaznaczonego warunku (zwiększania wcięcia). Pozwala to określić pierwszeństwo niektórych warunków połączonych operatorami logicznymi AND lub OR.
-
— służy do przenoszenia zaznaczonego warunku w górę w tworzonym ciągu zapytania. W przypadku warunku z poziomami podrzędnymi (tj. warunku ujętego w nawiasy) można przenieść dowolny warunek w strukturze poziomów. Gdy poziomy są rozwinięte, warunek można przenosić w górę między poziomami. Gdy poziomy są zwinięte, warunek jest przenoszony z pominięciem zwiniętej struktury poziomów.
-
— służy do przenoszenia zaznaczonego warunku w dół w tworzonym ciągu zapytania. W przypadku warunku z poziomami podrzędnymi (tj. warunku ujętego w nawiasy) można przenieść dowolny warunek w strukturze poziomów. Gdy poziomy są rozwinięte, warunek można przenosić w dół między poziomami. Gdy poziomy są zwinięte, warunek jest przenoszony z pominięciem zwiniętej struktury poziomów.
-
— służy do rozwijania symboli w celu pokazania kolejnych poziomów.
-
- służy do zwijania symboli w celu ukrycia bieżącego poziomu (i wszystkich poziomów poniżej).
-
- służy do usuwania wybranego warunku.
- Condition Type/Operator - w tym obszarze określ warunki wymagane do wskazania docelowego zbioru obiektów. Początkowo wpis w kolumnie Condition Type/Operator będzie miał wartość Add first condition. Kliknij ten wpis raz, aby otworzyć listę rozwijaną typów warunków. Zawartość listy zależy od miejsca, z którego otwarto okno dialogowe. Jeśli tworzysz zapytanie dla określonej reguły projektowej w oknie dialogowym PCB Rules And Constraints Editor , lista warunków będzie zawierać tylko typy warunków dostępne dla danego typu reguły.
- Condition Value - wybierz pierwszy warunek, a następnie kliknij w kolumnie Condition Value , aby uzyskać dostęp do listy rozwijanej możliwych wartości dla tego typu warunku. Podczas definiowania warunku w obszarze Query Preview wyświetlany jest podgląd aktualnie tworzonego zapytania.
Kreator zapytań
Kolejnym krokiem w rozwijaniu umiejętności pisania zapytań jest korzystanie z okna dialogowego Query Helper. Okno dialogowe Query Helper zawiera pole Query , w którym można wpisać żądane zapytanie, korzystając również z przycisków składni poniżej pola Query (np. And, Or, <, Not, Like itd.), a także z pełnej listy wszystkich słów kluczowych zapytań w polu Categories .
Okno dialogowe „Kreator zapytań” pomaga projektantom, którzy chcą definiować własne zapytania. Każde słowo kluczowe na liście ma krótki opis, a dostęp do pomocy online można uzyskać, naciskając klawisz F1, gdy dane słowo kluczowe jest zaznaczone. Spowoduje to otwarcie okna dialogowego biblioteki dokumentacji Altium Designer, które zawiera szczegółowe informacje o tym, jakie obiekty w dokumencie są zwracane przez zaznaczone słowo kluczowe, jak go używać, oraz co najmniej jeden przykład jego zastosowania.
Okno dialogowe można otworzyć na następujące sposoby:
- Kliknij przycisk Helper w panelu Filter .
PCB Filter dostęp z panelu
SCH Filter dostęp z panelu
-
W oknie dialogowym Wyszukiwanie w bibliotekach plikowych (otwieranym przez kliknięcie
w prawym górnym rogu panelu Komponenty, a następnie wybranie File-based Libraries Search z menu rozwijanego) kliknij przycisk Helper .
File-based Libraries Search dostęp z okna dialogowego
Użyj sekcji Query u góry okna dialogowego, aby utworzyć wyrażenie zapytania przy użyciu dostępnych funkcji. W polu tekstowym można przejrzeć i dodatkowo edytować wyrażenie wyszukiwania. Aby je edytować, wpisuj tekst bezpośrednio w tym polu. Aby wyszukać konkretne słowa kluczowe do dodania, zacznij pisać. Podczas wpisywania w oknie dialogowym będzie wyświetlane menu rozwijane z dostępnymi słowami kluczowymi pasującymi do dotychczas wpisanego tekstu. Kliknij słowo kluczowe, aby automatycznie uzupełnić wpis. Jeśli żądane słowo kluczowe jest zaznaczone, naciśnięcie Enter również automatycznie uzupełni wpis.
Przejrzyj Categories dostępnych słów kluczowych, aby znaleźć potrzebne. Użyj pola Mask, jeśli nie znasz dokładnego słowa kluczowego. Na przykład w Query Helper edytora schematów wpisanie *har w polu Mask spowoduje znalezienie słów kluczowych odnoszących się konkretnie do wiązek, jak pokazano na poniższej ilustracji. Pamiętaj, że pole Mask działa zarówno w odniesieniu do pola słowa kluczowego Name , jak i pola Description , więc może być najszybszym sposobem znalezienia potencjalnych słów kluczowych.
Kliknij dwukrotnie słowo kluczowe w tabeli, aby dodać je do zapytania w bieżącej pozycji kursora.
Środkowy obszar okna dialogowego zawiera przyciski składni udostępniające szereg operatorów do tworzenia wyrażeń. Więcej informacji o funkcji poszczególnych przycisków składni znajdziesz poniżej w sekcji Operatory logiczne wyrażeń zapytań. Użyj przycisku Check Syntax (w lewym dolnym rogu okna dialogowego), aby sprawdzić poprawność składni wyrażenia.
Historia zapytań
Każde nowe zapytanie wprowadzone i zastosowane w panelu filtrowania (SCH Filter / SCHLIB Filter, PCB Filter / PCBLIB Filter) zostanie dodane do listy historii zapytań. Kliknij przycisk History w panelu, aby uzyskać dostęp do tej listy. Otworzy się okno dialogowe Expression Manager z aktywną kartą History .
Karta Historia w oknie dialogowym Expression Manager zawiera listę wcześniej używanych wyrażeń zapytań. Tutaj pokazano przykładową historię zapytań dla schematu. Najedź kursorem na ilustrację, aby zobaczyć podobną przykładową listę dla PCB.
Aby użyć zapytania z historii, zaznacz jego wpis i kliknij przycisk Apply Expression lub kliknij dwukrotnie bezpośrednio ten wpis. Okno dialogowe zostanie zamknięte, a wyrażenie zapytania zostanie wczytane do środkowego obszaru odpowiedniego panelu filtrowania.
Zapytanie z historii można dodać do listy ulubionych zapytań, zaznaczając jego wpis i klikając przycisk Add To Favorites. Użyj przycisku Clear History, jeśli chcesz wyczyścić listę historii.
Maksymalnie dziewięć ostatnio używanych wyrażeń zapytań z listy będzie dostępnych w podmenu History menu kontekstowego panelu filtrowania.
Ulubione zapytania
Każde zdefiniowane zapytanie można dodać do listy ulubionych zapytań na dwa sposoby:
- Kliknij przycisk Add To Favorites lub kliknij prawym przyciskiem myszy w głównym obszarze Query Expression i wybierz polecenie Add to Favorites z menu kontekstowego, aby dodać wyrażenie zapytania aktualnie zdefiniowane w środkowym obszarze aktywnego panelu filtrowania.
- Wybierz wpis zapytania z historii na karcie History okna dialogowego Expression Manager, a następnie kliknij przycisk Add To Favorites.
Ulubione wyrażenia zapytań są przechowywane na karcie Favorites okna dialogowego Expression Manager, która służy również do zarządzania nimi. Dostęp do niej można uzyskać za pomocą przycisku Favorites w panelu filtrowania (SCH Filter / SCHLIB Filter, PCB Filter / PCBLIB Filter) lub klikając prawym przyciskiem myszy w głównym obszarze Query Expression panelu filtrowania i wybierając polecenie Organize Favorites z menu kontekstowego. Z obszaru projektowego można otworzyć to okno dialogowe za pomocą skrótu klawiaturowego Y, a następnie wybierając Organize Favorites z podręcznego menu filtrowania.
Listę ulubionych zapytań można otworzyć z panelu filtrowania edytora lub z obszaru projektowego za pomocą podręcznego menu filtrowania.
Po dodaniu wyrażenia zapytania do listy Favorites zostaje mu przypisana unikatowa nazwa. Domyślnie przypisywana jest nazwa ogólna — Favorite_n — gdzie n to kolejny dostępny, nieużywany numer. Nazwę wpisu można zmienić w dowolnym momencie, korzystając z jednej z następujących metod:
- Wybierz wpis zapytania, a następnie kliknij przycisk Rename.
- Wybierz wpis zapytania, a następnie wybierz polecenie Edytuj z menu otwieranego prawym przyciskiem myszy.
- Wybierz wpis zapytania, a następnie kliknij ponownie w polu Name.
W każdym przypadku wpisz żądaną nową nazwę, a następnie kliknij poza polem Name, aby zatwierdzić zmianę.
Aby edytować ulubione wyrażenie zapytania, wybierz jego wpis na liście, a następnie kliknij przycisk Edit (lub kliknij prawym przyciskiem myszy i wybierz Edit z menu kontekstowego). Otworzy się okno dialogowe Edit Favorite. Użyj go, aby zmodyfikować nazwę ulubionego zapytania, zmienić samo wyrażenie, a także określić sposób obsługi obiektów projektu (zarówno tych, które spełniają kryteria filtra, jak i tych, które ich nie spełniają).
Zmodyfikuj istniejące ulubione zapytanie za pomocą okna dialogowego Edit Favorite, pokazanego tutaj dla schematów (po lewej) i PCB (po prawej).
Aby usunąć zapytanie z listy Favorites , wybierz jego wpis na liście, a następnie kliknij przycisk Remove lub wybierz polecenie Remove z menu otwieranego prawym przyciskiem myszy. Pojawi się okno dialogowe z prośbą o potwierdzenie usunięcia.
Korzystanie z ulubionych zapytań
Z ulubionych zapytań można korzystać na trzy sposoby:
-
Na karcie Favorites okna dialogowego Expression Manager — wybierz wpis zapytania, a następnie kliknij przycisk Apply Expression lub kliknij dwukrotnie jego wpis. Okno dialogowe zostanie zamknięte, a wyrażenie zapytania zostanie wczytane do środkowego obszaru odpowiedniego panelu filtrowania.
-
W górnej części menu panelu filtrowania otwieranego prawym przyciskiem myszy (dostępnych jest maksymalnie dziesięć wyrażeń zapytań ostatnio dodanych do listy Favorites ).
-
W podręcznym menu filtrowania obszaru projektowego (naciśnij Y) — w górnej części menu wyświetlanych jest maksymalnie dziesięć ulubionych wyrażeń zapytań. Wybrane wyrażenie zapytania zostanie wczytane do środkowego obszaru odpowiedniego panelu filtrowania.
Korzystanie z gotowych przykładów
Zarówno edytor schematów, jak i edytor PCB zawierają zestaw gotowych przykładowych zapytań. Przykłady te są dostępne w menu filtrowania, które można otworzyć, klikając prawym przyciskiem myszy w obszarze wyrażenia w panelu filtrowania lub używając skrótu klawiaturowego Y w obszarze projektowym. Najedź kursorem na Examples, aby wyświetlić podmenu.
Po wybraniu pozycji w podmenu zostanie zastosowane zapytanie odpowiadające danemu filtrowi. Aby zobaczyć właściwe zapytanie kryjące się za jednym z przykładów, po jego zastosowaniu sprawdź listę History . Listę tę można również otworzyć w podręcznym menu filtrowania.
Narzędzia do tworzenia zapytań
Być może najłatwiejszym sposobem napisania zapytania jest zlecenie tego Altium Designer! Możesz to zrobić za pomocą okna dialogowego Find Similar Objects lub okna dialogowego Query Builder .
Okno dialogowe Znajdź podobne obiekty
Gdy korzystasz z okna dialogowego Znajdź podobne obiekty, generuje ono zapytanie służące do wyszukania wymaganych obiektów. Jeśli opcja Create Expression jest włączona, zapytanie to zostanie wyświetlone w panelu Filter . To doskonały sposób na poznanie różnych słów kluczowych zapytań.
Okno dialogowe Find Similar Objects otwiera się po kliknięciu prawym przyciskiem myszy dowolnego niezamaskowanego obiektu w dokumencie projektu i wybraniu Find Similar Objects z menu kontekstowego.
Ilustracja po lewej: wersja PCB; ilustracja po prawej: wersja SCH
To okno dialogowe umożliwia wyszukiwanie obiektów podobnych do obiektu klikniętego prawym przyciskiem myszy, a następnie określenie, które atrybuty obiektu muszą być takie same (lub różne), aby obiekt spełniał kryteria wyszukiwania. Załóżmy, że chcesz zmienić wszystkie pola lutownicze GND w projekcie. Możesz kliknąć prawym przyciskiem myszy jedno z takich pól, wybrać Find Similar Objects, a następnie zmienić wartość pola Net z Any (ustawienie domyślne) na Same. Wszystkie pola lutownicze GND zostaną zaznaczone po kliknięciu Apply w oknie dialogowym. Jeśli opcja Create Expression jest włączona, w panelu Filter pojawi się następujące zapytanie: (ObjectKind = 'Pad') And (Net = 'GND').
Przykładowo na schemacie można ustawić tę samą wartość właściwości Color dla wszystkich obiektów zasilania w dokumencie, które mają określoną wartość właściwości Text (np. „GND”). Z kolei na PCB można ustawić tę samą wartość właściwości Hole Size dla wszystkich przelotek w dokumencie, które mają określoną wartość właściwości Via Diameter.
Opcja Clear Existing
Włącz opcję Clear Existing , aby przed rozpoczęciem wyszukiwania usunąć istniejące zaznaczenie lub maskę edycji. Wyłącz tę opcję, jeśli wykonujesz kolejne wyszukiwania i chcesz, aby ich wyniki się kumulowały.
Pasek narzędzi filtrowania
Pasek Filter Toolbar jest dostępny dla dokumentów PCB i umożliwia maskowanie wszystkich obiektów w dokumencie z wyjątkiem tych, które mają określoną właściwość lub należą do określonego komponentu. Pole znajdujące się na prawym końcu paska narzędzi służy do określania treści zapytania. Możesz wpisać zapytanie w polu lub skorzystać z listy rozwijanej, aby wybrać jedno z ostatnich zapytań (znajdujących się na liście History ). Podczas stosowania zapytań z paska Filter Toolbar nie można określić używanych opcji. W każdym przypadku poprzednie zapytanie jest usuwane, a do bieżącego zapytania stosowane są opcje maskowania i powiększania. Aby korzystać z opcji zapytania, użyj panelu Filter , okna dialogowego Query Builder, okna dialogowego Query Helper lub okna dialogowego Find Similar Objects .
Operatory logicznych wyrażeń zapytań
Poniżej znajduje się zestawienie operatorów, których można używać podczas definiowania wyrażeń logicznych w języku zapytań.
Operatory arytmetyczne
| Operator | Opis | Przykład |
|---|---|---|
| + | Operator dodawania | NetPinCount + NetViaCount |
| - | Operator odejmowania | ArcStopAngle - ArcStartAngle |
| * | Operator mnożenia | PadXSize_BottomLayer * PadYSize_BottomLayer |
| / | Operator dzielenia | HoleDiameter / ViaDiameter |
| Div | Operator dzielenia całkowitego | Color Div 65536 >Oblicza wynik dzielenia Color przez 65536 z odrzuceniem części ułamkowej wyniku |
| Mod | Operator reszty z dzielenia | Color Mod 256 Oblicza resztę z dzielenia Color przez 256, bez wyznaczania części ułamkowej wyniku |
Operatory logiczne
| Operator | Opis | Przykład |
|---|---|---|
| And | Operator logiczny AND | IsPad And OnMultiLayer Aby obiekt został zwrócony, musi być polem lutowniczym i znajdować się na warstwie Multi-Layer |
| && | Operator logiczny AND (niższy priorytet) |
IsPad && OnMultiLayer Aby obiekt został zwrócony, musi być polem lutowniczym i znajdować się na warstwie Multi-Layer |
| Or | Operator logiczny OR | IsPad Or IsVia Aby obiekt został zwrócony, musi być polem lutowniczym lub przelotką |
| || | Operator logiczny OR (niższy priorytet) |
IsPad || IsVia Aby obiekt został zwrócony, musi być polem lutowniczym lub przelotką |
| Xor | Operator logiczny alternatywy wykluczającej XOR | OnMultiLayer Xor (HoleDiameter <> 0) Aby obiekt został zwrócony, musi znajdować się na warstwie Multi-Layer i mieć wartość Hole Diameter równą zero albo nie znajdować się na warstwie Multi-Layer i mieć wartość Hole Diameter różną od zera. |
| Not | Operator logiczny NOT | Not OnMultiLayer Aby obiekt został zwrócony, nie może znajdować się na warstwie Multi-Layer |
Operatory porównania
| Operator | Opis | Przykład |
|---|---|---|
| < | Operator „mniejsze niż” | HoleDiameter < 40 Aby obiekt został zwrócony, musi mieć wartość Hole Diameter mniejszą niż 40 |
| <= | Operator „mniejsze lub równe” | HoleDiameter <= 40 Aby obiekt został zwrócony, musi mieć wartość Hole Diameter mniejszą lub równą 40 |
| >= | Operator „większe lub równe” | HoleDiameter >= 40 Aby obiekt został zwrócony, musi mieć wartość Hole Diameter większą lub równą 40 |
| > | Operator „większe niż” | HoleDiameter > 40 Aby obiekt został zwrócony, musi mieć wartość Hole Diameter większą niż 40 |
| <> | Operator „różne od” | HoleDiameter <> 40 Aby obiekt został zwrócony, musi mieć wartość Hole Diameter różną od 40 |
| = | Operator „równe” | HoleDiameter = 40 Aby obiekt został zwrócony, musi mieć wartość Hole Diameter równą 40 |
| Between...And... | Operator przedziału domkniętego | HoleDiameter Between 30 And 50 Aby obiekt został zwrócony, musi mieć wartość Hole Diameter większą lub równą 30 oraz mniejszą lub równą 50. |
| Like | Operator Like | Name Like 'ADDR?*' Zwraca obiekty, dla których ciąg tekstowy powiązany z właściwością Name zaczyna się od ADDR i zawiera co najmniej jeden dodatkowy znak |
Symbole wieloznaczne
Znaki wieloznaczne umożliwiają podawanie ciągów znaków, które nie są w pełni określone. Znaki te są zwykle używane w połączeniu z innymi znakami, co pozwala tworzyć częściowo określone ciągi znaków. Kilka wyjątkowych słów kluczowych może przyjmować parametry tekstowe, które nie są w pełni określone, jednak w większości przypadków ciągi znaków mogą zawierać znaki wieloznaczne tylko wtedy, gdy są porównywane za pomocą operatora Like.
| Operator | Opis | Przykład |
|---|---|---|
| ? | Może zastępować pojedynczy znak dowolnego typu | Footprint Like 'DIP1?' Zwraca obiekty, których właściwość Footprint ma wartość DIP10, DIP12, DIP14 itd. |
| * | Może zastępować dowolną liczbę znaków, z których każdy może być dowolnego typu | Footprint Like 'SIP*' Zwraca obiekty, których właściwość Footprint ma wartość SIP1, SIP12, SIP216 itd. (Zwracane są również wszystkie obiekty, których właściwość Footprint ma wartość SIP, ponieważ '*' może również zastępować no znaków). |
Ciągi logiczne
| Operator | Opis | Przykład |
|---|---|---|
| True | Potwierdza znaczenie słowa kluczowego | IsPad = True Aby obiekt został zwrócony, musi być polem lutowniczym |
| False | Neguje znaczenie słowa kluczowego | IsVia = False Aby obiekt został zwrócony, nie może być przelotką |
Nawiasy okrągłe i kolejność wykonywania działań
Warto zapoznać się z kolejnością wykonywania działań obowiązującą dla operatorów używanych w logicznych wyrażeniach zapytań. Bez tej wiedzy wyrażenie może nie wskazywać wymaganych obiektów.
Nawiasy okrągłe mają najwyższy priorytet w hierarchii zdefiniowanej dla poszczególnych operatorów, która określa sposób interpretowania zapytań przez oprogramowanie (gdy użytkownik nie podał nawiasów okrągłych). Kolejność ta, od najwyższego do najniższego priorytetu, jest następująca:
- Nawiasy okrągłe ()
- Not
- ^, *, /, Div, Mod, And
- +, -, Or, Xor
- =, <>, <, >, <=, >=
- &&, ||
Globalne systemowe funkcje zapytań

Globalne systemowe funkcje zapytań wyświetlane w oknie dialogowym Query Helper
W tej sekcji szczegółowo opisano słowa kluczowe języka zapytań dostępne w dokumentach schematów, PCB i bibliotek w Altium Designer. Aby uzyskać pomoc dotyczącą konkretnego słowa kluczowego zapytania, skorzystaj z poniższych rozwijanych sekcji lub zaznacz dowolne słowo kluczowe (albo kliknij w jego obrębie) — w Query Helper, panelu Filter lub polu Query reguły projektowej PCB — i naciśnij F1, aby od razu przejść do odpowiedniej sekcji.
Funkcje arytmetyczne
ABS
Podsumowanie
Zwraca liczbę (rzeczywistą) równą wartości bezwzględnej wartości liczbowej parametru. Jeśli ta wartość liczbowa jest dodatnia, zwracana liczba ma tę samą wartość; w przeciwnym razie zwracana liczba jest równa wartości liczbowej parametru pomnożonej przez -1.
Składnia
ABS(X : Number / Numeric_String) : Number
Przykłady użycia
ABS(2.3)
Zwraca 2.3.
ABS(-7.2)
Zwraca 7.2.
CEIL
Podsumowanie
Zwraca liczbę całkowitą, której wartość zależy od wartości liczbowej parametru. Jeśli ta wartość liczbowa jest liczbą całkowitą, zwracana liczba ma dokładnie tę samą wartość; w przeciwnym razie zwracana jest najmniejsza liczba całkowita większa od wartości liczbowej parametru.
Składnia
CEIL(X : Number / Numeric_String) : Number
Przykłady użycia
CEIL(5.0)
Zwraca 5.
CEIL(5.33)
Zwraca 6.
CEIL(-5.0)
Zwraca -5.
CEIL(-5.33)
Zwraca -5.
FLOOR
Podsumowanie
Zwraca liczbę całkowitą, której wartość zależy od wartości liczbowej parametru. Jeśli ta wartość liczbowa jest liczbą całkowitą, zwracana liczba ma dokładnie tę samą wartość; w przeciwnym razie zwracana jest największa liczba całkowita mniejsza od wartości liczbowej parametru.
Składnia
FLOOR(X : Number / Numeric_String) : Number
Przykłady użycia
FLOOR(5.0)
Zwraca 5.
FLOOR(5.33)
Zwraca 5.
FLOOR(-5.0)
Zwraca -5.
FLOOR(-5.33)
Zwraca -6.
FRAC
Podsumowanie
Zwraca liczbę (rzeczywistą), której wartość zależy od wartości liczbowej parametru:
- Jeśli ta wartość liczbowa jest dodatnia, ale nie jest liczbą całkowitą, zwracana liczba jest różnicą między wartością liczbową parametru a największą liczbą całkowitą mniejszą od wartości liczbowej parametru.
- Jeśli ta wartość liczbowa jest ujemna, ale nie jest liczbą całkowitą, zwracana liczba jest różnicą między wartością liczbową parametru a najmniejszą liczbą całkowitą większą od wartości liczbowej parametru.
- Jeśli wartość liczbowa parametru jest liczbą całkowitą, zwracana liczba wynosi 0.
Składnia
FRAC(X : Number / Numeric_String) : Number
Przykłady użycia
FRAC(5.0)
Zwraca 0.
FRAC(5.33)
Zwraca 0.33.
FRAC(-5.0)
Zwraca 0.
FRAC(-5.33)
Zwraca -0.33.
IIF
Podsumowanie
Jest to konstrukcja specjalnego przeznaczenia zawierająca trzy zapytania. Obliczana jest wartość pierwszego zapytania (między nawiasem otwierającym a pierwszym przecinkiem). Jeśli wynosi ona True, zwracane jest drugie zapytanie (między przecinkami); w przeciwnym razie zwracane jest trzecie zapytanie (między drugim przecinkiem a nawiasem zamykającym).
Składnia
IIF(L : Boolean Query , A : Query , B : Query)
L, A i B to ciągi znaków, z których każdy określa pewne zapytanie; L musi być zapytaniem logicznym (tj. takim, które zwraca wynik True albo False).
Przykłady użycia
IsArc And IIF(ArcStopAngle - ArcStartAngle >= 0 , ArcStopAngle - ArcStartAngle Between 30 And 60 , ArcStartAngle - ArcStopAngle Between 300 And 330)
Zwraca wszystkie łuki, których długość kątowa jest większa lub równa 30 stopni i mniejsza lub równa 60 stopni. (Właściwość długości kątowej łuku określa kąt obliczany przez odjęcie wartości właściwości Start Angle od wartości właściwości Stop Angle. Dodatkowym utrudnieniem jest to, że wartość właściwości Stop Angle łuku może być mniejsza od wartości właściwości Start Angle, jednak to zapytanie poprawnie oblicza rzeczywistą długość kątową wszystkich możliwych obiektów łuku.)
IsComponent And IIF(Layer = 'Top Layer' , Rotation <> 0 , Rotation <> 180)
Zwraca wszystkie komponenty znajdujące się na górnej stronie płytki PCB, których właściwość Rotation ma wartość inną niż 0 stopni, oraz wszystkie komponenty znajdujące się na dolnej stronie płytki PCB, których właściwość Rotation ma wartość inną niż 180 stopni. (Obiekty komponentów mogą znajdować się wyłącznie na warstwie sygnałowej Top lub Bottom, więc każdy komponent, który nie znajduje się na warstwie sygnałowej Top, musi znajdować się na warstwie sygnałowej Bottom.)
INT
Podsumowanie
Zwraca liczbę całkowitą, której wartość zależy od wartości liczbowej parametru:
- Jeśli ta wartość liczbowa jest dodatnia, ale nie jest liczbą całkowitą, zwracana jest największa liczba całkowita mniejsza od wartości liczbowej parametru.
- Jeśli ta wartość liczbowa jest ujemna, ale nie jest liczbą całkowitą, zwracana jest najmniejsza liczba całkowita większa od wartości liczbowej parametru.
- Jeśli ta wartość liczbowa jest liczbą całkowitą, zwracana liczba ma dokładnie tę samą wartość.
Składnia
INT(X : Number / Numeric_String) : Number
Przykłady użycia
INT(5.0)
Zwraca 5.
INT(5.33)
Zwraca 5.
INT(-5.0)
Zwraca -5.
INT(-5.33)
Zwraca -5.
Wskazówki
Jest to alias funkcji arytmetycznej TRUNC.
MAX
Podsumowanie
Zwraca liczbę rzeczywistą równą największej wartości spośród wszystkich podanych parametrów. Każdy parametr musi być liczbą lub ciągiem znaków reprezentującym liczbę. Można podać dowolną liczbę parametrów.
Składnia
MAX(N1 : Number / Numeric_String, [N2] : Number / Numeric_String, ...) : Number
Przykłady użycia
MAX(2)
Zwraca 2.
MAX(7,2,3)
Zwraca 7.
Wskazówki
Należy podać co najmniej jeden parametr.
MIN
Podsumowanie
Zwraca liczbę rzeczywistą równą najmniejszej wartości spośród wszystkich podanych parametrów. Każdy parametr musi być liczbą lub ciągiem znaków reprezentującym liczbę. Można podać dowolną liczbę parametrów.
Składnia
MIN(N1 : Number / Numeric_String, [N2] : Number / Numeric_String, ...) : Number
Przykłady użycia
MIN(2)
Zwraca 2.
MIN(7,2,3)
Zwraca 2.
Wskazówki
Należy podać co najmniej jeden parametr.
POWER
Podsumowanie
Zwraca liczbę rzeczywistą równą wartości liczbowej pierwszego parametru podniesionej do potęgi określonej przez wartość liczbową drugiego parametru.
Składnia
POWER(X : Number / Numeric_String , Y : Number / Numeric_String) : Number
Przykłady użycia
POWER(3,2)
Zwraca 9.
POWER(32,0.2)
Zwraca 2.
POWER(16,-0.5)
Zwraca 0,25.
ROUND
Podsumowanie
Zwraca liczbę całkowitą, której wartość zależy od wartości liczbowej parametru:
- Jeśli ta wartość liczbowa jest liczbą całkowitą, zwracana liczba ma dokładnie tę samą wartość.
- Jeśli ta wartość liczbowa nie jest liczbą całkowitą, zwracana jest najbliższa jej liczba całkowita. Liczby dodatnie znajdujące się dokładnie w połowie między sąsiednimi liczbami całkowitymi są zaokrąglane upwards, natomiast liczby ujemne znajdujące się dokładnie w połowie między sąsiednimi liczbami całkowitymi są zaokrąglane downwards.
Składnia
ROUND(X : Number / Numeric_String) : Number
Przykłady użycia
ROUND(5.0)
Zwraca 5.
ROUND(5.33)
Zwraca 5.
ROUND(5.5)
Zwraca 6 (zaokrąglono w górę).
ROUND(5.66)
Zwraca 6.
ROUND(-5.0)
Zwraca -5.
ROUND(-5.33)
Zwraca -5.
ROUND(-5.5)
Zwraca -6 (zaokrąglono w dół).
ROUND(-5.66)
Zwraca -6.
SIGN
Podsumowanie
Zwraca wartość określającą znak podanego parametru. Oznacza to, że zwraca liczbę całkowitą, której wartość zależy od wartości liczbowej parametru:
- Jeśli ta wartość liczbowa jest dodatnia, zwracana jest liczba 1.
- Jeśli ta wartość liczbowa jest ujemna, zwracana jest liczba -1.
- Jeśli ta wartość liczbowa jest równa zeru, zwracana jest liczba 0.
Składnia
SIGN(X : Number / Numeric_String) : Number
Przykłady użycia
SIGN(5.33)
Zwraca 1.
SIGN(-5.33)
Zwraca -1.
SIGN(0)
Zwraca 0.
SQR
Podsumowanie
Zwraca liczbę rzeczywistą równą kwadratowi wartości liczbowej parametru.
Składnia
SQR(X : Number / Numeric_String) : Number
Przykłady użycia
SQR(2)
Zwraca 4.
SQR(14.1)
Zwraca 198,81.
SQR(-1.5)
Zwraca 2,25.
SQRT
Podsumowanie
Zwraca liczbę rzeczywistą równą dodatniemu pierwiastkowi kwadratowemu z wartości liczbowej parametru.
Składnia
SQRT(X : Number / Numeric_String) : Number
Przykłady użycia
SQRT(4)
Zwraca 2.
SQRT(10)
Zwraca 3,1623.
TRUNC
Podsumowanie
Zwraca liczbę całkowitą, której wartość zależy od wartości liczbowej parametru:
- Jeśli ta wartość liczbowa jest dodatnia, ale nie jest liczbą całkowitą, zwracana jest największa liczba całkowita mniejsza od wartości liczbowej parametru.
- Jeśli ta wartość liczbowa jest ujemna, ale nie jest liczbą całkowitą, zwracana jest najmniejsza liczba całkowita większa od wartości liczbowej parametru.
- Jeśli ta wartość liczbowa jest liczbą całkowitą, zwracana liczba ma dokładnie tę samą wartość.
Składnia
TRUNC(X : Number / Numeric_String) : Number
Przykłady użycia
TRUNC(5.0)
Zwraca 5.
TRUNC(5.33)
Zwraca 5.
TRUNC(-5.0)
Zwraca -5.
TRUNC(-5.33)
Zwraca -5.
Wskazówki
Jest to alias funkcji arytmetycznej INT.
ZERO
Podsumowanie
Zwraca liczbę całkowitą o wartości 0 lub 1, w zależności od wartości liczbowej parametru. Jeśli ta wartość liczbowa wynosi zero, zwracana jest liczba 0; w przeciwnym razie zwracana jest liczba 1.
Składnia
ZERO(X : Number / Numeric_String) : Number
Przykłady użycia
ZERO(5.33)
Zwraca 1.
ZERO(-5.33)
Zwraca 1.
ZERO(0)
Zwraca 0.
Funkcje trygonometryczne
ACOS
Podsumowanie
Zwraca liczbę rzeczywistą równą kątowi, którego cosinus jest równy wartości liczbowej parametru; kąt ten jest wyrażony w radianach (a nie w stopniach).
Składnia
ACOS(X : Number / Numeric_String) : Number
Przykłady użycia
ACOS(0)
Zwraca 1.5708.
ACOS(0.5)
Zwraca 1.0472.
ACOS(1)
Zwraca 0.
ASIN
Podsumowanie
Zwraca liczbę rzeczywistą równą kątowi, którego sinus jest równy wartości liczbowej parametru; kąt ten jest wyrażony w radianach (a nie w stopniach).
Składnia
ASIN(X : Number / Numeric_String) : Number
Przykłady użycia
ASIN(0)
Zwraca 0.
ASIN(0.5)
Zwraca 0.5236.
ASIN(1)
Zwraca 1.5708.
ATAN
Podsumowanie
Zwraca liczbę rzeczywistą równą kątowi, którego tangens jest równy wartości liczbowej parametru; kąt ten jest wyrażony w radianach (a nie w stopniach).
Składnia
ATAN(X : Number / Numeric_String) : Number
Przykłady użycia
ATAN(0)
Zwraca 0.
ATAN(1)
Zwraca 0.7854.
ATAN(2.5)
Zwraca 1.1903.
COS
Podsumowanie
Zwraca liczbę rzeczywistą równą cosinusowi kąta określonego przez wartość liczbową parametru; kąt ten jest wyrażony w radianach (a nie w stopniach).
Składnia
COS(X : Number / Numeric_String) : Number
Przykłady użycia
COS(0)
Zwraca 1.
COS(0.8)
Zwraca 0.6967.
COS(1.57)
Zwraca 0.0008.
COSH
Podsumowanie
Zwraca liczbę rzeczywistą równą cosinusowi hiperbolicznemu wartości liczbowej parametru.
Składnia
COSH(X : Number / Numeric_String) : Number
Przykłady użycia
COSH(TextHeight / TextWidth) < 70.5
Zwraca obiekty, dla których cosinus hiperboliczny stosunku wymiaru TextHeight do wymiaru TextWidth jest mniejszy niż 70.5. (Jest to równoważne zwróceniu obiektów, dla których stosunek wymiaru TextHeight do wymiaru TextWidth jest mniejszy niż 4.9487).
(TextHeight / TextWidth) >= COSH(2.3)
Zwraca obiekty, dla których stosunek wymiaru TextHeight do wymiaru TextWidth jest większy lub równy cosinusowi hiperbolicznemu 2.3 (który wynosi 5.0372).
COTAN
Podsumowanie
Zwraca liczbę rzeczywistą równą cotangensowi kąta określonego przez wartość liczbową parametru; kąt ten jest wyrażony w radianach (a nie w stopniach).
Składnia
COTAN(X : Number / Numeric_String) : Number
Przykłady użycia
COTAN(0.1)
Zwraca 9.9666.
COTAN(0.8)
Zwraca 0.9712.
COTAN(1.57)
Zwraca 0.0008.
SIN
Podsumowanie
Zwraca liczbę rzeczywistą równą sinusowi kąta określonego przez wartość liczbową parametru; kąt ten jest wyrażony w radianach (a nie w stopniach).
Składnia
SIN(X : Number / Numeric_String) : Number
Przykłady użycia
SIN(0)
Zwraca 0.
SIN(0.8)
Zwraca 0.7174.
SIN(1.57)
Zwraca 1.0.
SINH
Podsumowanie
Zwraca liczbę rzeczywistą równą sinusowi hiperbolicznemu wartości liczbowej parametru.
Składnia
SINH(X : Number / Numeric_String) : Number
Przykłady użycia
SINH(TextWidth / TextHeight) < 0.17
Zwraca obiekty, dla których sinus hiperboliczny stosunku wymiaru TextWidth do wymiaru TextHeight jest mniejszy niż 0.17. (Jest to równoważne zwróceniu obiektów, dla których stosunek wymiaru TextWidth do wymiaru TextHeight jest mniejszy niż 0.1692).
(TextWidth / TextHeight) >= SINH(0.2)
Zwraca obiekty, dla których stosunek wymiaru TextWidth do wymiaru TextHeight jest większy lub równy sinusowi hiperbolicznemu 0.2 (który wynosi 0.2013).
TAN
Podsumowanie
Zwraca liczbę rzeczywistą równą tangensowi kąta określonego przez wartość liczbową parametru; kąt ten jest wyrażony w radianach (a nie w stopniach).
Składnia
TAN(X : Number / Numeric_String) : Number)
Przykłady użycia
TAN(0)
Zwraca 0.
TAN(0.8)
Zwraca 1.0296.
TAN(1.57)
Zwraca 1255.7656.
TANH
Podsumowanie
Zwraca liczbę rzeczywistą równą tangensowi hiperbolicznemu wartości liczbowej parametru.
Składnia
TANH(X : Number / Numeric_String) : Number
Przykłady użycia
TANH(TextWidth / TextHeight) < 0.17
Zwraca obiekty, dla których tangens hiperboliczny stosunku wymiaru TextWidth do wymiaru TextHeight jest mniejszy niż 0.17. (Jest to równoważne zwróceniu obiektów, dla których stosunek wymiaru TextWidth do wymiaru TextHeight jest mniejszy niż 0.1717).
(TextWidth / TextHeight) >= TANH(0.2)
Zwraca obiekty, dla których stosunek wymiaru TextWidth do wymiaru TextHeight jest większy lub równy tangensowi hiperbolicznemu 0.2 (który wynosi 0.1974).
Funkcje wykładnicze i logarytmiczne
EXP
Podsumowanie
Zwraca liczbę rzeczywistą równą e podniesionemu do potęgi określonej przez wartość liczbową parametru. (Liczba e jest podstawą logarytmu naturalnego i wynosi w przybliżeniu 2.7183).
Składnia
EXP(X : Number / Numeric_String) : Number
Przykłady użycia
EXP(0)
Zwraca 1.
EXP(1)
Zwraca 2.7183.
LG
Podsumowanie
Zwraca liczbę rzeczywistą równą logarytmowi o podstawie 10 z wartości liczbowej parametru.
Składnia
LG(X : Number / Numeric_String) : Number
Przykłady użycia
LG(1)
Zwraca 0.
LG(10)
Zwraca 1.
LG(25)
Zwraca 1.3979.
LN
Podsumowanie
Zwraca liczbę rzeczywistą równą logarytmowi naturalnemu (czyli o podstawie e) z wartości liczbowej parametru. (Liczba e wynosi 2.7183).
Składnia
LN(X : Number / Numeric_String) : Number
Przykłady użycia
LN(1)
Zwraca 0.
LN(2)
Zwraca 0.6931.
LN(10)
Zwraca 2.3026.
LOG
Podsumowanie
Zwraca liczbę rzeczywistą równą logarytmowi o podstawie 2 z wartości liczbowej parametru.
Składnia
LOG(X : Number / Numeric_String) : Number
Przykłady użycia
LOG(1)
Zwraca 0.
LOG(2)
Zwraca 1.
LOG(8)
Zwraca 3.
LOG(10)
Zwraca 3.3219.
Funkcje agregujące
AVG
Podsumowanie
Zwraca liczbę rzeczywistą równą średniej wartości wszystkich podanych parametrów. Każdy parametr musi być liczbą lub ciągiem znaków reprezentującym liczbę. Można podać dowolną liczbę parametrów.
Składnia
AVG(N1 : Number / Numeric_String, [N2] : Number / Numeric_String, ...) : Number
Przykłady użycia
AVG(2)
Zwraca 2.
AVG(7,2,3)
Zwraca 4.
Wskazówki
- Należy podać co najmniej jeden parametr.
MAX
Podsumowanie
Zwraca liczbę rzeczywistą równą największej wartości spośród wszystkich podanych parametrów. Każdy parametr musi być liczbą lub ciągiem znaków reprezentującym liczbę. Można podać dowolną liczbę parametrów.
Składnia
MAX(N1 : Number / Numeric_String, [N2] : Number / Numeric_String, ...) : Number
Przykłady użycia
MAX(2)
Zwraca 2.
MAX(7,2,3)
Zwraca 7.
Wskazówki
Należy podać co najmniej jeden parametr.
MIN
Podsumowanie
Zwraca liczbę rzeczywistą równą najmniejszej wartości spośród wszystkich podanych parametrów. Każdy parametr musi być liczbą lub ciągiem znaków reprezentującym liczbę. Można podać dowolną liczbę parametrów.
Składnia
MIN(N1 : Number / Numeric_String, [N2] : Number / Numeric_String, ...) : Number
Przykłady użycia
MIN(2)
Zwraca 2.
MIN(7,2,3)
Zwraca 2.
Wskazówki
Należy podać co najmniej jeden parametr.
PROD
Podsumowanie
Zwraca liczbę rzeczywistą równą iloczynowi wszystkich podanych parametrów. Każdy parametr musi być liczbą lub ciągiem znaków reprezentującym liczbę. Można podać dowolną liczbę parametrów.
Składnia
PROD(N1 : Number / Numeric_String, [N2] : Number / Numeric_String, ...) : Number
Przykłady użycia
PROD(2)
Zwraca 2.
PROD(7,2,3)
Zwraca 42.
Wskazówki
Należy podać co najmniej jeden parametr.
SUM
Podsumowanie
Zwraca liczbę rzeczywistą równą sumie wszystkich podanych parametrów. Każdy parametr musi być liczbą lub ciągiem znaków reprezentującym liczbę. Można podać dowolną liczbę parametrów.
Składnia
SUM(N1 : Number / Numeric_String, [N2] : Number / Numeric_String, ...) : Number
Przykłady użycia
SUM(2)
Zwraca 2.
SUM(7,2,3)
Zwraca 12.
Wskazówki
Należy podać co najmniej jeden parametr.
Funkcje systemowe
Copy
Podsumowanie
Zwraca podciąg danego ciągu znaków. Można określić liczbę znaków zwracanego podciągu oraz pozycję w ciągu, od której ma się on zaczynać.
Składnia
Copy(S : String , Index : Integer , Count : Integer) : String
S jest wyrażeniem typu ciąg znaków. Index i Count są wyrażeniami typu całkowitego. Copy zwraca podciąg zawierający Count znaków, zaczynając od pozycji S[Index].
Jeśli Index jest większe niż długość S, Copy zwraca pusty ciąg znaków.
Jeśli Count określa większą liczbę znaków niż dostępna, zwracane są tylko znaki od S[Index] do końca S.
Przykłady użycia
Copy('Cats and dogs',1,1)
Zwraca 'C'. (Zwraca 1 znak z 1. pozycji w ciągu).
Copy('Cats and dogs',2,1)
Zwraca 'a'. (Zwraca 1 znak z 2. pozycji w ciągu).
Copy('Cats and dogs',13,1)
Zwraca 's'. (Zwraca 1 znak z 13. pozycji w ciągu).
Copy('Cats and dogs',14,1)
Zwraca '' (pusty ciąg znaków). (Zwraca 1 znak z 14. pozycji w ciągu; ciąg zawiera jednak tylko 13 znaków, więc zwracany jest pusty ciąg).
Copy('Cats and dogs',1,2)
Zwraca 'Ca'. (Zwraca 2 znaki, zaczynając od 1. pozycji w ciągu).
Copy('Cats and dogs',2,2)
Zwraca 'at'. (Zwraca 2 znaki, zaczynając od 2. pozycji w ciągu).
Copy('Cats and dogs',12,2)
Zwraca 'gs'. (Zwraca 2 znaki, zaczynając od 12. pozycji w ciągu).
Copy('Cats and dogs',13,2)
Zwraca 's'. (Zwraca 2 znaki, zaczynając od 13. pozycji w ciągu; ciąg zawiera jednak tylko 13 znaków, więc zwracany jest tylko 1 znak).
Copy('Cats and dogs',15,2)
Zwraca '' (pusty ciąg znaków). (Zwraca 2 znaki, zaczynając od 15. pozycji w ciągu; ciąg zawiera jednak tylko 13 znaków, więc zwracany jest pusty ciąg).
Copy('Cats and dogs',1,6)
Zwraca 'Cats a'. (Zwraca 6 znaków, zaczynając od 1. pozycji w ciągu).
Copy('Cats and dogs',5,9)
Zwraca ' and dogs'. (Zwraca 9 znaków, zaczynając od 5. pozycji w ciągu).
Copy('Cats and dogs',8,5)
Zwraca 'd dog'. (Zwraca 5 znaków, zaczynając od 8. pozycji w ciągu).
Copy('Cats and dogs',8,6)
Zwraca 'd dogs'. (Zwraca 6 znaków, zaczynając od 8. pozycji w ciągu).
Copy('Cats and dogs',8,7)
Zwraca 'd dogs'. (Zwraca 7 znaków, zaczynając od 8. pozycji w ciągu; ciąg zawiera jednak tylko 13 znaków, więc zwracanych jest tylko 6 znaków).
Length
Podsumowanie
Zwraca liczbę znaków w ciągu.
Składnia
Length(S : String) : Integer
S jest ciągiem, którego liczba znaków ma zostać zwrócona.
Przykłady użycia
Length(Name) Between 4 And 7
Zwraca obiekty, których właściwość Name zawiera od 4 do 7 znaków.
Length('Cat')
Zwraca 3.
Length('Darryll')
Zwraca 7.
Length('Cats and dogs')
Zwraca 13.
Length('')
Zwraca 0.
Pos
Podsumowanie
Zwraca indeks pierwszego znaku wskazanego podciągu występującego w danym ciągu znaków.
Składnia
Pos(Substr : String , S : String) : Integer
Pos wyszukuje podciąg Substr w ciągu S. Substr i S są wyrażeniami typu ciąg znaków. Zwracana jest wartość całkowita będąca indeksem pierwszego znaku Substr.
Przykłady użycia
Pos('T',Name) = 1
Zwraca wszystkie obiekty mające właściwość Name , której ciąg znaków zawiera pierwsze wystąpienie 'T' na pierwszej pozycji; przykładami takich ciągów są 'T1' i 'Time Table'. ('T' występuje dwukrotnie w ciągu 'Time Table', ale jego pierwsze wystąpienie znajduje się na pierwszej pozycji).
Pos('A',Name) = 2
Zwraca wszystkie obiekty mające właściwość Name , której ciąg znaków zawiera pierwsze wystąpienie 'A' na drugiej pozycji; przykładami takich ciągów są 'RA1' i 'CABLE CHART'.
Pos('B',Name) = 0
Zwraca wszystkie obiekty mające właściwość Name , której przypisany ciąg znaków nie zawiera 'B' na żadnej pozycji; przykładami takich ciągów są 'D1' i 'Time Table'. (Ciąg 'Time Table' zawiera 'b' na ósmej pozycji, ale funkcja Pos rozróżnia wielkość liter).
Pos('D',Name) > 0
Zwraca wszystkie obiekty mające właściwość Name , której przypisany ciąg znaków zawiera 'D' co najmniej raz, w dowolnym miejscu; przykładami takich ciągów są 'Data Chart', 'U1D' i 'Install either D1 and D2 or D3 and D4, but never install all of these.'.
Pos('Con',Name) = 1
Zwraca wszystkie obiekty mające właściwość Name , której przypisany ciąg znaków zawiera pierwsze wystąpienie 'Con' na pierwszej, drugiej i trzeciej pozycji; przykładem takiego ciągu jest 'Concatenate'. (Pierwsze wystąpienie 'Con' w ciągu 'Concatenate' obejmuje jego pierwsze trzy znaki; pierwszym znakiem w 'Con' jest 'C', który znajduje się na pierwszej pozycji w ciągu 'Concatenate').
Pos('ate',Name) = 5
Zwraca wszystkie obiekty mające właściwość Name , której przypisany ciąg znaków zawiera pierwsze wystąpienie 'ate' na piątej, szóstej i siódmej pozycji; przykładem takiego ciągu jest 'Concatenate'. (Pierwsze wystąpienie 'ate' w ciągu 'Concatenate' obejmuje znaki od piątego do siódmego; pierwszym znakiem w 'ate' jest 'a', który znajduje się na piątej pozycji w ciągu 'Concatenate').
Pos('ate',Name) = 0
Zwraca wszystkie obiekty mające właściwość Name , której przypisany ciąg znaków nie zawiera 'ate' w żadnym miejscu; przykładami takich ciągów są 'C1' i 'TIME:'.
Pred
Podsumowanie
Zwraca liczbę rzeczywistą równą wartości liczbowej parametru pomniejszonej o 1,0.
Składnia
Pred(X : Number / Numeric_String) : Number
Przykład użycia
Pred(4.1)
Zwraca 3,1.
Pred(41.313)
Zwraca 40,313.
Random
Podsumowanie
Zwraca liczbę losową z zakresu od 0 do X-1.
Składnia
Random(X) : Number
Przykład użycia
Random(10)
Zwraca wartość z zakresu od 0 do 9.
Random(100)
Zwraca wartość z zakresu od 0 do 99.
Succ
Podsumowanie
Zwraca liczbę rzeczywistą równą wartości liczbowej parametru powiększonej o 1,0.
Składnia
Succ(X : Number / Numeric_String) : Number
Przykład użycia
Succ(2.1)
Zwraca 3,1.
Succ(41.313)
Zwraca 42,313.





















