Cage

Biblioteka Javascript

Pobierz

Cage to niewielka biblioteka wspomagająca pracę z Canvas.

Cage.Assets

Komponent Cage.Assets to prosty manadżer zasobów multimedialnych. Ułatwia ładowanie i zarządzanie plikami graficznymi oraz audio.

Przykład użycia:

function assetComplete() {
	context.drawImage(Cage.Assets.getImage('foo'));
}

window.addEventListener('assets_complete', assetComplete, false);

Cage.Assets.load({
	images: {
		foo: 'foo.jpg',
		bar: 'bar.png'
	},
	sounds: {
		foobar: 'foobar' // bez rozszerzenia!
	}
});

Demo 1 Demo 2

Metody

• Cage.Assets.load(files)

  Metoda preload'ująca pliki.
  files - obiekt definiujący listę plików do wczytania. Lista plików podzielona jest na dwa podobiekty:
  • images - zawierający listę plików graficznych, gdzie nazwa własności to unikalny identyfikator pliku, a wartość to jego adres url pliku (gif, jpg, png).
  • sounds - zawierający listę plików dzwiękowych, gdzie nazwa własności to unikalny identyfikator pliku, a wartość to jego adres url. Jeśli nie zostanie podane rozszerzenie pliku, biblioteka wykryje możliwości przeglądarki i spróbuje załadować jeden z obsługiwanych formatów (ogg, mp3 lub wav)

• Cage.Assets.getImage(id, url)

  Metoda zwracająca załadowany plik graficzny.
  id - identyfikator pliku.
  url - opcjonalny atrybut, jeśli zostanie podany adres url do pliku, zostanie on wczytany do manadżera pod podany identyfikator.

• Cage.Assets.getSound(id, url)

  Metoda zwracająca załadowany plik dźwiękowy.
  id - identyfikator pliku.
  url - opcjonalny atrybut, jeśli zostanie podany adres url do pliku, zostanie on wczytany do manadżera pod podany identyfikator.

Zdarzenia

• asset_start

  Event zachodzi przed rozpoczęciem wczytywania zasobu. Event posiada atrybut asset zawierający informacje o zasobie:
  • id - identyfikator pliku
  • type - typ zasobu ("image" lub "sound")
  • src - adres zasobu

• assets_progress

  Event zachodzi po wczytaniu zasobu. Event posiada atrybuty:
  • progress - procentowy postęp ładowania wszystkich zadanych zasobów
  • asset - wczytany obiekt. Posiada atrybut asset zawierający informacje o zasobie:
    
    • id - identyfikator pliku
    • type - typ zasobu ("image" lub "sound")
    • src - adres zasobu

• assets_complete

  Event zachodzi po wczytaniu wszystkich zadanych zasobów.