Podpora a kontakt
- E-mail: forensika.eu@icloud.com — otázky, chyby, návrhy. Odpovedáme spravidla do niekoľkých pracovných dní.
- Pri hlásení chyby priložte protokol výpočtu (Sken → Protokol výpočtu → Kopírovať) a model zariadenia. Neposielajte snímky ani modely tiel.
Časté otázky
Aké zariadenie potrebujem?
iPhone alebo iPad s iOS 18+. LiDAR (modely Pro) je odporúčaný — dáva hĺbku ku každému snímku a model vzniká priamo v metroch. Bez LiDARu sa dá snímať tiež; mierku dodá trajektória ARKitu a kalibračný terč, overte ju etalónom.
Zariadenie nepodporuje fotogrametriu — čo teraz?
Výpočet 3D modelu potrebuje čip A17 Pro / M1 a novší (iPhone 15 Pro a novšie Pro modely, iPad s M1+). Staršie zariadenie vie snímať — aj bez LiDARu, mierku vtedy dá dráha kamery a kalibračný terč. Nasnímajte, v Exporte vyberte Model, nálezy a snímky a balík pošlite AirDropom buď na podporovaný iPhone alebo iPad, alebo na Mac s Apple Silicon do aplikácie Fotograme3ka 3D Výpočet. Tam sa model vypočíta a balík pošlete späť do telefónu, kde ho otvoríte ako nový sken. Podrobne v návode, kapitola 5.2.
Terč mám položený podľa návodu, ale aplikácia ho „nenašla“
Najčastejšia príčina nie je umiestnenie, ale vzdialenosť. QR kód sa dá prečítať, len keď má v obraze dosť pixelov: terč 40 mm má pri vzdialenosti 1,2 m asi 86 px, čo stačí iba na úplne ostrý snímok — pri chôdzi sa snímky mierne rozmazávajú a kód sa už neprečíta (overené meraním: pri rozmazaní 2 px prestane byť čitateľný, spoľahlivo funguje až od ~130 px). Riešenie: počas okruhu raz spomaľte a prejdite ponad terč z 0,5–0,8 m. Sledujte počítadlo terča na obrazovke snímania — kým ukazuje nulu, terč sa nezachytil. Od verzie 2.2.2 na to aplikácia po 40 snímkoch sama upozorní hláškou „Terč nie je v zábere“.
Kde je kalibračný terč?
Zoznam skenov → menu … → Kalibračný terč T3 na tlač (A4 na šírku, mierka 100 %, matný papier, tvrdá podložka). Posuvným meradlom zmerajte stredy kruhov A–B (247,00 mm) a hodnotu zadajte na obrazovke skenu (Overenie tlače terča). Kruhy aplikácia nájde aj z 2 m; QR sa prečíta pri prechode do ~1 m. Starší terč T3 je v menu tiež, rozpozná sa len zblízka.
Čo je certifikát 3D dokumentácie a trieda A–D?
Export → Vydať certifikát 3D dokumentácie (k hotovému modelu). Certifikát uvádza stopu snímania (dráha kamery, pokrytie, čas), overenie mierky (LiDAR, fit trajektórie, etalón, terč T3), SHA-256 modelu a nálezov, podpis kľúčom zariadenia (Pro) a QR kód na overenie. Trieda A = mierka doložená dvoma nezávislými cestami s chybou do 1 %; B = metrická bez druhého dôkazu; C = orientačná; D = neoverená. Certifikát je aj v balíku (certificate.json) a import ho overí. Metodika: PDF (SK).
Aplikácia sa počas výpočtu ukončila (E36) — telefón „vyplo“ pri 50 %
iOS ukončí aplikáciu bez varovania, keď počas výpočtu prejde do pozadia (zamknutie, iná aplikácia, hovor), keď nestačí pamäť alebo pri prehriatí. Snímky sú v poriadku. Po otvorení skenu aplikácia ukáže E36 a tlačidlo Spustiť úsporný výpočet (snímky zmenšené na 2560 px, mierku dáva LiDAR, presnosť sa prakticky nemení). Počas výpočtu nechajte aplikáciu v popredí na nabíjačke, telefón nezamykajte a zatvorte ostatné aplikácie. Podrobne v návode, kapitola 5.1.
Model je hore nohami
Fotogrametria Apple berie smer gravitácie výlučne z metadát HEIC (Apple MakerNote, tag 8); sidecar súbor _gravity.txt ignoruje. Snímky z verzií pred 2.2.1 (build 26) tento zápis nemali, preto model vychádzal otočený o 180° — na iPhone aj na Macu. Od buildu 26 sa gravitácia zapisuje priamo do snímkov; pri Prepočítať staršej relácie sa doplní automaticky. Fit trajektórie prevrátený model rozpozná a prehliadka ho otočí sama; ručne slúži prepínač ⋯ → Otočiť model hore nohami (mení len zobrazenie). Merania a mierka nie sú otočením dotknuté.
Ktorý súbor si mám archivovať pre súd alebo vyšetrovateľa?
Archívny balík so snímkami — Export → Archivovať. Je to úplný, prepočítateľný originál: snímky (surové dáta), model, celá scéna, okolie z LiDARu, nálezy, merania, certifikát, log výpočtu a SHA-256 každého súboru. Snímky sú v dôkaznom reťazci to isté, čo negatívy vo fotografii: bez nich sa model nedá nezávisle overiť, s nimi si ho ktokoľvek prepočíta. SHA-256 celého balíka je v manifeste aj v protokole, takže sa dá dokázať, čo presne odišlo do spisu. Uložte ho na dve nezávislé médiá.
Do spisu ďalej patrí protokol PDF a certifikát 3D dokumentácie. Vyšetrovateľovi alebo znalcovi, ktorý si chce model pozrieť a premerať, pošlite balík bez snímkov (desiatky MB) — nie je to však náhrada archívu. Po archivácii sa snímky dajú z telefónu zmazať, model a protokol zostanú. Samotný súbor model.usdz neposielajte ako jediný dôkaz — je to len výsledok bez manifestu, hashov a surových dát, nedá sa z neho preukázať, ako vznikol. Podrobne v návode, kapitola 11.1.
Riadok „Trajektória ARKit vs. model“ svieti oranžovo
Od verzie 3.0 je dráha kamery (LiDAR + IMU) zdrojom mierky merania: model z fotogrametrie nie je v metroch sám od seba ani s LiDARom (ten istý sken vyšiel o 6 % a o 14 % menší). Zelený riadok = mierka korigovaná z dráhy kamery s neistotou ~0,5 %; oranžový = fit nie je dosť presný (reziduál nad 25 mm alebo menej než 50 kamier) a mierka je len orientačná — doplňte terč T3 alebo etalón. Prehliadka ukazuje korekciu a pri každom meraní neistotu ± U (k = 2).
Čo sa stane s nálezmi, keď dám Prepočítať?
Každý výpočet vytvorí model vo vlastnom súradnicovom ráme, takže staré špendlíky a merania by na novom modeli sedeli inde. Od verzie 2.2.2 ich aplikácia prenesie: tie isté snímky majú v starom aj novom modeli kamery na tých istých miestach a z týchto dvojíc sa spočíta otočenie, posun a mierka nového rámu voči starému; tou istou transformáciou sa presunú špendlíky aj body meraní (chyba zvyčajne do niekoľkých milimetrov, aplikácia ju ukáže ako „odhad chyby polohy“). Hodnoty meraní sa nemenia — sú z pôvodného modelu. Pôvodný súbor ostáva v priečinku skenu ako annotations_<dátum>.json a protokol prenos uvádza. Pri starších skenoch bez uložených póz ide prenos cez dráhu kamery z ARKitu (hrubšie), a keď ani to nie je spoľahlivé, nálezy sa iba odložia a zadáte ich znova. Pôvodný model sa počas výpočtu odloží nabok — ak výpočet zrušíte alebo zlyhá, vráti sa. Certifikát vydajte nanovo, starý patril k inému modelu.
Čo znamená chybový kód (napr. E30, „error 1“)?
Každá chyba sa zobrazí s kódom E-xx, významom a nápravou; v hranatej zátvorke je systémová správa. E30 = fotogrametria nedokázala spárovať snímky (systémový kód 1): prepočítajte s citlivosťou Vysoká a rozsahom Celá scéna, potom vstup „Priečinok bez hĺbky“, inak sken zopakujte pomalšie s väčším prekrytím. E33 = málo miesta, E4x = ARKit (kamera, sledovanie), E60 = App Store. Úplná tabuľka je v návode (kapitola 14).
Dá sa vypnúť zvuk skenovania?
Áno — ikona reproduktora na obrazovke snímania alebo ⓘ → Nastavenia → Zvuk skenovania: Hlboký vesmír (predvolené, tichý hlboký tón a hvizd), Star Trek (senzorové warble) alebo Bez zvuku. Výška tónu stúpa s pokrytím, nový sektor a dokončenie majú vlastný signál.
Ako nasnímať živú osobu s terčom T2?
Osoba stojí vzpriamene na voľnom mieste (aspoň 1,5 m dookola), nohy na šírku ramien, ruky mierne od tela, hlava rovno a pohľad na pevný bod — ruky pritlačené k bokom sú najčastejšia chyba, vnútorné strany paží potom v modeli nebudú. Terč T2 položte naplocho na podlahu vedľa chodidiel, asi 20–40 cm nabok; jeden terč na sken. V aplikácii zvoľte profil Živá osoba, zamierte na hrudník a ťuknite Nastaviť stred skenu. Potom obíďte tri okruhy vo vzdialenosti 1,0–1,2 m: vo výške hlavy so sklonom nadol, vo výške hrudníka vodorovne a v podrepe s telefónom mierne nadvihnutým na nohy. Jeden okruh 15–20 sekúnd, plynulým krokom, celé pod minútu. Nikdy nesnímajte proti oknu a nezabudnite, že hladké jednofarebné oblečenie je pre fotogrametriu najhoršie — koža ide oveľa lepšie. Ak sa osoba pohla, sken zopakujte. Podrobne aj s obrázkami: kapitola 4.2 návodu.
Ako snímať?
Zamierte na stred subjektu, potvrďte a pomaly ho obchádzajte — snímky sa spúšťajú samy. Radar vpravo hore ukazuje pokrytie. Telo: difúzne svetlo, bez blesku. Predmet: matný kontrastný podklad, obísť v troch výškach.
Výpočet trvá dlho / telefón sa zahrieva
Rekonštrukcia beží výhradne v telefóne a je náročná — rádovo minúty. Obrazovka zostáva zapnutá (stlmená), nechajte telefón na nabíjačke. Po dokončení príde notifikácia.
Nevidím model
Sken → Diagnostika → Otvoriť v systémovom prehliadači. Ak model existuje, systémový prehliadač ho zobrazí vždy. Ak nie, pošlite protokol výpočtu.
Čo znamená „± 1,8 mm (k = 2)“ pri meraní?
Rozšírená neistota U podľa GUM: s pravdepodobnosťou ≈ 95 % je skutočná hodnota v intervale ± U. Skladá sa z neistoty mierky modelu (dráha kamery, terč T3) a z neistoty polohy zadaných bodov (prst ≈ 1,7 mm, Apple Pencil 0,5 mm, myš na Macu 0,2 mm, plus rozlíšenie snímok). Najmenšie U dosiahnete detailným skenom nálezu, lupou (podržať a ťahať) alebo Pencilom, terčom T3 v zábere a výpočtom na Macu. Do zápisu uvádzajte hodnotu s U.
Ako merať?
V prehliadke (režim Merať) ťuknite na dva body na povrchu — vzdialenosť; Dráha sa sčítava po povrchu (dĺžka rany, obvod), Plocha z bodov po obvode. Dĺžka tela: temeno a päta. Vzdialenosť tela od predmetu: rozsah rekonštrukcie Subjekt s okolím alebo Celá scéna. Etalón: zmerajte škálu terča a zadajte 100 mm.
Kde sú exporty?
Súbory → Na mojom iPhone → aPrehliadky → Exporty (balík, protokol PDF, USDZ). Archív má vlastný podpriečinok.
Ako označovať nálezy?
V prehliadke prepnite dolný panel na Označiť nález, vyberte typ (poranenie, znak, škvrna, odber, iné) a ťukajte na povrch — každé ťuknutie pridá očíslovaný špendlík. Názov a popis doplníte ťuknutím na špendlík; „Späť“ zruší posledný. V režime Merať ťuknutia pridávajú body merania.
Čo je Okolie z LiDARu?
S LiDARom aplikácia počas snímania ukladá aj mesh miestnosti z ARKitu (podlaha, steny, strop, stôl, dvere) ako druhý, metrický model bez textúry. Otvoríte ho v skene pod Okolie z LiDARu; má vlastné nálezy a merania. Ak chcete celú miestnosť, po obídení subjektu pomaly prejdite kamerou po stenách a podlahe.
Ako zmením jednotky?
ⓘ → Nastavenia → Jednotky merania: mm, cm, dm, m, palce, stopy. Prepočet je presný; v balíku a v protokole sú hodnoty vždy uložené v mm.
Funguje aj na Macu?
Áno, dvoma spôsobmi. aPrehliadky na Macu s Apple Silicon (App Store → Mac, aplikácia „Designed for iPad“) slúžia na prehliadku, meranie, nálezy a protokol: balík .f3d alebo starší .aprehliadka otvoríte dvojklikom, pri exporte použite „Uložiť do…“. Snímanie ani výpočet v nej na Macu nefungujú — fotogrametria Apple pri iPad aplikácii na Macu zlyháva.
Fotograme3ka 3D (do 1.1 „Fotograme3ka 3D Výpočet“) je samostatná natívna aplikácia pre Mac, ktorá výpočet zvládne a od 1.2.0 je aj plnou prehliadkou s protokolom a certifikátom PDF, dávkovým spracovaním a lasom s úpravou vrcholov. Balík so snímkami pretiahnete do okna, zvolíte detail a rozsah a Mac vypočíta model, ktorý pošlete späť do iPhonu. Mac pozná detail stredný a vysoký (iPhone len nízky) a zvládne 1 500 snímok a 16 384 px oproti 200 snímkam a 8 192 px na iPhone. Všetko beží v Macu, bez cloudu a bez účtu.
Donor — nepovinný poplatok
Aplikácia je bezplatná a plne funkčná bez obmedzení. Kto chce, môže sa stať donorom cez In-App Purchase Apple v pevných sumách od kávy po ročného donora (App Store neumožňuje ľubovoľnú sumu). Nič neodomyká.
ePrehliadky
aPrehliadky sú navrhnuté ako možný doplnok k ePrehliadkam (softvér ÚDZS, www.udzs-sk.sk): k záznamu sa prikladá balík .f3d, protokol PDF a certifikát. Nie sú produktom ÚDZS.
Support & contact
- E-mail: forensika.eu@icloud.com — questions, bugs, suggestions. We usually reply within a few working days.
- When reporting a bug, attach the processing log (Scan → Processing log → Copy) and your device model. Do not send frames or models of bodies.
FAQ
Which device do I need?
iPhone or iPad with iOS 18+. LiDAR (Pro models) is recommended — it provides depth for every frame and the model is built directly in meters. Without LiDAR you can still capture; scale comes from the ARKit trajectory and the calibration target — verify it with a reference.
The device does not support photogrammetry — what now?
Computing the 3D model needs an A17 Pro / M1 chip or newer (iPhone 15 Pro and later Pro models, iPad with M1+). An older device can still capture — even without LiDAR, in which case scale comes from the camera path and the calibration target. Capture, choose Model, findings and frames in Export and AirDrop the package either to a supported iPhone or iPad, or to an Apple Silicon Mac into the Fotograme3ka 3D Computation app. The model is computed there and you send the package back to the phone, where it opens as a new scan. Details in the user guide, chapter 5.2.
The target is placed as the guide says, but the app “did not find” it
The most common cause is not the placement but the distance. A QR code can only be read when it has enough pixels in the image: a 40 mm target is about 86 px at 1.2 m, which is only enough for a perfectly sharp frame — while walking the frames blur slightly and the code no longer decodes (verified by measurement: at 2 px of blur it stops being readable, it works reliably from about 130 px). Solution: during the lap, slow down once and pass over the target from 0.5–0.8 m. Watch the target counter on the capture screen — while it shows zero, the target has not been captured. From version 2.2.2 the app warns about this by itself after 40 frames with “Target not in shot”.
Where is the calibration target?
Scan list → menu … → Calibration target T3 for printing (A4 landscape, 100 % scale, matte paper, rigid board). Measure the circle centres A–B (247.00 mm) with a caliper and enter the value on the scan screen (Target print check). The app finds the circles even from 2 m; the QR is read when passing within ~1 m. The older T3 target is in the menu too, recognised only up close.
What is the 3D documentation certificate and class A–D?
Export → Issue 3D documentation certificate (for a finished model). The certificate states the capture trace (camera path, coverage, time), scale verification (LiDAR, trajectory fit, reference, T3 target), the SHA-256 of the model and findings, a device-key signature (Pro) and a QR code for verification. Class A = scale substantiated by two independent routes within 1 %; B = metric without a second proof; C = indicative; D = unverified. The certificate is also in the package (certificate.json) and import verifies it. Methodology: PDF (EN). The T3 target adds four QR fiducials with known distances; the app measures them from LiDAR depth and reports the error.
The app quit during processing (E36) — the phone “switched off” at 50 %
iOS terminates the app without warning when it goes to the background during processing (locking, another app, a call), when memory runs out or when the device overheats. The frames are fine. When you reopen the scan the app shows E36 and a button Start economy processing (frames downsized to 2560 px; scale comes from LiDAR, accuracy is practically unchanged). During processing keep the app in the foreground on the charger, do not lock the phone and close other apps. Details in the user guide, chapter 5.1.
The model is upside down
Apple photogrammetry takes the gravity direction solely from HEIC metadata (Apple MakerNote, tag 8); it ignores the _gravity.txt sidecar. Frames from versions before 2.2.1 (build 26) lacked this entry, so the model came out rotated by 180° — on iPhone and on a Mac alike. From build 26 gravity is written into the frames themselves; Recompute on an older session adds it automatically. The trajectory fit recognises an inverted model and the viewer flips it by itself; the manual toggle ⋯ → Flip model upside down changes only the display. Measurements and scale are not affected by the flip.
Which file should I archive for court or the investigator?
The archive package with frames — Export → Archive. It is the complete, recomputable original: frames (raw data), model, whole scene, LiDAR surroundings, findings, measurements, certificate, processing log and a SHA-256 of every file. In the chain of evidence the frames are what negatives are in photography: without them the model cannot be verified independently, with them anyone can recompute it. The SHA-256 of the whole package is in the manifest and in the report, so it can be proven exactly what went into the file. Store it on two independent media.
The case file should also contain the report PDF and the 3D documentation certificate. For an investigator or expert who wants to view and measure the model, send the package without frames (tens of MB) — it is not a substitute for the archive. After archiving, the frames can be deleted from the phone; the model and report remain. Do not send the model.usdz file alone as the only evidence — it is only the result, without the manifest, hashes and raw data, and cannot show how it was produced. Details in the user guide, chapter 11.1.
The “ARKit trajectory vs. model” row is orange
The app compares the camera path recorded by ARKit with the camera positions photogrammetry found. A good scan gives a scale close to 1 and a residual of a few centimetres. A difference up to 3 % is green, more is orange. With LiDAR this is not a measurement error — the model is metric straight from the depth maps and no conversion coefficient is applied; the camera path is only an independent check and drift accumulates over a long scan. Orange says the model has no second independent proof of scale: provide one with the T2 calibration target or a reference object, otherwise the certificate gives class C. Without LiDAR it is the other way round — the camera path then defines the scale and the app converts measurements with it.
What happens to findings when I recompute?
Every computation produces a model in its own coordinate frame, so old pins and measurements would sit in the wrong places on the new model. From version 2.2.2 the app transfers them: the same frames have their cameras at the same places in the old and the new model, and from these pairs the app computes the rotation, shift and scale of the new frame relative to the old one; the same transformation moves the pins and the measurement points (the error is usually a few millimetres and the app shows it as “estimated position error”). Measurement values do not change — they come from the original model. The original file stays in the scan folder as annotations_<date>.json and the report states the transfer. For older scans without stored camera poses the transfer goes through the ARKit camera path (coarser), and if even that is not reliable the findings are only set aside and you enter them again. The previous model is kept aside during the computation — if you cancel it or it fails, the old model is restored. Issue the certificate anew, the old one belonged to a different model.
What does an error code mean (e.g. E30, “error 1”)?
Every error is shown with a code E-xx, its meaning and a remedy; the system message is in square brackets. E30 = photogrammetry could not match the frames (system code 1): recompute with sensitivity High and extent Whole scene, then input “Folder without depth”, otherwise repeat the scan more slowly with more overlap. E33 = not enough space, E4x = ARKit (camera, tracking), E60 = App Store. The full table is in the user guide (chapter 14).
Can the scan sound be turned off?
Yes — the speaker icon on the capture screen or ⓘ → Settings → Scan sound: Deep Space (default, quiet deep tone and whistle), Star Trek (sensor warble) or No sound.
How do I capture a living person with the T3 target?
The person stands upright in an open space (at least 1.5 m all around), feet shoulder-width apart, arms slightly away from the body, head straight and gaze on a fixed point — arms pressed against the sides are the most common mistake, the inner surfaces of the arms will then be missing from the model. Put the T3 target flat on the floor beside the feet, about 20–40 cm to the side; one target per scan. In the app choose the Living person profile, aim at the chest and tap Set scan centre. Then walk three laps at a distance of 1.0–1.2 m: at head height tilted down, at chest height level, and crouching with the phone tilted slightly up at the legs. One lap takes 15–20 seconds at a steady pace, the whole capture under a minute. Never capture against a window, and remember that smooth single-colour clothing is the worst case for photogrammetry — skin works far better. If the person moved, repeat the scan. In detail and with figures: chapter 4.2 of the user guide.
How to capture?
Aim at the center of the subject, confirm and walk around slowly — frames are captured automatically. The radar in the top right shows coverage. Body: diffuse light, no flash. Object: matte contrasting surface, walk around at three heights.
Processing takes long / the phone heats up
Reconstruction runs entirely on the phone and is demanding — minutes. The screen stays on (dimmed); leave the phone on the charger. A notification arrives when it finishes.
I cannot see the model
Scan → Diagnostics → Open in system viewer. If the model exists, the system viewer always shows it. If not, send the processing log.
How to measure?
In the viewer, tap two points on the surface — distance in mm. Body length: crown and heel. Distance from an object: reconstruction extent Subject with surroundings or Whole scene. Reference: measure the target scale and enter 100 mm.
Where are the exports?
Files → On My iPhone → aPrehliadky → Exporty (package, PDF report, USDZ). The archive has its own subfolder.
How do I mark findings?
In the viewer switch the bottom panel to Mark finding, choose a type (injury, mark, livor, sample, other) and tap the surface — every tap adds a numbered pin. Tap the pin to add a title and note; “Undo” removes the last one. In Measure mode taps add measurement points.
What is Surroundings from LiDAR?
With LiDAR the app also stores the ARKit room mesh during capture (floor, walls, ceiling, table, door) as a second, metric, untextured model. Open it in the scan under Surroundings from LiDAR; it has its own findings and measurements. To capture the whole room, sweep the camera slowly over the walls and floor after circling the subject.
How do I change units?
ⓘ → Settings → Measurement units: mm, cm, dm, m, inches, feet. The conversion is exact; the package and the report always store values in mm.
Does it work on a Mac?
Yes, in two ways. aPrehliadky on an Apple Silicon Mac (App Store → Mac, “Designed for iPad” app) is for examination, measuring, findings and the report: double-click an .f3d package or an older .aprehliadka to open it, and use “Save to…” when exporting. Capture and processing do not work there — Apple's photogrammetry fails for iPad apps on the Mac.
Fotograme3ka 3D (until 1.1 “Fotograme3ka 3D Computation”) is a separate native Mac app that does the computing and, from 1.2.0, is also a full examination tool with report and certificate PDF, batch processing and a lasso with vertex editing. Drag a package with frames into the window, choose detail and extent, and the Mac computes the model, which you send back to the iPhone. The Mac offers medium and full detail (the iPhone only reduced) and handles 1,500 frames and 16,384 px against 200 frames and 8,192 px on the iPhone. Everything runs on the Mac, no cloud and no account.
Donor — optional fee
The app is free and fully functional with no limits. Anyone who wishes can become a donor through Apple In-App Purchase in fixed amounts from a coffee to an annual donor (the App Store does not allow arbitrary amounts). It unlocks nothing.
ePrehliadky
aPrehliadky is designed as a possible add-on to ePrehliadky (software of ÚDZS, www.udzs-sk.sk): the .f3d package, the PDF report and the certificate are attached to the record. It is not a product of ÚDZS.