Smileline
Patients

Opening files

What happens when you open a patient's file — PDFs, Word and Excel files, emails, DICOM x-rays, videos, archives, 3D files and the rest — and what to do when a preview isn't ready yet.

Click a file on a patient's record and it opens in place, in a viewer made for its kind: a PDF in the PDF viewer, a DICOM x-ray in the DICOM viewer, an email as an email, a 3D file in the 3D viewer. Nothing needs installing, and nothing opens in another program. Download is always there and always gives you the file exactly as it was received.

This works for practices in every country. Files open the same way wherever you find them:

  • the record's Files tab (see Files);
  • the record's Correspondence panel: Open on a file under Files, and Open PDF on a letter, prescription, referral or lab slip (see Filed documents);
  • invoices, statements, payment plan agreements, estimates and a plan's signature, wherever they are opened;
  • the page a lab opens from a shared link;
  • attachments in the inbox, with the limits in Inbox attachments.

A document opened from the record fills the screen, with Download and Close; nothing opens in a new browser tab, so a PDF looks the same on every computer, tablet and phone. A 3D file opened from Files offers Download: open it from the Files tab to see it in 3D.

What opens how

Some files open as they are. For others, Smileline makes a copy it can show — a PDF of a Word file, a picture of a TIFF, a playable copy of a video — on its own servers, shortly after the file is filed (see Previews Smileline makes). The stored file is never changed.

FilesFor exampleHow they open
PicturesJPEG, PNG, GIF, WebP, AVIFAs they are
iPhone photosHEIC, HEIFThrough a light copy
Other picturesTIFF, JPEG 2000, JPEG XL, PSD, BMP, TGA, PCX, PBM/PGM/PPM, EXR, HDR, DDS, ICNS, ICO, XCF, SVG, EMF, WMFThrough a copy Smileline makes. A TIFF of several pages becomes a PDF; a grey TIFF of more than 8 bits (a scanned x-ray, say) opens in the DICOM viewer
Camera RAWDNG, CR2, CR3, NEF, NRW, ARW, SR2, ORF, RW2, RAF, PEF, SRW, 3FR, IIQ, ERF, KDC, MRW, X3FThrough a copy Smileline makes
DICOMX-rays, intraoral and extraoral images, files of several frames, structured reports, DICOM holding a PDF, STL or OBJ, DICOM videoThe DICOM viewer
PDFPDF, and an Illustrator file saved as PDFThe PDF viewer
Office documentsWord (DOC, DOCX), Excel (XLS, XLSX), PowerPoint (PPT, PPTX), OpenDocument (ODT, ODS, ODP, ODG), Pages, Numbers, Keynote, RTF, Visio (VSD, VSDX), Publisher (PUB), XPSIn the PDF viewer, through a PDF copy Smileline makes
EmailsEML, Outlook MSGAs an email
TextTXT, CSV, TSV, JSON, XML, Markdown, HTMLAs text, or a table
Clinical documentsHL7 CDA, FHIRAs a page Smileline makes from them
ArchivesZIP, 7Z, RAR, TAR, GZAs a list of their files; a ZIP or 7Z of 3D files opens in the 3D viewer
VideosMP4, MOV, WebM, MKV, AVI, MPEG, TS, 3GPIn the video player, through a playable copy when the browser can't play the file
3D filesSTL, PLY, OBJ, GLB, glTF, 3MF, AMF, VRML (WRL)The 3D viewer
VolumesNIfTI (NII, NII.GZ), NRRD, MetaImage (MHA)In the DICOM viewer, a slice at a time
PostScriptEPS, PS, and an Illustrator file that isn't a PDFIts name and Download only

What Smileline can't show

  • CT and CBCT scans open in Implant planning, not here: the DICOM viewer shows one file at a time, never a scan made of hundreds of files, and has no 3D or cross-section views. On the Files tab, a scan's files are left out of the viewer's arrows and strip while it shows as one scan.
  • DICOM compressed as HTJ2K or JPEG XL says This DICOM uses a compression Smileline can't open yet (HTJ2K / JPEG XL). with Download, to open in your imaging software.
  • 3Shape's own .dcm 3D files are 3Shape's format, not DICOM, despite the ending, and Smileline can't draw them. Open them in 3Shape's software, or ask the lab for an STL or PLY.
  • A design or imaging program's own project file (an exocad or 3Shape project, an imaging program's study) opens only in that program: download it.
  • EPS, PS and Illustrator files that aren't PDFs are kept and can be downloaded, but never shown.
  • Audio files (MP3, M4A, WAV), WMV and FLV videos, and Word, Excel or PowerPoint files protected with a password: Smileline can't tell what they are, so they can't be added (see Adding files). Remove a document's password and add it again.

Previews Smileline makes

A copy is made once, in the background, after the file is filed. Files already on a record get theirs the same way, newest first. A copy holds only what you see: a phone video's location, say, stays in the original.

Until it is ready, the file says Making a preview… You can download the file meanwhile. with Download. Most copies take seconds and a long video a few minutes; the preview shows the next time you open the file.

If a copy can't be made, the file says why, with Download:

What it saysWhat it means
A preview of this file couldn't be made.The copy failed
This file is too large to preview.The file is too big or too slow to copy: a picture of more than about 250 megapixels, a copy over 2 GB, or one that takes more than 5 minutes (30 for a video or a DICOM file)
Smileline couldn't read this file to preview it.The file is damaged, or isn't what its name says

On the Files tab, Retry preview, for members who can upload documents, asks for the copy again; the file then says it is being made. Whatever happens to the copy, Download gives you the original to open in its own program.

Thumbnails. On the Files tab, in a document's pane under the record's Files, and on a shared link's page, a file shows a thumbnail once Smileline has made one: a document's first page, a video's frame, a DICOM image's picture. Until then, and for files without one (emails, text, archives), it shows an icon of its kind. A video's tile has a play button. On the Files tab, a 3D file's tile shows the model itself, which turns as you move the pointer over it, and a CBCT scan's tile an X-ray-style front view of the scan (see Files and CBCT scans).

The PDF viewer

PDFs, and Office documents through their PDF copy, open in the PDF viewer:

  • Page with the page number and of the number of pages: type a page number and press Enter to go to it. On a wider screen, a strip of pages runs down the side.
  • Zoom in, Zoom out, Fit width and Fit page.
  • Rotate 90° turns every page a quarter at a time.
  • Find in document searches the text of every page: it says how many matches there are and marks them, and Enter or Next match steps to the next (Previous match goes back).
  • Print brings up your browser's print dialog for the document.
  • Download saves the original file.

A letter's Print, and a lab order sent by Print, open the PDF here and bring up the print dialog straight away.

From the keyboard: Page Down and Page Up move a page, + and − zoom, and Ctrl+F (⌘F on a Mac) goes to the find box.

The text of a PDF can be selected and copied, and a screen reader reads it. Links inside a PDF are drawn but can't be clicked, and a PDF's forms and scripts never run. A PDF protected with a password says so: download it and open it with its password.

An Office document's copy looks as the document prints. A font Smileline doesn't have is replaced by a similar one, so lines may break a little differently from your computer. Macros in a document never run.

The DICOM viewer

DICOM images, a grey TIFF of more than 8 bits and the volumes above open in a dark viewer. Its bar holds, from left to right:

  • Reset puts the picture back as it opened: fitted, upright, at the file's own window and not inverted.
  • Window: File (the window the file was saved with), Full range, Bone, Soft tissue and Enamel. Bone, soft tissue and enamel are set from the picture's own range of greys, so they suit intraoral, panoramic and ceph x-rays as well as CT. Once you drag, it says Custom. A colour image has no window list.
  • Invert swaps black and white.
  • Rotate clockwise (⟳), Flip left to right (↔) and Flip upside down (↕).
  • Fit fits the picture to the pane; Actual size (1:1) shows one pixel of the image on one pixel of the screen.
  • Length, Angle and Clear (see Measuring).
  • Overlays shows or hides the text over the picture.
  • Enter fullscreen, and Download for the original file.

The text over the picture shows, at the top left, the modality, the study date and the frame; at the bottom left, the window and level (W and L) and the zoom. It never shows the patient's name.

Mouse, trackpad and touch

  • Brightness and contrast: drag with the left button. Drag right to widen the window, down to raise its level.
  • Zoom: drag with the right button, or hold Ctrl and drag. On a single picture the mouse wheel zooms toward the pointer; Ctrl with the wheel, and a trackpad pinch, zoom on any file.
  • Move: drag with the middle button, or hold Space and drag.
  • Frames: on a file of several frames or a volume, the mouse wheel steps through them.
  • Touch: pinch to zoom, and move with two fingers.

Keyboard

Click or tab to the picture first.

KeyWhat it does
+ or =Zoom in
−Zoom out
0Fit
RReset
IInvert
LMeasure a length
AMeasure an angle
Arrow keysMove the picture; on frames or a volume, step through them
SpacePlay or pause the frames
EscDrop the measurement you are drawing, then put the tool away

Pointing at a button shows its name and, when it has one, its key.

Measuring

Click Length (or press L) and click the two ends; click Angle (or A) and click one arm's end, the corner, then the other arm's end. Each measurement stays on the image as you zoom, move, turn or flip it. Clear removes them all.

  • When the file says how large its pixels are, lengths are in millimetres.
  • When it says only how large they are at the detector, lengths read mm at detector: the x-ray's magnification is included.
  • Otherwise they are in pixels, marked Not calibrated.

Measurements are for looking only: they are not saved, and go when the viewer closes.

Frames and volumes

A file of several frames, and a volume, has a slider under the picture (Frame or Slice, with Frame 3 of 40) and Play, which plays the frames at the file's own speed (ten a second when it doesn't say) and loops; Pause stops it. A volume is shown as it was saved: use Rotate clockwise and the flips if it is the wrong way round.

What a DICOM file can carry

  • A DICOM holding a PDF opens in the PDF viewer.
  • A DICOM holding an STL or OBJ opens in the 3D viewer.
  • A structured report shows as its headings and lines. If only part of it could be read, it says Only part of this report could be read.
  • A DICOM video plays through its playable copy; until that is made it says The video's playable copy isn't ready yet.

When a file can't be shown, the viewer says why, with Download: This file is cut short: it ends before its picture does., This file can't be read., This file is too large to open here. (over about 340 MB), or This file didn't open. Try again, or download it.

Emails

EML and Outlook MSG files open as an email: From, To, Cc, Date and the subject, then the message, then its Attachments.

The message is shown offline. Pictures inside it show; nothing is loaded from the internet, and its links can't be clicked, so opening an email never tells its sender. Click an attachment to open it in place, in its own viewer, with Back to return to the email; one that can't be shown in place downloads.

An email over 64 MB says Too large to preview here. Download it to open it.

Text and spreadsheets

Text files open as text: a CSV or TSV as a table, JSON laid out with indents, and HTML and XML as their source, never as a page. Only the first 2 MB shows, and the viewer then says Showing the first 2 MB. Download the file to see all of it.

An HL7 CDA or FHIR document opens as a readable page Smileline makes from it, shown offline like an email.

Archives

A ZIP, 7Z, RAR, TAR or GZ archive opens as the list of the files in it, with Files and how many. Click a file to open it in place when it is a kind the viewers show without a copy (a PDF, a picture, a DICOM image, an email, text, a video); otherwise it downloads. While one opens, Opening its name shows with Cancel. An archive inside the archive is listed but not opened: click it to download it. Download archive saves the whole archive.

The list shows up to 10,000 files and says how many more there are. An archive too large for the browser tab (about 1 GB) says Too large to open here. Download it to open it.

A ZIP or 7Z of 3D files, such as a lab's design, opens in the 3D viewer instead.

Videos

Videos play in the video player: play, pause, the sound and fullscreen, and you can skip to any point. An MP4 or WebM the browser can play plays as it is. Any other video (a MOV from an older camera, an MKV, an AVI, a phone's HEVC clip) plays through a copy Smileline makes: an MP4 up to 1920 pixels wide, with a still from the video shown before it starts.

On the Files tab, videos are filed as photos and are found under Filter › Videos.

3D files

STL, PLY, OBJ, and ZIP or 7Z files of them, open in the 3D viewer through their light copy, as before. GLB, glTF, 3MF, AMF and VRML (WRL) files open in the same viewer from the file itself: they are light enough already, so they get no light copy and no Full detail. Add to view shows them beside the patient's other 3D files. A jaw of an intraoral scan opens with the scan's other 3D files already in the view (see Scans).

The 3D viewer's controls sit on the view itself: the views, zoom, turns, Colour and fullscreen in a column down its right-hand side, each part's fade slider in a panel at its top left, and what the viewer says about the files, with Full detail, along its foot. Opened from the Files tab, the view fills the window between its title and the strip of files.

On the Files tab, an STL, PLY or OBJ file, or a ZIP or 7Z file of them, shows the model on its tile once Smileline has made the tile's picture with the light copy, a few minutes after it is filed; until then the tile says Preparing 3D preview…. Move the pointer over it and the model turns to face it, then comes back to the front when the pointer leaves. It stays still on a touch screen or with reduced motion turned on. The viewer's strip of files shows the same model. GLB, glTF, 3MF, AMF and VRML files, and a file whose tile picture couldn't be made, show a cube.

  • GLB and glTF show their colours and their colour pictures (textures). A texture Smileline can't read, or that is too large to draw, is left out and the viewer says … is shown without its textures. A glTF file often comes with separate files for its shape and pictures: add them together as one zip, or the viewer says … needs its other files to be shown: add them together as one zip. A glTF compressed with Draco can't be shown yet: download it.
  • 3MF shows each part's own colour, and VRML its colours; AMF shows without colour. None of the three draws its pictures, and the viewer notes it when a file had any.
  • A VRML file over about 25 MB is too large to view in the browser: download it.

A 3D file never loads anything from the internet or from your computer. A 3D file inside a DICOM file opens the same way.

Inbox attachments

Click an attachment in an inbox conversation and it opens in place when the viewers can show it as it is: a PDF, text, a CSV (as a table), an email, a ZIP, 7Z or RAR archive (as a list), a 3D scan, a DICOM image, a picture or a video. Smileline reads what the file is from the file itself, whatever it was sent as.

Smileline makes no copies of messages' attachments. A Word or Excel file, a camera RAW, a TIFF, an iPhone HEIC photo or a video the browser can't play shows its name, File it to a patient to preview it. and Download: once it is filed on the patient's record, Smileline makes its preview there. An attachment over 16 MB says it is too large to preview, and downloads.

The window's button reads Download for a file, and Open original for a photo or a video.

Team chat carries pictures only; they open as before.

Adding files

On the Files tab

Add files › Files… or Folder…, or a drop anywhere on the patient's record, takes any file (see Adding images):

  • pictures of any kind above, camera RAW and videos are filed as an x-ray or a photo, and show on the Files tab;
  • DICOM files are filed as x-rays (a CBCT as one scan);
  • documents — PDFs, Office documents, emails, text, CSV, RAR, TAR and GZ archives, volumes, CDA and PostScript — are filed as the patient's documents, under Other, and listed under Files on the record's Correspondence panel;
  • 3D files, and ZIP or 7Z archives of them, become 3D tiles.

A Word, Excel, PowerPoint, OpenDocument, Pages, Numbers, Keynote, XPS or 3MF file is a ZIP inside, but Smileline knows it from its contents and files it whole. Any other ZIP is opened, and the files in it are added one by one.

A file over 32 MB goes up in parts: its tile says Filing… once every part has arrived, and an upload cut off part-way waits with Resume and Discard…. A file over 2 GB uploads but can't be filed; it is kept as Too large to file (over 2 GB) with Download.

Not added

Files that can't be filed are listed under Not added in the upload box, each with why, and aren't sent:

  • Smileline can't tell what kind of file this is: a program, an audio file, a password-protected document, or anything else Smileline doesn't know.
  • Part of a scan viewer program: a text file (TXT, HTML, JS, CSS, XML, JSON, CSV, MD, LOG or INI) in the same folder or ZIP as DICOM files. A CBCT export often comes with a viewer program, its read-me and its settings; they aren't the patient's documents. A text file added on its own, or from a folder without DICOM files, is filed as a document.
  • A DICOM report or index, not an image: a CBCT export's DICOMDIR index.
  • A password-protected zip: unzip it on this computer and add the folder.
  • Damaged inside its zip: export it again.
  • A copy of a zip it is inside: not opened again.

Upload a file

New ▾ › Upload a file on the record's Correspondence panel takes any file Smileline can name, as a letter, consent, referral or any other kind (see Upload a file). One it can't name is refused in the dialog before anything is sent. One over 32 MB is sent in parts, and the dialog says Sent. Smileline is filing it now: it shows in Files in a moment.

On this page