diff --git a/inc/Service/Media/MediaHandler.php b/inc/Service/Media/MediaHandler.php index d2c84262..116c29a7 100644 --- a/inc/Service/Media/MediaHandler.php +++ b/inc/Service/Media/MediaHandler.php @@ -40,7 +40,7 @@ interface MediaHandler { * @param string $file_mime The mime type of the file. MUST be of a value for which {@link supportsMime} returns true. * @param int $file_kind One of the FILE_KIND_* constants. * @return mixed An opaque handle. - * @throws \RuntimeException On error. + * @throws MediaException On error. */ public function openHandle(string $file_path, string $file_mime, int $file_kind): mixed; @@ -51,6 +51,17 @@ interface MediaHandler { */ public function closeHandle(mixed $handle); + /** + * Installs the given file and generates a thumbnail for it. + * + * @param mixed $handle + * @param string $media_preferred_out_file_basepath + * @param string $preferred_out_file_basepath + * @param int $thumb_max_width + * @param int $thumb_max_height + * @return MediaInstallResult + * @throws MediaException On error. + */ public function installMediaAndGenerateThumb( mixed $handle, string $media_preferred_out_file_basepath, @@ -67,7 +78,7 @@ interface MediaHandler { * @param int $max_width * @param int $max_height * @return ThumbGenerationResult - * @throws \RuntimeException On error. + * @throws MediaException On error. */ public function generateThumb( mixed $handle,