Metadane zdjęć sferycznych XMP

Opisana tutaj przestrzeń nazw panoramy zawiera właściwości, które zapewniają informacje na temat tworzenia i renderowania zdjęć sferycznych, a także i czasami nazywane panoramami, utworzone za pomocą funkcji Photo Sphere w aparacie z Androidem 4.2. powinny zostać zserializowane i umieszczone wewnątrz zdjęcia sferycznego jako opisane przez Adobe XMP. (patrz źródła informacji na końcu tej strony).

Identyfikator URI przestrzeni nazw to http://ns.google.com/photos/1.0/panorama/

Właściwości metadanych

Na diagramach i w tabeli poniżej przedstawiono właściwości zdjęć sferycznych zawarte w obrazach sferycznych Parametry GPano. Podczas edytowania i wyświetlania zdjęć sferycznych odpowiednio zweryfikować i zaktualizować metadane, co opisano w dalszej części tego dokumentu. Określając pola pozycji i początkowego nagłówka, pamiętaj o przestrzeganiu konwencje kątów Eulera omówione w dalszej części artykułu ten dokument.

Pamiętaj, że usługi Google obsługują tylko rzutowanie sferyczne. Dodatkowe prognozy są obecnie obsługiwane tylko przez inne podmioty.

Odwzorowania sferyczne

Odwzorowanie walcowe walcowe

Pamiętaj, że jeśli góra obrazu walcowego znajduje się powyżej horyzontu, Wartość CroppedAreaTopPixels musi być ujemna. Wartość 0 w przypadku CroppedAreaTopPixels spowoduje umieszczenie obrazu na horyzoncie. Wartość dodatnia Skrót CroppedAreaTopPixels umieszcza górną część zdjęcia poniżej horyzontu.

Odniesienie do parametrów GPano

Przykład pełnego zdjęcia sferycznego

Osoby niebędące programistami mogą dodać do swojego pełnego zdjęcia widoczne poniżej metadane (360° x 180 stopni) z niewielkimi zmianami. Można to zrobić w programach do edycji obrazów, takich jak Adobe Photoshop.

1. zmień wszystkie wystąpienia 4000 i 2000, aby dopasować je do odpowiedniej szerokości i wysokości obrazu w pikselach
2. zaktualizuj PoseHeadingDegrads, jeśli chcesz, by Mapy Google mogły wyświetlać Twoje zdjęcie sferyczne; w przeciwnym razie możesz opcjonalnie usunąć ten parametr,
3. zaktualizowanie lub usunięcie parametrów opcjonalnych (jak opisano powyżej)

<rdf:Description rdf:about="" xmlns:GPano="http://ns.google.com/photos/1.0/panorama/">
    <GPano:UsePanoramaViewer>True</GPano:UsePanoramaViewer>
    <GPano:CaptureSoftware>Photo Sphere</GPano:CaptureSoftware>
    <GPano:StitchingSoftware>Photo Sphere</GPano:StitchingSoftware>
    <GPano:ProjectionType>equirectangular</GPano:ProjectionType>
    <GPano:PoseHeadingDegrees>350.0</GPano:PoseHeadingDegrees>
    <GPano:InitialViewHeadingDegrees>90.0</GPano:InitialViewHeadingDegrees>
    <GPano:InitialViewPitchDegrees>0.0</GPano:InitialViewPitchDegrees>
    <GPano:InitialViewRollDegrees>0.0</GPano:InitialViewRollDegrees>
    <GPano:InitialHorizontalFOVDegrees>75.0</GPano:InitialHorizontalFOVDegrees>
    <GPano:CroppedAreaLeftPixels>0</GPano:CroppedAreaLeftPixels>
    <GPano:CroppedAreaTopPixels>0</GPano:CroppedAreaTopPixels>
    <GPano:CroppedAreaImageWidthPixels>4000</GPano:CroppedAreaImageWidthPixels>
    <GPano:CroppedAreaImageHeightPixels>2000</GPano:CroppedAreaImageHeightPixels>
    <GPano:FullPanoWidthPixels>4000</GPano:FullPanoWidthPixels>
    <GPano:FullPanoHeightPixels>2000</GPano:FullPanoHeightPixels>
    <GPano:FirstPhotoDate>2012-11-07T21:03:13.465Z</GPano:FirstPhotoDate>
    <GPano:LastPhotoDate>2012-11-07T21:04:10.897Z</GPano:LastPhotoDate>
    <GPano:SourcePhotosCount>50</GPano:SourcePhotosCount>
    <GPano:ExposureLockUsed>False</GPano:ExposureLockUsed>
</rdf:Description>

Przykład częściowego zdjęcia sferycznego

<rdf:Description rdf:about="" xmlns:GPano="http://ns.google.com/photos/1.0/panorama/">
    <GPano:UsePanoramaViewer>True</GPano:UsePanoramaViewer>
    <GPano:CaptureSoftware>Photo Sphere</GPano:CaptureSoftware>
    <GPano:StitchingSoftware>Photo Sphere</GPano:StitchingSoftware>
    <GPano:ProjectionType>equirectangular</GPano:ProjectionType>
    <GPano:PoseHeadingDegrees>350.0</GPano:PoseHeadingDegrees>
    <GPano:InitialViewHeadingDegrees>90.0</GPano:InitialViewHeadingDegrees>
    <GPano:InitialViewPitchDegrees>0.0</GPano:InitialViewPitchDegrees>
    <GPano:InitialViewRollDegrees>0.0</GPano:InitialViewRollDegrees>
    <GPano:InitialHorizontalFOVDegrees>75.0</GPano:InitialHorizontalFOVDegrees>
    <GPano:CroppedAreaLeftPixels>90</GPano:CroppedAreaLeftPixels>
    <GPano:CroppedAreaTopPixels>128</GPano:CroppedAreaTopPixels>
    <GPano:CroppedAreaImageWidthPixels>2300</GPano:CroppedAreaImageWidthPixels>
    <GPano:CroppedAreaImageHeightPixels>1042</GPano:CroppedAreaImageHeightPixels>
    <GPano:FullPanoWidthPixels>4000</GPano:FullPanoWidthPixels>
    <GPano:FullPanoHeightPixels>2000</GPano:FullPanoHeightPixels>
    <GPano:FirstPhotoDate>2012-11-07T21:03:13.465Z</GPano:FirstPhotoDate>
    <GPano:LastPhotoDate>2012-11-07T21:04:10.897Z</GPano:LastPhotoDate>
    <GPano:SourcePhotosCount>50</GPano:SourcePhotosCount>
    <GPano:ExposureLockUsed>False</GPano:ExposureLockUsed>
</rdf:Description>

Niezawodność edytowania obrazów

Aby wszystko działało jak najdokładniej, programy wyświetlające zdjęcia sferyczne w przeglądarce powinny oryginalne zdjęcie sferyczne zostało przeskalowane przez aplikację bez aktualizowania metadanych. Aby to zrobić:

1. upewnij się, że tag CroppedAreaImageWidthPixels jest równa rzeczywistej szerokości obrazu
2. upewnij się, że tag CroppedAreaImageHeightPixels jest równy rzeczywistej wysokości obrazu;
3. jeśli krok 1 lub 2 nie powiedzie się, sprawdź, czy format obrazu został zachowany
4. Jeśli krok 3 nie powiedzie się, nie wyświetlaj zdjęcia jako zdjęcia sferycznego, ponieważ zostało ono przekształcone w niekompatybilny sposób, co spowoduje pojawienie się
5. jeśli krok 3 zostanie zaliczony, współczynnik proporcji będzie równoważny i wszystkie następujące powiązane wartości tagów należy przeskalować, aby pasowały do nowego rozmiaru obrazu:
   CroppedAreaImageWidthPixels, CroppedAreaImageHeightPixels, FullPanoWidthPixels, FullPanoHeightPixels, CroppedAreaLeftPixels, CroppedAreaRightPixels.

Omówienie kątów Eulera

Orientację zdjęcia sferycznego w ramce świata jest określana przez Eulera pod kątem różnych kątów. Kąty Eulera można zdefiniować na wiele sposobów. Aby mieć pewność, że program jest słuszny, zgodnie z podanymi tutaj konwencjami kątów Eulera.

Położenie nad powierzchnią Ziemi określa stały „lokalny”, ramki” XYZ, gdzie Z jest w górę i ortogonalne do powierzchni Ziemi, X to prawdziwy wschód, a Y to północ, Orientacja jest zdefiniowana w odniesieniu do tego stała „lokalna klatka”, a kąty Eulera to obroty wokół tych o stałej osi XYZ. Orientacja pozycji jest więc nieokreślona na biegunach. Ten oznacza, że zdjęcie sferyczne o kątach (0, 0, 0) zostanie zorientowane w taki sposób, środkowe płaszczyzny piksela skierowane na północ do równika zdjęcia sferycznego, równolegle do na powierzchni Ziemi.

Kąty Eulera umożliwiają przyporządkowanie punktów na (obróconym) „zdjęciu” ramki sferycznej" do punktów w (stałej) „ramce lokalnej”:
 
Macierz obrotu jest zbudowana z kątów Eulera jako następujące (ważne jest zachowanie tej kolejności):

R = R_Z(-nagłówek) * R_X(pitch) * R_Y(rola)

gdzie: R_*(t) oznacza obrót praworęczny wokół nazwanej osi:

gdzie: Z = wyżej, X = wschód, Y = północ.

Ważne jest zachowanie tej kolejności:

R = R_Z(-nagłówek) * R_X(pitch) * R_Y(rola)

, bo rotacje nie są przemienne.

Pamiętaj, że kąt nagłówka jest taki sam jak w przypadku standardowego nagłówka kompasu.

Pliki referencyjne

Adobe XMP Standard: http://www.adobe.com/devnet/xmp.html