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.