Overzicht
Elk PicoPixel-bestand heeft een eigen bibliotheek met kleuren, lettertypen, afbeeldingen, animaties en componenten. Je vindt deze in het paneel Assets. Door het bestand te publiceren met Publish maak je die bibliotheek beschikbaar voor je team. Andere teamleden kunnen de bibliotheek aan hun bestand koppelen en de onderdelen opnieuw gebruiken.
Deze handleiding legt uit wat een bibliotheek bevat, hoe je haar publiceert en koppelt, en wie er toegang toe heeft.
Publiceren maakt je werk niet openbaar. Met Publish stel je de bibliotheek uitsluitend beschikbaar aan je eigen team in PicoPixel. Het bestand komt niet op internet of in een openbare catalogus terecht. Verderop lees je welke twee bewuste handelingen je werk wél buiten je team delen.
Wat is een bibliotheek?
Een bibliotheek verzamelt de herbruikbare onderdelen van een bestand. In het paneel Assets staan de eigen onderdelen onder local library. Deze sectie is altijd aanwezig en staat standaard open.
Koppel je een bibliotheek van een ander teambestand, dan verschijnt die als een aparte sectie onder de lokale bibliotheek. De bestandsnaam, bijvoorbeeld Animation Examples, is de titel van die sectie. Je kunt onderdelen uit beide bibliotheken naar je ontwerp slepen.
Zie het als twee planken in dezelfde kast: op de ene staan de onderdelen van je huidige bestand, op de andere de onderdelen die je uit een teambestand gebruikt. Je hoeft je ontwerp niet te verlaten om ze te pakken.
Wat kan een bibliotheek bevatten?
Als je een bestand publiceert, komen alle onderdelen uit het paneel Assets beschikbaar voor je team. PicoPixel verdeelt ze in deze groepen:
- Images: stilstaande afbeeldingen.
- Animated images: animaties die uit meerdere afbeeldingen bestaan.
- Components: herbruikbare groepen LVGL-widgets; hieronder lees je hoe die werken.
- Colors: opgeslagen kleurstalen.
- Fonts: lettertypen die je hebt toegevoegd en geconverteerd voor gebruik op het apparaat.
Zo kan je team dezelfde onderdelen gebruiken zonder ze telkens tussen bestanden te kopiëren.
Wat is een component?
Een component is een herbruikbare bouwsteen van één of meer widgets. Een knop of label is één widget. Een component kan bijvoorbeeld een complete kaart bevatten, met een titel, icoon en meetwaarde, inclusief de opmaak.
Elke component heeft een main instance, het hoofdexemplaar. Wijzig je dit exemplaar, dan zijn die wijzigingen beschikbaar voor de kopieën, ook in bestanden die de bibliotheek gebruiken. Zo definieer je een bedieningselement één keer en onderhoud je het op één plek. Hieronder lees je hoe je bibliotheekupdates in een ander bestand toepast.
Maak een component van onderdelen die je steeds opnieuw opbouwt, zoals een kopbalk, meetwaardekaart of schakelaar met label. Dat scheelt werk en houdt je schermen consistent.
Een bestand als bibliotheek publiceren
Door te publiceren maak je de bibliotheek van het bestand deelbaar binnen je team.
- Open Libraries via Add library in het paneel Assets. Als het bestand al gekoppelde bibliotheken of componenten heeft, heet de knop Manage library.
- Ga naar LIBRARIES en zoek File library onder LIBRARIES IN THIS FILE.
- Klik op Publish.
De knop verandert in Unpublish. Je team kan de bibliotheek nu koppelen. Rechtsboven in de werkruimte en op de bestandskaart in het Dashboard verschijnt ook een bibliotheekpictogram.
Met Unpublish trek je de publicatie weer in, na een bevestiging. PicoPixel kopieert eerst de gebruikte onderdelen naar de bestanden die de bibliotheek hadden gekoppeld. Die bestanden raken hun onderdelen dus niet kwijt.
De bibliotheken van je team vinden
Alle gepubliceerde bibliotheken van je team staan bij elkaar:
- Open het Dashboard.
- Kies Libraries onder Sources in de linkerzijbalk.
Je ziet alleen de bibliotheken van het team dat op dat moment actief is. Wissel je van team, dan verandert ook deze lijst. Hier kunnen teamleden bekijken welke onderdelen al beschikbaar zijn.
Een bibliotheek in een ander bestand gebruiken
Zodra een bibliotheek gepubliceerd is, kun je haar koppelen aan een ander bestand van hetzelfde team:
- Open het bestand waarin je wilt werken.
- Klik in Assets op Add library of Manage library.
- Zoek de gewenste bibliotheek onder SHARED LIBRARIES. Gebruik eventueel Search shared libraries en klik op + naast de bibliotheek.
De bibliotheek verschijnt onder haar eigen naam in Assets, onder local library. Sleep de componenten, afbeeldingen, kleuren en lettertypen naar je ontwerp.
Een gekoppelde bibliotheek bijwerken
Wijzigingen uit een gekoppelde bibliotheek worden niet ongevraagd op je bestand toegepast. Als de eigenaar bijvoorbeeld een component of kleur aanpast, verschijnt de bibliotheek op het tabblad UPDATES in Libraries. Klik op Update wanneer je de wijzigingen wilt overnemen. Zijn er geen wijzigingen, dan geeft het tabblad dat aan.
Privacy: alleen je team heeft toegang
Het woord Publish kan de indruk wekken dat je iets openbaar maakt. Binnen deze functie betekent het uitsluitend delen met je team.
Een gepubliceerde bibliotheek is alleen toegankelijk voor je eigen team. Gebruikers moeten ingelogd zijn en tot dat team behoren. Er is geen openbare link of vermelding waarmee anderen de bibliotheek kunnen openen.
Je werk komt alleen buiten je team als je zelf een van deze twee stappen zet:
- Je exporteert een
.picopixel-bestand en deelt dat zelf. Kies Export.picopixelin het werkruimtemenu om het bestand te downloaden. Daarna bepaal je zelf of je het mailt of op een andere manier aan iemand geeft. - Je dient je werk officieel in bij het PicoPixel-team. Wil je een ontwerp delen met de bredere community, gebruik dan
app.picopixel.io/#/settings/submit-template. Het team beoordeelt elke inzending voordat die in de openbare galerij verschijnt. In Een sjabloon indienen lees je wat je moet aanleveren en welke rechten je verleent.
Zonder die handelingen blijven je bestanden en bibliotheken binnen je team.
Communitysjablonen en kant-en-klare bibliotheken
In de PicoPixel-sjabloongalerij vind je sjablonen, UI-kits, voorbeelden, sprites, animaties en complete apps van het PicoPixel-team en de community. Elk project is een gewoon .picopixel-bestand dat je kunt openen en aanpassen.
Ook een geopend sjabloon kun je als bibliotheek publiceren. Je team kan dan de componenten, lettertypen, kleuren en afbeeldingen gebruiken zonder alles opnieuw te maken.
Lees PicoPixel-sjablonen, UI-kits en complete apps gebruiken voor het vinden, importeren en aanpassen van een sjabloon.
Verder aan de slag
- Een sjabloon indienen: deel een ontwerp met de community.
- Wat is een sprite?: maak geanimeerde widgets met meerdere toestanden.
- Werken met lettertypen: voeg lettertypen toe aan je bibliotheek en converteer ze voor LVGL.
- Werken met de LVGL Animated Image-widget: maak animaties die je in andere bestanden kunt hergebruiken.
