Films and views in a case
A case is the patient. A view is one film inside it, with everything you have measured, planned and placed on that film. A case can hold up to 24 views, and shows up to 12 of them at once.
How many views can be on screen at once?
Twelve. A case holds 24, so a film added once 12 are showing comes in hidden, and the note that appears says how many did. Bring one back from Add View. With 12 already on screen, hide one first: the menu says so, and Add View’s empty slot waits too.
Each view gets its own pane on screen, and each pane carries its own bar along the top: the view’s name, a Left/Right chip, and the tools that act on that film.
Adding a view
How do I add another radiograph to a case?
Add View in the top bar. It opens an empty slot beside the films, where the new view will go, reading Click or drag to add view, and you can either click it to browse for a file or drag one onto it. The slot also has an Incoming / PACS button for films emailed in, sent by your equipment or kept on your PACS — see Getting radiographs in from your equipment — and a Your phone button for sending photos and videos from your phone (below).
Two other routes reach the same place:
- Drag a file onto the films — anywhere in the film area, not only the empty slot.
- Paste with Cmd/Ctrl + V — a view copied out of a PACS viewer or an email is on the clipboard, not on disk, and does not have to be saved out first. A pasted screenshot is filed as Pasted image. Paste a web link instead of a picture and the app says so: it cannot fetch a Drive or OneDrive link, because that needs your own login.
On a phone, Add view sits in the ⋯ menu in the header rather than on the header itself.
What file types can I add as a view?
JPG, PNG, DICOM, ZIP, or video — that is what the empty slot says, and the file picker offers the same.
- DICOM is read by the app itself. There is no need to export a JPEG first.
- A ZIP is opened in your browser and the radiographs inside it are imported. Nothing is sent anywhere to be unpacked. A burned-CD folder tree works. Where an archive holds both a DICOM study and loose JPEGs, the DICOM study is used and the app tells you how many other images it set aside.
- A folder from a CD or USB stick can be dragged in as it is, and is read like a ZIP. DICOMs with no extension, such as IM0001, work too.
- An iPhone photo saved as HEIC is not taken. Save it as a JPEG, or send it with Your phone, which converts it.
- A video dropped where films go becomes a view in its own right, tiled beside the films. See Videos on a case below.
Can I add several films at once?
Yes. Select several in the file picker, or drag several across together, and each becomes its own view.
All the files in one import must be the same patient. If the DICOM headers name more than one animal the whole import is refused and nothing is added, so a plan can never be measured across two dogs.
Can I send photos or videos from my phone?
Yes, and you do not sign in on the phone. In a case, click Add View, then Your phone in the empty slot. To start a new case from your phone instead, click New Case, then Your phone. A QR code appears: point your phone’s camera at it and tap the link it shows.
The page that opens on the phone has three buttons:
- Take a photo opens the camera — the quick way to bring in a film that is on another screen.
- Photos or videos on this phone picks from the phone’s library: a gait video, or photos taken earlier.
- A letter or document is for paperwork — a referral letter, blood results — as a PDF, a Word file or a photo. It goes into the case’s Attachments, not onto the films.
Each file appears in the case a few seconds after the phone sends it, and the phone marks it On your computer. Keep the page open on the phone until every file says so.
The code works for 30 minutes, and only while its window is open on your computer: closing the window ends it, so a photo of the code is no use to anybody afterwards. One code takes up to 24 files — photos up to 40 MB, videos up to 1 GB and documents up to 25 MB each. A photo from the camera arrives named Phone photo 1, Phone photo 2 and so on — or for what it shows, when Librevet is sure (see Naming a view); rename it as you would any view.
A photo of a film on a screen is calibrated like any other film, off the marker in it. Hold the phone square to the screen: a photo taken at an angle stretches one side of the film more than the other, and no marker can correct that.
Why can’t I add another view?
Hover Add View and it says which of these it is. If the case has hidden views, Add View opens the Hidden views list instead, and the reason is on the dimmed Add another image at its foot.
- The case is full. Twelve views is the ceiling. Hidden views still take up their slot, and the message says how many are hidden, so a case that looks half empty can still be full.
- The case is not yours. Only a case’s owner can add views to it. Make your own copy if you need to.
- An empty view is already waiting for an image. Fill it or close it with its × first.
Naming a view
A view arrives named after the file it came from, which is usually whatever the X-ray machine called it.
Why is my film called “Stifle — mediolateral” when I never named it?
A film whose file name says nothing — a camera’s IMG_4521, Pasted image, Phone photo 1, the long string of numbers a DICOM is often called — is named for what it shows as it arrives: the body part and how it was taken, such as Stifle — mediolateral, Antebrachium — craniocaudal or Pelvis — ventrodorsal. Librevet recognises the stifle, tibia, femur, pelvis, antebrachium, carpus, elbow, humerus, tarsus and spine, and names a film only when it is sure of both halves; otherwise the film keeps its file’s name. A film that takes in two neighbouring parts, such as a stifle and the tibia below it, is named for both — Stifle/tibia — mediolateral, the likelier first — when Librevet is sure it is one or the other. A name you or the file gave it is never replaced.
It can still be wrong — about one film in ten that it names, most often a stifle called a tibia or the other way round — so check it, and rename it as below if it is. The name is worked out on your own computer; the film is not sent anywhere to be named.
How do I rename a view?
Click the name on the film’s own bar. It turns into a View name field. Press Enter, or click away, to keep the new name; press Escape to abandon it.
Clear view name — the × inside the field — empties it so you can retype, and leaves the field open. An emptied name is never saved: abandon it and the view keeps the name it had.
Not on a phone: the phone layout leaves the name off the film’s bar, so rename a view on a tablet or a computer.
Where does the view’s name show?
- On the film’s own bar on anything bigger than a phone, cut short on a narrow pane. A phone leaves it off the bar; with two or more views it shows numbered tabs in the header instead, and the name is on each tab’s tooltip.
- Over that view’s group in the sidebar’s Items list.
- Under Hidden views in the Add View menu, so you can tell a hidden film from another.
- On the downloaded PNG’s filename, and in the Surgical report.
A good name is worth a minute. “Right tibia — mediolateral” is what tells two similar films apart in the Items list, in the report, and in the trash if one is ever removed.
Hiding a view
How do I hide a view?
Hide this view — the crossed-out eye on the film’s own bar, or in ⋯ More image tools on a narrow pane. It frees the space for the films you are working on.
Hiding does not take anything out of the case:
- The measurements, plans and implants on a hidden view are still there. They stay in the sidebar’s Items list, marked hidden.
- A hidden view is still offered when you build a Surgical report.
- A hidden view still counts towards the 24 a case can hold.
Hiding is saved with the case, so a view you hid is still hidden next time you open it. It is also undoable.
You cannot hide the last view on screen — the button dims and says The only view left — it cannot be hidden.
How do I get a hidden view back?
Add View. With hidden views in the case the button carries a count badge, and clicking it opens a list headed Hidden views: click one to put it back on screen. With 12 views already showing, hide one first. Add another image at the foot of the same menu is the way to a new film instead. On a phone the hidden views are rows in the ⋯ menu.
A hidden film is not loaded when the case opens, which is what makes a study with several hidden views quick to open — so expect a short pause the first time you bring one back.
Removing a view
How do I remove a film from a case?
Remove this view from the case — the bin at the right-hand end of the film’s own bar, or in ⋯ More image tools on a narrow pane. It asks first:
Remove this view? This will remove the image and all objects on this view.
Remove takes the view off the case. Cancel leaves it alone. Only the case’s owner can remove a view; on a colleague’s case the button is dimmed and says so.
What happens to the measurements on a view I remove?
They go with it. The view is removed whole — the radiograph, everything measured or planned on it, and the original it was imported from.
You can undo it straight away, and if you do not, it is still recoverable from the trash for 30 days.
How do I get a view back that I removed?
Trash, in the gallery sidebar. A removed view sits there for 30 days alongside deleted cases, documents and videos, and each row says how many days it has left.
- Restore puts the view back on the case it came off, at the position it held, with its measurements.
- Delete for good destroys it now rather than waiting out the rest of its time. That one cannot be undone.
A view whose whole case has also been deleted has nowhere to go back to. Its row says its case is not in the gallery and Restore is dimmed — restore the case first.
I took the last film out of the case. What now?
An empty case is not a broken one: swapping a poor exposure for a better copy of the same shot passes straight through it, and the empty case still shows the drop zone to land the replacement on.
The app offers a tidy-up rather than taking one — a message reading No images left in this case. with a Delete case button. Nothing happens unless you press it, and the case still holds the patient details, the attachments and the referral links.
Linking a bone’s two views
How do I link a bone’s two views, so a plate shows on both?
Yes, once the two films are linked. When a case holds a side view and a front-on view of the same long bone — a tibia, radius, femur or humerus — each of the two films shows a small Link box at its top left, just under the film’s bar. Tick it on either film and both are linked; untick it to unlink them. A ventrodorsal view of the hips counts as the front-on view of the femur on the side the femur’s side view is marked.
While they are linked, an implant you place on one film appears on the other at the same level along the bone, with the same size, screws and bends. Slide it along the bone on either film and it moves on both; turn it across the bone on one and it leans on the other, so it is drawn a little shorter there. Where it sits across the bone, and its angle, are each film’s own. A TPLO, CBLO or TTA plate placed on the side view appears on the front-on view side-on, against the medial side of the tibia, which the app tells from the fibula; move it if it needs moving. Its screws are placed on that side-on drawing: with the plate selected on the side view, Screws in its panel takes you there, and clicking a screw’s head on the side view takes you to that screw. It is one plate on both films: one row in the Items list, selected together, hidden and deleted together. Mirroring a film turns a plate seen side-on over with it, so its screws still point into the bone. Implants placed before you linked the films stay on their own film.
Does a TPLO or CCWO show on the other view?
Yes, once the films are linked. A CCWO, closing wedge, TPLO or CBLO planned on one view is drawn on the other as a dashed line across the bone, where the cut crosses it. When you close the wedge or rotate the plateau, everything beyond the cut moves on the other view too, the joint and the rest of the limb with it: it slides along the bone and looks a little shorter, the way the turn makes it look from that side. There is nothing to trace or move on the other view. A TPLO’s or CBLO’s cut stays closed on the other view: the plateau slides round its curved cut, so no gap opens. A TPLO’s Plateau Shift moves the top of the leg across the cut on the front-on view as well, medially or laterally.
What if the app doesn’t recognise the two views?
Link them yourself. Once a case has two or more films, every film carries a Link box, a few seconds after it opens. Tick it on the two films you want linked (with only two films, one tick links both). Where the app found the bone on both films, they link straight away. Where it didn’t, it asks you to click the middle of the proximal joint, then the distal joint, on that film, and the second click links the two. Click the same bone on both films, with both joints on the film. To place a joint again, untick the box and tick it again. Esc or a right-click on the film stops without linking.
Why is there no Link box on my films?
A case needs two or more films on screen, and the box appears a few seconds after a film opens, once the app has read it. It is never shown on an ultrasound, or on a case you can only view. A film that stops at the knee links by itself when both films’ scale was set from the ball (see the next question). Without that, link it yourself, as above. You can also place a plate side-on yourself: put it on the front-on view, choose Side under View in its panel, and set its screws in the Screws tab.
My front-on view only shows the stifle. Can it still link?
Yes, as long as both films have their scale set from the calibration ball, found by Auto or drawn by hand. A film centred on the stifle shows the knee but not the hock or the hip, so the app measures along the bone from the knee instead, taking the bone’s length from the other view, which must show the whole bone. A scale read from the X-ray machine’s own settings can be 10–25% out beside the ball, and would put the plate that much further along the bone, so it doesn’t count. Either view can be the one that stops at the knee, but not both. A plate placed well down the shin on the full-length view has its twin past the end of the shorter film.
My case has pre-op and post-op films of the same bone. Which ones link?
You choose. Every film of the bone gets a Link box. Tick one and, if there is only one film it can go with, the two link straight away. If it could go with more than one, Librevet picks the one from the same visit where it can tell (both marked post-op or neither, or taken the same day); otherwise the box waits, half ticked, the films it could go with are outlined, and the next one you tick is the one it links with. You can link the pre-op pair and the post-op pair side by side.
How do fragments work on linked views?
Trace each piece on both views. When you finish a piece on one film, the other film is selected with the same tracing tool and asks you to trace the same piece there. A piece can’t be moved until its match on the other view is traced. After that, sliding it along the bone on one film slides it the same distance along the bone on the other; moving it sideways or turning it stays on the film you moved it on.
Clearing what you have drawn
How do I clear the measurements off one film?
Clear all items on this view — the eraser on the film’s own bar, labelled Clear items on this view when the bar is folded into a menu. It removes every measurement, plan, annotation and implant on that one view. The image, the calibration and the other views are untouched, and it is undoable.
How do I clear every view at once?
The eraser beside the Items heading in the sidebar, under the caption All views. It asks first:
Clear every view? This deletes every measurement, plan, implant and annotation on all 3 views. The images themselves stay. You can undo it.
The number is your case’s own. A video counts as a view, and the marks on it are cleared too; on a case holding only a video the question reads This deletes every annotation on this video. Clear all does it; Cancel leaves everything as it was. One Undo brings everything back, films and videos together.
Beside it is a second study-wide button, Re-fit every view — zoom, pan and rotation back to default on every film, which changes nothing you have drawn.
Downloading a film
How do I download or save a copy of the film?
Download radiograph — the download arrow on the film’s own bar, or in ⋯ More image tools on a narrower pane. You get a PNG at the film’s full resolution, taking in any rotation you have applied, with the lines, osteotomies and implants you have placed drawn onto it, and the millimetres and degrees they read. The editing grips are left off.
The file is named after the view — so “Right tibia — mediolateral” downloads as Right tibia — mediolateral.png. An unnamed view falls back to radiograph_analysis.png. The view itself keeps its name either way.
For a document rather than a picture, use Reports in the top bar instead, which opens on the Surgical plan — see Frequently asked questions.
Can I put all the plan’s numbers on the film itself?
Yes. Open Annotation and press Summary. A box appears in the top-left corner of the film you are on, with every figure the Surgical report lists for that film: the measurements, the surgical plan and the implants. For a TPLO that is the blade radius, the rotation and how far the cut face travels, the TPAs, TT thickness and D1 to D3, then the plate. Each tool’s figures sit under its name, and they follow the plan as you change it. The box goes into the downloaded picture, drawn large enough to read with the whole film on screen. The report’s own pictures leave it off, because the report prints the same figures in its table.
While the box is selected (press it on the film, or press Summary again), Annotation shows its settings:
- Rows to show — untick a row you do not want, or a whole tool. The ticks are the same in every box on every case, and they follow you to any computer you sign in on.
- Text size — S, M, L or XL.
- Colour — one of the pens above, or Tool colours for each tool’s own colour. On the black pen the box turns white so it can be read.
- Your note — a line or two of your own, under the figures.
A new box starts in the size and colour you chose last. Drag the box anywhere on the film, or off it into the black beside it, where the download makes room for it; double-click puts it back in the corner. Each film has one box. It is listed under Items as Plan summary, where its eye hides it, and the Delete key takes it away. The readings beside each line stay as well; to have the box alone, turn off Readings on the film.
On a CT scan, Annotation → Summary puts the same box over one of the scan’s views — the 3D view to start with, or the view you have maximised — with every figure the Surgical plan lists for the scan. It has the same settings, plus Shown on to move it to another view. Each scan has one box, and a picture of its view saved with Export in the list of scans carries it.
Can I get the original DICOM back?
If the case has banked originals, yes: open Attachments from the top bar and look for the Original radiographs section, then Download beside the film you want. These are the DICOM files exactly as they arrived.
The section is absent when there is nothing to offer. Originals are kept on the paid plans only, they only exist for films that arrived as DICOM, and they are owner-only — a colleague you share the case with sees the film, never the original, because an original carries the full patient header that a share deliberately holds back.
Videos on a case
Can I put a video in a case?
Yes — a gait pass, a seizure, a joint being flexed. Anything worth watching rather than reading.
Drop it where films go and it becomes a view, tiled in the grid beside the films with the same three window controls: Maximise this view, Hide this view and Remove this view from the case. It offers no ruler — a clip is not calibrated or measured on.
You can also add one from the Attachments tab, with Add file or by dropping it there — the same button as a referral letter. It is listed with the documents, in the order things were added; click its row to watch it.
- MP4, MOV or WebM, up to 4 clips per case.
- Every clip is re-encoded to 720p and stored at up to 100 MB, which is about five minutes of footage. Compressing runs in real time — a sixty-second clip takes about sixty seconds — so keep the window open until it finishes.
- Videos are counted separately from the films.
How do I mark up a video?
The same way as a film. Pause on the frame, arm Text, Arrow or Draw in Annotation, and put the mark on the clip. It is saved as you put it down, it is selected, and the tool is put away. A text label is clicked down first and typed after, on the clip.
- Select a mark by clicking it on a paused clip, or its row in Items, where each clip’s marks are listed under its name with the time they appear. Clicking bare frame lets it go.
- Change it with its grips: an arrow has one at each end, a label has one at its corner to size its box, and any mark can be dragged whole. Click a selected label to retype it. A colour, font size, brush size or arrow thickness picked in Annotation restyles the selected mark.
- Link an arrow to a label as on a film: start the arrow inside the label’s box, or drag its tail onto it. Moving the label then brings the tail with it, and the head stays where it points. A label stays still; the arrow’s head can move with the animal while its tail stays on the label.
- Delete it with the Delete key, the bin in the Annotation header, or its row in Items. The eraser beside the Items heading clears every mark on every view, videos included.
- Undo takes marks back one at a time.
With a mark selected, the Annotation section also shows Stays up for (2, 5 or 15 seconds, or to the end), Mark moves and a Note about it.
On the Attachments tab, choose Mark this frame under the clip instead.
Can an arrow on a video follow the leg as the animal walks?
Yes. Put the arrow’s tip on the spot, such as the hock, the stifle or the foot. Mark moves: With the animal is on by default: the app follows that spot while the mark is on screen (up to 30 seconds) and the mark moves with it. Annotation says Following… while it works, and you can keep watching.
If a leg passes behind the other one the app can lose the spot. It stops rather than guessing, and Annotation says when. Pause on that frame and drag the mark back onto the leg; it carries on from there. Stays still keeps a mark where you drew it.
How do I delete a video?
Remove this view from the case on the clip’s own bar, or the delete button on its row in Attachments. Either way it asks first, and the clip then waits out the same 30 days in the trash as a film or a document, where you can put it back.
Documents on a case
Where do lab results, referral letters and other attachments go?
Referral reports, bloodwork and letters go in Attachments (the Attachments tab of an open case, or the paperclip on the card), in one list with any videos. Each row says when the file was added and who uploaded it. PDF, Word, JPG and PNG are accepted, up to 25 MB each, and they ride the same 30-day trash as everything else.
An attachment is reference only — you cannot measure or plan on one. A radiograph you intend to plan on has to come in through Add View, not through the paperclip. This is the one thing worth getting right first time: a film filed as an attachment looks safely stored and then cannot be measured. The Attachments screen says so in small print under its add-file button, but once the film is filed nothing on it gives a sign.
Working with several films at once
How are the films laid out?
They tile automatically, and wrap onto more rows as the case fills up: up to four columns on a desktop, three on a tablet. A phone mounts one film at a time and switches between them with the numbered tabs in the header.
Which film do the tools act on?
The one with the cyan outline. Click anywhere on a pane to make it the current one; the sidebar, the calibration panel and the keyboard all follow it.
Two things worth knowing about this:
- Calibration is per film. Two views of the same patient can be scaled differently, so the millimetres in the sidebar are the current film’s.
- The Items list is not. It shows every view in the case, grouped by view name, rather than only the current one — so a measurement you placed on another film does not vanish when you click away from it.
Can I make one film bigger?
Maximise this view, on the film’s bar, fills the whole film area with it. The same button then reads Restore all views and puts the others back. The button only appears where there is more than one pane to choose between.
On a computer you can also double-click the film itself, anywhere with nothing on it, and double-click it again to put the others back. While a tool is armed a double-click belongs to that tool, so put the tool away first (Escape).
Can I make one film wider than the one beside it?
Yes, on a computer: drag the line between the two films sideways. Only the films either side of that line change width, and neither goes narrower than its own bar needs. Double-click the line to make every film the same width again.
The widths are kept with the case, for your account on that computer, so it opens the way you left it. A colleague opening the same case sees the films evenly spaced. On a tablet or a phone the films always share the width evenly.
Can I change the order of the films?
Yes — drag a film by its own bar and drop it where you want it. The other panes shrink to open up the gaps, and a cyan marker shows which edge it will land on. The order is the one you read the films in, and it is kept with the case.
The image tools on each film’s bar
Brightness and contrast, mirroring, flipping, inverting and Reset view are all on the same film bar, and each acts on that one view only. On a computer the film is turned by the knob in its bottom-right corner rather than from the bar. They are answered in Frequently asked questions under Viewing the film.
On a narrow pane those tools fold into ⋯ More image tools rather than disappearing — if a button you expect is not on the bar, open that menu.