toonAfbeelding

Ingebouwde functies

Canonieke ID: media.showImage. English: showImage.

Toont een verpakte afbeelding als behouden achtergrond over het hele beeld. De host zoekt de media op; het programma krijgt geen bestandshandle of onbeperkte padtoegang. Begrensde PNG-, JPEG- en GIF-afbeeldingen werken op hosts met beeldmedia. Gebruik een .bipli-project met het genoemde bestand; het voorbeeld is geen zelfstandige losse-bronapplicatie.

Aanroepvorm

toonAfbeelding(mediapad)

Argumenten

Terugkeerwaarde

None.

Voorbeeld

# taal: nl
toonAfbeelding("assets/background.png")
tekenTekst(320, 20, "Pliro", 28, "white", "sans", "center")

Importeer eerst assets/background.png in het project. De afbeelding staat achter het label op een host met mediaondersteuning.

Aandachtspunten en veelgemaakte fouten

Gebruik de functienaam van je brontaal. De canonieke ID is een gezamenlijk documentatielabel; die ID typ je niet als aanroep. Een eigen variabele of functie met dezelfde naam kan de ingebouwde functie verbergen. Geef de beschreven argumenten en waardesoorten mee. Pliro meldt verschillen wanneer controle ze kan vinden, of wanneer de aanroep draait.

Een host is de app of omgeving die je programma uitvoert. Voor zichtbaar beeld heeft die een renderer nodig: het onderdeel dat op het scherm tekent. De opdrachtregelopdracht pliro run toont tekst maar tekent deze beelden niet. De tabel met uitvoeromgevingen vertelt welke effecten werken in de IDE, browser, native app en telefoonpreview. Een native bouw meldt een ontbrekende mogelijkheid in plaats van die weg te laten.

Het voorbeeld vereist de genoemde bestanden in een .bipli-project. Verpakte mediabestanden zijn momenteel elk maximaal 12 MiB. Paden onder assets/ zijn projectverwijzingen, geen willekeurige bestanden of URL’s. Native export ondersteunt speelGeluid nog niet.

Gerelateerde lemma’s

speelGeluid · Programmeergidsen · Hostondersteuning · Aanroepen en argumenten