Podstawy rysunkowego interfejsu API

Flash Player 9 i nowsze wersje, Adobe AIR 1.0 i nowsze wersje

Rysunkowy interfejs API to zbiór funkcji wbudowanych w język ActionScript, które umożliwiają tworzenie grafiki wektorowej — prostych, krzywych, kształtów, wypełnień i gradientów — oraz wyświetlanie ich na ekranie. Funkcje te są udostępniane przez klasę flash.display.Graphics. Kod ActionScript może rysować w dowolnej instancji klasy Shape, Sprite lub MovieClip, odwołując się do właściwości graphics każdej z tych klas. (Właściwość graphics każdej z tych klas jest w istocie instancją klasy Graphics).

Z myślą o osobach, które stawiają pierwsze kroki w rysowaniu programowym, klasa Graphics udostępnia kilka metod ułatwiających rysowanie typowych kształtów, takich jak koła, elipsy, prostokąty i prostokąty z zaokrąglonymi narożnikami. Wszystkie te figury można rysować jako obrysy lub wypełnione kształty. Jeśli potrzebna jest bardziej zaawansowana funkcjonalność, klasa Graphics oferuje także metody służące do rysowania linii i krzywych Béziera drugiego stopnia, których można używać razem funkcjami trygonometrycznymi z klasy Math do tworzenia dowolnych kształtów.

W środowiskach wykonawczych Flash (takich jak program Flash Player 10 i środowisko Adobe AIR 1.5 oraz nowsze wersje) dodano funkcje rysunkowego interfejsu API umożliwiające programowe rysowanie całych kształtów za pomocą pojedynczej komendy. Po zapoznaniu się z klasą Graphics i zadaniami omówionymi w sekcji „Podstawy korzystania z interfejsu API rysowania” można przejść do sekcji Zaawansowane zastosowania rysunkowego interfejsu API w celu poznania tych dodatkowych funkcji.

Ważne pojęcia i terminy

Na poniższej liście objaśniono ważne terminy, jakie można napotkać podczas korzystania z rysunkowego interfejsu API:

Punkt zakotwiczenia: Jeden z dwóch punktów końcowych krzywej Béziera drugiego stopnia.
Punkt sterujący: Punkt definiujący kierunek i stopień wygięcia krzywej Béziera drugiego stopnia. Krzywa nigdy nie przechodzi przez punkt sterujący, jest natomiast wygięta w stronę tego punktu.
Przestrzeń współrzędnych: Wykres współrzędnych zawarty w obiekcie wyświetlanym, względem którego określane są położenia elementów podrzędnych.
Wypełnienie: Jednolicie wypełniona wewnętrzna część kształtu składającego się z linii i kolorowego wypełnienia albo samego wypełnienia (wówczas cały kształt jest wypełnieniem).
Gradient: Stopniowe przejście od jednego koloru do innego koloru lub do wielu innych kolorów (w odróżnieniu od koloru jednolitego).
Punkt: Jedno miejsce w przestrzeni współrzędnych. W dwuwymiarowym układzie współrzędnych stosowanym w języku ActionScript punkt jest zdefiniowany przez jego położenie na osiach x i y (współrzędne).
Krzywa Béziera drugiego stopnia: Krzywa opisana konkretnym rodzajem wzoru matematycznego. W przypadku krzywych tego rodzaju kształt jest obliczany na podstawie położenia punktów kontrolnych na końcach krzywej oraz punktu kontrolnego wyznaczającego kierunek i stopień wygięcia krzywej.
Skala: Rozmiar obiektu określony względem jego pierwotnego rozmiaru. Czynność skalowania polega na zmianie rozmiaru obiektu przez jego rozciągnięcie lub skurczenie.
Obrys: Zewnętrzna część kształtu składająca się z linii wypełnionej kolorem lub linie kształtu niewypełnionego.
Translacja: Przekształcenie współrzędnych punktu w jednej przestrzeni współrzędnych we współrzędne w innej przestrzeni.
Oś x: Oś pozioma dwuwymiarowego układu współrzędnych używanego w języku ActionScript.
Oś y: Oś pionowa dwuwymiarowego układu współrzędnych używanego w języku ActionScript.