Skip to content

Commit

Permalink
reorder sections
Browse files Browse the repository at this point in the history
  • Loading branch information
snoyer committed Apr 20, 2023
1 parent 8ee2eef commit 83f922a
Showing 1 changed file with 11 additions and 15 deletions.
26 changes: 11 additions & 15 deletions doc/user/LIMITATIONS_AND_TROUBLESHOOTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -36,20 +36,6 @@ Make sure that VTK has been built with *OpenImageDenoise* support (`VTKOSPRAY_EN
With some C++ STD library version, explicit linking to `stdc++fs` is not supported. We provide a CMake option `F3D_LINUX_APPLICATION_LINK_FILESYSTEM` that you can set to `OFF` to workaround this issue.

## Windows

> Using the portable binary release, I'm unable to run F3D because Windows warns about a security risk
F3D is not signed by Microsoft yet so Windows shows this warning. Just click on the "more" button to be able to run F3D.

## macOS

> Using the binary release, I'm unable to run F3D because macOS warns about F3D not being signed.
F3D is not signed by Apple yet so macOS shows this warning. To run F3D, right click on the app and click "open", then click "open" again to be able to run F3D.


### Thumbnails
> Thumbnails are not working in my file manager.
* Check that your file manager supports the thumbnailer mechanism.
Expand All @@ -60,7 +46,6 @@ F3D is not signed by Apple yet so macOS shows this warning. To run F3D, right cl
* If no formats have working thumbnails, then it is an issue with the `f3d-plugin-xxx.thumbnailer` files.
* If only big file do not have thumbnails, this is intended, you can modify this behavior in the `thumbnail.d/10_global.json` configuration folder using the `max-size` option.

### Sandboxing
Some file managers (eg: Nautilus) are using sandboxing for thumbnails, which the F3D binary release does not support as it needs
access to the Xorg server for rendering anything.
A work around to this issue is to use a virtual Xorg server like Xephyr or Xvfb in all the `f3d-plugin-xxx.thumbnailer` files.
Expand All @@ -72,6 +57,11 @@ Another workaround is to build VTK with EGL or osmesa support and then build F3D
this custom VTK build.

## Windows

> Using the portable binary release, I'm unable to run F3D because Windows warns about a security risk
F3D is not signed by Microsoft yet so Windows shows this warning. Just click on the "more" button to be able to run F3D.

> After installing F3D or registering the shell extension, my explorer is broken.
Unregister the shell extension by running:
Expand All @@ -93,3 +83,9 @@ You can try to use a software implementation of OpenGL, called [Mesa](https://gi
> I run f3d from the command prompt and my Unicode characters are not displayed properly.
Set the codepage to UTF-8, run `chcp 65001`.

## macOS

> Using the binary release, I'm unable to run F3D because macOS warns about F3D not being signed.
F3D is not signed by Apple yet so macOS shows this warning. To run F3D, right click on the app and click "open", then click "open" again to be able to run F3D.

0 comments on commit 83f922a

Please sign in to comment.