warn against thumbnail_image

see libvips#1637 (comment)
kleisauke · May 3, 2020 · 54bfa23 · 54bfa23
1 parent a5680ab
commit 54bfa23
Showing 1 changed file with 6 additions and 1 deletion.
diff --git a/libvips/resample/thumbnail.c b/libvips/resample/thumbnail.c
@@ -1520,7 +1520,12 @@ vips_thumbnail_image_init( VipsThumbnailImage *image )
  * * @export_profile: %gchararray, export ICC profile
  * * @intent: #VipsIntent, rendering intent
  *
- * Exacty as vips_thumbnail(), but read from an existing image.
+ * Exacty as vips_thumbnail(), but read from an existing image. 
+ *
+ * This operation
+ * is not able to exploit shrink-on-load features of image load libraries, so
+ * it can be much slower than `vips_thumbnail()` and produce poorer quality
+ * output. Only use it if you really have to.
  *
  * See also: vips_thumbnail().
  *