Developers kit (API)

De Picario visualisatiemotor kan gebruikt worden als middel voor het ontwikkelen van je eigen tools door gebruik te maken van de API. PicarioXPO’s Developer API stelt je in staat onze software te implementeren in je eigen website. Zo kan je je eigen configurator creëren met je eigen design en lay-out.

Als je tegen problemen aanloopt bij het bouwen van je eigen website met Picario-implementatie, zijn onze programmeurs beschikbaar om je te helpen bij technische vragen. Neem contact met ons op voor meer informatie over Picario API. De PicarioXPO API bestaat uit twee delen: de render API en de data API. De eerste gaat, zoals de naam al zegt, helemaal over het renderen van scènes met hun objecten.

Render API

Het genereren van render URL’s kan een behoorlijke klus zijn vanwege alle variabelen en verschillende opties. Daarom hebben we een SDK gecreëerd voor JavaScript en C#-gebruikers. Deze SDK bevat een Fluent-interface die je kan gebruiken om URL’s te creëren voor jouw applicatie.

Data API

De data API wordt gebruikt om alle data van XPO te verkrijgen met een eenvoudig te gebruiken API. Je kan een enkele eenheid, een lijst met eenheden, een textuur, heel veel texturen, alles verkrijgen in JSON.

Bij het bouwen van een visualisatieoplossing met onze motor staan ons supportteam en onze ontwikkelaars standby om je in het proces te begeleiden en alle mogelijke vragen te beantwoorden.

PicarioXPO Development Kit FAQ

V1: Wat is een scenebestand?

Een scenebestand (.pfs bestandsformaat) is ons Picario Face Scene bestandsformaat. Een scenebestand bevat een JPG- of PNG-afbeelding die door ons is voorbereid en gebruikt kan worden om kleuren, logo’s en meer toe te voegen. Deze scenebestanden worden ook wel master images genoemd.

V2: Wij ondervinden time-outfouten op het platform, wat is er mis?

Meestal is dit een cacheprobleem. Om de performance van je PicarioXPO-account te verbeteren, raden wij u aan een unieke SUI-id te gebruiken in elk URL-verzoek. Als je nog steeds problemen ondervindt, neem dan contact met ons op via info@picario.com.

V3: Wat is een textuur?

Verschillende dingen kunnen als texturen gebruikt worden in onze PicarioXPO. Wij hebben ons Picario Face Texture formaat (.pft) die een afbeelding bevat en ook gelijk de juiste informatie bevat over positionering, dimensies, herhaling, etc.  Je kan ook afzonderlijke afbeeldingen, zoals logo’s, als texturen gebruiken. De dimensies, positionering, herhaling en meer van afbeeldingsbestanden kunnen ingesteld worden in de URL via verschillende parameters. Onze handleiding geeft meer informatie over het gebruik van texturen.

V4: Wij moeten een erg grote fontgroottte gebruiken in sommige afbeeldingen, hoe komt dat?

De oppervlaktes in de master image zijn gedefinieerd in centimeters. Een vloer in een woonkamer kan bijvoorbeeld 400cm breed en 800 cm lang zijn. De Picario motor gebruikt deze dimensies om een realistische visualisatie te creëren gebaseerd op de dimensies in de texturen. Deze dimensies worden gebruikt om de benodigde dimensies van de tekst te berekenen. Daarom moet je een geschikte fontgrootte zoeken, afhankelijk van de aangegeven dimensies van de objecten in de master image.

V5: Kan ik mijn eigen afbeeldingen gebruiken?

Ja, natuurlijk! Wij bereiden jouw productafbeeldingen voor op ons scenebestandsformaat zodat jij oneindige variaties van de afbeeldingen kan maken met ons platform. Je betaalt alleen voor het creëren van de master images. Er zijn geen extra kosten voor het creëren van al de variaties met verschillende kleuren, texturen, logo’s en meer, die je met ons platform maakt.

V6:Als we een scene opvragen, krijgen we de volgende foutmelding: “Unexpected error: FACE Return Code Error on Function 'ReadScene': 11 - Unexpected end of file”. Wat moet ik doen?

In de meeste gevallen betekent dit dat een scenebestand (de master image) die je opvraagt corrupt is. Dit kan zich voordoen als een FTP-transfer niet de complete scene heeft geüpload. Het verzoek zou moeten werken als je het scenebestand opnieuw naar de FTP upload. Als de problemen zich blijven voordoen, kan je controleren of het scenebestand werkt in je Face Designer software of je kan het scenebestand sturen naar info@picario.com en wij zullen ernaar kijken.

V7: Welke afbeeldingsformaten worden ondersteund?

De bestandsformaten die ondersteund worden door PicarioXPO zijn JPG en PNG. Ook de output van de gevisualiseerde afbeeldingen zijn JPG (met compressie die jij kan beheersen met de kwaliteitsparameter) en PNG, afhankelijk van de geselecteerde outputparameter in de URL.

V8: Kan ik transparante PNG-afbeeldingen gebruiken als master images?

It is possible to change the output of a scene file in PicarioXPO to the PNG format. The image inside a scene file is always in the JPG format. However Picario can use the transparant alpha mask from a PNG file to create transparancy in scene files and change the output image to PNG format. Transparant PNG files can also be used as textures and to stack images using the URL request. Please see PicarioXPO manual for more information.

V9: Wat zijn de kosten van het voorbereiden van mijn productafbeeldingen naar het scenebestandsformaat?

De prijs per productafbeelding hangt af van jouw wensen en van het product zelf. Sommige producten nemen meer tijd in beslag om voor te bereiden. De voorbereiding van gordijnen is bijvoorbeeld complexer dan platte oppervlaktes als vloeren en muren. Stuur ons gerust voorbeelden van jouw productafbeeldingen zodat wij je een prijsopgave kunnen geven van de voorbereidingskosten.

V10: Kan ik afbeeldingen gebruiken van een andere bron, zoals een andere website?

Ja, je kan afbeeldingen van een andere website gebruiken. Voer eenvoudig de URL van de gewenste afbeelding in aan het eind van de parameters voor het bepaalde object in de scene, bijvoorbeeld “&tn1=http://www.yourimages.com/image1.jpg”.

V11: Kan ik de scenebestanden niet zelf voorbereiden?

Het is mogelijk om jouw eigen scenebestanden te creëren met onze FACE Creator software. Neem contact met ons op via info@picario.com voor meer informatie of voor een 30-daagse gratis proefversie.

V12: Kan ik in realtime een textuur herkleuren op het web?

Ja, het is mogelijk een textuur te herkleuren en de aangepaste textuur te gebruiken in de master image om een gevisualiseerde afbeelding te creëren. Je doet dit door twee verzoeken te gebruiken en het eerste verzoek te gebruiken als textuur in het tweede verzoek. Het eerste verzoek is bijvoorbeeld een scenebestand (master image) van een houten vloer die je in een andere kleur opvraagt. Je gebruikt dan de URL van de herkleurde vloer als textuur in de tweede master image van bijvoorbeeld een woonkamer. Je zal een gecodeerde versie van het eerste URL-verzoek nodig hebben in het tweede URL-verzoek om dit te laten werken.

V13: Is de kwaliteit van de gegenereerde afbeeldingen geschikt voor gedrukte media?

De kwaliteit van de gevisualiseerde/gegenereerde afbeeldingen hangt af van de originele kwaliteit van de afbeeldingen. Als je hoge resolutie afbeeldingen van jouw producten hebt die geschikt zijn om af te drukken, kunnen we deze voorbereiden naar ons scenebestandsformaat. Houd er rekening mee dat deze afbeeldingen niet geschikt zijn voor webgebruik vanwege de grootte van de bestanden. Als je dezelfde productafbeeldingen wil gebruiken voor je website of webshop, kunnen de scenebestanden verkleind worden naar een lagere resolutie om de online performance te versnellen.

V14: Ik heb een master image die verschillende gelinkte objecten heeft in verschillende dimensies. Als ik een webafbeelding met het URL-verzoek toevoeg aan de textuurobjecten, wordt de textuur in verschillende groottes afgebeeld en de plaatsing is niet juist.

Picario gebruikt de dimensies die bepaald zijn in zowel de textuurbestanden als de scenebestanden om het gevisualiseerde eindresultaat te creëren. Een webafbeelding heeft geen vooraf vastgestelde dimensies waardoor het resultaat kan afwijken. Om dit probleem op te lossen, moet je dezelfde afmetingen voor de objecten in de master image invoeren, ook al is de grootte in pixels verschillend. De webafbeelding zal geschaald worden om te passen bij het object, wat resulteert in een realistische visualisatie.

V15: Moet ik een plug-in installeren om Picario te integreren op mijn eigen website of webshop in bijvoorbeeld Magento?

Nee, plug-ins zijn nodig om PicarioXPO toe te voegen aan je website of webshop. Picario is een URL API die eenvoudig integreert in elke website of webshop. Het integreert alsof je een normale afbeelding zou toevoegen aan je website of webshop. Bekijk onze handleiding voor meer informatie.

V16: Q16: Mijn gevisualiseerde afbeeldingen zijn ietwat onscherp. Kan ik dit veranderen?

Ja, dat kan. Picario vermindert automatisch de outputkwaliteit voor een betere performance. Voor een betere afbeeldingskwaliteit kan je de parameter “&q=100” of “&q=90” aan je verzoek toevoegen. Het kwaliteitsverschil tussen 100 en 90 is erg klein, maar voor de performance kan dit een groot verschil maken.

V17: De opgevraagde afbeeldingen laden de eerste keer langzaam. Is er een manier om de performance te verbeteren?

Ja, er zijn meerdere oplossingen. De meest gebruikte is het veranderen van de grootte van de master images. Bijvoorbeeld, als je een webversie van jouw afbeelding gebruikt met een outputgrootte van 500x500 pixels, maar je master image heeft een grootte van 6000x6000 pixels, moet Picario eerst de originele afbeelding downloaden en de output verkleinen. Dat vergt tijd. De beste oplossing is om de ‘save scaled’-optie te gebruiken in de Face Creator software om een kleinere versie te creëren van de scene die je op het web wilt gebruiken.

V18: Wij ondervinden time-outfouten op het platform, wat is er mis?

Meestal is dit een cacheprobleem. Om de performance van je PicarioXPO-account te verbeteren, raden wij u aan een unieke SUI-id te gebruiken in elk URL-verzoek. Als je nog steeds problemen ondervindt, neem dan contact met ons op via info@picario.com.