Medien & Zeichnungen

Die Arten von Assets

Fünf Arten, eine Form. GET /v1/firearms/{id}/media listet alles, was eine Waffe hat, als ein Array, jedes Element mit seinem kind markiert, und /media/{selector} holt eines über diese Art ohne vorherige Abfrage.

Silhouetten

2,589 Waffen haben eine Strichzeichnung. Diese vier sind genau die Dateien, die die Website rendert, aus dem Bundle dieser Seite geladen; im dunklen Design werden sie invertiert, wie die Website es tut.

• ak-47
• barrett-m82a1
• glock-17-gen5
• remington-870

Alle 2,589 Silhouetten in der Galerie

1. 1Ein Referenzfoto wird normalisiert: abgeflacht, nach sRGB konvertiert, skaliert. Fotos, die die Moderation nicht passieren, fallen auf eine reine Textgenerierung zurück und werden so markiert.
2. 2Ein Bildmodell zeichnet kräftige schwarze Strichgrafik nur des Motivs, ohne Hintergrund. Eine Anfrage nach einer gefüllten Silhouette ergibt einen Klumpen; die Pipeline fragt nach Strichgrafik und füllt danach.
3. 3Das Ergebnis wird in einem Durchgang bereinigt: Hintergrund transparent, enger Beschnitt, Antialiasing-Saum auf Alpha abgebildet, damit auf einer dunklen Seite kein heller Rand bleibt.
4. 4Die Bitmap wird mit VTracer ohne Verdickung in Vektorpfade nachgezeichnet, damit Linien ihre gezeichnete Stärke behalten. Das Ergebnis ist ein gefülltes SVG, keine Konturlinie.
5. 5Die Datei wird als svgLineArtUrl am Datensatz vermerkt, auf das Asset-CDN geladen und über die API mit der gewünschten Strichfarbe und -breite ausgeliefert.

Auf der Website wird dieselbe Datei verschleiert ausgeliefert und clientseitig dekodiert; deshalb erhält ein API-Aufrufer stattdessen eine absolute CDN-URL. Ein Pfad, den kein Konsument abrufen konnte,, war eine Weile so dokumentiert, als ginge es. Das Feld steht in der Feldreferenz.

Patronenillustrationen

Eine Patrone wird nie aus ihrem Namen gezeichnet, sondern aus bis zu 16 Feldern des Kaliberdatensatzes: Rand-, Boden-, Schulter- und Halsdurchmesser, Hülsen- und Gesamtlänge, Geschosslänge und -durchmesser, Bodentyp, Hülsenform, Material, Projektilart, Geschossprofil, Verschluss und Markierungsfarbe. Die sechs unten zeichnet der gemeinsame Renderer auf dieser Seite aus dem Datensatz, wie er ist.

• 9x19mm Parabellum14 von 16 Zeichenfeldern im Datensatz95 % KonfidenzBodenrimlessHülsetaperedProjektilbulletProfilround_noseVerschlussbullet
• .45 ACP14 von 16 Zeichenfeldern im Datensatz95 % KonfidenzBodenrimlessHülsestraightProjektilbulletProfilround_noseVerschlussbullet
• .223 Remington15 von 16 Zeichenfeldern im Datensatz95 % KonfidenzBodenrimlessHülsebottleneckProjektilbulletProfilspitzerVerschlussbullet
• 7.62x39mm15 von 16 Zeichenfeldern im Datensatz95 % KonfidenzBodenrimlessHülsebottleneckProjektilbulletProfilspitzerVerschlussbullet
• 12 Gauge12 von 16 Zeichenfeldern im Datensatz70 % KonfidenzBodenrimmedHülsestraightProjektilshotVerschlussfold_crimp
• .50 BMG15 von 16 Zeichenfeldern im Datensatz90 % KonfidenzBodenrimlessHülsebottleneckProjektilbulletProfilspitzerVerschlussbullet

1. 1resolveCartridgeGeometry macht aus dem Datensatz zeichenbare Millimeter. Jede vorhandene Zahl wird unverändert genutzt; eine fehlende wird Feld für Feld aus Verhältnisheuristiken ergänzt, und die Geometrie sagt, welche geraten wurden.
2. 2Die Hülsenkontur entsteht aus Bodentyp und Hülsenform, das Projektil aus Profil und Art, dann Crimps, Pfropfen oder Schrot aus dem Verschluss. projectile_kind: none ist eine Platzpatrone und wird als solche gezeichnet.
3. 3Materialien werden zu Verläufen: Messing ist Messing, lackierter Stahl ist lackierter Stahl, eine Papierhülse ist Papier. Die Markierungsfarbe wird dort aufgetragen, wo der Datensatz sie verortet.
4. 4Beide Renderer, die Inline-Glyphe und das Maßdiagramm, zeichnen aus derselben Geometrie, sodass ein Kaliber auf zwei Seiten nicht unterschiedlich aussehen kann.

Die geschlossenen Vokabulare, aus denen eine Patrone gezeichnet wird

caseShapeCase profile: straight, bottleneck, tapered, belted.

straight, tapered, bottleneck, none

caseMaterialWhat the case is made of: brass, steel, aluminium, polymer.

brass, nickel_brass, steel, lacquered_steel, aluminium, polymer, paper, caseless, none

projectileKindnone is a blank.

bullet, none, shot, slug, round_ball, flechette, dart, pellet, rocket, grenade, signal

bulletProfileBullet shape: fmj, hollow_point, soft_point, spitzer, round_nose.

spitzer, spitzer_boat_tail, round_nose, flat_nose, wadcutter, semi_wadcutter, hollow_point, truncated_cone, round_ball

closureWhat seals the case mouth; a blank is a star crimp.

bullet, star_crimp, rosette_crimp, roll_crimp, fold_crimp, wad, paper, none

markingColorPaint that identifies the load: crimp lacquer on a blank, tip colour on a military round.

black, white, red, orange, yellow, green, blue, purple, pink, brown, grey, silver, gold

Die Zahlen stammen aus der veröffentlichten Zeichnung des Herstellers oder eines Normungsgremiums und tragen wie jeder Datensatz eine Konfidenzbewertung. Jede Patrone steht mit all diesen Feldern in der Kaliberreferenz.

Geschossdiagramme

Der bullet_type einer Laborierung wird in eines von 8 Profilen eingeordnet und als seitlicher Querschnitt gezeichnet, skaliert auf den Geschossdurchmesser des Kalibers. Die API rendert es auf Anfrage unter /v1/ammunition/{id}/bullet.svg; die Reihen unten sind die Ausgabe dieses Renderers für jedes Profil bei zwei Durchmessern.

1# Public: no key needed2curl https://api.gunspec.io/v1/ammunition/m882/bullet.svg3 4# Or straight into an img tag5<img src="https://api.gunspec.io/v1/ammunition/m882/bullet.svg" alt="M882 Ball, side profile">

Gewehrdurchmesser bekommen einen längeren Körper und eine spitzere Ogive als Pistolendurchmesser, sodass dasselbe Profil über Kaliber hinweg richtig liest. Der Endpunkt braucht keinen Schlüssel. Jede Laborierung in der Munitionsreferenz trägt ihre Diagramm-URL als bulletSvgUrl.

Fotos, Schemata und Modelle

Die Assets, die wir hosten oder verlinken statt zeichnen. Jedes kommt mit der Quellenangabe, die es für die Weiterverwendung braucht.

• Fotos und Renderings werden von GET /v1/firearms/media indexiert, eine dreispaltige Zeile pro Waffe für Medienraster und Spiegel, mit einem Fingerabdruck, der sich ändert, wenn Bilder hinzukommen oder wegfallen.
• Schemata sind Explosions- und technische Zeichnungen aus Hersteller- und Archivmaterial, ab Studio; die Zugriffsmatrix hat die vollständige Freischaltung.
• 3D-Modelle sind glTF-Binärdateien mit meshopt-Kompression, WebP-Texturen und quantisierten Meshes. Ein Loader braucht diese drei Standarderweiterungen und sonst nichts.
• Assets, die wir verlinken statt hosten, antworten mit einem 302 auf ihren Ort; Assets in unserem eigenen Bucket streamen vom Endpunkt. In beiden Fällen ist url eines Medienelements absolut und abrufbar.

Medien abrufen

Eine Ressource für alles, plus die älteren Routen pro Art, die bestehen bleiben. Die Adressierung über die Art braucht keine vorherige Abfrage; format=json liefert die Metadaten ohne Bytes, format=datauri bettet bis zu 256 KB ein.

1# Everything a firearm has, one shape, with a credit block per item2curl -H "X-API-Key: your_api_key" \3  https://api.gunspec.io/v1/firearms/ak-47/media4 5# The silhouette as SVG, stroke recoloured, no prior lookup6curl -H "X-API-Key: your_api_key" \7  "https://api.gunspec.io/v1/firearms/ak-47/media/silhouette?stroke_color=%23ffffff"8 9# Just the metadata, no bytes10curl -H "X-API-Key: your_api_key" \11  "https://api.gunspec.io/v1/firearms/ak-47/media/photo?format=json"

Jede Medienantwort trägt ein ETag und antwortet mit 304, wenn unverändert, sodass ein Spiegel nichts erneut lädt, was sich nicht bewegt hat; siehe Caching. Gewinnt oder verliert eine Waffe ein Asset, feuert firearm.updated an Webhook-Abonnenten.

Weiterverwendung und Sicherheit

Jedes Medienelement trägt die nötige Quellenangabe, und jedes SVG, das die API ausliefert, ist in einer Sandbox, bevor es einen Browser erreicht.

Der Credit-Block an jedem Element

credit.source

Where the record came from: a curated entry, an inference, or an import.

credit.author

Who made the asset, where it is credited.

credit.sourceUrl

Page the asset or document was taken from.

credit.license

Licence the asset is held under, where one is recorded.

Wie SVGs ausgeliefert werden

Ein SVG kann Skript enthalten. Jedes, das die API ausliefert, darunter Silhouetten, Geschosszeichnungen und Medien, wird mit einer Content-Security-Policy gesendet, die beim direkten Öffnen jede Ausführung verhindert, und Farbwerte, die in eine Silhouette geschrieben werden, werden validiert und maskiert. Die Richtlinie, von der Seite Datenschutzmaßnahmen:

default-src

'none'

style-src

'unsafe-inline'

img-src

data:

sandbox

Pressekit und das ZertifizierungssiegelMedienfelder in der Feldreferenz