Changes between Version 8 and Version 9 of Nl:DevelopersGuide/DefaultPresets


Ignore:
Timestamp:
2026-10-25T12:09:31+01:00 (10 days ago)
Author:
DiGro
Comment:

Small adjustments

Legend:

Unmodified
Added
Removed
Modified
  • Nl:DevelopersGuide/DefaultPresets

    v8 v9  
    1 [[TranslatedPages(revision=65)]]
     1[[TranslatedPages(revision=67)]]
    22[[PageOutline(2-10, Inhoud)]]
    33= Richtlijnen voor standaardvoorkeuzen =
    … …  
    2525
    2626== Nieuwe pictogrammen ==
    27 * De bestandsindeling moet **SVG** zijn voor verliesloos op schaal brengen. (Technisch gezien wordt PNG ook ondersteund, maar vanaf augustus 2016 zijn alle pictogrammen voor voorkeuzen
    28 * De basisgrootte van SVG zou 16px of groter dan 64px moeten zijn. Afbeeldingen met een basisgrootte tussen 16 en 64 px zullen niet worden geschaald naar 16 px.
     27* De bestandsindeling moet **SVG** zijn voor verliesloos op schaal brengen. (Technisch gezien wordt PNG ook ondersteund, maar vanaf augustus 2016 zijn alle pictogrammen voor voorkeuzen SVG)
     28* Het pictogram moet te **identificeren zijn op een grootte van 16 pixels**. Dit is de standaardgrootte waarop de pictogrammen worden weergegeven in de [wikitr:/Help/MapView kaartweergave] op standaard dpi (niet hidpi) schermen.
     29* De **licentie** moet compatibel zijn met GPL3 (zoals PD of CC0). Een goede bron voor pictogrammen is [https://openclipart.org openclipart.org] (alle pictogrammen daar zijn PD), [https://publicdomainvectors.org/ publicdomainvectors.org] (alle pictogrammen CC0), [https://freesvg.org/ freesvg.org] (alle pictogrammen CC0) of [http://osm-icons.org/wiki/Icons osm-icons.org] (veel zijn CC0). U kunt ook controleren of JOSM al een passend niet-gebruikt pictogram heeft in een van zijn mappen voor pictogrammen: [source:josm/trunk/resources/images gebruikte pictogrammen] en [source:josm/trunk/nodist/images niet-gebruikte pictogrammen].
     30* Als de tag van toepassing is op knopen, zouden, indien mogelijk, het pictogram in de kaartweergave en het pictogram van de voorkeuze hetzelfde moeten zijn. (Dit is niet mogelijk als verschillende objecten dezelfde voorkeuze gebruiken, bijv. `crossing=island` en `crossing=traffic_signals` hebben verschillende pictogrammen, maar worden in één voorkeuze afgehandeld "Pedestrian Crossing".)
     31* Pictogrammen met een transparante achtergrond moeten **niet alleen zwart of alleen wit zijn**. Anders zouden, als men een witte of zwarte achtergrond (geen luchtfoto als achtergrond) gebruikt in de kaartweergave, zwarte of witte pictogrammen niet zichtbaar zijn. Oplossing: als u een zwart pictogram wilt gebruiken, voeg dan een witte vierkante achtergrond toe aan het pictogram in plaats van een transparante achtergrond, of beter nog: gebruik een witte halo. \\
     32 Voorbeeld: [[Image(BlackWhiteIcon.png,middle,link=)]] Gekleurde pictogrammen hebben echter de voorkeur.
     33* Het pictogram zou zo min mogelijk moeten bedekken in de kaartweergave, dus gekleurde pictogrammen met een transparante achtergrond hebben de voorkeur boven zwart/witte pictogrammen met een vierkante achtergrond.
     34* Het pictogram zou in alle landen moeten worden begrepen.
     35* Elke voorkeuze zou zijn eigen pictogram moeten hebben en geen bestaand pictogram moeten lenen uit een andere voorkeuze, zodat u de tag herkent door het zien van het pictogram in de kaartweergave.
     36* Testen van uw pictogram tegen deze vereisten in de JOSM-kaarttekenstijl [wikitr:/Styles/IconTester Icon tester] helpt u.
     37
     38=== Mogelijke problemen met SVG in JOSM ===
     39Controleer of het SVG-bestand correct werkt in JOSM.
     40
     41* De basisgrootte van SVG zou 16 px of groter dan 64 px moeten zijn. Afbeeldingen met een basisgrootte tussen 16 en 64 px zullen niet worden geschaald naar 16 px.
    2942* Er zijn enkele bibliotheken van SVG die niet met JOSM werken (de afbeeldingen worden vervormd). Als u een dergelijk bestand hebt, probeer dan de volgende werkwijze: maak een nieuw SVG-document met Inkscape, kopieer de gegevens van de SVG naar dit nieuwe bestand, pas de pagina aan de grootte van de gegevens aan en sla het document op.
    30 * Maak de grootte van uw pictogram aan naar 16 px of een meervoudige waarde integer daarvan (niet iets als 458,1534) om het weergeven van onnauwkeurigheden wegens fouten met afronden in Java te vermijden.
     43* Maak de grootte van uw pictogram aan naar 16 px of een waarde integer van een veelvoud daarvan (niet iets als 458,1534) om het weergeven van onnauwkeurigheden wegens fouten met afronden in Java te vermijden.
    3144* Controleer de code van het bestand in een tekstbewerker. Zoek naar de waarde **viewBox** aan het begin van het bestand. Als het pictogram, bijvoorbeeld, 16x16 pixels is, en u heeft het in Inkscape gemaakt (dit gebeurt tenminste in de versie 0.91) en in de Document Properties hebt gedefinieerd 16,00000 bij 16,00000 pixels, zult u in de bestandscode waarschijnlijk deze waarden vinden: **viewBox="0 0 16.000002 16.000001"**. Wijzig die naar **viewBox="0 0 16 16"**, anders kunnen er problemen optreden.
    3245* Pictogrammen van SVG worden automatisch opgeschoond om de bestandsgrootte in de build van JOSM te verkleinen. Er is dus geen noodzaak om die stap handmatig uit te voeren voordat de SVG-bestanden worden geüpload naar SVN. Bekijk comment:35:ticket:10479, comment:10:ticket:10877 en ticket:12201#comment:21 Uncleaned SVGs are better for further editing.
    … …  
    3649* Gebruik, indien mogelijk, helemaal geen tekstelementen, omdat dat kan leiden tot verschillende resultaten bij weergeven, gebaseerd op bijvoorbeeld besturingssysteem of geïnstalleerde lettertypen. U kunt tekst transformeren naar paden in de SVG om dit te vermijden.
    3750* JOSM zou uitzonderingen kunnen opwerpen bij het verwerken van beschadigde of ongeldige SVG-bestanden. Deze afbeeldingen zijn beschadigd, maar zouden daarentegen toch weergegeven kunnen worden in andere programma's. Niet-ondersteunde mogelijkheden zouden kunnen worden genegeerd of zouden ook uitzonderingen kunnen opwerpen.)
    38 * Het pictogram moet te **identificeren zijn op een grootte van 16 pixels**. Dit is de standaardgrootte waarop de pictogrammen worden weergegeven in de [wikitr:/Help/MapView kaartweergave] op standaard dpi (niet hidpi) schermen.
    39 * De **licentie** moet compatibel zijn met GPL3 (zoals PD of CC0). Een goede bron voor pictogrammen is [https://openclipart.org openclipart.org] (alle pictogrammen daar zijn PD), [https://publicdomainvectors.org/ publicdomainvectors.org] (alle pictogrammen CC0), [https://freesvg.org/ freesvg.org] (alle pictogrammen CC0) of [http://osm-icons.org/wiki/Icons osm-icons.org] (veel zijn CC0). U kunt ook controleren of JOSM al een passend niet gebruikt pictogram heeft in één van zijn mappen voor pictogrammen: [source:josm/trunk/resources/images gebruikte pictogrammen] en [source:josm/trunk/nodist/images niet-gebruikte pictogrammen].
    40 * Als de tag van toepassing is op knopen, zouden, indien mogelijk, het pictogram in de kaartweergave en het pictogram van de voorkeuze hetzelfde moeten zijn. (Dit is niet mogelijk als verschillende objecten dezelfde voorkeuze gebruiken, bijv. `crossing=island` en `crossing=traffic_signals` hebben verschillende pictogrammen, maar worden in één voorkeuze afgehandeld "Pedestrian Crossing".)
    41 * Pictogrammen met een transparante achtergrond moeten **niet alleen zwart of alleen wit zijn**. Anders zouden, als men een witte of zwarte achtergrond (geen luchtfoto als achtergrond) gebruikt in de kaartweergave, zwarte of witte pictogrammen niet zichtbaar zijn. Oplossing: als u een zwart pictogram wilt gebruiken, voeg dan een witte vierkante achtergrond toe aan het pictogram in plaats van een transparante achtergrond of beter nog: gebruik een witte halo. \\
    42  Voorbeeld: [[Image(BlackWhiteIcon.png,middle,link=)]] Gekleurde pictogrammen hebben echter de voorkeur.
    43 * Het pictogram zou zo min mogelijk moeten bedekken in de kaartweergave, dus gekleurde pictogrammen met een transparante achtergrond hebben de voorkeur boven zwart/witte pictogrammen met een vierkante achtergrond.
    44 * Het pictogram zou in alle landen moeten worden begrepen.
    45 * Elke voorkeuze zou zijn eigen pictogram moeten hebben en geen bestaand pictogram moeten lenen uit een andere voorkeuze, zodat u de tag herkent door het zien van het pictogram in de kaartweergave.
    46 * Testen van uw pictogram tegen deze vereisten in de JOSM kaarttekenstijl [wikitr:/Styles/IconTester Icon tester] helpt u.
    47 
    48 === Mogelijke problemen met svg in JOSM ===
    49 Controleer of het svg-bestand correct werkt in JOSM.
    50 
    51 * De basisgrootte van svg zou 16px of groter dan 64px moeten zijn. Afbeeldingen met een basisgrootte tussen 16 en 64 px zullen niet worden verkleind naar 16px.
    52 * Er zijn enkele bibliotheken voor svg die niet werken met JOSM (de afbeeldingen worden vervormd). Als u een dergelijk bestand heeft, probeer dan de volgende oplossing: maak een nieuw document svg met Inkscape, kopieer de svg-gegevens naar dit nieuwe bestand, breng de pagina op grootte voor de gegevens en sla het op.
    53 * Breng uw pictogram op de grootte van 16px of een integer veelvoud daarvan (niet iets als 458.1534) om onnauwkeurigheden bij het weergeven vanwege afrondingsfouten binnen Java te vermijden.
    54 * Controleer de code van het bestand in een tekstbewerker. Zoek naar de waarde **viewBox** in het begin van het bestand. Als het pictogram, bijvoorbeeld, in 16x16 pixels is, en als u het in Inkscape hebt gemaakt (dit gebeurt althans in de versie 0.91) en is gedefinieerd in Document Properties 16,00000 x 16,00000 pixels, heeft u waarschijnlijk in de bestandscode deze waarden: **viewBox="0 0 16.000002 16.000001"**. Wijzig deze naar **viewBox="0 0 16 16"** of u zult problemen ondervinden (bekijk #12201)
    55 * SVG-pictogrammen worden automatisch opgeschoond in de gebouwde JOSM om de bestandsgrootte te verkleinen. Er is dus geen noodzaak om deze stap handmatig uit te voeren voordat de SVG-bestanden worden geüpload naar svn. Bekijk comment:35:ticket:10479, comment:10:ticket:10877 en ticket:12201#comment:21 Niet opgeschoonde svg's zijn later beter te bewerken.
    56 * Echter, vanwege in probleem in svgcleaner, zou de code voor de svg geen argumenten moeten bevatten die beginnen met speciale tekens in stijlcodes, bijv. `-inkscape-font-specification:Sans;`. Dit kan leiden tot kleurwijzigingen (bekijk #13158).
    57 * Als het pictogram kleurverlopen bevat, moet de verschuiving op elke stap worden vergroot, d.i. twee stappen met dezelfde verschuiving zijn niet toegestaan, bekijk [https://github.com/blackears/svgSalamander/pull/4 svg salamander].
    58 * CSS-stijl (`<style type="text/css">`) worden nog niet door svgSalamander ondersteund.
    59 * Gebruik, indien mogelijk, in het geheel geen tekstelementen, omdat dat kan leiden to verschillende resultaten in de weergave, gebaseerd op bijv. besturingssysteem of geïnstalleerde lettertypen. U kunt, om dit te vermijden, text transformeren naar paden in de svg.
    60 * Sommige van de benoemde problemen kunnen worden gedetecteerd door dit [source:/josm/trunk/scripts/geticons.pl script] uit te voeren.
    6151
    6252== Zie ook ==