Witaj w Przewodniku początkującego po C# w Grasshopperze! W tym przewodniku przedstawię Ci język programowania, który jest powszechnie używany. Microsoft wykorzystuje ten język do praktycznie wszystkich swoich produktów i staje się coraz bardziej popularny w branży budowlanej. Wyobraź sobie Grasshoppera jako platformę, na której możesz budować skrypty, łącząc kolorowe bloki. Pomyśl o C# jako o magicznym języku opartym na tekście, który podnosi te bloki na wyższy poziom. Jeśli jesteś zupełnie nowy w tym wszystkim, nie martw się – ten przewodnik ma na celu być punktem wyjścia na drodze do stania się Inżynierem 4.0.
Spis treści
Czym jest C# i platforma .NET
C# (wymawiane “si szarp”) to jak magiczna różdżka, która ożywia programy komputerowe. To język, który dostarcza komputerom instrukcji krok po kroku. Pomyśl o tym w ten sposób: wyobraź sobie, że masz specjalny skrzynk€ narzędzi o nazwie “.NET Framework”. Wewnątrz tego zestawu narzędzi znajdują się narzędzia, które dają nam możliwość tworzenia różnych rodzajów aplikacji, w tym aplikacji na desktopa i aplikacji internetowych. Piękno polega na tym, że te narzędzia są już gotowe do użycia, więc nie musimy zaczynać od zera za każdym razem, gdy chcemy coś stworzyć. Oszczędzają nam ogromną ilość czasu i wysiłku.
Platforma .NET Framework została opracowana przez Microsoft w 2002 roku, aby ułatwić tworzenie różnorodnych aplikacji. Oto kilka znajomych przykładów aplikacji i technologii zbudowanych na platformie .NET Framework:
- Pakiet Microsoft Office
- Microsoft Azure
- Visual Studio
To oznacza, że język C# będzie rozwijany w przyszłości. Microsoft nie przestanie pracować nad nim, więc nauka tego języka to dobry inwestycja. Jest on niezawodny i otwiera nowe możliwości, jeśli już znasz Grasshoppera będzie tylko łatwiej się nauczyć.
Dlaczego C# w Grasshopperze ma znaczenie
Skryptowy komponent C# jest zintegrowany wewnątrz Grasshoppera i ma podobny interfejs do innych typowych komponentów. Mogą one czytać dane wejściowe i generować dane wyjściowe, a także posiadają edytor umożliwiający pisanie niestandardowego kodu z dostępem do RhinoCommon. Są one używane do tworzenia specjalistycznego kodu, który nie jest obsługiwany przez inne komponenty Grasshoppera. Możesz ich również używać do upraszczania, optymalizacji i usprawniania definicji poprzez łączenie wielu funkcji. Skrypty C# działają wyjątkowo szybko,redukując złożoność skryptów Grasshoppera.
Kiedy piszesz kod C#, oprogramowanie służy za pomocną dłoń. Oferuje sugestie, co można napisać dalej, co jest szczególnie korzystne dla początkujących. Jeśli aspirujesz do tworzenia specjalnych narzędzi dla Grasshoppera, znanych jako zestawy GHA lub wtyczki, to właśnie C# otwiera przed Tobą nową przestrzeń kreatywności.
Wyzwania związane z C#
No cóż, bądźmy realistami. C# nie jest najłatwiejszym językiem programowania do opanowania. Jest nieco mniej wyrozumiały w porównaniu do innych języków, takich jak Python. Oznacza to, że musisz głębiej zrozumieć dane, z którymi pracujesz. Może to prowadzić do dłuższych fragmentów kodu, ponieważ ważniejsza jest klarowność. Niemniej jednak, miej pewność, że ten podejście czyni cię lepszym programistą i minimalizuje szanse na błędy.
Jesteś podekscytowany rozpoczęciem przygody z C# w Grasshopperze? Zacznijmy od podstaw programowania w C# wewnątrz Grasshoppera.
Komponent C# w Grasshopperze
Narzędzie do skryptowania w C# znajdziesz w zakładce Math, w sekcji Script. Aby dodać je do canvas (obszaru pracy), wystarczy podwójnie kliknąć i wpisać “C#”.
Po dodaniu komponentu zobaczysz dwa wejścia oznaczone jako ‘x’ i ‘y’, oraz dwa wyjścia oznaczone jako ‘out’ i ‘A’. Wyjście ‘out’ to miejsce, gdzie pojawiają się błędy lub istotne informacje dotyczące Twojego kodu. Jeśli połączysz wyjście ‘out’ z narzędziem Panel, łatwo możesz odczytać informacje.
Są dwa rodzaje wiadomości, które pojawiają się w wyjściu ‘out’:
1. Wiadomości kompilacji: są to jakby notatki od sprawdzacza, który analizuje Twój kod. Mogą wskazywać na błędy lub rzeczy, które powinieneś poprawić.
2. Wiadomości czasu wykonania: możesz umieścić własne notatki w wyjściu ‘out’ podczas działania Twojego kodu. Pomaga to zrozumieć, co dzieje się wewnątrz Twojego kodu.
Nazwy, które widzisz na wejściach i wyjściach (z wyjątkiem ‘out’), to jak etykiety. To także nazwy rzeczy wewnątrz Twojego kodu. Jeśli je zmienisz, pamiętaj, aby przestrzegać zasad nazewnictwa w C#. Po przybliżeniu zobaczysz znaki plusa i minusa (interfejs użytkownika, który można przybliżać, podobny do komponentu Merg). Pozwalają one dodawać lub usuwać wejścia i wyjścia według potrzeb.
Typy danych - Csharp w Grasshopperze
Typy pierwotne odnoszą się do podstawowych i wbudowanych typów dostarczanych przez język programowania. Poniższe przykłady deklarują zmienne typów danych pierwotnych:
W języku C# deklarujesz wartości typu string przy użyciu podwójnych cudzysłowów (“”) zamiast pojedynczych cudzysłowów (”). Pojedyncze cudzysłowy są zwykle używane do oznaczania pojedynczych znaków (wartości typu char), podczas gdy podwójne cudzysłowy są używane dla ciągów znaków (stringów).
Oto jak deklarować wartości typu string w języku C#:
W Rhino istnieją pewne niestandardowe typy danych zaprojektowane specjalnie do reprezentowania geometrii. Niektóre z przykładów to Point3d, Line, Polyline, Brep.
Uwaga: typy wyjściowe zawsze są ustawione na ogólny typ „object”.
Ponadto, masz trzy sposoby dostarczania danych (pojedyncza wartość, lista, drzewo danych).
Definiowanie zmiennych w języku C#
W języku C# proces definiowania zmiennej polega na określeniu jej typu danych, a następnie wybraniu nazwy zmiennej. Należy przestrzegać określonych wytycznych, aby zapewnić unikalność i klarowność w kodzie:
- Zmienne powinny unikać zarezerwowanych słów kluczowych, np. bool, class, char, double.
- Powinny zaczynać się od litery lub znaku podkreślenia. _count, firstName, totalAmount.
- Dozwolone znaki: litery (duże i małe): od A do Z i od a do z, cyfry: od 0 do 9, znak podkreślenia: _.
- Spacje nie są dozwolone.
Zadeklarowana zmienna działa w istocie jako kontener do przechowywania określonych typów danych. Pierwsze przypisanie wartości do zmiennej nazywane jest jej inicjalizacją.
Praktyczne wskazówki:
- Opisowe Nazewnictwo: Wybieraj opisowe nazwy zmiennych, które dostarczą informacji o ich celu. Na przykład “userAge” jest preferowane w stosunku do “var123”.
- Konwencja Camel Case: Przyjęta jest powszechnie stosowana konwencja nazewnictwa Camel Case w języku C#. Oznacza to rozpoczęcie nazwy małą literą i oddzielanie słów wielkimi literami. Na przykład “totalPurchaseAmount”.
Przestrzegając tych wytycznych i przykładów, Twój kod nie tylko będzie wolny od plagiatu, ale również zachowa czytelność i zgodność z najlepszymi praktykami w programowaniu w języku C#.
Komentarze w celu Wyjaśnienia Klarowności Kodu w C#
Komentarze w kodzie są jak notatki, które piszesz bezpośrednio w kodzie, a które komputer ignoruje podczas uruchamiania programu. Są one przydatne do wyjaśniania trudnych fragmentów kodu. Istnieją dwa główne rodzaje komentarzy: krótkie i długie.
Komentarze są naprawdę przydatne, ponieważ pomagają Tobie i innym lepiej zrozumieć Twój kod. Pełnią rolę przypomnienia dla Ciebie oraz wyjaśnienia dla każdego czytającego Twój kod. Aby napisać komentarz, możesz skorzystać z dwóch metod:
- Komentarze Jednoliniowe: Wystarczy umieścić dwa ukośniki (//) przed nim, a komputer go zignoruje. W edytorze kodu C# w Grasshopperze komentarze pojawiają się na zielono.
2. Komentarze wieloliniowe. Jeśli chcesz wyjaśnić coś dłuższego, możesz to zawrzeć między /* a */, tak jak tutaj:
Korzystanie z komentarzy w ten sposób sprawia, że Twój kod jest łatwiejszy do zrozumienia dla każdego.
Warte zapamiętania!
Wszystkie instrukcje w języku C# muszą kończyć się średnikiem (w większości przypadkow).
Ćwiczenia z Grasshoppera
Teraz posiadasz podstawową wiedzę teoretyczną i jesteś gotów zastosować ją w praktyce. Pobierz plik Grasshopper i rozwiąż ćwiczenia, które dla Ciebie przygotowałem. Pod każdym ćwiczeniem znajdziesz instrukcje dotyczące tego, co powinieneś zrobić. Po lewej stronie od ćwiczeń znajdziesz cluster z przygotowanym rozwiązaniem.
If you want to get more information about Grasshopper and learn parametric modelling, download the free guide – FREE DOWNLOAD
Grasshopper is a plugin to Rhino that you can download HERE.
