add detailed jpg quality opts & thumbnail pass

2026-03-30 05:05:27 -07:00
parent 72d4d521e3
commit 30cbfaadad
10 changed files with 644 additions and 190 deletions
@@ -107,7 +107,11 @@ Create a conversion request:
 ```bash
 curl \
  --header "Content-Type: application/json" \
-  --data '{"sourceFilename":"example.pptx","resolution":"CONVERSION_RESOLUTION_FHD"}' \
+  --data '{
+    "sourceFilename":"example.pptx",
+    "full":{"resolution":"CONVERSION_RESOLUTION_FHD","jpeg":{"quality":85}},
+    "thumbnail":{"resolution":"CONVERSION_RESOLUTION_SD","jpeg":{"quality":75}}
+  }' \
  http://localhost:8080/officeconvertapi.v1.ConversionService/CreateConversion
 ```

@@ -139,8 +143,10 @@ Use `.env.example` as your baseline env configuration.

 If conversion fails on larger decks, tune these environment variables:

- `CreateConversionRequest.resolution` controls output dimensions via presets: `SD`, `HD`, `FHD`, `QHD`, `UHD`.
- Omitting `resolution` (or sending `CONVERSION_RESOLUTION_UNSPECIFIED`) defaults to `FHD`.
- Rasterization DPI is inferred automatically from source slide size and selected output dimensions.
+- `CreateConversionRequest.full.resolution` controls full-size output dimensions via presets: `SD`, `HD`, `FHD`, `QHD`, `UHD`.
+- `CreateConversionRequest.thumbnail.resolution` controls thumbnail output dimensions with the same presets.
+- Omitting full/thumbnail resolution (or sending `CONVERSION_RESOLUTION_UNSPECIFIED`) defaults to `FHD` for full and `SD` for thumbnail.
+- Output is JPEG-only for now; set `CreateConversionRequest.full.jpeg.quality` and `CreateConversionRequest.thumbnail.jpeg.quality` to `1..100` (`0` or omitted uses server defaults: full `85`, thumbnail `75`).
+- Rasterization DPI is inferred automatically from source slide size and selected full/thumbnail output dimensions.
 - `CONVERSION_PPTX_TO_PDF_TIMEOUT_SECONDS` (default `180`): timeout for LibreOffice export.
 - `CONVERSION_PDF_TO_IMAGES_TIMEOUT_SECONDS` (default `1800`): timeout for Poppler rasterization.