HANDLEIDING

01 / HANDLEIDING

Je eerste tekening

1. Klik op Nieuw project in het startscherm.
2. Kies 32 × 32 en klik op Maak project.
3. Klik rechts op een kleur uit het palet.
4. Kies Potlood links, of druk op B.
5. Klik of sleep op het canvas om te tekenen. Met ⌘Z maak je een fout ongedaan.
6. Klik op Bewaar, kies een naam en map en bewaar je .jenchapixel-project.
7. Wil je de afbeelding delen? Klik op Export… en exporteer een PNG. Hoofdstuk 12 legt dit uit.

De grijs-witte achtergrond betekent dat pixels transparant zijn. Het schaakbord zelf komt niet in je PNG terecht.

Je projectbestand bewaart je bewerkbare artwork. Een PNG is de afbeelding die je kunt delen. Bewaar je project ook als je een PNG hebt geëxporteerd.

02 / HANDLEIDING

Een project maken of openen

Kies een standaardformaat van 16 × 16, 32 × 32, 64 × 64 of 128 × 128 pixels. Via Aangepast voer je zelf de breedte en hoogte in: ieder een heel getal van 1 tot en met 1024. Een rechthoekig canvas kan dus ook.

Dit zijn de pixels van je tekening, niet de afmetingen van het venster. Je kunt het canvasformaat in deze versie niet achteraf aanpassen. Voor een groter te bekijken resultaat kun je inzoomen of bij export een grotere schaal kiezen.

Gebruik Open project voor een bestaand .jenchapixel-bestand. Op het startscherm kun je ook een recent project aanklikken. Onder de naam staan de mapnaam en, wanneer beschikbaar, het canvasformaat. Een mapnaam zoals ‘outputs’ is een opslaglocatie, geen projecttype.

De app gebruikt de macOS-taalinstellingen: Nederlands en Engels zijn ondersteund; andere talen vallen terug op Engels. Er is geen eigen taalkiezer in de app. Zelfgekozen project-, layer- en groepsnamen worden niet vertaald.

03 / HANDLEIDING

Rondkijken op je canvas

• + / − onder het canvas: in- en uitzoomen. Op het toetsenbord werken + (ook =) en − wanneer het canvas de invoer ontvangt.
• Passend, of 0: het hele canvas passend in beeld brengen.
• 100%: terug naar de normale weergaveschaal.
• Spatie ingedrukt houden en slepen: de weergave verschuiven, zonder pixels te verplaatsen. Scrollen met muis of trackpad verschuift de weergave ook.
• Knijpgebaar op een trackpad: zoomen rond de aanwijzer.
• Raster: pixelgrenzen tonen. De rasterlijnen worden zichtbaar vanaf voldoende vergroting, ongeveer 600%.

X en Y rechtsonder geven de pixel onder je muis aan. X loopt naar rechts, Y naar beneden. Linksboven is X 0 · Y 0. Bij 32 × 32 is rechtsonder X 31 · Y 31. Zoom verandert deze pixelcoördinaten niet. De kleine transparantievakjes zijn niet noodzakelijk één artworkpixel groot.

De linker balk bevat gereedschappen. De balk boven het canvas toont de opties voor het gekozen gereedschap. Bij een smal venster kun je die opties horizontaal scrollen. Rechts kun je KLEUR inklappen en de scheiding boven LAYERS slepen om de ruimte te verdelen.

Gebruik Projectgegevens… naast Bewaar voor herbruikbare exportinformatie. In een smal venster staan de tekstknoppen op twee regels. Projectgegevens

04 / HANDLEIDING

Tekengereedschappen

Bewerkingen werken op de actieve layer. Is er een selectie actief, dan blijven potlood, gum, vullen, lijn en vormen binnen die selectie. Druk op ⌘D om weer overal te kunnen tekenen.

Potlood — B

Kies een kleur en sleep om te tekenen. Grootte loopt van 1 tot 32 px. Het kader bij de aanwijzer laat de vierkante penseelgrootte zien.

Klik op Dekking 100% om de schuif te openen. Een lagere waarde maakt nieuwe streken doorzichtiger. De dekking stapelt niet binnen één doorlopende streek; opnieuw over hetzelfde gebied tekenen met een nieuwe streek kan het wel dekkender maken.

Pixel-perfect is beschikbaar bij 1 px. Het verwijdert overbodige hoekpixels tijdens het tekenen van diagonale lijnen. Het is geen automatische correctie van je hele tekening.

Gum — E

Kies een grootte van 1 tot 32 px en sleep. De gum maakt pixels op de actieve layer volledig transparant. Daardoor kunnen onderliggende layers zichtbaar worden. De gum heeft geen eigen dekkingsschuif.

Vullen — G

Klik op een pixel om het aaneengesloten gebied met exact dezelfde kleur en transparantie te vullen. Pixels moeten via een zijde verbonden zijn; alleen een hoek raken is niet genoeg.

De vulling kijkt naar de actieve layer. Een rand op een andere layer houdt de vulling niet tegen. Met een actieve selectie stopt vullen bij de selectiegrens. Buiten die selectie klikken vult niets.

Pipet — I

Klik op een zichtbare kleur in je artwork. De pipet neemt de weergegeven kleur over en schakelt terug naar Potlood. Een volledig transparante pixel levert geen kleur op. De pipet neemt geen transparantie over.

Met ⌥ + klik kies je tijdelijk een kleur zonder je huidige gereedschap te wisselen.

Lijn — L

Klik op het beginpunt, sleep naar het eindpunt en laat los. Je ziet tijdens het slepen een voorbeeld. Grootte en dekking worden gedeeld met Potlood. Na loslaten is de lijn gewone pixelinhoud. Esc annuleert een lopend voorbeeld.

Vorm — U

1. Kies Rechthoek of Ellips bij Vorm.
2. Kies Omtrek of Gevuld bij Modus.
3. Voor Omtrek stel je de randdikte in met Grootte (1–32 px). De rand groeit naar binnen. Bij Gevuld is Grootte niet van toepassing.
4. Stel eventueel Dekking in.
5. Sleep van de ene hoek van het gewenste gebied naar de tegenoverliggende hoek en laat los.

Houd Shift ingedrukt tijdens het slepen voor een vierkant of cirkel. Het voorbeeld volgt deze begrenzing. De vorm blijft scherp op het pixelraster, zonder vervaagde randen. Na loslaten zijn het gewone pixels; je kunt de vorm daarna niet als een afzonderlijk vectorobject aanpassen. Esc annuleert het voorbeeld.

Verplaatsen — V

Zonder pixelselectie klik je op zichtbaar artwork om automatisch de bovenste zichtbare, niet-vergrendelde layer met een niet-transparante pixel op die plek te selecteren. Sleep direct om haar te verplaatsen; de bijbehorende rij wordt geselecteerd. Lege ruimte verandert selectie en artwork niet. Verborgen layers/groepen en vergrendelde layers worden overgeslagen. Met een actieve pixelselectie sleep je binnen de selectie om alleen dat gebied op de actieve layer te verplaatsen; automatisch kiezen vervangt deze workflow niet.

Met V actief verplaatsen de pijltjestoetsen 1 pixel per keer; Shift + pijl verplaatst 10 pixels. Spatie + slepen verschuift alleen je blik op het canvas.

Verplaatsen klapt de betreffende groep zo nodig open en brengt de geselecteerde layer in beeld. Meerdere layers selecteren verplaatst hun pixels niet gezamenlijk.

05 / HANDLEIDING

Selecteren, kopiëren en plakken

1. Kies Selectie (M).
2. Sleep een rechthoek rond het gewenste gebied.
3. Gebruik ⌘C om te kopiëren, ⌘X om te knippen of Delete om de geselecteerde pixels te wissen.
4. Gebruik ⌘V om te plakken.
5. Sleep binnen het geplakte gebied om de kopie op zijn plaats te zetten. Je hoeft vóór het plakken niet ergens anders te klikken.

Copy/Cut gebruiken uitsluitend de actieve layer, niet alle zichtbare layers samen. Je kunt eerst een andere layer kiezen en dan plakken. Kopiëren en plakken tussen JENCHA Pixel-documenten kan ook, zolang het gekopieerde gebied op het doelcanvas past.

Bij een bestaande selectie wordt op die positie geplakt; zonder selectie wordt de kopie gecentreerd. Plakken is een bewerking die je met ⌘Z kunt terugdraaien. De geplakte kopie kan daarna worden gesleept zonder het origineel weg te halen.

De selectie blijft actief als je een ander gereedschap of een andere layer kiest. Zo kun je binnen hetzelfde gebied op verschillende layers tekenen. ⌘D heft de selectie op zonder pixels te wissen. ⌘A selecteert het hele canvas. Een nieuwe rechthoek maak je door met M buiten de huidige selectie te beginnen, of eerst te deselecteren.

Esc annuleert een lopend selectiesleepvoorbeeld. Zonder lopend voorbeeld heft Esc de selectie op. Een actieve selectie wordt niet opgeslagen in je projectbestand.

Plakken verwacht een selectie die in JENCHA Pixel is gekopieerd. Gebruik voor een afbeelding uit een ander programma Importeer PNG…; rechtstreeks een Photoshop-afbeelding plakken is hier niet ondersteund.

06 / HANDLEIDING

Kleuren en palet

Klik op Kies kleur… rechts of op het kleurvak links om de macOS-kleurenkiezer te openen. Je actuele kleur staat ook als HEX-code, bijvoorbeeld #E0464A, in de zijbalk.

Klik op een paletkleur om ermee te tekenen. Dit kiest Potlood, behalve wanneer Vullen actief is. Met + onder het palet voeg je de huidige kleur toe. Met − verwijder je de gekozen kleur uit het palet; bestaande pixels met die kleur blijven staan.

Het palet hoort bij je project en wordt mee opgeslagen. Het bevat maximaal 256 kleuren. Vergroot de KLEUR-sectie voor meer zichtbare kleuren of scroll binnen het palet. Voor doorzichtig tekenen gebruik je de dekking van het gereedschap; de kleurenkiezer heeft geen alpha-instelling.

Quick Shades

Direct onder de HEX-code staan vijf kleine kleurvakjes: van links naar rechts −20%, −10%, huidige kleur, +10%, +20%. Het omlijnde middelste vakje toont exact je huidige kleur. Houd de muis boven een vakje voor de uitleg, bijvoorbeeld 20% donkerder, Huidige kleur of 10% lichter.

Klik op een vakje om die tint als tekenkleur te kiezen. Vullen blijft actief als dat geselecteerd is; anders wordt Potlood gekozen, net als bij een paletkleur. De vijf tinten worden meteen opnieuw berekend rond de nieuwe kleur. Zo kun je stap voor stap verder lichter of donkerder gaan. Ook een kleur kiezen via de kleurenkiezer, het palet of de Pipet werkt de rij bij.

De percentages veranderen de HSL-lichtheid met 10 of 20 procentpunt, met zoveel mogelijk behoud van kleurtoon en verzadiging. Dicht bij zwart of wit kunnen vakjes dezelfde kleur tonen: donkerder dan zwart of lichter dan wit kan niet. Quick Shades voegt geen transparantie toe en verandert geen bestaande pixels.

Een gekozen tint komt niet automatisch in het palet. Wil je haar bewaren, klik dan op + onder het palet en daarna op Bewaar voor je project. Gebruik de tint met je tekengereedschap om haar op je artwork toe te passen.

Quick Shades gecontroleerd op 26 september 2026.

07 / HANDLEIDING

Werken met layers

Layers zijn losse lagen boven op elkaar. De bovenste layer in de lijst ligt vooraan. Klik op een layernaam om die layer actief te maken; de markering en het vinkje laten zien welke geselecteerd is.

Onderaan LAYERS staan nieuwe layer (+), nieuwe groep (mapje), dupliceren (twee vierkantjes) en verwijderen (prullenbak). Houd je muis op een knop voor uitleg.

• Naam wijzigen: vul boven de lijst een naam in en klik Hernoem of druk Enter.
• Tonen/verbergen: klik op het oog. Verbergen wist niets.
• Dekking: klik op het percentage om de schuif te openen. Dit wijzigt de zichtbaarheid van de hele layer, niet de opgeslagen kleuren van losse pixels.
• Volgorde: sleep de greep links van de layer. De invoeglijn toont de bestemming. De pijltjes onderaan verplaatsen de layer één positie binnen dezelfde groep of tussen losse layers.
• Rechtermuisknop: batchacties werken op de selectie wanneer de aangeklikte rij geselecteerd is; anders op die ene layer.

Een nieuwe layer komt boven de actieve layer en neemt diens groep over. Minimaal één layer blijft bestaan. Je kunt maximaal 256 layers hebben; op grote canvassen kan de geheugenlimiet eerder bereikt worden (bij 1024 × 1024 maximaal 16).

Meerdere layers selecteren en samen bewerken

• Gewoon klikken selecteert één layer. ⌘-klik voegt een layer toe of verwijdert haar uit de selectie. Shift-klik selecteert het zichtbare bereik vanaf het anker; ⌘-Shift-klik voegt dat bereik toe. Ingeklapte groepsinhoud valt niet binnen een zichtbaar bereik.
• Geselecteerde rijen hebben een blauwe/accentkleur en een vinkje. Tekenen werkt nog steeds op één actieve layer, niet op alle gemarkeerde layers.
• Open Geselecteerde layers boven de lijst of klik rechts op een geselecteerde rij. Tonen/Verbergen en Vergrendelen/Ontgrendelen zetten de hele selectie in dezelfde toestand. Een oog op een geselecteerde rij zet alle geselecteerde layers op de nieuwe zichtbaarheid van die rij.
• Dupliceren/Verwijderen en de onderste knoppen werken op de selectie. Minimaal één layer blijft staan; dupliceren respecteert de projectlimiet. Vergrendelde layers kunnen niet worden verwijderd of met pixeltools bewerkt. Een slotje markeert ze; de vergrendeling wordt opgeslagen.
• Verander de volgorde met de sleepgreep van een geselecteerde rij of de pijlen. De layers behouden onderling hun volgorde en bewegen als blok binnen dezelfde groep/parent. Een selectie met verschillende parents of vergrendelde layers kan niet samen worden geordend. Dit verplaatst de stapelvolgorde, niet meerdere artworks tegelijk op het canvas.
• Rechtsklikken op een niet-geselecteerde rij richt batchacties op die ene rij. Hernoemen, dekking en groepsindeling blijven bediening voor één layer.

Geselecteerde layers samenvoegen

Kies Geselecteerde layers samenvoegen in Geselecteerde layers of het rechtermuisknopmenu. Selecteer minstens twee aangrenzende, zichtbare, niet-vergrendelde layers binnen dezelfde groep (of allemaal zonder groep). Ze worden één Samengevoegde layer op dezelfde stapelpositie. ⌘Z herstelt de originelen; ⇧⌘Z herhaalt het samenvoegen.

Verschillende groepen, niet-aangrenzende, verborgen of vergrendelde layers geven een uitleg in plaats van een merge. De app vergelijkt ook de exacte eindpixels: als afronding van transparantie/dekking de afbeelding zou wijzigen, weigert zij de merge. Houd die layers gescheiden. Samenvoegen verandert namen/structuur en kan dus traits wijzigen of een nieuwe collectie vereisen; bewaar een bronkopie voordat je collectievarianten vereenvoudigt.

08 / HANDLEIDING

Layers in groepen ordenen

1. Selecteer een losse layer.
2. Klik op het mapje onderaan LAYERS. Er ontstaat een groep met die layer.
3. Dubbelklik op de groepsnaam om die te wijzigen, of gebruik de rechtermuisknop.
4. Kies een andere layer en gebruik het groepsmenu boven de lijst, of Naar groep in het rechtermuisknopmenu, om haar toe te voegen.

Zit de actieve layer al in een groep? Dan maakt het mapje een nieuwe lege groep; de bestaande groep blijft behouden.

Het pijltje bij de groepsnaam klapt de lijst in of uit. Het oog verbergt de hele groep. Sleep de groepsgreep om de groep inclusief layers in de stapel te verplaatsen. De onderlinge layervolgorde blijft gelijk. Klap grote groepen eerst in als dat makkelijker sleept.

Uit groep halen maakt een layer weer los. Groep opheffen (layers behouden) verwijdert alleen de groepering. Er zijn geen geneste groepen. Een lege groep heeft geen inhoud om in de pixelstapel te verplaatsen en staat bovenaan.

Een groep hoger in de layerlijst zetten verandert de stapelvolgorde. Dit verplaatst niet alle groepspixels samen over het canvas; zo’n gezamenlijke canvasverplaatsing is niet beschikbaar.

09 / HANDLEIDING

Spiegelen en draaien

Selecteer een layer en open Spiegelen en kantelen, of klik rechts op de gewenste layer en open hetzelfde submenu. Kies horizontaal/verticaal spiegelen of 90° linksom/rechtsom draaien.

Deze acties gelden voor de hele layer, ook als een pixelselectie actief is. De canvasafmetingen blijven gelijk. Pixels buiten de canvasrand worden afgesneden; ⌘Z kan de handeling terugdraaien. Bij een rechthoekig canvas kan 90° draaien dus delen buiten beeld brengen. Vrij draaien en schalen zijn niet beschikbaar.

10 / HANDLEIDING

Een PNG importeren

1. Controleer de pixelafmetingen van je PNG.
2. Open of maak een project met precies dezelfde breedte en hoogte.
3. Klik op Importeer PNG… en kies het bestand.
4. De PNG verschijnt als nieuwe layer boven de actieve layer, in dezelfde groep indien van toepassing.

Een PNG van 64 × 64 past alleen in een canvas van 64 × 64. De app schaalt de afbeelding niet automatisch. Transparantie blijft behouden. Importeer een gewone, niet-geanimeerde PNG; PSD, JPEG en SVG worden niet via deze knop geïmporteerd.

Zie je wel een nieuwe layer, maar geen afbeelding? Controleer het oog van de layer én van haar groep. Een nieuwe layer in een verborgen groep is ook verborgen. Controleer daarnaast de dekking en of hogere layers de afbeelding bedekken.

11 / HANDLEIDING

Projecten bewaren

Bewaar / ⌘S bewaart je werk als .jenchapixel. Gebruik Opslaan als… voor een andere naam of locatie. Bewaar geregeld, vooral vóór grote wijzigingen.

Je project bevat de pixels, layers, groepen, hun namen en zichtbaarheid, layerdekking, metadata-keuzes, het palet, layervergrendeling en Projectgegevens. Zoom, actieve selectie, gereedschapsinstellingen en undo-historie worden niet als blijvende werkruimte opgeslagen.

De app gebruikt de native automatische opslag en herstelmogelijkheden van macOS. Herstel is getest, ook met een nog nooit handmatig opgeslagen document. Dat is geen garantie dat de allerlaatste handeling vóór een crash terugkomt. Handmatig bewaren en een backup blijven belangrijk.

Een PNG bewaart geen afzonderlijke bewerkbare layers. Houd daarom ook je projectbestand.

Projectgegevens…

Open Projectgegevens… in de bovenbalk om informatie één keer in te voeren en bij export te hergebruiken. Bij een smal venster gaan de tekstknoppen naar een tweede regel.

Klik op Bewaar in het paneel om de gegevens toe te passen en bewaar daarna het project met ⌘S. Bewaar, Opslaan als, sluiten en heropenen behouden de gegevens. Projectnaam en Collectienaam zijn onafhankelijk. Bestaande projecten openen zonder dat je deze gegevens eerst moet invullen. Lege optionele waarden worden niet geëxporteerd. Vermijd dubbele veldnamen of traitnamen die gelijk zijn aan Name, Collection, Description of Website: de app blokkeert onduidelijke vlakke metadata in plaats van een waarde te overschrijven.

Projectgegevens en layervergrendeling gebruiken het huidige projectformaat. Oude projecten blijven in deze app leesbaar; een oudere appbuild kan een project met deze aanvullingen mogelijk niet openen. Bewaar backups bij uitwisseling met een oudere build.

12 / HANDLEIDING

Exporteren als PNG

Single Item-export is Free. Exporteer een PNG of zet optionele JSON aan voor zowel Bitcoin Inscription Metadata als NFT Marketplace Metadata. Een Pro-abonnement is niet nodig. Single Item maakt geen collectienummering of opgeslagen collectiestatus.

1. Zet de layers en groepen die je wilt zien aan. Verborgen inhoud wordt niet geëxporteerd.
2. Klik op Export… en kies Eén item.
3. Kies een schaalfactor: Origineel (1×), 2×, 4×, 8×, 16×, 32× of 64×. Controleer de getoonde uitvoerafmetingen; de beginwaarde is 32×.
4. Laat JSON-metadata exporteren uit als je alleen een afbeelding nodig hebt.
5. Klik op Export…, kies een map en bestandsnaam en bevestig.

Voorbeeld: een canvas van 32 × 32 wordt op 16× een PNG van 512 × 512. Elke oorspronkelijke pixel wordt een scherp blok van 16 × 16 pixels. De weergavezoom van je canvas heeft geen invloed op export.

Export neemt het hele canvas mee, niet alleen een actieve selectie. Transparantie en layerdekking worden meegenomen. Raster, selectieomlijning en aanwijzer worden niet geëxporteerd.

De standaardnaam komt van je project. Je mag hem aanpassen. JENCHA Demo.jenchapixel stelt JENCHA Demo.png voor. Er wordt geen automatisch nummer zoals -0001 toegevoegd.

Is de uitvoer te groot? Kies een kleinere schaal. De app begrenst export tot 67.108.864 uitvoerpixels (in de melding afgerond aangeduid als ‘64 miljoen’). Een bestaand bestand vervangen vraagt bevestiging. Annuleren schrijft geen nieuwe export weg.

Zonder opgeslagen projectbestandsnaam stelt alleen-PNG Artwork voor; de bestandsnaam blijft vrij te kiezen. Voor PNG met beide metadataformaten zie JSON-export. Alle vijf exportkeuzes staan bij Collection Builder.

13 / HANDLEIDING

Groepen als eigenschappen gebruiken

Dit hoofdstuk is optioneel. Je hebt metadata niet nodig om gewoon te tekenen of een PNG te delen.

Een eigenschap (trait) beschrijft iets in je artwork. Bijvoorbeeld: categorie HAAR, waarde Blond. Voor JSON gebruikt JENCHA Pixel de groepsnaam als categorie en de layernaam als waarde.

1. Maak een groep HAAR met bijvoorbeeld layers Blond en Bruin.
2. Laat alleen de variant zien die bij je afbeelding hoort.
3. Open het driepuntjesmenu of rechtermuisknopmenu van de groep.
4. Laat Opnemen in metadata aan voor groepen die eigenschappen moeten leveren.
5. Zet dit uit voor een groep die alleen je tekenwerk ordent. De afbeelding blijft gelijk.

Per opgenomen, zichtbare groep kan maximaal één actieve layer een eigenschap leveren. Actief betekent: het oog staat aan, de layerdekking is hoger dan nul en er zijn pixels die na die dekking niet volledig transparant zijn. Een layer die door een hogere layer wordt bedekt kan nog steeds actief meetellen.

Geen actieve layer betekent geen eigenschap voor die groep. Losse layers leveren geen eigenschap. Geef categorieën bij voorkeur verschillende namen om je bestand duidelijk te houden.

14 / HANDLEIDING

JSON-metadata exporteren

Single Item-export is Free. Exporteer een PNG of zet optionele JSON aan voor zowel Bitcoin Inscription Metadata als NFT Marketplace Metadata. Een Pro-abonnement is niet nodig. Single Item maakt geen collectienummering of opgeslagen collectiestatus.

1. Richt groepen in zoals in hoofdstuk 13 en vul eventueel Projectgegevens… in (hoofdstuk 11).
2. Open Export… Eén item en zet JSON-metadata exporteren aan.
3. Controleer Metadatavoorbeeld: eerst Naam, daarna Projectdetails en Eigenschappen als compacte veld/waarde-rijen. Twee vinkjes bevestigen Bitcoin Inscription Metadata en NFT Marketplace Metadata. Er zijn geen aparte formaatsecties of schemakeuzes.
4. Kies de schaal en klik Export…. Kies een doelmap. De app maakt daar een nieuwe map <projectbestandsnaam> Export. Bij een onbewaard document gebruikt zij Projectnaam, of Artwork als projectgegevens ontbreken.

Voor mijn-artwork.jenchapixel:

mijn-artwork Export/
  Images/mijn-artwork.png
  Bitcoin Inscription Metadata/mijn-artwork.json
  NFT Marketplace Metadata/mijn-artwork.json

Eén vinkje maakt automatisch twee metadataversies; er is geen schema- of platformkeuze. De drie bestanden hebben precies dezelfde bestandsstam. Er komt geen -bitcoin of -marketplace achter de naam. De mapnamen blijven in beide interfacetalen Engels.

Bitcoin Inscription Metadata bevat leesbare tekstvelden: Name, optioneel Collection, Description, Website, je Extra gegevens en de opgenomen traits. Bijvoorbeeld "Creator": "JENCHA" en "HAAR": "Blond".

NFT Marketplace Metadata behoudt de gebruikelijke structuur:

{
  "name": "mijn-artwork",
  "description": "Een pixelartstudie.",
  "external_url": "https://pixel.jencha.com",
  "attributes": [{ "trait_type": "HAAR", "value": "Blond" }]
}

Lege description en external_url worden weggelaten. Extra gegevens en Collection komen niet in marketplace-JSON: daarvoor wordt geen willekeurige indeling aangenomen. Er komt geen fictieve image-URL. Zonder traits is attributes een lege lijst. Bij Eén item is de itemnaam de exportbestandsstam. Nieuwe collecties gebruiken de collectienaam plus een nummer zonder voorloopnullen, bijvoorbeeld JENCHA Demo Collection #1, bij bestand JENCHA Demo Collection-00001.png. Projectnaam is een aparte interne titel. Eigen namen en waarden worden nooit vertaald.

Het compacte voorbeeld verandert alleen de presentatie, niet het JSON-schema. Meerdere actieve traits in één groep blokkeren JSON-export. Dubbele vlakke veldnamen, ook met afwijkende hoofdletters of omringende spaties, worden eveneens geblokkeerd. Hernoem het betreffende detail/de groep, verberg extra varianten of exporteer alleen PNG.

Bestaande exportmappen worden nooit overschreven. Kies een andere doelmap of hernoem/verplaats je vorige export voordat je opnieuw exporteert. PNG-only houdt de gewone bestandsnaamkeuze en vervangingsvraag; eerdere metadata wordt niet bijgewerkt of verwijderd. Eén item heeft geen automatische nummering. Voor collecties zie hoofdstuk 17. Export uploadt, inscribeert of publiceert niets.

De mapscreenshot toont een collectie-item en gebruikt daarom vijf cijfers. Eén item gebruikt de ongenummerde projectbestandsstam, zoals in het mapvoorbeeld hierboven.

15 / HANDLEIDING

Sneltoetsen

Gereedschaps- en canvassneltoetsen gelden wanneer het canvas actief is. Tijdens het typen van een layernaam blijven toetsen gewone tekstbewerkingen. Kies zo nodig een gereedschap in de linker balk om terug te keren naar het canvas.

Free, Pro en collectiebediening

Free: volledig bewerken, bewaren, Single Item PNG + beide optionele JSON-formaten, collectie-instellingen en maximaal 100 tijdelijke lokale preview-items. Pro: blijvende Create / Add / Resume / Extend, zoveel collecties als je wilt, maximaal 10.000 items per collectie.

1. Preview Collection (Collectievoorbeeld): stel het volledige doel, de rollen en de verdeling in en bekijk maximaal 100 tijdelijke voorbeelden. Geen doelmap of exportbestanden.
2. Regenerate Preview (Voorbeeld opnieuw genereren): vervang de steekproef. Back to Settings (Terug naar instellingen): pas dezelfde instellingen aan zolang het configuratiescherm open blijft. Sluiten verwijdert de preview.
3. Create Collection — Pro (Collectie maken — Pro): open het Pro-aanbod in Free. Kopen start geen productie. Kies na activering een doelmap en klik bewust op Create (Maken).

Pro-workflows: Create = nieuwe collectie; Add = één handmatig gekozen item; Resume = het opgeslagen doel afmaken; Extend = een voltooide collectie naar een nieuw totaal vergroten. 50 100 voegt 50 toe. Resume en Extend staan op het eerste Export-scherm; bewaar de hele collectiemap.

Appmenu: JENCHA Pixel Pro… · Restore Purchases · Manage Subscription…. Restore controleert je Apple-aankopen; Manage opent Mac App Store-abonnementen.

16 / HANDLEIDING

Als iets niet werkt zoals verwacht

Blijft er een probleem? Bewaar indien mogelijk een kopie van je project. Noteer wat je deed, het canvasformaat, je macOS-versie en eventuele foutmelding. Voeg bij een melding een screenshot toe zonder privégegevens.

Layers, metadata en collecties

Neem contact op met support

Problemen met abonnementen · Collection Preview

17 / HANDLEIDING

Collection Builder — een collectie maken

Een collectie is een reeks bij elkaar horende afbeeldingen, bijvoorbeeld zes robotportretten met verschillende achtergronden en ogen. Eén portret heet een item. Je hoeft niets te weten van NFT's, blockchains of programmeren. JENCHA Pixel maakt gewone afbeeldingen en beschrijvingen op je Mac; de app publiceert, verkoopt of mint ze niet.

Je kunt ieder portret zelf samenstellen met Toevoegen aan collectie, of Collectie maken de voorbereide varianten laten combineren. Bewaar eerst je bewerkbare project.

De nieuwe verdelingsscreenshots gebruiken het echte JENCHA Demo-project: zeven groepen en 38 layers. Het voltooide Balanced-voorbeeld heeft 220.500 beschikbare combinaties. De les met zes items hieronder is een kleiner, apart oefenproject. Andere afbeeldingen tonen hun eigen instellingen, zoals in de bijschriften staat. Eigen namen zoals Background en Creator worden niet vertaald. Nieuwe screenshots tonen de Engelse appinterface; bijbehorende Nederlandse en Engelse knopnamen staan in de uitleg. Ongewijzigde oudere screenshots kunnen nog de Nederlandse interface tonen.

Free, Pro en een collectievoorbeeld

Free is een volledige pixeleditor. Teken, organiseer layers en groepen, maak selecties, gebruik Quick Shades, bewaar en heropen projecten, importeer PNG’s en exporteer via Single Item een PNG plus beide optionele metadataformaten. Projectgegevens, traits, Required / Optional / Fixed en Balanced / Random / Weighted zijn ook Free.

Pro is voor blijvende collectieproductie: Create, Add to Collection, Resume en Extend. Maak zoveel collecties als je wilt, met maximaal 10.000 items per collectie. Pro omvat bulk-artwork en metadata, automatische nummering en duplicaatcontrole binnen de hele collectie.

JENCHA Pixel Pro Monthly is een maandabonnement via Apple. De app toont vóór aankoop de actuele prijs voor jouw App Store-regio. Het wordt iedere maand automatisch verlengd totdat je opzegt. Na opzegging blijft Pro actief tot de betaalde periode eindigt. Daarna blijft Free volledig bewerkbaar en blijven bestaande exports van jou: niets wordt verwijderd, vergrendeld of gewatermerkt.

Probeer een lokale Collection Preview

1. Open Export… Create Collection (Collectie maken).
2. Kies de naam, het volledige doelaantal, de rollen en de verdeling. Een doelmap is niet nodig voor een preview.
3. Klik op Preview Collection (Collectievoorbeeld). De app maakt lokaal maximaal 100 tijdelijke unieke voorbeelden; bij een kleiner doel zijn het er minder. Er ontstaan geen PNG’s, JSON-bestanden, manifest of blijvende collectiestatus.
4. Open bij Balanced of Weighted Planned distribution for … items (Geplande verdeling). De aantallen gelden voor het volledige doel: 10% van 3.000 plant 300 items, ook als je hooguit 100 voorbeelden ziet. Dit zijn doelen, geen gegarandeerde zeldzaamheid. Random toont Sample distribution (Verdeling in dit voorbeeld) en garandeert geen exacte percentages.
5. Kies Regenerate Preview (Voorbeeld opnieuw genereren) voor een nieuwe steekproef of Back to Settings (Terug naar instellingen) om dezelfde instellingen aan te passen. Opnieuw genereren vervangt de oude voorbeelden. Terug bewaart je instellingen zolang het configuratiescherm open blijft. Sluiten verwijdert de tijdelijke preview. Veel identieke beelden kunnen minder voorbeelden opleveren; de app legt dit uit.
6. Create Collection — Pro (Collectie maken — Pro) opent in Free het abonnementsaanbod. Kopen start nooit generatie. Ga na activering terug, kies een doelmap, controleer de instellingen en klik bewust op Create (Maken).

Preview is beschikbaar in Free en Pro. Het is een steekproef om artwork en de mix te controleren, geen opgeslagen collectie of bulkexport. De preview garandeert niet exact dezelfde definitieve items of mix. Je kunt Add, Resume of Extend niet op een preview gebruiken. Required / Optional / Fixed en de verdelingsregels hieronder blijven gelden. Er is geen JENCHA-account of cloud nodig.

Pro-toegang, herstellen en beheren

In het appmenu staan JENCHA Pixel Pro…, Restore Purchases (Aankopen herstellen) en Manage Subscription… (Beheer abonnement…). Herstellen controleert je aankopen bij Apple via je Apple Account. Geen actief abonnement gevonden? Free blijft beschikbaar. Een aankoop in behandeling ontgrendelt pas nadat Apple bevestigt. Mislukt een controle, kies dan Retry (Opnieuw proberen) of Restore Purchases; je kunt Free blijven gebruiken.

Manage Subscription opent Mac App Store-abonnementen. Een al toegestane generatie kan veilig afronden als Pro eindigt; voor een nieuwe Create-, Add-, Resume- of Extend-actie is actieve Pro nodig. Kopen of herstellen start nooit automatisch productie. Je artwork blijft lokaal op je Mac. Privacy en Terms blijven zonder abonnement bereikbaar.

Bekijk het Pro-venster

Hulp bij aankopen en abonnementen

De bouwstenen begrijpen

Zet iedere variant op een eigen layer, op de bedoelde canvaspositie. Zet bij elkaar horende alternatieven in dezelfde groep. De normale layervolgorde en dekking bepalen wat bovenop verschijnt. Begin met een klein oefenproject.

Waarom drie achtergronden en twee soorten ogen zes items geven

Maak bijvoorbeeld deze twee groepen. De Engelse namen zijn eigen projectnamen; je mag ook Nederlandse namen kiezen.

Zet beide op Verplicht. Iedere achtergrond kan met beide soorten ogen: Blue/Normal, Blue/Laser, Red/Normal, Red/Laser, Green/Normal en Green/Laser. Dat zijn 3 × 2 = 6 beschikbare combinaties. De app rekent dit voor je uit.

250 layers betekent niet automatisch 10.000 items. Eén verplichte groep met 250 varianten geeft 250 keuzes. Alternatieven verdelen over verschillende groepen kan veel meer combinaties geven. Vaste inhoud voegt geen keuzes toe. Verschillende combinaties kunnen bovendien hetzelfde beeld geven, bijvoorbeeld wanneer een hogere layer de verschillende ogen bedekt. Alleen unieke eindafbeeldingen worden opgeslagen.

Kies de juiste exportworkflow

Instellen en Preview zijn Free. Blijvende Create, Add, Resume en Extend vragen actieve Pro. In Free tonen Add, Resume en Extend het Pro-aanbod voordat je een collectiemap kiest.

• Eén item: exporteer het huidige zichtbare artwork één keer. Bij alleen PNG kies je de bestandsnaam; met JSON wordt de opgeslagen projectbestandsstam gebruikt, of Projectnaam / Artwork bij een onbewaard project. Zie hoofdstukken 12–14.
• Toevoegen aan collectie: kies zelf de zichtbare layers voor ieder item. De app regelt nummering, PNG/JSON-uitvoer en duplicaatcontrole.
• Collectie maken: bereid groepen voor en begin een nieuwe gegenereerde collectie.
• Collectie hervatten: maak een onderbroken generatie af tot het opgeslagen doel.
• Collectie uitbreiden: vergroot een voltooide collectie naar een nieuw totaal. Beide keuzes staan op het eerste Export-scherm en vragen om de bestaande collectiemap.

Nieuwe collectie-workflows slaan altijd één PNG en twee bijbehorende JSON-bestanden in aparte mappen op. JENCHA Demo Collection-00001.png is bijvoorbeeld de afbeelding en JENCHA Demo Collection-00001.json beschrijft datzelfde item. Je hoeft de bijbehorende nummers niet zelf bij te houden. Wil je maar één PNG zonder JSON, gebruik dan Eén item.

Alle onderdelen van Collectie maken

Nieuwe collectie? Doelmap kiezen.

Onvoltooide collectie afmaken? Export Collectie hervatten.

Voltooide collectie vergroten? Export Collectie uitbreiden.

Maak dus geen nieuwe doelmap om te hervatten. De bestaande map vertelt de app welke nummers en combinaties al zijn gebruikt.

Verplicht, Optioneel en Vast: de werkelijke werking

Een vaste groep varieert niet. Verplicht en Optioneel volgen de afzonderlijke instelling Verdeling, zoals hieronder uitgelegd.

Verborgen alternatieven in Verplicht/Optioneel tellen mee als kandidaten, ook wanneer hun groep in de editor verborgen is. Lege layers en layers zonder effectieve dekking tellen niet mee. Losse layers blijven vaste inhoud met hun opgeslagen zichtbaarheid. Export verandert de zichtbaarheid in de editor niet.

Opnemen in metadata staat in het groepsmenu in de editor (hoofdstuk 13). Het bepaalt de geschreven eigenschappen, niet of artwork zichtbaar is. Opgenomen groepen beginnen standaard als Verplicht; andere groepen als Vast. Controleer dit. Zet metadata uit bij een vaste basis met meerdere zichtbare layers om een conflict te voorkomen. Eigen groeps-, layer- en traitnamen worden letterlijk behouden.

Verdeling: Evenwichtig, Willekeurig of Gewogen

Groepsrollen en verdeling beantwoorden verschillende vragen. Verplicht / Optioneel / Vast bepalen wat in één item mag verschijnen. Verdeling bepaalt hoe die keuzes over de collectie worden verspreid. Vaste groepen krijgen geen percentagevelden.

De nieuwe afbeeldingen gebruiken de Engelse appinterface. De bijbehorende Nederlandse labels staan in de tekst: Balanced = Evenwichtig, Random = Willekeurig, Weighted = Gewogen en None = Geen.

Geen / None betekent: geen variant uit deze groep. JENCHA Pixel voegt die keuze automatisch toe aan Optioneel. Je maakt geen lege layer of transparante afbeelding. Voor dat item ontbreekt het variabele artwork uit die groep; ander zichtbaar artwork blijft staan. Vier hoofddeksels plus Geen geven vijf keuzes: bij 500 items streeft Evenwichtig naar 100 van iedere keuze.

Bij Geen levert de groep geen eigenschap in Bitcoin Inscription Metadata én NFT Marketplace Metadata. Er verschijnt geen eigenschap met waarde “None” of “Geen”. Opnemen in metadata blijft gelden voor werkelijk gekozen varianten.

Gewogen percentages instellen

1. Kies Gewogen / Weighted bij Verdeling. Groepen en details klapt open.
2. Open Percentages per variant / Variant percentages bij iedere verplichte of optionele groep.
3. Vul per variant een percentage in. Optionele groepen hebben ook Geen / None.
4. Controleer Totaal: 100.00% / Total: 100.00% per variabele groep. Maken blijft grijs zolang een groep ongeldig is.

De beginpercentages verdelen 100% gelijk, met kleine afrondingsverschillen waar nodig. Maximaal twee decimalen, met punt of komma: 12.50 of 12,50. Ieder percentage ligt tussen 0 en 100 en iedere groep moet precies 100% vormen. 0% sluit die keuze uit van Gewogen generatie én Beschikbare combinaties. Alleen nullen is ongeldig. Een optionele groep mag uitsluitend Geen op 100% overhouden: één keuze zonder eigenschap.

Zes achtergronden met 40 / 25 / 15 / 10 / 5 / 5% geven bij 400 items het doel 160 / 100 / 60 / 40 / 20 / 20. Afronden op hele items gebeurt herhaalbaar; het extra item gaat niet steeds naar de eerste variant. Geen = 15% bij Headwear streeft naar 60 items zonder hoofddeksel op 400. Iedere groep heeft een eigen totaal; tel percentages uit verschillende groepen niet bij elkaar op.

Unieke afbeeldingen gaan vóór exacte percentages. Bedekte of identieke varianten kunnen de perfecte verdeling onmogelijk maken. Duplicaten worden nooit bewaard om een percentage te halen. Bij onvoldoende unieke uitvoer volgt het werkelijk opgeslagen aantal of een begrensde zoekstop; een onvolledig doel wordt niet als voltooid gemeld. Dit zijn doelverdelingen, geen garantie op exacte zeldzaamheid of oplage.

Beschikbare combinaties rekent met N keuzes bij Verplicht, N + Geen bij Optioneel en één opgeslagen toestand bij Vast. Gewogen telt alleen keuzes boven 0%. Het aantal blijft een bovengrens voor combinaties, geen garantie op zoveel verschillende afbeeldingen.

Een echt voorbeeld met 400 items

De JENCHA Demo in de nieuwe afbeeldingen heeft 7 groepen en 38 layers. Background, Skin, Eyes en Mouth zijn Verplicht; Clothes, Headwear en Accessory zijn Optioneel. Dat geeft 6 × 5 × 7 × 6 × 5 × 7 × 5 = 220.500 combinaties. Evenwichtig maakte 400 unieke beelden: iedere achtergrond 66 of 67 keer, iedere skin 80 keer en 57 items zonder Headwear. Er zijn geen lege layers toegevoegd.

Taak: een nieuwe automatisch gegenereerde collectie maken

Blijvende collectieproductie vraagt actieve Pro.

1. Bereid het project voor en bewaar het. Zet Blue, Red en Green in Background, en Normal en Laser in Eyes. Maak een eventuele onveranderlijke basis zichtbaar.
2. Kies Export… Collectie maken (Create Collection).
3. Vul naam JENCHA Demo Collection en 6 bij Aantal items in.
4. Behoud Verdeling: Evenwichtig voor je eerste collectie. Klap Groepen en details / Groups and details uit. Kies Verplicht bij Background en Eyes, en Vast bij een onveranderlijke basis. Controleer metadata-inclusie in de editor als er een conflict verschijnt.
5. Kies Uitvoerformaat / Output size, bijvoorbeeld 512 × 512 bij een bron van 64 × 64.
6. Probeer Preview Collection voor een tijdelijke steekproef. Ga terug met Back to Settings. Kies in Free Create Collection — Pro en keer hier terug nadat Pro actief is; kopen start geen generatie.
7. Klik op Doelmap… / Destination folder… en kies waar de nieuwe map JENCHA Demo Collection moet komen.
8. Controleer Beschikbare combinaties: 6 en Klaar om te genereren. Gebruik Preview Collection als je alleen een tijdelijke steekproef wilt.
9. Klik op Maken / Create. Wacht op de eindmelding en bekijk de afbeeldingen in Images/.

Tijdens generatie toont Collectie genereren het opgeslagen aantal, totaal, percentage en een voortgangsbalk. Bij identieke beelden verschijnt hoeveel afbeeldingen zijn overgeslagen. Annuleer vraagt de app na het huidige item te stoppen; voltooide items blijven bewaard. De hele collectie wordt niet verwijderd of teruggedraaid. Er is geen aparte pauzeknop.

Als er niet genoeg unieke beelden te vinden zijn, stopt de app veilig en meldt het werkelijk opgeslagen aantal. Voltooide items blijven bewaard. Je kunt hervatten, of de bron verbeteren en een nieuwe collectie beginnen; het gewenste doel wordt niet als voltooid gemeld als minder items zijn gemaakt.

Taak: een onvoltooide collectie hervatten

Blijvende collectieproductie vraagt actieve Pro.

1. Open het bijbehorende project. Is het gewijzigd, open dan source.jenchapixel uit de collectiemap.
2. Kies Export… Collectie hervatten (Resume Collection) op het eerste Export-scherm.
3. Selecteer de volledige collectiemap met manifest.json en source.jenchapixel, niet een uitvoermap of los bestand.
4. Controleer Huidige items / Current items, Doelaantal / Target size en Resterend / Remaining. In de afbeelding: 728, 1.000, 272.
5. Klik op Hervatten / Resume. Items 1–728 blijven ongewijzigd; generatie gaat verder bij 729 en maakt het opgeslagen doel van 1.000 af.

Collectie kiezen selecteert een andere map; Sluiten / Close verlaat het scherm. Hervatten gebruikt de opgeslagen bron, rollen, schaal, metadata-instellingen, verdeling, percentages en generatievoortgang. De al bereikte verdeling telt mee; de doelen beginnen niet opnieuw bij nul. Een afwijkend project, beschadigde uitvoer of ongeldige administratie blokkeert voortzetting. Alleen zichtbaarheid wijzigen mag wel. Gebruik Collectie uitbreiden voor een voltooide collectie. Een uitsluitend handmatig opgebouwde collectie heeft geen generatiedoel: gebruik Toevoegen aan collectie.

Taak: een voltooide collectie uitbreiden

Blijvende collectieproductie vraagt actieve Pro.

1. Open het bijbehorende project of source.jenchapixel uit de collectie.
2. Kies Export… Collectie uitbreiden (Extend Collection) en selecteer de bestaande volledige collectiemap.
3. Bekijk Huidig aantal / Current size en vul Nieuw totaal / New total in, zoals hier: huidig 100 en nieuw totaal 1.000.
4. Te genereren items / Items to generate toont automatisch 900. Dit veld vul je niet zelf in.
5. Klik op Collectie uitbreiden / Extend Collection. De app controleert eerst of er genoeg verschillende beelden over zijn en genereert daarna de extra items.

Bestaande PNG- en JSON-bestanden blijven byte voor byte ongewijzigd. Nummering gaat verder bij 101. Duplicaten worden vergeleken met zowel bestaande als nieuw toegevoegde items. Bron, groepen, regels, schaal, verdeling, percentages en metadataformaten blijven gelijk. Evenwichtig en Gewogen tellen bestaande items, inclusief handmatige toevoegingen, en sturen de nieuwe items naar de doelen voor het nieuwe totaal. Bestaande uitvoer wordt nooit herschreven om de percentages mooier te maken. Oude collecties behouden hun oorspronkelijke uitvoermappen. Later opnieuw uitbreiden kan, met een hoger nieuw totaal.

Het nieuwe totaal moet hoger zijn dan het huidige aantal en mag niet boven 10.000 of de combinatiegrens liggen. Veel combinaties betekenen niet automatisch veel verschillende beelden. De voorafgaande controle berekent beelden zonder bestanden te exporteren; bij te weinig unieke beelden worden het doelaantal en de items niet gewijzigd. Bij zeer veel herhalingen kan de controle veilig stoppen en vraagt de app om een kleiner totaal. De controle kan tijd kosten; Annuleer laat de collectie tijdens deze controle ongewijzigd.

Na een geslaagde controle wordt het nieuwe doel opgeslagen. Annuleren tijdens generatie behoudt voltooide items én dat doel. Kies Hervatten / Resume in het huidige scherm of na opnieuw openen Export Collectie hervatten. Handmatig toegevoegde items binnen een eerder gegenereerde collectie tellen mee en doen mee aan duplicaatcontrole. Een uitsluitend handmatige collectie kan niet automatisch worden uitgebreid.

Taak: handmatig samengestelde items toevoegen

Blijvende collectieproductie vraagt actieve Pro.

1. Maak de layers/groepen voor het eerste item zichtbaar in de editor.
2. Kies Export… Toevoegen aan collectie.
3. Vul voor een nieuwe collectie de naam, het uitvoerformaat en de doelmap in. Er is hier geen automatisch aantal of groepsrolkeuze: je bepaalt het zichtbare resultaat zelf.
4. Klik op Toevoegen aan collectie zodra Klaar om toe te voegen verschijnt. Het eerste item krijgt nummer 00001.
5. Na succes is de knop grijs met ✓ Toegevoegd aan collectie. De itembevestiging blijft zichtbaar; je hoeft niet opnieuw te klikken.
6. Sluit het scherm, wijzig de zichtbaarheid voor het volgende item en open Toevoegen aan collectie opnieuw.
7. Klik op Bestaande collectie kiezen… en selecteer de hoofdmap. Controleer Opgeslagen items en klik op Toevoegen aan collectie. De nummering gaat verder met 00002, ook na een app-herstart.

Andere collectie kiezen…, Nieuwe collectie en Sluiten werken zoals hierboven. Na een mislukte toevoeging blijft de gewone actie beschikbaar om na het oplossen van de fout opnieuw te proberen. Duplicaatcontrole blijft een extra beveiliging.

Gebruik hetzelfde bronproject om handmatig verder te gaan. Zichtbaarheid wijzigen mag; andere wijzigingen aan pixels, namen, layervolgorde, dekking, groepen of brongegevens vereisen een nieuwe collectie. Collectienaam en uitvoerformaat staan na het aanmaken vast. Zo blijven nieuwe items consistent met eerder opgeslagen items.

Verdeling kiest geen handmatig item voor je: Toevoegen gebruikt het artwork dat je zichtbaar hebt gemaakt. Nummering en duplicaatcontrole blijven gelden. Toevoegingen aan een gegenereerde collectie tellen mee in het totaal en in de doelen van een latere uitbreiding.

Waarom een item dubbel kan zijn

• Dubbele combinatie: dezelfde bronlayers zijn opnieuw gekozen, bijvoorbeeld dezelfde layer Blue en dezelfde layer Normal.
• Dubbel beeld: andere layers zijn gekozen, maar de eindafbeelding is op oorspronkelijk canvasformaat identiek. Bijvoorbeeld wanneer zowel normale als laserogen volledig onder een helm verdwijnen.

De controle gebruikt de echte bronlayerkeuzes, niet alleen hun namen. Geef varianten duidelijke, verschillende namen. Bij Toevoegen aan collectie wordt een duplicaat geblokkeerd en noemt de melding het bestaande itemnummer. Bij Collectie maken slaat de app duplicaten over en zoekt verder naar een uniek resultaat. Daardoor ontstaan geen gaten in de nummering.

Geen in echte geëxporteerde metadata

Optionele groepen kiezen één variant of Geen. JENCHA Pixel voegt Geen automatisch toe; een lege layer of transparante afbeelding is niet nodig. Bij Geen verschijnt geen variant uit die groep en levert de groep in geen van beide metadataformaten een eigenschap.

Dit zijn de echte items 1 en 9 uit de Balanced-demo met 400 items. Item 1 heeft Headwear: Sport Visor. Bij item 9 ontbreekt Headwear in beide formaten; de andere eigenschappen blijven staan.

{
  "Name": "JENCHA Demo Collection #1",
  "Collection": "JENCHA Demo Collection",
  "Description": "A demo collection created with JENCHA Pixel.",
  "Website": "https://pixel.jencha.com",
  "Creator": "JENCHA",
  "Background": "Night",
  "Skin": "Rose",
  "Clothes": "Space Suit",
  "Eyes": "Sleepy",
  "Mouth": "Bubblegum",
  "Headwear": "Sport Visor",
  "Accessory": "Tech Implant"
}

{
  "Name": "JENCHA Demo Collection #9",
  "Collection": "JENCHA Demo Collection",
  "Description": "A demo collection created with JENCHA Pixel.",
  "Website": "https://pixel.jencha.com",
  "Creator": "JENCHA",
  "Background": "Violet",
  "Skin": "Mint",
  "Clothes": "Turtleneck",
  "Eyes": "Classic",
  "Mouth": "Bubblegum",
  "Accessory": "Gold Earring"
}

{
  "name": "JENCHA Demo Collection #1",
  "description": "A demo collection created with JENCHA Pixel.",
  "external_url": "https://pixel.jencha.com",
  "attributes": [
    {
      "trait_type": "Background",
      "value": "Night"
    },
    {
      "trait_type": "Skin",
      "value": "Rose"
    },
    {
      "trait_type": "Clothes",
      "value": "Space Suit"
    },
    {
      "trait_type": "Eyes",
      "value": "Sleepy"
    },
    {
      "trait_type": "Mouth",
      "value": "Bubblegum"
    },
    {
      "trait_type": "Headwear",
      "value": "Sport Visor"
    },
    {
      "trait_type": "Accessory",
      "value": "Tech Implant"
    }
  ]
}

{
  "name": "JENCHA Demo Collection #9",
  "description": "A demo collection created with JENCHA Pixel.",
  "external_url": "https://pixel.jencha.com",
  "attributes": [
    {
      "trait_type": "Background",
      "value": "Violet"
    },
    {
      "trait_type": "Skin",
      "value": "Mint"
    },
    {
      "trait_type": "Clothes",
      "value": "Turtleneck"
    },
    {
      "trait_type": "Eyes",
      "value": "Classic"
    },
    {
      "trait_type": "Mouth",
      "value": "Bubblegum"
    },
    {
      "trait_type": "Accessory",
      "value": "Gold Earring"
    }
  ]
}

De uitvoermap begrijpen

Met collectienaam JENCHA Demo Collection ziet de nieuwe collectie er zo uit:

JENCHA Demo Collection/
  Images/
    JENCHA Demo Collection-00001.png
    JENCHA Demo Collection-00002.png
  Bitcoin Inscription Metadata/
    JENCHA Demo Collection-00001.json
    JENCHA Demo Collection-00002.json
  NFT Marketplace Metadata/
    JENCHA Demo Collection-00001.json
    JENCHA Demo Collection-00002.json
  manifest.json
  source.jenchapixel
  .jencha-state/           (normaal verborgen)

Voor één item kan de metadata bijvoorbeeld zijn:

{
  "name": "JENCHA Demo Collection #1",
  "attributes": [
    { "trait_type": "Background", "value": "Blue" },
    { "trait_type": "Eyes", "value": "Normal" }
  ]
}

attributes betekent eigenschappen, trait_type is de categorie en value de gekozen variant. Ook een item zonder opgenomen traits krijgt een JSON-bestand, met een lege eigenschappenlijst. De bestandsnaam en de JSON-naam dragen hetzelfde nummer. Normaal hoef je deze tekst niet te openen of te wijzigen om een collectie te maken.

Laat manifest.json en de interne registraties ongemoeid. Verwijderen of handmatig wijzigen kan nummering, duplicaatcontrole of hervatten verstoren. Bewaar en backup de hele hoofdmap inclusief verborgen inhoud. Voor oplevering mag je Images/ en de benodigde metadatamap(pen) kopiëren, maar houd de volledige oorspronkelijke map om verder te werken. Hernoem, vervang of verwijder geen losse bestanden in een actieve collectie.

Het manifest bewaart ook de gekozen verdeling en percentages. Hervatten en uitbreiden gebruiken die opgeslagen instellingen en tellen bestaande items mee. Deze administratie beschrijft de hele collectie; ieder geëxporteerd metadata-JSON beschrijft slechts één item.

Bestaande collecties en veelvoorkomende meldingen

Legacy collecties die met images/ en metadata/ zijn gemaakt, behouden die structuur met één JSON-formaat. Oude afbeeldingen of metadata worden niet herschreven voor een tweede formaat. Start een nieuwe collectie voor dubbele metadata. De app legt dit uit bij het kiezen van een oudere collectie.

Bestaande afbeeldingen, metadata en bestandsnamen blijven ongewijzigd. Wordt een nieuwer collectieformaat niet ondersteund, bewaar dan de map intact en gebruik een passende appversie.

Ontbrekende of gewijzigde uitvoer blokkeert doorgaan. Herstel de volledige collectie uit een backup in plaats van zelf administratie te verzinnen. Bij een opslagfout: los het opslagprobleem op en selecteer opnieuw de bestaande collectiemap. Na een onderbroken schrijfactie kan heropenen de voorbereide itembestanden afmaken. Slechts één bewerking tegelijk mag naar een collectie schrijven.

Collecties van vóór de verdelingsupdate behouden hun oorspronkelijke generatiegedrag, namen en mappen. Voor nieuwe collecties is er geen Sequential-keuze. Begin een nieuwe collectie voor Evenwichtig / Balanced, Willekeurig / Random of Gewogen / Weighted. Oude bronprojecten blijven leesbaar.

Maken blijft grijs bij Gewogen? Controleer het totaal per variabele groep: iedere groep moet 100% vormen. Alleen nullen is ongeldig; Optioneel mag uitsluitend Geen op 100% gebruiken. Percentages instellen

Een eigenschap ontbreekt? Bij Geen ontbreekt de groep bewust in beide metadataformaten. Controleer Opnemen in metadata voor werkelijk gekozen varianten. Echte voorbeelden

Praktische grenzen

• Maximaal 10.000 opgeslagen items per collectie, 256 bronlayers en 64 groepen. Grote canvassen bereiken de gedeelde geheugenlimiet eerder: bij 1024 × 1024 zijn 16 layers mogelijk.
• Projecten met meer dan 64 layers vereisen deze nieuwere editor. Oude projecten blijven leesbaar; bewaar backups bij uitwisseling van grote projecten met oudere builds.
• Er wordt één item tegelijk gemaakt. Houd de doelmap beschikbaar en zorg voor voldoende schijfruimte. Herstel na procesonderbreking is getest; herstel na stroomuitval of defecte opslag is niet gegarandeerd.
• Doelpercentages zijn beschikbaar. Exacte oplagegaranties, geavanceerde traitcompatibiliteitsregels, verdelingsdashboards, een collectie-editor/herexport en minting ontbreken. Metadata-export garandeert geen compatibiliteit met iedere marktplaats.

Collecties — snel naslaan: Maken = nieuwe collectie; Hervatten = het opgeslagen doel afmaken; Uitbreiden = een voltooide collectie vergroten; Toevoegen = één handmatig gekozen item. Evenwichtig = gelijke mix. Willekeurig = toeval uit het hele bereik. Gewogen = per groep samen 100% aan doelpercentages. Optioneel Geen = geen layer en geen metadata-eigenschap. 0% sluit een gewogen keuze uit.

Collectiebestanden en zichtbare namen

Nieuwe collecties gebruiken vijf cijfers in alle drie de bestandsnamen: JENCHA Demo Collection-00001.png, JENCHA Demo Collection-00500.png tot JENCHA Demo Collection-10000.png. Beide JSON-bestanden hebben exact dezelfde stam. De zichtbare Name/name is JENCHA Demo Collection #1, JENCHA Demo Collection #500, JENCHA Demo Collection #10000. Maken, Hervatten, Uitbreiden en Toevoegen volgen dezelfde vastgelegde afspraak per collectie. Uitbreiden vanaf 500 maakt JENCHA Demo Collection-00501.png met naam JENCHA Demo Collection #501.

De bij het maken gekozen collectienaam wordt gebruikt voor de zichtbare itemnaam én het Bitcoin-veld Collection. Projectgegevens > Collectienaam is een beginvoorstel en hernoemt later geen bestaande collectie.

Oudere collecties houden hun oorspronkelijke viercijferige bestandsnamen en oorspronkelijke metadata-naamgeving, ook voor nieuw toegevoegde items. Bestaande bestanden worden nooit hernoemd of herschreven om namen te moderniseren. Begin een nieuwe collectie voor de nieuwe naamgeving. Eerdere collecties met dubbele metadata houden eveneens vier cijfers; dubbele metadata alleen zegt dus niet welke naamgeving geldt.

Bitcoin-velden worden in deze leesbare volgorde geschreven: Name, Collection, Description, Website, eigen Projectgegevens, daarna traits in groepsvolgorde. Lege optionele velden ontbreken. Marketplace gebruikt name, description, external_url, attributes; geen eigen velden of Collection. Groeps- en layertekst blijft letterlijk: cap_blue wordt niet “Cap Blue”.

Website is optioneel. Vul een volledig https://- of http://-adres in, bijvoorbeeld https://pixel.jencha.com. De app voegt niets toe en herschrijft het adres niet. Bij Projectgegevens bewaren of nieuwe JSON exporteren wordt ongeldige invoer gemeld. Oude projecten blijven met hun oude waarden openen zodat je die kunt corrigeren. Bestaande legacy collecties behouden hun vastgelegde exportgegevens. Een beschrijving met meerdere regels blijft behouden; JSON schrijft een regeleinde als \n en geeft bij opnieuw lezen dezelfde tekst terug.