https://github.com/miyako/4d-plugin-ql
Use QuickLook API to generate thumbnails and previews
https://github.com/miyako/4d-plugin-ql
4d-plugin
Last synced: 16 days ago
JSON representation
Use QuickLook API to generate thumbnails and previews
- Host: GitHub
- URL: https://github.com/miyako/4d-plugin-ql
- Owner: miyako
- License: mit
- Created: 2017-10-07T08:18:51.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2023-08-06T00:12:47.000Z (almost 3 years ago)
- Last Synced: 2025-02-26T04:16:22.083Z (over 1 year ago)
- Topics: 4d-plugin
- Language: C
- Homepage:
- Size: 9.43 MB
- Stars: 3
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
[](LICENSE)
# 4d-plugin-ql
Use [QuickLook](https://developer.apple.com/documentation/quicklook) API to generate thumbnails ~~and previews~~.
### Remarks
to dump "c" symbols from ``qlmanage``
```
nm -g /usr/bin/qlmanage
```
to dump "obj-c" symbols from ``qlmanage``
```
otool -ov /usr/bin/qlmanage
```
or use [class-dump](https://github.com/nygard/class-dump)
previous version was using a hidden function ``QLPreviewCopyData`` to generate preview.
this API has been removed on Catalina and Big Sur.
current version is using ``- synchronousGetData`` of the hidden ``QLPreview`` class.
### Syntax
```
thumbnail:=QL Create thumbnail (path;options)
```
Parameter|Type|Description
------------|------------|----
path|TEXT|
options|TEXT|JSON in/out
thumbnail|PICTURE|
Valid properties of ``options`` on input are ``scaleFactor``, ``width`` and ``height``.
```
preview:=QL Create preview (path;type;data;options)
```
Parameter|Type|Description
------------|------------|----
path|TEXT|
type|ARRAY TEXT|
data|ARRAY BLOB|
options|TEXT|JSON in/out
preview|BLOB|
Possible properties of ``options`` on output:
```
height
PDFStyle (0=standard, 3=right, 4=left)
baseBundlePath (converted to HFS)
textEncoding
pageElementXPath
mimeType
width
allowJavascript
```
No known generators seem to process ``options`` on input.
For documents with multiple pages, an HTML preview is generally returned.
If the preview document is a single page, the data is returned in ``preview``. You can use ``mimeType`` to find out its internal format. The generator decides what kind of preview to draw. For example, Microsoft Office generators tend to create JPG. Apple iWorks tend to create PDF.
If the preview document has several pages, the data is returned in ``data`` and a container HTML is returned in ``preview``. The ``cid`` of each page is returned in ``type``.
Note that QuickLook is actually a **collection of generators and viewers**. A "preview" is not limited to image, it can be audio, video, etc. Likewise, the viewer could be a web browser engine, PDF or text viewer, even a media player or stream player (``baseBundlePath`` indicates the type of viewer).